User Tools

Site Tools


cbus-en

CANBUS

ContentCommand StationsCANBUS


Setup

rcan-setup-en.jpg

CAN-ID

The CAN-ID used for the CAN Interface like CANGC1(e) and SocketCAN.

Sub-Library

The connected CAN nterface:

Type BPS Kit code Manufacturer Remark Extended Frames
TCP/IP 10/100 MBPS CAN-GC1e GCA Invalid
USB 500000 CANUSB MERG Preferred by MERG. The 12V version can be used in combination with the CAN-GCA line.
RTS/CTS should be disabled because its not supported by this module.
Invalid
Serial 230400 CAN-GC1 GCA Uses binary responses to improve through put. (Not MERG compatible.) Invalid
Serial 115200 CANRS MERG Deprecated; It is not fast enough to keep up with CBUS at full speed! Invalid
Serial 115200 Pi-Sprog Sprog
SocketCAN - Pi01CAN GCA SocketCAN compatible devices. Yes
LAWICEL / SLCAN 115200…500000 USBTin Thomas Fischl Tiny USB interface. Yes
TCP/IP WiFi WIO-CAN GCA Needs the binary option. Yes
USB 115200…500000 WIO-CAN GCA Yes

Note: Extended frame support is needed in case WIO-02 and/or WIO-Prog2 are on the same CAN bus.

Binary

Only in combination with Sub-Library TCP and WIO-CAN.

Device

The serial device used for the CAN interface.

Kit code Windows Linux Remark
CANUSB COM5…COMn /dev/ttyUSB0…/dev/ttyUSBn
CAN-GC1, CANRS COM1…COM4 /dev/ttyS0…/dev/ttySn An USB-RS232 converter can also be used. (Tested)

Host/Port

The hostname and port for the TCP/IP interface.
In case of SocketCAN the host name is the device name. Default can0

Protocol

:!: Set to CBUS only if a CANGC1, CANGC1e and/or CANGC3 is connected. :!:

Enable CAN protocols.
Default is RCAN and CBUS parallel.
RCAN uses extended CAN frames, and is used by WIO modules with CAN interface.
CBUS modules do not evaluate extended CAN frames, and WIO modules do not evaluate standard CAN frames.


RCAN

CS Node ID

Redirect all mobile commands with Node ID zero to the Command Station with this Node ID.
Mostly used in combination with WIO-Control and WIO-Prog.


CBUS

Short events

Use the short version of the accessory events; Event number only. (Recommended)
The long events are based on node number and event number.

Fastclock

Send fast clock packets on the CBUS.
It is recommended to set this enabled in case of using a TCP/IP connection to prevent idle timeout disconnection.

Command Ack

:!: Use only in case of data loss in combination with WiFi.

Activates the command acknowledgment handshake.
A next command can only be send if the interface did acknowledged the previous command.
This handshake prevents loss of commands due buffer overflow. (10/100MBit → 125kBit)
Other manufacturers, like Lenz, are also using such a handshake on there Ethernet interfaces.

Only the CAN-GC1e version 1.c is capable of handling this acknowledgment when this option is activated in the firmware.


Heartbeat

Sends every second an event# 4712 OPC_ACON/OPC_ACOF on the bus to be able to check for hardware/cable problems.
The LEDs on the modules should flash every second.
A CAN-GC2 can be programmed on this event# to be able to add a LED mounted on the dashboard.

  • Note: In order not to trigger unwanted SoD queries with the heartbeat, the selected address must be outside the address range defined by SoD.

SoD

"Start of Day" address offset for the query of all input states.
This must be programmed as event in all input nodes which should report.
Alternatively, all GC2 modules can be set to SoD address++. The second field is the number of modules, and the third the sleep time (ms) between SoD queries. This option avoids a CAN bus burst at SoD.

Slot purge time

CS timeout for updating DCC mobile decoders.
If a loco becomes idle before this time out a keep alive command is send to the CS.
:!: The hardware purgetime is 20 seconds, so this value should be set to less then 20 to assure the slot is not purged during automatic runs!

Decoder check

Check if all Decoders are online. (NET-ID=CAN-ID, Bus=Node Number)
The default interval is 10 seconds.
A power off will be issued if a decoder is not responding. (Lost node.)
Loco sessions will be invalidated if the GC3(CANCMD) was lost.

If a CAN-ID is found, which is not in the decoder list, it will be automatically added for checking. (It will be saved in the accessory decoder table, flagged as generated.)


FLAT Addressing

CBUS addressing is FLAT, only the bus and address values are used.

Rocrail CBUS Range Remark
- CAN ID 0…127 Unique number within a CAN segment to be used in the CAN transport layer.
This is the low part of the CAN Message Identifier without priority bits.
Bus Node number 0…65535 Used for long events and programming. This must be set unique for all modules.
Address Event number 0…65535
Gate Added to the address of output objects. 0,1 This is needed for signal pattern support.


cbus-en.txt · Last modified: 2024/03/10 09:21 by rjversluis