DCC · Francesc Pinyol Margalef

Throttles (EX-CommandStation)
- Web browsers
  - EX-WebThrottle
- Android
- Apple iOS
- Dedicated Hardware
  - ...
  - Elgato StreamDeck (EX-CommandStation) (companion-module-dcc-ex-commandstation)
- Personal computers
DCC++ Controller

Z21 - Slave am XpressNet (pgahtow)
- Roco_Z21_Arduino
- Emular la Z21 con Arduino z21f (Uno, Eth W5100, S88N, XpressNet) (Norber)
  - EMULAR_LA_Z21.pdf
Z21 - LocoNet-Adapter (pgahtow)

Comandament / Throttle
- John Alexander Stewart
- XpressNet (pgahtow)
  - XpressNet Master
    - used by Central Station
  - XpressNet Client
    - used by Z21 - Slave
    - esp8266-xpressnet-lib
    - MDRRC/XpressNet
      (STM32 Maple Mini)
- xpressnet_arduino (Nicolas Zin)
- Elgato StreamDeck (EX-CommandStation) (companion-module-dcc-ex-commandstation)

EX-CommandStation
DCC++
- (Uno,Mega,Nano)+(Motor shield,LMD18200)
DCCpp
Central station (pgahtow)

Booster (pgahtow)
- Booster2(R)
  - 2x 2,2A
- Booster3
  - 5A
- Booster3R (AtTiny, Railcom)

Maquinari / Hardware
- DCC Dekoder (pgahtow)
- ArSigDec (Arcomora)

	Programari / Software
	NmraDcc (MRRwA)	DCC_Decoder (MynaBay)	other
Monitor / Sniffer	Arduino DCC Monitor	Building a DCC Monitor with an Arduino (breadboard) Un moniteur de signaux DCC (LCD)	ReadDCC Packets DCC Sniffer – Packet Analyser with Arduino

S88N (pgahtow)

Rückmeldung (pgahtow)

DCC++ (Youtube)

MERG

CBUS Hand Controller (CAB1)
Hand Controller - Mark 2 (kit 43) (5 wire)
Original Hand controller (DCC8HSCL)

Accessory Encoder (updated) (kit 51)
Accessory Encoder PC adapter board (Ace_PC1) (kit 54)
Accessory decoder (ACC6)
Accessory decoder (ACC2) (kit 52)
Accessory decoder for Tortoise etc (ACC3) (kit 53)
Programmer (kit 41)

Auto reverse and cutout module (ARC)

OpenDCC

OpenDCC - A Command Station for DCC

Throttle

A Command Station for DCC

OpenDecoder (maquinari / hardware)
- Hardware 1: Details for the schematics of OpenDecoder (V. 1) (Attiny2313)
- Hardware 2: Schematics and details for open decoder (var. 2) (ATmega8515)
- Hardware 3: Details zur Schaltung des OpenDecoders (Variante 3)

DCC-BiDi (RailCom ®) für Lokomotiven

GBM16: BiDi/Occupancy-Detector

Paco Cañada (digitrens)

GenLi (XpressNet-serial)
GenLI-S88 (XpressNet-serial)
GenLI-RS (GenLI+ RS2PC) (PpP) (dt) (XpressNet-USB)
GenLi Xpress (dt) (XpressNet-USB)
GenLi LMAB (dt) (LMAB-USB)
RS2PC (dt) (RS-serial)
GenHSI (S88-serial)

XbusTCO (accessory encoder)
SimpleMaus
MiniMaus
XWL

Booster
Booster R-CDE
Roco10761-CDE / Roco 10761 -> CDE: to connect a 10761 (master connector) to be used as a booster receiving dcc from a CDE output from a central station

Accessory decoders
Accessory decoder
Decoder for 4 turnouts and signals
2 turnout decoder
4 servo decoder
ServoPoint
Decoder for semaphore with slow on / off
UniSemaf (4 outputs, 8 aspects)
UniSemaf-648 (8 outputs, 32 aspects)
PAN_Sound
Peripherals DCC
MOT-VREG
Turntable decoder
PpP decoders
- PpP Sem2
- PpP Sem3
- PpP Sem4
- PpP Des3
- PpP LightFX
- PpP Mot4
- PpP MotK

RailCom
- RailCom display
- BoosterR-CDE
- DCC_Rail (transmitter)

Occupancy detectors

RS2PC (PpP)
RS2PC-USB (PpP)
GenLI-RS
RS8 (PpP)
RS8-DC (PpP)
RS-TCO (PpP)
RS-TCO-DCC (PpP)

DC4 (PpP)

Commercial

(altres/other)

iTrain

YaMoRC

YD7110 (integrated)
- YD7100 COMMAND
- YD7101 EXTENSION
YD7001-E (intermediate)
- YD9401

YD7403 POWER

YD8116 SWITCH (16-fold) (DCC, DCCExt - RCN-213)
YD8044 SOLENOID (4-fold)
YD8008 SOLENOID (8-fold)
YD7622 CROSSING
YD7652 TURN

RailCom SENSOR:

YD6016LN-RC SENSOR (LocoNet)

OPTO SENSOR:

YD6016LN-OPTO SENSOR (LocoNet)
YD6016ES-OPTO SENSOR (s88N)

ES-PGM-LINK, ES-OUT-LINK:

YD9101 CONFIG (WiFi, LAN, USB)
YD9100 (USB)

Current SENSOR:

Ground SENSOR:

YD6016LN-GND SENSOR (LocoNet)
YD6016ES-GND SENSOR (s88N)

Digikeijs

DR5000

Digikeijs DR5033 (CDE, LNet, B-BUS) (RailCom) (pdf) (89€) (inc. power supply DR60710)

Digikeijs DR4018 16-channel switch decoder (pdf: z21/en) (32,49€)(27,95€) (28€)

DR5088RC DIGIDETECT (LocoNet) (RailCom) (MS Windows)

DR4088RB-OPTO (59,95€)

R 61117 (H0)
R 42605 (sleeper) (H0)
F ... (N)
Zaratren
Aneste 3021 (6.5mm) (2,15€) (1,90€)
Onda Radio

DR4088RB-CS (R-BUS) (RailCom) (pdf) (pdf) (59.95€)

DR410 (pdf) (58€)
DR5033 (booster)

Fleischmann / Roco

Android:

Z21 (Z21 LAN)
z21 mobile (old)

(z21/Z21: ethernet)
Rocomotion 10785 (R-BUS) (pdf)
10786 Multi Central Pro DCC system with Rocomotion program (Rocomotion)

Lokmaus 2 (X-Bus)
Lokmaus 3 (X-Bus)
Roco multiMAUS (10810) / Fleischmann Multimaus (686810) (X-Bus) (99€)
Z21 WLANmaus (10813) (Z21 LAN) (99€)

680801
Roco/Fleischmann multiMAUS (as master)
z21 (white)
Z21 (black)

10761 (2.5A) (no shortcut protection)
10764 (3.2A, master, slave, booster out)
10765 (3.2A, booster in/out) / 10762
10779
670601 transformer (79€)
Z21 Light Booster (10805) (RailCom) (B-BUS) (3A) (auto inversion) (99€) (89,99€) (99,99€)
Z21 Single Booster (10806) (CAN, B-BUS, CDE) (3A) (154€)
Z21 Dual Booster (10807) (CAN, B-BUS, CDE) (2x3A)(234€)
Roco 10765 Digital booster (B-BUS) (replaced by Z21 Booster light)
10789 - Z21®-Booster Adapter (CDE boosters)

F 685303 (pdf) (37,90€)

Roco 10775 (turnouts, decouplers, semaphores) (pdf) (73€)
Roco 10777 (light signals) (pdf)
Z21 signal DECODER (10837)
power
- Fleischmann 670601
brake generator
- Roco 10779 (pdf)

Z21 Detector (RailCom) (10808) (R-BUS, CAN)

Roco 10787 (pdf)
Z21 Detector x16 (10819) (using resistor) (R-BUS)

Z21 Detector (RailCom) (10808) (R-BUS, CAN)
Z21 Detector x16 (10819) (R-BUS)

Roco 10767
Z21 Reverse loop module (10797)
Z21 booster

Lenz

Wireless Model Railroad Control
- WiThrottle
- TouchCab

LI100 (XpressNet-RS232)
LI100F (XpressNet-RS232)
LI101F
LI-USB (XpressNet-USB)
LI-USB-Ethernet (XpressNet-USB, Ethernet)

Lenz LRC100
Lenz LRC120 (screen: loco address)

LK200 (pdf) (51,80€)

Märklin / Minitrix

RemoteCS2

Mobile Station

Central Station 2

Oscilloscopio

Rocrail

Rocrail server + :

Rocview
Rocweb
andRoc

GCA-PI04 RocMouse (RPi)
GCA124

LNet
CAN-GCA
RocNet

ORA-1: accessory decoder
ORA-2: accessory decoder

RocRail feedback:

GCA93: current
GCA133: IR
GCA173 Hall-sensor

GCA102

02Bus#

dispositiu / device	cab bus	central	control bus	dispositiu / device
throttle ordinador / computer	CAN LocoNet XpressNet Z21 LAN Protocol DCC-EX Native Protocol WiThrottle	command station	DCC booster B-BUS CDE CBUS	descodificadors estàtics (accessoris) / static decoders (accessories) descodificadors mòbils (locomotores) / mobile decoders (locomotive)
	feedback bus
mòduls de retroalimentació / feedback modules	R-BUS RS S88

Control bus
- DCC
  - Booster
    - Use de central digital de ROCO como booster?
      - lokmaus2_booster10761.gif
    - Come ampliare il sistema digitale Roco
    - Buses
      - B-BUS (z21/Z21) / "Booster out" (Roco 10764)
        
        RJ-9 (4/4) pinout
        
        Cable
        
        DR60895 (RJ-9 4P4C 1m)
      - CDE
    - Adapters
      - Roco 10789
      - Paco Cañada: Roco10761-CDE
- CBUS (MERG)

Cab buses / Throttle network (allow loco controllers connect to command station)

CAN Bus (by Zimo)

LocoNet

Loconet (iGwiki)

LocoNet Personal Use Edition 1.0 Specification (pdf)

length	opcode	byte 1	byte 2	byte 3	byte 4	byte 5	byte 6
2 bytes	OPC_IDLE	0x85	CKSUM
	OPC_GPON	0x83	CKSUM
	OPC_GPOFF	0x82	CKSUM
	OPC_BUSY	0x81	CKSUM
4 bytes	OPC_LOCO_ADR	0xBF	0x00	ADR	CHK
	OPC_SW_ACK	0xBD	SW1	SW2	CHK
	OPC_SW_STATE	0xBC	SW1	SW2	CHK
	OPC_RQ_SL_DATA	0xBB	SLOT	0	CHK
	OPC_MOVE_SLOTS	0xBA	SRC	DEST	CHK
	OPC_LINK_SLOTS	0xB9	SL1	SL2	CHK
	OPC_UNLINK_SLOTS	0xB8	SL1	SL2	CHK
	OPC_CONSIST_FUNC	0xB6	SLOT	DIRF	CHK
	OPC_SLOT_STAT1	0XB5	SLOT	STAT1	CHK
	OPC_LONG_ACK	0xB4	LOPC	ACK1	CHK
	OPC_INPUT_REP	0xB2	IN1	IN2	CHK
	OPC_SW_REP	0xB1	SN1	SN2	CHK
	OPC_SW_REQ	0xB0	SW1: <0,A6,A5,A4 - A3,A2,A1,A0> (7 LS address bits)	SW2: <0,0,DIR,ON - A10,A9,A8,A7> (DIR=1 for closed/green, =0 for thrown/red ON=1 for output ON, =0 for output OFF)	CHK
6 bytes	(reserved)	OPC	ARG1	ARG2	ARG3	ARG4	CKSUM
variable bytes	...

XPressNet (X-BUS)

XpressNET - Industrial Grade Electronics for the Model Railroader (Lenz)
- XpressNet Specification (pdf)
Roco Z21 LAN protocol specification
XpressNet Protocol (DCC Wiki)
XpressNet (iGwiki)

Versions

	XpressNet	X-Bus
	v3	v2	v1
EIA RS-485	1 start element (0), 9 data bits, 1 stop bit (1), no parity bit
EIA RS-485	62.5 kb/s

Monitoratge
- Analitzador lògic / Logic analyser
  - XpressNet-Analyser extension for Logic

Pinout

pin	name	XpressNet		Roco
		Port A	Port B	XpressNet Master	XpressNet Slave / X-BUS / R-BUS	Booster out / B-BUS
				connected device: generates DCC; controls XpressNet	connected device: generates XpressNet	(gif)
		RJ12/RJ25 (6P6C)	RJ11 (6P4C)	RJ12/RJ25 (6P6C)	RJ11 (6P4C)	RJ9 (4P4C)
1	C	Control Bus Connection (booster)	-	half-wave DCC (booster)	-	1 half-wave DCC
2	M	GND				2, 3 GND
3	B	- RS-485 (inverted)				-
4	A	+ RS-485 (not inverted)				-
5	L	+12V DC				-
6	D	Control Bus Connection (booster)	-	overload detection (booster)	-	4

Cable
- DR60890 (RJ-12 6P6C, 3m) (L.NET, R-BUS, X-BUS)
Hardware Support: XpressNet (JMRI)
XnTcp (TCP/IP interface for XpressNet)

Bus de retorn / Feedback bus
- Bidireccional / Bidirectional
  - DCC ACK
  - RailCom
  - BiDiB
    - BiDiB (iguadix)
- Detecció / Detection
  - Easy Block Detection and 2-Color Signals | Part 1: Detection Systems and Circuits
  - Train detection (dynamic) (DCC wiki)
  - Block detection (Occupancy detection) (static) (DCC wiki)
  - DCC Impulses: Where is my train?
  - Sensors
    - Reed switch
    - Hall effect
    - Fotodetectors / Photodetectors
    - Current detection
  - Bus
    - R-BUS (XpressNet)
      - R-BUS (iGwiki)
      - Protokoll – Beschreibung Interface 10785 (pdf)
      - Roco Z21 LAN protocol specification: section 7
      - Cable (RJ12 6P6C, el mateix que / same as XpressNet/X-BUS)
    - RS
      - Bus RS (IGwiki)
    - S88
      - S88 (IGwiki)
      - s88-N
      - ES-Link (Extended S88) (YaMoRC)
        
        What is ES-Link
        
        Product Tag: ES-Link YaMoRC products with ES-Link capabilities
      - Cable S88N
        
        DR60881 (RJ-45 STP 8P8C, 1m, blue)
        
        DR60882 (RJ-45 STP 8P8C, 2m, blue)

03Info DCC#

Digital Command Control (wp)

Modes

mode	z21 LED	Normes NMRA	Operations	Programming
mode	z21 LED	Normes NMRA	Operations	Decoder programming (on z21)	programming mode	escriptura CV	lectura CV
Mode d'operacions / Operations mode	blau	NMRA S 9.2.1	control de locomotores (descodificador mòbil) velocitat funcions (F0...F...): llums, sons, ... control d'accessoris (descodificador fix) control de desviaments control de senyalització ...	Operations mode programming / Program on main - POM hi pot haver diversos descodificadors connectats, perquè s'envia a una adreça en concret pot llegir valors de CV només si Railcom està activat Exemples: z21 POM		a una adreça en concret	Railcom
Mode de servei / Service mode	verd	NMRA S 9.2.3	-	Service mode / Broadcast programming / Programming track - PT només hi pot haver un descodificador connectat (per això habitualment es fa servir un tram de via aïllat), perquè s'envia per broadcast (a cap adreça en concret) pot llegir valors de CV, fent servir petits consums elèctrics (DCC ACK) alguns descodificadors estàtics, per exemple DR4018, necessiten a més una resistència i el led PROGRAM encès es fa servir per a programar l'adreça de la locomotora	direct byte direct bit paged register	broadcast	cal consum DCC ACK resistència

Estructura / Structure

NEM 671, NMRA
Monitoratge
- Oscil·loscopi / Oscilloscope
  - trigger:
    - Siglent SDS
      - Type: Edge
      - Holdoff Time: 6.6m
- Analitzador lògic / Logic analyser
  - DCC plugin for Sigrok
Bits
- 0: 100μs * 2
- 1: 58μs * 2

Formats de paquets

NMRA S 9.2.1: Operations mode

12-bit

byte

[byte]

byte

programari / software

preamble

address
(pDccMsg->Data[0])

CCC

DDDDD

[DDDDDDDD]

error correction

NmraDcc

111111111111

00000000 (0)	broadcast	00000000
00000001-01111111 (1-127)	multi-function (7-bit)	0AAAAAAA
11000000-11100111 (192-231)	multi-function (14-bit)	11AAAAAA	AAAAAAAA

000

Decoder and Consist Control Instruction

0

Decoder Control ...

EEEEEEEE

execDccProcessor(): pDccMsg->Data[0] < 128

processMultiFunctionMessage()

1

Consist Control ...

001

Advanced Operation Instructions

CCCCC

DDDDDDDD

notifyDccSpeed()

010

Speed and Direction Instruction for reverse operation

CSSSS

notifyDccSpeed()

011

Speed and Direction Instruction for forward operation

CSSSS

notifyDccSpeed()

100

Function Group One Instruction

DDDDD

FL,F1,F2,F3,F4

notifyDccFunc()

101

Function Group Two Instruction

SDDDD

S=1:F5-F8; S=0:F9-F12

notifyDccFunc()

110

Feature Expansion Instruction

00000

Binary State Control Instruction long form

DLLLLLLL

HHHHHHHH

11101

Binary State Control Instruction short form

DLLLLLLL

11110

F13-F20 Function Control

DDDDDDDD

notifyDccFunc()

11111

F21-F28 Function Control

DDDDDDDD

notifyDccFunc()

111

Configuration Variable Access Instruction (POM: Ops Byte)

1CCCC

Short Form

DDDDDDDD

processMultiFunctionMessage()

processDirectOpsOperation()

notifyCV...()

0CCVV

Long Form

VVVVVVVV

DDDDDDDD

notifyCV...()

10000000-10111111 (128-191)

basic accessory decoder packet format (2 bytes)
(9-bit decoder or board address; CV29/541 b6 is 0)

10AAAAAA

1aaa

CTTP

C: activate/deactivate output power (duration is set by CV515-518)
TTP=000: first pair/turnout thrown/turn;
TTP=001: first pair/turnout closed/straight

pDccMsg->Data[0] < 192

notifyDccAccTurnoutBoard()
notifyDccAccTurnoutOutput()

10AAAAAA

1aaa

CTTP

operations mode programming (POM: Ops Accessory Byte)

1110CCVV

VVVVVVVV

DDDDDDDD

notifyCV...()

broadcast command for basic accessory decoders (2 bytes)
(9-bit decoder or board address; CV29/541 b6 is 0)

10111111

1000

CTTP

C: activate/deactivate output power

extended accessory decoder control packet format (3 bytes) (11-bit accessory or output address; CV29/541 b6 is 1)

10AAAAAA

0aaa0AA1

000 (NMRA)
ddd (RCN-213)

aspect control

DDDDD

XXXXX = 00000: absolute stop aspect;
XXXXX: other aspects
NMRA S-9.2.1: 5 bits
RCN-213: 8 bits

// This function is called whenever a DCC Signal Aspect Packet is received
notifyDccSigOutputState()

10AAAAAA

0aaa0AA1

111

operations mode programming (POM: Ops Accessory Extended Byte)

0CCVV

VVVVVVVV

DDDDDDDD

notifyCV...()

broadcast command for extended accessory decoders (3 bytes)
(11-bit accessory or output address; CV29/541 b6 is 1)

10111111

00000111

000

XXXXX

11101000-11111110 (232-254)

future use

11111111 (255)

idle

11111111

notifyDccIdle()

Llegenda / Legend:

