Guida
Locomotive
Una locomotiva è il veicolo ferroviario motorizzato e indirizzabile individualmente che RailKernel comanda attraverso una centrale.
Locomotive in RailKernel e nelle centrali
Una centrale conosce le informazioni necessarie per guidare una locomotiva: identità interna, protocollo, indirizzo decoder, passi di velocità e funzioni. RailKernel importa tale identità operativa e aggiunge le informazioni di progetto necessarie al di sopra del livello del protocollo, come centrale proprietaria, produttore, numero di catalogo, lunghezza fisica, tipo di locomotiva, modello funzioni, immagine e commenti. Una locomotiva può quindi esistere nella centrale prima di esistere nel progetto. L’importazione crea la definizione RailKernel; non duplica né registra nuovamente il decoder. Quando una centrale collegata supporta la scrittura dei dati delle locomotive, il caricamento e la manutenzione della banca dati della centrale sono disponibili tramite Centrali anziché in questo editor del progetto.
Importare locomotive
Apri dal menu il comando di importazione delle locomotive. RailKernel legge l’elenco disponibile da ogni centrale collegata e assegna una scheda separata a ciascuna. La tabella mostra se una voce verrà importata insieme a nome, indirizzo, protocollo, UID e numero di funzioni. La didascalia della scheda e il piè di pagina mostrano quante voci sono state lette e visualizzate.

Scegliere cosa importare
Seleziona le singole caselle quando al progetto appartengono soltanto determinate locomotive. Seleziona tutto contrassegna ogni riga importabile attualmente visibile e Deseleziona tutto le cancella. Mostra/importa solo nuove locomotive nasconde le voci già riconosciute da RailKernel; disattivalo quando devi confrontare l’intero elenco della centrale. Le combinazioni indirizzo/protocollo già esistenti e i record di trazione o consist della centrale che non sono normali locomotive sono protetti dalla duplicazione accidentale. Premi Importa locomotive dalla centrale selezionata per aggiungere le definizioni contrassegnate. Ripeti l’operazione in un’altra scheda se il progetto usa più centrali.
Il Gestore locomotive
Apri Locomotive dal menu per visualizzare l’elenco del progetto. La tabella può essere ordinata e filtrata e mostra l’identità operativa insieme a marca e informazioni di catalogo. Nuovo crea manualmente una locomotiva, Modifica apre la definizione selezionata, Controlla apre il comando diretto e Elimina rimuove le voci selezionate dal progetto. Precedente e Successivo nell’editor consentono di esaminare l’elenco senza tornare ripetutamente alla tabella.

Dettagli della locomotiva
- Nome
- Il nome della centrale o del progetto usato in tutto RailKernel. Per le locomotive importate questa identità operativa rimane di sola lettura. Un nome significativo fornisce anche a Modello suggerito informazioni sufficienti per la ricerca.
- Protocollo
- Il protocollo del decoder, per esempio DCC, MFX o Motorola. Insieme all’indirizzo e alla centrale identifica come devono essere inviati i comandi di guida e delle funzioni.
- Indirizzo
- L’indirizzo decoder usato dalla centrale selezionata. I valori importati di protocollo e indirizzo provengono da quella centrale e non vengono riscritti con leggerezza modificando i metadati RailKernel.
- Centrale
- La centrale configurata responsabile di questa locomotiva. Tutti i comandi di velocità, direzione e funzione vengono inviati a tale connessione.
- Modello suggerito
- Una ricerca assistita dall’IA in RailKernel Cloud cerca nella RailKernel Model Database prodotti che potrebbero corrispondere al nome della locomotiva. Selezionando un risultato vengono compilati i dati disponibili di marca, numero di catalogo, lunghezza e tipo di locomotiva e viene aggiornata l’immagine del prodotto. I suggerimenti sono candidati, non prove: verifica sempre il modello scelto.
- Marca
- Il produttore o fornitore. Insieme al numero di catalogo collega la locomotiva a immagini RailKernel Cloud, pagine dei prodotti, manuali e informazioni sul copyright.
- Tipo di locomotiva
- La categoria di trazione, per esempio vapore, diesel, elettrica o altro. Un modello RMDB selezionato può suggerire questo valore.
- Numero di catalogo
- Il numero di articolo del produttore per il modello fisico. Valori precisi sono essenziali per ottenere immagine e documentazione corrette.
- Lunghezza mm
- La lunghezza fisica del modello in millimetri. RailKernel la usa per posizionare e seguire il materiale rotabile nei blocchi e per controllare se i treni vi entrano.
- Modello funzioni
- Associa i numeri delle funzioni del decoder a nomi, icone e comportamenti coerenti, appropriati al modello o alla famiglia del decoder.
- Commento
- Note libere sulla locomotiva, sul decoder, sulla manutenzione, sulla proprietà o sulle limitazioni operative.
Modello suggerito richiede un nome utile
La ricerca nel cloud estrae dal nome parole significative e numeri simili a quelli di catalogo. Un nome generico come “locomotiva1” non dice nulla sul prototipo o sul prodotto e difficilmente produce una corrispondenza utile. Nomi come “ns1215” o “big boy 1” contengono informazioni ferroviarie riconoscibili e possono restituire candidati pertinenti. L’esempio seguente mostra diversi modelli Big Boy trovati dal semplice nome “big boy 1”. Scegli produttore e articolo esatti soltanto quando corrispondono alla locomotiva realmente posseduta.

