Differences

This shows you the differences between two versions of the page.

--- loc-int-en [2018/11/25 08:06] – [Polarisation] rjversluis
+++ loc-int-en [2024/04/18 02:15] (current) – [Protocol] rainerk
@@ Line 2: / Line 2: @@
 [[:english#objects|{{  :objects.png}}]][[:english|{{  :rocrail-logo-35.png}}]]
 [[:english|Content]] -> [[:english#objects|Objects]] -> **Locomotives**
-  * [[:loc-index-en|Index]] | [[:loc-gen-en|General]] | **Interface** | [[:loc-details-en|Details]] | [[:loc-fun-en|Functions]] | [[:loc-consist-en|Multiple Units]] | [[:loc-cv-en|CVs]] | [[:loc-bbt-en|BBT]] | [[loc-sbt-en|SBT]] | [[loc-bat-en|BAT]] | [[loc-calibrate-en|Calibrate]]
+  * [[:loc-index-en|Index]] | [[:loc-gen-en|General]] | **Interface** | [[:loc-speed-en|Speed]] | [[:loc-details-en|Details]] | [[:loc-fun-en|Functions]] | [[:loc-consist-en|Multiple Units]] | [[:loc-cv-en|CVs]] | [[:loc-bbt-en|BBT]] | [[loc-sbt-en|SBT]] | [[loc-bat-en|BAT]] | [[loc-calibrate-en|Calibrate]] | [[loc-shunting-en|Shunting Mode]]
@@ Line 13: / Line 13: @@
 =====Interface ID=====
-Only set this to the IID you set in the rocrail.ini if your setup has more than one CS connected.
+If more than one command station is used, then the command station that is responsible for controlling the loc-decoder is specified in this field. The "Interface identifier" field can remain empty if the object is connected to the first command station (first 'digint' in rocrail.ini) from the list of command stations.
- \\
 ====All====
 If this option is activated all Loco and Function commands will send to all connected Command stations.
  \\
-=====Bus=====
+=====Node ID (Bus)=====
 See: **[[:addressing-en#bus|Addressing]]**\\
@@ Line 26: / Line 26: @@
 =====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 systems. "Stretched 0 Bit" according to NEM 670 is not supported.
+  * 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|protocol]] is set to **Analog**, otherwise an error message will be displayed. \\ "Stretched 0 Bit" according to NEM 670 is not supported.
-The optional second address can be used for T4T (TrainCoupling&CommunicationSystem).\\
+====Secondary Address====
+The optional secondary address can be used for **[[:arduino:wio-en#mobile|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.\\
@@ Line 38: / Line 40: @@
 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 __**[[:block-int-en|Track Driver]]**__ support.\\
- \\
+**Notes:** \\
+//With Rev. 2.1.4466+ the term "Serverdefined" was replaced by "Default". Functionally, nothing has changed.
+Default, 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 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. \\
+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. \\
@@ Line 49: / Line 58: @@
 =====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.
+  * 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.
@@ Line 56: / Line 65: @@
 =====Number of functions=====
 Number of extra functions supported by the decoder used. Default F0...F4.\\
-\\
-===== Speed =====
-The KMH column, the second one, is for displaying the throttle speed in kmh and is available only when Percent mode is selected\\
-   * All KMH and V values must be set greater then zero to activate the display values
-   * Percent values in between will be interpolated.
-   * This KMH values will be handled with KMH settings in objects, e.g. max kmh values in blocks, routes, cars and trains (11.056+)
-\\
-==== 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.
-==== 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.
  \\
-==== V_Min - KMH_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-en|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. \\
- \\
+=====Camera=====
-==== V_Mid - KMH_Mid / V_RMid ====
+[[https://youtu.be/6A57b-VoOSw|{{ :rocnet:cam:cam-throttle-demo.png}}]]
-This should be set to a medium locomotive velocity and is set when running in auto mode on the **enter** event. \\
+The IP address and port of the locomotive its live streaming camera, which will be showed in the throttle dialog.\\
-The value is in **km/h** or **%** depending on **V_mode** (see below). \\
+Supported streaming formats:
- \\
+  * HTTP
-**V_Rmid**: This should be set to a medium **reverse** locomotive velocity. V_mid will be used if left to zero. \\
+  * 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.// \\
-==== V_Cru - KMH_Cru / V_RCru ====
+====Options====
-If set greater then zero this is used as the cruise locomotive velocity instead of 80% of V_max \\
+The field on the right is an option for the ThrottleDialog.\\
-The value is in **km/h** or **%** depending on **V_mode** (see below). \\
+|   1 | Rotate 90° CCW |
- \\
+|  -1 | Rotate 90° CW |
-**V_Rcru**: This should be set to the cruise **reverse** locomotive velocity. V_cru will be used if left to zero. \\
+|   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 [[https://www.z21.eu/de/downloads/software-tools|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.//\\
+{{:roco:roco-videolok-utility-clientmode.png?240}}\\
-==== V_Max - KMH_Max / V_RMax ====
+====Demo & Links====
-V_max has two different meanings depending on V_mode (see below):
+  * Demo: https://youtu.be/6A57b-VoOSw
-  - In percent mode the value defines the maximum velocity in percent of the maximum number of decoder steps
+  * __**[[:rocnet:cam-en|Camera Streaming]]**__
-  - 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).
+  * [[https://randomnerdtutorials.com/esp32-cam-video-streaming-face-recognition-arduino-ide|ESP32-CAM]]
+**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.//\\
  \\
-==== V_Max sec. ====
-The optional second V_max can be used for T4T.\\
  \\
-**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.\\
- \\
- \\
 =====Options=====
 ====Mass====
-Only to be used when this is an analog loco in combination of the Dinamo CS. (Check the documentation.) \\
+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.
+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.
  \\
 ====Poll info====
@@ Line 137: / Line 117: @@
 :!: 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.\\
+<html><!--
 ====Placing====
-When the loco runs the wrong direction this flag can be swapped.\\
+//Placing is the __logical__ forward direction.// \\
+When the loco runs the wrong direction this flag can be swapped. This flag is not fixed and can change during automatic runs.\\
 For commuters this flag is automatically swapped in __**[[:block-gen-en#terminal_station|terminal station block types]]**__ and for routes in the opposite direction.\\
 This flag is default set and means a Loco run direction like 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.\\
-If the flag is __not__ set the placing type is swapped.
+If the flag is __not__ set the placing type is swapped.\\
 Read also: **[[:direction-en|Direction in Rocrail]]**
+--></html>
 ====Polarisation====
 A flag for correcting the BiDi, RailCom, direction in case the decoders is not correctly polarised. \\
 See also: __**[[:rocrailini-automode-en#use_bidi_direction|BiDi Direction]]**__ \\
+====Step range====
+If __**[[arduino:wio-en#mobile|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 |
+====Regulated====
+Uncheck this option __**only**__ if the decoder has accelerating and decelerating not implemented.\\
+The interval is the time between the speed steps.\\
+ \\
- \\
 =====Acceleration=====
 ====Adjust acceleration====
@@ Line 160: / Line 154: @@
   * The new calculated acceleration value will be written by POM in CV3 after assigning a train or in case __**[[:car-gen-en|Car]]**__ properties have been modified.
   * The min. acceleration value will be written by POM in CV3 after releasing the assigned train.
+MFX Protocoll - start-up delay (tested with CS2):
+  * Decoder mSD/3 - version 3.2 : CV178 index 1
+  * Decoder mSD - version 1.17.19 : CV78 index 1
+  * Decoder mfx - version 0.0.24.186 : CV78 index 1
 ====Max. Load====
@@ Line 180: / Line 179: @@
  \\
+ \\
+=====Notes on none Regulated Decoders=====
+**Deprecated**\\
+====Interval====
+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 Interval.
+The Interval 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:** The Interval 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 interval values, 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".
+====Regulated====
+| SBT will be disabled in case this option is __not__ set. |\\
+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 **Interval** (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.
+The following table gives hints on the impact of the parameters. It is supposed that the **[[#v_modus|V_Mode-Percent-Option]]** is __not__ set and **km/h** is applicable.
+ \\
+| ^Speed in steps and time \\ Interval = 5 (0,5 sec / step) \\ Speed at the beginning of the braking: 100 km/h^^^^^^^^^^^^^^^^^^
+^  steps  ^  1  ^  2  ^  3  ^  4  ^  5  ^  6  ^  7  ^  8  ^  9  ^  10  ^  11  ^  12  ^  13  ^  14  ^  15  ^  16  ^  17  ^  18  ^
+^  time / sec  ^  0,5  ^  1,0  ^  1,5  ^  2,0  ^  2,5  ^  3,0  ^  3,5  ^  4,0  ^  4,5  ^  5,0  ^  5,5  ^  6,0  ^  6,5  ^  7,0  ^  7,5  ^  8,0  ^  8,5  ^  9,0  ^
+^  Decelerate \\ 5 km/h  |  95  |  90  |  85  |  80  |  75  |  70  |  65  |  60  |  55  |  50  |  45  |  40  |  35  |  30  |  25  |  20  |  15  |  10  |  **km/h**  |
+^  10 km/h  |  90  |  80  |  70  |  60  |  50  |  40  |  30  |  20  |  10  |  **km/h**  |
+^  15 km/h  |  85  |  70  |  55  |  40  |  25  |  10  |  **km/h**  |
+^  20 km/h  |  80  |  60  |  40  |  20  |  10  |**km/h**  |
+:!: Independently of the values in the table, the breaking will end at the speed defined in **V_Min**.\\
+\\
+**Hint:** At interval = **10** the number of steps = time in seconds. \\
+Higher values for **Interval** and/or **Decelerate** reduce the amount of necessary steps respectively speed commands.\\
+This can help to avoid the above mentionned overload of the command station.
+**Example:** At Interval = 5 and Decelerate = 5 the speed is reduced from 100 km/h to 10 km/h in 9 seconds with 18 steps respectively commands.\\
+At Interval = 10 and Decelerate = 10 the reduction takes also place in 9 seconds, but with only 9 steps respectively commands.\\
+> **Hint:** The speed steps are not visible in the throttle, but only in the trace or on the real layout.