Registers

All VSCP modules have a set of 8-bit registers defined to export it's functionality in a common way. Some of them (register 128-255) are predefined and the information in them are the same for all VSCP modules. See the VSCP specification for a description of their content.

The lower 128 register space is used for module specific registers. It is also here you find registers with which you configure your module. Also registers where you typically can read status information such as measurement data from the module is here.

The lower register space is further expanded in register pages.

Below is a description of the registers of the Kelvin NTC10KA module.

Module zone registers

Register Page Description
0 0 The zone this module belongs to.
1 0 The sub zone this module belongs to.

Sensor Control Registers

Configure which data is reported here and how it is reported.

Register Page Description
2 0 Control byte for sensor 0.
3 0 Control byte for sensor 1.
4 0 Control byte for sensor 2.
5 0 Control byte for sensor 3.
6 0 Control byte for sensor 4.
7 0 Control byte for sensor 5.

Description of control register bits

Bit Description
0,1 Temperature unit

00 - Kelvin.
01 - Celsius (default).
10 - Fahrenheit.
11 - Reserved.
2 Reserved.
3 Enable low alarm if set to one.
4 Enable high alarm if set to one.
5 Send TurnOn/TurnOff events instead of Alarm if set to one.
6 Controls when TurnOn/TurnOff events will be sent if activated.

0 - TurnOn event is sent when low temperature is reached as set in low temperature alarm register (see [sub:Low-alarm-registers]). TurnOff event is sent when high temperature is reached as set in high temperature alarm register (see [sub:High-alarm-registers]).

1 - TurnOff event is sent when low temperature is reached as set in low temperature alarm register (see Registers]). TurnOn event is sent when high temperature is reached as set in high temperature alarm register (see [sub:High-alarm-registers]).

The hysteresis value (see [sub:Sensor-hysteresis-registers]) will effect TurnOn/TurnOff events The temperature must go above or below the hysteresis value before a new event will be sent out.
7

Low alarm registers

Register Page Description
50 0 Low alarm set point for sensor 0 MSB.
51 0 Low alarm set point for sensor 0 LSB.
52 0 Low alarm set point for sensor 1 MSB.
53 0 Low alarm set point for sensor 1 LSB.
54 0 Low alarm set point for sensor 2 MSB.
55 0 Low alarm set point for sensor 2 LSB.
56 0 Low alarm set point for sensor 3 MSB.
57 0 Low alarm set point for sensor 3 LSB.
58 0 Low alarm set point for sensor 4 MSB.
59 0 Low alarm set point for sensor 4 LSB.
60 0 Low alarm set point for sensor 5 MSB.
61 0 Low alarm set point for sensor 5 LSB.

Writing any of these registers will reset high/low alarm conditions for that sensor.

The value is stored as a twos complement number representing the temperature. Note note that the value is not *100.

The hysteresis value affects the low alarm after a low alarm condition has been set. The temperature must increase with hysteresis degrees before the low alarm condition is resetted.

High alarm registers

Register Page Description
62 0 High alarm set point for sensor 0 MSB.
63 0 High alarm set point for sensor 0 LSB.
64 0 High alarm set point for sensor 1 MSB.
65 0 High alarm set point for sensor 1 LSB.
66 0 High alarm set point for sensor 2 MSB.
67 0 High alarm set point for sensor 2 LSB.
68 0 High alarm set point for sensor 3 MSB.
69 0 High alarm set point for sensor 3 LSB.
70 0 High alarm set point for sensor 4 MSB.
71 0 High alarm set point for sensor 4 LSB.
72 0 High alarm set point for sensor 5 MSB.
73 0 High alarm set point for sensor 5 LSB.

Writing any of these registers will reset high/low alarm conditions for that sensor.

The value is stored as a twos complement number representing the temperature. Note note that the value is not *100.

The hysteresis value affects the high alarm after a high alarm condition has been set. The temperature must decrease with hysteresis degrees before the high alarm condition is resetted.

Sensor zone information registers

Register Page Description
74 0 Zone for sensor 0 alarms.
75 0 Sub zone for sensor 0 alarms.
76 0 Zone for sensor 1 alarms.
77 0 Sub zone for sensor 1 alarms.
78 0 Zone for sensor 2 alarms.
79 0 Sub zone for sensor 2 alarms.
80 0 Zone for sensor 3 alarms.
81 0 Sub zone for sensor 3 alarms.
82 0 Zone for sensor 4 alarms.
83 0 Sub zone for sensor 4 alarms.
84 0 Zone for sensor 5 alarms.
85 0 Sub zone for sensor 5 alarms.

Sensor absolute low temperature registers

