OCF 2.3 Zigbee Resource Mapping specification BTG. Legal Disclaimer

Similar documents
OCF Core Specification Extension

ITU-T Y.4552/Y.2078 (02/2016) Application support models of the Internet of things

scons --debug=explain VERBOSE=true RELEASE=false TARGET_TRANSPORT=IP BUILD_SAMPLE=ON

ITU-T Y Functional framework and capabilities of the Internet of things

Device Management Requirements

OCF Bridging Specification

Subtitle Safe Crop Area SCA

ATSC Candidate Standard: Video Watermark Emission (A/335)

Operations for Citizens Broadband Radio Service (CBRS): Priority Access License (PAL) Database Technical Specification

ATSC Standard: Video Watermark Emission (A/335)

ENGINEERING COMMITTEE Energy Management Subcommittee SCTE STANDARD SCTE

Device Management Requirements

Video System Characteristics of AVC in the ATSC Digital Television System

OMA Device Management Server Delegation Protocol

This document is a preview generated by EVS

Boot Control Profile SM CLP Command Mapping Specification

Version 0.5 (9/7/2011 4:18:00 a9/p9 :: application v2.doc) Warning

TA Document Enhancements to the AV/C Tape Recorder/Player Subunit Specification Version 2.1

Recomm I n t e r n a t i o n a l T e l e c o m m u n i c a t i o n U n i o n

Firmware Update Management Object Architecture

ITU-T Y Reference architecture for Internet of things network capability exposure

Network Operations Subcommittee SCTE STANDARD SCTE SCTE-HMS-QAM-MIB

EasyAir Philips Field Apps User Manual. May 2018

Control4 Philips Hue Lighting Driver Version 8

DM Scheduling Architecture

Firmware Update Management Object Architecture

ATSC Candidate Standard: A/341 Amendment SL-HDR1

ATSC Standard: A/342 Part 1, Audio Common Elements

Simple Identity Management Profile SM CLP Command Mapping Specification

ANSI/SCTE

ENGINEERING COMMITTEE

ASSEMBLY AND CALIBRATION

ISO INTERNATIONAL STANDARD. Bibliographic references and source identifiers for terminology work

Reference Release Definition for ConnMO

ATSC Standard: 3D-TV Terrestrial Broadcasting, Part 1

35PM-FCD-ST app-2e Sony Pictures Notes doc. Warning

No Trade Secrets. Microsoft does not claim any trade secret rights in this documentation.

NOTICE. (Formulated under the cognizance of the CTA R4 Video Systems Committee.)

CONSOLIDATED VERSION IEC Digital audio interface Part 3: Consumer applications. colour inside. Edition

DM DiagMon Architecture

ENGINEERING COMMITTEE Interface Practices Subcommittee AMERICAN NATIONAL STANDARD ANSI/SCTE

ITU-T Y Specific requirements and capabilities of the Internet of things for big data

ISO INTERNATIONAL STANDARD. Vacuum technology Vacuum gauges Specifications for hot cathode ionization gauges

Teradici Naming and Branding Guide for Partners

Implementation Agreement MEF 23.1

SERIES H: AUDIOVISUAL AND MULTIMEDIA SYSTEMS Infrastructure of audiovisual services Coding of moving video

[MS-CFB-Diff]: Compound File Binary File Format. Intellectual Property Rights Notice for Open Specifications Documentation

ENGINEERING COMMITTEE Digital Video Subcommittee AMERICAN NATIONAL STANDARD ANSI/SCTE

Tebis application software

Automotive 72 Exterior Smart Lighting Kit

INTERNATIONAL STANDARD

Digital terrestrial television broadcasting - Security Issues. Conditional access system specifications for digital broadcasting

This document is a preview generated by EVS

ENGINEERING COMMITTEE

Casambi App User Guide

Electronic solutions for the smart home. mobile App control of heating / electrical appliances / electrical power consumption

Drop Passives: Splitters, Couplers and Power Inserters

STEVAL-CCM003V1. Graphic panel with ZigBee features based on the STM32 and SPZBE260 module. Features. Description

CEA Standard. Standard Definition TV Analog Component Video Interface CEA D R-2012

NOTICE. (Formulated under the cognizance of the CTA R4.8 DTV Interface Subcommittee.)

INTERNATIONAL STANDARD

Sapera LT 8.0 Acquisition Parameters Reference Manual

Tebis application software

BUREAU OF ENERGY EFFICIENCY

Interface Practices Subcommittee SCTE STANDARD SCTE Hard Line Pin Connector Return Loss

Maintenance and upgrade of a BARCO video wall installed in the Crisis Room of the ECML

ENERGY STAR Program Requirements Product Specification for Televisions. Draft Test Method

HD ready 1080p LICENSE AGREEMENT

DVI Converters: Installation & Operation Guide BDV BLACK DIAMOND VIDEO

ENGINEERING COMMITTEE

RECOMMENDATION ITU-R BT (Questions ITU-R 25/11, ITU-R 60/11 and ITU-R 61/11)

www. enocean. com EnOcean Brand Guidelines

Interface Practices Subcommittee SCTE STANDARD SCTE Composite Distortion Measurements (CSO & CTB)

Device Management Push Binding

ATSC Proposed Standard: A/341 Amendment SL-HDR1

AMERICAN NATIONAL STANDARD

New ILS Data Delivery Guidelines

Event Triggering Distribution Specification

X-Sign 2.0 User Manual

Web Services Reliable Messaging TC WS-Reliability 1.1

ENGINEERING COMMITTEE

RECOMMENDATION ITU-R BT Studio encoding parameters of digital television for standard 4:3 and wide-screen 16:9 aspect ratios

ENGINEERING COMMITTEE

IP Roombox. Hotel Room Management

5620 SAM SERVICE AWARE MANAGER MPTGS Driver Version Guide

WORLD LIBRARY AND INFORMATION CONGRESS: 75TH IFLA GENERAL CONFERENCE AND COUNCIL

User Guide. express yourself through light. Based on FW of 27

ENGINEERING COMMITTEE

APN Remap Table Configuration Mode

Free TV Australia Operational Practice OP-45 Application of Time Related Tables in Australian DVB-T Systems Issue 4 October 2012 Page 1 of 9

TWD SPECIFICATION Interoperable Master Format Broadcast & Online IMF Application Constraints - ProRes

MK2010 ASSEMBLY AND CALIBRATION

AMERICAN NATIONAL STANDARD

Product Manual ise smart connect KNX Hue Order No Valid for application software v4.2 and firmware version v4.0

IoT Toolbox Mobile Application User Manual

INTERNATIONAL STANDARD

Internet of Things Telecommunication operator perspective

Simon XT/XTi/XTi-5 LTE Module INSTALLATION GUIDE

SOTI Brand Guidelines 2013

ETSI TS V ( )

Transcription:

