summaryrefslogtreecommitdiff
path: root/docs/PACKET-RADIO.md
diff options
context:
space:
mode:
authorinfo@mode42.com <info@mode42.com>2026-08-07 18:25:13 +0000
committerinfo@mode42.com <info@mode42.com>2026-08-07 18:25:13 +0000
commit04d965d67a7264a1c7c211494aebda1953df7603 (patch)
tree0ebd700a6e219f84a26a656f4bee8778bc75da7b /docs/PACKET-RADIO.md
Initial push
Diffstat (limited to 'docs/PACKET-RADIO.md')
-rw-r--r--docs/PACKET-RADIO.md46
1 files changed, 46 insertions, 0 deletions
diff --git a/docs/PACKET-RADIO.md b/docs/PACKET-RADIO.md
new file mode 100644
index 0000000..5876ff3
--- /dev/null
+++ b/docs/PACKET-RADIO.md
@@ -0,0 +1,46 @@
+# Packet Radio & AX.25 · MAX25-Stack 1.8.0
+
+Technical reference for on-air and host-side AX.25/KISS behaviour in MAX25.
+
+## Layer matrix
+
+| Layer | MAX25 owns |
+|-------|------------|
+| Operator UI | `max25-terminal` |
+| Session / IPC | `max25d` M25/1 |
+| Device prep | boot-wait, modprobe, KISS PTY |
+| AX.25 codec | `ax25_codec.py` / `kiss_bridge.py` |
+| KISS framing | FEND/FESC, port nibble |
+| HyBBX attach | external — after stack up |
+
+## Address matrix
+
+| Rule | Value |
+|------|-------|
+| Call body | 1–6 chars A–Z/0–9 |
+| SSID | `-0` … `-15` |
+| Path order | DEST → DIGI* → SOURCE |
+
+## KISS matrix
+
+| Item | Rule |
+|------|------|
+| FCS on DATA to TNC | stripped — TNC adds on air |
+| KISS return recovery | `0xC0 0xFF 0xC0` before prep |
+| MYCALL | MAX25 prep — not HyBBX |
+
+## CRDOP note matrix
+
+| Item | Value |
+|------|-------|
+| Device id | `soft-crdop` |
+| Speed | 1200 bd primary, up to 19200 bd |
+| Duplex | half and full |
+| TCP ports | 8515 control / 8516 data |
+
+## Related
+
+| Goal | Doc |
+|------|-----|
+| Device workflow | [PLUGINS-DEVICE-MODEL.md](PLUGINS-DEVICE-MODEL.md) |
+| HyBBX | [HYBBX.md](HYBBX.md) |
git clone -b <branch> https://cgit.mode42.com/<repo>.git
git clone -b <branch> git://cgit.mode42.com/<repo>.git

info@mode42.com