Register Page Description
86 0 Absolute low for sensor 0 MSB (Write to reset).
87 0 Absolute low for sensor 0 LSB (Write to reset).
88 0 Absolute low for sensor 1 MSB (Write to reset).
89 0 Absolute low for sensor 1 LSB (Write to reset).
90 0 Absolute low for sensor 2 MSB (Write to reset).
91 0 Absolute low for sensor 2 LSB (Write to reset).
92 0 Absolute low for sensor 3 MSB (Write to reset).
93 0 Absolute low for sensor 3 LSB (Write to reset).
94 0 Absolute low for sensor 4 MSB (Write to reset).
95 0 Absolute low for sensor 4 LSB (Write to reset).
96 0 Absolute low for sensor 5 MSB (Write to reset).
97 0 Absolute low for sensor 5 LSB (Write to reset).

The value is stored as a twos complement number as temperature * 100. Writing any of the registers will rest the value.

Sensor absolute high temperature registers

Register Page Description
98 0 Absolute high for sensor 0 MSB (Write to reset).
99 0 Absolute high for sensor 0 LSB (Write to reset).
100 0 Absolute high for sensor 1 MSB (Write to reset).
101 0 Absolute high for sensor 1 LSB (Write to reset).
102 0 Absolute high for sensor 2 MSB (Write to reset).
103 0 Absolute high for sensor 2 LSB (Write to reset).
104 0 Absolute high for sensor 3 MSB (Write to reset).
105 0 Absolute high for sensor 3 LSB (Write to reset).
106 0 Absolute high for sensor 4 MSB (Write to reset).
107 0 Absolute high for sensor 4 LSB (Write to reset).
108 0 Absolute high for sensor 5 MSB (Write to reset).
109 0 Absolute high for sensor 5 LSB (Write to reset).

The value is stored as a twos complement number as temperature * 100. Writing any of the registers will rest the value.

Sensor hysteresis registers

Register Page Description
110 0 Hysteresis in degrees Celsius for sensor 0 (default is 5 degrees).
111 0 Hysteresis in degrees Celsius for sensor 1 (default is 5 degrees).
112 0 Hysteresis in degrees Celsius for sensor 2 (default is 5 degrees).
113 0 Hysteresis in degrees Celsius for sensor 3 (default is 5 degrees).
114 0 Hysteresis in degrees Celsius for sensor 4 (default is 5 degrees).
115 0 Hysteresis in degrees Celsius for sensor 5 (default is 5 degrees).

The value here will affect the high and low alarms

Voltage calibration registers

The Voltage used to calculate the temperature for a sensor have effect on the error. The voltage is theoretically 5V but will in reality be something else but still close to 5V. These register can be used to set a calibrated voltage obtained from actual measurements. The value stored in the two registers is the voltage times 10000 so 5V for example should be stored as 50000.

Register Page Description
118 0 MSB of Voltage (Default is 0xC3).
119 0 MSB of Voltage (Default is 0x50).

Page 1

Raw A/D values

Raw A/D values from the temperature sensor network can be read if a user wants to. This can be useful for special nonstandard setups. The A/D converter is a 10-bit converter so the value can be 0-1023 and is stored MSB first in the registers (not in the converter) as all values are stored in VSCP. The registers can only be read, a write is ignored.

Register Page Description
72 1 MSB of A/D converter value for sensor 0.
73 1 LSB of A/D converter value for sensor 0.
74 1 MSB of A/D converter value for sensor 1.
75 1 LSB of A/D converter value for sensor 1.
76 1 MSB of A/D converter value for sensor 2.
77 1 LSB of A/D converter value for sensor 2.
78 1 MSB of A/D converter value for sensor 3.
79 1 LSB of A/D converter value for sensor 3.
80 1 MSB of A/D converter value for sensor 4.
81 1 LSB of A/D converter value for sensor 4.
82 1 MSB of A/D converter value for sensor 5.
83 1 LSB of A/D converter value for sensor 5.

Sensor calibration registers

The value in the calibration register is added to the measured sensor value before it's reported. The calibration value is stored as a two's complement temperature * 100 to allow for both positive and negative numbers. So 24.23 degrees is stored as 2423 and so on. This means that 100 will add one degree to the measured value while 65436 (0xFF9c) is -100 and will subtract one degree form the measured value. If you are unsecyre on how two complement umbers work there is an introduction here https://www.cs.cornell.edu/~tomf/notes/cps104/twoscomp.html

Register Page Description
84 1 MSB of calibration value for sensor 0.
85 1 LSB of calibration value for sensor 0.
86 1 MSB of calibration value for sensor 1.
87 1 LSB of calibration value for sensor 1.
88 1 MSB of calibration value for sensor 2.
89 1 LSB of calibration value for sensor 2.
90 1 MSB of calibration value for sensor 3.
91 1 LSB of calibration value for sensor 3.
92 1 MSB of calibration value for sensor 4.
93 1 LSB of calibration value for sensor 4.
94 1 MSB of calibration value for sensor 5.
95 1 LSB of calibration value for sensor 5.



Paradise of the Frog AB Brattbergavägen 17, 820 50 LOS, SWEDEN
email: info@paradiseofthefrog.com phone: +46 (0)8 40011835
web: http://www.paradiseofthefrog.com

 
registers.txt · Last modified: 2017/03/20 22:32 by admin