Interface

ContentObjectsLocomotives



LocoDialog Interface Tab.

Bus

See: Addressing


Address

The decoder address which range depends on the decoder type and underlying Command Station.

  • Marklin mfx-Decoders may need special settings depending on the command station. See the wiki page of the relevant command station, if applicable.
  • Locos with address 0 (zero) are considered to be analogue locos without decoders. The Address therefore must not be 0 (zero) unless a command station designed for running analogue locos is used.


Interface ID

Only set this to the IID you set in the rocrail.ini if your setup has more than one CS connected.


Protocol

Some command stations do support multiple protocols; Check the user manual for details.
If the address is set to zero the protocol should be set to Analog for Track Driver support.


Protocol version

If the Command Station cannot determine the decoder type itself you must specify the version as listed here ddx-en or found in the SRCP description. Most systems do not use this parameter because it is set directly in the CS or it does only support one version.


Number of functions

Number of supported extra function supported by the used decoder.


Decoder steps

Number of speed steps the decoder is set up to. Rocrail needs the number of the decoder's speed steps e. g. to be able to calculate the wanted velocity in percent or KM/H.

  • The number of speed steps of the decoder, the command station and in Rocrail must match otherwise the loco light (F0) may not work correctly.


Speed

V_min / V_Rmin¹

This should be set to the slowest reasonable locomotive velocity and is set when running in auto mode on the pre2in event (see also Sensors and Blocks).
The value is in km/h or % depending on V_mode (see below).

V_Rmin: This should be set to the slowest possible reverse locomotive velocity. V_min will be used if left to zero.


V_mid / V_Rmid¹

This should be set to a medium locomotive velocity and is set when running in auto mode on the enter event.
The value is in km/h or % depending on V_mode (see below).

V_Rmid: This should be set to a medium reverse locomotive velocity. V_mid will be used if left to zero.


V_cru / V_Rcru¹

If set greater then zero this is used as the cruise locomotive velocity instead of 80% of V_max
The value is in km/h or % depending on V_mode (see below).

V_Rcru: This should be set to the cruise reverse locomotive velocity. V_cru will be used if left to zero.


V_max / V_Rmax¹

V_max has two different meanings depending on V_mode (see below):

  1. In percent mode the value defines the maximum velocity in percent of the maximum number of decoder steps
  2. In km/h mode the value has to represent the velocity of the loco at highest decoder step (i. e. 28/128, or 14,27 depending on the decoder).
    The value is not used to adjust the maximum velocity. This has to be achieved by adjusting the decoder itself (e. g. CV6 for DCC compatible decoders).


V_Rmax: Should be set accordingly for reverse running. V_max will be used if left to zero.

¹) Reverse velocity settings are for automatic mode only and do not apply to throttles or other manual controllers.


V_step

This option is not active and greyed out by default. It can be used for old-fashioned decoders offering no regulation and mass simulation.

  • Regulated (see below) has to be deactivated in order to enable V_Step.

V_step merges in a pause between the decoder steps with a value of 1 corresponding to 100ms. With modern decoders this parameter is not needed and should be left to zero.

Tip: V_Step can be used to increase the deceleration / acceleration for decoders with a very limited tuning range. Some older Marklin locos with control potentiometers suffer from this limitation. Small values of V_Step, e. g. in the range of 1 to 5, may help in this case. It should be noted that no other locos in need of automatic speed control at inclines (see Regulated below) are present on the layout and that in all blocks the type of incline should be set to “none”.



Options

V_mode

V_Mode can be set to either Percent or km/h.

V_Mode Percent

With the check-box Percent activated velocities are in percent of the maximum decoder step. With a decoder offering 28 decoder steps as an example, 100% equals decoder step 28 whereas 50% equals decoder step 14.

Note: V_Max reduces the maximum velocity of the locomotive in percent-mode if values below 100 (percent) are entered.
Note: It is generally not recommended to reduce a locomotive's maximum speed by only V_Max as the number of available decoder steps would be reduced. Example: A locomotive equipped with a Motorola decoder featuring 14 decoder steps has a maximum velocity of 200 km/h but the maximum velocity of the original engine is 120 km/h. Reducing V_max to 60%, which is decoder step eight, leaves eight speed steps for the 120 km/h range. This will lead to an increase / decrease of 15 km/h (120 km/h : 8) per decoder step. It is thus favourable to adjust the decoder itself to the desired maximum speed if possible leaving V_Max to values around 100%. Decoders without any internal speed setting, however, may be adjusted by decreasing V_Max if necessary.

V_Mode km/h

Unchecking the check-box Percent activates the km/h mode.

Note: The locomotives maximum velocity is not influenced by V_Max in km/h mode.

V_Max has to be set to the velocity the model engine gains at the highest decoder step. This value is the basis for Rocrail's calculation of all other velocities. Example: If a model engine was adjusted to 80 km/h maximum speed 80 has to be entered into the field V_max. If, for example, 35 km/h is the desired speed for V_Mid 35 has to be entered there.

Note: A linear speed curve is a prerequisite for a working km/h mode, e.g. a V_Mid of 35 indeed yields 35 km/h. If this condition can not be fulfilled it is recommended to use percent mode instead.


Mass

Only to be used when this is an analogue loco in combination of the Dinamo CS. (Check the documentation.)


Regulated

If the decoder has motor management (BEMF) this flag should be set to prevent velocity changes by Rocrail when a locomotive enter a block defined as an incline block.
Deactivating this option activates V_step (see above) and automatic speed control at inclines.

Note: Rocrail is able to adjust the speed at inclines within certain limits in auto mode. The type of incline has to be specified in the block properties.


Poll info

Some bus systems, like XpressNet, do not propagate loco changes issued by throttles.
By activating this option, and if the loco is not in auto mode, every second a request is send to the Command Station to get the actual information needed to update the Rocrail clients.


Placing

When the loco runs the wrong direction this flag can be flipped. Default means the loco run direction when coming out of the box; some older decoders do only remember the direction for a short period after shut-down the power. When the decoder has “forgotten” its previous direction, then it will run the next time in its “default” direction. Read also: Direction in Rocrail

Dir pause

Some old Delta like decoders need some pause between a direction change and the last turnout command. With about 100ms this will do the trick when running DDX.


Acceleration

Adjust acceleration

  • Only available in combination with DCC and Trains.
  • The max. load and the acceleration range must be set greater then zero.
  • If the total train weight is zero the min. acceleration value is used.
  • The new calculated acceleration value will be written by POM in CV3 after assigning a train or in case Car1) properties have been modified.
  • The min. acceleration value will be written by POM in CV3 after releasing the assigned train.

Max. Load

The max. load for this locomotive in tons.

Min./Max. Acceleration

The CV3 range to use for loads between zero and max. load.

Server trace example

20130723.090557.995 r9999I cmdrD000 OLoc     2707 processing cmd="assigntrain" for [E03]
20130723.090557.995 r9999I cmdrD000 OLoc     2848 consist [train1] assigned to loco [E03]
20130723.090557.995 r9999I cmdrD000 OCar     0354 car [test] loaded weight [500]
20130723.090557.995 r9999I cmdrD000 OLoc     2026 loco [E03] adjust acceleration: CV3=16
20130723.090557.995 r9999I cmdrD000 OVirtual 0437 program cmd=1 mode=0
20130723.090557.995 r9999I cmdrD000 OVirtual 0465 POM: set CV3 of loc 1003 to 16...
20130723.090557.995 r9999I cmdrD000 OLoc     2079 loco [E03] train length=56 weight=500 
1) 5599+

Personal Tools