Mode d'emploi

Il vous faut trois choses : une clé, une antenne, un ordinateur.

Où placer l'antenne

• Dehors ou sur un balcon, tendue à l'horizontale, c'est l'idéal.
• À défaut, le long d'une fenêtre ou dans un grenier.
• Loin des chargeurs, ampoules LED, écrans, box Internet et panneaux solaires : ce sont eux qui produisent le « bruit » en ondes courtes.

Pas de clé ? Le mode démo de WAVECRAFT fonctionne sans matériel : idéal pour découvrir l'interface avant d'acheter.

Téléchargez la dernière version depuis la page des versions, puis suivez les instructions de votre système.

echo 'SUBSYSTEM=="usb", ATTRS{idVendor}=="0bda", ATTRS{idProduct}=="2838", MODE="0666"' | sudo tee /etc/udev/rules.d/20-rtlsdr.rules
echo 'blacklist dvb_usb_rtl28xxu' | sudo tee /etc/modprobe.d/blacklist-rtlsdr.conf
sudo udevadm control --reload-rules && sudo udevadm trigger
sudo modprobe -r dvb_usb_rtl28xxu

Windows prend la clé pour un tuner TV. Il faut lui associer le pilote générique WinUSB, une seule fois. L'assistant lance Zadig, fourni avec WAVECRAFT.

1. Menu Options, cochez List All Devices.
2. Dans la liste, choisissez Bulk-In, Interface (Interface 0). Vérifiez l'identifiant USB 0BDA 2838. Ne choisissez jamais votre clavier ou votre souris.
3. Dans la case de droite, sélectionnez WinUSB.
4. Cliquez sur Replace Driver (ou Install Driver) et patientez jusqu'au message de réussite.

Port USB : le pilote est associé au port. Si vous changez de port et que la clé n'est plus vue, refaites cette étape.

Au premier démarrage, l'assistant vous accompagne en quatre écrans :

1. Brancher la clé : WAVECRAFT la détecte et affiche son nom.
2. Pilote : Zadig sous Windows, règles udev sous Linux.
3. Antenne : conseils de placement.
4. Test d'écoute : réglage sur une station qui émet en continu, pour vérifier que tout fonctionne.

Il propose aussi le mode démo si aucune clé n'est branchée, et une clé distante via rtl_tcp (adresse et port d'une autre machine).

Votre fuseau horaire est détecté automatiquement, heure d'été comprise. Vous pouvez choisir une ville, ou autoriser la géolocalisation : elle n'est demandée que si vous cliquez dessus.

Le catalogue liste 92 stations, classées par heure d'écoute : « en cours » en tête, puis « 24 h/24 », puis « prochaine émission dans 12 min », etc. Les horaires s'affichent en heure locale et en UTC, l'heure de référence des radioamateurs. Un repère jour/nuit indique si la propagation est favorable.

Cliquez sur une station : WAVECRAFT applique son préréglage (fréquence, mode, bande passante, squelch). Le planning vient du calendrier public de Priyom ; hors connexion, un planning hebdomadaire prend le relais.

Simulateur : le préréglage appliqué

Les modes en deux mots

• AM : la radio « classique », voix et musique.
• USB / LSB : bande latérale supérieure ou inférieure, la plupart des voix de stations de nombres. Une erreur de mode donne une voix de « canard ».
• CW : le Morse, un filtre très étroit autour de la tonalité.

La cascade (waterfall) dessine le spectre au fil du temps : la fréquence à l'horizontale, le temps qui défile vers le bas, et plus c'est clair, plus le signal est fort.