Calibrate and review a locomotive
The Calibrate and Calibration buttons in the locomotive definition record the real driving behaviour of the selected locomotive. RailKernel stores the measurements with the locomotive and can use them to translate decoder speed steps into realistic movement and stopping behaviour.
Calibrate
Calibrate opens the guided measurement run. Place the locomotive on the centre feedback B. RailKernel follows the connected track in both directions, respecting the current turnout positions, and lists every reachable feedback on each side with its geometrical OCCUPIED-to-OCCUPIED distance from the entry of B. Select A and C far enough away to provide sufficient measuring and braking distance. Calibration times only new OCCUPIED transitions reported for B and A/C. It never uses a FREE transition as a physical measuring or stopping reference, so release delays in RailKernel, the command station or the feedback module cannot distort the result. Then choose the decoder speed steps and directions to measure.
- RailKernel first positions the locomotive from B in reverse. It commands speed zero as soon as the first outer feedback A or C becomes occupied, so that the actual measurements can start in the forward direction.
- The selected speed steps are measured from high to low. For every run, timing starts when centre feedback B becomes occupied and stops when destination feedback A or C becomes occupied. Because the same leading detecting axle causes both transitions, the measured geometry runs from the entry of B to the entry of A/C.
- At that destination OCCUPIED transition RailKernel immediately commands speed zero. It does not wait for the feedback to become free.
- Once the locomotive has stopped, enter the braking distance from the beginning of the destination feedback to the leading detecting axle. Alternatively click the rail at the rear conducting axle; RailKernel adds the configured detection length, calculated from locomotive length and its front and rear detection overhang.
- When both directions are selected, RailKernel measures the same speed step in the return direction before continuing with the next lower step.
- You may cancel a long calibration run. RailKernel then asks whether the measurements collected so far must be saved. Repeating a measurement replaces the existing value for the same speed step and direction.
Calibration
Calibration opens the stored measurements without starting the locomotive. Each row shows the decoder speed step, direction, measured distance and time, speed in millimetres per second, calculated scale speed, the speed related to the locomotive’s configured maximum speed, and braking distance.
- If this locomotive has no measurements, select another calibrated locomotive and press Copy. RailKernel copies its calibration data to the current locomotive, after which the copy can be changed independently.
- Select one or more measurement rows to display Delete selected measurements. This removes only the selected speed-step and direction combinations.
- Green speed-step selections in the Calibrate dialog indicate measurements that already exist. A new run for such a selection updates the stored measurement.
- Start from scratch removes all existing measurement points when the actual measurement sequence begins after the positioning run. Without this option, only remeasured speed-step and direction combinations are replaced and all other points remain available.
- Measurements from an older FREE-based distance model are removed when this calibration is opened, because they cannot safely be mixed with OCCUPIED-to-OCCUPIED measurements.
From km/h to decoder speed steps
RailKernel uses the locomotive calibration as its base speed model. The measured curve relates decoder speed step and direction to actual movement in millimetres per second and to braking distance. The highest usable measurement is linked to the locomotive’s configured maximum speed; intermediate km/h values are interpolated over the measured, non-linear curve. The displayed km/h value is therefore a practical operating scale rather than a claim of laboratory-grade scale-speed accuracy.
Use while driving, braking and stopping
Manual km/h control and automatic routing use the same direction-dependent locomotive curve. A requested route speed is converted into the appropriate decoder step for forward or reverse running. When approaching a configured stop position, RailKernel combines the interpolated speed in mm/s with the measured braking distance to determine where the speed-zero command must be sent. Train-type acceleration and braking factors can still modify the result.
Train calibration as a load correction
Locomotive calibration describes the locomotive itself. Optional train calibration remains useful for measuring how a particular consist changes that behaviour through its mass, length, rolling resistance and vehicles. It samples only four operating speeds—50, 70, 90 and 110 km/h—and acts as a correction layer on top of the detailed locomotive curve, rather than as a competing speed model. Values between these points can be interpolated.
The calculation order is: requested km/h → direction-dependent locomotive curve → decoder step and base braking distance → optional train correction. If usable locomotive measurements are unavailable, RailKernel falls back to the existing train calibration and feedback/stop-position behaviour.