This is an old revision of the document!
Table of Contents
BiDiB
General information
BiDiB is a protocol which supports P&P with a high reliability communication level.
For more information:
Rocrail is a BiDiB licensee.
Addressing
The addressing is linear: FADA
Only the Bus(ID) and the Address fields are used.
Addressing starts in Rocrail with one; Null is not used. Port zero on the LC is in Rocrail address one. |
Mapping
BiDiB Port | Rocrail Address | Rocrail Port |
---|---|---|
0 | 1 | 0 |
1 | 2 | 0 |
… | … | 0 |
127 | 128 | 0 |
if sensor and input types at the same board exist the sensor range is 1 .. 128 and the input types are at 201 .. 328.
Important Options
Railcom
Features
- Easy Configuration
- Current sense occupancy detection.
- RailCom® KM/H.
- Read/Write CV's on the main, POM, reported by RailCom® mobile decoders.
- CV Programming on the service track. (No hardware available yet.)
- Loco control; velocity, functions…
- BiDiB & DCC Accessory control.
- All port types and macros.
- DCC Watchdog support.
- External throttle support. (MultiMaus, LH90, LH100)
Color | Value | Range |
---|---|---|
Cyan | Voltage | 0…24V |
Red | Temperature | 0…100°C |
White | Current | Auto scaled; "mA max." is 100% |
Setup
Adding a bidib controller
General
Interface ID
IID for addressing this interface directly from without Rocrail.
Device
Windows
Device name of the RS232 port.
Typically COMx for Windows; Check the device manager.
Linux
The FDTI is supported out of the box: use /dev/ttyUSBx for Linux based systems.
See also USB Mapping.
Mac OS X
For Mac OS X the FDTI device driver must be installed: USB to Serial.
After install and connecting the GBMBoost Master a new serial device is found under "/dev/tty.*".
If the productID is not factory standard follow this setup: OpenDCC USB Setup
Links
- Reset Product ID to factory settings: http://wiki.fichtelbahn.de/doku.php?id=interface_treiber
Host
Host name or IP address.
Port
TCP or UDP port.
Baudrate
Communication speed in Bits Per Second.
The current version of the GBMBoost supports 115200 only.
CTS
Hardware handshake CTS/RTS.
Disable handshake only if the hardware does not support it.
Sub-Library
Options
Secure ACK
Activate
To activate the secure ACK option of the BiDiB protocol.
Interval
The secure ACK interval in 10ms units. 20 is the default. (200ms)
If Rocrail did not send an ACK with in this time frame the event will be resend by the sensor unit.
Echo commands
Echo switch commands.
This can be used to synchronise multiple switches in Rocrail on the same address.
Reset manually operated accessories
If a manually operated accessory is reported, as error, Rocrail will try to reset it back to its last known state.
Watchdog
The Watchdog Feature will be automatically checked at startup.
Nodes
This node overview list will be automatically generated during the connection setup between Rocrail and the BiDiB interface.
Configure
Hardware
Documentation
Module | Description | Remark |
---|---|---|
GBMboost | Command Station and Booster | |
GBM16T | RailCom detection | Current sense and RailCom |
LightControl | Light control | LEDs, I/O, Servos… |
MoBaLiSt | Die ModellBahnLichtSteuerung | |
BiDiBOne | Multipurpose I/O | |
s88-Bridge* | S88 Concentrator |
Cable
- CAT 5 Twisted pair cable. (AKA Ethernet patch cable)
Multi RailCom detection
To be able to detect multiple Railcom decoders in the same section the following option must be set:
IRM Location Reports
The reported Location ID must mach with a Sensor-ID in Rocrail.
This sensor should have its address set to zero.
The reporting address is used for the sensor Code.
IRM only reports arrival and not depart, so for automatically reset use the Sensor Timer.
Automatic mode
It is recommended not to add or remove BiDiB modules to/from the bus in automatic mode because this will cause a lot of communication traffic and leads to strong delayed events.
The track power will be shut off in case a module is reported as 'lost'.
Programming Track (PT)
Starting with firmware 2.1.4 the GBMBoost Master can be used as Programming Track.
Before programming on the PT the PT-Mode must be set, see the PT Button on the Programming Tab.
The GBM16T with Firmware 2.1.1 must be disconnected from the GBMBoost-Master or set into reset mode:
Compatibility
Virtual COM port (VCP) drivers
Links
Decoder Blacklist
Here are decoders listed which are not conform the RailCom specs.
Tams
- LDG30/32 SW Version 2.1 → http://forum.opendcc.de/viewtopic.php?f=27&t=547
RailCom® und RailComPlus® sind eingetragene Warenzeichen der Firma Lenz Elektronik GmbH in Hüttenbergstrasse 29, D-35398 Giessen |