OCF Core Optional 2.1.0
Total Page:16
File Type:pdf, Size:1020Kb
OCF Core - Optional Specification VERSION 2.1.0 | November 2019 CONTACT [email protected] Copyright Open Connectivity Foundation, Inc. © 2019 All Rights Reserved. 2 Legal Disclaimer 3 4 NOTHING CONTAINED IN THIS DOCUMENT SHALL BE DEEMED AS GRANTING YOU ANY KIND 5 OF LICENSE IN ITS CONTENT, EITHER EXPRESSLY OR IMPLIEDLY, OR TO ANY 6 INTELLECTUAL PROPERTY OWNED OR CONTROLLED BY ANY OF THE AUTHORS OR 7 DEVELOPERS OF THIS DOCUMENT. THE INFORMATION CONTAINED HEREIN IS PROVIDED 8 ON AN "AS IS" BASIS, AND TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, 9 THE AUTHORS AND DEVELOPERS OF THIS SPECIFICATION HEREBY DISCLAIM ALL OTHER 10 WARRANTIES AND CONDITIONS, EITHER EXPRESS OR IMPLIED, STATUTORY OR AT 11 COMMON LAW, INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF 12 MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. OPEN CONNECTIVITY 13 FOUNDATION, INC. FURTHER DISCLAIMS ANY AND ALL WARRANTIES OF NON- 14 INFRINGEMENT, ACCURACY OR LACK OF VIRUSES. 15 The OCF logo is a trademark of Open Connectivity Foundation, Inc. in the United States or other 16 countries. *Other names and brands may be claimed as the property of others. 17 Copyright © 2016-2019 Open Connectivity Foundation, Inc. All rights reserved. 18 Copying or other form of reproduction and/or distribution of these works are strictly prohibited. 19 Copyright Open Connectivity Foundation, Inc. © 2016-2019. All rights Reserved 20 CONTENTS 21 1 Scope .............................................................................................................................. 1 22 2 Normative references ...................................................................................................... 1 23 3 Terms, definitions, and abbreviated terms ....................................................................... 2 24 3.1 Terms and definitions.............................................................................................. 2 25 4 Document conventions and organization .......................................................................... 2 26 4.1 Conventions ............................................................................................................ 2 27 4.2 Notation .................................................................................................................. 2 28 4.3 Data types .............................................................................................................. 3 29 5 Functional interactions .................................................................................................... 3 30 5.1 Introduction ............................................................................................................. 3 31 5.2 Onboarding, provisioning and configuration ............................................................ 4 32 5.3 Device management ............................................................................................... 6 33 5.3.1 Overview ......................................................................................................... 6 34 5.3.2 Diagnostics and maintenance Resource Type .................................................. 6 35 5.3.3 Core behaviours on Device maintenance state changes .................................. 7 36 5.3.4 Network monitoring Resource Type ................................................................. 9 37 5.3.5 Software update Resource Type .................................................................... 13 38 5.4 Scenes ................................................................................................................. 18 39 5.4.1 Introduction ................................................................................................... 18 40 5.4.2 Scenes Resource model ................................................................................ 18 41 5.4.3 Security considerations.................................................................................. 22 42 5.5 Icons ..................................................................................................................... 23 43 5.5.1 Overview ....................................................................................................... 23 44 5.5.2 Resource ....................................................................................................... 23 45 5.6 Alerts .................................................................................................................... 23 46 5.6.1 Overview ....................................................................................................... 23 47 5.6.2 Resource Types ............................................................................................ 24 48 5.6.3 Example of Use ............................................................................................. 25 49 (normative) Resource Type definitions ................................................................... 26 50 A.1 List of Resource Type definitions .......................................................................... 26 51 A.2 Device Configuration ............................................................................................. 26 52 A.2.1 Introduction ................................................................................................... 26 53 A.2.2 Example URI ................................................................................................. 26 54 A.2.3 Resource type ............................................................................................... 26 55 A.2.4 OpenAPI 2.0 definition ................................................................................... 26 56 A.2.5 Property definition ......................................................................................... 31 57 A.2.6 CRUDN behaviour ......................................................................................... 31 58 A.3 Platform Configuration .......................................................................................... 32 59 A.3.1 Introduction ................................................................................................... 32 60 A.3.2 Example URI ................................................................................................. 32 61 A.3.3 Resource type ............................................................................................... 32 62 A.3.4 OpenAPI 2.0 definition ................................................................................... 32 Copyright Open Connectivity Foundation, Inc. © 2016-2019. All rights Reserved 63 A.3.5 Property definition ......................................................................................... 35 64 A.3.6 CRUDN behaviour ......................................................................................... 35 65 A.4 Icon ...................................................................................................................... 35 66 A.4.1 Introduction ................................................................................................... 35 67 A.4.2 Example URI ................................................................................................. 35 68 A.4.3 Resource type ............................................................................................... 36 69 A.4.4 OpenAPI 2.0 definition ................................................................................... 36 70 A.4.5 Property definition ......................................................................................... 37 71 A.4.6 CRUDN behaviour ......................................................................................... 38 72 A.5 Maintenance ......................................................................................................... 38 73 A.5.1 Introduction ................................................................................................... 38 74 A.5.2 Well-known URI ............................................................................................. 38 75 A.5.3 Resource type ............................................................................................... 38 76 A.5.4 OpenAPI 2.0 definition ................................................................................... 38 77 A.5.5 Property definition ......................................................................................... 41 78 A.5.6 CRUDN behaviour ......................................................................................... 42 79 A.6 Network Monitoring ............................................................................................... 42 80 A.6.1 Introduction ................................................................................................... 42 81 A.6.2 Example URI ................................................................................................. 42 82 A.6.3 Resource type ............................................................................................... 42 83 A.6.4 OpenAPI 2.0 definition ................................................................................... 42 84 A.6.5 Property definition ......................................................................................... 45 85 A.6.6 CRUDN behaviour ......................................................................................... 46 86 A.7 Scene List ............................................................................................................. 46 87 A.7.1