Management Objects for ZigBee Devices

Size: px

Start display at page:

Download "Management Objects for ZigBee Devices"

Herbert Nicholson
6 years ago
Views:

Management Objects for ZigBee Devices Approved Version 1.

2 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 2 (42) Use of this document is subject to all of the terms and conditions of the Use Agreement located at Unless this document is clearly designated as an approved specification, this document is a work in process, is not an approved Open Mobile Alliance specification, and is subject to revision or removal without notice. You may use this document or any part of the document for internal or educational purposes only, provided you do not modify, edit or take out of context the information in this document in any manner. Information contained in this document may be used, at your sole risk, for any purposes. You may not use this document in any other manner without the prior written permission of the Open Mobile Alliance. The Open Mobile Alliance authorizes you to copy this document, provided that you retain all copyright and other proprietary notices contained in the original materials on any copies of the materials and that you comply strictly with these terms. This copyright permission does not constitute an endorsement of the products or services. The Open Mobile Alliance assumes no responsibility for errors or omissions in this document. Each Open Mobile Alliance member has agreed to use reasonable endeavors to inform the Open Mobile Alliance in a timely manner of Essential IPR as it becomes aware that the Essential IPR is related to the prepared or published specification. However, the members do not have an obligation to conduct IPR searches. The declared Essential IPR is publicly available to members and non-members of the Open Mobile Alliance and may be found on the OMA IPR Declarations list at The Open Mobile Alliance has not conducted an independent IPR review of this document and the information contained herein, and makes no representations or warranties regarding third party IPR, including without limitation patents, copyrights or trade secret rights. This document may contain inventions for which you must obtain licenses from third parties before making, using or selling the inventions. Defined terms above are set forth in the schedule to the Open Mobile Alliance Application Form. NO REPRESENTATIONS OR WARRANTIES (WHETHER EXPRESS OR IMPLIED) ARE MADE BY THE OPEN MOBILE ALLIANCE OR ANY OPEN MOBILE ALLIANCE MEMBER OR ITS AFFILIATES REGARDING ANY OF THE IPR S REPRESENTED ON THE OMA IPR DECLARATIONS LIST, INCLUDING, BUT NOT LIMITED TO THE ACCURACY, COMPLETENESS, VALIDITY OR RELEVANCE OF THE INFORMATION OR WHETHER OR NOT SUCH RIGHTS ARE ESSENTIAL OR NON-ESSENTIAL. THE OPEN MOBILE ALLIANCE IS NOT LIABLE FOR AND HEREBY DISCLAIMS ANY DIRECT, INDIRECT, PUNITIVE, SPECIAL, INCIDENTAL, CONSEQUENTIAL, OR EXEMPLARY DAMAGES ARISING OUT OF OR IN CONNECTION WITH THE USE OF DOCUMENTS AND THE INFORMATION CONTAINED IN THE DOCUMENTS Open Mobile Alliance All Rights Reserved. Used with the permission of the Open Mobile Alliance under the terms set forth above Open Mobile Alliance All Rights Reserved.

3 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 3 (42) Contents 1. SCOPE REFERENCES NORMATIVE REFERENCES INFORMATIVE REFERENCES TERMINOLOGY AND CONVENTIONS CONVENTIONS DEFINITIONS ABBREVIATIONS INTRODUCTION VERSION ZIGBEE MANAGEMENT OBJECT MO DIAGRAM MO DESCRIPTIONS APPENDIX A. CHANGE HISTORY (INFORMATIVE) A.1 APPROVED VERSION HISTORY APPENDIX B. STATIC CONFORMANCE REQUIREMENTS (NORMATIVE) B.1 SCR FOR GWMO CLIENT B.1.1 SCR for ZigBee MO B.2 SCR FOR GWMO SERVER Figures Figure 1 ZigBee MO (Overview)... 8 Figure 2 ZigBeeMO sub-tree under Discovery... 8 Figure 3 ZigBee MO sub-tree under Interface... 9 Figure 4 ZigBee MO sub-tree under ZDO Tables No table of figures entries found Open Mobile Alliance All Rights Reserved.

4 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 4 (42) 1. Scope This document defines an OMA DM management object (data model) to represent ZigBee devices. This ZigBee MO models specific parameters used to represent a specific ZigBee device and should be used together with GwMO TS v1.1 [GwMO TS]. This ZigBee MO is optional for any OMA DM Gateway implementation. This standardised ZigBee device data model encourages the wide adoption of the management object while allowing vendor innovations and extensions Open Mobile Alliance All Rights Reserved.

5 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 5 (42) 2. References 2.1 Normative References [GwMO v1.1] [IEEE ] [ISO 8601] GwMO v1.1 Specifications, Version 1.1, Open Mobile Alliance, URL: IEEE , Wireles Medium Access Control (MAC) and Physical Layer (PHY) Specifications for Low-Rate Wireless Personal Area Networks (WPANs), IEEE, ISO 8601 Data elements and interchange formats Information interchange Representation of dates and times [ISO639-1] ISO 639-1, Codes for the representation of names of Languages - Part 1: Alpha-2 code, ISO, 2002 [ISO ] ISO/IEC , Information Technology - ISO 7-bit coded character set for information interchange, ISO, [RFC2119] Key words for use in RFCs to Indicate Requirement Levels, S. Bradner, March 1997, URL: [RFC2863] RFC 2863, The Interfaces Group MIB, IETF, 2000 URL: [RFC4234] Augmented BNF for Syntax Specifications: ABNF. D. Crocker, Ed., P. Overell. October 2005, URL: [SCRRULES] SCR Rules and Procedures, Open Mobile Alliance, OMA-ORG-SCR_Rules_and_Procedures, URL: [ZigBee2007] ZigBee Specification 2007, ZigBee Alliance, Version r17, URL: Informative References [OMADICT] Dictionary for OMA Specifications, Version 2.9, Open Mobile Alliance, OMA-ORG-Dictionary-V2_9, URL: Open Mobile Alliance All Rights Reserved.