18 OCF 2.3 Zigbee Resource Mapping specification BTG 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 Legal Disclaimer THIS IS A DRAFT SPECIFICATION DOCUMENT ONLY AND HAS NOT BEEN ADOPTED BY THE OPEN CONNECTIVITY FOUNDATION. THIS DRAFT DOCUMENT MAY NOT BE RELIED UPON FOR ANY PURPOSE OTHER THAN REVIEW OF THE CURRENT STATE OF THE DEVELOPMENT OF THIS DRAFT DOCUMENT. THE OPEN CONNECTIVITY FOUNDATION AND ITS MEMBERS RESERVE THE RIGHT WITHOUT NOTICE TO YOU TO CHANGE ANY OR ALL PORTIONS HEREOF, DELETE PORTIONS HEREOF, MAKE ADDITIONS HERETO, DISCARD THIS DRAFT DOCUMENT IN ITS ENTIRETY OR OTHERWISE MODIFY THIS DRAFT DOCUMENT AT ANY TIME. YOU SHOULD NOT AND MAY NOT RELY UPON THIS DRAFT DOCUMENT IN ANY WAY, INCLUDING BUT NOT LIMITED TO THE DEVELOPMENT OF ANY PRODUCTS OR SERVICES. IMPLEMENTATION OF THIS DRAFT DOCUMENT IS DONE AT YOUR OWN RISK AMEND AND IT IS NOT SUBJECT TO ANY LICENSING GRANTS OR COMMITMENTS UNDER THE OPEN CONNECTIVITY FOUNDATION INTELLECTUAL PROPERTY RIGHTS POLICY OR OTHERWISE. IN CONSIDERATION OF THE OPEN CONNECTIVITY FOUNDATION GRANTING YOU ACCESS TO THIS DRAFT DOCUMENT, YOU DO HEREBY WAIVE ANY AND ALL CLAIMS ASSOCIATED HEREWITH INCLUDING BUT NOT LIMITED TO THOSE CLAIMS DISCUSSED BELOW, AS WELL AS CLAIMS OF DETRIMENTAL RELIANCE. The OCF logo is a trademark of Open Connectivity Foundation, Inc. in the United States or other countries. *Other s and brands may be claimed as the property of others. Copyright 2018 Open Connectivity Foundation, Inc. All rights reserved. Copying or other form of reproduction and/or distribution of these works are strictly prohibited. 1

44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 CONTENTS 1 Scope... 9 2 Normative references... 9 3 Terms, definitions and symbols... 9 3.1 Terms and definitions... 9 3.2 Symbols and abbreviations... 9 4 Document conventions and organization... 9 4.1 Introduction... 9 4.2 Conventions... 10 4.3 Notation... 10 4.4 Data types... 10 5 Theory of Operation... 11 5.1 Interworking Approach... 11 5.1.1 General... 11 5.1.2 Value Assignment... 11 5.1.3 Property Naming... 11 5.1.4 Range... 11 5.1.5 Arrays... 11 5.1.6 Default Mapping... 11 5.1.7 Conditional Mapping... 11 5.1.8 Method Invocation... 11 6 Device Type Mapping... 12 6.1 Introduction... 12 6.2 Zigbee Device Types to OCF Device Types... 12 7 Resource to ZigBee Cluster Equivalence... 13 7.1 Introduction... 13 7.2 Zigbee Clusters to OCF Resources... 13 7.2.1 On/off... 14 7.2.2 Level Control... 14 7.2.3 Color Control... 14 7.2.4 Thermostat... 15 7.2.5 Window Covering... 15 7.2.6 Temperature Measurement... 16 7.2.7 Occupancy Sensing... 16 7.2.8 IAS Zone... 16 8 Detailed Mapping APIs... 17 8.1 Color Control Cluster - Color Space - Control... 17 8.1.1 Derived model... 17 8.1.2 Property definition... 17 8.1.3 Derived model definition... 17 8.2 Color Control Cluster - Color Space - Information... 18 2

86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 8.2.1 Derived model... 18 8.2.2 Property definition... 18 8.2.3 Derived model definition... 19 8.3 Color Control Cluster - Color Temperature - Control... 19 8.3.1 Derived model... 19 8.3.2 Property definition... 19 8.3.3 Derived model definition... 20 8.4 Color Control Cluster - Color Temperature - Information... 20 8.4.1 Derived model... 20 8.4.2 Property definition... 20 8.4.3 Derived model definition... 21 8.5 Color Control Cluster - Hue and Saturation - Control... 22 8.5.1 Derived model... 22 8.5.2 Property definition... 22 8.5.3 Derived model definition... 22 8.6 Color Control Cluster - Hue and Saturation - Information... 23 8.6.1 Derived model... 23 8.6.2 Property definition... 23 8.6.3 Derived model definition... 23 8.7 IAS Zone Cluster - Control... 24 8.7.1 Derived model... 24 8.7.2 Property definition... 24 8.7.3 Derived model definition... 24 8.8 IAS Zone Cluster - Information... 25 8.8.1 Derived model... 25 8.8.2 Property definition... 25 8.8.3 Derived model definition... 31 8.9 Level Control Cluster - Control... 35 8.9.1 Derived model... 35 8.9.2 Property definition... 35 8.9.3 Derived model definition... 35 8.10 Level Control Cluster - Information... 35 8.10.1 Derived model... 35 8.10.2 Property definition... 36 8.10.3 Derived model definition... 36 8.11 Occupancy Sensing Cluster - Information... 36 8.11.1 Derived model... 36 8.11.2 Property definition... 36 8.11.3 Derived model definition... 37 8.12 On/Off Cluster - Control... 37 8.12.1 Derived model... 37 8.12.2 Property definition... 37 8.12.3 Derived model definition... 38 8.13 On/off Cluster - Information... 39 3

130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 8.13.1 Derived model... 39 8.13.2 Property definition... 39 8.13.3 Derived model definition... 39 8.14 Temperature Measurement Cluster - Information... 39 8.14.1 Derived model... 39 8.14.2 Property definition... 40 8.14.3 Derived model definition... 40 8.15 Thermostat Cluster - Cool - Control... 41 8.15.1 Derived model... 41 8.15.2 Property definition... 41 8.15.3 Derived model definition... 42 8.16 Thermostat Cluster - Current Temperature - Information... 42 8.16.1 Derived model... 42 8.16.2 Property definition... 42 8.16.3 Derived model definition... 42 8.17 Thermostat Cluster - Heat - Control... 43 8.17.1 Derived model... 43 8.17.2 Property definition... 43 8.17.3 Derived model definition... 43 8.18 Window Covering Cluster - Configuration - Control... 44 8.18.1 Derived model... 44 8.18.2 Property definition... 44 8.18.3 Derived model definition... 45 8.19 Window Covering Cluster - Configuration - Information... 46 8.19.1 Derived model... 46 8.19.2 Property definition... 47 8.19.3 Derived model definition... 50 8.20 Window Covering Cluster - Lift Percentage - Control... 52 8.20.1 Derived model... 52 8.20.2 Property definition... 52 8.20.3 Derived model definition... 53 8.21 Window Covering Cluster - Lift Percentage - Information... 53 8.21.1 Derived model... 53 8.21.2 Property definition... 53 8.21.3 Derived model definition... 53 8.22 Window Covering Cluster - Lift Position - Control... 54 8.22.1 Derived model... 54 8.22.2 Property definition... 54 8.22.3 Derived model definition... 54 8.23 Window Covering Cluster - Lift Position - Information... 55 8.23.1 Derived model... 55 8.23.2 Property definition... 55 8.23.3 Derived model definition... 55 8.24 Window Covering Cluster - Tilt Percentage - Control... 56 4

174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 8.24.1 Derived model... 56 8.24.2 Property definition... 56 8.24.3 Derived model definition... 57 8.25 Window Covering Cluster - Tilt Percentage - Information... 57 8.25.1 Derived model... 57 8.25.2 Property definition... 57 8.25.3 Derived model definition... 57 8.26 Window Covering Cluster - Tilt Position - Control... 58 8.26.1 Derived model... 58 8.26.2 Property definition... 58 8.26.3 Derived model definition... 58 8.27 Window Covering Cluster - Tilt Position - Information... 59 8.27.1 Derived model... 59 8.27.2 Property definition... 59 8.27.3 Derived model definition... 59 5

