ZigBee Cluster Library Specification

1 ZigBee Cluster Library Document 075123 Copyright 2007-2016, The ZigBee Alliance. All rights reserved. Page 1 ZigBee Cluster Library Specification Revision 6 Draft Version Chapter Document: 14-0125 ZigBee Document: 07-5123-06 ZigBee Document 07-5123 Date of release 14 January 2016 Sponsored by ZigBee Alliance Accepted by This document has been accepted for release by the ZigBee Alliance Board of Directors. Abstract This document defines the ZigBee Cluster Library revision 6 (ZCL6). Keywords ZigBee Cluster Library , ZCL, ZCL6, Application Framework ZigBee Cluster Library Specification ZigBee Document 075123 Page 2 Copyright 2007-2016, The ZigBee Alliance.

2 All rights reserved. Notice of Use and Disclosure Copyright ZigBee Alliance, Inc. (1996-2016). All rights Reserved. This information within this document is the property of the ZigBee Alliance and its use and disclosure are restricted. Elements of ZigBee Alliance specifications may be subject to third party intellectual property rights, in-cluding without limitation, patent, copyright or trademark rights (such a third party may or may not be a member of ZigBee ). ZigBee is not responsible and shall not be held responsible in any manner for identifying or failing to identify any or all such third party intellectual property rights.

3 No right to use any ZigBee name, logo or trademark is conferred herein. Use of any ZigBee name, logo or trademark requires membership in the ZigBee Alliance and compliance with the ZigBee Logo and Trade-mark Policy and related ZigBee policies. This document and the information contained herein are provided on an AS IS basis and ZigBee DIS-CLAIMS ALL WARRANTIES EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO (A) ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OF THIRD PARTIES (INCLUDING WITHOUT LIMITATION ANY INTELLECTUAL PROPERTY RIGHTS INCLUDING PATENT, COPYRIGHT OR TRADEMARK RIGHTS) OR (B) ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE OR NONINFRINGEMENT.

4 IN NO EVENT WILL ZigBee BE LIABLE FOR ANY LOSS OF PROFITS, LOSS OF BUSINESS, LOSS OF USE OF DATA, INTERRUPTION OF BUSINESS, OR FOR ANY OTHER DIRECT, INDIRECT, SPECIAL OR EXEMPLARY, INCIDENTIAL, PUNITIVE OR CONSEQUENTIAL DAMAGES OF ANY KIND, IN CONTRACT OR IN TORT, IN CONNECTION WITH THIS DOCUMENT OR THE INFORMATION CONTAINED HEREIN, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH LOSS OR DAMAGE. All Company, brand and product names may be trademarks that are the sole property of their respective owners. The above notice and this paragraph must be included on all copies of this document that are made.

5 ZigBee Cluster Library Document 075123 Copyright 2007-2016, The ZigBee Alliance. All rights reserved. Page 3 Participants The following is a list of ZigBee members who contributed to this document: Cam Williams - Chair of the Foundation Working Group Rob Alexander Jared Lemke Shane Almeida Christopher Leidigh Casey Anderson Yingbo Li Skip Ashton Marco Naeve Wally Barnum Alexis Martin Ettore Colicchio Juan Agui Martin Jeff Cooper Jeff Mathews Damon Corbin Tony Mauro John Cowburn Leslie Mulder Robert Cragie Luca Negri Jonathan Cressman Ivan O Neill Tim Gillman Isaac Pinhas Drew Gislason Andrea Ranalli Ezra Hale Jonas Riska Jesper Haee Zachary Smith Robert Hall Robby Simpson Jon Harros Sumit Singh Jim Hartman David Smith Arasch Honarbacht Matt Smith Ted Humpal

6 Michael Stuber Phil Jamieson Don Sturek William Keith Mads Westergreen Larry Kohrmann Urban Wicklander Tom Klein Cam Williams John Knuth Ian Winterburn Cristian Kuster Kenny York Zin Kyaw Walter Young Gary Lee ZigBee Cluster Library Specification ZigBee Document 075123 Page 4 Copyright 2007-2016, The ZigBee Alliance. All rights reserved. Document Control The ZigBee Cluster Library is made of individual chapters such as this one. See Chapter 1 for the list of all chapters. References between chapters are made using a notation where X is the chapter and Y is the sub-section within that chapter.

7 References to external documents are contained in Chapter 1 and are made using [Rn] notation. An update to any of these chapters will be reflected in an update to the source document list below. Chapter 1 Introduction Document 14-0125-12 Chapter 2 Foundation Document 14-0126-15 Chapter 3 General Document 14-0127-17 Chapter 4 Measurement and Sensing Document 14-0128-10 Chapter 5 Lighting Document 14-0129-12 Chapter 6 HVAC Document 14-0130-11 Chapter 7 Closures Document 14-0131-14 Chapter 8 Security and Safety Document 14-0132-12 Chapter 9 Protocol Interfaces Document 14-0133-07 Chapter 10 Smart Energy Document 14-0134-10 Chapter 11 Over the Air Upgrades Document 14-0135-13 Chapter 12 Telecommunications Document 14-0136-09

8 Chapter 13 Commissioning Document 14-0137-10 Chapter 14 Retail Document 14-0138-07 Chapter 15 Appliances Document 14-0139-11 Approved Errata for this ZCL revision Document 15-0180 Source files for drawings in this ZCL revision Document 14-0141-00 ZigBee Cluster Library Document 075123 Copyright 2007-2016, The ZigBee Alliance. All rights reserved. Page 5 Document History Revision Number Date Comments 00 11th July 2007 Document created 01 19th Oct 2007 First release 02 29th May 2008 Added Commissioning Cluster from 064699r12. Added material from annex of CBA Profile 053516r10 Structured types (arrays etc) and structured R/W com-mands Input / Output / Value clusters (Basic) Input / Output / Value clusters (BACnet Regular & Ex-tended) Generic Tunnel Cluster BACnet Protocol Tunnel Cluster Made changes to the Color Control Cluster re.

9 CCB 870 Added x,y control according to CIE 1931 Color Space Added long data types (as required by SE profile 075356r12 etc) 40-64bit integers etc, long strings Made changes to time Cluster (as required by CCBs 890, 914) Added time zone & DST + UTCtime type Made minor changes as requested by the following CCBs 627, 714, 781, 853, 854, 867, 878, 879, 880, 881, 883, 893, 897, 898, 919, 958 03 18th Sept 2009 The following changes were made to the Editor s Copy of the ZCL, 095254r00. Made change to the Basic Cluster , re CCB comment #606 Added optional attribute DisableLocalConfig.

10 Updated Pressure Measurement Cluster re CCB comment #961 Added extra attributes to allow wider range of pressure. Updated Color Control Cluster re CCB comment #1006 Clarification of stop commands, color mode switching etc. Made changes to RSSI Location Cluster , re CCB comment #1053 Added mechanism for centralized location. Made change to Generic Tunnel Cluster , re CCB comment #1068 Added extra fields to Match Protocol Address Response Command 24th Dec 2009 Made minor changes and clarifications re the following CCBs 960, 1001, 1004, 1061, 1097. Added Door Lock Cluster .