Common Registers

From C-Labs Home

Contents 1 Registers 1.1 Registers Attributes 2 PHY Registers (0..7) 3 MAC Registers (8..39) 4 NET Registers (40..47) 5 WINE Application Registers (48..63) 6 APP Registers (64..447) 7 RESERVED Registers (448..511)

Registers

Register are segmented following the OSI layers, so register map has a Start and an End.

This register map refers to WINE Version 3.

Back to Data_Registers.

Start	End	Layer	Remarks
0	0	NONE	Error register
1	7	PHY	Diagnostics and settings from/to HW
8	39	MAC	Diagnostics, commands or events from MAC Layer
40	47	NET	Diagnostics, commands or events from NET Layer
48	63	NAP	Network-to-Application
64	511	APP	Application (custom)

Registers Attributes

Registers has several attributes:

• [R]ead, register can be read;
• [W]rite, register can be written;
• [E]vent, register is sent once;
• [O]nly, with [R,W,E] indicates unique option.

In other words, RO means “Read Only”, while RW means “Read & Write”.

PHY Registers (0..7)

Reg#	WORD		Units	Mode	Description
	HI	LO
0	ERR			RO	Error cause (Internal Use Only)
1	RST			RO	Reset/Restart cause
2	CLASS			RO	Unique Device Class / Manufacturer0xFFFF: Undefined / Proprietary
3	TYPE			RO	Unique Device Type0xFFFF: Undefined / Proprietary
4	RODATA			RO	48 bytes ROM vector data
5	COMMAND			WO	Bit Mapped (1/0): BIT0 → Force Update (write) Flash Memory BIT1 → Test mode set (nodes only) BIT2 → Rescan Network Write 0x0000 to stop commands.
6	SIGNATURE			RW	Device signature vector. Contains calibration data, so may differ from device to device.

MAC Registers (8..39)

Reg#	WORD		Units	Mode	Description
	HI	LO
8	X_OSC		[Hz]	RO	Signed, Oscillator trim value
9	TRIM_DATA			RO	Reserved
10	DEV	INDEX		RO	Index of last channel used (unsigned char) and deviation (signed char)
11	RSSI		[dB]	RO	Signed, RSSI of last received frame
12	UPTIME_LO		[s]	RO	Time elapsed from last restart
13	UPTIME_HI
14	IDLE_LO		[s/1024]	RO	Time spent in IDLE
15	IDLE_HI
16	WAKE_LO		[s/1024]	RO	Time spent in WAKE
17	WAKE_HI
18	RX_LO		[s/1024]	RO	Time spent in RX
19	RX_HI
20	TX_LO		[s/1024]	RO	Time spent in TX
21	TX_HI
22	NOSYNCT_LO			RO	Count of TX frames in “no sync” state
23	NOSYNCT_HI
24	SYNCT_LO			RO	Count of TX frames in “sync” state
25	SYNCT_HI
26	SYNCR_LO			RO	Count of RX frames in “sync” state
27	SYNCR_HI
28	CBS_RSSI		[dB]	RO	Signed, RSSI of last frame received from CBS (Cluster Base-Station)
29	NOISE	CHAN		RO	Vector of noise floor on used channels. NOISE is expressed in [dB] (signed char).

NET Registers (40..47)

Reg#	WORD		Units	Mode	Description
	HI	LO
40	NETWORK_KEY_0			RW	Network Key 0
41	NETWORK_KEY_1			RW	Network Key 1
42	NETWORK_KEY_2			RW	Network Key 2
43	NETWORK_KEY_3			RW	Network Key 3
44	ADDRESS			RW	Address in the network
45	PARENT			RO	Parent Address
46	PREFERRED			RW	Preferred Parent Address

WINE Application Registers (48..63)

Reg#	WORD		Units	Mode	Description
	HI	LO
48	VERSION			RO	WINE software version
49	INFO			RO	Bit Mapped (1/0): BIT0 → Routing capabilities Yes/No BIT1 → Base Station Yes/No BIT2 → Anchor Yes/No BIT[3..7] → Localization request count BIT8 → Restart BIT9 → Trimmed
50	SURVIVAL		[s]	RW	Survival time
51	CHILD_LOST			EO	Address of lost cluster child node
52	ENROLL_MODE			RW	Bit Mapped (1/0): BIT0 → Enroll Enabled Yes/No BIT1 → Enroll Batch/Single
53	ENROLL_ADDR			RW	Address of next enrolling node
54	ELP			WO	Extreme Low Power Parameters: BIT[0..9] → slot modulation value [node slots] BIT[10..15] → interaction timeout [node slots]
55	ANCHOR_LEVEL			RW	Anchor level (0 → no anchor)
56	LATITUDE_H		[']	RW	Latitude high part, expressed as signed 16 bits [']
57	LATITUDE_L		[“/100]	RW	Latitude low part, expressed as signed 16 bits [“/100]
58	LONGITUDE_H		[']	RW	Longitude high part, expressed as signed 16 bits [']
59	LONGITUDE_L		[“/100]	RW	Longitude low part, expressed as signed 16 bits [“/100]
60	ALTITUDE		[m]	RW	Altitude expressed as signed 16 bits [m]
61	LOCALIZE			RW	Localization request (count) trigger or address of localization data source
62	PTP_DEST			RW	Point-To-Point data transfer link address
63	SPEED	CHAN		RW	Point-To-Point data transfer configuration

APP Registers (64..447)

These registers start from number 64 up to 447, for a total of 384.

The register definition in this section depends on application, so description of these registers is out of the scope of this section.

RESERVED Registers (448..511)

These 64 registers are reserved to send “open data” from WINE base-station to nodes as:

• ACK payload, or...
• standard registers write.

These registers are RW from the BS point of view, but RO for nodes.

Reg#	WORD		Units	Mode	Description
	HI	LO
486	DEV_NAME		[]	RW	Vector of mnemonic name of device (max. 24 characters / 12 words)
487	INFO_BLOCK_0		[]	RW	Information register block: BIT[0..4] → Block Length BIT[5..6] → Reserved BIT[7..15] →Register Start
488	INFO_TIME_0		[s]	RW	Interval of INFO refresh
489	INFO_BLOCK_1		[]	RW	Information register block: BIT[0..4] → Block Length BIT[5..6] → Reserved BIT[7..15] →Register Start
490	INFO_TIME_1		[s]	RW	Interval of INFO refresh
491	INFO_BLOCK_2		[]	RW	Information register block: BIT[0..4] → Block Length BIT[5..6] → Reserved BIT[7..15] →Register Start
492	INFO_TIME_2		[s]	RW	Interval of INFO refresh
493	INFO_BLOCK_3		[]	RW	Information register block: BIT[0..4] → Block Length BIT[5..6] → Reserved BIT[7..15] →Register Start
494	INFO_TIME_3		[s]	RW	Interval of INFO refresh
495	ACK_SIZE			RW*	Enables ACK Payload, setting the number of registers to send as ACK Payload. Ranges from 0 (no ACK Payload) to 16 (max payload size).
496TO511	ACK_PAYLOAD			RW*	Open data.

(*) Only BS can write.