192 193 194 Figures No table of figures entries found. 6

195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 Tables Table 1 Zigbee to OCF Device Type Mapping... 12 Table 2 Zigbee Server Cluster to OCF Resource Type Mapping... 13 Table 3 The property mapping for zcl.colorcontrol_csc.control.movetocolor.... 17 Table 4 The properties of zcl.colorcontrol_csc.control.movetocolor.... 17 Table 5 The property mapping for zcl.colorcontrol_csc.info.... 18 Table 6 The properties of zcl.colorcontrol_csc.info... 18 Table 7 The property mapping for zcl.colorcontrol_ct.control.movetocolortemperature.... 19 Table 8 The properties of zcl.colorcontrol_ct.control.movetocolortemperature.... 20 Table 9 The property mapping for zcl.colorcontrol_ct.info.... 20 Table 10 The properties of zcl.colorcontrol_ct.info.... 21 Table 11 The property mapping for zcl.colorcontrol_hs.control.movetohueandsaturation... 22 Table 12 The properties of zcl.colorcontrol_hs.control.movetohueandsaturation.... 22 Table 13 The property mapping for zcl.colorcontrol_hs.info.... 23 Table 14 The properties of zcl.colorcontrol_hs.info.... 23 Table 15 The property mapping for zcl.iaszone.control.... 24 Table 16 The properties of zcl.iaszone.control.... 24 Table 17 The property mapping for zcl.iaszone.info.... 25 Table 18 The properties of zcl.iaszone.info.... 29 Table 19 The property mapping for zcl.levelcontrol.control.moveto.... 35 Table 20 The properties of zcl.levelcontrol.control.moveto.... 35 Table 21 The property mapping for zcl.levelcontrol.info.... 36 Table 22 The properties of zcl.levelcontrol.info.... 36 Table 23 The property mapping for zcl.occupancysensing.info.... 36 Table 24 The properties of zcl.occupancysensing.info.... 37 Table 25 The property mapping for zcl.onoff.control.on.... 37 Table 26 The properties of zcl.onoff.control.on.... 38 Table 27 The property mapping for zcl.onoff.control.off.... 38 Table 28 The properties of zcl.onoff.control.off.... 38 Table 29 The property mapping for zcl.onoff.... 39 Table 30 The properties of zcl.onoff.... 39 Table 31 The property mapping for zcl.temperaturemeasurement.info.... 40 Table 32 The properties of zcl.temperaturemeasurement.info.... 40 Table 33 The property mapping for zcl.thermostat_cool.control.setpointraiselower.... 41 Table 34 The properties of zcl.thermostat_cool.control.setpointraiselower.... 41 Table 35 The property mapping for zcl.thermostat_currenttemperature.info.... 42 Table 36 The properties of zcl.thermostat_currenttemperature.info.... 42 Table 37 The property mapping for zcl.thermostat_heat.control.setpointraiselower.... 43 Table 38 The properties of zcl.thermostat_heat.control.setpointraiselower.... 43 7

234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 Table 39 The property mapping for zcl.windowcovering_conf.control.... 44 Table 40 The properties of zcl.windowcovering_conf.control.... 44 Table 41 The property mapping for zcl.windowcovering_conf.info.... 47 Table 42 The properties of zcl.windowcovering_conf.info.... 48 Table 43 The property mapping for zcl.windowcovering_liftpercentage.control.gotoliftpercentage.... 52 Table 44 The properties of zcl.windowcovering_liftpercentage.control.gotoliftpercentage.... 52 Table 45 The property mapping for zcl.windowcovering_liftpercentage.info.... 53 Table 46 The properties of zcl.windowcovering_liftpercentage.info.... 53 Table 47 The property mapping for zcl.windowcovering_liftposition.control.gotoliftvalue.... 54 Table 48 The properties of zcl.windowcovering_liftposition.control.gotoliftvalue.... 54 Table 49 The property mapping for zcl.windowcovering_liftposition.info.... 55 Table 50 The properties of zcl.windowcovering_liftposition.info... 55 Table 51 The property mapping for zcl.windowcovering_tiltpercentage.control.gototiltpercentage.... 56 Table 52 The properties of zcl.windowcovering_tiltpercentage.control.gototiltpercentage.... 57 Table 53 The property mapping for zcl.windowcovering_tiltpercentage.info.... 57 Table 54 The properties of zcl.windowcovering_tiltpercentage.info.... 57 Table 55 The property mapping for zcl.windowcovering_tiltposition.control.gototiltvalue.... 58 Table 56 The properties of zcl.windowcovering_tiltposition.control.gototiltvalue.... 58 Table 57 The property mapping for zcl.windowcovering_tiltposition.info.... 59 Table 58 The properties of zcl.windowcovering_tiltposition.info... 59 257 8

258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 1 Scope The OCF Resource to Zigbee Cluster Mapping specification ( this specification ) provides detailed mapping information between Zigbee defined Clusters and OCF defined Resources, 2 Normative references The following documents, in whole or in part, are normatively referenced in this document and are indispensable for its application. For dated references, only the edition cited applies. For undated references, the latest edition of the referenced document (including any amendments) applies. OCF Core Specification, Open Connectivity Foundation Core Specification, Version 2.0 https://openconnectivity.org/specs/ocf_core_specification_v2.0.0.pdf OCF Device Specification, Open Connectivity Foundation Device Specification, Version 2.0 https://openconnectivity.org/specs/ocf_device_specification_v2.0.0.pdf OCF Resource Type Specification, Open Connectivity Foundation Resource Type Specification, Version 2.0 https://openconnectivity.org/specs/ocf_resource_type_specification_v2.0.0.pdf OCF Bridging Specification, Open Connectivity Foundation Bridging Specification, Version 2.0 https://openconnectivity.org/specs/ocf_bridging_specification_v1.3.0.pdf Zigbee Cluster Library Specification, Version 1.0 http://www.zigbee.org/zigbee-for-developers/zigbee-3-0/ ZigBee Lighting Occupancy Device, Version 1.0 http://www.zigbee.org/zigbee-for-developers/zigbee-3-0/ Derived Models for Interoperability between IoT Ecosystems, Stevens Merriam, March 2016 https://www.iab.org/wp-content/iab-uploads/2016/03/ocf-derived-models-for-interoperability- Between-IoT-Ecosystems_v2-examples.pdf IETF RFC 7159, The JavaScript Object Notation (JSON) Data Interchange Format, March 2014 http://www/ietf.org/rfc/rfc7159.txt 3 Terms, definitions and symbols All terms and definitions as defined in the OCF Core Specification and OCF Bridging Specification also apply to this specification. 3.1 Terms and definitions None defined. 3.2 Symbols and abbreviations None defined. 4 Document conventions and organization 4.1 Introduction For the purposes of this document, the terms and definitions given in OCF Core Specification, OCF Device Specification, and OCF Bridging Specification apply. 9

