TRX Console : mode d'emploi

TRX distant version 0.52.0

TRX Console est le tableau de commande de la station TRX distant, sur le PC (ou le Raspberry Pi) relié au poste. Elle sert à installer et configurer la station, la démarrer, l'essayer, la mettre à jour et la dépanner. Elle s'ouvre depuis le menu des applications (« TRX Console ») ou en tapant trx-console dans un terminal.

Elle n'émet jamais d'elle-même : les seuls menus qui peuvent faire passer le poste en émission sont l'essai complet (menu 4, avec confirmation à chaque étape) et, bien sûr, la station une fois démarrée, pilotée depuis la page web.

Premier déploiement ? Suis le parcours ci-dessous dans l'ordre. Station déjà en service ? Va directement à la référence des menus. Tu aides à déboguer ? Voir la partie « Dépannage avancé ».

Premier déploiement
Les menus
Dépannage avancé

Premier déploiement, pas à pas

Installer le logiciel
Sur un PC Debian 12 ou 13 avec bureau : décompresse le paquet trx-remote-debian-X.Y.Z.zip dans Téléchargements, ouvre un terminal dans le dossier obtenu et tape :
```
sudo bash install.sh
```
Ton mot de passe de session est demandé (rien ne s'affiche pendant la frappe : c'est normal). À la fin, déconnecte-toi puis reconnecte-toi pour que les droits soient pris en compte.

Tu viens d'une station Windows ? Pose son fichier station.toml à côté de install.sh avant de lancer l'installation : comptes, bandes et alertes seront repris.
Configurer la station (menu 2)
Au premier lancement, TRX Console propose l'assistant. Il demande, dans l'ordre : le modèle du poste (liste Hamlib), le port série du CAT, la méthode de PTT, les cartes son (réception et émission), les bandes autorisées à l'émission, l'accès réseau et le premier compte (identifiant et mot de passe pour la page web).

Le poste est interrogé en lecture seule pendant l'assistant : aucune émission. Rien n'est enregistré si tu abandonnes en cours de route.
Vérifier (menu 1)
Le diagnostic passe tout en revue sans rien modifier. Chaque ligne est OK, à surveiller ou en échec, avec la marche à suivre. Corrige les échecs avant d'aller plus loin (menu 14 pour retoucher la configuration, ou relance l'assistant).
Essayer le poste (menu 4)
Avant tout, la carte son du poste ne doit pas être le son par défaut du PC : sous Debian, Paramètres > Son, choisis en sortie les haut-parleurs du PC et en entrée son micro (sous Windows, Paramètres > Système > Son). Sinon le bureau occupe la carte et ses sons partent vers le poste.

Commence par l'essai en réception seule (choix 1) : liaison CAT, son reçu, changement de fréquence et de mode, largeurs de filtre, spectre. Ensuite seulement, l'essai complet (choix 2) vérifie l'émission : charge fictive obligatoire, puissance réduite, confirmation demandée à chaque étape. La station est arrêtée pendant l'essai.
Démarrer (menu 5) et se connecter
Le menu 5 démarre la station ; refais un diagnostic (menu 1) quelques secondes plus tard. Sur le téléphone ou un autre PC du même réseau, ouvre https://<adresse-de-la-station>:8443 et connecte-toi avec le compte créé par l'assistant. Pour l'accès depuis l'extérieur, voir la documentation « Accès distant » du projet.

Les menus de la console

Tape le numéro du menu puis Entrée ; q pour quitter. Les réponses aux questions (oui, non, OUI, EMETTRE...) ne tiennent compte ni des majuscules ni des accents. Mot de passe : le menu demande ton mot de passe de session (sudo).

Diagnostic complet

À quoi il sert: Contrôle complet de la station, en lecture seule : système, logiciels, configuration, matériel (ports série, cartes son), services, spectre HF, Cluster DX, accès réseau et mises à jour.
Quand: Après l'installation, après chaque changement, et en premier réflexe dès que quelque chose ne va pas.
Ce qu'il modifie: Rien. Aucune commande au poste, aucune émission.
Droits: non

