This page covers how to use the ADFWeb HD67941-B2 DALI/MQTT converter with MobiusFlow. The article covers control, querying and configuration for both standard luminaires and emergency lights.
The ADFWeb HD67941-B2 DALI/MQTT bridge acts as a converter between MQTT and DALI protocols. The bridge connects to an MQTT broker via either ethernet or WiFi. The bridge acts as a DALI master and therefore the pair of DALI lines is run directly into it. This completes the DALI/MQTT connection.
MobiusFlow can be connected to the same MQTT broker as DALI/MQTT bridge, allowing the two the communicate via MQTT. This allows MobiusFlow achieve to two-way communication with a given DALI circuit, hence allowing control, querying and configuration to be achieved.
The overall architecture is shown in the diagram below.
A MobiusFlow service called 'adfweb dali mqtt' has been made to specifically to allow control, querying and configuration to be performed simply and easily from MobiusFlow. Each adfweb dali mqtt service connects to a single HD67941-B2, so if your application uses mutliple HD67941-B2 then multiple adfweb dali mqtt services should be used.
For some use cases that will be covered later in this article, MobiusFlow direct commands (DCMDs) can be used to control some functions of service. These DCMDs are sent via the MobiusFlow engine API most commonly from the Flows, however direct HTTP requests can also be used.
As such, a lower-level system architecture diagram looks as follows:
The MQTT broker can be run anywhere which is accessible over a network to both the HD67941-B2 and MobiusFlow. For ease, in most cases the MQTT broker is run within MobiusFlow itself. As such, the architecture diagram becomes the following:
To configure the HD67941-B2, ADFWeb's documentation on HD67941-B should be followed here. Use the instructions to get the HD67941-B2 to connect to your MQTT broker. To work with MobiusFlow correctly, specific MQTT settings must be set using the SW67941 configurator tool.
Navigate to the the MQTT Set Topic menu:
Once on the MQTT Set Topic menu, navigate to the MQTT publish tab. Create a single entry the following settings:
Note that {MACID} should be replaced with the MAC ID of the HD67941-B2 you're using. For example:
Template
The template should be set to the following JSON string:
All remaining fields should be populated as shown in the screenshot below:
Navigate to the MQTT Subscribe tab.
The topic should be set as follows
As before, {MACID} should be replaced with the MAC ID of the HD67941-B2 you're using. For example:
The remainder of the row should be populated as shown in the screenshot below:
This completes the configuration required for MobiusFlow. Ensure all MQTT changes are saved before flashing the new configuration to the HD67941-B2.
Within MobiusFlow, a given DALI luminaire or DALI group is represented by an equivalent luminaire and group object. Both object types are designed to reside on the adfweb dali mqtt. This service is shown configured and running in the screenshot below.
The two object types are tabulated below.
A single instance of both of these objects is shown live on an adfweb dali mqtt service in the screenshot below. The screenshot also shows the configuration page for the luminaire object. A DALI short address should be entered to match that of a real-world DALI luminaire.
The configuration window of a group object is shown in the screenshot below. Similarly to a luminaire, a group address should be added to represent the group number of the DALI group this object will represent.
Both Luminaire objects and Group objects feature a setPoint resource (rid: 41). To change the lighting level, this resource should be simply be set in the same manner as any other MobiusFlow resource.
In the case of the Luminaire object, a knowLevel resource is also present. This populated as a result of the the current level being queried. It exists because sometimes due to issues with the system, there may be a discrepancy between the demanded level and actual level.
Within a luminaire, a resource exists for each group, allowing you to choose which groups the luminaire is a member of.
The screenshot below partially shows the resource list for the luminaire object.
Note that, the group membership of all luminaires should be set via changing the default value of any group membership resource prior to starting the adfweb dali mqtt service. Do not make the mistake of changing the live value of these resources after the service has started. Although this will work, if the service is restarted, this group membership information will not be saved.
The group object is simpler. As querying the level of a whole group is not possible in DALI, no known level resource exists. As with the luminaire, the lighting level of the DALI group can be changed by setting the setPoint resource.
Below is an example of a simple flow with two inject buttons, one to set the level to 95% and the other to 5%. The inject nodes are linked to a setResource node which setup to set the setPoint resource of a live DALI luminaire (resource 000001/020/027A/41).
A very similar flow is shown to change the level of a group between 80% and 10%. In this case the setResource has been set to set the setPoint resource of the DALI group (resource 000001/020/027B/0001/41.
A more typical use case may be to have the lights automatically controlled. As well as this, it may be required that groups and single luminaires may need to be controlled as one. In the below flow, an EnOcean PIR is linked to a 'local control' zone node, which is then linked both a setResource node linking to a single DALI luminaire, and a DALI group.
The local control node us used in this case to set time periods of when the lights should be at given levels. The config window for this node is shown below
Note that is node is included within the node-red-contrib-mobius-flow-lighting package and may not be included within your Flows palette by default. If this is the case, it can be instantly added using the palette manager.
The system has been setup to automatically query several key properties of all luminaires. These are as follows:
Group Membership (returned as raw 2 byte, bit-array)
Ballast Status
Lamp failure status
Lamp arc power status
Power failure status
Raw status (all status information returned as 1 byte, bit-array)
Device Type
Max lighting level
Min lighting level
Each luminaire object has resources to store this data. These resources are populated automatically when information is received from the HD67941-B2 DALI/MQTT bridge.
The system also allows the user to perform some additional queries manually. The queries can be sent by sending the adfweb dali mqtt service a recognised MobiusFlow direct command (DCMD). These DCMDs can be sent directly using the MobiusFlow engine API or by using the DCMD node within the Flows. Ensure the DCMD is setup with a timeout time of at least 10,000ms. All queries use the DCMD command name:
Supported queries and their associated DCMD data are tabulated below:
In the above table, all payloads were shown for a target DALI luminaire with a DALI short address of 0, however this should be replaced with the DALI short address of whichever luminaire is the target of the query (0-63).
After sending the DCMD, if correct, you should receive a response. This response will be in the form of a raw byte. The DALI documentation should be used to interpret this data.
Data that is automatically queried from all luminaires can be found in that luminaire's resource list.
In the example flow below, a resource COV node has been used to respond to the change of value of the lamp failure status (resource 54). This may be useful if actions need to be taken in such an event, e.g. notifying maintenance. A similar flow could be made to respond to the data from any of the resources.
In the case of special queries (queries which are not automatically run), as explained before, DCMDs should be sent. The flow below shows how this could be set up.
The function node labelled function 1, is used to set the correct DCMD data for the query. The configuration is shown below:
The DCMD node is setup as follows:
Note that the URI property should be set to target the adfweb dali mqtt service. In this case, the service id of the adfweb dali mqtt service is 020 and the hub id the MobiusFlow instance that service is running on is 000001, hence the target URI of 000001/020.
Configuration is performed in the same manner as manual querying, using DCMDs to directly interface with adfweb dali mqtt service, sent either directly to the MobiusFlow engine API or using the Flows.
Ensure the DCMD is setup with a timeout time of at least 10,000ms. All queries use the DCMD command name:
Supported queries and their associated DCMD data are tabulated below:
In the above table, all data packets were shown for a target DALI luminaire with a DALI short address of 0, however this should be replaced with the DALI short address of whichever luminaire is the target of the query (0-63).
The level parameter should be varied to set the desired quantity accordingly.
The group property can be set to true if an entire DALI group is being configured at once. Note, in this case, the address property will represent the group number (0-15) instead of a DALI short address.
The flow below shows how a DCMD node could be used to send configuration commands, in this case setting the maximum lighting level:
The node function node labelled function 4 is used to set the DCMD data. The configuration for this node is as follows:
The DCMD node is setup as follows:
Note that the URI property should be set to target the adfweb dali mqtt service. In this case, the service id of the adfweb dali mqtt service is 020 and the hub id the MobiusFlow instance that service is running on is 000001, hence the target URI of 000001/020.
A MobiusFlow object type has been created to represent DALI emergency lights. This object type contains resources to capture information regarding the status of the emergency light as well as test results. As with all other DALI object types, the DALI emergency light is designed to be a child of the adfweb dali mqtt service. It's details are tabulated below.
The screenshot below shows a DALI emergency light object within an adfweb dali mqtt.
Like all DALI objects, the DALI emergency object requires a DALI short address to be assigned to it:
No automatic control or querying of DALI emergency lights is performed. As such, all interfacing is performed using MobiusFlow direct commands (DCMDs) sent to the adfweb dali mqtt service, either via the MobiusFlow engine API or using the Flows.
In case of queries, data received as a result of the query automatically populates the corresponding MobiusFlow object. The data is also returned to the user via the DCMD response as normal.
Ensure the DCMD is setup with a timeout time of at least 10,000ms. All queries use the DCMD command name:
Supported actions and their associated DCMD data are tabulated below:
In the above table, all data packets were shown for a target DALI emergency light with a DALI short address of 0, however this should be replaced with the DALI short address of whichever emergency light is the target of the action (0-63).
The flows can be used to easily send DCMDs to the adfweb dali mqtt service to complete any desired actions. The flow below has been set to automatically query the potential failure mode on interval.
The function node labelled function 8 is used to set the DCMD data prior to the request. The configuration for the node is as follows:
The DCMD node is setup as follows:
Note that the URI property should be set to target the adfweb dali mqtt service. In this case, the service id of the adfweb dali mqtt service is 020 and the hub id the MobiusFlow instance that service is running on is 000001, hence the target URI of 000001/020.
Note that, no debug node is used here to display query results. This is because, in the case of DALI emergency lights, the data is auto-populated into the corresponding DALI emergency light object.
| Object | Profile ID (PID) | Name in MobiusFlow | Parent Service |
|---|---|---|---|
| Query Type | Example DCMD Data |
|---|---|
| Query Type | Example DCMD Data |
|---|---|
| Object | Profile ID (PID) | Name in MobiusFlow | Parent Service |
|---|---|---|---|
| Action | Example DCMD data |
|---|---|
DALI Luminaire
027A
dali_Luminiaire_v2
adfweb dali mqtt
DALI Group
027B
dali_group
adfweb dali mqtt
DALI Emergency Light
0259
dali_emergency
adfweb dali mqtt
Query power up level
Query system failure level
Query fade time / rate
Query power failure
Query dtr content
Set maximum allowed lighting level
Set minimum allowed lighting level
Set power up lighting level
Set system failure level
Set fade time
Set fade rate
Store current lighting level in dtr
Rest
Inhibit
ReLight Inhibit
Start function test
Start duration test
Stop test
Reset function test done flag
Reset duration test done flag
Reset lamp time
Store DTR as emergency level
Store test delay time high byte
Store test dalay time low byte
Store function test interval
Store duration test interval
Store test execuation timeout
Store prolong time
Start indentification
Query battery charge
Query duration test result
Query lamp operational time
Query emergency mode
Query failure mode
Query emergency status
