Driving
Documentation

Software

Driving

The track plan is where you drive your trains: by hand with the throttle, in Interlocking mode, where LoDi-Aura sets the routes and you drive, or fully automatically. This page explains the three driving modes, the drag gestures, the train menu, the buttons for starting and stopping, switching in operation and the safety settings.

The three driving modes

Every train has exactly one driving mode. You will find the three buttons in the train menu above the compass: click the block the train is standing in. The buttons only appear when the layout is switched on; the selected mode has a frame around it.

The mode belongs to LoDi-Aura: the button only sends your intention, and what is displayed is what LoDi-Aura reports back.

ModeWho sets the routes, who drives
“✋ Manual”The automation does not drive. You drive freely with the throttle; LoDi-Aura follows the turnout positions and keeps track. No route, no protection.
“🚦 Interlocking”LoDi-Aura sets the routes, you drive: dragging to a destination sets and books the route, and the departure arrow lets LoDi-Aura find destinations itself. Driving is always done with the throttle. The route protects against the automation, moves along with the train and is released at the destination. Routes that are not used are released again by LoDi-Aura after two minutes.
“🔄 Auto”Like Interlocking – except that LoDi-Aura also drives itself: drag to a destination, or use the departure arrow for a free choice of destination.

A badge on the train shows its state: A green = running or looking for destinations, A grey = only armed, S = Interlocking. Taking hold of the handheld throttle always takes priority.

Where the automation drives to

The automation only drives where it can get out again. A train in “🔄 Auto” does not choose a track it could not leave again with its train class, against one-way blocks and without permission to reverse – nor a “pocket” of several blocks that together lead nowhere. A locked track means “don't go here”: the train takes the next destination straight away instead of waiting. Trains only reverse in a station or on a dead-end track, never against the one-way direction of their own track.

If a train does get stuck, the log reports “stuck” and names the blocks of the pocket. Waiting won't help then – only driving it out by hand or adding another exit to the track plan.

Sending a train off

Everything starts with the same move: pick up the standing train and drag it onto the destination block. The preview line is green if there is a clear way and red if there is none – or if STOP is holding or there is no power; the reason is then shown at the pointer. Which modifier key you hold decides what kind of run it becomes:

GestureWhat happens
dragNormal run. The automation finds the way, sets the turnouts, books and drives.
Shift + dragAdd a waypoint. With a standing train, this collects intermediate stops; the train stays where it is. The last drag without Shift starts the departure. With a moving train, the waypoint is added straight away.
⌘/Ctrl + drag“As the turnouts are set”: no turnout is thrown – the train only runs over turnouts that are already set the right way. If there is no way like this, the line stays red.
Alt + dragShunting move: slow, ignores the block direction, may reverse, only onto free blocks (see Stations, shunting and staging yards).

The keys also work if you press them in the middle of dragging – the preview then asks again. If the way is only possible by reversing, the preview already announces the zigzag run.

The same gestures apply when you drag the loco picture from the throttle or from the “Trains” window onto a block in the track plan.

Other ways to move a train

WayHow it works
Departure arrowOnly in “🚦 Interlocking” and “🔄 Auto”, as long as the train has not yet departed. One arrow per block end: green = way clear. Red has two meanings, and the tooltip says which: if the way is currently blocked, the train waits after you click and keeps re-booking until it is clear. If there is only a reason such as “STOP is active …”, departure is blocked and a click does nothing. In the “Trains” window, the waiting arrow is yellow and only the blocked one is red.
Handheld throttleClicking the loco picture in the train menu or in the “Trains” window opens the throttle for this loco – on a computer in a window of its own, on a phone above the picture.
FunctionsThe buttons on the loco switch individual functions. ⋮ shows all functions of this loco; you can't switch them there – open the handheld throttle for that.

Open the “Trains” window with “Trains ⧉” next to the booster and feedback buttons. For each train it shows the three modes, the aspect at the block end and the distance to the signal (→🚦) or, where there is no signal, to the stopping point (→🏁). Below that is a strip with the blocks ahead. More about the windows in The interface.

When LoDi-Aura refuses the departure

As long as STOP is holding or there is no power on the way, LoDi-Aura does not accept any new driving command – not even “for later”. Otherwise the train would set off as soon as you released STOP, and you would long have forgotten the command.

WhereWhat you see
Departure arrowRed, the reason is in the tooltip, a click does nothing. If all arrows are blocked, the reason is also shown below the compass: “⛔ Departure blocked: …”
DraggingThe line turns red and “⛔ …” appears at the pointer – letting go won't drive. If you let go anyway, nothing is sent: “… — no drive command sent”.
Waypoint chainIs refused at the end: “Plan refused: …” – also in the log.
ReasonMeaning
“STOP is active — release STOP first, then drive off”The red button is holding (likewise “EMERGENCY STOP is active …”).
“Emergency stop / short circuit at the command station …”The command station reports it itself.
“No track power — the boosters are off …”No booster is supplying power; the header bar shows OFF.
“Booster 1 channel A is off (Gleis 2 on the route)”A block on the way is known to have no power. LoDi-Aura only knows this if you have entered which booster channel supplies which feedback sensors (see “Safety” below).

