Software
Locos, cars and trains
Before a train can run in the track plan, LoDi-Aura needs its vehicles: the locomotives with address and dimensions, the cars and, built from them, the trains. Train classes group trains together. This page explains every field – including RailCom, CV programming, address programming and maintenance.
The four sub-tabs
The “Vehicles” tab has four sub-tabs. Their order is also the sensible order to work in:
- “Locomotives” – each loco with address, protocol, dimensions and driving behaviour.
- “Cars” – cars, with a function decoder if you like.
- “Trains” – made up of locos and cars. You place trains in the track plan and drive them there.
- “Train classes” – classes of train with a colour and a route horizon.
Every sub-tab has the same layout: the list on the left, the form of the selected entry on the right. The form is divided into sections that you can expand and collapse one by one. LoDi-Aura saves changes immediately.
The loco list
Above the list are the buttons that apply to the whole list, and below them the search box and filters. Clicking a loco opens its loco profile on the right.
| Button | What it does |
|---|---|
| “⚙ CV programming” | Opens CV programming for the selected loco (see below). |
| “⤵ Import” | Imports locos from an iTrain file (.tcdz or .tcd). First, a preview shows every loco found with its name, address, protocol, speed curve, functions and CVs. Only the ticked locos are added to the project. |
| “🔗 Database sync” | Links your locos to the Lokstore loco database. LoDi-Aura suggests matching entries; nothing is linked until you confirm the suggestion. |
| “+ Add locomotive” | Adds a new loco. |
Filtering and sorting
| Filter | Meaning |
|---|---|
| “All categories” | Shows only locos of one type: electric, steam, diesel or other. |
| “All command stations” | Shows only the locos of one command station. Each command station is followed by the number of its vehicles. A command station that is currently not connected or switched off is marked “· offline”. Vehicles without a fixed command station count towards the command station they run through. |
| “All protocols” | Shows only locos of one protocol: DCC, mfx / m3, Motorola or analogue. |
| Sorting | “Sort: Name”, “Sort: Address” or “Sort: Command station”. |
| “responding only (RailCom)” | Shows only locos that are currently reporting via RailCom on the layout. |
LoDi-Aura remembers the filters separately on each computer, but not the search box. So that no loco disappears without you noticing, every active filter has a coloured outline and says what it filters (for example “Command station: …”). As long as something is filtered, the “✕ Reset filter” button appears next to the count.
The car and train lists have the same filters, adapted to their content.
Deleting several locos at once
- Turn on selectionClick “Select” above the loco list. The button then reads “Done”.
- Tick the locosA click now ticks a loco instead of opening it. Shift+click selects a whole range. “All shown” selects everything the filter is currently showing, “None” clears the selection.
- DeleteClick “Delete (n)”. The confirmation tells you which of the locos are part of a train and which carry a measured speed curve.
Combined with the command station filter, this lets you clear out, for example, all the locos of one command station in one go.
Adding a loco
Click “+ Add locomotive”. A new loco starts with DCC, address 3 and 128 speed steps. The loco profile has the sections “Master data”, “Dimensions”, “Digital / Address”, “Functions”, “Driving behavior”, “Maintenance” and “Loco photo”.
Master data
| Field | Meaning |
|---|---|
| “Name” | The name the loco appears under everywhere. |
| “Type” | “Electric (electric loco)”, “Diesel”, “Steam (with tender)”, “Tank Loco (steam, small)”, “Köf (small diesel)”, “Small electric loco”, “Crocodile”, “Power car (ICE)” or “Other”. The type only determines how the loco is drawn in the track plan. |
| “Class” | For example 218. |
| “Running number” | The number on the model. |
Dimensions
| Field | Meaning |
|---|---|
| “Length over buffers (cm)” | The full length of the loco. |
| “Front overhang (cm)” | How far the front of the loco sticks out ahead of the first axle. |
| “Rear overhang (cm)” | How far the rear of the loco sticks out behind the last axle. |
If you have chosen to display millimetres under “System” › “Track plan”, all lengths are shown in mm. Calculations and saving always use centimetres.
Digital / Address
| Field | Meaning |
|---|---|
| “Address” | The loco's digital address. |
| “Protocol” | “DCC”, “mfx / m3”, “Motorola” or “Analog” (see “Analogue loco” further down). |
| “Speed steps” | 14, 27, 28, 126 or 128. |
| “Decoder” | What is fitted in the loco. After a read, CV programming suggests the decoder. |
| “Driving interface” | The command station the loco runs through. You can choose any command station whose device card has “Use for driving” ticked – including ones that are currently not connected (marked “· offline”). |
| “Decoder UID (mfx)” | mfx only: the decoder's identifier. |
| “🔁 RailCom (decoder)” | How the decoder reports via RailCom (next section). |
| “RailCom address (transmitter)” | mfx only: the address of a separate RailCom transmitter in the loco (see below). |
How to set up a command station and enable it for driving is explained in Devices and command stations.
RailCom
In the “🔁 RailCom (decoder)” field you tell LoDi-Aura what the decoder reports via RailCom. This decides whether LoDi-Aura recognises the loco on the layout and which way it is facing.
| Setting | Meaning |
|---|---|
| “not recorded” | Default for new locos. |
| “normal” | The decoder reports address and direction. |
| “inverted (decoder mounting — affects only this loco)” | The decoder is fitted the wrong way round. LoDi-Aura reverses the reported direction for this loco only. |
| “no direction — address yes, direction no (e.g. several decoders in the train)” | LoDi-Aura uses the address, but not the reported direction. |
| “no RailCom active — reports no address at all” | The loco reports nothing. LoDi-Aura does not expect a RailCom answer from it. |
LoDi-Aura never recognises Motorola locos or analogue locos via RailCom.
RailCom transmitters in mfx locos
An mfx loco does not report its address via RailCom. If a separate RailCom transmitter is fitted in the loco, enter its DCC address under “RailCom address (transmitter)” – this is the number the feedback sensor reads. The field only appears with the “mfx / m3” protocol and as long as RailCom is not set to “no RailCom active”. Empty means: this loco cannot be recognised via RailCom. The “🔁 RailCom (decoder)” setting then applies to the transmitter, so “inverted” means a transmitter fitted the wrong way round.
So that the transmitter answers, LoDi-Aura switches on function F16 at its address – as a DCC command, when the command station connects and when the train is placed on the track.
A RailCom number belongs to exactly one train
To the feedback sensor, a DCC loco with address 3 and a transmitter with address 3 are the same number. If locos in different trains carry the same number, LoDi-Aura assigns a reading to none of them – no placing via RailCom –, and the log warns when opening and saving (“RailCom number 3 is duplicated: …”).
- To fix it: change the address or transmitter address, or set one of the locos to “no RailCom active”.
- Two locos in the same train under one number are fine.
- Locos that are not in any train don't make a number a duplicate. The log only mentions them as a note.
Analogue loco
With the “Analog” protocol, a loco without a decoder runs via the LoDi-Rektor. An analogue loco belongs permanently to exactly one Rektor; if there is only one, LoDi-Aura chooses it itself, otherwise you choose it under “Driving interface”. Instead of an address, the loco gets an internal number from 20001 upwards, assigned by LoDi-Aura – there is no address on the track. The speed steps are fixed at 28.
An analogue loco has no functions, CVs, RailCom or mfx. The “Functions” section and the “⚙ CV programming” button disappear. If you switch an existing loco to “Analog”, LoDi-Aura asks first and tells you what will be lost: address, functions, CV values, RailCom setting, transmitter address and mfx data.
You may set up several analogue locos on one Rektor. However, they all control the same track signal. Only the loco with “Active driving channel of this Rektor” ticked is driven.
Functions
Under “Functions” you name and assign F0, F1 and so on. “+ Function” adds another one. F0 is usually the light.
Driving behaviour
| Field | Meaning |
|---|---|
| “Decoder acceleration time (s to top step)” | How long the decoder itself takes to reach the top step (DCC: CV 3, mfx: acceleration delay). LoDi-Aura adds this time for the loco when starting and when measuring. |
| “Decoder run-on (s to standstill)” | How long the loco keeps rolling after speed step 0 (DCC: CV 4, mfx: braking delay). LoDi-Aura brakes earlier by this run-on. |
| “Brake correction” | A slider from −50 to +50 cm between “stops earlier” and “stops later”, centre = neutral. How to set it is explained in the next section. |
| “Braking correction separate for forward/reverse” | Gives the loco a second slider, “Reverse”. For most locos this is worth it. |
| “🎓 Learn the speed curve via the train” | The loco's speed curve is calibrated over time from its train's runs. |
The two decoder fields describe how sluggish the decoder itself is – not how the train should drive. Recommended: set CV 3 and CV 4 to 1 in the decoder; then both fields here stay at 0. How briskly a train starts and brakes is set on the train (“Train load”, see below).
Below the fields is the loco's speed curve with the buttons “🎯 Calibrate”, “🏁 Start measuring run”, “✎ Edit” and “🗑 Delete speed curve”. How to calibrate a loco is explained on the Calibration page.
Fine-tuning the stop with brake correction
If a loco regularly stops beside the mark, you don't need to recalculate any curve. Brake correction is the simplest way to an exact stop.
- Measure the stopMeasure from the buffer to the spot where the train should have stopped.
- Enter the valueUnder “Driving behavior”, enter the value in the “Stop measured:” row (1 to 100 cm) and choose “too far” or “too short”. With separate correction, also choose “forward” or “reverse”.
- ApplyClick “apply”. LoDi-Aura moves the “Brake correction” slider by exactly that amount, the slider visibly jumps along, and the log notes it.
- Check againRun the stop once more. If it is still not quite right, measure again – the values add up.
Maintenance
LoDi-Aura keeps count of how far and how long each loco runs – with the same calculation it uses to track the train in the track plan (speed curve × time). Runs in the simulation don't count. The distance is as accurate as the loco's speed curve: a calibrated loco counts more accurately than a freshly added one.
Under “Maintenance” you decide when the loco is due for the workshop: “After days”, “After distance (km)” or “After operating time (h)” – one, two or all three. The default is 40 operating hours; this applies to every new loco and to existing locos without an operating-time interval. You can change the value or clear the field – it then stays empty.
| Topic | How it works |
|---|---|
| Where it is calculated | Maintenance is kept in the Lokstore loco database. The intervals are transferred with the sync, and LoDi-Aura reports the distance travelled every ten minutes. For this, the loco must be linked to the database and the layout must be signed in to your Lokstore account. |
| Loco without a link | Still counts. As soon as the loco is linked to the database, the counted total is transferred. |
| Due | When an interval is reached, 🔧 appears next to the loco in the loco list, its train carries the same symbol in the track plan, the section shows “🔧 due”, and the log gets one line, for example “Maintenance due — distance 53.4 km of 50 km.” |
| Recording maintenance | If you like, write a note (for example “wheels cleaned, oiled”) and click “🔧 Record maintenance”. From then on, everything counts from zero. |
| Recording maintenance afterwards | If the maintenance was some time ago, choose its date next to it (empty means today). The date counts for the interval in days. Distance and operating time count from the moment you record it, because the database stores the current counter reading. |
| History | Below, every maintenance is listed with date, counter reading and note. Use ✕ to strike out a mistyped entry; the loco's counters stay as they are. |
Loco photo and throttle
Under “Loco photo” you load a photo from a file (“🖼 File”) or from the loco database (“🌐 Database”); “✕” removes it. The photo appears in the train menu, among other places, and – if you turn it on for the train – in the track plan. “⛶ Open external throttle” opens this loco's throttle in a window of its own.
Copying a loco or car
If you have several identical vehicles, add the first one and then click “Copy” at the top of the loco profile – right next to “Delete”. For cars, the button is in the same place. The copy has the same name as the original with “(copy)” added and is selected straight away.
| When copying | What |
|---|---|
| Copied | Master data (type, class, running number, photo), dimensions (length over buffers, both overhangs) and the functions. For cars, also “⚡ Car triggers occupancy detection”. |
| Not copied | Everything under “Digital / Address” – address, protocol, speed steps, driving interface, decoder, RailCom –, plus driving behaviour and speed curve, the CVs and the link to the loco database. |
A copied loco therefore starts like a new one with DCC, address 3 and 128 speed steps, a copied car with address 0. Enter the correct address straight away.
CV programming
“⚙ CV programming” – at the top of the loco list or in the loco profile – opens a separate window for the selected loco. An mfx loco gets its own mfx window.
At the top, under “How to program?”, choose the method:
- “RailCom via S88 + Rektor” – the Rektor asks the question, the S88-Commander receives the answer via RailCom. No extra hardware needed.
- “CV-Programmer · main track (RailCom)” – via the LoDi-CV-Programmer on the bus, reading via RailCom.
- “CV-Programmer · programming track” – the classic way on the programming track, CV by CV.
- “Read out mfx / DCC-A” – only for mfx and DCC-A locos: reads name, functions and decoder UID directly from the decoder.
If an ESU ECoS, a Z21 or a Lenz command station (XpressNet) is in the project, their own programming track (“… · Programming track”) and main track (“… · main track (RailCom)”) are added. On the main track, the command station itself then asks and evaluates the RailCom answer; the loco can stay where it is. The Lenz command station switches off its main track when using the programming track. LoDi-Aura does not know about locos that are only driven from the handheld throttle – stop them there first. If there are several Rektors, the window asks “Via which Rektor?”.
Whatever is not possible right now is locked and says why. “Read standard CVs” reads the usual set: CV 1, 3, 4, 5, 6, 7, 8, 17, 18, 28 and 29 – CV 5 and 6 are maximum and mid speed. The DCC scan reads the same set when you read in a new loco.
| Area | Meaning |
|---|---|
| Recognising the decoder | After reading, a line with 🏭 names the manufacturer from CV 8 and, where possible, also the model, article number and version. |
| RailCom page | Values that can only be read via the pointers CV 31/32 are shown in a table of their own. They only apply to this page and are not taken over into the loco. |
| Comparison | If the loco is set up differently in LoDi-Aura than in the decoder – address, RailCom, speed steps, decoder acceleration time, decoder run-on, decoder –, both are shown side by side: the decoder on the left, LoDi-Aura on the right. “Apply decoder values” enters them into the loco. Nothing is ever taken over silently. |
How to connect and set up the CV-Programmer on the bus is explained in Setting up the LoDi-CV-Programmer.
Reading on the main track via the CV-Programmer
With “CV-Programmer · main track (RailCom)”, the loco doesn't have to go onto the programming track or onto a RailCom feedback sensor. The Rektor asks the question, and the LoDi-CV-Programmer on the bus listens for the answer. For this, the loco stands on the section that the CV-Programmer feeds via channel A (main track).
Programming an address
You don't set a new DCC address CV by CV. The reading bar has “Program address”; the pencil ✎ next to CV 1, 17 and 18 also opens this dialog. You only enter the new address – LoDi-Aura works out which CVs are needed and shows you beforehand.
- Choose the methodAt the top, under “How to program?”, choose the “CV-Programmer · main track (RailCom)” or “CV-Programmer · programming track” card. The dialog takes over this method and shows it as “Method: Main track (POM)” or “Method: Programming track”.
- Enter the addressEnter the address after “new” (1 to 10239). Below it you see the plan: up to 127 a short address (CV 1), from 128 a long one (CV 17 and 18), plus bit 5 in CV 29.
- ProgramClick “Program”. A list shows each step with ✓ or ✗.
The job keeps running even if you close the window (“Keep running in the background”). When it is finished, the loco is set to the new address in LoDi-Aura – you don't need to update anything.
| Method | What applies |
|---|---|
| Programming track | Put only this one loco on it. LoDi-Aura first reads CV 29 – if it cannot be read, nothing is written. At the end, LoDi-Aura reads back the address and CV 29. |
| Main track | The loco must be standing still and already have an address in LoDi-Aura – that is where the commands go. Every loco with this address on the track is programmed as well; the dialog warns you if a second loco in the project uses it. Going from one long address to another long address takes a free short address as an intermediate step. Finally, LoDi-Aura queries the loco via RailCom at the new address. If it doesn't answer, you see “Not verified” – in that case, do a short test run. |
- For DCC locos only; with mfx and Motorola the button is greyed out.
- Lenz decoders (CV 8 = 99) block the main track – for them, only the programming track remains.
- On an ECoS, LoDi-Aura reads CV 29 first and aborts if there is no answer, before anything has been changed.
- If you opened the dialog via ✎, “Write CV 1 only” (or 17 or 18) still writes just that one value.
Cars
Under “Cars” you add cars – with or without a function decoder (light, sound, coupling). Cars don't have a motor. The car list has the same buttons and filters as the loco list, but can also be sorted by class.
| Section / field | Meaning |
|---|---|
| “Car photo” | Photo from a file (“🖼 File”) or from the loco database (“🌐 Database”). |
| “Type” | “Control waggon”, “Passenger car”, “Freight car” or “Service vehicle”. |
| “Class / Type”, “Running number” | As for the loco. |
| “⚡ Car triggers occupancy detection” | The car has resistor axles or similar and is seen by the occupancy sensors. |
| “Dimensions” | Length over buffers and both overhangs, as for the loco. |
| “Digital / decoder” | Address, protocol, speed steps and driving interface of the function decoder. Address 0 means: no decoder. |
| “Fixed speed step” | For work cars with a “motor” decoder, such as vacuum cleaning cars that only start sucking from a certain speed step. LoDi-Aura remembers the step on the car; “Set step” sends it to the car's address, “Stop (0)” sets it to 0. |
| “Functions” | As for the loco. |
Making up a train
Under “Trains” you make up trains from locos and cars. For each train, the train list shows where it is standing (“📍 standing in …”) or that it has not been placed yet (“📍 not placed”). You can also filter by display and sort by name, length or location. How to place a train in the track plan and drive it is explained on the Driving page.
Master data
| Field | Meaning |
|---|---|
| “Train class” | The class of train (see “Train classes” below). |
| “Display” · “Color” | How the train is drawn in the track plan (“ICE”, “Passenger”, “Freight”, “Steam”) and the train's colour. |
| “Train length without loco (cm)” | Display only: the length comes from the make-up – the individual cars plus the flat train section. |
| “Train load” | How briskly the train starts and how early it brakes – you don't need to know any tonnages for this. Five levels: “Very light — single loco, railbus”, “Light — railcar, short train”, “Normal — passenger train” (default), “Heavy — long train, freight train”, “Very heavy — long freight train, ore train”. A heavy train pulls away more slowly, brakes earlier and more gently, and LoDi-Aura books further ahead for it. The light levels only change how it starts. |
| “Vmax (km/h)” | The upper speed limit for this train. |
Train control
| Field | Meaning |
|---|---|
| “🚂 Loco image in the track plan” | Shows the loco's photo instead of the drawn train (carried along flat, not bent round curves). Only if the loco has a photo. |
| “Push-pull train / control waggon” | The train may run in reverse. The automation then reverses it instead of running the loco round. |
| “Learning active” | On: the train learns its speed curve during operation. Off: the speed curve stays as it is. “Reset speed curve” ticks the box again. More on this in Calibration. |
| “Detour” | What should happen if the way ahead stays blocked: “like system (track plan setting)”, “never — stays put and waits”, “only when stopped (after ~10 s)” or “immediately at the first blocked block”. This only takes effect if automatic detours under “System” › “Track plan” are not set to off – “Off” there applies to all trains. |
| “This train is a cleaning train” | The train systematically runs over the whole layout. |
| “May be affected by the cleaning train” | The train makes way for the cleaning train: it runs a lap and comes back to its place. |
Consist
With “+ Loco …” and “+ Car …” you add vehicles to the train. Each row shows the vehicle's length; if it is missing, you see “?” – then enter the length in the master data.
- For each loco, choose how it is coupled in the train: ▶ forward or ◀ reverse. ◀ on the first loco means: nose towards the cars – in reverse it pulls, forward it pushes.
- Use ▲ and ▼ to change the order; “Remove” takes a vehicle out.
- Enter the rest of the train that you don't want to add car by car as “Train section (flat) — rest of the train as one piece”. Its row shows its length and the ⚡ box if it triggers occupancy detection (resistor axles in the rake).
- Below that, LoDi-Aura adds up the lengths: locos, “Cars (individually)”, “Train section (flat)” and “Total length”.
If a loco or car is already part of another train, LoDi-Aura asks whether it should be taken out there and added here.
Multiple heading
If a train has several locos, LoDi-Aura checks how well they match and shows the result in the “Multiple heading” box below the consist. If the locos have speed curves, LoDi-Aura matches them using those: each loco gets its own speed step for the same speed. Without a speed curve for the lead loco, each loco gets the same proportional speed step.
Below that are notes (ℹ) and warnings (⚠), for example:
- a loco without an address – it gets no driving commands and is only hauled along,
- two locos with the same address on the same command station – both hear the same driving command, so they cannot be matched to each other,
- a loco without a usable speed curve, or a speed curve that only goes up to a certain speed step,
- a top speed that one of the locos can't reach – the train then runs no faster than the slowest loco,
- decoders with very different inertia (CV 3 or CV 4) – the locos drift apart when starting or braking,
- different speed step formats – LoDi-Aura converts the step for each loco.
Speed curve (learned)
In its last section, the train form shows the speed curve the train has learned in operation. “Reset speed curve” deletes it. What the display means is explained in Calibration.
Train classes
A train class is a class of train with a colour and a route horizon. Trains refer to their train class; blocks and stations can allow, direct or bar train classes individually (see Blocks, feedback and insulated joints and Stations, shunting and staging yards).
- “Name” and “Color” – this is how the train class appears in lists and in the track plan.
- “Route horizon (blocks)” – how many blocks a train of this class books in advance (1 to 20). A long horizon runs more smoothly, but ties up more of the layout for other trains.
- “Stop at the platform” – how trains of this class stop at a platform drawn in the track plan (table below).
| “Stop at the platform” | Where the train stops |
|---|---|
| “At the stop point” | Default: at the block's stop line, as without a platform. |
| “Cars at the start of the platform” | The last car stands at the start of the platform, where the train comes in – so the train stops early. |
| “Cars centred at the platform” | The cars stand in the middle. If they are longer than the platform, they overhang equally at both ends. |
| “Cars at the front end of the platform” | The first car stands at the front end of the platform. |
Everything from the first to the last car in the formation counts as cars, including the flat train section. The loco in front may stand beyond the platform. A train without cars – such as a multiple unit that you have added as a single loco – counts as a whole. A train never runs past the stopping point, and its end stays within the block. In operation, the stop line in the track plan is shown where the train really stops. Without a platform drawn in, the stopping point applies.