• Une ligne fine et continue : une porteuse, souvent un émetteur en attente ou une station AM.
• Une bande irrégulière de 2 à 3 kHz : une voix en USB ou LSB. Elle « respire » au rythme des chiffres.
• Des traits courts et longs alignés : du Morse. Le décodeur s'y accroche automatiquement.
• Des bandes larges et régulières qui couvrent tout : des parasites locaux (voir l'étape 10).

Le S-mètre indique la force du signal reçu ; le bouton Enregistrer crée un fichier WAV de ce que vous entendez.

Sur une station en mode CW, ouvrez le panneau Morse. Le décodeur suit automatiquement la tonalité, estime la vitesse entre 8 et 40 mots/min et transcrit en direct.

Beaucoup de stations Morse envoient des chiffres abrégés (cut numbers) pour gagner du temps. WAVECRAFT sait les traduire :

Conseil : si la transcription est fantaisiste, le signal est trop faible ou brouillé. Resserrez le filtre ou attendez une meilleure propagation ; l'enregistrement WAV permet de réécouter.

Chaque écoute peut devenir une entrée du journal (logbook) :

• commentaire libre et note de qualité de réception ;
• étiquettes (« première écoute », « Morse », « à réécouter »…) ;
• lien vers l'enregistrement WAV et la transcription Morse ;
• filtres et tris par date, station ou étiquette ;
• export en CSV (tableur), JSON ou Markdown.

Le mode serveur fait tourner WAVECRAFT sans écran et sert une interface web : son en direct, cascade, Morse, catalogue et journal. Sur un PC, le bouton « Lancer le serveur » suffit. Voici l'installation dans un conteneur LXC sous Proxmox (les étapes 3 à 5 valent aussi pour un Raspberry Pi ou un NAS sous Linux).

1. Sur l'hôte Proxmox : libérer la clé

echo 'blacklist dvb_usb_rtl28xxu' > /etc/modprobe.d/blacklist-rtlsdr.conf
modprobe -r dvb_usb_rtl28xxu
lsusb | grep -i 0bda   # la clé doit apparaître : 0bda:2838

2. Passer l'USB au conteneur

Ajoutez ces deux lignes à la configuration du conteneur, /etc/pve/lxc/<ID>.conf, puis redémarrez-le. Le numéro 189 est la classe des périphériques USB.

lxc.cgroup2.devices.allow: c 189:* rwm
lxc.mount.entry: /dev/bus/usb dev/bus/usb none bind,optional,create=dir

Conteneur non privilégié : les fichiers de /dev/bus/usb appartiennent à root sur l'hôte. Ajoutez sur l'hôte la règle udev de l'étape 2 (MODE="0666") pour que l'utilisateur du conteneur puisse ouvrir la clé.

3. Lancer le serveur

wavecraft --server --bind 0.0.0.0 --port 8073

Ouvrez ensuite http://adresse-du-conteneur:8073/ dans un navigateur du réseau local. Un mot de passe peut être défini dans les réglages du serveur.

4. Démarrage automatique avec systemd

[Unit]
Description=WAVECRAFT, serveur web d'écoute
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=wavecraft
ExecStart=/opt/wavecraft/wavecraft --server --bind 0.0.0.0 --port 8073
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

useradd --system --no-create-home wavecraft
systemctl daemon-reload
systemctl enable --now wavecraft
journalctl -u wavecraft -f   # suivre les messages

Sécurité : gardez le serveur sur le réseau local. Pour écouter depuis l'extérieur, passez par un VPN plutôt que d'ouvrir le port 8073 sur Internet.

C'est normal au début : les ondes courtes sont capricieuses. Vérifiez dans l'ordre :

1. La station émet-elle ? Choisissez une station « en cours » ou « 24 h/24 » (S28, S30, S32 sont de bons tests).
2. Jour ou nuit ? Sous 7 MHz, l'écoute est meilleure la nuit ; au-dessus de 10 MHz, plutôt le jour. Regardez le repère jour/nuit.
3. L'antenne : est-elle branchée, assez longue, dehors ou près d'une fenêtre ? Une antenne à l'intérieur au milieu des appareils ne capte que des parasites.
4. Les parasites locaux : débranchez un à un chargeurs, LED, écrans. Si la cascade se calme, vous tenez le coupable. Une rallonge USB éloigne aussi la clé du PC.
5. Le gain (mode Expert) : trop fort, tout sature et le bruit monte ; baissez-le jusqu'à ce que le signal ressorte du fond.
6. Le mode : une voix incompréhensible, type « canard », indique un mauvais mode (USB au lieu de LSB) ou un léger désaccord. Revenez au préréglage.
7. La correction PPM (mode Expert) : si toutes les stations semblent décalées, ajustez-la de quelques unités.
8. Le bias-tee : laissez-le désactivé, sauf avec une antenne active qui demande à être alimentée.
9. Le pilote : si la clé n'est pas détectée, refaites l'étape 3 (Windows) ou vérifiez la règle udev (Linux).

Toujours rien ? Ouvrez un ticket sur GitHub en joignant une capture de la cascade.