Update installation instructions.

Author: peterhinch

FASTPOLL.md

@@ -372,7 +372,7 @@ loop = asyncio.get_event_loop(runq_len=40, waitq_len=40)
 CPython V3.7 provides a function `get_running_loop` which enables the current
 loop to be retrieved, raising a `RuntimeError` if one has not been
 instantiated. This is provided in `fast_io`. In the above sample the `Bar`
-constructor call `get_running_loop` to avoid inadvertently instantiating an
+constructor can call `get_running_loop` to avoid inadvertently instantiating an
 event loop with default args.
 
 Function:

README.md

@@ -45,9 +45,10 @@ This comprises two parts.
 
 # 2. Version and installation of uasyncio
 
-Paul Sokolovsky (`uasyncio` author) has released `uasyncio` V2.2.1. This version
-is on PyPi and requires his [Pycopy](https://github.com/pfalcon/micropython)
-fork of MicroPython firmware. His `uasyncio` code may also be found in
+Paul Sokolovsky (`uasyncio` author) has released versions of `uasyncio` which
+supercede the official version. His latest version is that on PyPi and requires
+his [Pycopy](https://github.com/pfalcon/micropython) fork of MicroPython
+firmware. His `uasyncio` code may also be found in
 [his fork of micropython-lib](https://github.com/pfalcon/micropython-lib).
 
 I support only the official build of MicroPython. The library code guaranteed
@@ -58,12 +59,14 @@ CPython).
 Most documentation and code in this repository assumes the current official
 version of `uasyncio`. This is V2.0 from
 [micropython-lib](https://github.com/micropython/micropython-lib).
-If release build of MicroPython V1.10 or later is used, V2.0 is incorporated
-and no installation is required. Some examples illustrate the features of the
-`fast_io` fork and therefore require this version.
+It is recommended to use MicroPython firmware V1.11 or later. On many platforms
+`uasyncio` is incorporated and no installation is required.
+
+Some examples illustrate features of the `fast_io` fork and therefore require
+this version.
 
 See [tutorial](./TUTORIAL.md#installing-uasyncio-on-bare-metal) for
-installation instructions where a realease build is not used.
+installation instructions where `uasyncio` is not pre-installed.
 
 # 3. uasyncio development state
 

TUTORIAL.md

@@ -94,23 +94,60 @@ CPython V3.5 and above.
 
 ## 0.1 Installing uasyncio on bare metal
 
-If a release build of firmware is used no installation is necessary as uasyncio
-is compiled into the build. The current release build (V1.9.10) now supports
-asynchronous stream I/O.
+It is recommended to use MicroPython firmware V1.11 or later. On many platforms
+no installation is necessary as `uasyncio` is compiled into the build. Test by
+issuing
+```python
+import uasyncio
+```
+at the REPL.
+
+The following instructions cover cases where modules are not pre-installed. The
+`queues` and `synchro` modules are optional, but are required to run all the
+examples below.
+
+#### Hardware with internet connectivity
+
+On hardware with an internet connection and running firmware V1.11 or greater
+installation may be done using `upip`, which is pre-installed. After ensuring
+that the device is connected to your network issue:
+```python
+import upip
+upip.install('micropython-uasyncio')
+upip.install('micropython-uasyncio.synchro')
+upip.install('micropython-uasyncio.queues')
+```
+Error meesages from `upip` are not too helpful. If you get an obscure error,
+double check your internet connection.
+
+#### Hardware without internet connectivity (micropip)
+
+On hardware which lacks an internet connection (such as a Pyboard V1.x) the
+easiest way is to run `micropip.py` on a PC to install to a directory of your
+choice, then to copy the resultant directory structure to the target hardware.
+The `micropip.py` utility runs under Python 3.2 or above and runs under Linux,
+Windows and OSX. It may be found
+[here](https://github.com/peterhinch/micropython-samples/tree/master/micropip).
+
+Typical invocation:
+```bash
+$ micropip.py install -p ~/rats micropython-uasyncio
+$ micropip.py install -p ~/rats micropython-uasyncio.synchro
+$ micropip.py install -p ~/rats micropython-uasyncio.queues
+```
 
-The following instructions cover the case where a release build is not used.
-The instructions have changed as the version on PyPi is no longer compatible
-with official MicroPython firmware.
+#### Hardware without internet connectivity (copy source)
 
-The following instructions describe copying the bare minimum of files to a
-target device, also the case where `uasyncio` is to be frozen into a compiled
-build as bytecode. For the latest release compatible with official firmware
+If `micropip.py` is not to be used the files should be copied from source. The
+following instructions describe copying the bare minimum of files to a target
+device, also the case where `uasyncio` is to be frozen into a compiled build as
+bytecode. For the latest release compatible with official firmware
 files must be copied from the official
 [micropython-lib](https://github.com/micropython/micropython-lib).
 
 Clone the library to a PC with
-```
-git clone https://github.com/micropython/micropython-lib.git
+```bash
+$ git clone https://github.com/micropython/micropython-lib.git
 ```
 On the target hardware create a `uasyncio` directory (optionally under a
 directory `lib`) and copy the following files to it:
@@ -119,9 +156,6 @@ directory `lib`) and copy the following files to it:
  * `uasyncio.synchro/uasyncio/synchro.py`
  * `uasyncio.queues/uasyncio/queues.py`
 
-The `queues` and `synchro` modules are optional, but are required to run all
-the examples below.
-
 The `uasyncio` modules may be frozen as bytecode in the usual way, by placing
 the `uasyncio` directory and its contents in the port's `modules` directory and
 rebuilding.