From: Cefn Hoile <github.com@cefn.com>
Date: Mon, 26 Feb 2018 22:31:33 +0000 (+0000)
Subject: Headings added. More detail on repo structure and mpy-cross
X-Git-Tag: 0.1.0~4^2~5
X-Git-Url: https://git.ayoreis.com/Adafruit_Blinka-hackapet.git/commitdiff_plain/7fc1f8ab477124628a5afebbf6826005955805f9

Headings added. More detail on repo structure and mpy-cross
---

diff --git a/examples/index.md b/examples/index.md
index 33e3a34..0a03af3 100644
--- a/examples/index.md
+++ b/examples/index.md
@@ -1,3 +1,5 @@
+# About Adafruit_Micropython_Blinka
+
 This repository is structured around integration tests rooted at the `test/src`
 directory, intended to test the compatibility layer rooted in `src`. 
 
@@ -12,6 +14,8 @@ so the same routines can be carried out on Micropython boards, dual boards runni
 Typically the tests have first run on a native CircuitPython platform, and are then used to 
 prove equivalence on a Micropython platform running the **adafruit_blinka** compatibility layer.
 
+# Tests so far
+
 Tests of compatible versions of **digitalio**, **board** and **microcontroller** have successfully demonstrated
 the same code running on either platform, setting and getting pin values and using pull.
 
@@ -33,6 +37,20 @@ from testing import test_module_name
 test_module_name("testing.universal.digitalio")
 ```
 
+To prove this on a newly-flashed Feather Huzzah running Micropython 1.9.3, 
+it should be possible (on a posix-compliant platform with adafruit_ampy installed) 
+to `cd test/scripts` then run `./upload_feather_huzzah_micropython_put.sh` to 
+synchronize relevant files to the filesystem of the huzzah, reset the huzzah then 
+connect using `screen /dev/ttyUSB0 115200` before running the above commands.
+
+Micropython hosts require a micropython repository alongside
+the Adafruit_Micropython_Blinka repository. For circuitpython, 
+the repository is expected to be called circuitpython_2.2.3. 
+In each case, the matching version should have been checked out from github
+and `make` needs to have been run in the `mpy-cross` folder. This provides a tool 
+to make bytecode-compiled .mpy versions of all .py files before upload so that 
+tests can be achieved within the limited memory available on many target platforms. 
+
 ## Comments
 
 There are reference routines in `test/scripts` like `upload_feather_huzzah_micropython_put.sh` which execute a selective bytecode-compile to .mpy format and an ampy upload for CircuitPython/Micropython on esp8266, or `upload_pyboard_micropython_cp.sh` which selectively bytecode-compiles and synchronizes files with cp to the CIRCUITPY or PYBFLASH disk mount for stm32 and samd21 platforms.
\ No newline at end of file