Differences

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

--- loc-details-en [2020/03/18 15:10] – [V0 on swap] smitt48
+++ loc-details-en [2024/03/15 11:30] (current) – [Check for free destinations until reaching IN] rjversluis
@@ 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]] | [[:loc-int-en|Interface]] | [[:loc-speed-en|Speed]] | **Details** | [[:loc-fun-en|Functions]] | [[:loc-consist-en|Multiple Units]] | [[:loc-cv-en|CV's]] | [[:loc-bbt-en|BBT]] | [[loc-sbt-en|SBT]] | [[loc-bat-en|BAT]] | [[loc-calibrate-en|Calibrate]]
+  * [[loc-index-en|Index]] | [[loc-gen-en|General]] | [[:loc-int-en|Interface]] | [[:loc-speed-en|Speed]] | **Details** | [[:loc-fun-en|Functions]] | [[:loc-consist-en|Multiple Units]] | [[:loc-cv-en|CV's]] | [[:loc-bbt-en|BBT]] | [[loc-sbt-en|SBT]] | [[loc-bat-en|BAT]] | [[loc-calibrate-en|Calibrate]] | [[loc-shunting-en|Shunting Mode]]
@@ Line 10: / Line 10: @@
 LocDialog Details Tab.\\
-{{:loc:loc-details-en.png?800}}
+{{:loc:loc-details-en.png?801}}
  \\
@@ Line 42: / Line 42: @@
 Train priority used for multiplying the block wait time if no destination is found.
 Default priority is 10.\\
+This priority is only used in case of ICE and/or **[[:block-gen-en#mainline|Mainline]]**.\\
 If the train does not normally have to wait in the block the following formula and table shows the effect of the priority value: \\
+|< >|
 ^ pause in ms ^
-| (10 + 2 * priority) * 100 | \\
+| (10 + 2 x priority) x 100 |
- \\
-^ Priority ^ Min. wait time in ms ^
+|< >|
+^ Priority ^ Min. Wait time in ms ^
 |   0 |  1000 |
 |   1 |  1200 |
@@ Line 54: / Line 57: @@
 The lower the priority the more CPU power is used.\\
 > Tip: Use with care and lower it only for a few High Speed trains.\\
+====Force====
+Force to use the priority timer regardless off train type and/or mainline in case of block wait.\\
  \\
-=====Delay for direction change=====
+=====Swap timer=====
-//Revision 14916+.//\\
 Some Command Stations will send an emergency break before changing direction, which will cause an abrupt stop of the locomotive.\\
 In that case this option can delay the swap command(which results in a direction change) by the number of ms specified, to avoid this abrupt stop.\\
@@ Line 84: / Line 89: @@
 ===== Options =====
-==== Commuter train ====
-This flag is needed if the locomotive should be used for commuter trains. Only blocks **[[:block-permissions-en#commuter_train|allowing]]** commuter trains can be entered.
-The option is not needed for trains __exclusively__ travelling between blocks defined as **[[:block-gen-en#terminal_station|terminal stations]]** provided option **[[:rocrailini-automode-en#stop_none_commuter_in_terminal|Stop Non Commuter Trains in Terminal]]** is __not__ activated. \\
-However, only commuter trains are allowed to change their direction in blocks other than terminal stations. The blocks in this case must allow commuter trains __and__ **[[:block-gen-en#allow_change_direction|direction changes]]**.
-Further details are described on page **[[:commuter-setup-en|Setting Up a Commuter Train]]**.
- \\
 ==== Use schedules departure time ====
 Departure times in schedules will be used by this train.
@@ Line 103: / Line 98: @@
 ===Also in case of wait===
 This extra option will reserve the second next block also in case it must wait, which is for ICs very useful to be able to depart as planned.\\
-:!: The __**[[:block-gen-en#allow_second_next_block_in_case_of_wait|same option]]**__ must be set in the block where the loco must wait.\\
+**Note:** The __**[[:block-gen-en#allow_second_next_block_in_case_of_wait|same option]]**__ must be set in the block where the loco must wait.\\
  \\
 ==== Use shortin event ====
 Short trains can use this event to stop in a block.\\
@@ Line 123: / Line 117: @@
 ==== Use own wait time in blocks ====
 This option will force the wait time specified in the loco properties in every block regardless of the block settings.
+ \\
+==== Wait in all blocks ====
+Activate this option if the locomotive should always wait in all blocks, regardless of the waiting settings. The **[[#block_wait_time|Block wait time]]** defined for this locomotive is used.\\
+  * **Note:** Use only temporarily, e.g. to learn blocks without waiting settings in the BBT learning phase for this loco.
+=== Alternately ===
+Additional option that applies the option **[[#wait_in_all_blocks|Wait in all blocks]]** at the block after next. This is helpful, if in short block sections a locomotive in the BBT learning phase cannot reach the regular entry speed in the next block while waiting in all blocks.
+  * **Note:** With an even number of blocks per round, the entire BBT learning process would only be performed on half of the blocks. \\ Therefore, in this case, after the end of the entire learning phase for the first half, \\ the BBT learning process must be continued __shifted by one block__ with the other half.
  \\
 ==== Check for free destinations until reaching IN ====
+^  Do not use in combinations with schedules. \\ This option is automatically disabled at the last entry in schedules.  ^
 If set the checking for free destinations will continue after the **enter** event and until reaching the **in** event. If in the meantime a free destination block becomes available the train accelerates again and is not forced to stop.\\
-:!: Use with care. Every 100ms the loco main function tries to find a free destination. (Needs much CPU resources.)\\
+Use with care. Every 100ms the loco main function tries to find a free destination. (Needs much CPU resources.)\\
-The look up interval is from revision 4553 dependent of the priority: 0 = 100ms, 10 = 1000ms\\
+The look up interval is read from Priority (left column): 0 = 100ms, 10 = 1000ms
- \\
+\\
 ==== Use depart delay ====
 Use the **[[:block-gen-en#depart_delay|Block depart delay]]** for this loco.\\
@@ Line 136: / Line 144: @@
 ==== Free previous block on free or enter ====
-| :!: This option is **only usable with very short trains**, __should be used with care to avoid accidents__, and is **not** supported in the Forum. |\\
+| :!: This option is **only usable with very short trains**, __should be used with care to avoid accidents__. | \\
-The length of train should be less than:\\
+The length of a train __must be less than__:\\
   - the distance between a switch tongue and the free or enter sensor
   - the distance between two sensors, the in sensor from the previous block and the enter sensor of the entered block
 It frees up the previous block and the current route on the **free** or **enter** event to make it available for other trains.\\
-This option also depends on the __**[[:block-gen-en#free_previous_block_on_enter|Block option]]**__. \\
+This option also depends on the __**[[:block-gen-en#free_previous_block_on_enter|Block option]]**__ and the __**[[:operator-consist-en#options|Train Option]]**__. \\
 | :!: The BBT __**[[:loc-bbt-en#from_block|From block]]**__ option does not function with this option activated. |\\
 | :!: Track driver systems, like Dinamo, are NOT supported. |\\
@@ Line 166: / Line 174: @@
 This option overrules the **[[#reduce_speed_at_enter|Reduce speed at enter]]** option.\\
-====Reset placing and direction====
+====Reset logical direction====
-Initial, at startup, the loco placing and direction will be reset to the default values.\\
+Initial, at startup, the loco logical direction will be reset to the default values.\\
 | Use with care. It is only introduced for those who remove the locos from the layout at the end of a session. |
@@ Line 190: / Line 198: @@
 \\
 ====Generated====
-Locomotive is down-loaded from the command station.
+The locomotive was __not__ created in the locomotive dialog, but is \\
+   * Guest locomotive. \\
+   * downloaded from the command station. \\
+   * generated in a block by BiDi event. \\
+Remove the checkmark, if the locomotive needs to be kept in Rocrail.
 \\
 ====Swap on manual direction change====
+In half automatic mode the direction of the loco is swapped.
+====Record schedule====
+Generate a schedule from all visited blocks in automatic mode.\\
+The schedule recording ends, and will be added to the table, after stopping the locomotives automatic mode.\\
+This option is automatically reset.\\
+====Decoupler====
+This flag can be used with a query in XMLScript to check if this loco has a decoupler.\\
+====Use Route Stack====
+Keeps track of used routes and provides an on the fly **[[:route-gen-en#preferred|Preferred Route]]** value.\\
+This option makes it possible to let run a locomotive alternately all possible destinations in random automate mode.\\
+Routes can be excluded by the **[[:route-gen-en#use_stack|Use Stack]]** option.\\
+* **Hints:**
+    * Stack here means a temporary table of used routes.
+    * With the Route Stack it is achieved that already used routes are only used again when all other possible routes, between two blocks, have also been used.
+    * This thus avoids the possibility of using the same route multiple times in a row in aquarium auto mode.
+    * The Route Stack achieves this by dynamically assigning preference values that override the value defined in the properties only for the duration of the session.
 \\
+====Stop on fail goto block====
+If no destination can be found the locomotive stops searching for destinations. \\
+ \\
+====Only direct goto block====
+The locomotive will only accept a direct route to the requested destination. \\
+ \\
+==== Commuter train ====
+This flag is needed if the locomotive should be used for commuter trains. Only blocks **[[:block-permissions-en#commuter_train|allowing]]** commuter trains can be entered.
+The option is not needed for trains __exclusively__ travelling between blocks defined as **[[:block-gen-en#terminal_station|terminal stations]]** provided option **[[:rocrailini-automode-en#stop_none_commuter_in_terminal|Stop Non Commuter Trains in Terminal]]** is __not__ activated. \\
+However, only commuter trains are allowed to change their direction in blocks other than terminal stations. The blocks in this case must allow commuter trains __and__ **[[:block-gen-en#allow_change_direction|direction changes]]**.
+Further details are described on page **[[:commuter-setup-en|Setting Up a Commuter Train]]**.
+===Include===
+If the list is not empty the locomotive will only behave as commuter in the listed blocks.\\
+This is a CSV list. Use the [...] button for block selection.\\
+Alternative is to use the combobox for selecting a Z-Level.\\
+ \\
 ===== Engine =====
-If set to Electric, and possible destination blocks are not "__**[[:block-gen-en#electrified|Electrified]]**__", then the locomotive will probably not find a new destination block.\\
+If set to Electric, and possible destination blocks do not have "__**[[:block-gen-en#electrified_catenary|Catenary]]**__", then the locomotive will probably not find a new destination block.\\
+//This default behaviour is for protecting the sensitive pantograph on the top of the locomotive.//\\
+It can also be used for **[[:route-perm-en#engine|Route]]** and **[[:block-permissions-en#engine|Block]]** permissions.\\
+ \\
+===== Engine Fx =====
+If the selected function is set greater then zero the selected engine type will be used if this function is active. (On)\\
+Can be used for **[[:route-perm-en#engine|Route]]** and **[[:block-permissions-en#engine|Block]]** permissions.\\
  \\