From 04d965d67a7264a1c7c211494aebda1953df7603 Mon Sep 17 00:00:00 2001
From: "info@mode42.com" <info@mode42.com>
Date: Fri, 7 Aug 2026 18:25:13 +0000
Subject: Initial push

---
 docs/MAX25-TERMINAL.md | 95 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 95 insertions(+)
 create mode 100644 docs/MAX25-TERMINAL.md

(limited to 'docs/MAX25-TERMINAL.md')

diff --git a/docs/MAX25-TERMINAL.md b/docs/MAX25-TERMINAL.md
new file mode 100644
index 0000000..86d2a22
--- /dev/null
+++ b/docs/MAX25-TERMINAL.md
@@ -0,0 +1,95 @@
+# max25-terminal · MAX25-Stack
+
+Sole official operator client — text lines + F10 menu over M25/1.
+
+## Canonical binary
+
+| Path | Role |
+|------|------|
+| `/usr/local/bin/max25-terminal` | Install / PATH — **prefer** |
+| `build*/bin/max25-terminal` | CMake output |
+| `stacks/terminal/max25-terminal` | Tree copy after build (optional) |
+
+**Never** `stacks/daemon/max25-terminal` — that path does not exist (daemon is `stacks/daemon/max25d`).
+
+```bash
+max25-terminal --help
+# lists: -H -p -U -d/--device -v --probe …
+```
+
+`-d` / `--device` is **optional**: with max25d `[devices] default = max25e0`, the session already starts on that id. Use `-d` only to override, or type `SET DEVICE <id>` / F10 → **7**.
+
+## Canonical connect (BayCom/based · bcpr)
+
+```bash
+# max25d already up (auto_start owns max25-bcprd)
+max25-terminal -U /run/max25/modem.sock
+# header DEVICE: max25e0 when default=max25e0
+# F10 → 6  (CONNECT)   then   SEND …   or F10 → 4
+```
+
+## Connection matrix
+
+| Mode | Target |
+|------|--------|
+| Unix socket | `/run/max25/modem.sock` |
+| TCP | `127.0.0.1:7325` or remote host |
+| Flags | `--ax25-ui` (default on) · `--no-ax25-ui` for plain SEND |
+
+```bash
+max25-terminal -U /run/max25/modem.sock
+max25-terminal -T -H 127.0.0.1 -p 7325
+# optional override after connect:
+max25-terminal -U /run/max25/modem.sock -d max25e0
+```
+
+## Device selection
+
+| Method | When |
+|--------|------|
+| max25d `[devices] default = …` | Session starts on that id — **no** `-d` needed |
+| `-d` / `--device ID` | CLI `SET DEVICE` right after connect |
+| Type `SET DEVICE <id>` | In the terminal prompt |
+| F10 → **7** | Menu: Change DEVICE (TX target) |
+
+`CONNECT` (F10 → **6**, or type `CONNECT`) attaches the **currently selected** device.
+
+## Command matrix
+
+| Command | Action |
+|---------|--------|
+| `SET DEVICE <id>` | Select RF backend |
+| `GET DEVICES` | List enabled devices |
+| `CONNECT` | Attach selected device |
+| `SEND …` | Transmit payload |
+| F10 menu | Device ops, status, bans |
+
+## F10 menu
+
+| Key | Action |
+|-----|--------|
+| 1 | CALLERID |
+| 2 | CALLID |
+| 3 | Status |
+| 4 | Send line |
+| 5 | RX only (Monitor) |
+| 6 | Connection on/off (`CONNECT` / `DISCONNECT`) |
+| 7 | Change DEVICE |
+| 8 | List devices (`GET DEVICES`) |
+| 0 | Quit |
+
+## Identity matrix
+
+| Terminal field | AX.25 field |
+|----------------|-------------|
+| CALLERID | source address |
+| CALLID | destination address |
+
+## Related
+
+| Goal | Doc |
+|------|-----|
+| M25/1 protocol | [MAX25-CLIENT.md](MAX25-CLIENT.md) |
+| Operator runbook | [MAX25-OPERATOR-RUNBOOK.md](MAX25-OPERATOR-RUNBOOK.md) |
+| BayCom/based (bcpr) | [BAYCOM.md](BAYCOM.md) |
+| TX/RX release test | [TX-RX-TEST.md](TX-RX-TEST.md) |
-- 
cgit v1.3.1