3.2.10. Association Group Information (AGI) Command Class, version 3¶
The Association Group Information (AGI) Command Class allows a node to advertise the capabilities of each association group supported by a given application resource.
3.2.10.1. Compatibility considerations¶
The Association Group Information (AGI) Command Class, version 3 introduces the Profile category “Irrigation”.
The Association Group Information (AGI) Command Class, version 3 defines no new command fields or changes to the interpretation of Association Group Information (AGI) Command Class, version 1 and version 2.
All sections and commands not described in this version remain unchanged from version 2.
3.2.10.2. The Association Group Information¶
\requirement{CC:0059.03.00.12.001}{4}
A node may implement one or more association groups. If the device implements association groups, the device SHOULD provide an Association Group Information (AGI) table as described in Table 3.25
3.2.10.2.1. Profile¶
The profile categories are referenced in Table 3.36. The profiles category “Irrigation” introduced in version 3 is described in Section 3.2.10.2.1.1.
3.2.10.2.1.1. Irrigation Profiles¶
“Irrigation” profiles are intended for association groups of which commands are triggered by irrigation events. As an example, an irrigation control device may provide 8 channels that can each control an external resource such as a valve or a pump.
Profile |
Explanation |
Profile identifier |
|
|---|---|---|---|
MSB |
LSB |
||
General:NA (v1) |
“Not Applicable” There is no specific class of events for this association group |
AGI_PROFILE_GENERAL = 0x00 |
AGI_GENERAL_NA = 0x00 |
General: Lifeline (v1) |
“Lifeline” This association group is intended for all events relevant for the Lifeline group |
AGI_PROFILE_GENERAL = 0x00 |
AGI_GENERAL_LIFELINE = 0x01 |
Control:Key01 (v1) |
“Control Key 1” Members of this association group are controlled or receive reports in response to user input for key 1 |
AGI_PROFILE_CONTROL = 0x20 |
AGI_CONTROL_KEY01 = 0x01 |
Control:Key xx (v1) |
… |
||
Control:Key32 (v1) |
“Control Key 32” Members of this association group are controlled or receive reports in response to user input for key 32 |
AGI_PROFILE_CONTROL = 0x20 |
AGI_CONTROL_KEY32 = 0x20 |
Sensor: Air temperature (v1) |
“Sensor, Air Temperature” Members of this association group are controlled or receive reports when the sensor value changes |
AGI_PROFILE_SENSOR = 0x31 |
MULTILEVEL_SENSOR_TYPE_ TEMPERATURE = 0x01 |
Sensor: Humidity (v1) |
“Sensor, Humidity” Members of this association group are controlled or receive reports when the sensor value changes |
AGI_PROFILE_SENSOR = 0x31 |
MULTILEVEL_SENSOR_TYPE_ HUMIDITY = 0x05 |
… |
(only examples above. Sensor profiles are built based on the Sensor Type as described in Section 3.2.8.3.2.3 |
AGI_PROFILE_SENSOR = 0x31 |
MULTILEVEL_SENSOR_TYPE_ TEMPERATURE = 0x01 |
Notification: Smoke Alarm (v1) |
“Notification, Smoke Alarm” Members of this association group are controlled or receive reports when an event or state change is detected.for the given Notification Type |
AGI_PROFILE_ NOTIFICATION = 0x71 |
NOTIFICATION_TYPE_ SMOKE = 0x01 |
Notification: C02 Alarm (v1) |
“Notification, CO2 Alarm” Members of this association group are controlled or receive reports when an event or state change is detected.for the given Notification Type |
AGI_PROFILE_ NOTIFICATION = 0x71 |
NOTIFICATION_TYPE_ CO2 = 0x03 |
… |
(only examples above. Notification profiles are built based on the Notification Type as described in Section 3.2.8.3.2.4. |
AGI_PROFILE_NOTIFICATION = 0x71 |
… |
Profile |
Explanation |
Profile identifier |
|
|---|---|---|---|
MSB |
LSB |
||
Meter: Electric, kWH (v2) |
“Meter, Electric” Members of this association group receive meter reports or are controlled when a metering event is detected. |
AGI_PROFILE_METER = 0x32 |
METER_TYPE_ ELECTRIC = 0x01 |
Meter: Gas (v2) |
“Meter, Gas” Members of this association group receive meter reports or are controlled when a metering event is detected. |
AGI_PROFILE_METER = 0x32 |
METER_TYPE_ GAS = 0x02 |
Meter: Water (v2) |
“Meter, Water” Members of this association group receive meter reports or are controlled when a metering event is detected. |
AGI_PROFILE_METER = 0x32 |
METER_TYPE_ WATER = 0x03 |
… |
(only examples above. Meter profiles are built based on the Notification Type as described in Section 3.2.9.2.1.1. |
AGI_PROFILE_METER = 0x32 |
MULTILEVEL_SENSOR_TYPE_ TEMPERATURE = 0x01 |
Irrigation: Channel 01 (v3) |
“Irrigation Channel 01” Member(s) of this association group are controlled by channel 1 of an irrigation control device |
AGI_PROFILE_IRRIGATION = 0x6B |
AGI_IRRIGATION_CHANNEL_ 01 = 0x01 |
Irrigation: Channel xx (v3) |
… |
||
Irrigation: |
“Irrigation Channel 32” Members of this association group are controlled or receive reports in response to user input for key 32 |
AGI_PROFILE_IRRIGATION = 0x6B |
AGI_IRRIGATION_CHANNEL_ 32 = 0x20 |
