diff --git a/uart/terminal/README.md b/uart/terminal/README.md
new file mode 100644
index 0000000..4a48625
--- /dev/null
+++ b/uart/terminal/README.md
@@ -0,0 +1,25 @@
+# Pico serial terminal
+
+A simple example to allow a Pico to act as a serial terminal into another Raspberry Pi computer.
+Useful for setting up a Pi when network setup fails for some reason.
+Should work for Windows, Linux, or Mac host machines.
+
+1. Add `enable_uart=1` to the Raspberry Pi computer `config.txt` and boot it.
+2. Connect pins `pico:{1,2,3}` to `pi:{10,8,6}`
+3. Connect to Pico using [Thonny][thonny]
+4. From Thonny, run `terminal.py` on Pico, then power up the Pi
+
+[thonny]: https://thonny.org/
+
+You should now have a serial terminal to your Raspberry Pi computer through your Pico.
+
+### Errata / Bugs
+
+* Input is only taken a whole line at a time after the EOL character.
+* Line input is ALWAYS echoed back to the terminal as a new line, even passwords
+* Control characters are dropped so no curses tools (like `raspi-config`) work
+
+For a full-fledged serial interface, look at [picoprobe][probe] referenced in Appendix A of the [Pico Getting Started Guide][get-start].
+
+[get-start]: https://datasheets.raspberrypi.com/pico/getting-started-with-pico.pdf#page=61
+[probe]: https://github.com/raspberrypi/picoprobe/
diff --git a/uart/terminal/terminal.py b/uart/terminal/terminal.py
new file mode 100644
index 0000000..ea5fb8d
--- /dev/null
+++ b/uart/terminal/terminal.py
@@ -0,0 +1,33 @@
+#!/usr/bin/env micropython
+from _thread import start_new_thread
+from machine import UART, Pin
+
+UART0 = 0 # uart0 is the FIRST uart
+TX=0 # Default Pin number for TX on Pico uart0
+RX=1 # Default Pin number for RX on Pico uart0
+VS=2 # comment reminder: DONT FORGET to connect the common Ground (VSS)
+
+uart = UART(UART0, 115200, parity=None, bits=8, stop=1, tx=Pin(TX, Pin.OUT), rx=Pin(RX, Pin.IN))
+
+# Type a line (plus enter) in REPL to transmit down UART
+def TX():
+ while True:
+ line = input() + "\n"
+ uart.write(line.encode())
+
+# Busy thread to relay EVERY character arriving from uart
+def RX():
+ while True:
+ recv = uart.read()
+ if(recv):
+ try:
+ print(recv.decode(), end='')
+ except UnicodeError:
+ # Caught a control char in buffer, eject it and move along
+ fix = [x for x in recv if x <= 127]
+ print(bytes(fix).decode(), end='')
+
+# Run busy thread on second processor
+start_new_thread(RX, tuple([]))
+# Run input wait on this (BSP) processor
+TX()
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy