diff options
| author | info@mode42.com <info@mode42.com> | 2026-08-08 03:54:55 +0000 |
|---|---|---|
| committer | info@mode42.com <info@mode42.com> | 2026-08-08 03:54:55 +0000 |
| commit | 20cb29c2f8c5c87bc590896854a20b1473ceb358 (patch) | |
| tree | 2857f41513a56ad41af97b57362639298aa7f033 /docs/TOPOLOGY.md | |
#2
Diffstat (limited to 'docs/TOPOLOGY.md')
| -rw-r--r-- | docs/TOPOLOGY.md | 43 |
1 files changed, 43 insertions, 0 deletions
diff --git a/docs/TOPOLOGY.md b/docs/TOPOLOGY.md new file mode 100644 index 0000000..0336c9d --- /dev/null +++ b/docs/TOPOLOGY.md @@ -0,0 +1,43 @@ +# Topology · HyBBX 2.8.0 + +Main, Secondary, and mains-proxy mesh layout. + +## Role matrix + +| Role | Process | Typical `[networks]` | Hosts | +|------|---------|----------------------|-------| +| **Main** | `hybbxd` | `circuit=yes` | Users, storage, HBX hub `:7323` | +| **Secondary** | `hybbxd` (remote) | `circuit=no`, `ax25=yes` | RF; HBX client to Main | +| **Standalone Main** | `hybbxd` | `ax25=yes` on same box | Lab / dual local TNC | + +## RF attachment matrix + +| Layout | TNC host | Main `[transport.packet_radioN]` | +|--------|----------|----------------------------------| +| Remote Secondary | Secondary (`device`, `tnc`, `circuit_host`) | Bridge registry only (`link_id`, password) | +| Local TNC on Main | Same box as users | Full TNC keys (`device`, `tnc`, …) | + +## HBX/Circuit matrix + +| Item | Value | +|------|-------| +| Protocol | HBX v1 — magic `HBX` | +| Default port | `7323` | +| Max links | 16 (default `max_links=8`) | +| Auth | Per-link `link_password` | +| Scope | Sole inter-node transport — core never sees raw KISS | + +## Broadcast matrix + +| Command | Scope | Level | +|---------|-------|-------| +| `/broadcast <msg>` | Local logged-in users | Sysop | +| `/broadcast ax25` | Sequential RF beacon (60 s link gap) | Sysop | + +## Related + +| Goal | Doc | +|------|-----| +| Manual | [MANUAL.md](MANUAL.md) | +| Mesh proxy | [MAINS_PROXY.md](MAINS_PROXY.md) | +| Dual-TNC | [DUAL-TNC-OPERATOR-GUIDE.md](DUAL-TNC-OPERATOR-GUIDE.md) | |