Examples
#Weather protection and logic module
A weather station, a logic module, and a shutter actuator share the facade line. Enter values in the station's fields:
- Shutter keys: a long press on Key 1 or Key 2 moves the shutter; a short press stops it or steps the slats.
- Wind alarm: a wind speed of 10 m/s or more sets the alarm on 2/6/1 (DPT 1.005). The actuator raises the shutter and ignores other commands. The alarm resets below 8 m/s (threshold minus a 2 m/s hysteresis); the shutter then stays where it is.
- Sun protection: a brightness of 40,000 lx or more sets the request on 2/6/2. The logic module combines it with the automatic mode from Key 3 (DPT 1.003) using AND, and sends the result as an up/down command on 2/1/1.
- Logic module: with automatic mode off, the request stays inside the logic module. Press Key 3 to enable it and follow the resulting telegram.
Wind speed (DPT 9.005) and brightness (DPT 9.004) are two-byte floating-point values; open a telegram to inspect their encoding.
<bus-diagram>
<script type="application/json">
{
"formatVersion": 2,
"title": "Weather protection: wind alarm and sun protection",
"description": "A weather station sends wind speed and brightness. Above 10 m/s, its wind alarm raises the shutter and locks it until the alarm ends. Above 40,000 lx, it requests sun protection; a logic module forwards this request to the shutter only while automatic mode (Key 3) is enabled. Enter values in the station's fields to follow the telegrams.",
"lines": [{ "address": "1.1", "name": "Facade" }],
"groupAddresses": [
{ "address": "2/1/1", "name": "Shutter movement", "dpt": "1.008" },
{ "address": "2/1/2", "name": "Shutter stop / step", "dpt": "1.007" },
{ "address": "2/1/4", "name": "Estimated position", "dpt": "5.001" },
{ "address": "2/6/1", "name": "Wind alarm", "dpt": "1.005" },
{ "address": "2/6/2", "name": "Sun protection request", "dpt": "1.001" },
{ "address": "2/6/3", "name": "Automatic sun protection", "dpt": "1.003" },
{ "address": "2/6/4", "name": "Wind speed", "dpt": "9.005" },
{ "address": "2/6/5", "name": "Brightness", "dpt": "9.004" }
],
"devices": [
{
"id": "weatherStation",
"name": "Weather station",
"address": "1.1.10",
"kind": "weatherStation",
"behavior": "weatherStation/v1",
"objects": [
{
"id": "wind",
"name": "Wind speed",
"ga": "2/6/4",
"dpt": "9.005",
"port": "wind",
"flags": { "W": false, "T": true }
},
{
"id": "brightness",
"name": "Brightness",
"ga": "2/6/5",
"dpt": "9.004",
"port": "brightness",
"flags": { "W": false, "T": true }
},
{
"id": "windAlarm",
"name": "Wind alarm",
"ga": "2/6/1",
"dpt": "1.005",
"port": "windAlarm",
"flags": { "W": false, "T": true }
},
{
"id": "sun",
"name": "Sun protection",
"ga": "2/6/2",
"dpt": "1.001",
"port": "sunProtection",
"flags": { "W": false, "T": true }
}
],
"inputs": [
{
"id": "wind",
"type": "number",
"label": "Wind (m/s)",
"object": "wind",
"min": 0,
"max": 40,
"step": 1
},
{
"id": "brightness",
"type": "number",
"label": "Brightness (lx)",
"object": "brightness",
"min": 0,
"max": 100000,
"step": 5000
}
]
},
{
"id": "pushButton",
"name": "Three-key push-button",
"address": "1.1.1",
"kind": "pushButton",
"behavior": "pushButton/v1",
"objects": [
{
"id": "move",
"name": "Movement",
"ga": "2/1/1",
"dpt": "1.008",
"port": "input",
"flags": { "W": false, "T": true }
},
{
"id": "stop",
"name": "Stop / slat step",
"ga": "2/1/2",
"dpt": "1.007",
"port": "input",
"flags": { "W": false, "T": true }
},
{
"id": "auto",
"name": "Automatic mode",
"ga": "2/6/3",
"dpt": "1.003",
"port": "input",
"flags": { "W": true, "T": true }
}
],
"buttons": [
{
"id": "key1",
"label": "Key 1 · Up",
"icon": "up",
"short": { "object": "stop", "value": 0 },
"long": { "object": "move", "value": 0 }
},
{
"id": "key2",
"label": "Key 2 · Down",
"icon": "down",
"short": { "object": "stop", "value": 1 },
"long": { "object": "move", "value": 1 }
},
{
"id": "key3",
"label": "Key 3 · Automatic",
"press": { "object": "auto", "value": "toggle" },
"led": "auto"
}
]
},
{
"id": "logicModule",
"name": "Logic module",
"address": "1.1.20",
"kind": "logicModule",
"behavior": "logicGate/v1",
"objects": [
{
"id": "sunIn",
"name": "Sun protection request",
"ga": "2/6/2",
"dpt": "1.001",
"port": "logicIn",
"flags": { "W": true, "T": false }
},
{
"id": "autoIn",
"name": "Automatic mode",
"ga": "2/6/3",
"dpt": "1.003",
"port": "logicIn",
"flags": { "W": true, "T": false }
},
{
"id": "out",
"name": "Shutter movement",
"ga": "2/1/1",
"dpt": "1.008",
"port": "logicOut",
"flags": { "W": false, "T": true }
}
]
},
{
"id": "shutterActuator",
"name": "Shutter actuator",
"address": "1.1.3",
"kind": "shutterActuator",
"behavior": "shutterActuator/v1",
"objects": [
{
"id": "move",
"name": "Movement",
"ga": "2/1/1",
"dpt": "1.008",
"port": "move",
"channel": "s1",
"flags": { "W": true, "T": false }
},
{
"id": "stop",
"name": "Stop / step",
"ga": "2/1/2",
"dpt": "1.007",
"port": "stopStep",
"channel": "s1",
"flags": { "W": true, "T": false }
},
{
"id": "wind",
"name": "Wind alarm",
"ga": "2/6/1",
"dpt": "1.005",
"port": "windAlarm",
"channel": "s1",
"flags": { "W": true, "T": false }
},
{
"id": "status",
"name": "Estimated position",
"ga": "2/1/4",
"dpt": "5.001",
"port": "positionStatus",
"channel": "s1",
"flags": { "W": false, "T": true }
}
],
"channels": [
{
"id": "s1",
"label": "Shutter S1",
"parameters": { "estimatedTravelTimeMs": 20000 },
"equipment": { "type": "shutter", "parameters": { "actualTravelTimeMs": 20000 } }
}
]
}
],
"options": { "speed": 1, "filterTables": false }
}
</script>
</bus-diagram>{
"formatVersion": 2,
"title": "Weather protection: wind alarm and sun protection",
"description": "A weather station sends wind speed and brightness. Above 10 m/s, its wind alarm raises the shutter and locks it until the alarm ends. Above 40,000 lx, it requests sun protection; a logic module forwards this request to the shutter only while automatic mode (Key 3) is enabled. Enter values in the station's fields to follow the telegrams.",
"lines": [{ "address": "1.1", "name": "Facade" }],
"groupAddresses": [
{ "address": "2/1/1", "name": "Shutter movement", "dpt": "1.008" },
{ "address": "2/1/2", "name": "Shutter stop / step", "dpt": "1.007" },
{ "address": "2/1/4", "name": "Estimated position", "dpt": "5.001" },
{ "address": "2/6/1", "name": "Wind alarm", "dpt": "1.005" },
{ "address": "2/6/2", "name": "Sun protection request", "dpt": "1.001" },
{ "address": "2/6/3", "name": "Automatic sun protection", "dpt": "1.003" },
{ "address": "2/6/4", "name": "Wind speed", "dpt": "9.005" },
{ "address": "2/6/5", "name": "Brightness", "dpt": "9.004" }
],
"devices": [
{
"id": "weatherStation",
"name": "Weather station",
"address": "1.1.10",
"kind": "weatherStation",
"behavior": "weatherStation/v1",
"objects": [
{
"id": "wind",
"name": "Wind speed",
"ga": "2/6/4",
"dpt": "9.005",
"port": "wind",
"flags": { "W": false, "T": true }
},
{
"id": "brightness",
"name": "Brightness",
"ga": "2/6/5",
"dpt": "9.004",
"port": "brightness",
"flags": { "W": false, "T": true }
},
{
"id": "windAlarm",
"name": "Wind alarm",
"ga": "2/6/1",
"dpt": "1.005",
"port": "windAlarm",
"flags": { "W": false, "T": true }
},
{
"id": "sun",
"name": "Sun protection",
"ga": "2/6/2",
"dpt": "1.001",
"port": "sunProtection",
"flags": { "W": false, "T": true }
}
],
"inputs": [
{
"id": "wind",
"type": "number",
"label": "Wind (m/s)",
"object": "wind",
"min": 0,
"max": 40,
"step": 1
},
{
"id": "brightness",
"type": "number",
"label": "Brightness (lx)",
"object": "brightness",
"min": 0,
"max": 100000,
"step": 5000
}
]
},
{
"id": "pushButton",
"name": "Three-key push-button",
"address": "1.1.1",
"kind": "pushButton",
"behavior": "pushButton/v1",
"objects": [
{
"id": "move",
"name": "Movement",
"ga": "2/1/1",
"dpt": "1.008",
"port": "input",
"flags": { "W": false, "T": true }
},
{
"id": "stop",
"name": "Stop / slat step",
"ga": "2/1/2",
"dpt": "1.007",
"port": "input",
"flags": { "W": false, "T": true }
},
{
"id": "auto",
"name": "Automatic mode",
"ga": "2/6/3",
"dpt": "1.003",
"port": "input",
"flags": { "W": true, "T": true }
}
],
"buttons": [
{
"id": "key1",
"label": "Key 1 · Up",
"icon": "up",
"short": { "object": "stop", "value": 0 },
"long": { "object": "move", "value": 0 }
},
{
"id": "key2",
"label": "Key 2 · Down",
"icon": "down",
"short": { "object": "stop", "value": 1 },
"long": { "object": "move", "value": 1 }
},
{
"id": "key3",
"label": "Key 3 · Automatic",
"press": { "object": "auto", "value": "toggle" },
"led": "auto"
}
]
},
{
"id": "logicModule",
"name": "Logic module",
"address": "1.1.20",
"kind": "logicModule",
"behavior": "logicGate/v1",
"objects": [
{
"id": "sunIn",
"name": "Sun protection request",
"ga": "2/6/2",
"dpt": "1.001",
"port": "logicIn",
"flags": { "W": true, "T": false }
},
{
"id": "autoIn",
"name": "Automatic mode",
"ga": "2/6/3",
"dpt": "1.003",
"port": "logicIn",
"flags": { "W": true, "T": false }
},
{
"id": "out",
"name": "Shutter movement",
"ga": "2/1/1",
"dpt": "1.008",
"port": "logicOut",
"flags": { "W": false, "T": true }
}
]
},
{
"id": "shutterActuator",
"name": "Shutter actuator",
"address": "1.1.3",
"kind": "shutterActuator",
"behavior": "shutterActuator/v1",
"objects": [
{
"id": "move",
"name": "Movement",
"ga": "2/1/1",
"dpt": "1.008",
"port": "move",
"channel": "s1",
"flags": { "W": true, "T": false }
},
{
"id": "stop",
"name": "Stop / step",
"ga": "2/1/2",
"dpt": "1.007",
"port": "stopStep",
"channel": "s1",
"flags": { "W": true, "T": false }
},
{
"id": "wind",
"name": "Wind alarm",
"ga": "2/6/1",
"dpt": "1.005",
"port": "windAlarm",
"channel": "s1",
"flags": { "W": true, "T": false }
},
{
"id": "status",
"name": "Estimated position",
"ga": "2/1/4",
"dpt": "5.001",
"port": "positionStatus",
"channel": "s1",
"flags": { "W": false, "T": true }
}
],
"channels": [
{
"id": "s1",
"label": "Shutter S1",
"parameters": { "estimatedTravelTimeMs": 20000 },
"equipment": { "type": "shutter", "parameters": { "actualTravelTimeMs": 20000 } }
}
]
}
],
"options": { "speed": 1, "filterTables": false }
}