6 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 6 (42) 3. Terminology and Conventions 3.1 Conventions The key words MUST, MUST NOT, REQUIRED, SHALL, SHALL NOT, SHOULD, SHOULD NOT, RECOMMENDED, MAY, and OPTIONAL in this document are to be interpreted as described in [RFC2119]. All sections and appendixes, except Scope and Introduction, are normative, unless they are explicitly indicated to be informative. 3.2 Definitions 3.3 Abbreviations OMA ZDO Open Mobile Alliance ZigBee Device Object 2017 Open Mobile Alliance All Rights Reserved.

7 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 7 (42) 4. Introduction ZigBee is a protocol for wireless communication standardized by the ZigBee Alliance. The ZigBee protocol defines the network layer and the layers above it. Lower layers are based on IEEE [IEEE ] which defines the MAC sublayer and the physical layer. This specification defines OMA DM management objects to represent ZigBee devices so that these devices can be managed through an OMA DM Server and DM Gateway pair. The ZigBee Device MO is dependent on and SHOULD be used together with GwMO TS v1.1 [GwMO TS]. 4.1 Version 1.0 This version defines ZigBee device MO to represent ZigBee devices Open Mobile Alliance All Rights Reserved.

8 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 8 (42) 5. ZigBee Management Object The management object for ZigBee device capabilities is based on the [ZigBee2007] specification. 5.1 MO diagram This MO diagram is composed of following three sub-trees. Nodes under Discovery are shown in Figure 2. Figure 1 ZigBee MO (Overview) Figure 2 ZigBeeMO sub-tree under Discovery 2017 Open Mobile Alliance All Rights Reserved.

9 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 9 (42) Nodes under Interface are shown in Figure 3. Nodes under ZDO are shown in Figure 4. Figure 3 ZigBee MO sub-tree under Interface 2017 Open Mobile Alliance All Rights Reserved.

11 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 11 (42) 5.2 MO Descriptions <x> Figure 4 ZigBee MO sub-tree under ZDO Required One node Get This placeholder node is for storing information regarding the ZigBee End Device deployed. This node specifies a reference to the Management Tee of the ZigBee End Device. The identifier for the ZigBee devices MUST be: urn:oma:mo: oma-dm-zigbee:1.0. <x>/interfacenumberofentries The number of entries in the Interface table. Value of this node MUST be a positive integer. <x>/zdonumberofentries The number of entries in the ZDO table. Value of this node MUST be a positive integer. <x>/discovery Required One node Get This object is used for managing the discovery of ZigBee devices within a ZigBee Area Network. ZigBee Devices are discovered via the ZDO instance associated with the ZigBee Coordinator of an Area Network. <x>/discovery/areanetworknumberofentries The number of entries in the AreaNetwork table. Value of this node MUST be a positive integer Open Mobile Alliance All Rights Reserved.

12 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 12 (42) <x>/discovery/areanetwork Required One node Get This object specifies the ZigBee devices that are discovered by the Coordinator. As the ZigBee specification does not provide a discovery protocol between the DM Gatewayand the ZigBee coordinator, the AreaNetwork object is provisioned and not discovered. At most one entry in this table (regardless of whether or not it is enabled) can exist with a given value for Alias. On creation of a new table entry, the device MUST choose an initial value for Alias such that the new entry does not conflict with any existing entries. At most one enabled entry in this table can exist with a given value for Coordinator. <x>/discovery/areanetwork/<x> Required OneOrMore node Get, Replace This placeholder node is for OneOrMore AreaNetwork entries. <x>/discovery/areanetwork/<x>/enable Required One bool Get, Replace Enables or disables discovery of the ZigBee devices in this AreaNetwork <x>/discovery/areanetwork/<x>/lastupdate The date and time when this AreaNetwork or its member devices (i.e., the devices with ZDOs listed in ZDOList) were updated due to a discovery operation. The representation of this node MUST follow the [YYYY]-[MM]-[DD] T[hh]:[mm]Z format, as defined by [ISO 8601]. <x>/discovery/areanetwork/<x>/status The status of the current discovery operation. Indeterminate (The discovery operation has not been executed and there are no valid discovery results available)) InProgress Success 2017 Open Mobile Alliance All Rights Reserved.

13 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 13 (42) Error Error_Timeout (OPTIONAL) <x>/discovery/areanetwork/<x>/alias, Replace A non-volatile handle used to reference this instance. Alias provides a mechanism for a DM Server to label this instance for future reference. If the device supports the Alias-based Addressing feature the following mandatory constraints MUST be enforced: Its value MUST NOT be empty. Its value MUST start with a letter. If its instance object is created by the Device, the initial value MUST start with a "device-" prefix. The Device MUST NOT change the parameter value. The string length of this node MUST NOT exceed 64. <x>/discovery/areanetwork/<x>/coordinator, Replace The Fully Qualified Domain Name (FQDN) or IP address of the ZigBee Coordinator. The Coordinator MAY be located within the Device. In this scenario the Server or Device MAY use the value of "localhost". The string length of this node MUST NOT exceed 256. <x>/discovery/areanetwork/<x>/zdoreference The ZDO object for this device that is used to discover the ZigBee capabilities of attached devices. The value MUST be the path name of a row in the ZigBee ZDO table. If the referenced object is deleted, the parameter value MUST be set to an empty string. The string length of this node MUST NOT exceed Open Mobile Alliance All Rights Reserved.