What LoDi-Aura doesn't know doesn't block anything. Only your commands are refused: an automation that was already under way pauses during STOP and carries on afterwards. Sequences, the turntable and “⏭ Advance” are not affected. When you release STOP or the power comes back, an open train menu fetches the arrows again by itself.

The train menu

Clicking a block with a train in it opens the train's menu. What you need often is at the top, what you need rarely is at the bottom.

RowContent
HeaderBlock name and “🔓 lock” – no train enters any more. When locked, it shows “🔒 locked”; a click lifts the lock.
Train · ✎Colour dot, train name and the coupled loco (🚂). ✎ opens the train under “Vehicles” › “Trains”.
◀ loco picture ▶Direction of travel of the loco and handheld throttle (see below).
“✋ Manual” · “🚦 Interlocking” · “🔄 Auto”The driving mode. Only when the layout is switched on.
CompassSTOP in the middle, the departure arrows all around. The line below says what is going on right now.
“🔃 Turn” · “📥 Depot” · “🏠 Home” · “⏭ Advance”Where and how the train stands in the plan (below).
“🗺 Where may I go?” · “⏱ Measuring run”Tools (below).

The menu has a handle (⠿) at the top. Use it to drag the menu aside with the mouse or your finger so that the train underneath stays visible. It stays there until you close it.

Direction of travel and handheld throttle

Below the train name, the loco is shown as on the LoDi-Con: ◀ loco picture ▶. The bright arrow is the direction the loco is travelling in: ▶ green = forward, ◀ red = reverse. This means the loco's direction of travel, not left or right on the screen.

  • Clicking the pale arrow sends speed step 0 with the opposite direction to every loco in the train. The train stays where it is and keeps facing the same way – only its exit changes to the other end of the block. The log records it.
  • Clicking the loco picture opens the handheld throttle for this loco.

The arrows are locked while the train is moving or holding a route, and when the layout is off. The tooltip says so (“— stop first” or “— layout is off”). You can still always see the current state.

Below the loco picture is a small speed slider for shunting: fine on the left, coarse on the right, stop at the far left. It appears when the layout is switched on and can be moved in “✋ Manual” and “🚦 Interlocking”.

Position on the track and tools

ButtonWhat it does
“🔃 Turn”Turns the whole train in the plan: nose and exit flip. No driving command – the direction is saved and applies in all windows.
“📥 Depot”Takes the train off the track; you can place it again later.
“🏠 Home”Remembers this track as the home track (“🟢 Start” and “🏠 Go home” work with it). If it is already the home track, the button is highlighted and a click clears it.
“✥ Reposition”If a train is really standing somewhere other than in the track plan, use this to tell LoDi-Aura: a ghost train follows the pointer along the track and snaps to the stopping point (with Shift, without snapping). R turns it, a click places it, Esc cancels; on a touchscreen the first tap shows it, the second places it. Repositioning only works when the train is stopped, and any other block must be free.
“⏭ Advance”For tidying up after a restart: only if the block does not report occupied even though the train should be standing there – it has then rolled on forwards. The train creeps forward to the next block with the turnouts as they are set; the feedback sensor there tells where it really is.
“🗺 Where may I go?”Shows at every block whether this train may enter: ⇄ may · → one direction only · ✕ may not. Clicking a block bars it for the loco or train; “Rules done” finishes. Also works with the layout switched off and needs the right to edit.
“⏱ Measuring run”Only for a standing train made up of exactly one loco: measures its speed curve (see Calibration). While it is running, the button reads “⏱ Stop measuring run”.

If you are looking for a train in the track plan, “🎯” in the “Trains ⧉” window finds it: the track plan comes to the front, centres the loco and briefly highlights it – even in a different layout part.

“🔃 Turn” and “📥 Depot” are only available when the train is safely stopped – not moving and not holding a route. “🏠 Home” disappears while it is moving. If a button is missing, press STOP first.

On a block without a train, the menu offers “⇱ Take over …” if the feedback sensor is occupied and RailCom is reading the loco of a train there that, according to the plan, is standing somewhere else. The train is moved here – without a driving command. If it is not offered, the menu gives the reason (“not offered: …”).

Stopping

HowWhat happens
Double-click the trainEMERGENCY STOP – immediately, where it is. The route stays locked; another double-click releases it. The first click has to hit the train, the second can go anywhere – otherwise a moving train would already have rolled on.
STOP in the train menuThe button in the middle of the compass: speed step 0 for every train in this block, and a booked route is released. The train stays in its mode but is no longer departed (A grey) – it only carries on with a new departure arrow. If it is already stopped and only holding a route, the button shows ✋: a click releases the route.
EscCancels a train action in progress.
“🛑 STOP” in the toolbarStops the whole layout (next section).