294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 4.2 Conventions In this specification a number of terms, conditions, mechanisms, sequences, parameters, events, states, or similar terms are printed with the first letter of each word in uppercase and the rest lowercase (e.g., Network Architecture). Any lowercase uses of these words have the normal technical English meaning 4.3 Notation In this document, features are described as required, recommended, allowed or DEPRECATED as follows: Required (or shall or mandatory). These basic features shall be implemented to comply with OIC Core Architecture. The phrases shall not, and PROHIBITED indicate behaviour that is prohibited, i.e. that if performed means the implementation is not in compliance. Recommended (or should). These features add functionality supported by OIC Core Architecture and should be implemented. Recommended features take advantage of the capabilities OIC Core Architecture, usually without imposing major increase of complexity. Notice that for compliance testing, if a recommended feature is implemented, it shall meet the specified requirements to be in compliance with these guidelines. Some recommended features could become requirements in the future. The phrase should not indicates behaviour that is permitted but not recommended. Allowed (or allowed). These features are neither required nor recommended by OIC Core Architecture, but if the feature is implemented, it shall meet the specified requirements to be in compliance with these guidelines. Conditionally allowed (CA)The definition or behaviour depends on a condition. If the specified condition is met, then the definition or behaviour is allowed, otherwise it is not allowed. Conditionally required (CR) The definition or behaviour depends on a condition. If the specified condition is met, then the definition or behaviour is required. Otherwise the definition or behaviour is allowed as default unless specifically defined as not allowed. DEPRECATED Although these features are still described in this specification, they should not be implemented except for backward compatibility. The occurrence of a deprecated feature during operation of an implementation compliant with the current specification has no effect on the implementation s operation and does not produce any error conditions. Backward compatibility may require that a feature is implemented and functions as specified but it shall never be used by implementations compliant with this specification. Strings that are to be taken literally are enclosed in double quotes. Words that are emphasized are printed in italic. 4.4 Data types Data types are defined in the OCF Core Specification. 10