Même résultat sans le menu : trx-console --diagnostic (code de sortie différent de 0 en cas d'échec, utilisable dans un script).

Assistant de configuration

À quoi il sert: Assistant de configuration : poste, ports, PTT, cartes son, bandes autorisées, accès réseau, comptes. Écrit station.toml.
Quand: Au premier déploiement, ou pour tout reprendre (changement de poste, d'interface audio, de PC).
Ce qu'il modifie: station.toml (seulement si tu vas au bout). La station est arrêtée pendant l'assistant puis redémarrée à la demande.
Droits: mot de passe de session demandé

Le poste n'est interrogé qu'en lecture. Une configuration importée d'une ancienne station (station.import.toml) sert de point de départ.

Essai du poste (CAT, audio, PTT)

À quoi il sert: Essai guidé du vrai poste. Choix 1 : réception seule (CAT, son reçu, accord, largeurs de filtre, écran du spectre). Choix 2 : la même chose puis l'émission.
Quand: Après l'assistant, après un changement de câble ou d'interface audio, ou pour qualifier un nouveau poste.
Ce qu'il modifie: Rien dans la configuration. Le choix 2 fait émettre le poste : charge fictive, puissance réduite, confirmation (taper EMETTRE) à chaque étape. La station est arrêtée pendant l'essai.
Droits: mot de passe de session demandé

Le résumé final de l'essai s'affiche à l'écran : copie-le dans ta demande d'aide. Les réponses tapées ne tiennent compte ni des majuscules ni des accents (« emettre », « Émettre » et « EMETTRE » sont acceptés).

Rapport de dépannage (zip sur le Bureau)

À quoi il sert: Crée un rapport de dépannage (fichier zip sur le Bureau) : diagnostic, journaux, configuration sans aucun mot de passe, versions, matériel détecté, rapports envoyés depuis la page, identifiant de la station.
Quand: Pour demander de l'aide : joins ce zip à ta demande.
Ce qu'il modifie: Rien (un fichier est créé sur le Bureau).
Droits: non

Sans le menu : trx-console --rapport. Le fichier station.toml du rapport a ses secrets masqués ; vérifie quand même son contenu avant de l'envoyer si tu le souhaites.

Mise à jour de TRX distant

À quoi il sert: Mise à jour par Internet : affiche la nouvelle version, ses notes, puis l'installe après vérification de sa signature.
Quand: Quand l'en-tête du menu annonce « Nouvelle version disponible ».
Ce qu'il modifie: Installe la nouvelle version à côté de l'ancienne (gardée pour le menu 11). station.toml et les certificats sont conservés. Refusé tant que le poste émet. Il faut taper le numéro de version pour confirmer.
Droits: mot de passe de session demandé

Installer une version depuis un fichier zip (Bureau, Téléchargements)

À quoi il sert: Installe une version à partir d'un fichier trx-remote-debian-X.Y.Z.zip déposé sur le Bureau, dans Téléchargements ou dans le dossier personnel.
Quand: Station sans Internet, version d'essai, ou retour à une version précise.
Ce qu'il modifie: Comme le menu 10 : nouvelle version à côté de l'ancienne, configuration conservée. Un paquet non signé demande de taper OUI puis le numéro de version.
Droits: mot de passe de session demandé

Déposer le zip ne suffit pas : il faut l'installer ici. Compte-rendu : /var/log/trx-remote-install.log.

Modifier la configuration (station.toml)

À quoi il sert: Modifie station.toml dans l'éditeur nano, sur une copie.
Quand: Pour un réglage précis sans relancer tout l'assistant.
Ce qu'il modifie: station.toml, seulement si la copie est valide : elle est vérifiée, les différences sont montrées, une confirmation est demandée et l'ancienne version est gardée à côté. Une configuration invalide n'est jamais écrite.
Droits: mot de passe de session demandé

Dans nano : Ctrl+O puis Entrée pour enregistrer, Ctrl+X pour quitter. Les copies de sauvegarde s'appellent station.toml.avant-modification-AAAAMMJJ-HHMMSS.

Menu expert (tests automatiques du logiciel)

À quoi il sert: Menu expert : lance toute la suite de tests automatiques du logiciel sur la station.
Quand: Pour aider au débogage, ou vérifier qu'une installation est saine.
Ce qu'il modifie: Rien. Les tests utilisent un poste simulé : aucune commande au vrai poste, aucune émission. La station est arrêtée pendant les tests (7 à 10 minutes sur un PC récent, 30 minutes ou plus sur un petit PC) puis relancée à la demande.
Droits: mot de passe de session demandé

Le résultat est enregistré sur le Bureau (trx-remote-tests-AAAAMMJJ-HHMM.txt) : transmets ce fichier si des tests échouent. L'outil de test (pytest) est installé au premier usage (Internet nécessaire).

Les points s'affichent au fur et à mesure ; sans rien de nouveau pendant une minute, la console rappelle que les tests continuent. Un test vraiment bloqué 10 minutes affiche la pile de ses fils d'exécution : c'est ce qu'il faut transmettre (Ctrl+C arrête les tests).

Seuils de température du poste (avertissement, coupure)

À quoi il sert: Seuils de température du poste : premier seuil (avertissement dans la page et notification), second seuil (émission à distance coupée et refusée jusqu'au retour sous le premier seuil). 40 et 50 °C par défaut.
Quand: Si ton poste chauffe en usage normal (modes numériques en continu, par exemple) ou pour plus de prudence.
Ce qu'il modifie: Les clés rig_temp_warn_c et rig_temp_cut_c de station.toml, par le même chemin vérifié que le menu 14.
Droits: mot de passe de session demandé

Sans effet si le poste ne donne pas sa température par Hamlib (cas de l'IC-7300MK2). L'opérateur au micro du poste n'est jamais coupé pour ce motif.

Indicateur dans la barre du haut (GNOME : état de la station en permanence)

À quoi il sert: Active ou désactive l'indicateur de la barre du haut (bureau GNOME) : un voyant à gauche du son (vert réception, rouge émission, orange alerte, gris station arrêtée, violet mode sûr), la fréquence ou le compte à rebours d'émission, et au clic l'état complet : émission, fréquence et filtre, clients web connectés, liaison avec le poste, opérateur sur place, dernière coupure, température, alimentation, spectre HF, Cluster DX, mise à jour disponible, version et identifiant.
Quand: Une fois, après l'installation (puis une déconnexion et reconnexion), pour garder un œil sur la station en permanence.
Ce qu'il modifie: Seulement l'affichage de ton bureau. L'indicateur ne fait que LIRE l'état publié par la station : il ne peut rien commander.
Droits: non

Fichiers lus chaque seconde : /run/trx-remote/gateway-status.json, et dans /var/lib/trx-remote/ : safe_mode, cluster/status.json, update/latest.json, station-id. Extension installée dans /usr/share/gnome-shell/extensions/trx-distant@rf-diy.com. Le menu de l'indicateur ouvre aussi la page web, TRX Console et le tableau de bord.

Profils de poste (plusieurs TRX : enregistrer, charger, supprimer)

À quoi il sert: Profils de poste, pour qui pilote plusieurs TRX tour à tour : enregistrer la configuration du poste en service sous un nom (« IC-7300 maison »), la recharger plus tard, ou supprimer un profil. Le profil en service est signalé dans la liste.
Quand: Après avoir configuré et essayé un poste (menus 2 et 4) : enregistre-le. Pour changer de poste : branche-le, charge son profil, la station redémarre avec lui.
Ce qu'il modifie: Charger un profil ne change que les réglages du POSTE dans station.toml (modèle, ports, PTT, cartes son, spectre), par le même chemin vérifié que le menu 14 (différences montrées, confirmation, ancienne version gardée). Comptes, réseau, bandes autorisées et sécurités ne bougent jamais. Refusé pendant une émission.
Droits: mot de passe de session demandé

Fichiers : /etc/trx-remote/profils/<nom>.toml. Chaque profil porte un numéro de format. Un profil d'une ancienne version est converti au chargement quand c'est possible (une clé manquante prend sa valeur par défaut) ; sinon, ou s'il vient d'une version plus récente, il est refusé avec la marche à suivre : refaire la configuration de ce poste (menu 2) puis l'enregistrer de nouveau. Le fichier d'origine n'est jamais modifié au chargement.

Appairer un téléphone (application Android : adresse, empreinte du certificat)

À quoi il sert: Affiche ce qu'il faut pour appairer l'application Android avec cette station : l'adresse à saisir, les comptes autorisés et l'empreinte du certificat (SHA-256, sur deux lignes). L'application montre la même empreinte à la première connexion : si elles diffèrent, ne pas continuer. Aucun mot de passe n'est affiché : la station ne les connaît pas en clair.
Quand: Au moment d'ajouter la station dans l'application Android, et après avoir refait le certificat (menu 2).
Ce qu'il modifie: Rien : lecture seule.
Droits: non

Même affichage en ligne de commande : trx-setup --output /etc/trx-remote/station.toml --empreinte. Si le certificat n'est lisible que par la station, la console le relit avec les droits d'administration. Station limitée à cette machine (boucle locale) : aucun téléphone ne peut s'y connecter, la console le dit. Derrière un proxy HTTPS, l'empreinte à épingler est celle du certificat du proxy.

Dépannage avancé

En-tête de la console

La première ligne donne la version installée, la deuxième l'état (en marche, arrêtée, pas encore configurée), la troisième l'identifiant de la station : un code unique créé au premier démarrage, qui permet de rapprocher plusieurs rapports d'une même station. Il n'est envoyé nulle part automatiquement.

Fichiers utiles (Debian)

/etc/trx-remote/station.toml : configuration (modifier par le menu 14).
/var/lib/trx-remote/ : état de la station (mode sûr, mémoires, rapports de la page, identifiant station-id, Cluster DX).
/run/trx-remote/gateway-status.json : état en direct publié par la passerelle (lu par le tableau de bord).
/opt/trx-remote/releases/ : versions installées côte à côte ; /opt/trx-remote/current pointe sur la version active.
/var/log/trx-remote-install.log : compte-rendu des installations et mises à jour.

Relevés sur le poste (lecture seule)

Pour un poste Icom avec un second port CI-V (spectre), un relevé brut des réglages, sans aucune écriture, aide à établir le format réel des réponses. Station arrêtée (menu 6), puis :

/opt/trx-remote/current/venv/bin/python -m trxstation.devtools.civ_scope --port /dev/serial/by-id/<port-B> --reglages

Le résultat est enregistré dans un dossier spectre-reglages-… : joins-le à ta demande.

Transmettre un problème

Dans la page web : section « Signaler un problème » (texte relu avant l'envoi).
Sur la station : menu 8 (rapport de dépannage), et si besoin le résultat du menu 15.
Décris ce que tu faisais, ce que tu attendais et ce qui s'est passé, avec l'heure approximative.

TRX Console : mode d'emploi

Premier déploiement, pas à pas

Installer le logiciel

Configurer la station (menu 2)

Vérifier (menu 1)

Essayer le poste (menu 4)

Démarrer (menu 5) et se connecter