How djwinter29-oss/picouart works
PicoUart is RP2040/RP2350 firmware that presents six USB CDC serial ports and a HID status/control interface, bridging each CDC port to a UART channel. Startup initializes board services and UART before polling CDC and HID; UART work runs on a worker loop. The README documents two hardware-UART and four PIO-UART channels, DMA-backed paths, line-coding limits, and host monitoring. Edges reflect the startup excerpt, source-index references, or README; unsampled internals are not assumed.
Main entry points: usb_hid.c HID monitor · main.c Firmware loop · usb_cdc.c CDC ACM · uart_driver.c Logical UART ports
Components 19
USB interfaces
- CDC ACM
firmware/src/usb/usb_cdc.c - HID monitor
firmware/src/usb/usb_hid.c - USB descriptors
firmware/src/usb/usb_descriptors.c - Python HID tool
host/python/src/pico_uart_hid.py
UART routing
- Logical UART ports
firmware/src/uart/uart_driver.c - Control plane
firmware/src/uart/control/plane.c - Line coding
firmware/src/uart/line_coding.h - Ring buffers
firmware/src/uart/ring_buffer/ring_buffer.c - UART worker
firmware/src/uart/worker.c
UART backends
- Backend adapter
firmware/src/uart/backend/adapter.c - Hardware UART
firmware/src/uart/hw/hw_uart_driver.c - PIO UART
firmware/src/uart/pio/pio_uart_driver.c
Board services
- Firmware loop
firmware/src/main.c - UART topology
firmware/src/board/uart_topology.c - Board UART setup
firmware/src/board/uart_board.c - System services
firmware/src/driver/system.c - Temperature
firmware/src/driver/temperature.c - LED service
firmware/src/driver/led.c
Other components
- Host PC
Connections 26
- Host PC → CDC ACM: opens ports
- Host PC → HID monitor: reads status
- Firmware loop → Board UART setup: validates topology
firmware/src/main.c - Firmware loop → Logical UART ports: initializes
firmware/src/main.c - Firmware loop → CDC ACM: initializes, polls
firmware/src/main.c - Firmware loop → HID monitor: initializes, polls
firmware/src/main.c - Firmware loop → System services: initializes
firmware/src/main.c - Firmware loop → Temperature: initializes
firmware/src/main.c - Firmware loop → LED service: initializes
firmware/src/main.c - CDC ACM → Logical UART ports: routes serial data
- CDC ACM → Line coding: parses requests
firmware/src/usb/usb_cdc.c - CDC ACM → HID monitor: reports health
firmware/src/usb/usb_cdc.c - HID monitor → Logical UART ports: reads port status
firmware/src/usb/usb_hid.c - HID monitor → System services: reads status
firmware/src/usb/usb_hid.c - HID monitor → Temperature: reads temperature
firmware/src/usb/usb_hid.c - HID monitor → LED service: uses LED status
firmware/src/usb/usb_hid.c - Python HID tool → HID monitor: monitors, controls
- Board UART setup → UART topology: configures ports
firmware/src/board/uart_board.c - Backend adapter → Hardware UART: dispatches
firmware/src/uart/backend/adapter.c - Backend adapter → PIO UART: dispatches
firmware/src/uart/backend/adapter.c - Logical UART ports → Ring buffers: buffers port data
- Hardware UART → Ring buffers: publishes DMA data
- PIO UART → Ring buffers: publishes DMA data
firmware/src/uart/pio/pio_uart_driver.c - UART worker → Control plane: services control
- UART worker → Logical UART ports: polls I/O
- USB descriptors → Host PC: defines interfaces