14 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 14 (42) <x>/discovery/areanetwork/<x>/zdolist Comma-separated list of strings (maximum length 256). The list of ZDO objects discovered in this Area Network by the ZigBee Coordinator. Each list item MUST be the path name of a row in the ZigBee ZDO table. If the referenced object is deleted, the corresponding item MUST be removed from the list. <x>/interface Required One node Get ZigBee interface table is a stackable interface object. This table models the ZigBee interface of a ZigBee end device, ZigBee router or ZigBee coordinator. At most one entry in this table can exist with a given value for Alias, or with a given value for Name, or with a given value for ZDOReference. <x>/interface/<x> Required OneOrMore node Get, Replace This placeholder node is for OneOrMore Interface entries. <x>/interface/<x>/enable Required One bool Get, Replace Enables or disables the interface. This parameter is based on ifadminstatus from [RFC2863]. <x>/interface/<x>/status The current operational state of the interface Enumeration of: Up Down 2017 Open Mobile Alliance All Rights Reserved.

15 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 15 (42) Unknown Dormant NotPresent LowerLayerDown Error (OPTIONAL) When Enable is false then Status SHOULD normally be Down (or NotPresent or Error if there is a fault condition on the interface). When Enable is changed to true then Status SHOULD change to Up if and only if the interface is able to transmit and receive network traffic; it SHOULD change to Dormant if and only if the interface is operable but is waiting for external actions before it can transmit and receive network traffic (and subsequently change to Up if still operable when the expected actions have completed); it SHOULD change to LowerLayerDown if and only if the interface is prevented from entering the Up state because one or more of the interfaces beneath it is down; it SHOULD remain in the Error state if there is an error or other fault condition detected on the interface; it SHOULD remain in the NotPresent state if the interface has missing (typically hardware) components; it SHOULD change to Unknown if the state of the interface can not be determined for some reason. This parameter is based on ifoperstatus from [RFC2863]. <x>/interface/<x>/alias, Replace A non-volatile handle used to reference this instance. Alias provides a mechanism for a Server to label this instance for future reference. If the Device supports the Alias-based Addressing feature the following mandatory constraints MUST be enforced: Its value MUST NOT be empty. Its value MUST start with a letter. If its instance object is created by the Device, the initial value MUST start with a "device-" prefix. The DeviceMUST NOT change the parameter value. The string length of this node MUST NOT exceed 64. <x>/interface/<x>/name The textual name of the interface as assigned by the Device. The string length of this node MUST NOT exceed Open Mobile Alliance All Rights Reserved.

16 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 16 (42) <x>/interface/<x>/lastchange The accumulated time in seconds since the interface entered its current operational state. The node value MUST be positive. <x>/interface/<x>/lowerlayers, Replace Comma-separated list (maximum length 1024) of strings. Each list item MUST be the path name of an interface object that is stacked immediately below this interface object. If the referenced object is deleted, the corresponding item MUST be removed from the list. The string length of this node MUST NOT exceed <x>/interface/<x>/ieeeaddress The IEEE address assigned to this interface. A value of "FF:FF:FF:FF:FF:FF:FF:FF" indicates that this address is unknown. This parameter has the same value as the ZigBee ZDO/IEEEAddress parameter of the ZDO instance ZDOReference is pointing to. The string length of this node MUST NOT exceed 23. <x>/interface/<x>/networkaddress The ZigBee network address assigned to this interface. This parameter has the same value as the ZigBee ZDO/NetworkAddress parameter of the ZDO instance ZDOReference is pointing to. The string length of this node MUST NOT exceed Open Mobile Alliance All Rights Reserved.

17 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 17 (42) <x>/interface/<x>/zdoreference The value MUST be the path name of a row in the ZigBee ZDO table. If the referenced object is deleted, the parameter value MUST be set to an empty string. The ZigBee Device Object assigned to this interface. The string length of this node MUST NOT exceed 256. <x>/interface/<x>/associateddevicenumberofentries The number of entries in the AssociatedDevice table. The node value MUST be positive. <x>/interface/<x>/associateddevice Required One node Get This table provides information about other ZigBee devices that are directly accessible via this interface. At most one entry in this table can exist with the same values for IEEEAddress and NetworkAddress. It is possible that instances of this object have the same key value when the value of IEEEAddress parameter is "FF:FF:FF:FF:FF:FF:FF:FF" and the ZigBee Coordinators on two or more separate area networks assign the same value for the NetworkAddress. This is because the ZigBee specification describes only intra-area network topologies in Section Network Topology in [ZigBee2007]. As such if two or more AssociatedDevice instances have the same key value the implemenation is undefined. <x>/interface/<x>/associateddevice/<x> Required OneOrMore node Get This is placeholder node for OneOrMore AssociatedDevice. <x>/interface/<x>/associateddevice/<x>/ieeeaddress The IEEE address assigned to this device. A value of "FF:FF:FF:FF:FF:FF:FF:FF" indicates that this address is unknown Open Mobile Alliance All Rights Reserved.

