diff --git a/TS-0041-oneM2M-SensorThings_interworking.md b/TS-0041-oneM2M-SensorThings_interworking.md index dbc2275be3e197208d59a86943436c75086e402a..7e200e052165ec54cdd1daeac73c0cc0ee3bd45f 100644 --- a/TS-0041-oneM2M-SensorThings_interworking.md +++ b/TS-0041-oneM2M-SensorThings_interworking.md @@ -68,15 +68,11 @@ References are either specific (identified by date of publication and/or edition ## 2.1 Normative references -<mark>Clause 2.1 only shall contain normative (essential) references which are cited in the document itself. These references have to be publicly available and in English.</mark> -The following referenced documents are necessary, partially or totally, for the application of the present document. Their use in the context of this TS is specified by the normative statements that are referring back to this clause. -- Use the **EX** style, enclose the number in square brackets and separate it from the title with a tab (you may use sequence fields for automatically numbering references, see clause A.4: "Sequence numbering") (see example). - -`EXAMPLE:` -- <a name="_ref_1">[1]</a> ETSI TR 102 473: "<Title>". + +- <a name="_ref_1">[1]</a> OGC SensorThings API "Part 1: Sensing Version 1.1" (http://www.opengis.net/doc/is/sensorthings/1.1) ## 2.2 Informative references @@ -87,7 +83,8 @@ The following referenced documents are not necessary for the application of the - Use the **EX** style, add the letter "i" (for informative) before the number (which shall be in square brackets) and separate this from the title with a tab (you may use sequence fields for automatically numbering references). -- <a href="#_ref_i.1">[i.1]</a> oneM2M Drafting Rules (http://www.onem2m.org/images/files/oneM2M-Drafting-Rules.pdf) +- <a href="#_ref_i.1">[i.1]</a> oneM2M Drafting Rules (http://www.onem2m.org/images/files/oneM2M-Drafting-Rules.pdf) + # 3 Definition of terms, symbols and abbreviations @@ -151,8 +148,30 @@ For the purposes of the present document, the [following] abbreviations [given i The key words "Shall", "Shall not", "May", "Need not", "Should", "Should not" in this document are to be interpreted as described in the oneM2M Drafting Rules <a href="#_ref_i.1">[i.1]</a> -# 5 User defined clause(s) from here onwards -<Text> +# 5 Introduction to OGC SensorThings API + + +The SensorThings API (STA) is a standard of the Open Geospatial Consortium (OGC). It provides a framework for communication and exchanging data between sensors and applications. The standard is devided in two parts. SensorThings API Part 1 is dedicated to sensing and was published in 2016 and updated in 2021 <a href="#_ref_1">[1]</a>. +A STA-based architecture works in client/server mode. A sensor device pushes data to the SensorThings Server via HTTP. A SensorThings Server may also support MQTT protocol to support publish and subscribe capabilities. An interested application can subscribe to the MQTT-Broker, in order to get notified about new sensor events. + +<figure> + <img src="media/STA_flow.png" alt="STA_message_flow"> + <figcaption>Figure 5-1 STA message flow</figcaption> +</figure> + +The data in the SensorThings server are organized as according to **Sensing Entities** (see Figure 5.0-1: Sensing Entities data model <a href="#_ref_1">[1]</a>). + +<figure> + <img src="media/data_model.jpg" alt="data_model"> + <figcaption>Figure 5-1 STA Sensing Entities Data Model <a href="#_ref_1">[1]</a></figcaption> +</figure> + +In the Sensing Entities Data Model events or sensor data are called "observations". Before a sensor is able to push an observation to the server it needs at least a 'Thing' and a 'Datastream' entity. This has to be created beforehand. One 'Thing' might have different 'Sensors', one 'Location' or many 'HistoricalLocations'. + +The Sensing Entities data model and the purpose of data within the data model discloses mainly two data characteristics, associated with a 'thing': +- Data observations originated by sensors or commands sent to interact with actuators may be seen as IoT data from oneM2M point of view. + While: +- Data embedded in the Sensing Entities Data Model, like "historic locations" should be seen as data for documentation purposes. ## 5.1 User defined subdivisions of clause(s) from here onwards diff --git a/media/.gitkeep b/media/.gitkeep new file mode 100644 index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 diff --git a/media/STA_flow.png b/media/STA_flow.png new file mode 100644 index 0000000000000000000000000000000000000000..3657ff273ffce7abd687410ec9ba32b311d15076 Binary files /dev/null and b/media/STA_flow.png differ diff --git a/media/data_model.jpg b/media/data_model.jpg new file mode 100644 index 0000000000000000000000000000000000000000..c7a0684badf482d4f29db876f05b126614d23427 Binary files /dev/null and b/media/data_model.jpg differ diff --git a/media/image1.png b/media/image1.png new file mode 100644 index 0000000000000000000000000000000000000000..97c1800c30f775e41f7ceeccb99e5678e51651cd Binary files /dev/null and b/media/image1.png differ