fixes

2026-07-31 23:46:37 -07:00
parent 9eaf3ce1c4
commit d96435b7c4
14 changed files with 321 additions and 6 deletions
@@ -0,0 +1,39 @@
+# 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.
+
+| Board | Example | MicroPython UART | TX pin | RX pin |
+| --- | --- | --- | --- | --- |
+| Seeed Studio XIAO RP2040 | `xiao_rp2040.py` | UART0 | D6 / GPIO0 | D7 / GPIO1 |
+| Raspberry Pi Pico / Pico W | `raspberry_pi_pico.py` | UART0 | GP0 | GP1 |
+| Generic ESP32 | `esp32.py` | UART2 | GPIO17 | GPIO16 |
+
+## Wiring
+
+UART signals cross between the two boards:
+
+```text
+MicroPython board TX  -> radio RX
+MicroPython board RX  <- radio TX
+MicroPython board GND --- radio GND
+```
+
+Both ends must use 3.3 V UART logic. Do not connect the power pins unless you have
+confirmed the voltage and current requirements for both boards. Meshtastic radio UART
+pin names vary by model and may need to be configured in the radio firmware.
+
+## Run an example
+
+Install MicroMesh, copy the matching example to the board as `main.py`, and reset it:
+
+```sh
+mpremote mip install package.json
+mpremote fs cp examples/xiao_rp2040.py :main.py
+mpremote reset
+```
+
+Each example requests the node configuration, listens for text messages, and broadcasts
+one greeting after configuration completes. Remove the `mesh.sendText(...)` line for a
+receive-only application.