// praktijkvoorbeeld

Heltec V4 als LoRa node via WiFi

Hier maak je van een Heltec LoRa32 V4 een Reticulum LoRa node. Je flasht de RNode firmware, koppelt het board via WiFi aan je netwerk en gebruikt het daarna als radio-interface voor Reticulum.

ReticulumNet LoRa instellingen

Frequentie869.463 MHz
Bandbreedte125 kHz
Spreading FactorSF8
Coding Rate5

Wat je nodig hebt

Heltec LoRa32 V4868 MHz versie voor Europa. Rond de 20 euro.
USB-C kabelMoet een datakabel zijn, niet alleen opladen.
ComputerOm te flashen (Chrome nodig voor de web flasher).
WiFi netwerkDe Heltec verbindt hiermee na het flashen.
Server of Raspberry PiOm rnsd op te draaien. Moet op hetzelfde WiFi netwerk zitten.
USB laderOm de Heltec van stroom te voorzien bij het raam.

Stap 1: RNode firmware flashen

De web flasher is de makkelijkste manier. Sluit de Heltec aan via USB aan je computer en open Chrome.

1.

Zet het board in boot modus: houd BOOT ingedrukt, druk kort RESET, laat BOOT los.

2.

Open de web flasher.

3.

Product: Heltec LoRa32 v4. Model: 868 MHz.

4.

Klik Official Firmware om het zip bestand te downloaden.

5.

Klik Bestand kiezen, selecteer het zip bestand, klik Flash Now.

6.

Klik Provision (stap 3 in de flasher).

7.

Klik Set Firmware Hash (stap 4 in de flasher).

RNode Web Flasher openen
Alternatief: via command line

pip install rns

rnodeconf /dev/ttyACM0 --autoinstall

# Kies 9 (Heltec LoRa32 v4)

# Kies 1 (868 MHz)

Stap 2: WiFi configureren

Sluit de geflashte Heltec aan via USB aan de server of Pi waar straks rnsd op gaat draaien. Installeer RNS als dat nog niet gedaan is.

# RNS installeren (als dat nog niet gedaan is)

pip install rns

# WiFi instellen

rnodeconf /dev/ttyACM0 -w station --ssid JouwWiFiNaam --psk JouwWiFiWachtwoord

# Vast IP-adres instellen (aanbevolen)

rnodeconf /dev/ttyACM0 -w station --ip 192.168.1.50 --nm 255.255.255.0

Koppel nu de USB kabel los en sluit de Heltec aan op een USB lader. Zet hem bij het raam voor het beste LoRa bereik. De Heltec verbindt automatisch met je WiFi.

Controleer of hij bereikbaar is:

ping 192.168.1.50

Stap 3: rnsd configureren

Start rnsd een keer om de config te genereren, stop hem, en voeg de LoRa interface toe.

# Eerste start: genereert config in ~/.reticulum/config

rnsd

# Stop met Ctrl+C

Bewerk ~/.reticulum/config. Zet enable_transport = Yes in de [reticulum] sectie en voeg de LoRa interface toe onder [interfaces]:

[[ReticulumNet LoRa]]

type = RNodeInterface

enabled = yes

port = tcp://192.168.1.50

frequency = 869463000

bandwidth = 125000

spreadingfactor = 8

codingrate = 5

Vervang 192.168.1.50 door het IP-adres dat je in stap 2 hebt ingesteld.

Stap 4: Starten en controleren

rnsd &

rnstatus

De ReticulumNet LoRa interface moet Up tonen. Je ziet de frequentie, bandbreedte, spreading factor en coding rate bevestigd door de radio.

RNodeInterface[ReticulumNet LoRa]

Status: Up

Rate: 3.12 kbps

Freq: 869.463 MHz / BW: 125 kHz / SF: 8 / CR: 5

Als systemd service draaien (altijd aan na reboot)

# /etc/systemd/system/rnsd.service

[Unit]

Description=Reticulum Network Daemon

After=network.target

[Service]

Type=simple

User=kel

