summaryrefslogtreecommitdiff
path: root/docs/HYBBX.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/HYBBX.md
Initial push
Diffstat (limited to 'docs/HYBBX.md')
-rw-r--r--docs/HYBBX.md44
1 files changed, 44 insertions, 0 deletions
diff --git a/docs/HYBBX.md b/docs/HYBBX.md
new file mode 100644
index 0000000..4772d5f
--- /dev/null
+++ b/docs/HYBBX.md
@@ -0,0 +1,44 @@
+# HyBBX integration ยท MAX25-Stack 1.8.0
+
+MAX25 is the standalone RF/link layer โ€” HyBBX consumes via transport plugins after MAX25 prep.
+
+## Plugin mapping matrix
+
+| MAX25 hardware | HyBBX plugin | INI `[networks]` |
+|----------------|--------------|------------------|
+| `hardware/tncs` | `packet_radio` | `ax25=yes` |
+| `hardware/modems` | `baycom` | `baycom=yes` |
+| `hardware/soft-modems` | `crdop` | `crdop=yes` |
+
+## Order rule matrix
+
+| Rule | Detail |
+|------|--------|
+| Start order | MAX25 before HyBBX |
+| Serial ownership | One process per port |
+| v2.4.0 HyBBX | `[max25] check=yes`, `kiss_entry=none` |
+| BayCom in packet_radio | rejected โ€” use MAX25 + baycom plugin |
+
+## TNC workflow matrix
+
+| Step | Action |
+|------|--------|
+| 1 | `max25-ctl start --hardware tncs --device tnc2c` |
+| 2 | Merge `share/hybbx/tnc2c-host.ini.example` |
+| 3 | HyBBX `[max25] check=yes`, `kiss_entry=none` |
+| 4 | Start HyBBX Secondary โ†’ HBX to Main |
+
+## INI fragment matrix
+
+| Device | Example INI |
+|--------|-------------|
+| TNC2C | `share/hybbx/tnc2c-host.ini.example` |
+| BayCom/based | via MAX25 **bcpr** (kernel SER12 host INI removed) |
+| CRDOP | `share/hybbx/crdop-host.ini.example` |
+
+## Related
+
+| Goal | Doc |
+|------|-----|
+| Packet radio facts | [PACKET-RADIO.md](PACKET-RADIO.md) |
+| BayCom | [BAYCOM.md](BAYCOM.md) |
git clone -b <branch> https://cgit.mode42.com/<repo>.git
git clone -b <branch> git://cgit.mode42.com/<repo>.git

info@mode42.com