User Tools

Site Tools


loc-int-en

Interface

ContentObjectsLocomotives



LocoDialog Interface Tab.

Interface ID

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

All

If this option is activated all Loco and Function commands will send to all connected Command stations.

Node ID (Bus)

See: Addressing


Address

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

  • Attention: Contrary to the NMRA standard with addresses greater than 127, addresses from 100 must already be programmed in the Locomotive decoder as "long address" when controlling with Rocrail. For this it is essential to consider CV29/Bit5=1 and CV17/18 or do not use the addresses between 100 and 127 :!:
  • 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 analog locos without decoders which are only supported by TrackDriver (like Dinamo) systems. Address 0 is only accepted if the protocol is set to Analog, otherwise an error message will be displayed.
    "Stretched 0 Bit" according to NEM 670 is not supported.

Secondary Address

The optional secondary address can be used for WIO or T4T (TrainCoupling&CommunicationSystem).

OID

Some Command Station, like the ESU Ecos, are using an Object ID instead of an address for referring to a specific loco.
This field can be left empty because the Ecos library can also look up locos by ID or address.


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.

Note: Serverdefined, is the default mobile digital protocol used by the Command Station (CS). This setting is only of interest in case of multi protocol CS like Ecos/CSx(dcc/mfx). For a "DCC only" CS this option has no effect at all. Or for the Märklin 6051 its always Motorola.

Protocol version

If the Command Station cannot determine the decoder type itself the version must specify as listed 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.


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 Rocrail must match otherwise the loco light (F0) may not work correctly.

The optional second speed steps can be used for T4T.


Number of functions

Number of extra functions supported by the decoder used. Default F0…F4.

Camera

The IP address and port of the locomotive its live streaming camera, which will be showed in the throttle dialog.
Supported streaming formats:

  • HTTP
  • Roco

Skip Frames

The field in the middle is the number of frames to skip. This will reduce CPU power and fluency of the video stream.
Note: Frames will also be skipped if the graphic processing is slow, even if this parameter is set to zero; The video stream cannot be paused.

Options

The field on the right is an option for the ThrottleDialog.

1 Rotate 90° CCW
-1 Rotate 90° CW
2 Rotate 90° CCW and use only the lower half of the image.
-2 Rotate 90° CW and use only the lower half of the image.

Roco

The Roco video locomotive must be configured in "Client Mode".
This can be done with the Roco Videolok utility.
The port must be set to 5152.
Note: It can take up to 30 seconds before the first frames are coming in after starting the camera.

Note: If a train is assigned to the locomotive, and this train contains a car with a streaming camera, the camera of the car will be used instead.



Options

Mass

Can be used:

  • When this is an analog loco in combination of the Dinamo CS. (Check the documentation.)
  • A WIO with the mobile option activated.
  • A RocNetNode mobile decoder

A value of 5 is a good start to experiment with.

Dir Change 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.

Poll info

XpressNet does 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.
:!: Use with care. This option is not recommended and not supported in the Forum, and uses unnecessary CPU resources. :!:

Invert

Inverts the hardware running direction.
This is an alternative to program the direction in the decoder by CV29.

Polarisation

A flag for correcting the BiDi, RailCom, direction in case the decoders is not correctly polarised.
See also: BiDi Direction

Step range

If WIO as Mobile decoder be used, this can simulate Vstart and Vhigh, CV2/CV5.

Field Value Remark
1 Min. Step
2 Max. Step
3 PWM width factor Example for 100 speed steps: 1=10kHz, 10=1kHz, 100=100Hz, 1000=10Hz

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 Car 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 


loc-int-en.txt · Last modified: 2020/10/03 08:30 by rjversluis