Aide
Locomotives
Une locomotive est le véhicule ferroviaire motorisé adressable individuellement que RailKernel commande par l’intermédiaire d’une centrale numérique.
Locomotives dans RailKernel et dans les centrales
Une centrale connaît les informations nécessaires pour conduire une locomotive : identité interne, protocole, adresse du décodeur, crans de vitesse et fonctions. RailKernel importe cette identité opérationnelle et ajoute les données de projet nécessaires au-dessus du protocole, telles que la centrale propriétaire, le fabricant, le numéro de catalogue, la longueur physique, le type, le modèle de fonctions, l’image et les commentaires. Une locomotive peut donc exister dans la centrale avant d’exister dans le projet. L’importation crée la définition RailKernel ; elle ne duplique ni ne réenregistre le décodeur. Lorsqu’une centrale permet l’écriture des données, le téléversement et la maintenance de sa base sont disponibles dans Centrales numériques et non dans cet éditeur de projet.
Importer des locomotives
Ouvrez la commande d’importation depuis le menu. RailKernel lit la liste disponible dans chaque centrale connectée et crée un onglet par centrale. Le tableau indique si une entrée sera importée, ainsi que son nom, adresse, protocole, UID et nombre de fonctions. Le titre de l’onglet et le pied affichent le nombre d’entrées lues et présentées.

Choisir ce qui doit être importé
Cochez individuellement les locomotives appartenant à ce projet. Tout cocher sélectionne toutes les lignes importables visibles et Tout décocher les efface. Afficher/importer uniquement les nouvelles locomotives masque les entrées déjà reconnues ; désactivez cette option pour comparer toute la liste de la centrale. Les combinaisons adresse/protocole existantes et les enregistrements de traction qui ne sont pas des locomotives normales sont protégés contre la duplication. Appuyez sur Importer les locomotives de la centrale sélectionnée, puis répétez l’opération dans un autre onglet si le projet utilise plusieurs centrales.
Le Gestionnaire de locomotives
Ouvrez Locomotives depuis le menu pour afficher la liste du projet. Le tableau est triable et filtrable et montre l’identité opérationnelle avec la marque et le catalogue. Nouveau crée une locomotive manuellement, Modifier ouvre sa définition, Commander ouvre la commande directe et Supprimer retire les entrées sélectionnées du projet. Précédent et Suivant permettent de parcourir la liste depuis l’éditeur.

Détails de la locomotive
- Nom
- Le nom de la centrale ou du projet utilisé dans RailKernel. Pour les locomotives importées, cette identité opérationnelle reste en lecture seule. Un nom significatif fournit aussi suffisamment d’informations à Modèle suggéré.
- Protocole
- Le protocole du décodeur, par exemple DCC, MFX ou Motorola. Avec l’adresse et la centrale, il détermine comment envoyer les commandes de conduite et de fonctions.
- Adresse
- L’adresse du décodeur utilisée par la centrale sélectionnée. Le protocole et l’adresse importés proviennent de cette centrale et ne sont pas réécrits simplement en modifiant les métadonnées RailKernel.
- Centrale numérique
- La centrale configurée responsable de cette locomotive. Toutes les commandes de vitesse, direction et fonctions sont envoyées à cette connexion.
- Modèle suggéré
- Une requête assistée par IA dans RailKernel Cloud recherche dans la RailKernel Model Database les produits pouvant correspondre au nom. La sélection d’un résultat remplit les données disponibles de marque, numéro, longueur et type et actualise l’image. Les suggestions sont des candidates, pas des preuves : vérifiez toujours le modèle choisi.
- Marque
- Le fabricant ou fournisseur. Avec le numéro de catalogue, il relie la locomotive aux images, pages produit, notices et informations de droits d’auteur de RailKernel Cloud.
- Type de locomotive
- La catégorie de traction, par exemple vapeur, diesel, électrique ou autre. Un modèle RMDB sélectionné peut suggérer cette valeur.
- Numéro de catalogue
- Le numéro d’article du fabricant pour le modèle physique. Une valeur exacte est essentielle pour obtenir la bonne image et la bonne documentation.
- Longueur en mm
- La longueur physique du modèle en millimètres. RailKernel l’utilise pour placer et suivre le matériel dans les cantons et vérifier que les trains y tiennent.
- Modèle de fonctions
- Associe les numéros de fonctions du décodeur à des noms, icônes et comportements cohérents pour ce modèle ou cette famille de décodeurs.
- Commentaire
- Notes libres sur la locomotive, son décodeur, sa maintenance, sa propriété ou ses restrictions d’exploitation.
Modèle suggéré nécessite un nom utile
La recherche cloud extrait du nom les mots significatifs et numéros ressemblant à des références. Un nom générique comme « locomotive1 » ne dit rien sur le prototype ou le produit et donnera rarement un résultat utile. Des noms comme « ns1215 » ou « big boy 1 » contiennent des informations ferroviaires reconnaissables et peuvent renvoyer des candidats pertinents. L’exemple ci-dessous montre plusieurs Big Boy trouvés à partir du simple nom « big boy 1 ». Ne choisissez le fabricant et l’article exacts que s’ils correspondent à la locomotive que vous possédez réellement.

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.