Surveillance et dépannage

Utiliser des preuves, pas des suppositions

Commencez par sécuriser le réseau. Notez l’heure exacte et la dernière action réussie, puis consultez le moniteur concerné avant de modifier adresses, itinéraires ou géométrie. Changez une seule chose à la fois et répétez le même essai. Modifier plusieurs objets au hasard peut masquer la cause initiale et créer de nouvelles incohérences. Les dialogues de refus, infobulles d’état et journaux RailKernel sont conçus pour expliquer pourquoi une opération s’est arrêtée ; lisez-les avant de reconstruire quoi que ce soit.

Identifier la couche incorrecte

Modèle du projet

Voies, connecteurs, cantons, appartenance des contacts, accessoires, itinéraires, placement des trains et configuration. Les Statistiques du projet et prévisualisations testent principalement cette couche.

Exécution RailKernel

Occupation réelle, états des accessoires, réservations, mouvements en attente ou en pause, stationnements et itinéraires calculés. Les Moniteurs de rétrosignalisation, des accessoires et des trains exposent cette couche.

Centrale numérique

Les messages envoyés par RailKernel et les événements reçus. L’aperçu de la centrale, l’état de connexion et la journalisation du protocole exposent cette couche.

Réseau physique

Position réelle des aiguillages, câblage des détecteurs, matériel roulant, alimentation, déraillements et pannes mécaniques. Seule l’observation directe confirme cette couche.

Commencer par les Statistiques du projet

Ouvrez Affichage > Statistiques du projet avant de tester la conduite automatique. Le tableau de bord commence par une bannière de préparation verte ou rouge et une vue visuelle des voies, connexions et définitions opérationnelles. Une bannière rouge signifie qu’un ou plusieurs objets de voie commutables n’ont pas encore de définition d’accessoire. La conduite automatique reste bloquée jusqu’à ce que chaque aiguillage, aiguillage courbe, croisement, traversée-jonction double et aiguillage triple participant au routage en possède une. RailKernel identifie ces objets par le nom du catalogue, un type compréhensible et leur position sur le canevas plutôt que par un GUID interne.

Overview

Affiche le nombre d’objets de voie, la longueur à l’échelle et réelle, les sections connectées, connecteurs ouverts, accessoires, contacts, cantons, locomotives et trains. Les nombres techniques de nœuds et d’arêtes restent disponibles comme information complémentaire.

Automatic driving

Indique clairement si l’infrastructure d’accessoires requise est complète. Si une intervention est nécessaire, chaque objet commutable sans accessoire est indiqué avec son type et sa position x/y afin de le retrouver sur le canevas.

Layout issues

Répertorie les connecteurs ouverts et les objets de voie hors de la plus grande partie connectée du réseau. RailKernel utilise si possible les noms, numéros de connecteur et positions. Corrigez ces défauts géométriques avant la génération des cantons ou la recherche d’itinéraire.

Feedback integrity

Détecte les contacts sans canton, affectés à plusieurs cantons ou partageant une même adresse physique. Les entrées utilisent le nom opérationnel et l’adresse complète.

Reliability

Regroupe les contacts et accessoires volontairement marqués peu fiables avec nom, adresse, type et protocole. Il s’agit d’une liste de maintenance, pas d’une invitation à ignorer les défauts récurrents.

Un GUID n’apparaît plus que comme référence interne pour une entrée endommagée ou orpheline que RailKernel ne peut plus associer à un objet compréhensible. Après correction, rouvrez les Statistiques du projet et vérifiez la bannière ainsi que les onglets concernés. Examinez aussi les itinéraires enregistrés après toute modification structurelle.

Moniteur de rétrosignalisation : qu’est-ce qui est occupé ?

Le Moniteur affiche les contacts en direct connus du projet et des centrales. Utilisez-le pour vérifier adresse, bus et module et observer les transitions LIBRE/OCCUPÉ en actionnant un détecteur à la fois. Si un détecteur fonctionne dans la centrale mais pas dans RailKernel, comparez son identité complète, pas seulement son numéro final, puis vérifiez les longueurs de bus et la centrale sélectionnée. Un contact qui change de manière inattendue est une preuve ; ne l’inversez pas simplement avant de comprendre le câblage et la polarité.

Moniteur des accessoires : comparer le projet et la centrale

Le Moniteur superpose les accessoires du réseau aux appareils importés d’une centrale compatible. Ses états distinguent les définitions présentes seulement dans le projet, concordantes, présentes seulement dans la centrale ou conflictuelles. Les accessoires sans adresse sont volontairement ignorés. Double-cliquez sur un conflit pour son explication. Si un aiguillage ne bouge pas, vérifiez centrale, protocole, adresse, demi-sortie ou définition multi-adresses, état actuel et par défaut et décodeur physique. Une commande visible dans le journal sans mouvement physique oriente le diagnostic vers la centrale, le décodeur, le câblage ou la mécanique plutôt que vers le routage.

Moniteur des trains : pourquoi un train attend-il ?

Le Moniteur des trains affiche chaque opération en attente, en marche, en stationnement, en pause ou réservée. Lisez l’infobulle État, la destination et les cantons réservés avant d’appuyer sur Libérer ou Abandonner. EN PAUSE signifie souvent que RailKernel attend en sécurité un corridor et peut reprendre automatiquement. Démarrer lance un mouvement en attente, Arrêter le cycle le termine progressivement, Abandonner supprime une opération et l’Arrêt d’urgence concerne tout le réseau.

