Guida

Monitoraggio e risoluzione dei problemi

Una buona diagnosi confronta tre realtà: ciò che secondo il progetto RailKernel dovrebbe accadere, ciò che comunica la centrale e ciò che fa realmente la ferrovia fisica.

Usa prove, non supposizioni

Metti innanzitutto in sicurezza la ferrovia. Annota l’ora esatta e l’ultima azione riuscita, poi esamina il monitor pertinente prima di cambiare indirizzi, itinerari o geometria. Modifica una sola cosa alla volta e ripeti la stessa prova. Cambiamenti casuali a più oggetti possono nascondere la causa originale e creare nuove incoerenze. Le finestre di rifiuto, i suggerimenti di stato e i registri RailKernel sono progettati per spiegare perché un’operazione si è fermata; leggi tali messaggi prima di ricostruire qualsiasi cosa.

Individuare quale livello è errato

Modello del progetto: Binari, connettori, blocchi, appartenenza dei feedback, accessori, itinerari, posizionamento dei treni e configurazione. Statistiche progetto e anteprime verificano principalmente questo livello.
Stato operativo RailKernel: Occupazione reale, stato degli accessori, prenotazioni, movimenti in coda e in pausa, sessioni di sosta e itinerari calcolati. I Monitor Feedback, Accessori e Treni mostrano questo livello.
Centrale: I messaggi inviati da RailKernel e gli eventi ricevuti. Panoramica della centrale, stato della connessione e registrazione del protocollo mostrano questo livello.
Ferrovia fisica: Posizione reale dei deviatoi, cablaggio dei rilevatori, materiale rotabile, alimentazione, deragliamenti e guasti meccanici. Soltanto l’osservazione diretta può confermare questo livello.

Inizia dalle Statistiche progetto

Apri Vista > Statistiche progetto prima di provare la guida automatica. Il quadro inizia con un indicatore verde o rosso di preparazione e una panoramica visiva di binari, connettività e definizioni operative. Un indicatore rosso significa che uno o più oggetti ferroviari commutabili non hanno ancora una definizione di accessorio; la guida automatica rimane bloccata finché ogni deviatoio, deviatoio curvo, incrocio, inglese doppio e deviatoio a tre vie coinvolto negli itinerari ne possiede una. RailKernel identifica questi oggetti tramite nome di catalogo, tipo comprensibile e posizione nell’area di lavoro, anziché mostrare un GUID interno.

Panoramica: Mostra conteggi degli oggetti ferroviari, lunghezza dei binari in scala e reale, sezioni collegate, connettori aperti, accessori, feedback, blocchi, locomotive e treni. I conteggi tecnici di nodi e archi del grafo restano disponibili come informazioni di supporto.
Guida automatica: Indica chiaramente se l’infrastruttura di accessori richiesta è completa. Quando è necessario intervenire, elenca ogni oggetto ferroviario commutabile che richiede un accessorio e ne mostra tipo e posizione x/y per trovarlo nell’area di lavoro.
Problemi del plastico: Elenca connettori aperti e oggetti ferroviari esterni alla parte collegata più grande del plastico. Dove possibile usa nomi, numeri dei connettori e posizioni. Correggi questi difetti geometrici prima di affidarti alla generazione dei blocchi o alla ricerca degli itinerari.
Integrità dei feedback: Individua feedback esterni a ogni blocco, assegnati a più blocchi e indirizzi fisici duplicati. Le voci sono mostrate con nome operativo e indirizzo completo.
Affidabilità: Raccoglie feedback e accessori deliberatamente contrassegnati come inaffidabili, usando nomi, indirizzi, tipi e protocolli. È un elenco di manutenzione, non un invito a ignorare guasti ricorrenti.

Un GUID compare soltanto come riferimento interno per una voce danneggiata o orfana del progetto che RailKernel non riesce più a risolvere in un oggetto comprensibile all’utente. Dopo aver corretto il progetto, riapri Statistiche progetto e conferma che l’indicatore di preparazione e le schede pertinenti siano liberi da problemi. Esamina inoltre gli itinerari salvati dopo modifiche strutturali.

Monitor Feedback: che cosa è occupato?

Il Monitor Feedback mostra i contatti reali conosciuti dal progetto e dalle centrali. Usalo per verificare indirizzo, assegnazione di bus e modulo e osservare le transizioni FREE/OCCUPIED azionando un rilevatore alla volta. I colori configurati distinguono contatti normali, occupati e speciali o legati ad azioni. Se un rilevatore funziona sulla centrale ma non in RailKernel, confrontane l’identità completa, non soltanto il numero finale del contatto, e controlla lunghezze dei bus e centrale selezionata. Un contatto che cambia inaspettatamente è una prova; non limitarvi a invertirlo finché non comprendi il cablaggio e la polarità configurata.

Monitor Accessori: confrontare progetto e centrale

Il Monitor Accessori sovrappone gli accessori del plastico ai dispositivi importati da una centrale capace. Gli stati distinguono definizioni solo progetto, corrispondenti, solo centrale e in conflitto. Gli accessori privi di indirizzo sono intenzionalmente irrilevanti per il confronto reale. Fai doppio clic su un conflitto per la spiegazione. Se un deviatoio non si muove, verifica centrale, protocollo, indirizzo, metà dell’uscita o definizione a più indirizzi, stato corrente rispetto al predefinito e decoder fisico. Un comando nel registro del protocollo senza movimento fisico sposta l’indagine dall’instradamento verso centrale, decoder, cablaggio o meccanismo.

Monitor Treni: perché un treno attende?

