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 Bridge est hors ligne dans KiwiDesk
Section intitulée « Le Bridge est hors ligne dans KiwiDesk »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.
sudo systemctl restart kiwidesk-bridge, puis journalctl -u kiwidesk-bridge -n 50.
launchctl kickstart -k gui/$(id -u)/com.kiwidesk.bridge
docker compose -f docker-compose.bridge.yml restart, puis
docker logs kiwidesk-bridge --tail 50.
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.
L’imprimante n’imprime pas
Section intitulée « L’imprimante n’imprime pas »- 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.
Les ports série et USB (TPE, imprimante série)
Section intitulée « Les ports série et USB (TPE, imprimante série) »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.ymldevices:- /dev/ttyACM0:/dev/ttyACM0group_add:- dialoutpuis 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 :
sudo usermod -aG dialout,lp <compte-du-bridge>sudo systemctl restart kiwidesk-bridgeLe 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.
Le TPE ne répond pas
Section intitulée « Le TPE ne répond pas »- 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.
Avoir plus de détails
Section intitulée « Avoir plus de détails »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é.