The buttons in the track plan toolbar

The toolbar above the track plan holds the buttons for the whole layout. Green is the way into operation, red the way out.

ButtonWhat it does
“🟢 Start”Every train standing on its home track sets off; trains standing elsewhere stay put. If the layout is currently stopped (the button then says “Operation paused”), this button releases the stop. Carrying on is always done here, never with the red button.
“🛑 STOP”The first press stops – how, you set in the ▾ menu (default: every train runs to the next stopping point and brakes there). Every further press while stopping is already in progress is the EMERGENCY STOP: all locos immediately, without braking delay. What counts is the state, not the time – so a double-click is always an emergency stop, and so is a slow second click.
▾ (“Stop operation”)The menu on the red button (table below).
“🧰 Tools ▾”Rarely used tools (table below).

Stop operation

The menu on the red button lists the ways of bringing the layout to a standstill, from gentle to hard:

EntryWhat happens
“🏠 Go home” – home in order, then restEvery train with a home track runs home and is parked there. While this is in progress, ● appears next to the entry and ◷ with the count next to the red button. A second click on the entry cancels: the trains get no new destination; any train that is moving still finishes its booked route.
“🛑 Halt trains” – at the next stopping pointEvery train runs to the next stopping point and brakes there cleanly.
“⏹ Stop trains” – immediately, speed step 0Speed step 0 to all locos. The locos' braking delay still applies – they roll to a stop.
“🚨 Emergency stop” – immediately, without deceleration rateEmergency stop to all locos; the locos' braking delay does not apply.

With the pin (📍/📌) next to an entry, you set what the first press on “🛑 STOP” does. It can't be Go home: that doesn't set the stopped state, so a second press would not give an emergency stop.

Tools

EntryWhenWhat it does
“📏 Calibration run”alwaysMeasures the block lengths with a calibration loco (see Calibration).
“🔎 Check track plan”alwaysLists known errors in the track plan, such as duplicate feedback sensors, blocks without an exit, turnouts without an address or home tracks that are too short.
“↺ Turnouts to home position”in operationSets all turnouts to their home position. Turnouts in booked routes and under trains that LoDi-Aura knows about stay as they are.
“📌 Pushpin”in operationPlaces a note pin (below).
“🔌 Re-lay all cables”in edit modeCreates the feedback cables in the track plan from the addresses you have entered.
“📐 Alignment guides while dragging”in edit modeTurns the guide lines on and off while drawing.

To release a route that is stuck, use STOP or ✋ in the train menu, one train at a time.

Switching in operation

ElementWhat a click does
TurnoutThrows it. For a double slip with two drives, a three-way turnout or a single slip, a panel with all positions opens instead – one picture per position showing the path that is set, with the current one highlighted; a click sets the turnout to that position. LoDi-Aura decides whether it switches: a locked turnout (route active or occupied) gives the reason.
SignalOpens the panel with all aspects of the signal and “⟲ Automatic” (see Turnouts and signals). Setting it by hand changes the display and the real signal, not the driving.
StationOpens the menu with the operating mode (see Stations, shunting and staging yards).
Booster outputWith a real, connected booster, a real switching command. If no device is connected, the click does nothing.
House and station windowsSwitches the lighting on and off by hand; the picture changes as soon as LoDi-Aura confirms it. With the layout switched off, LoDi-Aura refuses. A light on the Shift-Commander with more than two states opens a panel with all states, named after its command list.
Buffer stop lamp · bridge houseSwitches the light.
Turntable · segment turntable · traverserA click on the pit opens the control panel; a click on a track at the bridge moves it there.

Pushpins: notes in the track plan

  1. Choose the pinIn operation, click “🧰 Tools ▾” › “📌 Pushpin”.
  2. Place itThe next click places a note pin on a turnout, a block, a track – or anywhere in the plan.
  3. Write a noteWrite down what you noticed, for example “it always judders here”.

Clicking an existing pin opens its note. Pins marked as “done” don't disappear but stay in the history; for each spot, LoDi-Aura counts how often something has been noted there. Open pins are listed in the log under “Maintenance” (see Log and diagnostics).

What the track plan shows

LoDi-Aura never turns a placed train by itself. RailCom reports what it sees, but doesn't change how you placed the train – unless you have switched on “Relocate by RailCom” (see “Safety”): then a train follows its number into another block and picks up the direction there afresh. If a train is the wrong way round in the picture, turn it with “🔃 Turn”. The ◀ ▶ arrows won't help here: they only change the loco's direction of travel.

Reversing loops

