Aller au contenu

Dépannage du Bridge

Commencez toujours par la page locale du Bridge (http://127.0.0.1:4242) : l’état de la connexion, l’état de chaque périphérique et le bloc Journal indiquent presque toujours la cause. Le journal complet est dans bridge.log, dans le dossier de données du Bridge.

Le poste est-il allumé, et le Bridge démarré ? Si la page locale ne répond pas, relancez-le :

Fermez la session et rouvrez-la, ou lancez la tâche planifiée « KiwiDesk Bridge » depuis le Planificateur de tâches.

Ensuite :

  • La page locale dit Hors ligne : le poste ne joint pas KiwiDesk (connexion Internet, proxy, pare-feu). Le Bridge réessaie seul, avec des délais croissants jusqu’à 30 secondes.
  • La page locale dit Révoqué : associez-le de nouveau, voir Associer le Bridge.
  • Imprimante réseau : l’adresse IP a-t-elle changé ? Donnez-lui une adresse fixe dans la box. Le bouton Scanner le réseau local retrouve les imprimantes qui écoutent sur le port 9100.
  • Imprimante USB sous Windows : déclarez-la par le nom exact de l’imprimante dans Windows (envoi brut au spouleur). L’imprimante doit être installée et partagée localement.
  • Caractères bizarres à la place des accents : changez la Table de caractères (PC858 ou Windows-1252).
  • État Plus de papier : remplacez le rouleau ; le Bridge reprend tout seul.
  • Le tiroir ne s’ouvre pas : la case Tiroir-caisse branché sur l’imprimante (RJ11) doit être cochée, et le câble branché sur la prise « DK » de l’imprimante, pas sur une prise téléphone.

Un TPE branché en USB apparaît comme un port série : COM3, COM4… sous Windows, /dev/ttyACM0 ou /dev/ttyUSB0 sous Linux, /dev/cu.usbmodem... sous macOS. Le Bridge complète un nom saisi sans dossier (ttyACM0 devient /dev/ttyACM0, com3 devient COM3). Le bouton Ports et imprimantes du poste liste les ports présents.

« le port n’existe pas »

  • Le TPE est-il branché, allumé et en mode USB série (CDC) ? Certains terminaux proposent plusieurs modes USB dans leur menu de configuration.

  • Sous Linux, ls -l /dev/ttyACM* /dev/ttyUSB* après avoir branché le câble. Le numéro peut changer d’un démarrage à l’autre quand plusieurs appareils sont branchés : préférez le chemin stable /dev/serial/by-id/....

  • Avec Docker, le port doit être donné au conteneur : ajoutez dans docker-compose.bridge.yml

    devices:
    - /dev/ttyACM0:/dev/ttyACM0
    group_add:
    - dialout

    puis redéployez. Un port listé mais absent de la machine empêche le conteneur de démarrer.

« accès refusé »

Sous Linux, le compte du Bridge doit appartenir au groupe dialout (ports série) et lp (imprimantes USB). Le script d’installation l’ajoute ; si vous avez installé autrement :

Fenêtre de terminal
sudo usermod -aG dialout,lp <compte-du-bridge>
sudo systemctl restart kiwidesk-bridge

Le changement de groupe ne compte qu’après une nouvelle session ou un redémarrage du service.

« déjà utilisé par un autre programme »

Un autre logiciel tient le port : ancien logiciel de caisse, logiciel du fabricant, ou, sous Linux, ModemManager, qui ouvre les ports /dev/ttyACM* en croyant y trouver un modem. Désactivez-le si la machine n’a pas de modem : sudo systemctl disable --now ModemManager.

  • En réseau : vérifiez l’adresse IP et le port du TPE (menu du terminal), et que le mode caisse (Concert / Caisse-AP) est activé. Scanner le réseau local sonde les ports 8888, 5000 et 2000.
  • Mauvais format : essayez l’autre Format des messages (Caisse-AP V3 ou Concert V2).
  • Résultat « Délai dépassé » : le TPE a reçu le montant mais n’a pas répondu à temps. Le résultat est inconnu : regardez le dernier ticket du terminal avant de relancer un paiement.
  • Annulation ignorée : normal sur de nombreux terminaux une fois la carte insérée ; annulez avec la touche rouge du TPE.

Mettez KIWIDESK_BRIDGE_DEBUG=1 (variable d’environnement du service ou du conteneur) puis redémarrez : le journal contient alors les échanges détaillés avec le matériel. Remettez-la à vide une fois le problème trouvé.