Enhance testing and error handling; update documentation and examples

examples/README.md

@@ -1,8 +1,9 @@
 # Board examples
 
 These examples connect a MicroPython board to the hardware UART exposed by a
-Meshtastic radio. The radio must have its serial module enabled in `PROTO` mode at
-115200 baud.
+Meshtastic radio. The radio must have its serial module enabled in `PROTO` mode. The
+examples choose 115200 baud, so configure the radio to match; Meshtastic's serial
+module defaults to 38400 baud.
 
 | Board | Example | MicroPython UART | TX pin | RX pin |
 | --- | --- | --- | --- | --- |
@@ -21,9 +22,11 @@ python -m pip install -e . pyserial
 python examples/curses_dashboard.py /dev/cu.usbmodem123456
 ```
 
-For a radio wired to a XIAO RP2040, first install the bridge as the XIAO's boot script:
+For a radio wired to a XIAO RP2040, install MicroMesh and then install the bridge as
+the XIAO's boot script:
 
 ```sh
+mpremote connect /dev/cu.usbmodem2101 mip install package.json
 mpremote connect /dev/cu.usbmodem2101 fs cp examples/xiao_dashboard_bridge.py :main.py
 mpremote connect /dev/cu.usbmodem2101 reset
 python examples/curses_dashboard.py --xiao-bridge /dev/cu.usbmodem2101
@@ -37,7 +40,7 @@ Use `mpremote connect list`, `python -m serial.tools.list_ports`, or your operat
 system's device list to find the radio port. The message field is always active: type
 and press Enter to send. Use Escape to clear it, F5 to refresh, and F10 to quit.
 `Ctrl-R` and `Ctrl-Q` are also supported. On Windows, install `windows-curses` and use
-a port such as `COM4`.
+a port such as `COM4`. A `message queued` status is not a delivery receipt.
 
 ## Wiring