|
4 | 4 |
|
5 | 5 | A framework to allow multiple devices to be in a group with values such as power, light color, color temperature, brightness, PWM values, sensor values and more, all shared with other devices in the group. For example, with multiple lights in a device group, light settings can be changed on one light and the settings will automatically be changed on other lights. Dimmer switches could be in a device group with lights and that dimmer switch could control the power, brightness and colors of all the lights in the group. Multiple dimmer switches could be in a device group to form a 3-way/4-way dimmer switch.
|
6 | 6 |
|
7 |
| -UDP multicasts, followed by UDP unicasts if necessary, are used to send updates to all devices so updates are fast. There is no need for an MQTT server but all the devices in a group must be on the same multicast network. The multicast address and port are specified at compile time with the DEVICE_GROUPS_ADDRESS (default=239.255.250.250) and DEVICE_GROUPS_PORT (default=4447) macros respectively. |
| 7 | +UDP multicasts, followed by UDP unicasts if necessary, are used to send updates to all devices so updates are fast. There is no need for an MQTT server but all the devices in a group must be on the same multicast network. The multicast address and port are specified at compile time with the `DEVICE_GROUPS_ADDRESS` (default = 239.255.250.250) and `DEVICE_GROUPS_PORT` (default = 4447) macros respectively. |
8 | 8 |
|
9 | 9 | To enable device groups, execute command: `SetOption85 1`. All devices in a group must be running firmware with device group support and have device groups enabled.
|
10 | 10 |
|
11 | 11 | ## Operation
|
12 | 12 |
|
13 |
| -The device group name is set with the `DevGroupName` command (GroupTopic prior to 8.2.0.3). If a device group name is not set for a group, the MQTT group topic is used (with the device group number appended for device group numbers > 1). All devices in the same multicast network with the same device group name are in the same group. Some modules may define additional device groups. For example, if Remote Device Mode is enabled, the PWM Dimmer module defines three devices groups. |
| 13 | +The device group name is set with the `DevGroupName` command (`GroupTopic` prior to v8.2.0.3). If a device group name is not set for a group, the MQTT group topic is used (with the device group number appended for device group numbers > 1). All devices in the same multicast network with the same device group name are in the same group. Some modules may define additional device groups. For example, if Remote Device Mode is enabled, the PWM Dimmer module defines three devices groups. |
14 | 14 |
|
15 |
| -The items sent and received from the group are selected with the `DevGroupShare` command. By default all items are sent and received. An example of when the `DevGroupShare` command would be used is when you have a group of lights that you control with a dimmer switch and home automation software. You want the dimmer switch to be able to control all items. The home automation software controls each light individually. When it controls the whole group, it actually sends command to each light in the group. If you use the home automation software to turn an individual light on or off or change it's brightness, color or scheme, you do not want the change to be replicated to the other lights. In this case, you would set the incoming and outgoing item masks to 0xffffffff (all items) on the dimmer switch (`DevGroupShare 0xffffffff,0xffffffff`) and set the incoming item mask to 0xffffffff and outgoing item mask to 0 on all the lights (`DevGroupShare 0xffffffff,0`). |
| 15 | +The items sent and received from the group are selected with the `DevGroupShare` command. By default all items are sent and received. An example of when the `DevGroupShare` command would be used is when you have a group of lights that you control with a dimmer switch and home automation software. You want the dimmer switch to be able to control all items. The home automation software controls each light individually. When it controls the whole group, it actually sends command to each light in the group. If you use the home automation software to turn an individual light on or off or change it's brightness, color or scheme, you do not want the change to be replicated to the other lights. In this case, you would set the incoming and outgoing item masks to `0xffffffff` (all items) on the dimmer switch (`DevGroupShare 0xffffffff,0xffffffff`) and set the incoming item mask to 0xffffffff and outgoing item mask to 0 on all the lights (`DevGroupShare 0xffffffff,0`). |
16 | 16 |
|
17 | 17 | By default, the state of all relays is sent to and received from device group 1. To enable each relay to be in a separate device group, enable option 88 (`SetOption88 1`). Relay 1 updates will be sent to/received from device group 1, relay 2 updates will be sent to/received from device group 2, etc.
|
18 | 18 |
|
|
0 commit comments