OpenWebRx Plus

OpenWebRX Plus

Deze versie bevat heel wat meer decoders, waardoor je zo goed als alles kan decoderen.

Info

Github pagina: https://luarvique.github.io/ppa/
En om Docker te gebruiken, vind je hier de info: https://luarvique.github.io/ppa/#if-you-are-using-docker- met directe link naar de Stable versie: https://hub.docker.com/r/slechev/openwebrxplus

1 Create Volumes

Er worden twee volumes aangemaakt waarin ook de settings bewaard blijven, zodat er updates van de software kunnen gebeuren zonder verlies van instellingen.

Open een terminal Systemtools/Qterminal om de volgende commado's in te geven om twee volumes te maken voor het bewaren van de settings.

sudo docker volume create owrxp-settings

sudo docker volume create owrxp-etc

Setting files

Deze zijn terug te vinden onder /var/lib/docker/volumes.

De inhoud kan gekopieerd worden naar andere folders om zo de settings over te nemen van een werkende openwebrx naar openwebrxplus etc.

2 First run

Hierdoor wordt de image toegankelijk via de poort 8088 op de host, er worden een extra volumes gebruikt voor het bewaren van de settings en de openwebrxplus wordt gehaald of gebruikt voor het maken van de container en opgestart.

Dit commando dien je slechts één maal uit te voeren, zodat de container gemaakt kan worden en nadien met start - stop kan gebruikt worden.
Wordt de image lokaal gevonden, dan wordt deze gebruikt, zoniet wordt deze van de hub.docker.com gehaald, geïnstalleerd en opgestart.

sudo docker run -d --name owrxp --device /dev/bus/usb -p 8088:8073 -v owrxp-settings:/var/lib/openwebrx -v owrxp-etc:/etc/openwebrx --restart unless-stopped slechev/openwebrxplus

Optie mogelijkheid:

De --tmpfs=/tmp/openwebrx is een parameter die er voor zorgt dat de temp files niet op je flash geschreven worden, maar in RAM bewaard worden.
Let wel op het path moet overeenkomen met je docker container, doordat dit een standaard werking is voor docker.
De -d optie zorgt ervoor dat de applicatie in de achtergrond draait.
De --restart unless-stopped zorgt ervoor dat applicaties steeds draaien na het opstarten van je pc.

Nightly image

Deze versies worden gebruikt voor de meest recente ontwikkelingen en zijn niet noodzakelijk stabiel.

sudo docker run -d --name owrxp-nightly --device /dev/bus/usb -p 8088:8073 -v owrxp-settings:/var/lib/openwebrx -v owrxp-etc:/etc/openwebrx --restart unless-stopped slechev/openwebrxplus-nightly

3 Aanmaken admin gebruiker

Vermits in de laatste versies van owrxp het aanpassen van de config vanuit de webinterface kan, is het niet meer noodzakelijk om de files te editeren.
Echter, om toegang te hebben, moet owrxp een admin user kennen met bijbehorend paswoord.
Als voorbeeld maken we de gebruiker walter aan, waarna je de mogelijkheid krijgt om hiervoor een paswoord te voorzien.

# add admin user

sudo docker exec -it owrxp openwebrx admin adduser walter

4 Blacklist device drivers (indien nodig)

Het is mogelijk dat je een aantal drivers dient te black listen.
Dit gebeurt via een bestand in /etc/modprobe.d/owrx-blacklist.conf
Als je root bent kan je volgend commando's uitvoeren, zoniet dien je met Featherpad een file aan te maken in de folder en de blacklist lijst er in te plaatsen.

Het herstarten van de host is noodzakelijk om dit te activeren.

cat > /etc/modprobe.d/owrx-blacklist.conf << _EOF_

blacklist dvb_usb_rtl28xxu

blacklist sdr_msi3101

blacklist msi001

blacklist msi2500

blacklist hackrf

_EOF_

5 Starten en stoppen van een applicatie

Eens de installatie één maal heeft gedraaid, kan je deze stoppen of activeren door stop en start te gebruiken, vanuit een nieuw terminal venster.
Hierdoor heb je geen openstaande terminal venster meer nodig na het geven van de commando's.

sudo docker stop owrxp

sudo docker start owrxp

6 Benaderen en configureren OpenWebRX Plus

