summaryrefslogtreecommitdiff
path: root/plugins/betriebsform/hybbx-host
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 /plugins/betriebsform/hybbx-host
Initial push
Diffstat (limited to 'plugins/betriebsform/hybbx-host')
-rw-r--r--plugins/betriebsform/hybbx-host/README.md22
-rw-r--r--plugins/betriebsform/hybbx-host/plugin.yaml27
2 files changed, 49 insertions, 0 deletions
diff --git a/plugins/betriebsform/hybbx-host/README.md b/plugins/betriebsform/hybbx-host/README.md
new file mode 100644
index 0000000..21affb5
--- /dev/null
+++ b/plugins/betriebsform/hybbx-host/README.md
@@ -0,0 +1,22 @@
+# Operating mode: HyBBX Host
+
+Secondary RF host on a HyBBX **Secondary** node — or **standalone Main** cohost when `[instance] standalone=yes` and max25d `mode=hybbx-cohost`. MAX25 prepares hardware; HyBBX bridges AX.25 to Main over HBX (Secondary) or serves users locally (standalone Main).
+
+## Workflow
+
+1. MAX25 device prep (boot-wait, `max25-bcpr-ctl start`, or `crdopc`)
+2. max25d releases KISS PTY (`/tmp/max25-bcpr/kiss-bc0` for BayCom/based)
+3. Merge `share/hybbx/*-host.ini.example` into `hybbx.ini`
+4. Start HyBBX (Secondary or standalone Main)
+
+## Per device
+
+| Device | MAX25 prep | HyBBX plugin |
+|--------|------------|--------------|
+| TNC2C | `tnc2c-boot-wait.sh` | `packet_radio` |
+| BayCom/based SER12 | `max25-bcpr-ctl start` / max25d `max25_bcpr=yes` | `baycom` |
+| CRDOP | `crdopc` running | `crdop` |
+
+**Co-host Main:** dual TNC + PC-COM on one host — max25d `mode=hybbx-cohost`, HyBBX `[networks] baycom=yes`. See [docs/BAYCOM.md](../../docs/BAYCOM.md).
+
+Contract: [docs/HYBBX.md](../../docs/HYBBX.md)
diff --git a/plugins/betriebsform/hybbx-host/plugin.yaml b/plugins/betriebsform/hybbx-host/plugin.yaml
new file mode 100644
index 0000000..4ff2c56
--- /dev/null
+++ b/plugins/betriebsform/hybbx-host/plugin.yaml
@@ -0,0 +1,27 @@
+id: hybbx-host
+type: betriebsform
+parent_stack: MainAX25-Stack (MAX25-Stack)
+label: HyBBX Host
+description: Secondary RF host — serial TNC or BayCom KISS → HBX to Main
+
+stack_requirements:
+ hybbx_secondary: true
+ circuit_link: required
+
+hybbx:
+ plugins:
+ - packet_radio
+ - baycom
+ transport_sections:
+ - transport.packet_radioN
+ - transport.baycomN
+
+integration:
+ tncs:
+ boot_script: stacks/tncs/tnc2c-boot-wait.sh
+ integration_test: stacks/tncs/tnc2c-integration-test.sh
+ ini_template: stacks/tncs/hybbx-tnc2c.ini
+ modems:
+ kiss_link: /tmp/max25-bcpr/kiss-bc0
+ ctl: stacks/max25-bcpr/tools/max25-bcpr-ctl
+ plugin_doc: stacks/max25-bcpr/README.md
git clone -b <branch> https://cgit.mode42.com/<repo>.git
git clone -b <branch> git://cgit.mode42.com/<repo>.git

info@mode42.com