この規格 プレビューページの目次
※一部、英文及び仏文を自動翻訳した日本語訳を使用しています。
序文
ISO (国際標準化機構) と IEC (国際電気標準会議) は、世界標準化のための専門システムを形成しています。 ISO または IEC のメンバーである国家機関は、技術活動の特定の分野を扱うために、それぞれの組織によって設立された技術委員会を通じて、国際規格の開発に参加しています。 ISO と IEC の技術委員会は、相互に関心のある分野で協力しています。 ISO および IEC と連携して、政府および非政府の他の国際機関もこの作業に参加しています。情報技術の分野では、ISO と IEC が合同技術委員会 ISO/IEC JTC 1 を設立しました。
この文書の開発に使用された手順と、今後の維持のために意図された手順は、ISO/IEC 指令で説明されています。 1. 特に、さまざまなタイプの文書に必要なさまざまな承認基準に注意する必要があります ( www.iso.org/directives を参照)
このドキュメントの要素の一部が特許権の対象となる可能性があることに注意してください。 ISO および IEC は、そのような特許権の一部またはすべてを特定する責任を負わないものとします。ドキュメントの開発中に特定された特許権の詳細は、序文および/または受信した特許宣言の ISO リストに記載されます ( www.iso.org/patents を参照)
このドキュメントで使用されている商号は、ユーザーの便宜のために提供された情報であり、保証を構成するものではありません。
規格の自発的な性質の説明、適合性評価に関連する ISO 固有の用語と表現の意味、および技術的貿易障壁 (TBT) における世界貿易機関 (WTO) の原則への ISO の準拠に関する情報については、以下を参照してください。 www.iso.org/iso/foreword.html .
このドキュメントは、Open Connectivity Foundation (OCF) によって (OCF Bridging Specification, バージョン 1.0.0 として) 作成され、その編集規則に従って作成されました。これは、JTC 1 PAS 手順の下で、合同技術委員会 ISO/IEC JTC 1, 情報技術によって採用されました。
ISO/IEC 30118 シリーズのすべての部品のリストは、ISO Web サイトで見つけることができます。
1 スコープ
このドキュメントは、OCF デバイスと他のエコシステム間の変換のためのフレームワークを指定し、AllJoyn プロデューサー アプリケーションを OCF クライアントに公開し、OCF サーバーを AllJoyn コンシューマー アプリケーションに公開するトランスレーターの動作を指定します。特定の AllJoyn インターフェイスと特定の OCF リソース タイプとの間の変換は、他の仕様に委ねられています。 AllJoyn 以外のプロトコルの翻訳は、この仕様の将来のバージョンに委ねられています。このドキュメントは、より具体的なドキュメントによって上書きされない限り、適用される一般的な要件を提供します。
2 参考文献
以下のドキュメントの全体または一部は、このドキュメントで規範的に参照されており、その適用に不可欠です。日付のある参考文献については、引用された版のみが適用されます。日付のない参照については、参照文書の最新版 (修正を含む) が適用されます。
- AllJoyn インターフェイス仕様について、機能インターフェイス定義について、バージョン 14.12
https://allseenalliance.org/framework/documentation/learn/core/about-announcement/interface - AllJoyn 構成インターフェース仕様、構成インターフェース定義、バージョン 14.12
https://allseenalliance.org/framework/documentation/learn/core/configuration/interface - D バス仕様、 D バス仕様
https://dbus.freedesktop.org/doc/dbus-specification.html - IEEE 754, 浮動小数点演算の IEEE 標準、 2008 年 8 月
- IETF RFC 4122, Universally Unique IDentifie, 2013 年 10 月
https://www.rfc-editor.org/info/rfc7049 - IETF RFC 7159, JavaScript Object Notation (JSON) データ交換フォーマット、 2014 年 3 月
https://www.rfc-editor.org/info/rfc7159 - JSON スキーマ コア、 JSON スキーマ: コアの定義と用語、2013 年 1 月
http://json-schema.org/latest/json-schema-core.html - JSON Schema Validation, JSON Schema: interactive and non-interactive validation 、2013 年 1 月
http://json-schema.org/latest/json-schema-validation.html - JSON Hyper-Schema, JSON Hyper-Schema: A Vocabulary for Hypermedia Annotation of JSON 、2016 年 10 月
http://json-schema.org/latest/json-schema-hypermedia.html - OCF 1.0 コア仕様、 Open Connectivity Foundation コア仕様、バージョン 1.0
- OCF セキュリティ仕様、 Open Connectivity Foundation セキュリティ仕様、バージョン 1.0
- OCF ASA マッピング、 OCF リソースから ASA インターフェイスへのマッピング、v0.3 候補、2016 年 7 月
https://workspace.openconnectivity.org/apps/org/workgroup/smarthome_tg/download.php/6287/OCF_Resource_to_ASA_Interface_Mapping_v.0.3_candidate.docx - OIC 1.1 コア仕様、 Open Interconnect Consortium コア仕様、バージョン 1.1
- RAML 仕様、 Restful API モデリング言語、バージョン 0.
https://github.com/raml-org/raml-spec/blob/master/versions/raml-08/raml-08.md - OCF リソース タイプ定義、OCF リソース タイプ定義のAPI 定義言語、リリース OCF-v1.0.0
https://github.com/openconnectivityfoundation/bridging
3 用語、定義、記号、略語
3.1 用語と定義
3.1.1
OCF ブリッジ デバイス
図 1 — OCF ブリッジ デバイス コンポーネント
3.1.2
ブリッジプロトコル
OCF プロトコルとの間で変換されている別のプロトコル (AllJoyn など)
3.1.3
翻訳者
特定のブリッジ プロトコルとの間の変換を担当する OCF ブリッジ デバイス コンポーネント。異なるブリッジ プロトコル用に、同じ OCF ブリッジ デバイス上に複数のトランスレータが存在できます。
3.1.4
OCF クライアント
OCFサーバー上のOCFリソースにアクセスする論理エンティティ。OCFブリッジ・デバイスによって公開される仮想OCFサーバーである可能性があります。
3.1.5
ブリッジされたクライアント
ブリッジ プロトコルを介してデータにアクセスする論理エンティティ。たとえば、AllJoyn コンシューマ アプリケーションはブリッジ クライアントです。
3.1.6
仮想 OCF クライアント
OCF ブリッジ デバイスを OCF サーバーに公開する、ブリッジ クライアントの論理表現。
3.1.7
仮想ブリッジ クライアント
OCF ブリッジ デバイスをブリッジ サーバーに公開する OCF クライアントの論理表現。
3.1.8
OCF装置
1 つ以上の OCF の役割 (OCF クライアント、OCF サーバー) を引き受ける論理エンティティ。複数の OCF デバイスが同じ物理プラットフォーム上に存在できます。
3.1.9
仮想OCFサーバー
OCF ブリッジ デバイスを OCF クライアントに公開する、ブリッジ サーバーの論理表現。
3.1.10
ブリッジサーバー
ブリッジ プロトコルを介してデータを提供する論理エンティティ。たとえば、AllJoyn プロデューサーはブリッジ サーバーです。複数の Bridged Server が同じ物理プラットフォーム上に存在できます。
3.1.11
仮想ブリッジ サーバー
OCF ブリッジ デバイスをブリッジ クライアントに公開する OCF サーバーの論理表現。
3.1.12
OCF リソース
OCF フレームワークによってモデル化および公開されたアーティファクトを表します
3.1.13
仮想 OCF リソース
OCF ブリッジ デバイスが OCF クライアントに公開するブリッジ リソースの論理表現。
3.1.14
ブリッジされたリソース
Bridged Protocol によってモデル化および公開されたアーティファクトを表します。たとえば、AllJoyn オブジェクトはブリッジ リソースです。
3.1.15
OCF リソース プロパティ
OCFリソースを通じて公開されるメタデータを含む重要な側面または概念
3.1.16
OCF リソースタイプ
OCF リソースのデータ型定義を表す OCF リソース プロパティ
3.1.17
ブリッジされたリソース タイプ
ブリッジ プロトコルで使用されるスキーマ。たとえば、AllJoyn インターフェイスはブリッジ リソース タイプです。
3.1.18
OCF サーバー
リソースの状態情報を提供し、そのリソースをリモート制御できるようにする役割を持つ論理エンティティ。
3.1.19
オンボーディングツール
OCF セキュリティ仕様で次のように定義されています。
3.1.20
ブリッジされたデバイス
ブリッジ クライアントまたはブリッジ サーバー。
3.1.21
仮想 OCF デバイス
仮想 OCF クライアントまたは仮想 OCF サーバー。
3.2 記号と略語
3.2.1
CRUDN
作成 読み取り 更新 削除 通知
リソースで可能な操作を示す
3.2.2
CSV
カンマ区切り値リスト
コンマで区切られた 1 つの文字列に、より多くのフィールドを持つ構造。値にコンマが含まれる場合、コンマの前に「\」を追加することでコンマをエスケープできます。
3.2.3
OCF
オープン コネクティビティ ファンデーション
これらの仕様を作成した組織
3.2.4
ラムル
RESTful API モデリング言語
実質的に RESTful API を説明するシンプルで簡潔な方法 (OIC 1.1 コア仕様、 Open Interconnect Consortium コア仕様、バージョン 1.1 RAML 仕様を参照)
3.3 規約
この仕様では、いくつかの用語、条件、メカニズム、シーケンス、パラメーター、イベント、状態、または同様の用語が、各単語の最初の文字が大文字で残りが小文字で印刷されています (たとえば、ネットワーク アーキテクチャ)これらの単語の小文字の使用は、通常の技術的な英語の意味を持ちます。
Foreword
ISO (the International Organization for Standardization) and IEC (the International Electrotechnical Commission) form the specialized system for worldwide standardization. National bodies that are members of ISO or IEC participate in the development of International Standards through technical committees established by the respective organization to deal with particular fields of technical activity. ISO and IEC technical committees collaborate in fields of mutual interest. Other international organizations, governmental and non‐governmental, in liaison with ISO and IEC, also take part in the work. In the field of information technology, ISO and IEC have established a joint technical committee, ISO/IEC JTC 1.
The procedures used to develop this document and those intended for its further maintenance are described in the ISO/IEC Directives, 1. In particular, the different approval criteria needed for the different types of document should be noted (see www.iso.org/directives ).
Attention is drawn to the possibility that some of the elements of this document may be the subject of patent rights. ISO and IEC shall not be held responsible for identifying any or all such patent rights. Details of any patent rights identified during the development of the document will be in the Introduction and/or on the ISO list of patent declarations received (see www.iso.org/patents ).
Any trade name used in this document is information given for the convenience of users and does not constitute an endorsement.
For an explanation of the voluntary nature of standards, the meaning of ISO specific terms and expressions related to conformity assessment, as well as information about ISO’s adherence to the World Trade Organization (WTO) principles in the Technical Barriers to Trade (TBT), see www.iso.org/iso/foreword.html .
This document was prepared by the Open Connectivity Foundation (OCF) (as the OCF Bridging Specification, Version 1.0.0) and drafted in accordance with its editorial rules. It was adopted, under the JTC 1 PAS procedure, by Joint Technical Committee ISO/IEC JTC 1, Information technology.
A list of all parts in the ISO/IEC 30118 series can be found on the ISO website.
1 Scope
This document specifies a framework for translation between OCF devices and other ecosystems, and specifies the behaviour of a translator that exposes AllJoyn producer applications to OCF clients, and exposes OCF servers to AllJoyn consumer applications. Translation of specific AllJoyn interfaces to or from specific OCF resource types is left to other specifications. Translation of protocols other than AllJoyn is left to a future version of this specification. This document provides generic requirements that apply unless overridden by a more specific document.
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.
- AllJoyn About Interface Specification, About Feature Interface Definitions, Version 14.12
https://allseenalliance.org/framework/documentation/learn/core/about-announcement/interface - AllJoyn Configuration Interface Specification, Configuration Interface Definition, Version 14.12
https://allseenalliance.org/framework/documentation/learn/core/configuration/interface - D-Bus Specification, D-Bus Specification
https://dbus.freedesktop.org/doc/dbus-specification.html - IEEE 754, IEEE Standard for Floating-Point Arithmetic, August 2008
- IETF RFC 4122, A Universally Unique IDentifier (UUID) URN Namespace, July 2005
https://www.rfc-editor.org/info/rfc4122 - IETF RFC 4648, The Base16, Base32, and Base64 Data Encodings, October 2006
https://www.rfc-editor.org/info/rfc4648 - IETF RFC 6973, Privacy Considerations for Internet Protocols, July 2013
https://www.rfc-editor.org/info/rfc6973 - IETF RFC 7049, Concise Binary Object Representation (CBOR), October 2013
https://www.rfc-editor.org/info/rfc7049 - IETF RFC 7159, The JavaScript Object Notation (JSON) Data Interchange Format, March 2014
https://www.rfc-editor.org/info/rfc7159 - JSON Schema Core, JSON Schema: core definitions and terminology, January 2013
http://json-schema.org/latest/json-schema-core.html - JSON Schema Validation, JSON Schema: interactive and non interactive validation, January 2013
http://json-schema.org/latest/json-schema-validation.html - JSON Hyper-Schema, JSON Hyper-Schema: A Vocabulary for Hypermedia Annotation of JSON, October 2016
http://json-schema.org/latest/json-schema-hypermedia.html - OCF 1.0 Core Specification, Open Connectivity Foundation Core Specification, Version 1.0
- OCF Security Specification, Open Connectivity Foundation Security Specification, Version 1.0
- OCF ASA Mapping, OCF Resource to ASA Interface Mapping, v0.3 candidate, July 2016
https://workspace.openconnectivity.org/apps/org/workgroup/smarthome_tg/download.php/6287/OCF_Resource_to_ASA_Interface_Mapping_v.0.3_candidate.docx - OIC 1.1 Core Specification, Open Interconnect Consortium Core Specification, Version 1.1
- RAML Specification, Restful API modelling language, Version 0.8.
https://github.com/raml-org/raml-spec/blob/master/versions/raml-08/raml-08.md - OCF Resource Type Definitions, API Definition Language for OCF Resource Type Definitions, Release OCF-v1.0.0
https://github.com/openconnectivityfoundation/bridging
3 Terms, definitions, symbols and abbreviations
3.1 Terms and definitions
3.1.1
OCF Bridge Device
Figure 1—OCF Bridge Device Components
3.1.2
Bridged Protocol
another protocol (e.g., AllJoyn) that is being translated to or from OCF protocols
3.1.3
Translator
an OCF Bridge Device component that is responsible for translating to or from a specific Bridged Protocol. More than one translator can exist on the same OCF Bridge Device, for different Bridged Protocols.
3.1.4
OCF Client
a logical entity that accesses an OCF Resource on an OCF Server, which might be a Virtual OCF Server exposed by the OCF Bridge Device.
3.1.5
Bridged Client
a logical entity that accesses data via a Bridged Protocol. For example, an AllJoyn Consumer application is a Bridged Client.
3.1.6
Virtual OCF Client
a logical representation of a Bridged Client, which an OCF Bridge Device exposes to OCF Servers.
3.1.7
Virtual Bridged Client
a logical representation of an OCF Client, which an OCF Bridge Device exposes to Bridged Servers.
3.1.8
OCF Device
a logical entity that assumes one or more OCF roles (OCF Client, OCF Server). More than one OCF Device can exist on the same physical platform.
3.1.9
Virtual OCF Server
a logical representation of a Bridged Server, which an OCF Bridge Device exposes to OCF Clients.
3.1.10
Bridged Server
a logical entity that provides data via a Bridged Protocol. For example, an AllJoyn Producer is a Bridged Server. More than one Bridged Server can exist on the same physical platform.
3.1.11
Virtual Bridged Server
a logical representation of an OCF Server, which an OCF Bridge Device exposes to Bridged Clients.
3.1.12
OCF Resource
represents an artifact modelled and exposed by the OCF Framework
3.1.13
Virtual OCF Resource
a logical representation of a Bridged Resource, which an OCF Bridge Device exposes to OCF Clients.
3.1.14
Bridged Resource
represents an artifact modelled and exposed by a Bridged Protocol. For example, an AllJoyn object is a Bridged Resource.
3.1.15
OCF Resource Property
a significant aspect or notion including metadata that is exposed through the OCF Resource
3.1.16
OCF Resource Type
an OCF Resource Property that represents the data type definition for the OCF Resource
3.1.17
Bridged Resource Type
a schema used with a Bridged Protocol. For example, AllJoyn Interfaces are Bridged Resource Types.
3.1.18
OCF Server
a logical entity with the role of providing resource state information and allowing remote control of its resources.
3.1.19
Onboarding Tool
defined by the OCF Security Specification as: A logical entity within a specific IoT network that establishes ownership for a specific device and helps bring the device into operational state within that network.
3.1.20
Bridged Device
a Bridged Client or Bridged Server.
3.1.21
Virtual OCF Device
a Virtual OCF Client or Virtual OCF Server.
3.2 Symbols and abbreviations
3.2.1
CRUDN
Create Read Update Delete Notify
indicating which operations are possible on the resource
3.2.2
CSV
Comma Separated Value List
construction to have more fields in 1 string separated by commas. If a value contains a comma, then the comma can be escaped by adding “\” in front of the comma.
3.2.3
OCF
Open Connectivity Foundation
organization that created these specifications
3.2.4
RAML
RESTful API Modeling Language
Simple and succinct way of describing practically RESTful APIs (see the OIC 1.1 Core Specification, Open Interconnect Consortium Core Specification, Version 1.1 RAML Specification)
3.3 Conventions
In this specification several 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.