summaryrefslogtreecommitdiff
path: root/docs/AX25-NATIVE-CODEC.md
blob: a865e9cff9bbad46e07be1c11b0a9af85307f226 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
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