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
39 commits 1 branch 15 tags 508 KiB
Find a file
Exact
Light-Fighter-Manifesto 344049a558 v0.3.2-alpha: Multi-interface transport with TX gating 
- Add operating mode selector (Hybrid/HF Only/Internet Only)
- Add TX gate control in freedvtnc2 (beacon windows only in hybrid)
- Add I2P transport integration (Lightfighter node)
- Add multi-interface RNS config (TCP Gateway + I2P + HF)
- Add ethernet DHCP + NAT for internet backhaul
- Pre-install i2pd for I2P connectivity
- Bundle Leaflet/Chart.js locally (offline dashboard)
- Fix copy buttons for HTTP
- Remove CLAUDE.md from repo
2026-01-30 17:26:11 -05:00
.github/ISSUE_TEMPLATE ReticulumHF: Reticulum mesh networking over HF radio 2025-12-17 05:40:19 -05:00
beacon v0.3.2-alpha: Multi-interface transport with TX gating 2026-01-30 17:26:11 -05:00
configs v0.3.2-alpha: Multi-interface transport with TX gating 2026-01-30 17:26:11 -05:00
docs v0.3.1-alpha: Dashboard, JS8Call integration, beacon scheduler 2026-01-30 15:44:43 -05:00
image v0.3.2-alpha: Multi-interface transport with TX gating 2026-01-30 17:26:11 -05:00
scripts v1.0: HF-only release with setup wizard 2026-01-12 12:27:08 -05:00
services v0.3.1-alpha: Dashboard, JS8Call integration, beacon scheduler 2026-01-30 15:44:43 -05:00
setup-portal v0.3.2-alpha: Multi-interface transport with TX gating 2026-01-30 17:26:11 -05:00
Testing/Postman Collections Create ReticulumHF.postman_collection.json 2026-01-12 10:04:18 -05:00
.gitignore v0.3.2-alpha: Multi-interface transport with TX gating 2026-01-30 17:26:11 -05:00
CONTRIBUTING.md Update project name in CONTRIBUTING.md 2026-01-29 08:58:22 -05:00
LICENSE ReticulumHF: Reticulum mesh networking over HF radio 2025-12-17 05:40:19 -05:00
README.md v0.3.2-alpha: Multi-interface transport with TX gating 2026-01-30 17:26:11 -05:00

README.md

ReticulumHF

v0.3.2-alpha - Reticulum networking over HF radio using FreeDV data modes.

What It Does

Raspberry Pi gateway that bridges Reticulum networks over HF radio. Provides encrypted communication without internet infrastructure.

  • Web setup wizard and operator dashboard
  • JS8Call integration (station discovery)
  • TAK/CoT push (map markers)
  • Hybrid beacon/ARQ protocol
  • FreeDV modes: DATAC4 (beacon), DATAC1 (data transfer)

Quick Start

  1. Flash image to SD card
  2. Boot Pi, connect radio via Digirig
  3. Connect to WiFi: ReticulumHF / reticulumhf
  4. Open http://192.168.4.1
  5. Complete setup wizard
  6. Connect clients to 192.168.4.1:4242 (TCP Client Interface)

Network

Setting Value
WiFi ReticulumHF / reticulumhf
Web Portal http://192.168.4.1
Client Port 4242 (TCP Client Interface)
SSH pi / reticulumhf

Tested Hardware

Radio Interface Notes
Xiegu G90 Digirig Mobile Hamlib 3088, 19200 baud
Yaesu FT-818 Digirig Mobile Hamlib 1020, 4800 baud
(tr)uSDX Digirig Lite VOX mode

FreeDV Modes

Mode Bitrate Min SNR Use
DATAC4 87 bps -4 dB Beacons, weak signals
DATAC1 980 bps 3 dB Data transfer

All stations must use the same mode to communicate.

Architecture

Client (Sideband/MeshChat) → WiFi → Pi Gateway → Digirig → HF Radio → RF
                            4242      8001/8002
  • Port 4242: Reticulum gateway (boundary mode)
  • Port 8001: freedvtnc2 KISS
  • Port 8002: freedvtnc2 command interface

Manual Install

# Prerequisites
sudo apt install -y git build-essential cmake python3-pip pipx portaudio19-dev

# Codec2
git clone https://github.com/drowe67/codec2.git
cd codec2 && mkdir build && cd build
cmake .. && make && sudo make install && sudo ldconfig

# Reticulum + FreeDV
pipx install rns freedvtnc2

References

License

MIT

Author

Light Fighter Manifesto