LoDi-Aura plans and drives routes through reversing loops, but doesn't switch anything electrically – the polarity is changed by a separate reversing loop module on the layout. Returning to the train's own starting block only works if the train length is known and the loop is longer than the train. You can't drag the train's own block as a single destination: it works as a waypoint with Shift, or you choose a destination beyond the loop. In “🔄 Auto”, LoDi-Aura does not extend the run back through the loop; the train stops at the end of the booked route and then looks for a new destination.

Safety

You will find the safety settings under “System” › “Track plan” in the “RailCom”, “Protection”, “Automation” and “Program start” cards. Switches marked “Administrator” can only be changed by whoever administers the layout (see Settings).

The fields apply to all trains on the layout and are saved in the project.

SettingMeaning
“Protection distance (cm)”Behind the train, the route is only released once the end of the train plus this margin has passed. This protects against a following train moving up too early, for example if only the loco is detected. In front of another train's block, a train stops at least this far before the boundary (empty = 20 cm).
“Protection time (s)”In addition to the protection distance: the section behind the train stays locked for this many seconds.
“RC guard: immediate stop on wrong-way run/intruder (level 2)”On a wrong-way run or an intruder ahead, the train is stopped immediately. Off = only a warning is given (⚠ in the track plan). The warning level is always active.
“Turnout guard: emergency stop if the turnout behind the stop block reports occupied”Only takes effect when the train itself is standing at the block boundary – then the occupancy behind it can only be the train itself (overrun). Off = only a message in the log.
“Learn the RC direction of the blocks from driving”Off (default) = only reports if RailCom keeps showing the opposite direction on a block; the setting in the block inspector stays yours. On = LoDi-Aura turns such blocks round by itself. Careful: a loco with a decoder fitted the wrong way round reports wrongly on every block – LoDi-Aura then learns the wrong thing.
“Relocate by RailCom”Off (default) = a placed train is never moved by RailCom. On = if you lift a loco off and put it down somewhere else, the train follows – but only once the feedback sensor under it has been free for 5 seconds and its number appears steadily in another occupied block. If it only flashes up somewhere, nothing happens. A train with a driving job keeps following the feedback sensors; one with several locos only moves if all of them are read there. The block directly behind the train is excluded. Every move is recorded in the log. LoDi-Aura always handles placing from the depot.
“Behavior on short circuit”If a booster channel reports a short circuit: “Stop affected trains (default)” – they get speed step 0 immediately and carry on by themselves as soon as the power is back –, “Stop all trains” or “Report only”.
“Detour automation”What happens if the way stays blocked: “Off — a waiting train stays put”, “Only when stopped (after ~10 s wait)” or “Immediately at the first blocked block”. Individual trains may differ from this (“Detour” field on the train); “Off” here applies to all trains.
“When stopped, complete rebooking is allowed”Allows the automation, when stopped, to re-book the part of the route already travelled as well, instead of only the rest.
“Roamer wait time (s)”How long a self-driving train waits in front of an occupied station track before moving aside onto a line block and releasing its own block. Empty or 0 = 30 seconds.
“Lights on locos always on”When connecting, LoDi-Aura switches on F0 for all locos of trains that are standing on a block in the track plan. Locos in the depot stay dark.

Whatever the RC guard finds is recorded in the log – as an error if a train was stopped, otherwise as a warning. The block or turnout shows “⚠ RC” or “⚠ STOP” for 90 seconds.

What always applies

  • Speed steps don't survive a restart. As soon as the layout goes online after starting, every loco of a placed train gets speed step 0 (see Installing and starting). A train must not carry on by itself after a restart.
  • Speed step 0 before every switch-on. Not just the main “Layout” switch: GO in the throttle, GO on a command station in the booster window and the first main-track booster on the LoDi-Rektor also set that command station's placed locos to speed step 0 first. Otherwise locos would set off at their last saved speed step when power comes on. If a STOP or an emergency off happens in the meantime, nothing is switched on; the log names the command station.
  • Movement only with track power on. Without a booster, the automation doesn't drive either, and LoDi-Aura refuses a new driving command and gives the reason.
  • Driving and all guards run in the program on the layout computer. Closing an interface window doesn't stop any train. If the program crashes, a layout on the LoDi-Rektor loses power within about two seconds because its watchdog stops getting a signal. LoDi-Aura does not maintain such a watchdog on the Z21, ECoS and Märklin® CS3 – what happens there in a crash is up to the command station.
  • Dead man's switch: if the automation stands still for more than three seconds while the layout is online, LoDi-Aura switches off track power on all command stations and sets ALL STOP. The log names every command station that could not be switched off. After that, nothing starts up again by itself.
  • Cycle watchdog: if the automation's cycle drops out for half a second, a warning appears in the log. After one second, every placed loco gets an emergency stop, and ALL STOP applies until you release it; track power stays on.