Diagnostic : quoi regarder, quoi envoyer

Avant de chercher, lisez ce que le système dit déjà : il nomme presque toujours la machine, la caisse ou l’étape en cause. Si cela ne suffit pas, envoyez à l’éditeur deux fichiers : les journaux du PC de salle et, pour un boîtier, sa trace.

1. Les signes à lire d’abord

Où	Ce qu’on y lit
Back-office → Alertes	Chaque problème en cours, en phrase : boîtier hors ligne, compteurs muets, transfert incertain, sauvegarde ou mise à jour en échec… Voir Alertes et le Catalogue des alertes.
L’écran du boîtier	L’étape qui manque (PAS DE RESEAU, CHERCHE SERVEUR, SERVEUR REFUSE, MACHINE MUETTE…). Voir Boîtiers : brancher, flasher, vérifier.
Exploitation → Boîtiers	Firmware, adressage, dernier contact de chaque boîtier ; Faire sonner pour retrouver le bon.
Paramètres → Mises à jour	La version, le dernier résultat et le journal du service de mise à jour.
Paramètres → Sauvegardes	L’état des sauvegardes, le dernier échec, le journal.
Paramètres → Plateforme	La liaison avec la plateforme : envois en attente, dernier refus et sa phrase.
La caisse	Ses bandeaux : serveur en maintenance, serveur injoignable, caisse à mettre à jour. Voir Quand la liaison tombe.
Journal d’audit	Qui a fait quoi, quand. Voir Journal d’audit.

Les cas les plus fréquents

Symptôme	Regardez d’abord
Un boîtier n’apparaît pas	Son écran. SERVEUR REFUSE → Le réseau de la salle. A ADOPTER → Exploitation → Boîtiers en attente.
« boîtier hors ligne »	Câble réseau, alimentation du boîtier ; son écran.
« machine SAS muette (câble ?) » / MACHINE MUETTE	Le câble entre le boîtier et la machine.
« compteurs muets »	Le boîtier parle au serveur mais ne remonte plus de compteurs : liaison avec la machine.
Aucune caisse ne se connecte	Le PC de salle est-il allumé ? En maintenance (mise à jour, restauration) ? Sur le même réseau ?
Rien ne s’enregistre, tout est grisé	Paramètres → Mises à jour : une mise à jour ou une restauration est peut-être en cours.

2. Le fichier de journaux du PC de salle

Sur le PC de salle, une commande rassemble en un fichier tout ce qu’il faut pour comprendre un problème : les journaux des services du serveur et des extraits de la base des 7 derniers jours. Il ne contient ni mot de passe ni réglage secret.

📍 À taper sur : PC de la salle (Ubuntu)

sudo bash /opt/lucky-touch/current/deploy/collect-logs.sh

Par défaut, les journaux couvrent les 48 dernières heures ; pour une autre durée, ajoutez par exemple --since 24h. La commande affiche à la fin le chemin du fichier créé, lucky-logs-<date>.tar.gz (dans le dossier de la version en service). Envoyez-le à l’éditeur. Ce fichier contient des opérations de la salle : ne le transmettez qu’à l’éditeur.

Le service de mise à jour et de sauvegarde

Pour lire l’état du service qui installe les versions et fait les sauvegardes (étape en cours, dernière erreur) : sudo lt-updater status. S’il ne répond plus, redémarrez le PC de la salle ; sinon appelez l’éditeur.

3. La trace d’un boîtier

Quand un problème touche une machine précise (transfert refusé, impulsions, réseau du boîtier), la trace raconte tout ce que fait le boîtier. Le boîtier se comporte exactement comme d’habitude pendant ce temps.

1. Branchez le boîtier en USB à un PC Windows qui a le paquet de flash (voir Boîtiers : brancher, flasher, vérifier).
2. Dans le dossier du paquet, lancez le mode diagnostic, avec le port du boîtier :

   📍 À taper sur : PC Windows (dossier du paquet de flash)

   diagnostic.cmd COM5

   Il installe le firmware de trace, puis ouvre la console, qui enregistre tout dans le dossier logs (serial-COM5-<date>.log).
3. Reproduisez le problème sur la machine.
4. Arrêtez l’enregistrement (Ctrl+C) et envoyez ce fichier, avec le fichier de journaux du PC de salle (§2).
5. Revenez au firmware normal : flash.cmd COM5. Le boîtier garde ses réglages et ce qu’il a appris.

Sous Linux, ./flash.sh /dev/ttyACM0 trace installe le firmware de trace ; la commande affiche ensuite comment enregistrer la console.

Lire la trace (pour une première idée) : les lignes lan:… et mqtt:… parlent du réseau — mqtt:UP = le boîtier est connecté au serveur ; lan:server refused = un autre serveur a répondu à sa place (voir Le réseau de la salle). Les lignes pulse:… concernent les machines à pièces : pulse:front = une impulsion, pulse:xfer_refus suivi d’une raison = un refus.

Ce qu’il faut dire à l’éditeur

• la salle, la machine (son numéro) ou la caisse concernée ;
• l’heure où le problème s’est produit, à la seconde si possible (par exemple 14:32:05) ;
• ce qui était affiché (phrase exacte de l’alerte ou du refus, écran du boîtier) ;
• les deux fichiers ci-dessus.