reticulum-ref/ReticulumHF
1
0
Fork 0
mirror of https://github.com/LFManifesto/ReticulumHF synced 2026-08-14 19:31:48 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions
No description
42 commits 1 branch 15 tags 508 KiB
Find a file
Light-Fighter-Manifesto 92c0a239a2 Add v1.0 image build system and configuration files 
- Add image/build.sh: Automated Pi image builder for ReticulumHF v1.0
- Add configs/: System configuration files (hostapd, dnsmasq, ALSA, radios DB)
- Add scripts/wait-for-port: Service dependency utility
- Update .gitignore: Exclude .claude/ and test files

This release includes the complete build infrastructure for creating
ReticulumHF Raspberry Pi images with pre-configured WiFi AP, web portal,
and Reticulum gateway services.
2026-02-05 23:59:43 -05:00
configs Add v1.0 image build system and configuration files 2026-02-05 23:59:43 -05:00
image Add v1.0 image build system and configuration files 2026-02-05 23:59:43 -05:00
scripts Add v1.0 image build system and configuration files 2026-02-05 23:59:43 -05:00
services Audit fixes: config persistence, security, and code quality 2026-01-27 05:33:55 -05:00
setup-portal v0.3.1-alpha: Connection health monitor, RNS stats, PWA support 2026-02-02 17:50:32 -05:00
Testing/Postman Collections Create ReticulumHF.postman_collection.json 2026-01-12 10:04:18 -05:00
.gitignore Add v1.0 image build system and configuration files 2026-02-05 23:59:43 -05:00
README.md Refactor README.md to simplify content 2026-02-04 23:29:04 -05:00

README.md

Overview

Runs Reticulum over HF radio using FreeDV data modes.

Quick Start

  1. Flash to SD card using Raspberry Pi Imager
  2. Insert SD card, connect radio via Digirig, power on
  3. Connect to WiFi: ReticulumHF (password: reticulumhf)
  4. Open http://192.168.4.1 in browser
  5. Complete 6-step setup wizard
  6. Connect Sideband to 192.168.4.1:4242

Setup Wizard

  1. Select Radio - Choose from supported radios (tested radios marked)
  2. Radio Settings - Configure your radio with the displayed menu values
  3. Hardware Detection - Automatically detects Digirig, serial port, audio device
  4. Test Connection - Verify CAT and PTT (or check "Using VOX mode" for audio-only)
  5. Network Security - Optional IFAC encryption for the gateway
  6. Start Gateway - Launches services and redirects to status page

IMPORTANT: All stations must use the same FreeDV mode to communicate. Coordinate with other operators before changing modes.

Network Configuration

Setting Value
WiFi SSID ReticulumHF
WiFi Password reticulumhf
Gateway IP 192.168.4.1
Web Portal http://192.168.4.1
RNS Gateway Port 4242 (all clients)
SSH pi / reticulumhf

Client Connections

All clients connect using TCP Client Interface on port 4242.

Sideband / Columba: Settings → Connectivity → Add Interface → TCP Client

Setting Value
Interface Type TCP Client Interface
Address 192.168.4.1
Port 4242

MeshChat: Settings → Interfaces → Add → TCP Client Interface

Setting Value
Interface Type TCP Client Interface
Target Host 192.168.4.1
Target Port 4242

Note: If IFAC is configured on the gateway, clients must use matching IFAC Name and Passphrase.

What's Included

  • Raspberry Pi OS Bookworm Lite (64-bit)
  • RNS (Reticulum Network Stack)
  • freedvtnc2 (FreeDV modem)
  • codec2 (built from source)
  • Hamlib rigctld (CAT/PTT control)
  • Web portal with setup wizard and status dashboard

References