X-Git-Url: https://git.ayoreis.com/hackapet/Adafruit_Blinka.git/blobdiff_plain/f15a0431b5c4185424541d41e5bd843838bf6efd..bef64a33250d4e47c41c27f47312afb928d4b41c:/README.rst diff --git a/README.rst b/README.rst old mode 100644 new mode 100755 index 67c770a..e94a478 --- a/README.rst +++ b/README.rst @@ -9,8 +9,8 @@ Introduction :target: https://discord.gg/nBQh6qu :alt: Discord -.. image:: https://travis-ci.org/adafruit/Adafruit_Micropython_Blinka.svg?branch=master - :target: https://travis-ci.org/adafruit/Adafruit__Micropython_Blinka +.. image:: https://travis-ci.org/adafruit/Adafruit_Blinka.svg?branch=master + :target: https://travis-ci.org/adafruit/Adafruit_Blinka :alt: Build Status This repository contains a selection of packages mirroring the CircuitPython API @@ -19,6 +19,9 @@ on hosts running micropython. Working code exists to emulate the CircuitPython p * **board** - breakout-specific pin identities * **microcontroller** - chip-specific pin identities * **digitalio** - digital input/output pins, using pin identities from board+microcontroller packages +* **bitbangio** - software-driven interfaces for I2C, SPI +* **busio** - hardware-driven interfaces for I2C, SPI, UART +* **time** * - substitute functions monkey-patched to time module Dependencies @@ -28,32 +31,28 @@ The Micropython compatibility layers described above are intended to provide a C are running Micropython. Since corresponding packages should be built-in to any standard CircuitPython image, they have no value on a device already running CircuitPython and would likely conflict in unhappy ways. -The test suites under **testing.implementation.all** are by design -intended to run on *either* CircuitPython *or* Micropython+compatibility layer to prove conformance. - -The test suites under **testing.implementation.micropython** will only run -on Micropython and **testing.implementation.circuitpython** will only run on CircuitPython - +The test suites in the test/src folder under **testing.universal** are by design +intended to run on *either* CircuitPython *or* Micropython+compatibility layer to prove conformance. Usage Example ============= -At the time of writing (`git:3b2fc268 `_), -the following sequence runs through some basic testing of the digitalio compatibility layer... +At the time of writing (`git:7fc1f8ab `_), +the following sequence runs through some basic testing of the digitalio compatibility layer... .. code-block:: python - import testing - testing.main() + from testing import test_module_name + test_module_name("testing.universal.digitalio") -A typical log from running the suites is `here `_ . +An example log from running the suites is `here `_ . Contributing ============ Contributions are welcome! Please read our `Code of Conduct -`_ +`_ before contributing to help this project stay welcoming. Building locally