ExecStart=/usr/local/bin/rnsd

Restart=always

[Install]

WantedBy=multi-user.target

sudo systemctl enable rnsd

sudo systemctl start rnsd

Stap 5: Ratspeak verbinden

Download Ratspeak op je telefoon. Voor Android: de ARM64 APK van ratspeak.org. Niet beschikbaar in de Play Store.

1.

Installeer de APK. Sta installatie van onbekende bronnen toe als Android erom vraagt.

2.

Open Ratspeak. Je identity (LXMF adres en hash) wordt automatisch aangemaakt.

3.

Ga naar Connections > Local Network.

4.

Zet aan. Group ID op "reticulum" laten staan.

5.

Zorg dat je telefoon op hetzelfde WiFi zit als de server.

Je telefoon en server vinden elkaar automatisch via AutoInterface. Onder Peers in de app zie je de transport node verschijnen. Je kunt nu berichten sturen via LoRa naar iedereen binnen bereik van je Heltec.

Ratspeak downloaden

Het resultaat

Antenne bij het raam
      |
  Heltec V4 (RNode, 869.463 MHz, SF8)
      |
    WiFi (tcp://192.168.x.x)
      |
  Server (rnsd, enable_transport = yes)
      |
  Telefoon (Ratspeak, zelfde WiFi)

De Heltec is de radio. De server is de transport node. De telefoon is de client. LoRa berichten van andere nodes in de buurt komen binnen via de Heltec, de server stuurt ze door. En andersom.

Zonder aparte host: standalone firmware

In de stappen hierboven is het bordje alleen de radio en draait Reticulum op een host (een computer of Raspberry Pi). Er is ook een andere route: microReticulum, een implementatie van de Reticulum-stack in C++ die op het bordje zelf draait. Een aparte host is dan niet nodig.

Met de bijbehorende firmware draait het bordje in "Transport Mode" als transport node en repeater. Handig op een goede radioplek waar je geen computer kwijt kunt.

Voor de Heltec V4 is er kant-en-klare firmware op basis hiervan: RTNode-HeltecV4. Die stuurt lokaal LoRa-verkeer via WiFi door naar het bredere Reticulum-netwerk (LoRa naar TCP). Het board krijgt een OLED-statusscherm en een web-configuratieportaal. Flashen gaat via een web flasher (Chrome/Edge), een Python-script of PlatformIO. De Heltec V3 werkt ook.

Standaard RNode Standalone (RTNode-HeltecV4)
Aparte host nodigJa (computer of Pi)Nee, draait op het bordje
RolRadio, host doet de routingZelfstandige node, ook transport en repeater
VolwassenheidStabiel, breed gebruiktActief in ontwikkeling, experimenteler
Heltec V4OndersteundSpeciaal hiervoor gemaakt
FlashenWeb flasher of rnodeconfWeb flasher, flash.py of PlatformIO

Let op: deze standalone firmware is Beta (licht getest, voor early adopters). Door het beperkte geheugen van de ESP32 is de routeringstabel begrensd (RTNode-HeltecV4: 24 paden). Voor een repeater die gewoon stabiel moet draaien is de host-route (Pi plus RNode) voorlopig de veiligste keuze. Er is ook een 2.4 GHz-variant, RTNode-2400, voor andere radiochips.

Problemen oplossen

De meest voorkomende problemen bij deze setup. Meer, ook voor flashen, USB en standalone firmware, staat op probleemoplossing.

Probleem Oplossing
Board wordt niet herkend bij flashen Probeer een andere USB kabel. Moet een datakabel zijn, niet alleen opladen.
LoRa interface toont "Down" Check of het IP-adres klopt met ping. Gebruik tcp://IP zonder poortnummer.
Geen peers in Ratspeak Check of je telefoon op hetzelfde WiFi zit, niet op mobiele data.
rnodeconf niet gevonden export PATH=$PATH:~/.local/bin
"Missing config" op het scherm Stap 3 (Provision) en stap 4 (Set Firmware Hash) in de web flasher zijn niet gedaan.