summaryrefslogtreecommitdiff
path: root/docs/TOPOLOGY.md
blob: 0336c9d33c1bf16aa588041ab74118c25676a1dd (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
34
35
36
37
38
39
40
41
42
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) |
git clone -b <branch> https://cgit.mode42.com/<repo>.git
git clone -b <branch> git://cgit.mode42.com/<repo>.git

info@mode42.com