diff options
| author | info@mode42.com <info@mode42.com> | 2026-08-07 18:25:13 +0000 |
|---|---|---|
| committer | info@mode42.com <info@mode42.com> | 2026-08-07 18:25:13 +0000 |
| commit | 04d965d67a7264a1c7c211494aebda1953df7603 (patch) | |
| tree | 0ebd700a6e219f84a26a656f4bee8778bc75da7b /docs/LINUX-HOST-SETUP.md | |
Initial push
Diffstat (limited to 'docs/LINUX-HOST-SETUP.md')
| -rw-r--r-- | docs/LINUX-HOST-SETUP.md | 48 |
1 files changed, 48 insertions, 0 deletions
diff --git a/docs/LINUX-HOST-SETUP.md b/docs/LINUX-HOST-SETUP.md new file mode 100644 index 0000000..5f3ada9 --- /dev/null +++ b/docs/LINUX-HOST-SETUP.md @@ -0,0 +1,48 @@ +# Linux host setup · MAX25-Stack 1.8.0 + +Example settings for running `max25d` on a Linux host with USB TNC or sound-card modem. + +## Component matrix + +| Component | On Linux | Notes | +|-----------|----------|-------| +| `max25d` | yes | Python 3 | +| `max25-terminal` | yes | Unix socket or `127.0.0.1:7325` | +| TNC2C / USB TNC | yes | `/dev/ttyUSB*` | +| BayCom/based (SER12) | yes | `max25-bcpr` default ON; KISS `/tmp/max25-bcpr/kiss-bc0` | +| CRDOP | yes | ALSA sound device | +| HyBBX attach | yes | after MAX25 prep | + +## Dependency matrix (Debian/Ubuntu) + +| Package group | Packages | +|---------------|----------| +| Build | `build-essential`, `cmake`, `pkg-config`, `git` | +| Runtime | `python3`, `libncurses-dev` | +| CRDOP | `libasound2-dev` | +| BayCom/based | built with default stack | Real 8250 UART; prove RX before TX | + +## Install matrix + +| Step | Command | +|------|---------| +| Build | `./scripts/build.sh` | +| INI deploy | copy `share/max25/max25d.ini.host.example` → site config | +| Run daemon | `max25d -c /etc/max25/max25d.ini` | +| Terminal | `max25-terminal -U /run/max25/modem.sock --ax25-ui` | +| Serial access | `usermod -aG dialout $USER` | + +## Config matrix + +| Item | Value | +|------|-------| +| Live INI | site path or `./local/max25d.ini` | +| M25/1 port | `7325` | +| Secrets | `./local/` only | + +## Related + +| Goal | Doc | +|------|-----| +| Operator runbook | [MAX25-OPERATOR-RUNBOOK.md](MAX25-OPERATOR-RUNBOOK.md) | +| HyBBX | [HYBBX.md](HYBBX.md) | |