Add optional reporting interval and reportable change fields to Zigbee event mappings

Author: rohitmohan96

cddl/zigbee-event-map.cddl

@@ -12,4 +12,7 @@ zigbee-event-map = {
   attributeType: uint,
   ? profileID: uint,
   ? manufacturerCode: uint,
+  ? minReportingInterval: uint,
+  ? maxReportingInterval: uint,
+  ? reportableChange: number,
 }

draft-ietf-asdf-sdf-protocol-mapping.md

@@ -559,6 +559,16 @@ Where:
 - `attributeType` is the Zigbee data type of the attribute.
 - `profileID` is the Zigbee application profile ID (optional). If not provided, it defaults to the Home Automation profile (0x0104), which is the default profile in Zigbee 3.0.
 - `manufacturerCode` is the Zigbee manufacturer code of the attribute (optional).
+- `minReportingInterval` is the minimum reporting interval in seconds
+  (optional). It is the minimum time between issued attribute reports and
+  applies only when `type` is `"attribute_reporting"`.
+- `maxReportingInterval` is the maximum reporting interval in seconds
+  (optional). It is the maximum time between issued attribute reports and
+  applies only when `type` is `"attribute_reporting"`.
+- `reportableChange` is the minimum change to the attribute value that triggers
+  a report (optional). It applies only when `type` is `"attribute_reporting"`
+  and to attributes with an 'analog' data type, and MUST have the same data type
+  as the reported attribute.
 
 
 For example, a Zigbee event mapping for a temperature change report:
@@ -574,7 +584,10 @@ For example, a Zigbee event mapping for a temperature change report:
           "endpointID": 1,
           "clusterID": 1026,
           "attributeID": 0,
-          "attributeType": 41
+          "attributeType": 41,
+          "minReportingInterval": 10,
+          "maxReportingInterval": 300,
+          "reportableChange": 50
         }
       }
     }

generated/combined.cddl

@@ -70,6 +70,9 @@ zigbee-event-map = {
   attributeType: uint,
   ? profileID: uint,
   ? manufacturerCode: uint,
+  ? minReportingInterval: uint,
+  ? maxReportingInterval: uint,
+  ? reportableChange: number,
 }
 
 $$SDF-ACTION-PROTOCOL-MAP //= (

openapi/ProtocolMap-Zigbee.yaml

@@ -47,5 +47,21 @@ components:
               example: 260
 
     ProtocolMap-Zigbee-Event:
-      allOf:  
+      allOf:
         - $ref: '#/components/schemas/ProtocolMap-Zigbee-Propmap'
+        - type: object
+          properties:
+            zigbee:
+              type: object
+              properties:
+                minReportingInterval:
+                  type: integer
+                  format: int32
+                  example: 10
+                maxReportingInterval:
+                  type: integer
+                  format: int32
+                  example: 300
+                reportableChange:
+                  type: number
+                  example: 50