-
Notifications
You must be signed in to change notification settings - Fork 3
05.01. Switches
Endpoint Types:
- ET_BINARYSWITCH
- ET_MULTILEVELSWITCH
No extra data.
| Byte | Parameter | Description |
|---|---|---|
| 4 | Current | Current value |
| 5 | Target | Target value |
The values are treated as unsigned bytes with the following range semantics:
- 0: 0%
- 255: 100%
Anything inbetween is interpolated freely by the device depending on the Endpoint type:
- ET_BINARYSWITCH: 1-254: 100%
- ET_MULTILEVELSWITCH: gradual or rounded step values between fully off/deactivated and fully on/activated
All reports must contain an actual target value, even if it has already been reached (i.e. Current=Target). Devices, which cannot physically support the requested target value (e.g. value 55 for ES_BINARYSWITCH) must store it and report back the requested target value (while recalculating the actual one internally).
After the (possibly recalculated) Target value has been reached the device must send PROPERTY_REP to:
- The device, which sent PROPERTY_GET. The Command Seq value must be maintained
- The device, which sent PROPERTY_SET that caused the change. The Command Seq value must be maintained
- The reporting node, according to the device's configuration (reporting node, discrete change, threshold change). The Command Seq value is arbitrary in this case
| Byte | Parameter | Description |
|---|---|---|
| 4 | Value | Switch value as unsigned byte |
| 5-6 | Time | Transition time in ms (unsigned short) |
Duration is specified in milliseconds as 2 bytes. Value 0 means to use the device's default transition time. The device is free to ignore the specified Time value completely if it does not support it.