Il Monitor Treni mostra ogni operazione in coda, in esecuzione, in sosta, in pausa o prenotata. Leggi il suggerimento Stato, la destinazione e i blocchi prenotati prima di premere Libera o Interrompi. PAUSED significa spesso che RailKernel attende in sicurezza un corridoio e può riprendere automaticamente quando l’infrastruttura diventa disponibile. Avvia esegue il lavoro in coda, Arresta ciclo conclude con gradualità, Interrompi abbandona una singola operazione e Arresto di emergenza riguarda l’intera ferrovia. La pagina dedicata al Monitor Treni descrive le conseguenze di ciascuna azione.

Registro di guida: ricostruire la decisione

Il Registro di guida memorizza la sequenza dietro l’esercizio automatico: scelta dell’itinerario, prenotazione del corridoio, requisiti degli accessori, comandi alla locomotiva, transizioni dei feedback, frenata, sosta, prosecuzione, pausa, liberazione e allarmi. Cerca attorno all’ora esatta del sintomo e segui il nome di un treno. La domanda utile non è soltanto “che cosa è fallito?”, ma “qual è stata l’ultima condizione di sicurezza che RailKernel poteva ancora dimostrare?”. Copia la sezione pertinente prima di riavviare, perché una nuova esecuzione può sostituire il contesto necessario.

Registri dei protocolli delle centrali

La finestra Centrale offre una registrazione in tempo reale limitata per le connessioni CS3, ECoS e Z21 supportate. Ogni registro mostra ora, descrizione leggibile e frame o messaggio del protocollo sottostante, con i comandi Cancella, Copia e Chiudi. Usalo per rispondere a due domande separate: RailKernel ha inviato il comando previsto e la centrale ha inviato la risposta o l’evento previsto? Un comando in uscita mancante suggerisce stato o configurazione dell’applicazione; un comando corretto senza risposta suggerisce connessione o protocollo; uno scambio corretto senza azione fisica suggerisce hardware. Cancella immediatamente prima di una breve riproduzione, così le prove restano leggibili.

Quando una centrale non si collega

Conferma che la centrale sia abilitata in Connessioni e che tipo, nome visualizzato, host e porta siano corretti.
Leggi il messaggio di avanzamento all’avvio per vedere se il passaggio lento è caricamento della configurazione, connessione, scaricamento dei dati della centrale o lettura dello stato iniziale.
Usa Scansiona rete dove supportato, ma verifica che il dispositivo rilevato sia la centrale che intendi comandare.
Controlla che computer e centrale si trovino su reti raggiungibili e che un’altra applicazione non occupi in modo esclusivo l’interfaccia.
Apri il registro del protocollo della centrale ed esegui una piccola azione. Assenza di traffico e traffico rifiutato sono guasti differenti.
Disabilita temporaneamente le centrali non pertinenti quando isoli problemi di avvio o timeout.

Sintomi comuni e miglior primo controllo

Impossibile posizionare il treno: Fai clic sulla spiegazione disabilitata e verifica feedback di uscita occupato, appartenenza univoca al blocco, prenotazione del blocco e disponibilità di un Treno semplice non posizionato.
Impossibile muovere il treno: Usa la finestra dei motivi di RailKernel. Controlla coerenza del progetto, velocità del blocco di origine, stato GO della centrale, identità treno/locomotiva, occupazione del blocco successivo e protezione accessori mancante.
Il treno rimane in pausa: Leggi il suggerimento nel Monitor Treni e il corridoio prenotato. Attendi prima il treno che lo blocca; usa Libera soltanto quando sai che le prenotazioni mantenute da questo stesso treno sono obsolete.
Il deviatoio si muove soltanto sullo schermo: Confronta Monitor Accessori e comando del protocollo in uscita, quindi verifica indirizzo del decoder, uscita, alimentazione e meccanismo.
Il deviatoio si muove soltanto fisicamente: Cerca l’evento accessorio restituito e verifica che sia associato alla stessa centrale, protocollo e indirizzo dell’accessorio nel progetto.
Feedback corretto dopo un cambiamento ma errato all’avvio: Esamina traffico dello stato iniziale e identità completa bus/modulo/contatto. Una transizione reale che funziona in seguito non prova che rilevamento all’avvio e sincronizzazione iniziale siano corretti.
Arresto di emergenza ripetuto: Usa feedback e ora segnalati. Controlla materiale rotabile inatteso, rimbalzo o polarità del rilevatore, appartenenza errata al blocco, regole di azione e mancata corrispondenza tra posizioni fisiche e digitali dei treni.
L’anteprima dell’itinerario omette infrastruttura: Esamina itinerario salvato e tratti accessori calcolati. L’anteprima mostra ciò che l’itinerario contiene realmente; infrastruttura arancione mancante indica normalmente dati mancanti nell’itinerario, non soltanto un problema di disegno.

Preparare una segnalazione utile

Includi versione RailKernel, sistema operativo, tipo e versione software della centrale, ora locale esatta dell’evento, sequenza ripetibile più breve, risultato previsto e osservato, schermata del monitor pertinente e righe copiate dal Registro di guida o dal registro del protocollo. Esporta o carica privatamente il progetto quando sono coinvolti geometria o instradamento. Indica se il problema persiste dopo un riavvio e se si verifica con una sola centrale abilitata. Non pubblicare mai file di licenza, password, chiavi private o dati personali non pertinenti.

Conservare un punto noto funzionante

Registra le modifiche al sorgente e conserva backup datati del progetto prima di una modifica strutturale o di un esperimento di instradamento. Quando compare una regressione, riproducila una volta, conserva le prove e confronta con l’ultimo stato noto funzionante. Annullare una singola modifica isolata è molto più sicuro che riparare una catena crescente di correzioni speculative. Il monitoraggio non è un ripensamento: è ciò che rende manutenibile un sistema fisico e digitale complesso.