CRC32
CRC32 value of byte 4..n
32
0
4294967295
SenderID
The SenderID is the DeviceID of the sending device. It's only allowed to send packets with the own DeviceID. 0 = base station, others are arbitrary.
12
0
4095
PacketCounter
The PacketCounter is counted up throughout the whole lifetime of the device and is used to make the encrypted packets differently from each other every time. Packets received with the same or lower number must be ignored per SenderID.
24
0
16777215
MessageType
The message type influences the behaviour with sending the packet. E.g. requests are acknowledged.
4
0
Get
1
Set
2
SetGet
8
Status
9
Ack
10
AckStatus
0
ReceiverID
The ID of the device to process the request. Use 4095 for broadcasts.
12
0
4095
MessageGroupID
0 = Generic, 1..9 = Reserved, others are arbitrary
7
0
127
MessageID
4
0
15
false
1
2
ReceiverID
The ID of the device to process the request. Use 4095 for broadcasts.
12
0
4095
MessageGroupID
0 = Generic, 1..9 = Reserved, others are arbitrary
7
0
127
MessageID
4
0
15
true
8
MessageGroupID
0 = Generic, 1..9 = Reserved, others are arbitrary
7
0
127
MessageID
4
0
15
true
9
AckSenderID
The ID of the requestor whose request is acknowledged.
12
0
4095
AckPacketCounter
The PacketCounter of the request that is acknowledged.
24
0
16777215
Error
Tells if there was an error fulfilling the request or not.
false
10
AckSenderID
The ID of the requestor whose request is acknowledged.
12
0
4095
AckPacketCounter
The PacketCounter of the request that is acknowledged.
24
0
16777215
Error
Tells if there was an error fulfilling the request or not.
MessageGroupID
0 = Generic, 1..9 = Reserved, others are arbitrary
7
0
127
MessageID
4
0
15
true
Generic
This group contains messages useful for different devices.
0
Version
Reports the current firmware version. Version information is only available when set in source code, which is usually only done for official builds by the build robot.
1
0
8
10
test
Major
Different major version means incompatible changes.
8
0
255
Minor
Different minor number means new functionality without breaking compatibility.
8
0
255
Patch
The patch version is changed when backwards-compatible bug fixes are made.
8
0
255
Hash
The beginning of the revision ID hash (as reported by Git).
32
0
4294967295
BatteryStatus
Tells the current battery status in percent. Please note that the "Get" may not be answered because a device does not listen to requests.
5
0
8
10
test
Percentage
The remaining capacity of the battery from 0 (empty) to 100 (full).
7
0
100
GPIO
This group contains messages for general I/O functions. The meaning of the values is not known to the SHC devices. It depends on the connected parts (e.g. switches). The values have to be processed by the user/server software appropriately.
1
DigitalPin
This is the state of up to 8 pins.
1
0
1
2
8
9
10
test
8
On
Tells if the pin is on (at high level) or not (low level).
Weather
This message group contains messages for weather data.
10
Temperature
This is a message containing temperature only.
1
0
8
10
test
Temperature
temperature [1/100 degree celsius], -50°C = -5000, 50°C = 5000
16
-32768
32767
HumidityTemperature
This is a message containing humidity and temperature.
2
0
8
10
test
Humidity
relative humidity permill, 0..1000 (other values not defined)
10
0
1000
Temperature
temperature [1/100 degree celsius], -50°C = -5000, 50°C = 5000
16
-32768
32767
BarometricPressureTemperature
This is a message containing barometric pressure and temperature.
3
0
8
10
test
BarometricPressure
barometric pressure in pascal
17
0
131071
Temperature
temperature [1/100 degree celsius], -50°C = -5000, 50°C = 5000
16
-32768
32767
Environment
This message group contains messages for environmental data except weather data.
11
Brightness
1
0
8
10
test
Brightness
brightness in percent
7
0
100
Distance
2
0
8
10
test
Distance
distance in cm
14
0
16383
PowerSwitch
20
SwitchState
This is the state of the relais and its timeout value.
1
0
1
2
8
9
10
test
On
Tells if the switch is on (active).
TimeoutSec
The time after which the switch is automatically toggled again. Use 0 to disable this.
16
0
65535
SwitchStateExt
This is the state of up to 8 relais and its timeout values.
2
0
1
2
8
9
10
test
8
On
8
TimeoutSec
The time after which the switch is automatically toggled again. Use 0 to disable this.
16
0
65535
Dimmer
60
Brightness
This is to set a fixed brightness.
1
0
1
2
8
9
10
test
Brightness
The brightness in percent. 0 = Off.
7
0
100
Animation
This is the state of the dimmer output voltage and its timeout value.
2
0
1
2
8
9
10
test
AnimationMode
If a time is set, use this animation mode to change the brightness over time (none = leave at start state for the whole time and switch to end state at the end).
2
0
none
1
linear
TimeoutSec
The time for the animation. Use 0 to disable this.
16
0
65535
StartBrightness
The brightness in percent at the beginning of the animation.
7
0
100
EndBrightness
The brightness in percent at the end of the animation.
7
0
100