18 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 18 (42) The string length of this node MUST NOT exceed 23. <x>/interface/<x>/associateddevice/<x>/networkaddress The ZigBee network address assigned to this device. The string length of this node MUST NOT exceed 4. <x>/interface/<x>/associateddevice/<x>/active Required One bool Get Whether or not this device is currently present in the ZigBee network as defined in Section [ZigBee2007]. The ability to list inactive devices is OPTIONAL. If the Device includes inactive devices in this table, Active MUST be set to false for each inactive device. The length of time an inactive device remains listed in this table is a local matter to the Device. <x>/interface/<x>/associateddevice/<x>/zdoreference The value MUST be the path name of a row in the ZigBee ZDO table. If the referenced object is deleted, the parameter value MUST be set to an empty string. The ZigBee Device Object assigned to this interface. The string length of this node MUST NOT exceed 256. <x>/interface/<x>/stats/ Required One node Get Throughput statistics for this interface. The Device MUST reset the interface's Stats parameters (unless otherwise stated in individual object or parameter descriptions) either when the interface becomes operationally down due to a previous administrative down (i.e. the interface's Status parameter transitions to a down state after the interface is disabled) or when the interface becomes administratively up (i.e. the interface's Enable parameter transitions from false to true) Open Mobile Alliance All Rights Reserved.

19 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 19 (42) <x>/interface/<x>/stats/bytessent The total number of bytes transmitted out of the interface, including framing characters. The value of this node MUST be 64 bits positive. <x>/interface/<x>/stats/bytesreceived The total number of bytes received on the interface, including framing characters. The value of this node MUST be 64 bits positive. <x>/interface/<x>/stats/packetssent The total number of ZigBee packets sent transmitted out of the interface. The value of this node MUST be 64 bits positive. <x>/interface/<x>/stats/packetsreceived The total number of ZigBee packets received by the interface. The value of this node MUST be 64 bits positive. <x>/interface/<x>/stats/errorssent The total number of ZigBee packets discarded by interface due to any error. The value of this node MUST be 32 bits positive Open Mobile Alliance All Rights Reserved.

20 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 20 (42) <x>/interface/<x>/stats/errorsreceived The total number of ZigBee packets received that contained errors preventing them from being delivered to a higher-layer protocol. The value of this node MUST be 32 bits positive. <x>/interface/<x>/stats/unicastpacketssent The total number of ZigBee packets requested for transmission which were not addressed to a multicast or broadcast address at this layer, including those that were discarded or not sent. The value of this node MUST be 32 bits positive. <x>/interface/<x>/stats/unicastpacketsreceived Required One int Get, Add, Delete, Replace The total number of ZigBee packets received which were not addressed to a multicast or broadcast address at this layer. The value of this node MUST be 32 bits positive. <x>/interface/<x>/stats/discardpacketssent The total number of ZigBee packets requested for transmission which were chosen to be discarded even though no errors had been detected to prevent the ZigBee packets being transmitted. The value of this node MUST be 32 bits positive. <x>/interface/<x>/stats/discardpacketsreceived The total number of ZigBee packets received which were chosen to be discarded even though no errors had been detected to prevent their being delivered. The value of this node MUST be 32 bits positive Open Mobile Alliance All Rights Reserved.

21 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 21 (42) <x>/interface/<x>/stats/multicastpacketssent The total number of ZigBee packets requested for transmission which were addressed to a multicast address at this layer, including those that were discarded or not sent. The value of this node MUST be 32 bits positive. <x>/interface/<x>/stats/multicastpacketsreceived The total number of ZigBee packets received which were addressed to a multicast address at this layer and delivered by this layer to a higher layer. The value of this node MUST be 32 bits positive. <x>/interface/<x>/stats/broadcastpacketssent The total number of ZigBee packets received which were addressed to a broadcast address at this layer and delivered by this layer to a higher layer. The value of this node MUST be 32 bits positive. <x>/interface/<x>/stats/broadcastpacketsreceived The total number of ZigBee packets received which were addressed to a broadcast address at this layer and delivered by this layer to a higher layer. The value of this node MUST be positive with 32 bits. <x>/interface/<x>/stats/unknownpacketsreceived The total number of ZigBee packets received which were discarded because of an unknown or unsupported protocol. The value of this node MUST be 32 bits positive Open Mobile Alliance All Rights Reserved.

22 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 22 (42) <x>/zdo Required One node Get ZigBee Device Object (ZDO) provides management capabilities of the ZigBee Application Support (APS) and Network (NWK) layers of a ZigBee Device as defined in Section 2.5 [ZigBee2007]. At most one entry in this table can exist with the same values for IEEEAddress and NetworkAddress. It is possible that instances of this object have the same key value when the value of IEEEAddress parameter is "FF:FF:FF:FF:FF:FF:FF:FF" and the ZigBee Coordinators on two or more separate area networks assign the same value for the NetworkAddress. This is because the ZigBee specification describes only intra-area network topologies in Section Network Topology [ZigBee2007]. As such if two or more ZDO instances have the same key value the implemenation is undefined <x>/zdo/<x> Required OneOrMore node Get This is a placeholder node for ZDO entries. <x>/zdo/<x>alias, Replace A non-volatile handle used to reference this instance. Alias provides a mechanism for an Server to label this instance for future reference. If the Device supports the Alias-based Addressing feature, the following mandatory constraints MUST be enforced: Its value MUST NOT be empty. Its value MUST start with a letter. If its instance object is created by the Device, the initial value MUST start with a "Device-" prefix. The Device MUST NOT change the parameter value. This string length of this node MUST be 64. <x>/zdo/<x>/ieeeaddress The IEEE address assigned to this device. A value of "FF:FF:FF:FF:FF:FF:FF:FF" indicates that this address is unknown. This string length of this node MUST be Open Mobile Alliance All Rights Reserved.

23 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 23 (42) <x>/zdo/<x>/networkaddress The ZigBee network address assigned to this device. This string length of this node MUST be 4. <x>/zdo/<x>/bindingtablenumberofentries The number of entries in the Binding table. This node value must be positive. <x>/zdo/<x>/groupnumberofentries The number of entries in the Group table. This node value must be positive. <x>/zdo/<x>/ ApplicationEndpointNumberOfEntries The number of entries in the ApplicationEndpoint table. This node value must be positive. <x>/zdo/<x>/nodedescriptor Required One node Get The NodeDescriptor object describes the node capabilities of the ZigBee device as defined in Section Node Descriptor [ZigBee2007]. <x>/zdo/<x>/nodedescriptor/logicaltype The type of ZigBee device that is extracted from the Logical Type Field as defined in Table 2.29 [ZigBee2007]. ZC (ZigBee Coordinator) ZR (ZigBee Router) 2017 Open Mobile Alliance All Rights Reserved.

24 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 24 (42) ZED (ZigBee End Device) <x>/zdo/<x>/ NodeDescriptor/ComplexDescriptorSupported Required One bool Get When true, specifies that the ComplexDescriptor object is supported for this ZigBee device. <x>/zdo/<x>/ NodeDescriptor/UserDescriptorSupported Required One bool Get When true, specifies that the UserDescriptor object is supported for this ZigBee device. <x>/zdo/<x>/ NodeDescriptor/FrequencyBand Specifies the frequency bands that are supported by the underlying IEEE radio utilized by the ZigBee device. Comma-separated list of strings. Each list item is an enumeration of: (The MHz Band) (The MHz Band) (The MHz Band) <x>/zdo/<x>/ NodeDescriptor/MACCapability Specifies the IEEE MAC sub-layer capabilities for this ZigBee device. Comma-separated list of strings. Each list item is an enumeration of: AlternatePANCoordinator (Alternate PAN Coordinator) FFD (Full Function Device) MainsPowerSource (The current power source is mains power) OnWhenIdle (The receiver is on when idle) SecureCommunication (Secure communication is enabled) 2017 Open Mobile Alliance All Rights Reserved.

25 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 25 (42) <x>/zdo/<x>/ NodeDescriptor/ManufactureCode Specifies a manufacturer code that is allocated by the ZigBee Alliance, relating the manufacturer to the device. This node MUST be positive and MUST NOT exceed the value <x>/zdo/<x>/ NodeDescriptor/MaximumBufferSize Specifies the maximum buffer size, in octets, of the network sub-layer data unit (NSDU) for this ZigBee device. This node MUST be positive and MUST NOT exceed the value 128. <x>/zdo/<x>/ NodeDescriptor/MaximumIncomingTransferSize Specifies the maximum size, in octets, of the application sub-layer data unit (ASDU) that can be transferred to this ZigBee device in one single message transfer. This node MUST be positive and MUST NOT exceed the value <x>/zdo/<x>/ NodeDescriptor/MaximumOutgoingTransferSize Specifies the maximum size, in octets, of the application sub-layer data unit (ASDU) that can be transferred from this ZigBee device in one single message transfer. This node MUST be positive and MUST NOT exceed the value <x>/zdo/<x>/ NodeDescriptor/ServerMask Specifies the system server capabilities of this ZigBee device. Comma-separated list of strings. Each list item is an enumeration of: PrimaryTrustCenter PrimaryBindingTableCache BackupBindingTableCache PrimaryDiscoveryCache BackupDiscoveryCache 2017 Open Mobile Alliance All Rights Reserved.

26 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 26 (42) NetworkManager <x>/zdo/<x>/ NodeDescriptor/DescriptorCapability Specifies the descriptor capabilities of this ZigBee device. Comma-separated list of strings. Each list item is an enumeration of: ExtendedActiveEndpointListAvailable ExtendedSimpleDescriptorListAvailable <x>/zdo/<x>/ ComplexDescriptor Optional One Node Get The ComplexDescriptor object is an optional descriptor that describes extended capabilities of the ZigBee device as defined in Section Complex Descriptor [ZigBee2007]. This MUST be present if <x>/zdo/<x>/ NodeDescriptor/ComplexDescriptorSupported node is true. <x>/zdo/<x>/ ComplexDescriptor/DescriptorAvailable Required One bool Get When true, the Complex Descriptor recorded has been received from the target device. <x>/zdo/<x>/ ComplexDescriptor/Language Specifies the ISO language code as defined in [ISO639-1]. <x>/zdo/<x>/ ComplexDescriptor/CharacterSet Specifies the ISO 646 character set as defined in [ISO ] Open Mobile Alliance All Rights Reserved.

27 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 27 (42) <x>/zdo/<x>/ ComplexDescriptor/ManufacturerName Specifies the name of the manufacturer of the ZigBee device. <x>/zdo/<x>/ ComplexDescriptor/ModelName Specifies the name of the manufacturer's model of the ZigBee device. <x>/zdo/<x>/ ComplexDescriptor/SerialNumber Specifies the manufacturer's serial number of the ZigBee device. <x>/zdo/<x>/ ComplexDescriptor/DeviceURL Specifies the URL through which more information relating to the ZigBee device can be obtained. <x>/zdo/<x>/ ComplexDescriptor/Icon Required One bin Get The icon field contains an octet string which carries the data for an icon that can represent the ZigBee device. The format of the icon MUST be a 32-by-32-pixel PNG image. <x>/zdo/<x>/ ComplexDescriptor/IconURL Specifies the URL through which the icon for the ZigBee device can be obtained Open Mobile Alliance All Rights Reserved.

28 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 28 (42) <x>/zdo/<x>/applicationendpoint Required One node Get The ApplicationEndpoint object describes the application endpoint as defined in Section Application Framework [ZigBee2007]. At most one entry in this table (regardless of whether or not it is enabled) can exist with a given value for Alias. On creation of a new table entry, the Device MUST choose an initial value for Alias such that the new entry does not conflict with any existing entries. At most one enabled entry in this table can exist with a given value for EndpointId. <x>/zdo/<x>/applicationendpoint/<x> Required OneOrMore node Get, Replace This node is a placeholder for OneOrMore ApplicationEndpoint entries. <x>/zdo/<x>/applicationendpoint/<x>/enable Required One bool Get, Replace Enables or disables the use of this application endpoint on the device. <x>/zdo/<x>/applicationendpoint/<x>/alias, Replace A non-volatile handle used to reference this instance. Alias provides a mechanism for a Server to label this instance for future reference. If the Device supports the Alias-based Addressing feature, the following mandatory constraints MUST be enforced: Its value MUST NOT be empty. Its value MUST start with a letter. If its instance object is created by the Device, the initial value MUST start with a "device-" prefix. The Device MUST NOT change the parameter value. The string length of this node MUST NOT exceed Open Mobile Alliance All Rights Reserved.

29 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 29 (42) <x>/zdo/<x>/applicationendpoint/<x>/endpointid, Replace The Endpoint Identifier for this object as defined in Section Application Framework [ZigBee2007]. An ApplicationEndpoint with an EndpointId value of 0 is designated as the device application: This is a special application that is responsible for device operation and contains logic to manage the device's networking and general maintenance features. The value of this node MUST be positive and MUST NOT exceed 240. <x>/zdo/<x>/ ApplicationEndpoint/<x>/SimpleDescriptor Required One node Get The SimpleDescriptor object contains the attributes of the Simple Descriptor of an application endpoint, as defined in Section Simple Descriptor [ZigBee2007]. <x>/zdo/<x>/applicationendpoint/<x>/simpledescriptor/profileid, Replace Specifies the application profile that is supported on this endpoint. Application profiles are agreements for messages, message formats, and processing actions that enable developers to create an interoperable, distributed application employing application entities that reside on separate ZigBee devices. These application profiles enable applications to send commands, request data, and process commands and requests as defined in Section Application Profiles [ZigBee2007]. The value of this node MUST be positive and MUST NOT exceed <x>/zdo/<x>/applicationendpoint/<x>/simpledescriptor/deviceid Application device identifier, as defined in Section Application Device Identifier Field [ZigBee2007]. The value of this node MUST be positive and MUST NOT exceed <x>/zdo/<x>/applicationendpoint/<x>/simpledescriptor/deviceversion Application device version, as defined in Section Application Device Version Field [ZigBee2007]. The value of this node MUST be positive and MUST NOT exceed Open Mobile Alliance All Rights Reserved.

30 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 30 (42) <x>/zdo/<x>/applicationendpoint/<x>/simpledescriptor/inputclusterlist, Replace Comma-separated list of unsigned integers (value 0 to 65535). Specifies the input cluster identifiers to be matched by the ZigBee coordinator by remote Zigbee device's output cluster list for this SimpleDescriptor object. <x>/zdo/<x>/applicationendpoint/<x>/simpledescriptor/outputclusterlist, Replace Comma-separated list of unsigned integers (value 0 to 65535). Specifies the output cluster identifiers to be matched by the ZigBee coordinator by remote Zigbee device's input cluster list for this SimpleDescriptor object. <x>/zdo/<x>/powerdescriptor Required One node Get The PowerDescriptor object describes the power capabilities of the ZigBee device as defined in Section Node Power Descriptor [ZigBee2007]. <x>/zdo/<x>/powerdescriptor/currentpowermode Specifies the current sleep/power-saving mode of the ZigBee device. Synchronized Periodic Manual <x>/zdo/<x>/powerdescriptor/availablepowersource Specifies the power sources available on this ZigBee device. Comma-separated list of strings. Each list item is an enumeration of: Constant (Constant (mains) power) Rechargeable (Rechargable battery) Disposable (Disposable battery) 2017 Open Mobile Alliance All Rights Reserved.

31 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 31 (42) <x>/zdo/<x>/powerdescriptor/currentpowersource The current power source field specifies the current power source being utilized by the node. Constant (Constant (mains) power) Rechargeable (Rechargable battery) Disposable (Disposable battery) <x>/zdo/<x>/powerdescriptor/currentpowersourcelevel Specifies the level of charge of the current power source. Critical (Critical battery state) 33 (Battery state is 33 percent) 66 (Battery state is 66 percent) 100 (Battery state is 100 percent) <x>/zdo/<x>/>/userdescriptor Optional One node Get The UserDescriptor object is an optional descriptor that describes user defined capabilities of the ZigBee device as defined in Section User Descriptor [ZigBee2007]. The UserDescriptor object contains information that allows the user to identify the device using a user-friendly character string, such as "Bedroom TV" or "Stairs Light". This MUST be present if <x>/zdo/<x>/ NodeDescriptor/UserDescriptorSupported node is true. <x>/zdo/<x> UserDescriptor/DescriptorAvailable Required One bool Get When true, the User Descriptor recorded has been received from the target device Open Mobile Alliance All Rights Reserved.

32 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 32 (42) <x>/zdo/<x>/userdescriptor/description Specifies the information that allows the user to identify the ZigBee device using a user-friendly character string, such as "Bedroom TV" or "Stairs light". This node string length MUST NOT exceed 16. <x>/zdo/<x>/security Required One node Get The Security object provides the configuration capabilities needed to perform the Security Management functionality defined in Section 4 Security Management [ZigBee2007]. <x>/zdo/<x>/security/trustcenteraddress Specifies the IEEE address of a special device trusted by devices within a ZigBee network to distribute keys for the purpose of network and end-to-end application configuration management. This node string length MUST NOT exceed 23. <x>/zdo/<x>/security/securitylevel Specifies how an outgoing frame is to be secured, how an incoming frame purportedly has been secured; it also indicates whether or not the payload is encrypted and to what extent data authenticity over the frame is provided, as reflected by the length of the message integrity code (MIC). None MIC-32 MIC-64 MIC-128 ENC ENC-MIC-32 ENC-MIC-64 ENC-MIC Open Mobile Alliance All Rights Reserved.

33 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 33 (42) <x>/zdo/<x>/security/timeoutperiod The period of time, in milliseconds, that this ZigBee device will wait for an expected security protocol frame. This MUST be positive integer and the value MUST NOT exceed <x>/zdo/<x>/group Required One node Get The Group object describes the configuration capabilities related to maintaining a ZigBee Device's Group Table as defined in Section Group Manager [ZigBee2007]. At most one entry in this table (regardless of whether or not it is enabled) can exist with a given value for Alias. On creation of a new table entry, the Device MUST choose an initial value for Alias such that the new entry does not conflict with any existing entries. At most one enabled entry in this table can exist with a given value for GroupId. <x>/zdo/<x>/group/<x> Required OneOrMore node Get, Replace This is a placeholder node for OneOrMore Group entries. <x>/zdo/<x>/group/<x>/enable Required One bool Get, Replace Enables or disables the use of this group on the device. <x>/zdo/<x>/group/<x>/alias, Replace A non-volatile handle used to reference this instance. Alias provides a mechanism for an Server to label this instance for future reference. If the Device supports the Alias-based Addressing feature as, the following mandatory constraints MUST be enforced: Its value MUST NOT be empty. Its value MUST start with a letter Open Mobile Alliance All Rights Reserved.

34 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 34 (42) If its instance object is created by the Device, the initial value MUST start with a "cpe-" prefix. The Device MUST NOT change the parameter value. This node string length MUST NOT exceed 64. <x>/zdo/<x>/group/<x>/groupid, Replace The Group Identifier for this object as defined in Table 2.25 Group Table Entry Format [ZigBee2007]. This node string length MUST NOT exceed 4. <x>/zdo/<x>/group/<x>/endpointlist, Replace Comma-separated list of strings (maximum length 256). Each list item MUST be the path name of a row in the ZigBee ZDO/ApplicationEndpoint table. If the referenced object is deleted, the corresponding item MUST be removed from the list. The list of application endpoints assigned as a member of this Group object. <x>/zdo/<x>/binding Required One node Get The Binding object describes the configuration capabilities related to maintaining a ZigBee Device's Binding Table as defined in Section Binding [ZigBee2007]. At most one entry in this table (regardless of whether or not it is enabled) can exist with a given value for Alias. On creation of a new table entry, the Device MUST choose an initial value for Alias such that the new entry does not conflict with any existing entries. <x>/zdo/<x>/binding/<x> Required OneOrMore node Get, Replace This is a placeholder node for Binding entries. <x>/zdo/<x>/binding/<x>/enable Required One bool Get, Replace Enables or disables the use of this binding on the device Open Mobile Alliance All Rights Reserved.

35 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 35 (42) <x>/zdo/<x>/binding/<x>/alias, Replace A non-volatile handle used to reference this instance. Alias provides a mechanism for a Server to label this instance for future reference. If the Device supports the Alias-based Addressing feature, the following mandatory constraints MUST be enforced: Its value MUST NOT be empty. Its value MUST start with a letter. If its instance object is created by the Device, the initial value MUST start with a "device-" prefix. The Device MUST NOT change the parameter value. This node string length MUST NOT exceed 64. <x>/zdo/<x>/binding/<x>/sourceendpoint, Replace Specifies the source endpoint used in this binding entry. This MUST be positive integer and the value MUST NOT exceed 240. <x>/zdo/<x>/binding/<x>/sourceaddress, Replace Specifies the source address used in this binding entry. This node string length MUST NOT exceed 23. <x>/zdo/<x>/binding/<x>/clusterid,, Replace Specifies the cluster identifier used in this binding entry. This MUST be positive integer and the value MUST NOT exceed <x>/zdo/<x>/binding/<x>/destinationaddressmode, Replace Specifies the type of destination address used for this binding entry. Enumeration of: Group 2017 Open Mobile Alliance All Rights Reserved.

36 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 36 (42) Endpoint <x>/zdo/<x>/binding/<x>/destinationendpoint, Replace Specifies the destination endpoint for the binding entry. The value of this field is valid when the value of the DestinationAddressMode is Endpoint. This MUST be positive integer and the value MUST NOT exceed 240. <x>/zdo/<x>/binding/<x>/ieeedestinationaddress, Replace Specifies the IEEE destination address for this binding entry. The value of this field is valid when the value of the DestinationAddressMode is Endpoint. This node string length MUST NOT exceed 23. <x>/zdo/<x>/binding/<x>/groupdestinationaddress, Replace Specifies the group destination address for this binding entry. The value of this field is valid when the value of the DestinationAddressMode is Group. This node string length MUST NOT exceed 4. <x>/zdo/<x>/network Required One node Get The Network object provides the configuration capabilities needed to by a ZigBee Device to operate within a ZigBee Area Network as defined in Section Network Manager [ZigBee2007]. <x>/zdo/<x>/network/neighbornumberofentries Required One node Gete The number of entries in the Neighbor table. This MUST be a positive integer Open Mobile Alliance All Rights Reserved.

37 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 37 (42) <x>/zdo/<x>/network/neighbour Required One node Get The Neighbor object provides the configuration capabilities needed to by a ZigBee Device to operate within a ZigBee Area Network as defined in Section Network Manager [ZigBee2007]. At most one entry in this table can exist with a given value for Neighbor. <x>/zdo/<x>/network/neighbour/<x> Required OneOrMore node Get This is placeholder node for OneOrMore <x>/zdo/<x>/network/neighbour entries. <x>/zdo/<x>/network/neighbour/<x>/neighbor The value MUST be the path name of a row in the ZigBee ZDO table. If the referenced object is deleted, the parameter value MUST be set to an empty string. Neighbor of this ZigBee device. The value MUST be the path name of a row in the ZigBee.ZDO table. If the referenced row is deleted then this entry MUST be deleted. <x>/zdo/<x>/network/neighbour/<x>/lqi The LQI field specified link quality identification (LQI) for neighbor ZigBee device. This MUST be positive integer and the value MUST NOT exceed 255. <x>/zdo/<x>/network/neighbour/<x>/relationship The relationship between the neighbor and this device.enumeration of: Parent Child PrevChild Sibling None 2017 Open Mobile Alliance All Rights Reserved.

38 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 38 (42) <x>/zdo/<x>/network/neighbour/<x>/permitjoin An indication of whether the neighbor device is accepting join requests.enumeration of: Accepting NotAccepting Unknown <x>/zdo/<x>/network/neighbour/<x>/depth The tree depth of the neighbor device. A value of 0x00 indicates that the device is the ZigBee coordinator for the network. This MUST be positive integer. <x>/zdo/<x>/nodemanager Required One node Get The NodeManager object describes the configuration capabilities related for remote management of the ZigBee Area Network as defined in Section Node Manager [ZigBee2007]. <x>/zdo/<x>/nodemanager/routingtablenumberofentries The number of entries in the RoutingTable table. This MUST be positive integer. <x>/zdo/<x>/nodemanager/routingtable Required One node Get The RoutingTable object describes the route table as defined in Table 3.51 Routing Table Entry [ZigBee2007]. At most one entry in this table can exist with a given value for DestinationAddress Open Mobile Alliance All Rights Reserved.

39 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 39 (42) <x>/zdo/<x>/nodemanager/routingtable/<x> Required OneOrMore node Get This is placeholder node for OneOrMore RoutingTable entries. <x>/zdo/<x>/nodemanager/routingtable/<x>/destinationaddress The ZigBee network address of this route. Possible patterns: ([0-9A-Fa-f]){4} This node string length MUST NOT exceed 4. <x>/zdo/<x>/nodemanager/routingtable/<x>/nexthopaddress Specifies the network address of the next hop ZigBee device on the way to the destination ZigBee device. This node string length MUST NOT exceed 4. <x>/zdo/<x>/nodemanager/routingtable/<x>/status The status of the route entry. Enumeration of: Active DiscoveryUnderway DiscoveryFailed Inactive ValidationUnderway <x>/zdo/<x>/nodemanager/routingtable/<x>/memoryconstrained Required One bool Get A flag indicating whether the device is a memory constrained concentrator Open Mobile Alliance All Rights Reserved.

40 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 40 (42) <x>/zdo/<x>/nodemanager/routingtable/<x>/manytoone Required One bool Get A flag indicating that the destination is a concentrator that issued a many to-one request. <x>/zdo/<x>/nodemanager/routingtable/<x>/routerecordrequired Required One bool Get A flag indicating that a route record command frame should be sent to the destination prior to the next data packet Open Mobile Alliance All Rights Reserved.

41 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 41 (42) Appendix A. Change History (Informative) A.1 Approved Version History Reference Date Description OMA-TS-DM-GwMO_ZigBeeMO-V1_ A 25 Jul 2017 Status changed to Approved by TP TP Ref # OMA-TP INP_GwMO-V1_1_ERP_for_Final_Approval 2017 Open Mobile Alliance All Rights Reserved.

42 OMA-TS-DM-GwMO_ZigBeeMO-V1_ A Page 42 (42) Appendix B. Static Conformance Requirements (Normative) The notation used in this appendix is specified in [SCRRULES]. B.1 SCR for GwMO Client B.1.1 SCR for ZigBee MO Item Function Reference Requirement GwMO-ZB-C-001-M Support for updating Section 5.2 GwMO-C-007-O ZigBee MO when the GW becomes aware of a new ZigBee Device GwMO-ZB-C-002-M Support for updating ZigBee MO when the GW becomes aware of a previously subtending Device that is no longer present in the network Section 5.2 GwMO-C-007-O B.2 SCR for GwMO Server Item Function Reference Requirement GwMO-ZB-S-001-M Support for the ZigBee Section 5 GwMO-S-001-M Management Object 2017 Open Mobile Alliance All Rights Reserved.

NGSI Common Definitions

NGSI Common Definitions Approved Version 1.0 29 May 2012 Open Mobile Alliance OMA-TS-NGSI_Common-V1_0-20120529-A OMA-TS-NGSI_Common-V1_0-20120529-A Page 2 (12) Use of this document is subject to all of