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). AnalogPin This is the voltage of up to 8 ADC channels. The ATMega328 in the PDIP package has only 6 ADCs and one ADC may be blocked by the battery voltage measurement, so there may be less than 8 ADC values reported depending on the device and configuration. 2 0 1 2 8 9 10 test 8 On Tells if the pin is on (voltage over trigger threshold) or not. 8 Voltage This is the voltage level in mV. 11 0 1100 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 Color This is to set a fixed color. 10 0 1 2 8 9 10 test Color The color is according to the 6 bit color palette used in SHC. 6 0 63 ColorAnimation This is to set a color animation. 11 0 1 2 8 9 10 test Repeat The number of times the animation will be repeated. 0 means infinitely. 4 0 15 AutoReverse If true, the animation will be played back in the normal direction and then in reverse order. 10 Time The time for the animation between the current color and the next one. The number of seconds used is 0.05 * 1.3 ^ Time and covers the range from 0.03s to 170s. Use 0 to mark the end of the animation. Further values will be ignored. 5 0 31 Color The color is according to the 6 bit color palette used in SHC. The last color (or the first when AutoReverse is true) of the animation will remain visible after the animation is completed. 6 0 63