334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 5 Theory of Operation 5.1 Interworking Approach The interworking between ZigBee Clusters and OCF defined Resources is modelled using the derived model syntax described in Derived Models for Interoperability Mapping Syntax Within the defined syntax for derived modelling used by this Specification there are two blocks that define the actual Property-Property equivalence or mapping. These blocks are identified by the keywords x-to-ocf and x-from-ocf. Derived Models for Interoperability does not define a rigid syntax for these blocks; they are free form string arrays that contain pseudo-coded mapping logic. Within this specification we apply the rules in the following sub-sections to these blocks to ensure consistency and re-usability and extensibility of the mapping logic that is defined. 5.1.1 General All statements are terminated with a carriage return. 5.1.2 Value Assignment The equals sign (=) is used to assign one value to another. The assignee is on the left of the operator; the value being assigned on the right. 5.1.3 Property Naming All Property s are identical to the used by the original model; for example from the OCF Temperature Resource the Property temperature is used whereas when referred to the derived ecosystem then the semantically equivalent Property is used. The of the OCF defined Property is prepended by the ecosystem designator ocf to avoid ambiguity (e.g. ocf.step ) 5.1.4 Range The range on the OCF side is fixed. 5.1.5 Arrays An array element is indicated by the use of square brackets [ with the index of the element contained therein, e.g. range [1. All arrays start at an index of 0. 5.1.6 Default Mapping There are cases where the specified mapping is not possible as one or more of the Properties being mapped is optional in the source model. In all such instances a default mapping is provided. (e.g. transitiontime = 1 ) 5.1.7 Conditional Mapping When a mapping is dependent on the meeting of other conditions then the syntax: If condition, then mapping is applied. E.g. if onoff = false, then ocf.value = false 5.1.8 Method Invocation The invocation of a command from the derived ecosystem as part of the mapping from an OCF Resource is indicated by the use if a double colon :: delimiter between the applicable resource, service, interface or other construct identifier and the command. The command always includes trailing parentheses which would include any parameters should they be passed. 11

374 375 376 377 378 379 380 381 382 For example when dealing with the on() command for Zigbee On/off Cluster this gives a complete command invocation as: zb.command.onoff::on(). 6 Device Type Mapping 6.1 Introduction This Section contains the mappings Zigbee Device Types to OCF Device Types. 6.2 Zigbee Device Types to OCF Device Types Table 1 captures the equivalency mapping between Zigbee defined Device Types (Please see Zigbee Cluster Library) and OCF defined Device Types (Please see OCF Device Specification). Table 1 Zigbee to OCF Device Type Mapping Zigbee Device Type Zigbee Device ID OCF Device Type On/off Output 0x0002 oic.d.smartplug Mains Power Outlet 0x0009 oic.d.smartplug Smart Plug 0x0051 oic.d.smartplug On/Off Light 0x0100 oic.d.light Dimmable Light 0x0101 oic.d.light Color Dimmable Light 0x0102 oic.d.light Color Temperature Light 0x010c oic.d.light Extended Color Light 0x010d oic.d.light Window Covering Device 0x0202 oic.d.blind Thermostat 0x0301 oic.d.thermostat Temperature Sensor 0x0302 oic.d.sensor 12

Occupancy Sensor 0x0107 oic.d.sensor IAS Zone 0x0402 oic.d.sensor 383 384 385 386 387 388 389 390 391 392 393 7 Resource to ZigBee Cluster Equivalence 7.1 Introduction This clause introduces new resource types for resource mapping between Zigbee Clusters and OCF Resources and lists the complete set of applicable Zigbee Clusters and equivalent OCF Resource Type(s) in 7.2 7.2 Zigbee Clusters to OCF Resources Table 2 captures the equivalency mapping between Zigbee defined Clusters (see Zigbee Cluster Library) and OCF defined Resource Types (see OCF Resource Type Specification). Detailed Property by Property mappings are provided in Section 7.1. Clause 8 captures the mappings for mandatory server clusters for Zigbee 3.0 devices Table 2 Zigbee Server Cluster to OCF Resource Type Mapping Zigbee Cluster OCF Resource Type Name OCF Resource Type ID OCF Interface(s) On/off Binary Switch oic.r.switch.binary oic. if.a Level Control Dimming oic.r.light.dimming oic. if.a Color Control Colour Hue and Saturation, Colour Space Coordinates, Colour Temperature oic.r.colour.hs, oic.r.colour.csc, oic.r.colour.colourtemperature, oic. if.a Thermostat Temperature (3) oic.r.temperature (3) * 1 for sensor, 2 for heater and cooler oic. if.s oic. if.a Window Covering Window Covering oic.r.windowcovering, oic.r.openlevel (4) * 2 for lift (percentage scale and cm scale), oic. if.rw oic. if.a 2 for tilt (percentage scale and cm scale) Temperature Measurement Temperature oic.r.temperature oic. if.s 13

Occupancy Sensing Presence Sensor oic.r.sensor.presence oic. if.s IAS Zone IAS Zone oic.r.ias.zone oic. if.rw 394 395 396 397 398 399 400 401 402 7.2.1 On/off The APIs with zcl.onoff define the mapping between an instance of an OCF Binary Switch Resource and the Zigbee On/off Cluster. In Section 8.13, a RETRIEVE on an OCF Binary Switch Resource maps to a general Read command on a Zigbee On/off Cluster. The value of Zigbee Attribute in Zigbee On/off Cluster is retrieved via the general Read command and mapped with the value of OCF Property in OCF Binary Switch Resource. In Section 8.12, an UPDATE on a Binary Switch maps to a command invocation on either on() command or off() command of Zigbee On/off Cluster. value = true maps to on(), value = false maps to off() of Zigbee On/off Cluster. 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 7.2.2 Level Control The APIs with zcl.levelcontrol define the mapping between an instance of an OCF Dimming Resource and the Zigbee Level Control Cluster. In Section 8.10, a RETRIEVE on an OCF Dimming Resource maps to a general Read command on a Zigbee Level Control Cluster. The value of Zigbee Attribute in Zigbee Level Control Cluster is retrieved via the general Read command and mapped with the value of OCF Property in OCF Dimming Resource. In Section 8.9, an UPDATE on a dimmingsetting maps to a command invocation on movetolevel(level,transitiontime=0) of Zigbee Level Control Cluster. 7.2.3 Color Control The APIs with zcl.colorcontrol define the mapping between instances of OCF Colour Resources and the Zigbee Color Control Cluster. The OCF Colour Resources are OCF Hue and Saturation Resource, OCF Colour Space Coordinate Resource, OCF Colour Temperature Resource. The APIs with zcl.colorcontrol_hs define the mapping between an instance of OCF Hue and Saturation Resources and the Zigbee Color Control Cluster. In Section 8.6, a RETRIEVE on an are OCF Hue and Saturation Resource maps to a general Read command on a Zigbee Color Control Cluster. The values of Zigbee Attributes in Zigbee Color Control Cluster are retrieved via the general Read command and mapped with those of OCF Properties in OCF Hue and Saturation Resource. In Section 8.5, an UPDATE on OCF Colour Hue and Saturation Resource maps to a command invocation on movetohueandsaturation(hue,saturation,transitiontime=0) of Zigbee Color Control Cluster. The APIs with zcl.colorcontrol_csc define the mapping between an instance of OCF Colour Space Coordinate Resource and the Zigbee Color Control Cluster. In Section 8.2, a RETRIEVE on an OCF Colour Space Coordinate Resource maps to a general Read command on a Zigbee Color Control Cluster. The values of Zigbee Attributes in Zigbee Color Control Cluster are retrieved via the general Read command and mapped with those of OCF Properties in OCF Colour Space Coordinate Resource. In Section 8.1, an UPDATE on OCF Colour Space Coordinate Resource maps to a command invocation on movetocolor(colorx,colory,transitiontime=0) of Zigbee Color Control Cluster. 14

436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 The APIs with zcl.colorcontrol_ct define the mapping between an instance of OCF Colour Temperature Resource and the Zigbee Color Control Cluster. In Section 8.4, a RETRIEVE on an OCF Colour Temperature Resource maps to a general Read command on a Zigbee Color Control Cluster. The values of Zigbee Attributes in Zigbee Color Control Cluster are retrieved via the general Read command and mapped with those of OCF Properties in OCF Colour Temperature Resource. In Section 8.3, an UPDATE on OCF Colour Temperature Resource maps to a command invocation on movetocolortemperature(colortemperature,transitiontime=0) of Zigbee Color Control Cluster. 7.2.4 Thermostat The APIs with zcl.thermostat define the mapping between 3 instances of OCF Temperature Resources and the Zigbee Thermostat Cluster. The 3 instances of OCF Temperature Resources are for sensor, heater, cooler, respectively. The API with zcl.thermostat_currenttemperature defines the mapping between an instance of OCF Temperature Resource and the Zigbee Thermostat Cluster for sensor. In Section 8.16, a RETRIEVE on an OCF Temperature Resource maps to a general Read command on a Zigbee Thermostat Cluster. The value of Zigbee Attribute in Zigbee Thermostat Cluster is retrieved via the general Read command and mapped with the value of OCF Property in OCF Temperature Resource. The value represents the current temperature. The API with zcl.thermostat_heat defines the mapping between an instance of OCF Temperature Resource and the Zigbee Thermostat Cluster for heater. In Section 8.17, an Update on temperature of OCF Temperature Resource maps to setpointraiselower(mode=heat mode, amount) on a Zigbee Thermostat Cluster. The API with zcl.thermostat_cool defines the mapping between an instance of OCF Temperature Resource and the Zigbee Thermostat Cluster for cooler. In Section 8.15, an Update on temperature of OCF Temperature Resource maps to setpointraiselower(mode=cool mode, amount) on a Zigbee Thermostat Cluster. 7.2.5 Window Covering The APIs with zcl.windowcovering define the mapping between 5 instances of OCF Resources and the Zigbee Window Covering Cluster. The 5 instances of OCF Resources are the instance of OCF Window Covering Resource and the 4 instances of OCF Open Level Resources. The 4 instances of OCF Open Level Resources are for lift level with percentage scale, lift level with centimetre scale, tilt level with percentage scale, tilt level with centimetre scale. The API with zcl.windowcovering_conf defines the mapping between an instance of OCF Window Covering Resource and the Zigbee window Covering Cluster. In Section 8.19, a RETRIEVE on an OCF Window Covering Resource maps to a general Read command on a Zigbee Window Covering Cluster. The values of Zigbee Attributes in Zigbee Window Covering Cluster is retrieved via the general Read command and mapped with the value of OCF Property in OCF Window Covering Resource. In Section 8.18, an Update on OCF Window Covering Resource maps to a general Write command on a Zigbee Window Covering Cluster. The API with zcl.windowcovering_liftpercentage defines the mapping between an instance of OCF Open Level Resource and the Zigbee window Covering Cluster for lift with percentage scale. In Section 8.21, a RETRIEVE on an OCF Open Level Resource maps to a general Read command on CurrentPositionLiftPercentage of Zigbee Window Covering Cluster. The value of Zigbee Attribute in Zigbee Window Covering Cluster is retrieved via the general Read command and mapped with the value of OCF Property in OCF Open Level Resource. In Section 8.20, an Update 15

488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 on OCF Open Level Resource maps to gotoliftpercentage(percentageliftvalue) on a Zigbee Window Covering Cluster. The API with zcl.windowcovering_liftposition defines the mapping between an instance of OCF Open Level Resource and the Zigbee window Covering Cluster for lift with centimetre scale. In Section 8.23, a RETRIEVE on an OCF Open Level Resource maps to a general Read command on CurrentPosition-Lift of Zigbee Window Covering Cluster. The value of Zigbee Attribute in Zigbee Window Covering Cluster is retrieved via the general Read command and mapped with the value of OCF Property in OCF Open Level Resource. In Section 8.22, an Update on OCF Open Level Resource maps to gotoliftvalue(liftvalue) on a Zigbee Window Covering Cluster. The API with zcl.windowcovering_tiltpercentage defines the mapping between an instance of OCF Open Level Resource and the Zigbee window Covering Cluster for tilt with percentage scale. In Section 8.25, a RETRIEVE on an OCF Open Level Resource maps to a general Read command on CurrentPositionTiltPercentage of Zigbee Window Covering Cluster. The value of Zigbee Attribute in Zigbee Window Covering Cluster is retrieved via the general Read command and mapped with the value of OCF Property in OCF Open Level Resource. In Section 8.24, an Update on OCF Open Level Resource maps to gototiltpercentage(percentagetiltvalue) on a Zigbee Window Covering Cluster. The API with zcl.windowcovering_tiltposition defines the mapping between an instance of OCF Open Level Resource and the Zigbee window Covering Cluster for tilt with centimetre scale. In Section 8.27, a RETRIEVE on an OCF Open Level Resource maps to a general Read command on CurrentPosition-Tilt of Zigbee Window Covering Cluster. The value of Zigbee Attribute in Zigbee Window Covering Cluster is retrieved via the general Read command and mapped with the value of OCF Property in OCF Open Level Resource. In Section 8.26, an Update on OCF Open Level Resource maps to gototiltvalue(tiltvalue) on a Zigbee Window Covering Cluster. 7.2.6 Temperature Measurement The API with zcl.temperaturemeasurement defines the mapping between an instance of an OCF Temperature Resource and the Zigbee Temperature Measurement Cluster for sensor. In Section 8.14, a RETRIEVE on an OCF Temperature Resource maps to a general Read command on a Zigbee Temperature Measurement Cluster. The value of Zigbee Attribute in Zigbee Temperature Measurement Cluster is retrieved via the general Read command and mapped with the value of OCF Property in OCF Temperature Resource. The value represents the current temperature. 7.2.7 Occupancy Sensing The API with defines the mapping between an instance of an OCF Presence Sensor Resource and the Zigbee Occupancy Sensing Cluster. In Section 8.11, a RETRIEVE on an OCF Presence Sensor Resource maps to a general Read command on a Zigbee Occupancy Sensing Cluster. The value of Zigbee Attribute in Zigbee Occupancy Sensing Cluster is retrieved via the general Read command and mapped with the value of OCF Property in OCF Presence Sensor. 7.2.8 IAS Zone The API with defines the mapping between an instance of an OCF IAS Zone Resource and the Zigbee IAS Zone Cluster. In Section 8.8, a RETRIEVE on an IAS Zone Resource maps to a general Read command on a Zigbee IAS Zone Cluster. The values of Zigbee Attributes in Zigbee IAS Zone Cluster are retrieved via the general Read command and mapped with those of OCF Properties in OCF IAS Zone Resource. In Section 8.7, an Update on OCF IAS Zone Resource maps to a general Write command on a Zigbee IAS Zone Cluster. 16

537 538 539 540 541 542 543 544 545 8 Detailed Mapping APIs This section provides a mapping description (using JSON that aligns with the Derived Modelling syntax described in [Derived Model White Paper) for all Clusters and Resources that are within scope 8.1 Color Control Cluster - Color Space - Control 8.1.1 Derived model The derived model: zcl.colorcontrol_csc.control.movetocolor. 8.1.2 Property definition Table 3 The property mapping for zcl.colorcontrol_csc.control.movetocolor. 546 Zigbee Proper ty colorx colory OCF Resource oic.r.colour. csc oic.r.colour. csc To OC F N/ A N/ A From OCF colorx =ocf.csc[0*65536 transitiontime=0zcl.command.colorcontrol::movetocolor(colorx,col ory,transitiontime). colory= ocf.csc[1*65536 transitiontime=0zcl.command.colorcontrol::movetocolor(colorx,col ory,transitiontime). Table 4 The properties of zcl.colorcontrol_csc.control.movetocolor. 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 Zigbee Property Type Required Description colorx number no Move to certain value(s) of color coordinates as fast as possible with transitiontime=0. transitiontime is set by Zigbee 3.0 translator. colory number no Move to certain value(s) of color coordinates as fast as possible with transitiontime=0. transitiontime is set by Zigbee 3.0 translator. 8.1.3 Derived model definition { "id": "http://openinterconnect.org/zigbeemapping/schemas/zcl.colorcontrol_csc.control.json#", "$schema": "http://json-schema.org/draft-04/schema#", "description" : "Copyright (c) 2018 Open Connectivity Foundation, Inc. All rights reserved.", "title": "Color Control Cluster - Color Space - Control", "definitions": { "zcl.colorcontrol_csc.control.movetocolor": { "properties": { "colorx": { "type": "number", "description": "Move to certain value(s) of color coordinates as fast as possible with transitiontime=0. transitiontime is set by Zigbee 3.0 translator.", "x-ocf-alias": "oic.r.colour.csc", 17

563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 "colorx =ocf.csc[0*65536 transitiontime=0", "zcl.command.colorcontrol::movetocolor(colorx,colory,transitiontime).", "colory": { "type": "number", "description": "Move to certain value(s) of color coordinates as fast as possible with transitiontime=0. transitiontime is set by Zigbee 3.0 translator.", "x-ocf-alias": "oic.r.colour.csc", "colory= ocf.csc[1*65536 transitiontime=0", "zcl.command.colorcontrol::movetocolor(colorx,colory,transitiontime).", "allof": [ {"$ref": "#/definitions/zcl.colorcontrol_csc.control.movetocolor" 8.2 Color Control Cluster - Color Space - Information 8.2.1 Derived model The derived model: zcl.colorcontrol_csc.info. 8.2.2 Property definition Table 5 The property mapping for zcl.colorcontrol_csc.info. Zigbee Property OCF Resource To OCF From OCF currentx oic.r.colour.csc ocf.csc[0 = N/A currentx/65536 currenty oic.r.colour.csc ocf.csc[1 = N/A currenty/65536 Table 6 The properties of zcl.colorcontrol_csc.info. Zigbee Property Type Required Description currentx integer no current value of the normalized chromaticity value x, as defined in the CIE xy Color Space currenty integer no current value of the normalized chromaticity value y, as defined in the CIE xy Color Space 18

601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 8.2.3 Derived model definition { "id": "http://openinterconnect.org/zigbeemapping/schemas/zcl.colorcontrol_csc.info.json#", "$schema": "http://json-schema.org/draft-04/schema#", "description" : "Copyright (c) 2018 Open Connectivity Foundation, Inc. All rights reserved.", "title": "Color Control Cluster - Color Space - Information", "definitions": { "zcl.colorcontrol_csc.info": { "properties": { "currentx": { "description": "current value of the normalized chromaticity value x, as defined in the CIE xy Color Space", "x-ocf-alias": "oic.r.colour.csc", "ocf.csc[0 = currentx/65536", "currenty": { "description": "current value of the normalized chromaticity value y, as defined in the CIE xy Color Space", "x-ocf-alias": "oic.r.colour.csc", "ocf.csc[1 = currenty/65536", "allof": [ {"$ref": "#/definitions/zcl.colorcontrol_csc.info" "required": ["currentx","currenty" 8.3 Color Control Cluster - Color Temperature - Control 8.3.1 Derived model The derived model: zcl.colorcontrol_ct.control.movetocolortemperature. 8.3.2 Property definition Table 7 The property mapping for zcl.colorcontrol_ct.control.movetocolortemperature. Zigbee Property colortempe rature OCF Resource oic.r.colour.colourt emperature To O CF N/ A From OCF colourtemperature=ocf.ct transitiontime=0 z cl.command.colorcontrol::movetocolortemperature(col ortemperature,transitiontime) 19

654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 Table 8 The properties of zcl.colorcontrol_ct.control.movetocolortemperature. Zigbee Property Type Required Description colortemperature integer no Move to certain value of colortemperature as fast as possible with transitiontime=0. transitiontime is set by Zigbee 3.0 translator. 8.3.3 Derived model definition { "id": "http://openinterconnect.org/zigbeemapping/schemas/zcl.colorcontrol_ct.control.json#", "$schema": "http://json-schema.org/draft-04/schema#", "description" : "Copyright (c) 2018 Open Connectivity Foundation, Inc. All rights reserved.", "title": "Color Control Cluster - Color Temperature - Control", "definitions": { "zcl.colorcontrol_ct.control.movetocolortemperature": { "properties": { "colortemperature": { "description": "Move to certain value of colortemperature as fast as possible with transitiontime=0. transitiontime is set by Zigbee 3.0 translator.", "x-ocf-alias": "oic.r.colour.colourtemperature", "colourtemperature=ocf.ct transitiontime=0", "zcl.command.colorcontrol::movetocolortemperature(colortemperature,transitiontime)", "allof": [ {"$ref": "#/definitions/zcl.colorcontrol_ct.control.movetocolortemperature" 8.4 Color Control Cluster - Color Temperature - Information 8.4.1 Derived model The derived model: zcl.colorcontrol_ct.info. 8.4.2 Property definition Table 9 The property mapping for zcl.colorcontrol_ct.info. Zigbee Property OCF Resource To OCF From OCF colortemphysicalmin oic.r.colour.colourtemperature ocf.range[0 = N/A colortemphysicalmin colortemperaturemired oic.r.colour.colourtemperature ocf.ct = N/A colortemperaturemired colorphysicalmax oic.r.colour.colourtemperature ocf.range[1 = N/A colorphysicalmax 20

693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 Table 10 The properties of zcl.colorcontrol_ct.info. Zigbee Property Type Required Description colortemphysicalmin integer no minimum mired value supported by the hardware colortemperaturemired integer yes Scaled inverse of the current value of the color temperature colorphysicalmax integer no maximum mired value supported by the hardware 8.4.3 Derived model definition { "id": "http://openinterconnect.org/zigbeemapping/schemas/zcl.colorcontrol_ct.info.json#", "$schema": "http://json-schema.org/draft-04/schema#", "description" : "Copyright (c) 2018 Open Connectivity Foundation, Inc. All rights reserved.", "title": "Color Control Cluster - Color Temperature - Information", "definitions": { "zcl.colorcontrol_ct.info": { "properties": { "colortemperaturemired": { "description": "Scaled inverse of the current value of the color temperature", "x-ocf-alias": "oic.r.colour.colourtemperature", "ocf.ct = colortemperaturemired", "colortemphysicalmin": { "description": "minimum mired value supported by the hardware", "x-ocf-alias": "oic.r.colour.colourtemperature", "ocf.range[0 = colortemphysicalmin", "colorphysicalmax": { "description": "maximmum mired value supported by the hardware", "x-ocf-alias": "oic.r.colour.colourtemperature", "ocf.range[1 = colorphysicalmax", 21

747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 "allof": [ {"$ref": "#/definitions/zcl.colorcontrol_ct.info" "required": ["colortemperaturemired","colortempphysicalmin","colortempphysicalmax" 8.5 Color Control Cluster - Hue and Saturation - Control 8.5.1 Derived model The derived model: zcl.colorcontrol_hs.control.movetohueandsaturation. 8.5.2 Property definition Table 11 The property mapping for zcl.colorcontrol_hs.control.movetohueandsaturation. Zigbe e Prope rty hue saturat ion OCF Resourc e oic.r.colo ur.hs oic.r.colo ur.hs To O CF N/ A N/ A From OCF hue=ocf.hue/360 * 254 transitiontime=0zcl.command.colorcontrol::movetohueandsaturation( hue,saturation,transitiontime) saturation=ocf.saturation transitiontime=0zcl.command.colorcontrol::movetohueandsaturation( hue,saturation,transitiontime) Table 12 The properties of zcl.colorcontrol_hs.control.movetohueandsaturation. Zigbee Property Type Required Description hue integer no Move to certain value(s) of hue or saturation or both as fast as possible with transitiontime=0. transitiontime is set by Zigbee 3.0 translator. saturation integer no Move to certain value(s) of hue or saturation or both as fast as possible with transitiontime=0. transitiontime is set by Zigbee 3.0 translator. 8.5.3 Derived model definition { "id": "http://openinterconnect.org/zigbeemapping/schemas/zcl.colorcontrol_hs.control.json#", "$schema": "http://json-schema.org/draft-04/schema#", "description" : "Copyright (c) 2018 Open Connectivity Foundation, Inc. All rights reserved.", "title": "Color Control Cluster - Hue and Saturation - Control", "definitions": { "zcl.colorcontrol_hs.control.movetohueandsaturation": { "properties": { "hue": { "description": "Move to certain value(s) of hue or saturation or both as fast as possible with transitiontime=0. transitiontime is set by Zigbee 3.0 translator.", "x-ocf-alias": "oic.r.colour.hs", 22

775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 "hue=ocf.hue/360 * 254 transitiontime=0", "zcl.command.colorcontrol::movetohueandsaturation(hue,saturation,transitiontime)", "saturation": { "description": "Move to certain value(s) of hue or saturation or both as fast as possible with transitiontime=0. transitiontime is set by Zigbee 3.0 translator.", "x-ocf-alias": "oic.r.colour.hs", "saturation=ocf.saturation transitiontime=0", "zcl.command.colorcontrol::movetohueandsaturation(hue,saturation,transitiontime)", "allof": [ {"$ref": "#/definitions/zcl.colorcontrol_hs.control.movetohueandsaturation" 8.6 Color Control Cluster - Hue and Saturation - Information 8.6.1 Derived model The derived model: zcl.colorcontrol_hs.info. 8.6.2 Property definition Table 13 The property mapping for zcl.colorcontrol_hs.info. Zigbee Property OCF Resource To OCF From OCF currentsaturation oic.r.colour.hs ocf.saturation = N/A currentsaturation maximumsaturation=254 currenthue oic.r.colour.hs ocf.hue = N/A currenthue/254 * 360 Table 14 The properties of zcl.colorcontrol_hs.info. Zigbee Property Type Required Description currentsaturation integer yes current saturation value of the light currenthue integer yes current hue value of the light 8.6.3 Derived model definition { "id": "http://openinterconnect.org/zigbeemapping/schemas/zcl.colorcontrol_hs.info.json#", "$schema": "http://json-schema.org/draft-04/schema#", "description" : "Copyright (c) 2018 Open Connectivity Foundation, Inc. All rights reserved.", "title": "Color Control Cluster - Hue and Saturation - Information", "definitions": { "zcl.colorcontrol_hs.info": { 23

821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 "properties": { "currenthue": { "description": "current hue value of the light", "x-ocf-alias": "oic.r.colour.hs", "ocf.hue = currenthue/254 * 360", "currentsaturation": { "description": "current saturation value of the light", "x-ocf-alias": "oic.r.colour.hs", "ocf.saturation = currentsaturation maximumsaturation=254", "allof": [ {"$ref": "#/definitions/zcl.colorcontrol_hs.info" "required": ["currenthue","currentsaturation" 8.7 IAS Zone Cluster - Control 8.7.1 Derived model The derived model: zcl.iaszone.control. 8.7.2 Property definition Table 15 The property mapping for zcl.iaszone.control. 864 Zigbee Property currentzonesensit ivitylevel OCF Resourc e oic.r.ias. zone To O CF N/ A From OCF currentzonesensitivitylevel = ocf.currentzonesensitivitylevelzcl.command.general::write (currentzonesensitivitylevel) Table 16 The properties of zcl.iaszone.control. 865 866 867 868 869 870 871 Zigbee Property Type Required Description currentzonesensitivitylevel integer no Set a sensitivity level of IAS Zone 8.7.3 Derived model definition { "id": "http://openinterconnect.org/zigbeemapping/schemas/zcl.iaszone.control.json#", "$schema": "http://json-schema.org/draft-04/schema#", "description" : "Copyright (c) 2018 Open Connectivity Foundation, Inc. All rights reserved.", "title": "IAS Zone Cluster - Control", "definitions": { 24

872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 "zcl.iaszone.control": { "properties": { "currentzonesensitivitylevel": { "description": "Set a sensitivity level of IAS Zone", "x-ocf-alias": "oic.r.ias.zone", "currentzonesensitivitylevel = ocf.currentzonesensitivitylevel", "zcl.command.general::write(currentzonesensitivitylevel)", "allof": [ {"$ref": "#/definitions/zcl.iaszone.control" 8.8 IAS Zone Cluster - Information 8.8.1 Derived model The derived model: zcl.iaszone.info. 8.8.2 Property definition Table 17 The property mapping for zcl.iaszone.info. Zigbee Property IAS_CIE_address zonestatus OCF Resourc e oic.r.iasz one oic.r.iasz one To OCF ocf.iascieaddress= IAS_CIE_address if zonetype=0x0000 zonestatus=xxxxxxxxxxxxx0, ocf.zonestatus.alarms=['' if zonetype=0x0000 zonestatus=xxxxxxxxxxxxx1, ocf.zonestatus.alarms=['system' if if zonetype=0x0000 zonestatus=xxxxxxxxxxxx0x, ocf.zonestatus.alarms=['' if if zonetype=0x0000 zonestatus=xxxxxxxxxxxx1x, ocf.zonestatus.alarms=['' if zonetype=0x000d zonestatus=xxxxxxxxxxxxx0, ocf.zonestatus.alarms=['' if zonetype=0x000d zonestatus=xxxxxxxxxxxxx1, ocf.zonestatus.alarms=['intrusion' if zonetype=0x000d zonestatus=xxxxxxxxxxxx0x, ocf.zonestatus.alarms=['' if zonetype=0x000d zonestatus=xxxxxxxxxxxx1x, ocf.zonestatus.alarms=['presence' if zonetype=0x000d zonestatus=xxxxxxxxxxxx11, Fro m OC F N/A N/A 25

ocf.zonestatus.alarms=['intrusion','presence' if zonetype=0x0015 zonestatus=xxxxxxxxxxxxx0, ocf.zonestatus.alarms=['' if zonetype=0x0015 zonestatus=xxxxxxxxxxxxx1, ocf.zonestatus.alarms=['1stportalopenclose' if zonetype=0x0015 zonestatus=xxxxxxxxxxxx0x, ocf.zonestatus.alarms=['' if zonetype=0x0015 zonestatus=xxxxxxxxxxxx1x, ocf.zonestatus.alarms=['2ndportalopenclose' if zonetype=0x0015 zonestatus=xxxxxxxxxxxx11, ocf.zonestatus.alarms=['1stportalopenclose','2 ndportalopenclose' if zonetype=0x0028 zonestatus=xxxxxxxxxxxxx0, ocf.zonestatus.alarms=['' if zonetype=0x0028 zonestatus=xxxxxxxxxxxxx1, ocf.zonestatus.alarms=['fire' if zonetype=0x0028 zonestatus=xxxxxxxxxxxx0x, ocf.zonestatus.alarms=['' if zonetype=0x0028 zonestatus=xxxxxxxxxxxx1x, ocf.zonestatus.alarms=['' if zonetype=0x002a zonestatus=xxxxxxxxxxxxx0, ocf.zonestatus.alarms=['' if zonetype=0x002a zonestatus=xxxxxxxxxxxxx1, ocf.zonestatus.alarms=['wateroverflow' if zonetype=0x002a zonestatus=xxxxxxxxxxxx0x, ocf.zonestatus.alarms=['' if zonetype=0x002a zonestatus=xxxxxxxxxxxx1x, ocf.zonestatus.alarms=['' if zonetype=0x002b zonestatus=xxxxxxxxxxxxx0, ocf.zonestatus.alarms=['' if zonetype=0x002b zonestatus=xxxxxxxxxxxxx1, ocf.zonestatus.alarms=['co' if zonetype=0x002b zonestatus=xxxxxxxxxxxx0x, ocf.zonestatus.alarms=['' if zonetype=0x002b zonestatus=xxxxxxxxxxxx1x, ocf.zonestatus.alarms=['cooking' if zonetype=0x002b zonestatus=xxxxxxxxxxxx11, ocf.zonestatus.alarms=['co','cooking' if zonetype=0x002c zonestatus=xxxxxxxxxxxxx0, ocf.zonestatus.alarms=['' if zonetype=0x002c zonestatus=xxxxxxxxxxxxx1, ocf.zonestatus.alarms=['fall' if zonetype=0x002c zonestatus=xxxxxxxxxxxx0x, ocf.zonestatus.alarms=['' if zonetype=0x002c zonestatus=xxxxxxxxxxxx1x, ocf.zonestatus.alarms=['emergencybutton' if zonetype=0x002c 26

zonestatus=xxxxxxxxxxxx11, ocf.zonestatus.alarms=['fall','emergencybutton' if zonetype=0x002d zonestatus=xxxxxxxxxxxxx0, ocf.zonestatus.alarms=['' if zonetype=0x002d zonestatus=xxxxxxxxxxxxx1, ocf.zonestatus.alarms=['movement' if zonetype=0x002d zonestatus=xxxxxxxxxxxx0x, ocf.zonestatus.alarms=['' if zonetype=0x002d zonestatus=xxxxxxxxxxxx1x, ocf.zonestatus.alarms=['vibration' if zonetype=0x002d zonestatus=xxxxxxxxxxxx11, ocf.zonestatus.alarms=['movement','vibration' if zonetype=0x010f zonestatus=xxxxxxxxxxxxx0, ocf.zonestatus.alarms=['' if zonetype=0x010f zonestatus=xxxxxxxxxxxxx1, ocf.zonestatus.alarms=['panic' if zonetype=0x010f zonestatus=xxxxxxxxxxxx0x, ocf.zonestatus.alarms=['' if zonetype=0x010f zonestatus=xxxxxxxxxxxx1x, ocf.zonestatus.alarms=['emergency' if zonetype=0x010f zonestatus=xxxxxxxxxxxx11, ocf.zonestatus.alarms=['panic','emergency' if zonetype=0x0115 zonestatus=xxxxxxxxxxxxx0, ocf.zonestatus.alarms=['' if zonetype=0x0115 zonestatus=xxxxxxxxxxxxx1, ocf.zonestatus.alarms=['panic' if zonetype=0x0115 zonestatus=xxxxxxxxxxxx0x, ocf.zonestatus.alarms=['' if zonetype=0x0115 zonestatus=xxxxxxxxxxxx1x, ocf.zonestatus.alarms=['emergency' if zonetype=0x0115 zonestatus=xxxxxxxxxxxx11, ocf.zonestatus.alarms=['panic','emergency' if zonetype=0x021d zonestatus=xxxxxxxxxxxxx0, ocf.zonestatus.alarms=['' if zonetype=0x021d zonestatus=xxxxxxxxxxxxx1, ocf.zonestatus.alarms=['panic' if zonetype=0x021d zonestatus=xxxxxxxxxxxx0x, ocf.zonestatus.alarms=['' if zonetype=0x021d zonestatus=xxxxxxxxxxxx1x, ocf.zonestatus.alarms=['emergency' if zonetype=0x021d zonestatus=xxxxxxxxxxxx11, ocf.zonestatus.alarms=['panic','emergency' if zonetype=0x0225 zonestatus=xxxxxxxxxxxxx0, 27