Journal de conduite : reconstruire la décision

Le Journal de conduite enregistre la séquence de l’exploitation automatique : choix d’itinéraire, réservation du corridor, accessoires requis, commandes de locomotive, changements de contacts, freinage, stationnement, poursuite, pause, libération et alarmes. Recherchez autour de l’heure exacte du symptôme et suivez le nom d’un seul train. La question utile n’est pas seulement « qu’est-ce qui a échoué ? », mais « quelle était la dernière condition de sécurité que RailKernel pouvait encore prouver ? ». Copiez la section pertinente avant de redémarrer.

Journaux des protocoles des centrales

La boîte Centrales numériques fournit une journalisation en direct limitée pour les connexions CS3, ECoS et Z21 prises en charge. Chaque journal affiche l’heure, un mnémonique lisible et la trame ou le message du protocole, avec Effacer, Copier et Fermer. Utilisez-le pour répondre à deux questions : RailKernel a-t-il envoyé la commande attendue, et la centrale a-t-elle envoyé la réponse ou l’événement attendu ? Une commande sortante absente suggère l’état ou la configuration de l’application ; une commande correcte sans réponse suggère la connexion ou le protocole ; un échange correct sans action physique suggère le matériel. Effacez le journal juste avant une courte reproduction.

Lorsqu’une centrale ne se connecte pas

• Confirmez que la centrale est activée dans Connexions et que son type, son nom, son hôte et son port sont corrects.
• Lisez le message de progression au démarrage pour voir si le chargement de la configuration, la connexion, le téléchargement des données ou la lecture de l’état initial constitue l’étape lente.
• Utilisez Analyser le réseau lorsqu’il est pris en charge, mais vérifiez que l’appareil découvert est bien la centrale que vous souhaitez commander.
• Vérifiez que l’ordinateur et la centrale se trouvent sur des réseaux accessibles et qu’aucune autre application n’occupe exclusivement l’interface.
• Ouvrez le journal de protocole et effectuez une petite action. Une absence de trafic et un trafic rejeté sont deux pannes différentes.
• Désactivez temporairement les centrales sans rapport lorsque vous isolez un problème de démarrage ou de délai d’attente.

Symptômes courants et meilleur premier contrôle

Impossible de placer le train

Cliquez sur l’explication et vérifiez le contact de sortie occupé, l’appartenance unique au canton, la réservation du canton et la disponibilité d’un Train simple non placé.

Impossible de déplacer le train

Utilisez le dialogue d’explication. Vérifiez la cohérence du projet, la vitesse du canton source, l’état GO de la centrale, l’identité du train et de la locomotive, l’occupation du canton suivant et les protections d’accessoires manquantes.

Le train reste en pause

Lisez son infobulle dans le Moniteur des trains et son corridor réservé. Attendez d’abord le train qui bloque ; n’utilisez Libérer que si les réservations conservées par ce train sont connues comme obsolètes.

L’aiguillage ne bouge qu’à l’écran

Comparez le Moniteur des accessoires et la commande de protocole sortante, puis vérifiez l’adresse, la sortie, l’alimentation et la mécanique du décodeur.

L’aiguillage ne bouge que physiquement

Recherchez l’événement de retour et vérifiez qu’il correspond à la même centrale, au même protocole et à la même adresse que l’accessoire du projet.

Le contact est correct après un changement mais faux au démarrage

Examinez le trafic d’état initial et l’identité complète bus/module/contact. Une transition réelle correcte plus tard ne prouve pas que la découverte et la synchronisation initiales sont correctes.

Arrêts d’urgence répétés

Utilisez le contact et l’heure signalés. Vérifiez le matériel roulant inattendu, les rebonds ou la polarité du détecteur, la mauvaise appartenance au canton, les règles d’action et l’écart entre les positions physiques et numériques.

La prévisualisation omet une infrastructure

Examinez l’itinéraire enregistré et les tronçons d’accessoires calculés. La prévisualisation montre ce que l’itinéraire contient réellement ; une infrastructure orange manquante indique généralement des données d’itinéraire manquantes, pas seulement un problème de dessin.

Préparer un rapport de problème utile

Indiquez la version de RailKernel, le système d’exploitation, le type et la version logicielle de la centrale, l’heure locale exacte, la plus petite séquence reproductible, le résultat attendu et observé, la capture du moniteur concerné et les lignes copiées du Journal de conduite ou du protocole. Exportez ou téléversez en privé le projet lorsque la géométrie ou le routage est concerné. Précisez si le problème persiste après un redémarrage et s’il survient avec une seule centrale activée. Ne publiez jamais licences, mots de passe, clés privées ou données personnelles sans rapport.

Conserver un point de référence fiable

Validez les modifications du code source et conservez des sauvegardes datées du projet avant toute modification structurelle ou expérience de routage. Lorsqu’une régression apparaît, reproduisez-la une fois, conservez les preuves et comparez avec le dernier état fiable. Annuler une modification isolée est beaucoup plus sûr que réparer une chaîne croissante de corrections spéculatives. La surveillance n’est pas secondaire : elle rend un système physique et numérique complexe maintenable.