ISO_IEC_30118-4_2021.pdf

Information technology Open Connectivity Foundation(OCF)SpecificationPart 4:ResourcetypespecificationTechnologies de linformation Specification de la Fondation pour la connectivit ouverte(Fondation OCF)Partie 4:Spcification des types de ressourcesINTERNATIONAL STANDARDISO/IEC 30118-4Second edition 2021-10Reference number ISO/IEC 30118-4:2021(E)ISO/IEC 2021iiISO/IEC 30118-4:2021(E)COPYRIGHT PROTECTED DOCUMENT ISO/IEC 2021All rights reserved.Unless otherwise specified,or required in the context of its implementation,no part of this publication may be reproduced or utilized otherwise in any form or by any means,electronic or mechanical,including photocopying,or posting on the internet or an intranet,without prior written permission.Permission can be requested from either ISO at the address below or ISOs member body in the country of the requester.ISO copyright officeCP 401 Ch.de Blandonnet 8CH-1214 Vernier,GenevaPhone:+41 22 749 01 11Email:copyrightiso.orgWebsite:www.iso.orgPublished in Switzerland ISO/IEC 2021 All rights reserved ISO/IEC 30118-4:2021(E)ISO/IEC 2021 All rights reserved iii Contents Page Foreword.xxix Introduction.xxx 1 Scope.1 2 Normative references.1 3 Terms,definitions and abbreviated terms.1 3.1 Terms and definitions.2 3.2 Symbols and abbreviated terms.2 4 Document conventions and organization.2 4.1 Conventions.2 4.2 Notation.2 5 Baseline model constructs.3 5.1 URI.3 5.2 OCF Interfaces.3 5.2.1 Introduction.3 5.2.2 Restricting OCF Interface functionality.4 5.3 OpenAPI specification 2.0 definition.4 5.4 Property definition.5 5.4.1 Common Properties.5 5.4.2 Resource Properties.5 5.4.3 Basic Resource Schema.7 5.4.4 CRUDN operation response codes.7 5.5 Example Resource definitions.7 5.6 Observable Resource Types.7 5.6.1 Introduction.7 5.6.2 Conditional Notification.8 5.7 Composite Resource Types.10 5.8 Document version.11 5.9 Data types.11 6 Resource Type definitions.12 6.1 Introduction.12 6.2 Air Flow.16 6.2.1 Introduction.16 6.2.2 Example URI.16 6.2.3 Resource type.16 6.2.4 OpenAPI 2.0 definition.17 6.2.5 Property definition.19 6.2.6 CRUDN behaviour.20 6.3 Air Flow Control.20 6.3.1 Introduction.20 6.3.2 Example URI.20 6.3.3 Resource type.20 6.3.4 OpenAPI 2.0 definition.20 6.3.5 Property definition.25 6.3.6 CRUDN behaviour.26 ISO/IEC 30118-4:2021(E)iv ISO/IEC 2021 All rights reserved 6.4 Battery.26 6.4.1 Introduction.26 6.4.2 Example URI.26 6.4.3 Resource type.26 6.4.4 OpenAPI 2.0 definition.27 6.4.5 Property definition.29 6.4.6 CRUDN behaviour.30 6.5 Binary Switch.30 6.5.1 Introduction.30 6.5.2 Example URI.30 6.5.3 Resource type.30 6.5.4 OpenAPI 2.0 definition.30 6.5.5 Property definition.32 6.5.6 CRUDN behaviour.32 6.6 Brightness.33 6.6.1 Introduction.33 6.6.2 Example URI.33 6.6.3 Resource type.33 6.6.4 OpenAPI 2.0 definition.33 6.6.5 Property definition.35 6.6.6 CRUDN behaviour.35 6.7 Colour Chroma.35 6.7.1 Introduction.35 6.7.2 Example URI.36 6.7.3 Resource type.36 6.7.4 OpenAPI 2.0 definition.36 6.7.5 Property definition.38 6.7.6 CRUDN behaviour.39 6.8 Colour RGB.39 6.8.1 Introduction.39 6.8.2 Example URI.39 6.8.3 Resource type.39 6.8.4 OpenAPI 2.0 definition.39 6.8.5 Property definition.41 6.8.6 CRUDN behaviour.42 6.9 Dimming.42 6.9.1 Introduction.42 6.9.2 Example URI.42 6.9.3 Resource type.42 6.9.4 OpenAPI 2.0 definition.42 6.9.5 Property definition.44 6.9.6 CRUDN behaviour.45 6.10 Door.45 6.10.1 Introduction.45 6.10.2 Example URI.45 6.10.3 Resource type.45 6.10.4 OpenAPI 2.0 definition.45 6.10.5 Property definition.47 ISO/IEC 30118-4:2021(E)ISO/IEC 2021 All rights reserved v 6.10.6 CRUDN behaviour.48 6.11 Energy Consumption.48 6.11.1 Introduction.48 6.11.2 Example URI.48 6.11.3 Resource type.48 6.11.4 OpenAPI 2.0 definition.48 6.11.5 Property definition.50 6.11.6 CRUDN behaviour.50 6.12 Energy Usage.51 6.12.1 Introduction.51 6.12.2 Example URI.51 6.12.3 Resource type.51 6.12.4 OpenAPI 2.0 definition.51 6.12.5 Property definition.56 6.12.6 CRUDN behaviour.57 6.13 Humidity.57 6.13.1 Introduction.57 6.13.2 Example URI.57 6.13.3 Resource type.57 6.13.4 OpenAPI 2.0 definition.57 6.13.5 Property definition.59 6.13.6 CRUDN behaviour.60 6.14 Ice Maker.60 6.14.1 Introduction.60 6.14.2 Example URI.60 6.14.3 Resource type.60 6.14.4 OpenAPI 2.0 definition.60 6.14.5 Property definition.62 6.14.6 CRUDN behaviour.63 6.15 Lock.63 6.15.1 Introduction.63 6.15.2 Example URI.63 6.15.3 Resource type.63 6.15.4 OpenAPI 2.0 definition.63 6.15.5 Property definition.65 6.15.6 CRUDN behaviour.66 6.16 Lock Code.66 6.16.1 Introduction.66 6.16.2 Example URI.66 6.16.3 Resource type.66 6.16.4 OpenAPI 2.0 definition.66 6.16.5 Property definition.68 6.16.6 CRUDN behaviour.68 6.17 Mode.68 6.17.1 Introduction.68 6.17.2 Example URI.68 6.17.3 Resource type.69 6.17.4 OpenAPI 2.0 definition.69 ISO/IEC 30118-4:2021(E)vi ISO/IEC 2021 All rights reserved 6.17.5 Property definition.71 6.17.6 CRUDN behaviour.71 6.18 Open Level.71 6.18.1 Introduction.71 6.18.2 Example URI.72 6.18.3 Resource type.72 6.18.4 OpenAPI 2.0 definition.72