Document firmware architecture, ESP-NOW, UART, and goTool in README.

Expand main/README with master/slave overview, boot config, protocols,
and build notes; point goTool README at the full system doc.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
2026-05-18 22:17:53 +02:00
co-authored by Cursor
parent 54f2a7de5b
commit b592401e78
2 changed files with 223 additions and 88 deletions
+8 -6
View File
@@ -1,10 +1,10 @@
# goTool
Host-side UART utilities for Powerpod.
Host-side UART client for the Powerpod **master** ESP.
## version command
Full system documentation (roles, ESP-NOW, framing, protobuf): [`../main/README.md`](../main/README.md).
Sends `MessageType.VERSION` (0x03) in a framed UART packet and prints the protobuf response.
## Usage
```bash
cd goTool
@@ -12,10 +12,12 @@ go mod tidy
go run . -port /dev/ttyUSB0
```
Options:
| Flag | Default | Description |
|------|---------|-------------|
| `-port` | (required) | Serial port on master UART (GPIO2/3 adapter) |
| `-baud` | `921600` | Must match firmware `UART_BAUD_RATE` |
- `-port` — serial device (required)
- `-baud` — default `921600` (must match firmware)
Implements the VERSION command (`MessageType` = 3): sends framed `03`, decodes protobuf `UartMessage.version_response`.
## Regenerate protobuf