intellibox-basic-en
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
intellibox-basic-en [2021/04/13 16:34] – [Mac OS X] besra | intellibox-basic-en [2021/12/02 17:27] (current) – rjversluis | ||
---|---|---|---|
Line 6: | Line 6: | ||
// \\ // \\ | // \\ // \\ | ||
- | < | ||
- | | [[: | ||
- | | //For testing purpose a test key for one week can be requested by email: “supportkey at rocrail.net”.// | ||
- | \\ | ||
- | --></ | ||
===== Product Overview ===== | ===== Product Overview ===== | ||
Line 21: | Line 16: | ||
- | ===== Setup ===== | + | ===== Introduction |
- | Rocrail supports the __U__hlenbrock __L__oco__N__et __I__nterface | + | * Programming of locomotive decoders is not conform to the freely available documentation //LocoNet Personal Edition// |
- | The device drivers shipped | + | * There is no publicly available documentation for the advanced programming protocol used by Uhlenbrock. |
+ | |||
+ | Since revision 2118 Rocrail supports the **U**hlenbrock **L**oco**N**et **I**nterface | ||
+ | |||
+ | :!: Install the interface driver first! :!: | ||
+ | * Under **Windows**, | ||
+ | * Under **MacOS** the driver from the manufacturer Silicon Labs must be downloaded | ||
+ | * Common **Linux** distributions already include | ||
+ | * For more information on the interface, see [[# | ||
+ | |||
+ | In order to display loco velocity changes by means of the IB throttles correctly in Rocview option **[[: | ||
\\ | \\ | ||
- | ==== Add the ULNI ==== | + | ===== Setting up Rocrail ===== |
- | From the menu **File -> Rocrail properties...** is selected and in the following dialogue tab **[[: | + | From the menu **File -> Rocrail properties...** is selected and in the following dialogue tab **[[: |
\\ | \\ | ||
- | + | ==== Interface ==== | |
- | ===== Interface | + | |
{{: | {{: | ||
On tab // | On tab // | ||
- | ====Device==== | + | === Device === |
Rocrail determine under Windows the available serial ports currently only to Com10.\\ | Rocrail determine under Windows the available serial ports currently only to Com10.\\ | ||
If the LocoNet Com port in the dropdown list " | If the LocoNet Com port in the dropdown list " | ||
\\ | \\ | ||
- | + | ==== Options ==== | |
- | ===== Options | + | |
{{: | {{: | ||
Set the CS Type: **intellibox** or **ibcom** for functions support > 8. \\ | Set the CS Type: **intellibox** or **ibcom** for functions support > 8. \\ | ||
Line 49: | Line 52: | ||
\\ | \\ | ||
- | + | ==== Details ==== | |
- | ===== Details | + | |
{{: | {{: | ||
- | ====Switch Time==== | + | |
+ | === Switch Time === | ||
The Switch Time should be set to the maximum switch time of the IB (see also the description of **Switch acknowledge** below).\\ | The Switch Time should be set to the maximum switch time of the IB (see also the description of **Switch acknowledge** below).\\ | ||
- | ====Slot Purge Time==== | + | === Slot Purge Time === |
Locomotives not in use will be purged from the refresh cycle after a time specified in the Intellibox (default two minutes). The value entered into the field **Slot Purge time** on tab //Details// should be equal or slightly lower than the purge time of the Intellibox, e.g. 110 seconds. \\ | Locomotives not in use will be purged from the refresh cycle after a time specified in the Intellibox (default two minutes). The value entered into the field **Slot Purge time** on tab //Details// should be equal or slightly lower than the purge time of the Intellibox, e.g. 110 seconds. \\ | ||
+ | > **Note:** If the **Slot Purge time** is set to zero, the IB is supposed not to purge! This will lead to unpredictable situations: Rocrail will not check with the IB if the known slot is purged.\\ | ||
+ | Very small purge time values will cause unnecessary traffic for checking the slots.\\ | ||
+ | Locos that were controlled by Rocrail and were afterwards parked remain active if the option **Slot Ping** is active. If such a loco is selected on the Intellibox a warning will be shown telling the loco is already under control.\\ | ||
- | ====Slot Ping==== | + | === Slot Ping === |
The option Slot Ping can be used to inhibit purging by pinging the slot right before it would be purged. | The option Slot Ping can be used to inhibit purging by pinging the slot right before it would be purged. | ||
- | ====Slot Purge time==== | + | === Wait for slot data === |
- | If the **Slot Purge time** is set to zero, the IB is supposed not to purge! This will lead to unpredictable situations: Rocrail will not check with the IB if the known slot is purged.\\ | + | This value can be increased |
- | Very small purge time values will cause unnecessary traffic for checking the slots.\\ | + | |
- | Locos that were controlled by Rocrail and were afterwards parked remain active if the option **Slot Ping** is active. If such a loco is selected on the Intellibox a warning will be shown telling the loco is already under control.\\ | + | |
- | + | ||
- | ====Wait for slot data==== | + | |
- | This number should | + | |
< | < | ||
Could not get slot for loco addr=xx | Could not get slot for loco addr=xx | ||
Line 73: | Line 74: | ||
Default Rocrail will read up to 16 packets until it give up waiting for a free slot.\\ | Default Rocrail will read up to 16 packets until it give up waiting for a free slot.\\ | ||
- | ====Echo timeout==== | + | === Echo timeout === |
- | The default | + | The default time is 100 x 10ms to wait for the echo of a command. \\ |
- | Under some conditions this could be too short, and can be increased to max. 1000 * 10ms.\\ | + | Under some conditions, this may be too short and can be gradually |
- | ====Check switch acknowledge==== | + | === Check switch acknowledge === |
The option "Check switch acknowledge" | The option "Check switch acknowledge" | ||
> **Note:** If **Check switch acknowledge** is enabled the **Switch Time** (see above) __has to be set to exactly the maximum switch time value of the IB__. \\ Moreover, minimum and maximum switch times of the IB should be set to identical values, e.g. 200 or 250 milliseconds both. \\ Genearally this option can and should be disabled. | > **Note:** If **Check switch acknowledge** is enabled the **Switch Time** (see above) __has to be set to exactly the maximum switch time value of the IB__. \\ Moreover, minimum and maximum switch times of the IB should be set to identical values, e.g. 200 or 250 milliseconds both. \\ Genearally this option can and should be disabled. | ||
- | ====Retries/ | + | === Retries/ |
Number of attempts to set the switch and receive an acknowledgement plus pause between retries.\\ | Number of attempts to set the switch and receive an acknowledgement plus pause between retries.\\ | ||
It is recommended to set the sleep time to higher values (250ms maximum).\\ | It is recommended to set the sleep time to higher values (250ms maximum).\\ | ||
- | ====Slotserver==== | + | === Slotserver === |
The __**Slot Server** must be disabled!__ This will conflict with the IB and could lead to a Rocrail server crash.\\ | The __**Slot Server** must be disabled!__ This will conflict with the IB and could lead to a Rocrail server crash.\\ | ||
- | ====Query address==== | + | === Query address === |
The standard query address for getting the current sensor state is 1017.\\ | The standard query address for getting the current sensor state is 1017.\\ | ||
For Uhlenbrock sensor modules this must be set to **1016**.\\ | For Uhlenbrock sensor modules this must be set to **1016**.\\ | ||
\\ | \\ | ||
- | |||
===== Addressing and Timing ===== | ===== Addressing and Timing ===== | ||
See __**[[: | See __**[[: | ||
Line 107: | Line 107: | ||
\\ | \\ | ||
- | |||
==== Debian Linux ==== | ==== Debian Linux ==== | ||
Under Debian, the interface is recognised as '' | Under Debian, the interface is recognised as '' | ||
Line 136: | Line 135: | ||
</ | </ | ||
Users who want to use the interface must be added to the '' | Users who want to use the interface must be added to the '' | ||
- | \\ | ||
- | ====Mac OS X==== | + | \\ |
+ | ==== Mac OS X ==== | ||
The Mac OS X needs to install an extra driver for this interface which can be downloaded from Silicon Labs: | The Mac OS X needs to install an extra driver for this interface which can be downloaded from Silicon Labs: | ||
https:// | https:// | ||
Line 154: | Line 153: | ||
**Basic Settings** -> **LocoNet Prog.** -> **Art.-Nr.: < | **Basic Settings** -> **LocoNet Prog.** -> **Art.-Nr.: < | ||
Values in angle brackets <> have to be entered as shown. | Values in angle brackets <> have to be entered as shown. | ||
+ | |||
+ | \\ | ||
+ | ===== Special Options ===== | ||
+ | === IB Basic SO14 === | ||
+ | Maximum Switch time; default setting is 5 secs. Using the ** OpenDCC signaldecoder ** and loconet, set the value to 0 to get a sufficient fast response of the signal patterns.\\ | ||
+ | |||
+ | \\ | ||
+ | ===== Reset the device ===== | ||
+ | |//This step is only needed if the device has been reprogrammed.// | ||
+ | With the LocoNet type **[[: | ||
+ | ^ LNCV 2 = 4 | 115200 Baudrate | | ||
+ | ^ LNCV 4 = 0 | LocoNet Direct Mode **OFF** | | ||
+ | {{: | ||
+ | |||
+ | \\ | ||
+ | :!: LocoNet direct mode __has to be switched off__! \\ | ||
+ | Since the software handshake itself requires part of the bandwidth available the highest possible baud rate (115200) should be used in order not to slow down communication speed. | ||
\\ | \\ | ||
Line 175: | Line 191: | ||
The **IB-Com** does NOT refresh the loco commands on the track in case of __mixed DCC and Motorola__ type of decoders.\\ | The **IB-Com** does NOT refresh the loco commands on the track in case of __mixed DCC and Motorola__ type of decoders.\\ | ||
This will result in a loco stop after a bad contact, depending of decoder manufacturer, | This will result in a loco stop after a bad contact, depending of decoder manufacturer, | ||
- | This problem cannot be solved without some advice from the manufacturer Uhlenbrock. Some undocumented LocoNet commands seems to solve this behaviour.\\ | + | This problem cannot be solved without some advice from the manufacturer Uhlenbrock. Some undocumented LocoNet commands seems to solve this behaviour. |
- | + | ||
- | \\ | + | |
- | + | ||
- | ===== Reset the device ===== | + | |
- | |//This step is only needed if the device has been reprogrammed.// | + | |
- | With the LocoNet type **[[: | + | |
- | ^ LNCV 2 = 4 | 115200 Baudrate | | + | |
- | ^ LNCV 4 = 0 | LocoNet Direct Mode **OFF** | | + | |
- | {{: | + | |
- | + | ||
- | \\ | + | |
- | :!: LocoNet direct mode __has to be switched off__! \\ | + | |
- | Since the software handshake itself requires part of the bandwidth available the highest possible baud rate (115200) should be used in order not to slow down communication speed. \\ | + | |
- | + | ||
- | \\ | + | |
- | + | ||
- | ==== Special Options ==== | + | |
- | === IB Basic SO14 === | + | |
- | Maximum Switch time; default setting is 5 secs. Using the ** OpenDCC signaldecoder ** and loconet, set the value to 0 to get a sufficient fast response of the signalpatterns.\\ | + | |
- | + | ||
- | + |
intellibox-basic-en.1618324495.txt.gz · Last modified: 2021/04/13 16:34 by besra