User Tools

Site Tools


bidib-en

This is an old revision of the document!


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

  • Current sense occupancy detection.
  • RailCom® detection; Rocrail Code.1)
  • 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.
  • External throttle support. (MultiMaus, LH90, LH100)
  • Booster diagnostics

ColorValueRange
CyanVoltage0…24V
RedTemperature0…100°C
WhiteCurrentAuto 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

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

  • Serial (USB)
  • TCP (Ethernet)
  • UDP (Ethernet)


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

Read the Configuration page for more information on node configuration.



Hardware

Documentation

Overview

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


RailCom® und RailComPlus® sind eingetragene Warenzeichen der Firma Lenz Elektronik GmbH in Hüttenbergstrasse 29, D-35398 Giessen
1)
Max. 4 in the same section.
bidib-en.1542009373.txt.gz · Last modified: 2018/11/12 08:56 by 127.0.0.1