Le RRFRaptor analyse le trafic sur le réseau RRF (Réseau des Répéteurs Francophones) et gère automatiquement les QSY de votre Spotnik afin de lui faire rejoindre automatiquement le salon sur lequel il y a de l'activité. Attention, il n'est pas recommandé de l'installer sur un relais en permanence. Par contre, il est parfaitement adapté à un usage personnel.
Pour ma part, j'active néanmoins le RRFRaptor sur le F1ZPX situé en JN18du, entre 22h05 et 06h05, période généralement assez calme sur le RRF. J'ai ajouté les lignes suivantes dans la crontab du user root, via la commande
crontab -e:
05 22 * * * /opt/RRFRaptor/RRFRaptor.sh start 05 06 * * * /opt/RRFRaptor/RRFRaptor.sh stop 06 06 * * * /bin/echo "96#" > /tmp/dtmf_uhf
Vous pouvez aussi vous contenter d'éditer le fichier
/etc/crontabavec votre éditeur préféré et ajouter les lignes :
05 22 * * * root /opt/RRFRaptor/RRFRaptor.sh start 05 06 * * * root /opt/RRFRaptor/RRFRaptor.sh stop 06 06 * * * root /bin/echo "96#" > /tmp/dtmf_uhf
Une fois le RRFRaptor lancé, tant qu'il y a de l'activité sur le salon sur lequel vous êtes, rien ne se passe. Le RRFRaptor reste en sommeil.
Si l'activité retombe, au bout d'une certaine temporisation paramétrable, le RRFRaptor va s'activer et commencer à analyser le trafic sur l'ensemble du réseau RRF à la recherche de QSO sur les autres salons.
Si le trafic reprend entre temps sur le salon sur lequel vous étiez, évidemment, la temporisation redémarre à zéro et le RRFRaptor retombe en sommeil.
Par contre, si le trafic ne reprend pas et que le RRFRaptor détecte de l'activité sur un autre salon, alors il va automatiquement faire basculer votre Spotnik sur celui ci.
J'ai réalisé une video qui explique le paramétrage du RRFRaptor. Elle est complémentaire de cette documentation.
Commencez par ouvrir une connexion SSH sur votre Spotnik.
Depuis votre connexion SSH, lancez les commandes suivantes :
cd /opt
Puis,
git clone https://github.com/armel/RRFRaptor.git
Si nécessaire, il faut également procéder à l'installation de quelques paquets complémentaires. Rassurez-vous, ce sera rapide. Toujours depuis votre connexion SSH, lancez la commande suivante :
sudo pip3 install requests
Il est possible d'activer et de désactiver le RRFRaptor par un simple code DTMF.
Si vous n'êtes pas familier avec les fichiers de paramétrages de SvxLink, il vous suffit de copier le fichier Logic.tcl que j'ai déjà modifié pour vous. Donc, depuis votre connexion SSH, lancer les commandes suivantes :
mv /usr/share/svxlink/events.d/local/Logic.tcl /usr/share/svxlink/events.d/local/Logic.tcl.bak
cp /opt/RRFRaptor/Logic.tcl /usr/share/svxlink/events.d/local/Logic.tcl
La première va faire une sauvegarde de votre fichier Logic.tcl (renommé en Logic.tcl.bak au cas ou). Et la seconde va copier le fichier Logic.tcl modifié afin de prendre en charge le RRFRaptor.
Le RRFRaptor pourra désormais être activé ou désactivé en envoyant le code DTMF 200.
Enfin, pour finir, redémarrez SvxLink à l'aide de la commande suivante :
/etc/spotnik/restart
Et voilà, c'est tout ;) Vous êtes pret à utiliser le RRFRaptor !
Le plus simple est de lancer le RRFRaptor en CLI (ligne de commande). Toujours depuis une connexion SSH,
- pour activer le RRFRaptor :
/opt/RRFRaptor/RRFRaptor.sh start - pour désactiver le RRFRaptor :
/opt/RRFRaptor/RRFRaptor.sh stop
Sinon, vous pouvez également activer ou désactiver le RRFRaptor à l'aide du code DTMF 200.
Dans tous les cas, une annonce vocale vous informera de l'activation ou de la désactivation du RRFRaptor.
Une fois activé, en l'absence d'activité durant 1 minute (par défaut), le RRFRaptor va commencer à analyser le trafic sur l'ensemble du réseau RRF à la recherche de QSO sur les autres salons et gérer lui même les QSY.
Le RRFRaptor dispose également d'une fonctionnalité de scan rapide. Cela permet de savoir si un QSO est en cours sur un salon, via une annonce vocale. Il n'est pas nécessaire que le RRFRaptor soit activé pour que cette fonctionnalité soit utilisable. On peut donc lancer un scan rapide à tous moments.
En CLI (ligne de commande), depuis une connexion SSH, lancez la commande suivante :
/opt/RRFRaptor/RRFRaptor.sh scan
Sinon, vous pouvez également utiliser le code DTMF 201.
S'il n'est pas forcément recommandé d'activer en permanence le RRFRaptor sur un relais, cette fonctionnalité de scan rapide peut s'avérer très intéressante partout. Un seul code DTMF peut renseigner les OM sur les QSO en cours sur les autres salons. À eux, si le RRFRaptor n'est pas activé, de gérer les QSY.
scan_sleep = 60(ligne 16)
Lorsqu'un QSO se termine, le RRFRaptor patiente pendant une certaine durée, avant de débuter la recherche de QSO sur les autres salons. C'est évidement sa fonction première. Par défaut, cette temporisation est de 60 secondes. Mais il est évidemment possible de la changer.
Vous pouvez éditer le fichier /opt/RRFRaptor/settings.py et modifier la variable scan_sleep (ligne 16) en indiquant une durée exprimée en secondes.
room_base = 'RRF'(ligne 20)
Quant le RRFRaptor est activé, le Spotnik a la possibilité d'aller sur l'ensemble des salons actifs et passifs (voir point ci dessus). Mais si un OM force un QSY (via commande DTMF ou autres moyens) sur un salon ne faisant pas partie de ces 2 listes, le RRFRaptor vous enverra vers le salon de base. Par défaut, ce salon de base est RRF. Mais il est évidemment possible de le changer.
Vous pouvez éditer le fichier /opt/RRFRaptor/settings.py et modifier la variable room_base (ligne 20) en indiquant un salon faisant partie de la listes des salons actifs : RRF, FON, TECHNIQUE, INTERNATIONAL, BAVARDAGE, LOCAL ou EXPERIMENTAL.
Exemple pratique. Si vous souhaitez suivre l'ensemble des salons actifs mais exclure le salon RRF et autoriser l'utilisation du PERROQUET, voici la configuration permettant de le faire en choisissant le salon TECHNIQUE comme salon de base :
room_base = 'TECHNIQUE' # Salon de base si le RRFRaptor est perdu...
room_active = ['FON', 'TECHNIQUE', 'INTERNATIONAL', 'BAVARDAGE', 'LOCAL', 'EXPERIMENTAL'] # Liste des salons actifs
room_passive = ['PERROQUET'] # Liste des salons passifs...
park = False(ligne 17)
park_sleep = 300(ligne 18)
Lorsqu'un QSO se termine, le RRFRaptor patiente pendant une certaine durée avant de débuter la recherche de QSO sur les autres salons. Par défaut, il reste sur la salon courant. Mais il est possible de lui demander de retourner préventivement sur le salon de base (voir point précédent).
Vous pouvez éditer le fichier /opt/RRFRaptor/settings.py et modifier la variable park (ligne 17) en indiquant True, si vous souhaitez retourner préventivement sur le salon de base.
En complément, toujours par défaut, la temporisation avant QSY sur le salon de base est de 300 secondes. Mais il est évidemment possible de la changer.
Vous pouvez éditer le fichier /opt/RRFRaptor/settings.py et modifier la variable park_sleep (ligne 18) en indiquant une durée exprimée en secondes.
Vous pouvez éditer le fichier /opt/RRFRaptor/settings.py et modifier la variable room_active (ligne 21) qui liste les salons actifs que vous souhaitez surveiller. Idem avec la variable room_passive (ligne 22) pour les salons passifs.
À noter qu'il existe 2 types de salons :
- Les salons actifs (ligne 21) : RRF, FON, TECHNIQUE, INTERNATIONAL, BAVARDAGE, LOCAL et EXPERIMENTAL
- Les salons passifs (ligne 22) : PERROQUET, REGIONAL, FREEDV, NUMERIQUE, ECHOLINK et ADMIN
Seuls les salons actifs font l'objet d'une surveillance par le RRFRaptor. La liste des salons passifs permet uniquement d'autoriser un QSY manuel (via commandes DTMF ou autres) sur ces salons, même si le RRFRaptor est enclenché. Dans ce cas, le timersalon.sh prendra en charge le QSY avec retour sur le salon RRF en l'absence d'activité pendant 6 minutes (valeur par défaut).
Enfin, retenez que si vous forcez un QSY vers un salon non référencé dans la liste des salons actifs ou des salons passifs, le RRFRaptor vous enverra vers le salon de base (RRF par défaut)
Il est évidemment possible de lancer le RRFRaptor au démarrage du Spotnik. Il suffit d'éditer le fichier /etc/rc.local et d'y ajouter les lignes suivantes, juste avant le exit 0 qui termine le script :
## demarrage Raptor
/opt/RRFRaptor/RRFRaptor.sh start
Depuis votre connexion SSH, lancez les commandes suivantes :
/opt/RRFRaptor/RRFRaptor.sh stop
cd /opt/RRFRaptor
git reset --hard
git pull
sudo pip3 install requests
/opt/RRFRaptor/RRFRaptor.sh start
Et voilà, votre version est à jour.
Si vous le souhaitez, vous pouvez modifier les codes DTMF par défaut et les adapter suivant vos besoins. Pour se faire, éditer le fichier /usr/share/svxlink/events.d/local/Logic.tcl à l'aide de votre éditeur préféré. Recherchez les blocs concernant les codes DTMF (vers les lignes 600...). Ajoutez et / ou modifiez les 4 nouveaux blocs ci dessous en les adaptant à votre convenance :
# 200 Raptor start and stop
if {$cmd == "200"} {
puts "Executing external command"
exec nohup /opt/RRFRaptor/RRFRaptor.sh &
return 1
}
# 201 Raptor quick scan
if {$cmd == "201"} {
puts "Executing external command"
exec /opt/RRFRaptor/RRFRaptor.sh scan
return 1
}
# 202 Raptor sound
if {$cmd == "202"} {
if { [file exists /tmp/RRFRaptor_status.tcl] } {
source "/tmp/RRFRaptor_status.tcl"
if {$RRFRaptor == "ON"} {
playSilence 1500
playFile /opt/RRFRaptor/sounds/active.wav
} else {
playSilence 1500
playFile /opt/RRFRaptor/sounds/desactive.wav
}
}
return 1
}
# 203 Raptor quick scan sound
if {$cmd == "203"} {
if { [file exists /tmp/RRFRaptor_scan.tcl] } {
source "/tmp/RRFRaptor_scan.tcl"
if {$RRFRaptor == "None"} {
playSilence 1500
playFile /opt/RRFRaptor/sounds/qso_ko.wav
} else {
playSilence 1500
playFile /opt/RRFRaptor/sounds/qso_ok.wav
if {$RRFRaptor == "RRF"} {
playFile /usr/share/svxlink/sounds/fr_FR/RRF/Srrf.wav
} elseif {$RRFRaptor == "FON"} {
playFile /usr/share/svxlink/sounds/fr_FR/RRF/Sfon.wav
} elseif {$RRFRaptor == "TECHNIQUE"} {
playFile /usr/share/svxlink/sounds/fr_FR/RRF/Stec.wav
} elseif {$RRFRaptor == "INTERNATIONAL"} {
playFile /usr/share/svxlink/sounds/fr_FR/RRF/Sint.wav
} elseif {$RRFRaptor == "BAVARDAGE"} {
playFile /usr/share/svxlink/sounds/fr_FR/RRF/Sbav.wav
} elseif {$RRFRaptor == "LOCAL"} {
playFile /usr/share/svxlink/sounds/fr_FR/RRF/Sloc.wav
} elseif {$RRFRaptor == "EXPERIMENTAL"} {
playFile /usr/share/svxlink/sounds/fr_FR/RRF/Sexp.wav
}
}
}
return 1
}
Attention, si vous modifiez également les codes 202 et 203 qui servent aux annonces vocales, vous devrez les modifiez également dans le script
/opt/RRFRaptor/RRFRaptor.sh. Ce changement n'est pas recommandé.
Bon trafic à tous, 88 & 73 de Armel F4HWN !