A: LSB of address
a: MSB of address (1-complement)
C: activate
T: turnout/pair
P: position/direction

...

12-bit		first byte	second byte	third byte	last byte
preamble	...				error correction

111111111111	basic accessory decoder (9-bit decoder address)	10AA-AAAA	1aaa-CTTP	-
	...
	extended accessory decoder (11-bit output address)	10AA-AAAA	0aaa-0AA1	000D-DDDD (NMRA: 32 aspects) dddD-DDDD (RCN-213: 256 aspects)

basic accessory decoders (S-9.2.1 2.4.1) (9-bit: AAAAAA AAA; CV29/541 b6 is 0) (DCC, decoder accessori per led) (DR4018 example):

		byte								byte
DCC		1	0	A	A	A	A	A	A	1	A	A	A	C	D	D	D
DCC++ / DCCpp / EX-CommandStation (DCC++ EX)	`<a ADDRESS_0_511 SUBADDRESS_0_3 ACTIVATE>`			ADDRESS (9-bit)							ADDRESS (9-bit)			1	SUBADDRESS (2-bit)		ACTIVATE (0: thrown; 1: closed)
EX-CommandStation (DCC++ EX)	`<a LINEAR_ADDRESS_1_2044 ACTIVATE>`			LINEAR_ADDRESS (11-bit)							LINEAR_ADDRESS (11-bit)			1	LINEAR_ADDRESS (11-bit)		ACTIVATE (0: straight,closed; 1: turn,thrown?)
NmraDcc	when Init is called without FLAGS_OUTPUT_ADDRESS_MODE: notifyDccAccTurnoutBoard(BoardAddr, OutputPair, Direction, OutputPower)			BoardAddr (9-bit) (CV1/CV9, CV513/521)							BoardAddr (9-bit)			OutputPower (0: off; 1: on)	OutputPair (2-bit)		Direction (0: thrown; 1: closed)
	when Init is called with FLAGS_OUTPUT_ADDRESS_MODE: notifyDccAccTurnoutOutput(Addr, Direction, OutputPower)			Addr (11-bit)							Addr (11-bit)			OutputPower (0: off; 1: on)	Addr (11-bit)		Direction (0: thrown; 1: closed)
	Decoder_Basic_Monitor_V1 notifyDccAccState(Addr, BoardAddr, OutputAddr, State)			BoardAddr							BoardAddr			State (0b1/0b0)	OutputAddr
	Decoder_Basic_Monitor_V1														Output=OutputAddr>>1		Status (Thrown/Closed)=OutputAddr & 0b1

extended accessory decoders (S-9.2.1 2.4.2 )

JMRI			sigrok-DCC-Protocoll	NmraDCC
DCC Accessory Address	Offset Address	selected aspect		notifyDccSigOutputState
1	disabled	1	-3 (decoder:0, port:0) Aspect:0x1/1	65533, 1
1	enabled	1	1 (decoder:1, port:0) Aspect:0x1/1	1,1
5	disabled	1	1 (decoder:1, port:0) Aspect:0x1/1	1, 1
5	enabled	1	5 (decoder:2, port:0) Aspect:0x1/1	5, 1

Format de paquets extended accessory decoder
- Anàlisi
  - sigrok-DCC-Protocoll
    - pd.py
Comandament / Throttle
- Maquinari
  - WLAN Maus
    - no el suporta
- Programari
  - z21 App
    - Control Station
      - DCCext signal
        
        4 aspects:
        
        free driving (default: 16)
        
        driving with the speed limit 60 km/h (default: 6)
        
        driving with the speed limit 40 km/h (default: 4)
        
        absolute hold (0)
  - JMRI
    - Programació CV / CV programming
    - Tools -> Tables -> Signals -> Signal Masts
      - Mast Driver: DCC Signal Mast Decoder
      - Offset Address must be enabled
      - Send Count multiplied by 4 is the number of generated dcc packets
Estació de control / Command station
- DCC++ / DCCpp / DCC++ EX
  - supported from JMRI (DCC Signal Mast Decoder):
    - e.g.: Write DCC Packet Main Cmd: Register: 0, Packet: 81 71 07
- z21
  - Z21 Maintenance Tool User Manual
  - Signal types according to countries with Z21 signal DECODER
  - from Z21 FW V1.40 Z21 LAN Protocol (5.4, 5.5, 5.6):
    - LAN_X_SET_EXT_ACCESSORY
    - LAN_X_GET_EXT_ACCESSORY_INFO
    - LAN_X_EXT_ACCESSORY_INFO
Decoder
- AP_DCC_Library
- NmraDcc
  - notifyDccSigOutputState

...

	DCC packet					Digikeijs DR4018 16-channel switch decoder (2 boards)		Fleischmann turnout	DCC++	EX-CommandStation (DCC++ EX)	PulseView+DCC	Decoder_Basic_Monitor_v1 (uses obsolete NmraDCC notifyDccAccState)
	decoder-based addressing (CV29/541 b6=0)		output-based addressing (CV29/541 b6=1)
	decoder / board address (9-bit)	pair / port (2-bit)	accessory address (11-bit)	1: closed/straight 0: thrown/turn	activate	label	connector
Z21 app			Address	State
DCC++, DCC++ EX	ADDRESS	SUBADDRESS	LINEAR_ADDRESS
Decoder_Basic_Monitor_V1	BoardAddr	Output	Raw addr	Status
NmraDCC	BoardAddr	OutputPair	Addr	Direction	OutputPower
AP_DCC_Library	decoderAddress (0..511)	turnout (1..4)	outputAddress (1..2048)	position	activate
	board 1	0	1	1		OUT1	1	verd / green		<a 1 0 1> <a 1 1>	1 (decoder:1, port:0) 1:on
		0	1	0		OUT1	2	vermell / red		<a 1 0 0> <a 1 0>	1 (decoder:1, port:0) 0:on
		1	2	1		OUT2	3			<a 1 1 1> <a 2 1>	2 (decoder:1, port:1) 1:on
		1	2	0		OUT2	4			<a 1 1 0> <a 2 0>	2 (decoder:1, port:1) 0:on
		2	3	1		OUT3	5			<a 1 2 1> <a 3 1>	3 (decoder:1, port:2) 1:on
		2	3	0		OUT3	6			<a 1 2 0> <a 3 0>	3 (decoder:1, port:2) 0:on
		3	4	1		OUT4	7			<a 1 3 1> <a 4 1>	4 (decoder:1, port:3) 1:on
		3	4	0		OUT4	8			<a 1 3 0> <a 4 0>	4 (decoder:1, port:3) 0:on	AccState - Raw addr: 4 BoardAddr: 1 OutputAddr: 6 Output: 3 State: 0b1 Status: Thrown
	board 2	0	5	1		OUT5	9			<a 2 0 1> <a 5 1>	5 (decoder:2, port:0) 1:on
		0	5	0		OUT5	10			<a 2 0 0> <a 5 0>	5 (decoder:2, port:0) 0:on
		1	6	1		OUT6	11			<a 2 1 1> <a 6 1>	6 (decoder:2, port:1) 1:on
		1	6	0		OUT6	12			<a 2 1 0> <a 6 0>	6 (decoder:2, port:1) 0:on
		2	7	1		OUT7	13			<a 2 2 1> <a 7 1>	7 (decoder:2, port:2) 1:on
		2	7	0		OUT7	14			<a 2 2 0> <a 7 0>	7 (decoder:2, port:2) 0:on
		3	8	1		OUT8	15			<a 2 3 1> <a 8 1>	8 (decoder:2, port:3) 1:on	AccState - Raw addr: 8 BoardAddr: 2 OutputAddr: 7 Output: 3 State: 0b1 Status: Closed
		3	8	0		OUT8	16			<a 2 3 0> <a 8 0>	8 (decoder:2, port:3) 0:on	AccState - Raw addr: 8 BoardAddr: 2 OutputAddr: 6 Output: 3 State: 0b1 Status: Thrown

Notes:

cada board/decoder conté 4 outputAddress
des d'un WLANMaus o la Z21App, les adreces que hi apareixen fan referència a les outputAddress (p.ex.: #3, #4, #1025, #1026)
en un dispositiu comercial com el Dijikejs DR4018 hi ha 2 boards/decoders, que donen servei a 8 desviaments (8 outputAddress) (p.ex. Address / outputAddress: #1, #2, #3, #4, #5, #6, #7, #8)
en un dispositiu d'extended accessory (p.ex. un Arduino Nano Every amb AP_DCC_Library) hi pot haver, per exemple:
- 1 board/decoder amb decoderAddress 256 (setMyAddress(256)) que dóna servei a 4 senyals (outputAddress: #1025, #1026, #1027, #1028)
- si cada senyal conté 4 leds, caldran un total de 16 connexions elèctriques des de l'Arduino
- cada senyal pot mostrar 32 aspectes (0..31) (NMRA) o 256 aspectes (0..255) (RCN-213)

NMRA S 9.2.3: Service Mode (PT)

mode

long preamble (20-bits)

byte

programari

NmraDcc

Direct configuration
(4 bytes)

11111111111111111111

0111

CC

AAAAAAAAAA

EEEEEEEE

processServiceModeOperation()

01: Verify byte

DDDDDDDD

11: Write byte

10: Bit manipulation

111

K

D: value of bit to be verified

BBB: bit position within the CV

0: bit verify

1: write bit

processDirectOpsOperation()

Address-only

C

0000

DDDDDDD

0: Verify register/CV contents
1: Write register/CV contents

Physical register

C

RRR

DDDDDDDD

0: Verify register/CV contents
1: Write register/CV contents

value	register	CVs for accessory decoders	CVs for mobile decoders
000	1	Lower address (CV1/513)	Address (CV1)
001	2	Undefined	Start voltage (CV2)
010	3	Undefined	Acceleration (CV3)
011	4	Undefined	Deceleration (CV4)
100	5	Undefined	Basic configuration register (CV29)
101	6	Undefined	(reserved for page register)
110	7	Version number (CV7)	Version number (CV7)
111	8	Manufacturer ID (CV520)	Manufacturer ID (CV8)

Paged Addressing

C

RRR

DDDDDDDD

0: Verify register/CV contents
1: Write register/CV contents

value	register
000	1	Data register 0
001	2	Data register 1
010	3	Data register 2
011	4	Data register 3
100	5	Basic configuration register
101	6	Paging register

PC interface
- Z21 LAN
- Lenz
  - Downloads, manuals, PDF-infos...
    - xpressnet_li101f.pdf (de)
  - Manuals (Lenz USA)
    - LI101F Hi-Speed XpressNet Computer Interface (pdf) (en)
  - Lenz (Rocrail)
Modes

Decoder Acknowledgement (DCC wiki)

DCC ACK (on PT)
- Programming track: at least 60mA for 6ms
- Using motor or other load
- Basic (DCC wiki)
- NMRA S-9.2.3 D: Decoder Acknowledgment Mechanism
- Implementació / Implementation
  - Central station
    - DCC++
  - Decoder
    - Maquinari descodificadors / Decoder hardware
      - SMA 13: What about the confirmation for command station
      - NmraDcc.h: notifyCVAck
        
        void notifyCVAck(void) { Serial.println("notifyCVAck") ; digitalWrite( ACK_PIN, HIGH ); delay( 6 ); # 6ms digitalWrite( ACK_PIN, LOW ); }

RailCom (Lenz) (on POM)

comunicació bidireccional (informació des del descodificador, quan s'està en mode POM) / bi-directional data communication (feedback from decoder, when in POM mode)
- Nota: quan es vol llegir informació en mode PT, només cal fer servir DCC ACK
Info
- Advanced (DCC wiki)
- DCCWiki
- RAILCOM, ¿qué es exactamente? ¿Me es útil?…….10 cosas a tener en cuenta !!
- Railcom (IGwiki)
- pgahtow
- NMRA
  - RP 9.3.1
  - RP 9.3.2

dades des del codificador / data from decoder:

channel	information	CV28
1 (broadcast)	address	bit 0
2 (data)	speed	bit 1
	motor load
	CV read (when using POM)

Cal que estigui activat a tots dos components: / Must be activated at both components:
- Control station
  - Settings
- Decoder
  - Digikeijs DR4018 (estàtic) no té RailCom (no es poden llegir valors CV amb POM); per a llegir els valors CV cal fer servir PT (amb resistència)
  - Les locomotores haurien de ser compatibles amb RailCom si s'activa el bit 3 del CV29, i el dos bits de CV28. Provat amb:
    - Zimo (Le lait: CV8=145, CV7=32): funiona bé (es poden llegir els valors amb POM) (i també amb PT, és clar)
    - Fleischmann (Railion, DCC-Decoder 685303: CV8=155, CV7=101): no funciona (cal fer servir PT per a llegir els valors CV)
  - CV
    - CV28 to config RailCom
      - bit 0: enable channel 1 (address broadcast)
      - bit 1: enable channel 2 (data: CV values, speed...)
      - bit 2: channel 1 is used for command aknowledge
    - CV29 bit 3 to enable RailCom
Programari
- JMRI
  - DecoderPro
    - Control station
      - Z21 -> Z21 Configurarion Tool -> RaiCom Messages
    - Decoder
      - <decoder amb capacitats RailCom> -> Program -> pestanya RailCom
      - <decoder Fl decoders RailCom> -> Program -> pestanya Fleischmann
Codificadors RailCom / RailCom encoders
- Maquinari descodificadors / Decoder hardware
Descodificadors RailCom / RailCom decoders
- DCC resum
Dispositius que n'han de permetre el pas / Devices that must bypass it
- Control station
  - Roco Z21/z21
- Feedback
  - Digikeijs DR5088RC DIGIDETECT (LocoNet) (MS Windows)
- Booster
  - DR5033
    - Roco's Z21 does generate RailCom on it's Main Track, but unfortunately not on it's booster-bus (B-BUS). With the DR5033's RailSniffer input RailCom can be boosted !!
    - DR5033 RailCom on Z21 (YouTube)

Bucles / Loops
- Experimenting with reverse loops
- Can someone help me wire my layout?
DCCWiki
- Block (Power district)
Locoduino
- L'Arduino et le système de commande numérique DCC
Paco's Official Web Site
- CV: calculators (CV17,18, CV29, CV513,521)
  - Accesorios: 513-521
- PpPDecoders.zip (for Rocrail-Pro)

04Maquinari obert / Open hardware#

Descodificadors / Decoders

			Microcontroller	DIY			power supply						DCC signal			Acknowledgement generation		output circuit		#outputs	library		...	program
					schematics	pcb	input V	rectifier	input cap	voltage regulator (78L05=100mA, 78M05=500mA, 7805=1A)	output cap	Arduino PIN	input	opto-coupler	output	DCC ACK	RailCom	circuit	voltage		NmraDCC (MRRwa)	AP_DCC_Library	DCC_Decoder (MynaBay)
Arduino	Iowa Scaled	DCC Power adapter (DCC -> DC) (assembled)		ckt-dccpwr			(DCC)	x	-	-?	x
	Iowa Scaled	DCC Decoder Shield for Arduino	Arduino Uno, Mega	ard-dccshield	ard-dccshield.pdf	ard-dccshield.pcb		MB110S	10μF, 10μF	7805	-		1KΩ, 330pF, LED	6N137	(6): 10KΩ, 1μF	78L05, 75Ω, LTV-352T, 300Ω		-		8	x
	Geoff Bunza (DCC projects using the Arduino) (SMA)	SMA10 - Build a 17-Function DCC Decoder for about $5 DCC Code Receiver Using an Arduino Mini	Arduino Pro Mini	x	17_Function_Decoder-a-small.jpg		(DCC)	DF05		from track (LM78L05)		5V DC -> VCC		6N137				-	arduino digital out	17	x			DecoderNmraDcc_4.ino NmraDCC SMA examples
		SMA12 - 17 Channel Configurable Multifunction $5 DCC Decoder For Servos	Arduino Pro Mini	x	Blog12 17 Ftn DecoderSmall.jpg		5V DC			-		input -> VCC		6N137				-	same as input: 5V DC	17	x			NmraDCC SMA examples
		SMA 13 - Update to the 17 Pin Configurable Multi Function Decoder / Accessory Decoder Version Added																			x			NmraDCC SMA examples 7 servos, 10 LED
		SMA15: New Dual Acessory-Multifunctionl 17 Channel Configurable DCC Decoders for about $5 with Configurable Servo Support																			x			NmraDCC SMA examples 6 mobile / function decoder 6 accessory decoder
		SMA20 Low Cost 17 Channel DCC Decoders Ver 6.01 with Sound,Triggered Sound,Stepper,Dual Motor,LED and Servo Control	Arduino Pro Mini	DCC_Decoder3 (oshpark)	DCC_Decoder3 schematic.jpg	decoderpcbs.zip (.brd)	(DCC)	DF05	100nF	7805L	22μF, 100nF	5V DC -> VCC	1.3KΩ, 270pF, 1N4148	6N137	(6): 5KΩ, (7): 10KΩ	-		H-bridge: SN754410	rectified DCC		x			NmraDCC SMA examples
			Arduino Pro Mini	DCC_Decoder3P	DCC_Decoder3P schematic.jpg	decoderpcbs.zip (.brd)	(DCC)	DF05	100nF	7805TV	22μF, 100nF	5V DC -> VCC	1.3KΩ, 270pF, 1N4148	6N137	(6): 5KΩ, (7): 10KΩ	-		H-bridge: SN754410	rectified DCC		x			NmraDCC SMA examples
	Nick's Landing	Arduino DCC Monitor (DCC interface, circuits: OpenDCC, SMA10, SMA12)								SMA10, SMA12				SMA10, SMA12							x			Decoder_Basic_Monitor_v1.ino
	Nick's Landing	MRRwA NmraDCC Library												x				ULN2803			x
	DCC Interface How-To	Arduino Model Railway DCC Interface (assembled)		-						-				x		-		-		-
		Model Railway DCC Turntable Accessory Decoder for Arduino Nano - Assembled DCC Controlled Turntable Stepper Motor Driver	Arduino Nano	-			12V DC, 12V AC			7805				6N137				A4988			x			DCC Stepper Controller – A4988 Nano – Example Sketch
		Model Railway DCC Turntable Accessory Decoder for Arduino Uno (R3) – Assembled	Arduino Uno				12V DC			7805				6N138				A4988
	MynaBay	Building a DCC Monitor with an Arduino	Arduino				(USB)						1KΩ, 1N4148	breadboard (Dave Falkenburg) 6N137	(6): 10KΩ, (7): 10KΩ			-	-				x	Examples: DCC Decoder/DCC_Monitor
	Locoduino	Un moniteur de signaux DCC (LCD)	Arduino Nano										1KΩ, 1N4148	(Dave Falkenburg) 6N137	(6): 10KΩ, (7): 10KΩ								x	Examples: DCC Decoder/DCC_Monitor
	arduinodcc	Un décodeur d'accessoire DCC versatile basé sur Arduino (Nicolas Zin) (Locoduino)	Arduino Nano	arduinodcc			16V AC			7812TV		12V DC -> VIN	1KΩ, 1N4148	6N137	(6): 10KΩ, (7): 10KΩ			leds: R400 relay: COM-00100	leds: arduino digital out relay: (secondary)	3 + 1 relay			x	dccduino.ino
	ASALAF	Decoder DCC 8 señales (Descodificador DCC para 8 señales con Arduino) (selector ánodo/cátodo común)	Arduino Nano, Pro Mini	x			5V DC					5V		6N137						16
	Arcomora	ArSigDec	Arduino Uno, Mega										1.5KΩ, 1N4148	6N137	(6): 10KΩ, (7): 10KΩ, 100nF
	EasyEDA	Simple Arduino DCC Decoder			x	x										rect: 4x1N4148 trans: BC560 opto: PC817 res: 100, 1k
Altres / Other	MERG	ACC6	16F628A	ACC6	ACC6_sch.pdf	ACC6_pcb.pdf	15V AC	BR1	2200μF, 470μF	LM317 (var) + 7805	10μF, 10μF		1.5KΩ	6N137	(6): 1KΩ	rect: 4 x 1N4148 2N4401, TLP521, res: 100Ω 470Ω		SN754410			-		-
		ACC2	16F627	ACC2	acc2bsch.pdf	acc2bpcb.pdf	15-20V AC	BR1	1μF, 100μF	7812 + 78L05	100μF, 10μF		1.5KΩ	6N137	(6): 1KΩ	4 x 1N4148, 100Ω, ZTX450/2N4401, TLP521, 470Ω		-
		ACC3	16F628	ACC3	acc3sch.pdf	acc3pcb.pdf	15-20V AC	BR1	1000μF, 100μF	7812 + 7805	10μF, 10μF		1.5KΩ	6N137	(6): 1KΩ	4 x 1N4148, 100Ω, ZTX450, TLP521, 470Ω		ULN2803
	OpenDCC Open decoder	Hardware 1	Attiny2313	Details for the schematics of OpenDecoder (V. 1)			12-18V AC	B1	470μF, 100nF	IC4: 7805	100μF, 100nF	5V DC -> VCC	1.5KΩ, 1N4148	6N136	(6): 10KΩ, (7): 10KΩ	-		ULN2803	rectified input
		Hardware 2 (Wolfgang Kufer) (mrrwa)	ATMega8515A	Schematics and details for open decoder (var. 2) (jpg)			12-18V AC	x	470μF, 100nF	7805 / 7805L	100μF, 100nF	5V DC -> VCC	1.5KΩ, 1N4148	6N136 / 6N137 / 4N25	(6): 10KΩ	4x BAV199, 100Ω, BC860, PC817 / CNY17F, 1KΩ		ULN2803	rectified input
		Hardware 3	ATmega162	Details zur Schaltung des OpenDecoders (Variante 3)			AC	B80C800		7805 / Max1837		5V DC -> VCC	1.5KΩ, 4x BAV199	6N136 / 6N137 / 4N25	(6): 10KΩ, (7): 10KΩ (only 6N136)	4x BAV199, 100Ω, BC860, PC817, 1KΩ	x		rectified input
	Paco Cañada		PIC16F...	x			14V AC, 16V AC	B40C1500	47μF, 100nF	78L05	47μF, 100nF		1.5KΩ, 1N4148	6N137	(6): 1KΩ	-		ULN2803	rectified input (common anode)	8
	Digikeijs DR4018		PIC16F690	-				2 DF04S		78M05				6N137				F7103		16

Circuits

source

schema

values

power supply

	B1 (rectifier)	U1 (voltage reg.)	C1	C2	C3	C4
FPM	B250R, 2W08G, B40C1500	78L05		47uF
SMA20 Decoder3	DF05	7805L	100nF	-	22uF	100nF
SMA20 Decoder3P	DF05	7805TV	100nF		22uF	100nF
OpenDCC decoder	?	7805, 7805L	100nF	470uF	100uF	100nF
ard-dccshield	MB110S	7805	10uF // 10uF	-	-	-
Paco Cañada	B40C1500	78L05	100nF	47uF	47uF	100nF
DR4018	DF04S	78M05

dcc signal

	U1 (optocoupler)	C1 (2-3)	D1 (2-3)	R1 (2)	R2 (7)	R3 (6)
FPM	6N137		led	1kΩ	10kΩ	10kΩ
Dave Falkenburg	6N137	-	1N4148	1kΩ	10kΩ	10kΩ
SMA10/12	6N137	270pF	1N4152	1kΩ	10kΩ	5kΩ
OpenDCC decoder	6N136, 6N137, 4N25	-	1N4148	1k5Ω	10kΩ	10kΩ
ard-dccshield	6N137	330pF	amber led	1kΩ	0	10kΩ
ASALAF	6N137	-	led	10kΩ	10kΩ	10kΩ
DCCInspector EX	6N137	1nF	1N4148	1kΩ	-	5V: 470Ω; 3,3V (ESP32): 330Ω
Paco Cañada	6N137	-	1N4148	1k5Ω	-	1kΩ
DR4018	6N137

ack generation

ard-dccshield

	B1 (rectifier)	U1 (voltage reg.)	R1	T1	U2 (optocoupler)	R2
FPM				BC560	817, PC817
OpenDCC decoder	?	-	100Ω	BC860	PC817	1kΩ
ard-dccshield	MB110S	78L05	75Ω 1/2W	-	LTV-352T	330Ω

OpenDCC

output

	U1	...
FPM		ànode/positiu comú (semàfors)
SMA20	SN754410 (H-bridge for motor)
OpenDCC decoder	ULN2803
Paco Cañada	ULN2803
DR4018	F7103 (mosfet)

Arduino based

Info
- Model Railroading with Arduino (MRRwA)
  - NmraDCC
- Locoduino (fr)
  - Arduino
    - Comment alimenter l’Arduino sans ordinateur ?
  - Présentation de la norme DCC
  - Réalisation pratique d’un système de mesure de vitesse à l’échelle N: Pro Mini + adaptateur série usb
  - Réalisation d’un affichage de gare ARRIVEE DEPART
  - Comandament / Throttle
    - xpressnet_arduino
  - Descodificadors d'accessoris / Accessory decoders
    - arduinodcc
- Arduino (es) (Paco Cañada)
- PCR-NMRA
  - model railroading with arduino - PCR-NMRA (Dave Flakenburg) (pdf)
    - connecting leds
- Decodificadores DCC baratos con Arduino
- Arduino : modules pour le train (UAICF Nevers Vauzelles)
  - Commande de pont transbordeur avec moteur pas à pas
  - Pupitre TCO compatible Roco, Lenz, Viessmann, Fleischmann,...
  - Souris DCC XpressNet compatible Roco, Lenz, Viessmann, Fleischmann,...
  - Analyser les trames DCC
  - Schémas et programmes avec un Arduino UNO pour réaliser un lecteur / décodeur sonore
  - Réaliser un TCO en digital DCC avec une carte ARDUINO
  - Réalisation d’un décodeur de servomoteurs en digital (DCC) et compatible analogique pouvant piloter jusqu’à 6 servomoteurs.
  - Notice pour décodeur DCC d'accessoires avec un PIC 16F629
  - Décodeur DCC d'accessoires avec un ARDUINO
  - Support pour servomoteur à imprimer en 3D
  - Support pour servomoteurs et réglages
Comandament / Throttle
- Info
  - Un TCO xpressnet (Locoduino) (Nicolas Zin)
    - Forum: TCO arduino Xpressnet
  - Interface programable XpressNet
    - Throttle (Norber)
- Programari / Software
  - xpressnet_arduino (Nicolas Zin)
    - Arduino Mega
  - John Alexander Stewart
    - Arduino Uno
    - Examples
      - XpressNet_Trottle.ino (John Alexander Stewart)
      - NOR_XpressNet_Throttle.zip (Norber)
      - NOR_XpressNet_TCO2.ino.zip (Norber)
  - Philipp Gahtow (pgahtow)
    - Wiki
      - Eigenbau
      - XpressNet
        
        based on John Alexander Stewart software
      - Z21 Mobile
      - DCC Dekoder
      - Railcom
    - Digital Modellbahn (sourceforge) (files)
      - Arduino (v1.0) libaries
        
        XpressNetMaster.zip (master)
        
        XpressNetMaster/
        
        xpressnetmaster/
        
        XpressNet.zip (client)
        
        XpressNet/
        
        XpressNet.h
        
        XpressNet.cpp
        
        examples/
        
        Xpressnet_Lib/
        
        Xpressnet_Lib_StopButton/
        
        Xpressnet_Lib_Weiche/
        
        XpressNet_Sniffer/
        
        XpressNet_Z21_Ethernet_v2.3/
        
        Z21-multimouse-slave/
        
        ...
      - Booster
        
        Version3
        
        Version2
        
        Version1
      - Z21_mobile
        
        XpressNet_Slave
        
        DCC_Zentrale
        
        DCC_mini_Dekoder
        
        ESP8266_WiFi
        
        LocoNet
      - ...

Estació de control / Command station

Programari / Software

Z21 Arduino (client)
autor

DCC++ Gregg

DCCpp Thierry biblioteca

EX-CommandStation (DCC++ EX) DCC-EX

	autor
DCC++	Gregg
DCCpp	Thierry	biblioteca
EX-CommandStation (DCC++ EX)	DCC-EX

DCC++ (YouTube)

See also:
- DCCpp, a newer version, conceived as a library instead of a program
- EX-CommandStation replaces DCC++
Autor / Author: Gregg
Components
- BaseStation (gh)
  - Arduino: Uno, Mega, (Nano)
- Controller (gh)
  - DcDccNanoController (Locoduino)
wiki
- Getting Started With DCC Hardware
  - Instal·lació / Installation
    1. cd ~/src
    2. git clone https://github.com/DccPlusPlus/BaseStation.git
    3. git checkout master (master-2.0)
    4. cd ~/Arduino/librarires
    5. (master) ln -s ~/src/BaseStation/DCCpp_Uno .
    6. (master-2.0) ln -s ~/src/BaseStation/DCCpp .
  - Ús / Usage
    - Arduino IDE
      - Fitxers -> Exemples (Exemples de les biblioteques personalitzades)
        
        (master) DCCpp_Uno
        
        (master-2.0) DCCpp
      - Eines -> Monitor sèrie
        
        115000 bps
        
        Diagnostics D command
        
        Testing the Arduino and Base Station code
        
        jumper D13 - D3, to test MAIN (SIGNAL_ENABLE_PIN_MAIN in Mega)
        
        type: <0>. LED should go off.
        
        type: <1>. LED should go on.
        
        jumper D13 - D11, to test PROG (SIGNAL_ENABLE_PIN_PROG in Mega)
        
        type: <0>. LED should go off.
        
        type: <1>. LED should go on.
        
        Testing the DCC signal
        
        with an oscilloscope
        
        probe: GND, pin D12
        
        trigger:
        
        Siglent SDS
        
        Type: Edge
        
        Holdoff Time: 6.6m
        
        jumper D13 - D12 (DCC_SIGNAL_PIN_MAIN in Mega)
        
        type: <D>. LED should follow a DCC signal slowed down by a factor of 256.
        
        jumper D13 - D2 (DCC_SIGNAL_PIN_PROG in Mega)
        
        type: <D>. LED should follow a DCC signal slowed down by a factor of 256.
        
        Testing the motor shield
        
        type: <1>. All 4 LEDs next to A, B should be on.
        
        type: <D>. All 4 LEDs next to A, B should follow a DCC signal slowed down by a factor of 256.
DCC++ (iGuadix)
Locoduino
- See also DCCpp (library version of DCC++)
- Réalisation de centrales DCC avec le logiciel libre DCC++
  - 1. Comment adapter ce très bon logiciel à ses besoins propres
    - La mesure de courant pour les commandes de programmation
      - DCC ACK to recover 8 bits when reading a CV (ACK_SAMPLE_THRESHOLD):
        
        «Si le résultat dépasse la valeur de repos d’un seuil ACK_SAMPLE_THRESHOLD alors le bit est un "1", sinon c’est un "0". Ce mécanisme se répète 8 fois pour récupérer les 8 bits d’un octet de réponse de la loco.»
    - trouveAddresseDCC
      - readCV_Main(...)
  - 2. Mise en œuvre d’un contrôleur pour BaseStation en HTML
  - 3. DCC++ : Quel matériel et quelle mise en œuvre ?
- Discussions
  - DCC & CVs
  - DCC++ sur Nano avec LMD18200 (jpg)

		DCC++
		DCCpp_Uno.h	Uno	Mega	Motor Shield
main	dir	DCC_SIGNAL_PIN_MAIN	D10	D12	D12	A
	PWM	SIGNAL_ENABLE_PIN_MAIN	D3	D3	D3
	sense	CURRENT_MONITOR_PIN_MAIN	A0	A0	A0
prog	dir	DCC_SIGNAL_PIN_PROG	D5	D2	D13	B
	PWM	SIGNAL_ENABLE_PIN_PROG	D11	D11	D11
	sense	CURRENT_MONITOR_PIN_PROG	A1	A1	A1

Serial commands

L'interface avec le Contrôleur par liaison série ou ethernet
Commands for DCCpp BaseStation

group SerialCommand.cpp SerialCommand::parse (master-2.0: SerialCommand.cpp) PacketRegister.cpp

info s <s> READ STATUS OF DCC++ BASE STATION

F <F> ATTEMPTS TO DETERMINE HOW MUCH FREE SRAM IS AVAILABLE IN ARDUINO

L <L> LISTS BIT CONTENTS OF ALL INTERNAL DCC PACKET REGISTERS

c <c> READ MAIN OPERATIONS TRACK CURRENT

D <D> ENTER DIAGNOSTIC MODE (slows down by a 256 factor)

J <J> SHOW DCC++ SERVER ID (only on master-2.0 tag)

<J ID> SET DCC++ SERVER ID (only on master-2.0 tag)

power on track 0 <0> TURN OFF POWER FROM MOTOR SHIELD TO TRACKS

1 <1> TURN ON POWER FROM MOTOR SHIELD TO TRACKS

throttle t <t REGISTER CAB SPEED DIRECTION> SET ENGINE THROTTLES USING 128-STEP SPEED CONTROL setThrottle()

function

f

<f CAB BYTE1 [BYTE2]>

OPERATE ENGINE DECODER FUNCTIONS F0-F28

BYTE1								BYTE2
128	64	32	16	8	4	2	1	128	64	32	16	8	4	2	1
1	0	0	F0	F4	F3	F2	F1
1	0	1	1	F8	F7	F6	F5
1	0	1	0	F12	F11	F10	F9
1	1	0	1	1	1	1	0	F20	F19	F18	F17	F16	F15	F14	F13
1	1	0	1	1	1	1	1	F28	F27	F26	F25	F24	F23	F22	F21

setFunction()

accessory a <a ADDRESS(0-511) SUBADDRESS(0-3) ACTIVATE(0-1)> OPERATE STATIONARY ACCESSORY DECODERS (basic accessory) setAccessory()

T <TID ADDRESS SUBADDRESS> create a new turnout ID, with specified address and subaddress

<TID> delete definition of turnout ID

<T> list all defined turnouts

<TID THROW> set turnout ID to either thrown or unthrown position

sensor S ... CREATE/EDIT/REMOVE/SHOW A SENSOR

Q <Q> SHOW STATUS OF ALL SENSORS

output pins Z <Z ID ACTIVATE> CREATE/EDIT/REMOVE/SHOW & OPERATE AN OUTPUT PIN

CV POM w <w CAB CV VALUE> WRITE CONFIGURATION VARIABLE BYTE TO ENGINE DECODER ON MAIN OPERATIONS TRACK writeCVByteMain()

b <b CAB CV BIT VALUE> WRITE CONFIGURATION VARIABLE BIT TO ENGINE DECODER ON MAIN OPERATIONS TRACK writeCVBitMain()

CV PT W <WCV VALUE CALLBACKNUM CALLBACKSUB> WRITE CONFIGURATION VARIABLE BYTE TO ENGINE DECODER ON PROGRAMMING TRACK writeCVByte()

B <B CV BIT VALUE CALLBACKNUM CALLBACKSUB> WRITE CONFIGURATION VARIABLE BIT TO ENGINE DECODER ON PROGRAMMING TRACK writeCVBit()

R <R CV CALLBACKNUM CALLBACKSUB> READ CONFIGURATION VARIABLE BYTE FROM ENGINE DECODER ON PROGRAMMING TRACK readCV()

eeprom E <E> STORE SETTINGS IN EEPROM

e <e> CLEAR SETTINGS IN EEPROM

other ' ' < > PRINT CARRIAGE RETURN IN SERIAL MONITOR WINDOW

dcc packets M <M REGISTER BYTE1 BYTE2 [BYTE3] [BYTE4] [BYTE5]> WRITE A DCC PACKET TO ONE OF THE REGSITERS DRIVING THE MAIN OPERATIONS TRACK

P <P REGISTER BYTE1 BYTE2 [BYTE3] [BYTE4] [BYTE5]> WRITE A DCC PACKET TO ONE OF THE REGSITERS DRIVING THE MAIN OPERATIONS TRACK

Exemples / Examples

Turn on track power:
- <1>

Main track (A)

POM: write CV value
- on locomotive with ID=3
  - ...
- on accessory decoder, with ID=9999, reset (PROGRAM led must be on):
  - <w 9999 8 8>
Locomotive decoder
- Run locomotive with ID=3, at speed 100, forward (1):
  - <t 1 3 100 1>
- Turn on lights of locomotive with ID=3:
  - <f 3 144>
- Turn off lights of locomotive with ID=3:
  - <f 3 128>

Accessory decoder (e.g. Digikeijs DR4018)

...

command	monitor (Decoder_Basic_Monitor_V1)
<a 0 0 0>	AccState - Raw addr: 65533 BoardAddr: 0 OutputAddr: 0 Output: 0 State: 0b1 Status: Thrown
<a 0 0 1>	AccState - Raw addr: 65533 BoardAddr: 0 OutputAddr: 1 Output: 0 State: 0b1 Status: Closed
<a 1 0 0>	AccState - Raw addr: 1 BoardAddr: 1 OutputAddr: 0 Output: 0 State: 0b1 Status: Thrown
<a 1 1 0>	AccState - Raw addr: 2 BoardAddr: 1 OutputAddr: 2 Output: 1 State: 0b1 Status: Thrown
<a 2 0 0>	AccState - Raw addr: 5 BoardAddr: 2 OutputAddr: 0 Output: 0 State: 0b1 Status: Thrown
<a 2 1 0>	AccState - Raw addr: 6 BoardAddr: 2 OutputAddr: 2 Output: 1 State: 0b1 Status: Thrown
<a 2 2 0>	AccState - Raw addr: 7 BoardAddr: 2 OutputAddr: 4 Output: 2 State: 0b1 Status: Thrown
<a 2 3 0>	AccState - Raw addr: 8 BoardAddr: 2 OutputAddr: 6 Output: 3 State: 0b1 Status: Thrown

Programming track (B)
- PT: read CV8 (manufacturer ID):
  - <R 8 1 2>

Bibliothèque DCCpp

Based on DCC++, but DCCpp is conceived as a library
Autor / Author: Thierry Paris (Trusty77)
Arduino: Uno, Mega, Nano (native support)
Codi font / Source
- Locoduino / DCCpp
Instal·lació / Installation
- Arduino IDE
  - Eines -> Gestiona les biblioteques
    - DIO2
    - Commanders
    - DCCpp
Documentació / Documentation
- file:///home/.../Arduino/libraries/DCCpp/extras/Doc/index.html

		DCCpp
		Config.h	Uno, Nano	Mega	Motor Shield
main	dir	DCC_SIGNAL_PIN_MAIN	D10	D12	D12 (MOTOR_SHIELD_DIRECTION_MOTOR_CHANNEL_PIN_A)	A
	PWM	MOTOR_SHIELD_SIGNAL_ENABLE_PIN_MAIN	D3		D3
	sense	MOTOR_SHIELD_CURRENT_MONITOR_PIN_MAIN	A0		A0
prog	dir	DCC_SIGNAL_PIN_PROG	D5	D2	D13 (MOTOR_SHIELD_DIRECTION_MOTOR_CHANNEL_PIN_B)	B
	PWM	MOTOR_SHIELD_SIGNAL_ENABLE_PIN_PROG	D11		D11
	sense	MOTOR_SHIELD_CURRENT_MONITOR_PIN_PROG	A1		A1

Estructura / Structure

file	classe	fonctions
DCCpp.h
DCCpp.cpp	DCCpp	setup	begin() beginMain() beginMainMotorShield() beginMainPololu() beginProg() beginProgMotorShield() beginProgPololu() beginEhternet()
		générales	loop() panicStop(true/false) powerOn() powerOff() setAccessory()
		voie principale	setSpeedMain() setFunctionsMain() readCvMain() writeCvMain() getCurrentMain()
		voie de programmation	setSpeedProg() setFunctionsProg() readCvProg() writeCvProg() getCurrentProg()
Turnout.cpp	Turnout
Sensor.cpp	Sensor
Outputs.cpp	Outputs
EEStore.cpp	EEStore

Ús / Usage
- Fitxer -> Exemples
  - DCCpp / SerialDcc
    - Basic example with serial commands
    - To be used with an Arduino Motor Shield:
      - //DCCpp::beginMain(UNDEFINED_PIN, DCC_SIGNAL_PIN_MAIN, 11, A0); DCCpp::beginMainMotorShield(); DCCpp::beginProgMotorShield();
    - Exemples / Examples
  - DCCpp / MiniDcc
  - DCCpp / MaxiDcc
    - ~/Arduino/libraries/DCCpp/src/DCCpp.h
      - #define USE_TURNOUT #define USE_EEPROM #define USE_OUTPUT #define USE_SENSOR
...

EX-CommandStation (DCC++ EX)

Instal·lació / Installation
- DCC-EX
  - CommandStation-EX

Reference

Hardware
- Arduino Mega + motor shield
  - track Arduino pin motor shield output
    
    main 12 A
    
    program 13 B
Diagnostic tools
- DCC sniffer
  - Stand-alone DCC Diagnosticsf
    - ESP32 + OLED
    - DCC-EX / DCCInspector-EX
DCC++ EX Command Reference

track	Arduino pin	motor shield output
main	12	A
program	13	B

DCC++ EX Command Summary

group		command (DCCEXParser.cpp)	description	returns
power	0	`<0 [MAIN \| PROG]>`	Power off	`<p0>`
	1	`<1 [MAIN \| PROG \| JOIN]>`	Power on	`<p1>`
	c	`<c>`	Current on the MAIN Track
	s	`<s>`	CommandStation Status
	D	`<D RESET>`	Reboot the command station
cab functions
programming track
DCC Accessories					DCC::setAccessory()
Turnouts
Sensors
Outputs
EEPROM management
WiFi Control
Diagnostic traces
Tuning
I/O (HAL) Diagnostics
Other

...

Extended accessory decoders
- v3.0.0 - Release Candidate Feature List #33

Descodificador / Decoder

Info

Maquinari / Hardware

Consum Arduino Nano Every, entrada DCC (pin 2)

VIN	cap sortida activada	1 semàfor Mafen connectat a 5V vermell + blanc encesos	LEDs amb resistències connectats a 5V (4 encesos)
7 V	47 mA / 329 mW
8 V	53 mA / 424 mW
9 V	30 mA / 270 mW
10 V	26 mA / 260 mW
11 V	24 mA / 264 mW
12 V	22 mA / 264 mW
13 V	20 mA / 260 mW
14 V	19 mA / 266 mW
15 V	18 mA / 270 mW	18 mA / 270 mW	21 mA / 315 mW
16 V	17 mA / 272 mW
17 V	16 mA / 272 mW
18 V	15 mA / 270 mW
19 V	14 mA / 266 mW
20 V	14 mA / 280 mW
21 V	13 mA / 273 mW

Programari / Software

AP_DCC_Library

replacement for NmraDcc when using new Arduino processors (ATMega 4809, e.g. Nano Every)

...

lib class methods attributes

AP_DCC_Library

Dcc

void attach(uint8_t dccPin, uint8_t ackPin=255)
void detach(void)
bool input(void)
void sendAck(void)

CmdType_t cmdType
- Unknown - Start value, but should never be returned
- IgnoreCmd - Command should be ignored
- ResetCmd - We have received a reset command
- SomeLocoSpeedFlag - Loco speed == 0, but not for this decoder => end of Reset
- SomeLocoMovesFlag - Loco speed > 0, but not for this decoder
- MyLocoSpeedCmd - Loco speed and direction command, for this decoder
- MyEmergencyStopCmd - Loco Emergency stop, for this decoder
- MyLocoF0F4Cmd - F0..F4 command, for this decoder address(es)
- MyLocoF5F8Cmd - F5..F8 command, for this decoder address(es)
- MyLocoF9F12Cmd - F9..F12 command, for this decoder address(es)
- MyLocoF13F20Cmd - F13..F20 command, for this decoder address(es)
- MyLocoF21F28Cmd - F21..F28 command, for this decoder address(es)
- MyLocoF29F36Cmd - F29..F36 command, for this decoder address(es)
- MyLocoF37F44Cmd - F37..F44 command, for this decoder address(es)
- MyLocoF45F52Cmd - F45..F52 command, for this decoder address(es)
- MyLocoF53F60Cmd - F53..F60 command, for this decoder address(es)
- MyLocoF61F68Cmd - F61..F68 command, for this decoder address(es)
- AnyAccessoryCmd - Accessory command, but not for this decoder address(es)
- MyAccessoryCmd - Accessory command, for this decoder address(es)
- MyPomCmd - Programming on the Main (PoM)
- SmCmd - Programming in Service Mode (SM = programming track)

Accessory

void setMyAddress(unsigned int first, unsigned int last = 65535)
uint8_t myMaster = Lenz | OpenDcc | Roco;
- see sup_acc.cpp
  - very interesting explanation about addresses

Command_t command: (basic..extended)

`outputAddress` (11 bits)
`decoderAddress` (9 bits)	`turnout` (2 bits)	`position` (1 bit)
	`device` (3 bits)

Decoder-based addressing (basic)
- unsigned int decoderAddress: (0..511)
- uint8_tturnout: (1..4)
Output-based addressing (basic and extended)
- unsigned int outputAddress: (1..2048)
- basic:
  - uint8_t position: (0..1)
  - uint8_t device: (1..8)
  - uint8_t activate: (0..1)
- extended:
  - uint8_t signalHead: (0..255)

Loco

void setMyAddress(unsigned int first, unsigned int last = 65535)

unsigned int address; // 0..9999 - Received Loco addres
bool longAddress; // Was the received adress 14 bit, or 7-bit?
bool emergencyStop; // Flag: emargency stop for this decoder
uint8_t speed; // 0..28 / 0..127
bool forward; // True = Forward / False = Reverse
uint8_t F0F4; // 0..31. Least significant bit is F1. F0 is bit 4
uint8_t F5F8; // 0..15. Least significant bit is F5
uint8_t F9F12; // 0..15. Least significant bit is F9
uint8_t F13F20; // 0..255. Least significant bit is F13
uint8_t F21F28; // 0..255. Least significant bit is F21
uint8_t F29F36; // 0..255. Least significant bit is F29
uint8_t F37F44; // 0..255. Least significant bit is F37
uint8_t F45F52; // 0..255. Least significant bit is F45
uint8_t F53F60; // 0..255. Least significant bit is F53
uint8_t F61F68; // 0..255. Least significant bit is F61

CvAccess

access to CV variables can be sent in:
- Service Mode (SM, programming track)
  - S-9.2.3 defines 4 methods:
    - direct configuration (implemented)
    - address-only (not implemented)
    - physical register (not implemented)
    - paged addressing (not implemented)
- Programming on the Main (PoM)
  - S-9.2.1 defines 2 methods:
    - short form (not implemented)
    - long form (implemented)
uint8_t writeBit(uint8_t data); // write bitvalue on bitposition
bool verifyBit(uint8_t data); // the received bitvalue on bitposition matches the old

unsigned int number; // 1..1024 - CV number
uint8_t value; // 0..255 - CV value
operation_t operation; // verifyByte, writeByte, bitManipulation
in case of bitManipulation:
- uint8_t writecmd; // 0 = verify bit command, 1 = write bit command
- uint8_t bitvalue; // 0..1
- uint8_t bitposition; // 0..7

AP_DCC_Decoder_Core
(replaced by AP_DCC_Library,
except CvValues:
suspected bug on ReadCV #4)

CvValues
(CV)

storage of CV values in EEPROM
void init(uint8_t decoderType, uint8_t softwareVersion = 1)

decoderType is stored in CV27 (DecType)

uint8_t read(uint8_t number)
void write(uint8_t number, uint8_t value)
unsigned int storedAddress(void)

AP_DccLED

BasicLed

void attach (uint8_t pin, bool invert=false)
bool ledIsOn(void)
void turn_on(void)
void turn_off(void)
void toggle(void)

FadeOutLed: public BasicLed

(BasicLed)

should usually be called from setup():

void attach (uint8_t pin, bool invert=false)
void fadeOut(void)

should usually be called from loop():

void update(void)

uint8_t fadeTime
uint8_t fadeSteps
uint8_t pwmFrequency

FlashLed: public BasicLed

(BasicLed)

should usually be called from setup():

void attach (uint8_t pin, bool invert=false)
void flash(void)
void flashSlow(void)
void flashFast(void)

should usually be called from loop():

void update(void)

(BasicLed)
uint8_t flashOntime
uint8_t flashOfftime
uint8_t flashPause
uint8_t flashCount
bool neverStopFlashing

DccLed: public FlashLed

(FlashLed)
void start_up(void)
void activity(void)
void feedback(void)

Examples
- dcc-fpm /
- Minimal example
  - extern Dcc dcc; extern Accessory accCmd; extern Loco locoCmd; extern CvAccess cvCmd;

DCC_Decoder (MynaBay)
- Building a DCC Monitor with an Arduino (MynaBay)
  - DCC signal in breadboard
- Arduino accessory decoder experiments

NmraDcc (MRRwA) (Alex Shepherd / Geoff Bunza for SMA)

see AP_DCC_library for new Arduino processors (ATMega 4809, e.g. Nano Every)
dcc-fpm/
- decoder/
- nmradcc-fpm/
DCC interface
- Iowa Scaled Engineering’s Arduino DCC Decoder Shield
- DCC Interface’s Model Railway DCC Turntable Accessory Decoder for Arduino Nano
- Wolfgang Kuffer’s DCC Decoder (with DCC ACK) (OpenDCC Open decoder)

	motor	step	servo	LED	turnout	audio	functions	mobile/function decoder	stationary accessory decoder
Examples								`setup()` `Dcc.init( MAN_ID_DIY, 10, FLAGS_MY_ADDRESS_ONLY, 0 );`	`setup()` `Dcc.init( MAN_ID_DIY, 10, CV29_ACCESSORY_DECODER \| CV29_OUTPUT_ADDRESS_MODE, 0 );`
								NmraDccMultiFunctionDecoder_1 notifyCVResetFactoryDefault notifyDccMsg notifyCVAck notifyDccFunc	NmraDccAccessoryDecoder_1 (responds to normal DCC Turnout Control packets [basic accessory decoder s-9.2.1 2.4.1] and the newer DCC Signal Aspect packets [extended accessory decoder control packet s-9.2.1 2.4.2]) Does not control any LED. See Pulsed_8 if you want real outputs. notifyCVResetFactoryDefault notifyDccMsg notifyCVAck notifyDccAccTurnoutBoard (Board Addressing Mode) notifyDccAccTurnoutOutput (Output Addressing Mode) notifyDccSigOutputState (DCC Signal Aspect Packet) (s-9.2.1 2.4.2)
					8				NmraDccAccessoryDecoder_Pulsed_8 (control of 8 pulsed turnouts) #define ACTIVE_OUTPUT_STATE LOW #define CV_ACCESSORY_DECODER_ACTIVE_STATE 4 ... {CV_ACCESSORY_DECODER_ACTIVE_STATE, ACTIVE_OUTPUT_STATE} ... uint8_t activeOutputState = Dcc.getCV(CV_ACCESSORY_DECODER_ACTIVE_STATE); notifyCVResetFactoryDefault notifyDccMsg notifyCVAck notifyCVChange notifyDccAccTurnoutOutput initPinPulser
									NmraDcc_ARD_DCCSHIELD (Iowa Scaled Engineering ARD-DCCSHIELD; allow CV read/write) notifyCVResetFactoryDefault notifyDccMsg notifyCVAck notifyCVChange
									DCCInterface_TurntableControl
									dcc-fpm/decoder/AccessoryDecoder_1
									dcc-fpm/nmradcc-fpm/NmraDcc_Monitor
									dcc-fpm/nmradcc-fpm/NmraDccAccessoryDecoder_2_fpm notifyDccSigOutputState (DCC Signal Aspect Packet) (s-9.2.1 2.4.2)
Arduino DCC Monitor									Decoder_Basic_Monitor_v1
SMA Examples (SMA)								`setup()` `Dcc.init( MAN_ID_DIY, 601, FLAGS_MY_ADDRESS_ONLY, 0 );` `loop()` `Dcc.process()` `notifyDccFunc() exec_function()`	`setup()` `#define CV_To_Store_SET_CV_Address 121` `Dcc.init( MAN_ID_DIY, 601, FLAGS_OUTPUT_ADDRESS_MODE \| FLAGS_DCC_ACCESSORY_DECODER, CV_To_Store_SET_CV_Address);` `loop()` `Dcc.process()` `notifyDccAccTurnoutOutput() exec_function()`
			0	17			1 (on/off)	Dec_17LED_1Ftn	AccDec_17LED_1Ftn #define SET_CV_Address 24 // THIS ADDRESS IS FOR SETTING CV'S Like a Loco #define CV_To_Store_SET_CV_Address 121 Dcc.init( MAN_ID_DIY, 601, FLAGS_OUTPUT_ADDRESS_MODE \| FLAGS_DCC_ACCESSORY_DECODER, CV_To_Store_SET_CV_Address);
			0	17			6 (LED on/off, LED blink, servo control, dual LED blink, pulsed output, LED fade on)	Dec_17LED_6Ftn	AccDec_17LED_6Ftn
			0	17				Dec_Dir_and_Fade
								Dec_SMA12_LED_Groups
			7	10			6	Dec_7Serv_10LED_6Ftn	AccDec_7Servos_10LED_6Ftn
			10	7			6	Dec_10Serv_7LED_6Ftn	AccDec_10Servos_7LED_6Ftn AccDec_7ServoBackandForth6Ftn
			13	4			6	Dec_13Serv_4LED_6Ftn	AccDec_13Servos_4LED_6Ftn
			15	2			6	Dec_15Serv_2LED_6Ftn	AccDec_15Servos_2LED_6Ftn
	2							Dec_2MotDrive_12LED_1Srv_6Ftn
	2			10		x		Dec_2Mot_10LED_Audio_6Ftn
		1						Dec_Stepper_8Ftn
Digital Town Project 5
	motor	step	servo	LED	turnout	audio	functions	mobile/function decoder	stationary accessory decoder

NmraDcc.h

	common	multi-function decoder	accessory decoder
#define (CV index)	`CV_VERSION_ID 7` `CV_MANUFACTURER_ID 8` `CV_29_CONFIG 29` `CV_29_BITS {` `CV29_LOCO_DIR = 0b00000001` (b0) `CV29_F0_LOCATION= 0b00000010` (b1) `CV29_APS` `= 0b00000100`(b2) `CV29_RAILCOM_ENABLE = 0b00001000`(b3) `CV29_SPEED_TABLE_ENABLE= 0b00010000` (b4) `CV29_EXT_ADDRESSING` `= 0b00100000` (b5) `CV29_OUTPUT_ADDRESS_MODE` `= 0b01000000` (b6) `CV29_ACCESSORY_DECODER = 0b10000000` (b7)	`CV_MULTIFUNCTION_PRIMARY_ADDRESS 1` `CV_MULTIFUNCTION_EXTENDED_ADDRESS_MSB 17` `CV_MULTIFUNCTION_EXTENDED_ADDRESS_LSB 18`	`CV_ACCESSORY_DECODER_ADDRESS_LSB 1 (new definition in S-9.2.2, equivalent to CV513)` `CV_ACCESSORY_DECODER_ADDRESS_MSB 9` `(new definition in S-9.2.2, equivalent to CV521)`
#define (values)	ManufacturerId (used for CV8): `MAN_ID_JMRI 0x12` (18: JMRI) `MAN_ID_DIY 0x0D` (13: Public-domain and DIY) `MAN_ID_SILICON_RAILWAY 0x21` Flag values to be logically ORed together and passed into the init() method: `FLAGS_MY_ADDRESS_ONLY 0x01` `FLAGS_AUTO_FACTORY_DEFAULT 0x02` `FLAGS_SETCV_CALLED 0x10` `FLAGS_OUTPUT_ADDRESS_MODE 0x40` (CV 29/541 b6) Accessory decoders normally have 4 paired outputs and a single address refers to all 4 outputs. Setting `FLAGS_OUTPUT_ADDRESS_MODE` causes each address to refer to a single output. `FLAGS_DCC_ACCESSORY_DECODER 0x80` (CV29/541 b7) `FLAGS_CV29_BITS (FLAGS_OUTPUT_ADDRESS_MODE \| FLAGS_DCC_ACCESSORY_DECODER`)	`DEFAULT_MULTIFUNCTION_DECODER_ADDRESS 3` `DCC_SPEED_STEPS{` `SPEED_STEP_14 = 15` `SPEED_STEP_28 = 29` `SPEED_STEP_128 = 127` `DCC_DIRECTION{` `DCC_DIR_REV = 0` `DCC_DIR_FWD = 1` `DCC_ADDR_TYPE{` `DCC_ADDR_SHORT` `DCC_ADDR_LONG` `FN_GROUP` `{` `FN_0_4 = 1` `FN_5_8` `FN_9_12` `FN_13_20` `FN_21_28`	`DEFAULT_ACCESSORY_DECODER_ADDRESS 1`
functions (to be called)	# pin to receice DCC packets void pin( uint8_t ExtIntNum, uint8_t ExtIntPinNum, uint8_t EnablePullup); #pin to receive DCC packets void pin( uint8_t ExtIntPinNum, uint8_t EnablePullup); void init( uint8_t ManufacturerId, uint8_t VersionId, uint8_t Flags, uint8_t OpsModeAddressBaseCV ); uint8_t process(); uint8_t getCV( uint16_t CV ); uint8_t setCV( uint16_t CV, uint8_t Value); # returns 1 if EEPROM is ready to write uint8_t isSetCVReady( void ); # return the currently active decoder address uint16_t getAddr(void); ...		# same as init, with FLAGS_DCC_ACCESSORY_DECODER ored void initAccessoryDecoder( uint8_t ManufacturerId, uint8_t VersionId, uint8_t Flags, uint8_t OpsModeAddressBaseCV ); void setAccDecDCCAddrNextReceived(uint8_t enable);
callback functions (to be implemented)	extern void notifyDccReset(uint8_t hardReset ); extern void notifyDccIdle(void); extern void notifyDccMsg( DCC_MSG * Msg ); # Callback to determine if a given CV is valid extern uint8_t notifyCVValid( uint16_t CV, uint8_t Writable ); # Callback to read a CV extern uint8_t notifyCVRead( uint16_t CV); # if you implement this function, you must explicitly manage EEPROM writing extern uint8_t notifyCVWrite( uint16_t CV, uint8_t Value); extern uint8_t notifyIsSetCVReady(void); extern void notifyCVChange( uint16_t CV, uint8_t Value); called when setting a CV value in PT extern void notifyDccCVChange( uint16_t CV, uint8_t Value); extern void notifyCVResetFactoryDefault(void); extern void notifyCVAck(void); (DCC ACK) extern void notifyServiceMode(bool);	extern void notifyDccSpeed( uint16_t Addr, DCC_ADDR_TYPE AddrType, uint8_t Speed, DCC_DIRECTION Dir, DCC_SPEED_STEPS SpeedSteps ); extern void notifyDccSpeedRaw( uint16_t Addr, DCC_ADDR_TYPE AddrType, uint8_t Raw); extern void notifyDccFunc( uint16_t Addr, DCC_ADDR_TYPE AddrType, FN_GROUP FuncGrp, uint8_t FuncState);	# Board oriented callback for a turnout accessory decoder extern void notifyDccAccTurnoutBoard( uint16_t BoardAddr, uint8_t OutputPair, uint8_t Direction, uint8_t OutputPower ); Most useful when CV29_OUTPUT_ADDRESS_MODE is not set. Decoders of this type have 4 paired turnout outputs per board. # Output oriented callback for a turnout accessory decoder extern void notifyDccAccTurnoutOutput( uint16_t Addr, uint8_t Direction, uint8_t OutputPower); when `FLAGS_OUTPUT_ADDRESS_MODE` is set in `init()` extern void notifyDccAccBoardAddrSet( uint16_t BoardAddr); extern void notifyDccAccOutputAddrSet( uint16_t Addr); # Callback for a signal aspect accessory decoder extern void notifyDccSigOutputState( uint16_t Addr, uint8_t State); deprecated: extern void notifyDccAccState( uint16_t Addr, uint16_t BoardAddr, uint8_t OutputAddr, uint8_t State ); extern void notifyDccSigState( uint16_t Addr, uint8_t OutputIndex, uint8_t State);

o

NmraDcc.cpp
- #define DEBUG_PRINT
Snippets
- monitor DCC messages
  - void printBits(byte myByte){ for(byte mask = 0x80; mask; mask >>= 1){ if(mask & myByte) Serial.print('1'); else Serial.print('0'); } } #ifdef NOTIFY_DCC_MSG extern void notifyDccMsg( DCC_MSG * Msg ) { int i; if( ( Msg->Data[0] == 0 ) && ( Msg->Data[1] == 0 ) ) return; //reset packet if( ( Msg->Data[0] == 0b11111111 ) && ( Msg->Data[1] == 0 ) ) return; //idle packet if(Msg->Data[0] == 100 && Msg->Data[1] == 63) return; Serial.print("[notifyDccMsg] "); Serial.print(Msg->Size); Serial.print(" "); for(i=0;i<Msg->Size;i++){ //Serial.print(Msg->Data[i], BIN); printBits(Msg->Data[i]); Serial.print(" "); } Serial.println(); } #endif
- CV factory reset
  - const uint16_t ACC_ADDR = 1000; // 11 bit address: // 0 - broadcast, 1 to 2044 - specific. const byte ACC_ADDR_LSB = ACC_ADDR & 0xff; const byte ACC_ADDR_MSB = ACC_ADDR >> 8; struct CVPair { uint16_t CV; uint8_t Value; }; CVPair FactoryDefaultCVs [] = { {CV_ACCESSORY_DECODER_ADDRESS_LSB, ACC_ADDR_LSB}, // Accessory address LSB. {CV_ACCESSORY_DECODER_ADDRESS_MSB, ACC_ADDR_MSB}, // Accessory address MSB. }; uint8_t FactoryDefaultCVIndex = 0; void notifyCVResetFactoryDefault() { // mark reset to factory defaults is needed, to be called from loop // Make FactoryDefaultCVIndex non-zero and equal to num CV's to be reset // to flag to the loop() function that a reset to Factory Defaults needs to be done Serial.println(F("notifyCVResetFactoryDefault called.")); FactoryDefaultCVIndex = sizeof(FactoryDefaultCVs)/sizeof(CVPair); }; void setup() { // mark factory defaults is needed // TODO: protect from being called when decoder is restarted? notifyCVResetFactoryDefault(); } void loop() { // reset to factory defaults if( FactoryDefaultCVIndex && Dcc.isSetCVReady()) { Serial.print("FactoryDefaultCVIndex: "); Serial.println(FactoryDefaultCVIndex); FactoryDefaultCVIndex--; // Decrement first as initially it is the size of the array Dcc.setCV( FactoryDefaultCVs[FactoryDefaultCVIndex].CV, FactoryDefaultCVs[FactoryDefaultCVIndex].Value); } }
- define operation mode address (like a loco)
  - #define OPS_MODE_ADDRESS 9999 // this address is for setting cv's like a loco #define OPS_MODE_ADDRESS_BASE_CV 17 // CV where to store the ops mode address CVPair FactoryDefaultCVs [] = { ... {OPS_MODE_ADDRESS_BASE_CV, OPS_MODE_ADDRESS & 0xFF }, // LSB Ops Mode Address {OPS_MODE_ADDRESS_BASE_CV+1,(OPS_MODE_ADDRESS >>8) & 0x3F }, // MSB Ops Mode Address }; void setup() { ... Dcc.init( MAN_ID_DIY, 601, FLAGS_OUTPUT_ADDRESS_MODE | FLAGS_DCC_ACCESSORY_DECODER, OPS_MODE_ADDRESS_BASE_CV); }
- CV read
  - ...
- CV write
  - POM
    - ...
  - PT

Function hierarchy

	callback functions (to be implemented)	functions (to be called)	DCC packet CCC	internal function
		pin						pin
common functions		init						init
		process						process
		getCV		readCV
		setCV		writeCV
		isSetCVReady		isSetCVReady
		...
common callbacks	notifyDccReset					processMultiFunctionMessage	execDccProcessor	process
	notifyDccIdle					-	execDccProcessor	process
	notifyDccMsg			-	-	-	-	process
	notifyCVValid			validCV	processDirectOpsOperation	processServiceModeOperation	execDccProcessor	process
	notifyCVValid			validCV	-	processServiceModeOperation	execDccProcessor	process
	notifyCVRead			readCV	processDirectOpsOperation	processServiceModeOperation	execDccProcessor	process
	notifyCVRead			readCV	-	processServiceModeOperation	execDccProcessor	process
	notifyCVWrite			writeCV	processDirectOpsOperation	processServiceModeOperation	execDccProcessor	process
	notifyCVWrite			writeCV	-	processServiceModeOperation	execDccProcessor	process
	notifyCVWrite			writeCV	-	-	execDccProcessor	process
	notifyCVWrite			writeCV	-	-	-	init
	notifyIsSetCVReady			isSetCVReady	?
	notifyCVChange			writeCV	...
	notifyDccCVChange			writeCV	...
	notifyCVResetFactoryDefault			-	-	-	-	init
	notifyCVResetFactoryDefault			validCV	...
	notifyCVAck			ackCV	processDirectOpsOperation	processServiceModeOperation	execDccProcessor	process
	notifyServiceMode			resetServiceModeTimer	clearDccProcState	-	execDccProcessor	process
	notifyServiceMode			-	-	-	-	init
	notifyServiceMode			-	-	-	execDccProcessor	process
multi-function decoder callbacks	notifyDccSpeed		010 011			processMultiFunctionMessage	execDccProcessor	process
	notifyDccSpeedRaw		010 011			processMultiFunctionMessage	execDccProcessor	process
	notifyDccFunc		100 101 110			processMultiFunctionMessage	execDccProcessor	process
accessory decoder callbacks	notifyDccAccTurnoutBoard					-	execDccProcessor
	notifyDccAccTurnoutOutput					-	execDccProcessor
	notifyDccAccBoardAddrSet					-	execDccProcessor
	notifyDccAccOutputAddrSet					-	execDccProcessor
	notifyDccSigOutputState					-	execDccProcessor
	notifyDccAccState
	notifyDccSigState
accessory decoder functions	initAccessoryDecoder
	setAccDecDCCAddrNextReceived

CTMS (Control de trenes modelo por software)
MERG (Model Elelctronic Railway Group)
- Electronics for model railways
  - Part A (pdf)
    - 1 – Basic electronics
    - 2 – Loco controllers
    - 3 – Layout wiring
    - 4 – Track wiring
    - 5 – Voltage problems
    - 6 – Point wiring
    - 7 - Point motors & servos
    - 8 – Scenic lighting
    - 9 – Coach lighting
    - 10 - Adding sound
    - 11 - Track occupancy detectors
    - 12 – R F I D
    - 13 – Digital Command Control
    - 14 – CBUS
  - Part B (pdf)
    - 15 – Transistors, ICs & PICs
    - 16 - Interfacing techniques
    - 17 – Computers & model railways
    - 18 – Assembling a tool kit
    - 19 – Soldering
    - 20 – Using test equipment
    - 21 - Pocket Money Projects
    - 22 – Abbreviations & Acronyms
    - Appendix - M E R G
- MERG DCC System
  - MERG DCC System - Downloads
OpenDCC

Paco Cañada

Maquinari / Hardware
Foro de The POWS
Electrònica
- PIC
- Paso a paso
DCC
- Introducción al digital DCC (Firatren 2012) (pdf)
- Introducción al control por ordenador de la maqueta (Firatren 2014) (pdf)
- Control total por ordenador de la maqueta (Firatren 2014) (pdf)
  - Cantons, semàfors, ...

Descodificadors d'accessoris / Accessory decoders

Accessory decoders	model	desc	semaphore			PIC	voltage		manual	source code	hex firmware	PCB	JMRI
			2L	3L	4L		input	output
DIY	2 turnout decoder	4 outputs				12F629	14V AC	rectified input (common anode/positive)		dcc2coil.asm	dcc2coil.zip	dcc2semaf.pdf
	semaphore with slow on / off	4 outputs				12F629	14V AC	rectified input (common anode/positive)	2semaf_manual.pdf	dcc2semaf.asm	dcc2semaf.zip	dcc2semaf.pdf
	UniSemaf	4 outputs 8 aspects	2	1	1	12F629	14V AC	rectified input (common anode/positive)	UniSemaf_manual.pdf	UniSemaf_10.asm	UniSemaf_10.zip UniSemaf_20.zip
	4 semaphore / Semaphore decoder for 16F84/16F628 (based on MERG, CTMS)	8 outputs 4 aspects	4	2	-	16F84/16F628	16V AC	rectified input (common anode/positive)	4Semaf_manual.pdf	dc4semaf_pulsador.asm	dcc4semaforos.zip (*)
	4 turnouts and signals / Accessory decoder	8 outputs				16F84				dbacc4p.asm	dbacc4p.zip (*)	DCCacc_sch.pdf
	UniSemaf-648 (based on MERG)	8 outputs 24 aspects	4	2	2	16F628	AC	rectified input (common anode/positive)	UniSemaf648_manual.pdf	UniSemaf_648.asm	UniSemaf_648.zip
	UniSemaf-648 (based on MERG)	8 outputs 32 aspects	4	2	2	16F648			UniSemaf648_manual.pdf	UniSemaf_648.asm	UniSemaf_648.zip
	4 servo decoder v2
	Servo point
PpP	PpP-Sem2	8 outputs 2, 4 aspects	4	-	-				Informacion_Sem2.pdf				PpP_Decoders.zip
	PpP-Sem3	12 outputs 4 aspects	-	4	-				Informacion_Sem3.pdf
	PpP-Sem4	12 outputs 8 aspects	-	-	3				Informacion_Sem4.pdf
DCC Accessory decoders by Salus	DEC-TRN, DEC-REG								Periféricos DCC

...

05Comandament / Throttle#

Bus de comandament / Cab bus

Productes / Products

...

	ref	color	connexió	protocol
Lokmaus 1	10750
Lokmaus 2/R3	10760 10790 10860 10792
Z21 multiMAUS (z21)	10835	blanc	cable	X-BUS
Z21 WLANMaus	10813	negre	WiFi	Z21 LAN

Z21 WLANmaus (z21) (10813)

Documentació

WLANmaus manuals
- Z21 WLANMAUS Manual (DE)
- Z21 WLANMAUS-firmware-restoration (EN)
Firmware
- Use Z21-WLANMAUS-Update Z21 Maintenance Tool (MS Windows)
  - heu de connectar l'ordinador a la mateixa subxarxa que el WLANMaus (proporcionada pel punt d'accés que acompanya la z21)
  - Linux
    - WINEPREFIX=~/.win_32 WINEARCH=win32 wine WlanMausUpdate.exe
      - segurament Search no funcionarà i haureu de posar manualment l'adreça IP
    - si peta, feu servir un WINEPREFIX nou de trinca
- firmware update is not possible from Android z21 «Updater»

Ús bàsic/ Basic usage:

funció	tecla
engega	OK
apaga	MENU + OK
menú	shift + MENU MENU (5s)
atura tren seleccionat	shift + STOP
atura central	STOP
F1-F10	1...0
F11-F20	shift + 1...0
F21-F31	shift + shift + 1...0
commuta entre biblioteca i ID	shift + LOCO/TURN
reset de fàbrica	shift + MENU, OK

menú:
1. LOCO
  1. NEW
  2. EDIT
  3. DELETE
  4. SEARCH
  5. SEND (cap a un altre WLANMaus)
  6. RECEIVE (des d'un altre WLANMaus)
  7. MODE
2. PROGRAM
  1. CV MODIFICATION
  2. LONG ADDRESS
  3. CV29
    - ...
  4. CV BIT
  5. MODE
    - CV (PT)
    - POM
3. SETTINGS
  1. DISPLAY
  2. USER INTERFACE
    1. LANGUAGE
    2. SCROLLING SPEED
    3. MENU-KEY TIME
    4. SPEED STEPS TIME (temps durant el qual es mostra la velocitat)
    5. CATCH SENSITIVITY
    6. FUNCTION KEYS
    7. CHILD LOCK
  3. RESET
    - ABORTl
    - SETTINGS
    - LOCO LIBRARY
    - ROUTES
    - EVERYTHING
    - CALIBRATION
  4. STOP KEY
  5. INFO
    1. MAUS VERSION
    2. WIFI VERSION
    3. LANGUAGE VERSION
    4. BATTERY VOLTAGE
    5. CONTROL CENTER
      - HARDWARE TYPE
  6. WIFI
  7. TURNOUT SWITCHING TIME
  8. TURN-OFF TIME
  9. CONTROL CENTER
4. ROUTES (fins a 10 rutes, cadascuna amb 10 desviaments)
  1. NEW
  2. EDIT
  3. DELETE
  4. SEARCH
  5. SEND
  6. RECEIVE
  7. MODE
  8. PAUSE TIME

06Estació de control / Command station#

Command stations (Rocrail)

Roco / Fleischmann Z21

	connector	ús / usage	z21 (white) (10825)	Z21 (black) (10820)	RailCom	dispositius / devices
posterior / back	Main track	decoder control decoder program (POM)	Track out / blue led	Main track	x	descodificadors mòbils (locomotora) / mobile decoders (locomotive) descodificadors estàtics (accessori) / stationary decoders (accessory) Digikeijs DR4018
	Prog Track	decoder program (PT) decoder (Zimo) firmware update (z21m)	Track out / green led	Prog track	-
	Sniff BUS	estació de control antiga / legacy command station	-	x		main track out from a legacy command station RailCom with booster Digikeijs DR5033
	B-BUS	booster	x	x	-	Booster Roco 10765 (10762) Digikeijs DR5033 (RailCom: using track sniffer port) Booster adapter Roco 10789 Braking generator: Roco 10779 + 10777 (signal module)
	L-BUS	LocoNet	-	x
	R-BUS	feedback can be configured as additional X-BUS (z21m)	x	x		Feedback modules (up to 20 devices): Roco 10787 Digikeijs DR4088RB (CS/OPTO) (initial address can be changed using z21m) DR4088 (CS/OPTO) (S88N) ... multiMAUS firmware update (z21m)
	LAN	cap al commutador de xarxa / to network switch	x	x
	CAN	CAN bus	-	x		Zimo MX32
	X-BUS	XpressNet	-	x		multiMAUS Lokmaus2 Lokmaus3 ...
frontal	X-BUS	XpressNet	x	x
frontal	X-BUS	XpressNet	x	x

Maquinari / Hardware
- Xarxa / Network
  - TP-Link TL-WR740N V4
  - Connexió sense encaminador TP-Link
    - Ordinador:
      - afegiu una adreça ip secundària a una interfície ethernet existent:
        
        sudo ip address add 192.168.0.112/24 dev enp45s0

Downloads: manuals

All connections z21 (white) (pdf)
All connections Z21 (black) (pdf)

Z21 LAN Protocol specification (en) / Z21 LAN Protokoll Spezifikation (de) (pdf)

UDP port 21105 (control application on the client), 21206

DataLen (2 bytes, little endian)	Header (2 bytes, little endian)			Request Data (n bytes) (client -> Z21) Response Data (Z21 -> client)
				X-Header	DB0	DB1	DB2	DB3	XOR
			lenz/XNetBundle.properties roco/z21/z21Bundle.properties lenz/XNetMessage.java (toMonitorString)	lenz/XNetConstants.java roco/z21/Z21Constants.java roco/z21/Z21Message.java
0xLL 0x00	2. System, status, versions	0x10 0x00	2.1 LAN_GET_SERIAL_NUMBER	- serial	- serial	- serial	- serial		-
		0x18 0x00	2.21 LAN_GET_CODE	- code (8-bit) (no_lock, start_locked, start_unlocked)
		0x1A 0x00	2.20 LAN_GET_HWINFO	- HwType (32-bit) FW Version (32-bit)	- HwType (32-bit) FW Version (32-bit)	- HwType (32-bit) FW Version (32-bit)	- HwType (32-bit) FW Version (32-bit)
		0x30 0x00	2.2 LAN_LOGOFF
		0x40 0x00	2.3 LAN_X_GET_VERSION	0x21 0x63	0x21 0x21	- 0xvv	- 0x12 (=Z21)		0x00 XOR
			2.4 LAN_X_GET_STATUS	0x21 LAN_X_STATUS_CHANGE	0x24				0x05
			2.5 LAN_X_SET_TRACK_POWER_OFF	0x21 LAN_X_BC_TRACK_POWER_OFF	0x80				0xa1
			2.6 LAN_X_SET_TRACK_POWER_ON	0x21 LAN_X_BC_TRACK_POWER_ON	0x81				0xa0
			2.7 LAN_X_BC_TRACK_POWER_OFF	0x61 (CS_INFO)	0x00 (BC_EVERYTHING_OFF)				0x61
			2.8 LAN_X_BC_TRACK_POWER_ON	0x61 (CS_INFO)	0x01 (BC_NORMAL_OPERATIONS)				0x60
			2.9 LAN_X_BC_PROGRAMMING_MODE	0x61 (CS_INFO)	0x02 (BC_SERVICE_MODE_ENTRY)				0x63
			2.10 LAN_X_BC_TRACK_SHORT_CIRCUIT	0x61 (CS_INFO)	0x08				0x69
			2.11 LAN_X_UNKNOWN_COMMAND	0x61 (CS_INFO)	0x82				E3
			2.12 LAN_X_STATUS_CHANGED	0x62 (CS_REQUEST_RESPONSE)	0x22	Status			XOR
			2.13 LAN_X_SET_STOP	0x80 LAN_X_BC_STOPPED					0x80
			LAN_X_BC_STOPPED	0x81	0x00				0x81
			LAN_X_GET_FIRMWARE_VERSION	0xF1 0xF3	0x0A 0x0A	- V_MSB	- V_LSB		0xFB XOR
	4. Conducció / Driving / Fahren		LAN_X_GET_LOCO_INFO	0xE3
			4.2 LAN_X_SET_LOCO_DRIVE	0xE4	0x1S
			4.3.1 LAN_X_SET_LOCO_FUNCTION	0xE4	0xF8
			LAN_X_LOCO_INFO	0xEF
	5. Desviaments / Switching / Schalten		LAN_X_GET_TURNOUT_INFO	0x43	FAdr_MSB	FAdr_LSB			XOR
			LAN_X_SET_TURNOUT	0x53	FAdr_MSB	FAdr_LSB	10Q0A00P
			LAN_X_TURNOUT_INFO	0x43	FAdr_MSB	FAdr_LSB	000000ZZ		XOR
			LAN_X_SET_EXT_ACCESSORY (FW>V1.40)	0x54
			LAN_X_GET_EXT_ACCESSORY_INFO (FW>V1.40)	0x44
			LAN_X_EXT_ACCESSORY_INFO (FW>V1.40)	0x44
	6. Lectura i escriptura de CV del descodificador / Reading and writing Decoder CVs / Decoder CV Lesen und Schreiben		LAN_X_CV_READ	0x23 LAN_X_BC_PROGRAMMING_MODE [LAN_X_CV_NACK_SC, LAN_X_CV_NACK, LAN_X_CV_RESULT]	0x11	CVAdr_MSB	CVAdr_LSB		XOR
			LAN_X_CV_WRITE	0x24	0x12
			LAN_X_CV_NACK_SC	0x61	0x12				0x73
			LAN_X_CV_NACK	0x61	0x13				0x72
			LAN_X_CV_RESULT	0x64	0x14	CVAdr_MSB	CVAdr_LSB	value	XOR
			LAN_X_CV_POM_WRITE_BYTE	0xE6
			LAN_X_CV_POM_WRITE_BIT	0xE6
			LAN_X_CV_POM_READ_BYTE	0xE6	0x30
			LAN_X_CV_POM_ACCESSORY_WRITE_BYTE	0xE6	0x31
			LAN_X_CV_POM_ACCESSORY_WRITE_BIT	0xE6	0x31
			LAN_X_CV_POM_ ACCESSORY_READ_BYTE	0xE6	0x31
			LAN_X_MM_WRITE_BYTE	0x24	0xFF
			LAN_X_DCC_READ_REGISTER	0x22	0x11
			LAN_X_DCC_WRITE_REGISTER	0x23	0x12
	2. System, status, versions	0x50 0x00	2.16 LAN_SET_BROADCASTFLAGS	flags	flags	flags	flags
	2. System, status, versions	0x51 0x00	LAN_GET_BROADCASTFLAGS	- flags	- flags	- flags	- flags
	3. Ajustos / Settings / Einstellungen	0x60 0x00	LAN_GET_LOCOMODE	16-bit loco address (big endian) 16-bit loco address (big endian)	16-bit loco address (big endian) 16-bit loco address (big endian)	- mode (8-bit) (DCC, MM)
		0x61 0x00	LAN_SET_LOCOMODE	16-bit loco address (big endian)	16-bit loco address (big endian)	mode (8-bit) (DCC, MM)
		0x70 0x00	LAN_GET_TURNOUTMODE	16-bit accessory decoder address (big endian) 16-bit accessory decoder address (big endian)	16-bit accessory decoder address (big endian) 16-bit accessory decoder address (big endian)	- mode (8-bit) (DCC, MM)
		0x71 0x00	LAN_SET_TURNOUTMODE	16-bit accessory decoder address (big endian)	16-bit accessory decoder address (big endian)	mode (8-bit) (DCC, MM)
	7. Feedback - R-BUS / Rückmelder – R-BUS	0x80 0x00	LAN_RMBUS_DATACHANGED
		0x81 0x00	LAN_RMBUS_GETDATA
		0x82 0x00	LAN_RMBUS_PROGRAMMODULE
	2. System, status, versionen	0x84 0x00	LAN_SYSTEMSTATE_DATACHANGED	state (current, temp, vcc...)	state (current, temp, vcc...)
	2. System, status, versionen	0x85 0x00	LAN_SYSTEMSTATE_GETDATA	- LAN_SYSTEMSTATE_DATACHANGED
	8. RailCom	0x88 0x00	LAN_RAILCOM_DATACHANGED
	8. RailCom	0x89 0x00	LAN_RAILCOM_GETDATA
	9. LocoNet (the Z21 can be used as an Ethernet/LocoNet gateway)	0xA0 0x00	LAN_LOCONET_Z21_RX	OPC: 0xBA	ARG1: 0X00	ARG2: 0X00	CKSUM
		0xA1 0x00	LAN_LOCONET_Z21_TX
		0xA2 0x00	LAN_LOCONET_FROM_LAN
		0xA3 0x00	LAN_LOCONET_DISPATCH_ADDR
		0xA4 0x00	LAN_LOCONET_DETECTOR

X-BUS tunnel
LocoNet tunnel

Monitor

Petició i resposta / Request and response:

	request					response
	DataLen	Header	Data				DataLen	Header	Data
	DataLen	Header	X-Header	DB0	XOR-Byte		DataLen	Header	X-Header	DB0	DB1	DB2	XOR-Byte
2.1 LAN_X_GET_SERIAL_NUMBER	0x04 0x00	0x10 0x00	-				0x08 0x00	0x10	32-bits serial number (little endian)
2.3 LAN_X_GET_VERSION	0x07 0x00	0x40 0x00	0x21	0x21	0x00		0x09 0x00	0x40 0x00	0x63	0x21	XBUS_VER	CMDST_ID	0x60
2.4 LAN_X_GET_STATUS	0x07 0x00	0x40 0x00	0x21	0x24	0x05	2.12 LAN_X_STATUS_CHANGED	0x08 0x00	0x40 0x00	0x62	0x22	Status		XOR-Byte
...
2.15 LAN_X_GET_FIRMWARE_VERSION	0x07 0x00	0x40 0x00	0xF1	0x0A	0xFB		0x09 0x00	0x40 0x00	0xF3	0x0A	V_MSB	V_LSB	XOR-Byte
2.19 LAN_SYSTEMSTATE_GETDATA	0x04 0x00	0x85 0x00	-			2.18 LAN_SYSTEMSTATE_DATACHANGED	...
2.20 LAN_GET_HWINFO	0x04 0x00	0x1A 0X00	-				0x0C 0x00	0x1A 0x00	HwType 32 bit (little)				FW Version 32 bit (little)
...

Broadcast (cal una subscriptció amb LAN_SET_BROADCASTFLAGS, que dura 60 segons / needs subscription with LAN_SET_BROADCASTFLAGS, which lasts for 60 seconds):

DataLen

Header

Data

X-Header

DB0

DB1

XOR-Byte

LAN_SET_BROADCASTFLAGS

driving and switching

0x00000001

2.7 LAN_X_BC_TRACK_POWER_OFF

0x07 0x00

0x40 0x00

0x61

0x00

0x61

2.8 LAN_X_BC_TRACK_POWER_ON

0x07 0x00

0x40 0x00

0x61

0x01

0x60

2.9 LAN_X_BC_PROGRAMMING_MODE

0x07 0x00

0x40 0x00

0x61

0x02

0x63

2.10 LAN_X_BC_TRACK_SHORT_CIRCUIT

0x07 0x00

0x40 0x00

0x61

0x08

0x69

2.14 LAN_X_BC_STOPPED

0x07 0x00

0x40 0x00

0x81

0x00

0x81

4.4 LAN_X_LOCO_INFO

5.3 LAN_X_TURNOUT_INFO

feedback devices

0x00000002

7.1 LAN_RMBUS_DATACHANGED

RailCom

0x00000004

8.1 LAN_RAILCOM_DATACHANGED

Z21 system status

0x00000100

2.18 LAN_SYSTEMSTATE_DATACHANGED

0x14 0x00

0x84 0x00

SystemState (16 bytes)

offset	type	name	units	desc
0		MainCurrent	mA
2		ProgCurrent	mA
4		FilteredMainCurrent	mA
6		Temperature	℃
8		SupplyVoltage	mV
10		VCCVoltage	mV
12		CentralState	bitmask
13		CentralStateEx	bitmask
14		reserved
15		Capabilities	bitmask

driving and switching (extension)

0x00010000

4.4 LAN_X_LOCO_INFO (for all locos)

LocoNet bus to LAN without locos and switches

0x01000000

LocoNet: locomotive-specific

0x02000000

LocoNet: switch-specific

0x04000000

LocoNet: track occupancy

0x08000000

RailCom to LAN client (all locomotives)

0x00040000

8.1 LAN_RAILCOM_DATACHANGED

CAN-bus occupancy to LAN client

0x00080000

10.1 LAN_CAN_DETECTOR

CAN-bus booster status

0x00020000

10.2.3LAN_CAN_BOOSTER_SYSTEMSTATE_CHGD

LAN_X_SET_TURNOUT (0x53)

53 MM LL DB2 XOR

DB2: 10Q0A00P	0	1
Q	Execute command immediately	from Z21 FW V1.24: Insert turnout command in Z21 in the queue and for spend the next possible time on the track.
A	Disable switch output	Enable switch output
P	Select output 1 of the turnout	Select output 2 of the turnout

Exemples / Examples:
- 10Q0A00P hex
  
  closed activate output 1 10001000 0x88
  
  deactivate output 1 10000000 0x80
  
  thrown activate output 2 10001001 0x89
  
  deaactivate output 2 10000001 0x81

LAN_X_TURNOUT_INFO (0x43)

43 MM LL DB2 XOR

DB2	ZZ
000000ZZ	00	turnout not switched yet
	01	turnout is in position according to switching command P=0 (output 1 of the turnout; usually closed/recte)
	10	turnout is in position according to switching command P=1 (output 2 of the turnout; usually thrown/desviat)
	11	invalid combination

Exemples / Examples:

action	command	XpressNet packet
Turnout #5, switch output 1 (usually recte/closed)	-> LAN_X_SET_TURNOUT 4,0x88 (activate output 1) <- LAN_X_TURNOUT_INFO 4,0x01 (turnout in position P=0) -> LAN_X_SET_TURNOUT 4,0x80 (deactivate output 1)	-> 53 00 04 88 xx <- 43 00 04 01 xx -> 53 00 04 80 xx
Turnout #5, switch output 2 (usually desviat/thrown)	-> LAN_X_SET_TURNOUT 4,0x89 (activate output 2) <- LAN_X_TURNOUT_INFO 4,0x02 (turnout in position P=1) -> LAN_X_SET_TURNOUT 4,0x81 (deactivate output 2)	-> 53 00 04 89 xx <- 43 00 04 02 xx -> 53 00 04 81 xx

...

	JMRI Z21 Traffic	ncat (reply is visible with: tshark -i enp4s0f2 -T fields -e data src 192.168.0.111 and port 21105)	decode (little endian)
LAN_GET_SERIAL_NUMBER	[04 00 10 00] Z21 Serial Number Request [08 00 10 00 B6 B9 01 00] Z21 Serial Number Reply. Serial Number: 113,078	`# send 4 bytes (\x04\x00) in total: echo -ne "\x04\x00\x10\x00" \| ncat -u 192.168.0.111 21105 # from tshark: 08001000b6b90100`	hex (little endian) to decimal: 00 01 b9 b6 = 113078
LAN_GET_HWINFO		`# send 4 bytes (\x04\x00) in total: echo -ne "\x04\x00\x1a\x00" \| ncat -u 192.168.0.111 21105 # from tshark: 0c001a000302000042010000`	hex (little endian): 00 00 02 03: Hardware type D_HWT_z21_SMALL 00 00 01 42: Firmware version v1.42
LAN_X_GET_STATUS		`echo -ne "\x07\x00\x40\x00\x21\x24\x05" \| ncat -u 192.168.0.111 21105# from tshark: 0800400062220040`	00: ?
LAN_SYSTEMSTATE_GETDATA		`echo -ne "\x04\x00\x85\x00" \| ncat -u 192.168.0.111 21105 # from tshark: 14008400 0000 0100 0000 1c00 5f45 5f45 00 00 00 7b`	0000: 0mA on main track 0100: 1mA on programming track 0000: 0mA smoothed current on main track 1c00: 28℃ 5f45: 17759mV supply voltage 5f45: 17759mV internal voltage 00: CentralState 00: CentralStateEx 00: reserved 7b: 01111011 capabilities

Implementacions / Implementations
- Servidor / Server
  - simulador / simulator
    - JMRI z21 simulator
  - emulador / emulator
    - z21-arduino
- Client
  - JMRI
  - Arduino
    - YuriyGorvitovskiy / ArduinoZ21Library
  - Python
    - z21-fpm / z21_python
    - Marcel van Oosterwijk
      - Connecting to the Roco Z21 via Python
        
        2.1 LAN_GET_SERIAL_NUMBER
      - Receiving Loc Information From Z21
        
        2.16 LAN_SET_BROADCASTFLAGS
      - Controlling a loc using the Roco Z21 and Python
        
        4.2 LAN_X_SET_LOCO_DRIVE
        
        4.3.1 LAN_X_SET_LOCO_FUNCTION
      - Train feedback with the Roco Z21 and Python
      - Automated shunting with the Z21 and Python
      - ...
    - Example to get the serial number:
      - import socket s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM) Z21 = ('192.168.0.111', 21105) # send packetLAN_GET_SERIAL_NUMBER command = b'\x04' + b'\x00' + b'\x10' + b'\x00' s.sendto(command, Z21) # receive and process response incomingPacket, sender = s.recvfrom(1024) print(sender) print(incomingPacket) print(incomingPacket[4:]) serialNumber = int.from_bytes(incomingPacket[4:], byteorder = 'little') print(serialNumber) s.close()

Downloads: Software and tools

Z21 (Android)
- Z21 app from FLEISCHMANN and ROCO
- Z21 App Tutorials
- Sections
  - Vehicles
  - Control Station
  - CV Programming
  - Layouts
  - Settings
    - App Settings
    - Z21 Settings (z21 must be active and connected)
      - Z21 connection
      - Z21 information
      - Z21 system state
      - Z21 common settings
        
        Activate RailCom
        
        DCC turnout addressing compliant with RCN-213
        
        Short DCC local address
        
        Output format on the track
        
        Centre stop-key
      - Z21 programming settings
    - Z21 Link
    - Z21 Updater app
  - Steering
Z21 Mobile (vell/old) (Android)
Z21 Updater (Android)
- Firmware update

z21 maintenance (MS Windows)

Manual
- Z21 Maintenance manual (V1.10) (de, pdf)
Linux (using wine 32 bit)
- WINEPREFIX=~/.win_32 WINEARCH=win32 wine Z21_Maintenance.exe

usage

Tab	Section	JMRI alternative	other
Options / WLANmaus update
Options / Loco Controller
Status	Connection IP address
	Versions Serial number Firmware version Hardware type Hardware version
	System Supply voltage Internal voltage Main track current Prog-track current Temperature
Settings	Common Settings Main track voltage Z21-stop-key Track signal type Short DCC loco-address Short circuit Main track Short circuit B-BUS activate RailCom, CV29 automatic address, supervise accessory dcoder outputs, DCC turnout-addressing according RCN-213, DCC turnout invert straight/branch, DCC read 28 instead of 14 speed steps on Sniffer BUS, Track signal on start of Z21 at STOP position
Settings	Programming Settings Programming voltage Read-mode Bit-verify with 1 Reset packets (start) Programming packets Reset packets (cont) ACK threshold
IP Settings	IP-Settings IP-Adress Subnet-Mask Standard Gateway
R-BUS	R-Bus Mode Feedback bus / XpressNet
	R-BUS Status (Roco 10787, 10808,10819)
	R-BUS Programming (Roco 10787, 10808,10819) Module address		RocRail z21
multiMAUS	Update firmware
Firmware update	Update to Z21 firmware
CV Programming	CV Programming	Decoder Pro
	CV-Set Programming

Rocrail

Programació de descodificadors / Decoder programming

	PT (Program Track)	POM (Program on Main)
via / track	tram de via aïllat / isolated track section	tot el circuit / all circuit
adreça / address	no cal especificar la loco address / no need to sepecify loco address	cal especificar la loco address / loco address must be specified
nombre de dispositius / number of devices	només un alhora / only one at once	diversos / several
lectura / read	pot llegir valors de CV / can read CV values	pot llegir valors de CV si RailCom està activat / can read CV values only if RailCom is enabled: CV28=3, CV29b3=1
z21 (white)	Track out (green led)	Track out (blue led)
Z21 (black)	Prog Track	Main Track
mobile decoder	Decoder update (Zimo)	-
static decoder (DR4018)	cal una resistència (1-C) i el led PROGRAM encès / a resistor is needed (1-C) and LED PROGRAM on	no cal cap resistència / no resistor needed

Eines / Tools

	Rocrail		Z21 Mobile
	Programming tab	Programming -> RocPro
mobile (locomotives)	x	nmra-rp922.xml	x
stationary (accessories) (e.g. DR4018)	-	dr4018.xml	POM: e.g. address=9999

07Booster#

Booster bus

Productes / Products

	bus	input power	output			auto inversion	RailCom
			power	voltage	adjustable voltage		cutout	receiver and transfer
Dijikeijs
Z21 light booster	B-BUS	10851 (20V DC, 54W)	3A	input V - 1.1V	-	x	x	-
Z21 single booster	B-BUS, CAN, CDE		3A		12-24V	x	x	CAN
Z21 dual booster	B-BUS, CAN, CDE		2x 3A		12-24V	x	x	CAN

...

08Descodificador / Decoder#

Decoder
Decoder programming with Roco z21

Tipus / Type

Mobile (locomotives)

Stationary (accessories)

Accessory addressing:

FADA	address	1	2	3	4	5	6	7	8	9	10	11	12	13	14	15	16
PADA	address	0
PADA	port	port 1		port 2		port 3		port 4		port 5		port 6		port 7		port 8
MADA	address	addr 1								addr 2
	port	port 1		port 2		port 3		port 4		port 1		port 2		port 3		port 4
	gate	0	1	0	1	0	1	0	1	0	1	0	1	0	1	0	1
NMRA	module	module 1								module 2
	port	port 0		port 1		port 2		port 3		port 0		port 1		port 2		port 3
	gate	0	1	0	1	0	1	0	1	0	1	0	1	0	1	0	1
Z21 Mobile		#1		#2		#3		#4		#5		#6		#7		#8
Z21 Mobile		1	0	1	0	1	0	1	0	1	0	1	0	1	0	1	0
Rocrail (with Z21)	address	1		2		3		4		5		6		7		8
	port
	gate (inverted)	r	g	r	g	r	g	r	g	r	g	r	g	r	g	r	g
	gate (not inverted)	g	r	g	r	g	r	g	r	g	r	g	r	g	r	g	r

Digikejs DR4018
- Outputs (la relació entre adreces i sortides es fa programant els valors de CV141-235):
  
  output
  1
  C
  2
  3
  C
  4
  5
  C
  6
  7
  C
  8
  9
  C
  10
  11
  C
  12
  13
  C
  14
  15
  C
  16
  
  OUT1
  OUT2
  OUT3
  OUT4
  OUT5
  OUT6
  OUT7
  OUT8

Funcions / Functions:

Valors per defecte / Default values

	Decoder	RN204616-7 (Railion)	Le lait (CFF/SBB)		460 019-3 "175 years of Swiss railways" (CFF/SBB)
	Fleischmann 685303	Fleischmann 721181	Fleischmann 731376		Fleischmann 731369 (Zimo sound decoder)
F0	Lights	Lights	Lights		Light on/off
F1	aux 1		Sound on	Sound on: Start, engine start, upgrade At a standstill: Motor idling On departure: Thyristors, engine revving Accelerating: Running noise, thyristors Whilst running: Running noise, thyristors When stopping: Thyristors, brake squeal Sound off: Engine stop, teardown	Driving noise on/off
F2	aux 2		Loco whistle (open line)	Horn complete	Horn high
F3	aux 3		Acoustic signal	Horn high	Horn low
F4	aux 4		Interior light	Cabin light on/off (depending on the direction of travel)	Conductor's signal
F5	Acceleration zero	Inertia	Departure signal	Shrill whistle before departure	Couple/Decouple
F6	Half speed	Shunting gear (half speed)	Inertia on/off	F6=1: no acceleration or braking inertia F6=0: acceleration and braking inertia as set by CV	Inertia on/off
F7			Compressor	Air compressor noise on/off	Curve squeaking (only if F1 is switched and the locomotive rolls)
F8			Loudspeaker message	Loudspeaker announcement (german)	Compressor on/off
F9			Shunting gear	Shunting gear on/off	Driver's cabin light for driver's cabin 1
F10			Mute	All sounds slightly fade out on/off	Driver's cabin light for driver's cabin 2
F11			Lights	Headlights cabin side 1 on/off	Announcement while driving (only with F1)
F12			Lights	Headlights cabin side 2 on/off	Light suppression, driver's cab 2
F13			Door	Cabin door closing	Light suppression, driver's cab 1
F14			Loudspeaker message	Station announcement Locarno (german)	Mute
F15			Loudspeaker message	Station announcement Bellinzona (italian + german)	Manuel fan on/off (only if F1 is active)
F16			Coupling	Coupling noises/air valve	Horn high-low
F17			Step	folding step on the buffer down/up	Doors close
F18			Heating	Noise of the heating cable	Passing train
F19			Fan	High speed fans on/off	Volume increase
F20					Volume decrease

Locomotives decoder function setup (NMRA RP 9.2.2: assigment of internal to external function)

Fleischmann 685303

key	CV	light fwd	light back	aux1	aux2	aux3	aux4	acceleration zero	half speed
F0v	33	1	2	4	8	16	32	64	128
F0r	34	1	2	4	8	16	32	64	128
F1	35	1	2	4	8	16	32	64	128
F2	36	1	2	4	8	16	32	64	128
F3	37	1	2	4	8	16	32	64	128
F4	38				1	2	4	8	16
F5	39				1	2	4	8	16
F6	40				1	2	4	8	16
F7	41				1	2	4	8	16
F8	42				1	2	4	8	16
F9	43						1	2	4
F10	44						1	2	4
F11	45						1	2	4
F12	46						1	2	4

Accessories decoder function setup

Digikeijs DR 4018:

			CV→	113	114	115	116	117	118	119	120		121	122	123	124	125	126	127	128
			output→	1	2	3	4	5	6	7	8		9	10	11	12	13	14	15	16
decoder	key (offset)	status
			CV↓/value→	1	2	4	8	16	32	64	128		1	2	4	8	16	32	64	128
first decoder	#1	on	141									142
		off	144									145
	#2	on	147									148
		off	150									151
	#3	on	153									154
		off	156									157
	#4	on	159									160
		off	162									163
	#5	on	165									166
		off	168									169
	#6	on	171									172
		off	174									175
	#7	on	177									178
		off	180									181
	#8	on	183									184
		off	186									187
	#9	on	189									190
		off	192									193
	#10	on	195									196
		off	198									199
	#11	on	201									202
		off	204									205
	#12	on	207									208
		off	210									211
	#13	on	213									214
		off	216									217
	#14	on	219									220
		off	222									223
	#15	on	225									226
		off	228									229
	#16	on	231									232
		off	234									235
second decoder	#17	on	141									142
		off	144									145
	...

Note: key/address offset is configured with PROGRAM physical button and kept in CV 513, 521 (CV1, 9 ?)

CV:

NMRA RP DCC S-9.2.2 (RP 9.2.2) RN204616-7 (Railion)
(set 931381) Re 460, Le lait (CFF/SBB) Re 460, 175 years (CFF/SBB) Digikejs

multi-function (mobile) decoder accessory (stationary) decoder Z21 signal decoder Fleischmann 685303 Fleischmann 721181 (decoder) Fleischmann 731376 (Zimo decoder) Fleischmann 731369 (Zimo decoder) DR4018

Rocrail xml nmra-rp922.xml nmra-rp922-acc.xml

JMRI xml
(JMRI/xml/decoderIndex.xml)
(JMRI/xml/decoders) JMRI/xml/decoders/nmra/ AP_DCC_Decoder
CvValues.md Fl_decoders_RailCom.xml Zimo_Unified_software_v32_MX648.xml Digirails_Stationary.xml

CV description CV CV (opt) description Name Basic value Meaning Name Basic value Meaning Name Basic value Description Name Basic value Description

1 Primary Address 1 513 Decoder Address LSB shortAddressOnly.xml
shortAndLongAddress.xml (CV17, 18) myAddrL First decoder address Loco address 3 Loco address 3 Loco address Locomotive address 3 first address offset (low byte)

2 Vstart 2 514 Auxiliary Activation vStartHighMid.xml v min 3 v min 3 Start-up voltage Start Voltage 3

3 Acceleration Rate 3 515 Time On F1 accelDecel.xml
accelDecel_31.xml
accelDecel_254.xml
accelDecel_255.xml T_on_F1 Aceleration rate 2 Acceleration inertia 2 Acceleration inertia Acceleration time 19

4 Deceleration Rate 4 516 Time On F2 T_on_F2 Deceleration rate 2 Braking inertia 2 Braking inertia Braking time 13

5 Vhigh 5 517 Time On F3 vStartHighMid.xml T_on_F3 v max 180 v max 150 Maximum voltage Top speed Vhigh 160

6 Vmid 6 518 Time On F4 T_on_F4 v mid 0 v mid 0 Middle voltage Medium speed Vmid 1

7 Manufacturer Version No. 7 519 Manufacturer Version Info mfgVersionId.xml version Manufacturer firmware version number Decoder versions no. 101 Manufacturer vesion no. 101 Manufacturer version 32 10
13

8 Manufacturer ID 8 520 Manufacturer ID VID Manufacturer identification Manufacturer ID 155 Manufacturer ID 155 Manufacturer ID 145 Manufacturer ID and HARD RESET 8=Reset 42

9 Total PWM Period 9 521 Decoder Address MSB - myAddrH Decoder address Motor control 20 Motor control 20 first address offset (high byte)

10 EMF Feedback Cutout 10 (future use) - myRSAddr

11 Packet Time-Out Value 11 ... - DelayIn1 Packet timeout 0

12 Power Source Conversion 12 - DelayIn2 Power source conversion Bit 0=1 Current type

13 Alternate Mode Function Status F1-F8 13 analogModeFunction.xml DelayIn3 Analog mode F1 up to F8 Functions F1-F8 1

analogModeFunction_F12.xml
analogModeFunction_F15.xml

14 Alternate Mode Function. Status FL,F9_F12 14 DelayIn4 Analog mode F9 up to F12 and frontlight Functions F0, F9-F12 195

15 Decoder Lock 15 - DelayIn5

16 16 decoderLockId16.xml DelayIn6

17 Extended Adddress 17 shortAndLongAddress.xml DelayIn7 Extended address (upper section) 192 Extended address (upper section) Long address (upper section)

18 Extended Adddress 18 - DelayIn8 Extended address (lower section) 0 Extended address (lower section) Long address (lower section)

19 Consist Address 19 consistAddrDirection.xml CmdStation

20 (reserved for future use) 20 - RSFEC

21 Consist Addr Active for F1-F8 21 cv21_lsb.xml
cv21_lsb_MRC.xml SkipUnEven

cv21.22.xml
cv21.22_F12.xml
cv21.22_F15.xml

22 Consist Addr Active for FL-F9-F12 22 RSParity

23 Acceleration Adjustment 23 consistAccelDecelSigned.xml Search

24 Deceleration Adjustment 24 RSPulsCount

25 Speed Table/Mid-range Cab Speed Step 25 - Restart

26 (reserved for future use) 26 ... - DccQuality

27 Decoder Automatic Stopping Configuration 27 (future use) - DecType

28

Bi-Directional Communication Configuration (RailCom):

bit	value	description	0	1
0	1	unsolicited decoder initiated trasmission	disabled	enabled
1	2	initiated broadcast transmission using asymmetrical DCC signal	disabled	enabled
2	4	initiated broadcast transmission using signal controlled influence signal	disabled	enabled
3-7		reserved for future use

28

540

Bi-Directional Communication Configuration:

bit	desc	0	1
0	unsolicited decoder initiated transmission	disabled	enabled
1	(not used)
2-5	(future use)
6-7	flag bits (future use)

-

RailCom

RailCom configuration

RailCom configuration (not working!?):

bit	value		0	1
0	1	RailCom channel 1 (Broadcast)	off	on
1	2	RailCom channel 2 (Data)	off	on

3

RailCom configuration (not working!?)

RailCom configuration (working)

RailCom configuration

3

29

Configuration Data 1:

bit	value	description	0	1
0	1	locomotive direction (`CV29_LOCO_DIR`)	normal	reversed
1	2	FL location (`CV29_F0_LOCATION`)	bit 4 in speed and direction instructions control FL	bit 4 in function group one instruction controls FL
2	4	Power source conversion (`CV29_APS`)	NMRA digital only	Power source conversion enabled (see CV12)
3	8	Bi-directional communications (see S-9.3.2) (see CV28) (`CV29_ADV_ACK`)	disabled	enabled
4	16	Speed table (`CV29_SPEED_TABLE_ENABLE`)	set by CV 2, 5, 6	set by CV 66-95
5	32	addressing (`CV29_EXT_ADDRESSING`)	one byte addressing (in CV1)	two bytes addressing (in CV17,18)
6	64	(reserved for future use)
7	128	Accessory decoder (`CV29_ACCESSORY_DECODER`)	Multifunction decoder	Accessory decoder (see CV 541)

29

541

Accessory Decoder Configuration:

bit	value	desc	0	1
0-2		(future use)
3	8	bi-directional communications (`CV29_ADV_ACK`)	disabled	enabled
4		(future use)
5	32	decoder type (`CV29_EXT_ADDRESSING`)	basic	extended
6	64	addressing method (`CV29_OUTPUT_ADDRESS_MODE`)	decoder address (board addressing mode) (9-bit)	output address (output addressing mode) (`FLAGS_OUTPUT_ADDRESS_MODE`) (11-bit)
7	128	accessory decoder (`CV29_ACCESSORY_DECODER`)	multifunction decoder (see CV29)	accessory decoder (`FLAGS_DCC_ACCESSORY_DECODER`)

cv29direction.xml (bit 0)
cv29speedSteps.xml (bit 1)
cv29analog.xml (bit 2)
cv29RailCom.xml (bit 3)
cv29AdvAck.xml (bit 3)
cv29table1-28.xml (bit 4)
cv29table3-28.xml (bit 4)
shortAndLongAddress.xml (bit 5) (also: CV...)

Config

Decoder configuration

Configuration variable

Bit 0=0
...

Configuration values

Basic configuration

14

30 Error information 30 (future use) - VID_2 Error information 0 Error information

31 Index High Byte 31 Indexes Area Pointer - ParityErrors

32 Index Low Byte 32 Indexes Area Pointer - PulseErrors

33 Output Loc. FL(f), FL(r), F1-F12 Manufacturer Unique functionmap.xml F0v 1 Light forwards

34 ... F0r 2 Light backwards

35 F1 4 Aux 1

36 F2 8 Aux 2

37 F3 16 Aux 3

38 F4 4 Aux 4

39 39 DCC addressing mode F5 8 Acceleration zero

40 40 Number of signals F6 16 Half speed

41 41 Signal-ID for signal 1 F7 32

42 42 Signal-ID for signal 2 F8 64

43 43 Signal-ID for signal 3 F9 16

44 44 Signal-ID for signal 4 F10 32

45 45 Initialisation signal 1 F11 64

46 46 Initialisation signal 2 F12 128

47 Manufacturer Unique 47 - Initialisation signal 3

51 cv51_DirectionalHeadlights.xml (bit 0) Individual FLEISCHMANN settings Individual FLEISCHMANN functions

60 - Light dimming

64 64 - Current DCCext value of signal 4 RESET RESET

65 Kick Start 65 kickStart.xml
kickStart_63.xml Current number of the signal aspect from signal 1

66 Forward Trim 66 ... fwdTrim.xml
fwdTrim128.xml Forward trim 248 Forwards trim Speed adjustation, forward

67-81 Speed Table Manufacturer Unique - 67: Current number of the signal aspect from signal 3 Adjustment of control characteristic curve of controller Adjustment of control characteristic curve of controller Modification of the regulation characteristic of the control unit

82-94 Speed Table (future use)

95 Reverse Trim ... revTrim.xml
revTrim128.xml Backwards trim 248 Backwards trim Speed adjustation, backward

96-104 (reserved for future use) -

105 User Identifier 1 userId.xml User variables 0

106 User Identifier 2 ... User variables 0

107-111 (future use) (future use) -

112-256 Manufacturer Unique Manufacturer Unique - 211
250: Decoder type (37 = ROCO 10387) 250: Configuration values (only Motorola)

257-512 Indexed Area Indexed Area - 266: Volume 0=low up to 255=loud CV266: Total volume
CV287: Threshold
for
brake squeal CV266: 80
CV287: 35

513-879 (future use) Manufacturer Unique (CV opt) -

880-891 (future use) ... -

892 Decoder Load -

893 Dynamic Flags -

894 Fuel/Coal ... -

895 Water Manufacturer Unique (CV opt) -

896-1024 SUSI Sound and Function Modules (future use) -

...

09Retorn / Feedback#

Bidireccional
- Bus bidireccional

Detecció / Detection

Bus de detecció / Detection bus

Productes / Products

	BUS	number inputs	RailCom
Digikeijs DR4088	R-BUS	16 opto (OPTO model) / 16 current (CS model)
Roco Feedback module (10787)	R-BUS	8 opto
Roco Z21 Detector (10808) (z21.eu)	CAN, R-BUS	8 current	CAN only
Roco Z21 Detector x16 (10819) (z21.eu)	R-BUS	16 current

Roco 10787 (discontinued)
- pdf
- ...

10Comercial / Commercial#

Digikeijs

		Digikeijs	Decoders.es	Tren Castilla	Zaratren
Decoder	DR4018	32,49€	27,95€	28€	32,50€
Feedback	DR4088RB-CS	59,95€	58,90€	-	59.95€
	DR4088-CS (S88N)	49,95€	48,90€	49€	49,95€
	DR4088RB-OPTO	59,95€	-	-	-
	DR4088OPTO	44,95€	38€	-	-
Loop	DR410	59,95€ (out of stock)	-	58€	-
	enviament (normal/0€)	20€/>150€	4,60€/?	6€/?	.../>100€

11Digikeijs DR4018 16-channel switch decoder (stationary DCC decoder)#

...

Info

Config file for Rocrail
- decspecs/digikeijs/dr4018.xml
Digikeijs DR4018 16-channel switch decoder
- DR4018 Manuals
Controlador de accesorios Digikeijs DR4018: Guía rápida de puesta en marcha
Decóder accesorios DIGIKEIJS DR4018. CASO PRÁCTICO: conexión señal 2 aspectos
Notes:
- Default loco (extended) address (used when asked by POM config) for the decoder is 9999 (specified in CV17-18; bit 5 to 1 in CV29 indicates to use extended address instead of loco address in CV1)
- It has up to 16 addresses / keys
  - like a double canonical accessory decoder: 2 * (9-bit accessory decoder address + 2-bit subaddress + 1-bit output [2 solenoids])
- Default first accessory address for output 1 is 5. This can be changed by using the physical button ("PROGRAM") in the unit
  - Offset value is stored in CV 513,521
- Mapping from function key (address in control unit) to outputs is specified by CV141-235. By default: key 1 ON/OFF controls outputs 1,2; key 2 ON/OFF controls outputs 3,4; ... key 8 ON/OFF controls outputs 15,16.
- Outputs are configured by CV113-128
  - additional values (pulse duration) in CV238-253
- (optional) 4 Signals setup
  - type: CV131-134
  - mapping to group of outputs: CV143, 167, 191, 215
- to facilitate setup, some presets can be called by using CV47

Ús amb estacions de control / Usage with command stations

default configuration: basic accessory decoders
DCC++ EX
- reset factory defaults (set CV8=8):
  - press PROGRAM physical button: red led on
  - <w 9999 8 8>
  - press PROGRAM physical button: red led off
- ...

z21

Digikeijs DR4018 with Z21 (translation from pdf v1.34 in dutch, p34)

Programming Start Address (1st Address / Key) (accessory address, specified as AAAAAAAAA in accessory decoders)
- Option 1: via CV 513,521
  - set offset value in CV513/CV521. See examples there.
  - NOTE: maximum accessory address is 2048. If first address of the module is set to 2048, this will be the only available address. Other outputs will not work.
- Option 2: manually

CV programming

	POWER SIGNAL	write	read
POM	can be different	PROGRAM (not working?)	-
PT	must be the same	PROGRAM + resistor	PROGRAM + resistor

CV programming via POM (Program On Main). CV values cannot be read. To read them, use PT instead. In the following example we will program the DR4018 on preset 0 through CV47.
- escriptura / write
  1. Connect the DR4018 to the "Main Track" / "Track out" of your z21
  2. Program Set the desired CV
    - using the Z21 application (Android) (you can monitor the commands with JMRI "Z21 Traffic"):
      1. (not needed) Vehicles (if you do not register 9999 loco/accessory, POM will not work)
        
        + Accessory
        
        Loco address: 9999
        
        Would you like to change the address of loco 3 to 3 in the decoder? Program (POM)
        
        no cal que PROGRAM estigui encès / no need to be PROGRAM led on
        
        Note: if this question does not appear:
        
        Settings -> App Settings -> Advanced Settings
        
        Programming in railway vehicles settings: on
      2. CV Programming
        
        Manual
        
        Program On Main (POM)
        
        Loco address: 9999
        
        CV address: 47
        
        4 (2 groups with 8x Fluorescent lamp)
        
        Set CV
        
        may not work at the first time; try again (to be sure, monitor the commands with JMRI "Z21 Traffic")
        
        NOTE: don't worry about the message "Could not read CV value for selected loco address or CV address"; it is due to the lack of RailCom feedback.
    - using JMRI:
      1. ...
  3. Press once the switch of the DR4018. The red LED lights up.
  4. Press the "Program" button in the Z21 application
  5. Press once the switch of the DR4018. The red LED goes out.
  6. The DR4018 will now save the settings and apply them. The effect of the programmed settings are now immediately visible.
  7. Personal note: To program another CV, go back and enter "Program on Main" again (if not doing so, sometimes programming another value does not work)
CV programming via PT (Program Track):
- escriptura / write
  - es poden escriure els valors dels CV / CV values can be written
- lectura / read
  - es poden llegir els valors dels CV / CV values can be read (e.g. with Z21 app, JMRI)
  - per a un ús més fàcil, sense haver de connectar cap resistència, feu servir POM / for an easier usage, without using a resistor, use POM
  - connecteu una resistència (150-270Ω) entre output 1 i C / connect a resistor (150-270Ω) between output 1 and C
  - premeu el botó PROGRAM (el led es posarà vermell) / press PROGRAM button (led will turn red)
Reset the module to factory settings using POM programming
1. Connect the DR4018 to the "Main Track" / "Track out" of your Z21
2. Program the desired CV using the Z21 application:
  1. Programming
  2. PROGRAM ON MAIN
    - Loco-Address: 9999
    - CV-Number: 8
    - CV-Value: 8 (Reset)
3. Press once the switch of the DR4018. The red LED turns on.
4. Press the "Program" button in the Z21 application
5. Press once the switch of the DR4018. The red LED turns off.
6. It is important when carrying out a RESET that the module is now disconnected from the power.
  Disconnect both the power and the signal inputs and wait for 3 to 5 seconds.

group

CV

description

info

range

value

1

Loco address (1-127)

(not used, because bit 5 of CV29 is set to 1 => extended address is used instead)

7

Version of the decoder

-

134

8

Manufacturer ID

Writing the value “8” will reset the decoder to its factory settings (CV513=4, CV521=0)

-

42

Extended address (128-9999)

17

Extended Address high byte (two most significant bits are always 11)

11xx xxxx (e.g. CV17=231, CV18=15 -> extended address.: (231-192)*256 + 15 = 9999)

192-255

231 (b1110 0111)

18

Extended Address low byte

yyyy yyyy

0-255

15 (b0000 1111)

29

Configuration Data

bit	function	default	value
0
1
2
3
4
5	'0' = one byte addressing (address in CV1) '1' = two byte addressing (also known as extended addressing, ad- dress in CV17 and 18)	0	32

98 (b0110 0010)

presets (write only)

47

IMPORTANT: This CV is not readable as entered values will not be stored, rather the entire decoder will be configured according to the preset selected.

			output
preset	function	no. of addresses / keys	1	2	3	4	5	6	7	8	9	10	11	12	13	14	15	16
0	8x Turnout with twin-coil motor	8	1		2		3		4		5		6		7		8
1	16x permanent on/off switch	16	1	2	3	4	5	6	7	8	9	10	11	12	13	14	15	16
2	8x two-light signal with fade effect	8	1		2		3		4		5		6		7		8
3	8x AHOB	8	1		2		3		4		5		6		7		8
4	2 groups with 8x Fluorescent lamp	2	1								2
5	1 x 16 output with Fluorescent lamp	1	1
6	8x Turnout motor control	8	1		2		3		4		5		6		7		8
7	4x Dutch three-light signal (CV131-134: 1)	4	1				2				3				4
8	4x DB Main signal (CV131-134: 2)	4	1				2				3				4
9	4x DB pre-signal associated with main signal (CV131-134: 3)	4	1				2				3				4
10	2x Combination of DB Main signal and pre-signal	4	1				2				3				4
11	4x DB Pre-signal (CV131-134: 4)	4	1				2				3				4
12	4x NMBS Main signal (CV131-134: 5)	4	1				2				3				4
13	8x Turnout control with time limit	8	1		2		3		4		5		6		7		8

0-13

n/a

107

Dark time between signal transitions

1-255

70

108

Value to dim intensity of signal (night mode)

0-15

10

109

PWM Period

The resolution with which the internal PWM operates to achieve effects and dim -values

1-255

14

111

Fade Speed

The speed with which the outputs configured for fading will fade in and fade out (bit 4 in output configuration CV113-128)

1-255

3

112

Blink rate

The speed with which the outputs configured for blinking will blink (bit 5 in output configuration CV113-128)

1-255

183

output configuration

1

113

Output Configuration 1

bit	function		default	value
0-3	Intensity of the output.	Also called dimmer. Where 0 is completely off and 15 completely on.	15	0-15
4	Fade in and fade out effect.	"0" = no fading "1" = fading active. Fade speed is controlled by CV111	0	16
5	Blink effect	"0" = no blinking "1" = blinking active. Blink rate iscontrolled by CV112	0	32
6	Random effect	"0" = random off "1" = random active. Combined with bit 4 (fade) the lights start with a flash, after which they slowly fade in. Note: The intensity value should be max. 14 for this effect to work.	0	64
7	Pulse	0 = continuous 1 = pulse Length is set via CV 238 through 253, when combined with bit 5 the output blinks, but with inverted phase	1	128

0-255

143
(b1000 1111)

2

114

Output Configuration 2

3

115

Output Configuration 3

4

116

Output Configuration 4

5

117

Output Configuration 5

6

118

Output Configuration 6

7

119

Output Configuration 7

8

120

Output Configuration 8

9

121

Output Configuration 9

10

122

Output Configuration 10

11

123

Output Configuration 11

12

124

Output Configuration 12

13

125

Output Configuration 13

14

126

Output Configuration 14

15

127

Output Configuration 15

16

128

Output Configuration 16

Signal

1

131

Type of signal #1 (linked group of 4 outputs is specified in CV143)

If the CV contains a value different than 0 all its controlled outputs will switch according to the signal rules. The other CVs that normally control the outputs will be deactivated.

value ->				0	1	2	3	4	5
used by preset (CV47) ->					7	8	9	11	12
function ->				No Signal	Dutch (NS railways) (3-aspect + digit board)	DB_HP (German main signal)	DB_VRHP (German front and main signal)	DB_VR (German front signal)	NMBS (Belgium railways)
address
1st	2nd	3rd	4th
R	R	R	night dimming		Red	HP0	Off	VR0	Red
G	R	R			Green	HP1	VR0	VR1	Flashing red
R	G	R			Yellow	HP2	VR0	VR2	Double yellow
G	G	R			Flashing green with digit	SH1	Off	Off	Flash double yellow
R	R	G			Yellow with digit	HP1	VR1	VR0	Green yellow horiz.
G	R	G			Flashing green	HP2	VR1	VR1	Green
R	G	G			Flashing yellow	HP1	VR2	VR2	Flashing green
G	G	G			Yellow with flashing digit	HP2	VR2	Off	Green yellow vertical

0-5

0

2

132

Type of signal #2 (linked group of 4 outputs is specified in CV167)

3

133

Type of signal #3 (linked group of 4 outputs is specified in CV191)

4

134

Type of signal #4 (linked group of 4 outputs is specified in CV215)

Switching function keys in control unit
(see table in p16 in pdf)
(see address-output)

group A (1-8)

group B (9-16)

	outputs group A (1-8) and group B (9-16)
	1 \| 9	2 \| 10	3 \| 11	4 \| 12	5 \| 13	6 \| 14	7 \| 15	6 \| 16
value:	1	2	4	8	16	32	64	128

1st address (Function Key 1)

ON

141

142

value contained in CV141 specifies which outputs in group A are activated when key 1 is pressed ON.
value contained in CV142 specifies which outputs in group B are activated when key 1 is pressed ON.
E.g.:
- to activate outputs 2 and 5 when key 1 is ON:
  - set CV141 to 2+16=18

OFF

144

145

2nd address (Function Key 2)

ON

147

148

OFF

150

151

3rd address (Function Key 3)

ON

153

154

OFF

156

157

4th addresss (Function Key) 4

ON

159

160

OFF

162

163

5th address (Function Key 5)

ON

165

166

OFF

168

169

6th address (Function Key 6)

ON

171

172

OFF

174

175

7th address (Function Key 7)

ON

177

178

OFF

180

181

8th address (Function Key 8)

ON

183

184

OFF

186

187

9th address (Function Key 9)

ON

189

190

OFF

192

193

10th address (Function Key 10)

ON

195

196

value contained in CV195 specifies which outputs in group A are activated when key 10 is pressed ON.
value contained in CV196 specifies which outputs in group B are activated when key 10 is pressed ON.
E.g.:
- to activate outputs 1 and 15 when key 10 is ON:
  - set CV195 to 1
  - set CV196 to 64

OFF

198

199

11th address (Function Key 11)

ON

201

202

OFF

204

205

12th address (Function Key 12)

ON

207

208

OFF

210

211

13th address (Function Key 13)

ON

213

214

OFF

216

217

14th address (Function Key 14)

ON

219

220

OFF

222

223

15th address (Function Key 15)

ON

225

226

OFF

228

229

16th address (Function Key 16)

ON

231

232

OFF

234

235

SIGNAL

1

143

Group of outputs coupled to SIGNAL 1

	outputs
	1-4	5-8	9-12	13-16
value:	1	2	4	8

1

2

167

Group of outputs coupled to SIGNAL 2

2

3

191

Group of outputs coupled to SIGNAL 3

4

215

Group of outputs coupled to SIGNAL 4

8

Pulse time for OUTPUT ...

1

238

Pulse time OUTPUT 1

bit 7 in output 1 configuration (CV113)

2

239

Pulse time OUTPUT 2

bit 7 in output 2 configuration (CV114)

3

240

Pulse time OUTPUT 3

bit 7 in output 3 configuration (CV115)

4

241

Pulse time OUTPUT 4

bit 7 in output 4 configuration (CV116)

5

242

Pulse time OUTPUT 5

bit 7 in output 5 configuration (CV117)

6

243

Pulse time OUTPUT 6

bit 7 in output 6 configuration (CV118)

7

244

Pulse time OUTPUT 7

bit 7 in output 7 configuration (CV119)

8

245

Pulse time OUTPUT 8

bit 7 in output 8 configuration (CV120)

9

246

Pulse time OUTPUT 9

bit 7 in output 9 configuration (CV121)

10

247

Pulse time OUTPUT 10

bit 7 in output 10 configuration (CV122)

11

248

Pulse time OUTPUT 11

bit 7 in output 11 configuration (CV123)

12

249

Pulse time OUTPUT 12

bit 7 in output 12 configuration (CV124)

13

250

Pulse time OUTPUT 13

bit 7 in output 13 configuration (CV125)

14

251

Pulse time OUTPUT 14

bit 7 in output 14 configuration (CV126)

15

252

Pulse time OUTPUT 15

bit 7 in output 15 configuration (CV127)

16

253

Pulse time OUTPUT 16

bit 7 in output 16 configuration (CV128)

Primary address (first accessory address)

513

Primary Address (start address) (first accessory address LSB) Low

CV521	CV513	first accessory address = CV521*256 + CV513 + 1
0	0	1
0	1	2
0	2	3
0	3	4
0	4	5 (?default; after reset by sending CV8=8)
...
0	255	256
1	0	257
1	1	258
...
7	254	2047
7	255	2048

4

521

Primary Address (start address) (first accessory address MSB) High

0

				group A									group B
		output →		1	2	3	4	5	6	7	8		9	10	11	12	13	14	15	16
		CV for output configuration →		113	114	115	116	117	118	119	120		121	122	123	124	125	126	127	128
		value →		1	2	4	8	16	32	64	128		1	2	4	8	16	32	64	128
Address / Key			CV ↓									CV ↓
1st Address / key	on (1)		141									142
1st Address / key	off (0)		144									145
2nd Address / key	on (1)		147									148
2nd Address / key	off (0)		150									151
3rd Address / key	on (1)		153									154
3rd Address / key	off (0)		156									157
4th Address / key	on (1)		159									160
4th Address / key	off (0)		162									163
5th Address / key	on (1)		165									166
5th Address / key	off (0)		168									169
6th Address / key	on (1)		171									172
6th Address / key	off (0)		174									175
7th Address / key	on (1)		177									178
7th Address / key	off (0)		180									181
8th Address / key	on (1)		183									184
8th Address / key	off (0)		186									187
9th Address / key	on (1)		189			x						190
9th Address / key	off (0)		192				x					193
10th Address / key	on (1)		195									196
10th Address / key	off (0)		198									199
11th Address / key	on (1)		201									202
11th Address / key	off (0)		204									205
12th Address / key	on (1)		207									208
12th Address / key	off (0)		210									211
13th Address / key	on (1)		213									214
13th Address / key	off (0)		216									217
14th Address / key	on (1)		219									220
14th Address / key	off (0)		222									223
15th Address / key	on (1)		225									226	x	x
15th Address / key	off (0)		228									229			x
16th Address / key	on (1)		231									232
16th Address / key	off (0)		234									235

Examples
- when address/key #9 is on/green, move a turnout (connected to outputs 3,C,4) to right position; when address/key #9 is off/red move it to turn position
  - key #9
    - on: set CV189 to 4 (activate output 3)
    - off: set CV192 to 8 (activate output 4)
  - outputs:
    - output 3: set CV115 to 10001111=143 (pulse, highest intensity)
    - output 4: set CV116 to 10001111=143 (pulse, highest intensity)
- when address/key #15 is on/green, activate a solid green led connected to output 9 and a blinking yellow led connected to output 10; when off, activate a solid red led, connected to output 11:
  - key #15
    - on: set CV226 to 1+2=3
    - off: set CV229 to 4
  - outputs:
    - output 9 (green led): set CV121 to 00011111=31 (fade,highest intensity)
    - output 10 (yellow led): set CV122 to 00111111=63 (blinking,fade,highest intensity)
    - output 11 (red led): set CV123 to 00011111=31 (fade,highest intensity)

12Digikeijs DR4088 ( feedback module )#

...

Variants:

	bus	type
DR4088RB-CS	R-BUS	current detection (no RailCom?)
DR4088-CS	S88N (can be connected to a RB-CS unit)	current detection
DR4088RB-OPTO	R-BUS	sensor detection

DR4088RB (R-BUS)
- Identical to Roco 10787 (pdf)
- Setup start address
  - Notes:
    - PAY ATTENTION! According to the R-BUS standard is mandatory to always start at address 1. You can
      not choose any address.
    - Important! The DR4088RB feedbacks are equipped with 16 feedback points. This means
      that each module uses two addresses. A second DR4088RB feedback unit must begin
      with address 3.
  - Steps using "Z21 Maintenance Tool"
    1. Connect DR4088RB feedback unit as the only feedback module to the central z21 use hard
      del a Loconet or R BUS cable.
    2. Open "Z21 Maintenance Tool" (Android app)
    3. Go to the "R-BUS" and enter in Module address tab in the number 1.
    4. Press the 'Assign' button in the "Z21 Maintenance Tool" application.
    5. The application now asks to disconnect the feedback module.
      Disconnect the DR4088RB NOT from the z21 in this case! But once the pressure
      Program Button on the DR4088RB. The green LED briefly pulsate.
    6. Press OK
    7. Then the next screen where you press OK.
    8. The DR4088RB feedback has received the address and stored.
      The green LED flashes again in normal mode.
- The module give an address
  In the following order, you can DR4088RB feedback module includes a start address.
  PAY ATTENTION! According to the R-BUSTM standard is mandatory to always start at address 1. You can
  not choose any address.
  Important! The DR4088RB feedbacks are equipped with 16 feedback points. This means
  that each module uses two addresses. A second DR4088RB feedback unit must begin
  with address 3.
  1. Connect DR4088RB feedback unit as the only feedback module to the central z21TM use hard
  del a LoconetTM or R BUSTM cable.
  2. Open Z21TM Maintenance Tool
  3. Go to the "R-BUS" and enter in Module address tab in the number 1.
  4. Press the 'Assign' button in the Z21TM Maintenance Tool application.
  5. The application now asks to disconnect the feedback module.
  Disconnect the DR4088RB NOT from the z21 in this case! But once the pressure
  Program Button on the DR4088RB. The green LED briefly pulsate.
  5. Press OK
  6. Then the next screen where you press OK.
  7. The DR4088RB feedback has received the address and stored.
  The green LED flashes again in normal mode.

13Z21 signal DECODER#

Z21 signal DECODER (10837)
- Signal types according to countries with Z21 signal DECODER
- Z21 signal DECODER Manual (DE, EN, FR) (pdf)

Assignment (Appendix A - Signal configuration "Universal")

terminal	assignment (LED)	note
1	red	red light for stop
2	red	second red stop
3	green	green light for proceed
4	yellow orange	yellow light for proceed with speed limit
5	white orange	additional lamps for cancellation of the movement or shunting prohibited
6	white	possibility for the connection of a speed or direction display
7	green	second green light
8	reserved

Signal aspects (vegeu/see: Senyalització / Signalling) (Appendix A - Signal configuration "Universal")

DCC ext	DCC basic (G=straight; R=branch)	Name	Description	proposal for ADIF
0	1R	Stop	Absolute stop	FF7
4	2G	Go 40	Proceed with limit 40 km/h	FF3
6	3R	Go 60	Proceed with limit 60 km/h
16	1G	Go	Clear	FF1A
65	2R	Shunt go	Shunting allowed	FF8
66			Dark switching (e.g. light distant signals)
68	4R	Warning
69	3G	Substitution	Substitution signal (permits trains to pass)
70	4G	Blink

CV

description

range

default

#1

First decoder address

#7

Manufacturer firmware version number

#8

Manufacturer identification

#9

Decoder address

0-7 (read only)

#28

RailCom configuration

#29

Decoder configuration

#39

DCC addressing mode

#40

Number of signals

2,3,4

2

#41

Signal-ID for signal 1

0-255

value	hex	name (Appendix B - Signal configurations)
64	0x40	4 single LEDs
65	0x41	4 fading LEDs
67	0x43	4 running lights
71	0x47	Universal
72	0x48	Universal #2 (red flashing for Substitution)
73	0x49	Railway crossing
77	0x4d	Roco 10777
160-170	0xa.	(AT) ÖBB
176-177	0xb.	NS
192-205	0xc.	(CH) SBB
208-221	0xd.	(DE) DB
	0xe.	(ES) ADIF
240-244	0xf.	(FR) SNCF

71 (Universal)

#42

Signal-ID for signal 2

#43

Signal-ID for signal 3

#44

Signal-ID for signal 4

#45

Initialisation signal 1

0-255

255

#46

Initialisation signal 2

#47

Initialisation signal 3

#48

Initialisation signal 4

#61

Current DCCext value of signal 1

#62

Current DCCext value of signal 2

#63

Current DCCext value of signal 3

#64

Current DCCext value of signal 4

#65

Current number of the signal aspect from signal 1

#66

Current number of the signal aspect from signal 2

#67

Current number of the signal aspect from signal 3

#68

Current number of the signal aspect from signal 4

#211

DCCbasic / DCCext mapping for Signal 1, 1R

0..254: explicit specification through user
255: specification in accordance with signal configuration

255

#212

DCCbasic / DCCext mapping for Signal 1, 1G

#213

DCCbasic / DCCext mapping for Signal 1, 2R

#214

DCCbasic / DCCext mapping for Signal 1, 2G

#221-#224

DCCbasic / DCCext mapping for Signal 2

#231-#234

DCCbasic / DCCext mapping for Signal 3

#241-#244

DCCbasic / DCCext mapping for Signal 4

#250

Decoder type (37 = ROCO 10387 Z21 signal DECODER)

read only

37

14YaMoRC#

Config
- YD9100 (USB)
  - ID 0403:6015 Future Technology Devices International, Ltd Bridge(I2C/SPI/UART/FIFO)
  - YD-Command
  - Linux (wine32)
    - Instal·lació / Installation
      - ...
    - Comunicació sèrie / Serial communication
      - /dev/ttyUSB0
    - Execució / Run
      - cd ~/.toto_win_32/drive_c/YaMoRC/YaMoRC Configuration and Drivers/Config
      - WINEPREFIX=~/.toto_win_32 WINEARCH=win32 wine YD9100.exe

http://www.francescpinyol.cat/.html
Primera versió: / First version: 9.V.2015
Darrera modificació: 7 de desembre de 2025 / Last update: 7th December 2025

Cap a casa / Back home.

		10Q0A00P	hex
closed	activate output 1	10001000	0x88
closed	deactivate output 1	10000000	0x80
thrown	activate output 2	10001001	0x89
thrown	deaactivate output 2	10000001	0x81

key	CV	light fwd	light back	aux1	aux2	aux3	aux4	acceleration zero	half speed
F0v	33	1	2	4	8	16	32	64	128
F0r	34	1	2	4	8	16	32	64	128
F1	35	1	2	4	8	16	32	64	128
F2	36	1	2	4	8	16	32	64	128
F3	37	1	2	4	8	16	32	64	128
F4	38				1	2	4	8	16
F5	39				1	2	4	8	16
F6	40				1	2	4	8	16
F7	41				1	2	4	8	16
F8	42				1	2	4	8	16
F9	43						1	2	4
F10	44						1	2	4
F11	45						1	2	4
F12	46						1	2	4

key	CV	light fwd	light back	aux1	aux2	aux3	aux4	acceleration zero	half speed
F0v	33	1	2	4	8	16	32	64	128
F0r	34	1	2	4	8	16	32	64	128
F1	35	1	2	4	8	16	32	64	128
F2	36	1	2	4	8	16	32	64	128
F3	37	1	2	4	8	16	32	64	128
F4	38				1	2	4	8	16
F5	39				1	2	4	8	16
F6	40				1	2	4	8	16
F7	41				1	2	4	8	16
F8	42				1	2	4	8	16
F9	43						1	2	4
F10	44						1	2	4
F11	45						1	2	4
F12	46						1	2	4

key	CV	light fwd	light back	aux1	aux2	aux3	aux4	acceleration zero	half speed
F0v	33	1	2	4	8	16	32	64	128
F0r	34	1	2	4	8	16	32	64	128
F1	35	1	2	4	8	16	32	64	128
F2	36	1	2	4	8	16	32	64	128
F3	37	1	2	4	8	16	32	64	128
F4	38				1	2	4	8	16
F5	39				1	2	4	8	16
F6	40				1	2	4	8	16
F7	41				1	2	4	8	16
F8	42				1	2	4	8	16
F9	43						1	2	4
F10	44						1	2	4
F11	45						1	2	4
F12	46						1	2	4