summaryrefslogtreecommitdiff
path: root/docs/AX25-NATIVE-CODEC.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/AX25-NATIVE-CODEC.md')
-rw-r--r--docs/AX25-NATIVE-CODEC.md33
1 files changed, 33 insertions, 0 deletions
diff --git a/docs/AX25-NATIVE-CODEC.md b/docs/AX25-NATIVE-CODEC.md
new file mode 100644
index 0000000..a865e9c
--- /dev/null
+++ b/docs/AX25-NATIVE-CODEC.md
@@ -0,0 +1,33 @@
+# AX.25 native codec · MAX25-Stack 1.8.0
+
+In-tree userspace AX.25 encode/decode — no kernel AX.25 required for max25d.
+
+## Component matrix
+
+| Module | Role |
+|--------|------|
+| `ax25_codec.py` | Address encode/decode, FCS |
+| `kiss_bridge.py` | KISS frame wrap/unwrap |
+| `banlist.py` | Source address ban list |
+
+## Build matrix
+
+| Option | Default | Effect |
+|--------|---------|--------|
+| `MAX25_BUNDLE_AX25` | OFF | Vendored ax25-apps tarballs reference-only |
+| In-tree codec | always | Used by max25d and terminal |
+
+## FCS matrix
+
+| Direction | Rule |
+|-----------|------|
+| To TNC (KISS DATA) | FCS stripped |
+| From TNC (RX) | FCS validated in codec |
+| UI frames | Built in terminal or HyBBX attach path |
+
+## Related
+
+| Goal | Doc |
+|------|-----|
+| Packet radio | [PACKET-RADIO.md](PACKET-RADIO.md) |
+| Hardware acceptance | [HARDWARE-ACCEPTANCE.md](HARDWARE-ACCEPTANCE.md) |
git clone -b <branch> https://cgit.mode42.com/<repo>.git
git clone -b <branch> git://cgit.mode42.com/<repo>.git

info@mode42.com