Je kan nu Owrxp benaderen via een webbrowser op de host via:
localhost:<port>
Settings kan je aanpassen via het settings menu of door rechtstreeks te gaan naar:
localhost:<port>/settings
Geef je login en paswoord (aangemaakte user)

7 Settings in openWebRX/settings

Samplerates

Wanneer je banden bij maakt in de config, mag je niet zomaar een sample rate nemen, daar er anders gekke dingen gebeuren, zoals het niet juist op frequentie zitten.
Alvorens je start met het "offset" gebeuren, doe je er goed aan een aantal verschillende sample rates te testen, om dit probleem uit te sluiten.

Ieder SDR device heeft zo zijn eigen rates:

Airspy mini : 3M s/s, 6M s/s
Airspy HF+ Discovery: (48, 96), 192, 256, 384, 768 s/s schijnen het wel te doen. (max. 660 kHz alias-free)
RTL-SDR V3(R820T ): 2.4M s/s als maximum op een USB2.

Wanneer je meerdere identieke Airspy modules aan één openwebrx koppelt, dien je het serial number ervan te gebruiken in de SDR definitie veld Device identifier.
De tekst die je daarin moet invullen is deze waarbij het laatste nummer de serial nummer is:
serial=0xA74068C8365CA093

Direct conversion

De RTL-SDR V3 laten direct conversion toe, een optie die je kan bijvoegen en aanzetten in de settings van een SDR device.
Voor de Direct conversion (gebruik op freq <14Mhz) maak je gebruik van de Q branch en zet je best de Auto AGC af, als je een RTL-SDR V3 gebruikt zonder de ingangsfrequentie te beperken door voorzetfilters.
Het dynamisch bereik wordt hierdoor merkelijk beter.
Het bereik tussen 14MHz en 24MHz is niet bruikbaar bij de V3 versie.
De V4 versie laat dit wel toe, zonder zelfs de direct sampling te gebruiken.
Echter vergeet niet de drivers te updaten, zoals op de site wordt vermeld.

Wanneer je meer dan één RTL-SDR hebt, dien je via de device identifier de serial nummer op te geven:
serial=38009000

Het instellen van een unieke serial nummer in een RTL-SDR kan je dmv het rtl_eeprom programma (zie 12 RTL-SDR Dongle )

8 Auto restart enable in docker

Als je een auto restart wil laten gebeuren van een docker container na een reboot van de pc (bij update etc), kan je het volgende commando gebruiken om de bestaande docker file aan te passen.
In ons voorbeeld is de installatie reeds gebeurt met deze parameter en dus deze handeling niet meer nodig.
Zo maak je een "connect en forget" device dat kan gebruikt worden door enkel de antenne om te schakelen en de voeding op te zetten.

sudo docker update --restart unless-stopped airspy
Restart van docker image is nodig om deze setting persistent te maken.

Het gebruik OpenwebRX vind je terug op Gebruik OpenWebRX

9 Update OWRXp

Een typische manier om een docker container te update is:

stop de bestaande container
verwijder de container zonder de settings te verwijderen
Pull de nieuwe docker container uit de docker hub
recreate de nieuwe container en herstart deze met de juiste settings.

Maak onderstaand script (UpdateOwrxp)aan in je document folder en maak het executable, zodat je verschillende stappen met een eenvoudige oproep kan uitvoeren.

Opstarten van dit script doe je als volgt:
Ga naar de folder waarin je het script het aangemaakt (./Documents)
geeft nu
sudo ./UpdateOwrxp
Geef je paswoord als root in en het script doet de rest.

Script update UpdateOwrxp in ./Documents

#!/usr/bin/env bash

set -euo pipefail

docker pull slechev/openwebrxplus

docker stop owrxp || true

docker rm owrxp || true

docker run -d --name owrxp --device /dev/bus/usb -p 8088:8073 -v owrxp-settings:/var/lib/openwebrx -v owrxp-etc:/etc/openwebrx --restart unless-stopped slechev/openwebrxplus

OWRXP instellingen Saffraanberg

Als voorbeeld vind je hier wat screenshots van de instellingen op Saffraanberg. De owrxp bestaat uit 2 SDR ontvangers, de Airspy HF+ Discovery en de Airspy mini.