diff --git a/TS-0041-oneM2M-SensorThings_interworking.md b/TS-0041-oneM2M-SensorThings_interworking.md index 9920439ba35759b0081e178cce9934198e5bea98..72cd7f9b67827aff3b89e32199ea0ad1baecc1d0 100644 --- a/TS-0041-oneM2M-SensorThings_interworking.md +++ b/TS-0041-oneM2M-SensorThings_interworking.md @@ -244,6 +244,53 @@ Once the destination-"Datastream" is created, the IPE can send an "Observation" **Figure 6.3.1.2-1: Message flow from IPE to OGC/STA Server to OGC/STA Client** +### 6.3.2 Configuration of the oneM2M CSE + +#### 6.3.2.0 Overview + +The IPE needs to perform configuration steps on the hosting CSE. + +#### 6.3.2.1 Communication direction oneM2M CSE towards IPE + +In Figure 6.3.2.1-1 a oneM2M AE, triggered by a sensor, sends data to the CSE by creating a `<contentInstance>` in a `<container>` at the CSE. +The IPE subscribes to the `<container>`by creating a `<subscription>` and receives a `<notification>` message along with the `<contentInstance>` when new data arrives. + + + +**Figure 6.3.2.1-1: Message flow from AE to CSE to IPE** + +The IPE shall set a `<subscription>` to the `<container>` that holds the data to be forwarded to OGC/STA server. + + + +**Figure 6.3.2.1-2: Configuration message flow for CSE to IPE direction** + +The detailed configuration steps are shown in Figure 6.3.2.1-2: +1) The IPE creates a `<subscription>` to the `<container>` that is appointed to hold the data to be forwarded to the OGC/STA side. +2) The hosting CSE evaluates the request, performs the appropriate checks, and creates the `<subscription>` resource. +3) The hosting CSE responds with a successful result message of the `<subscription>` resource creation; otherwise, it responds with an error. + +#### 6.3.2.2 Communication direction IPE towards oneM2M CSE + +In Figure 6.3.2.2-1, a oneM2M AE creates a `<subscription>` to the destination `<container>` in the CSE that is used by the IPE to store data from the OGC/STA server. The IPE creates a `<contentInstance>` in the dedicated `<container>`. Subsequently, the AE receives a `<notification>` along with data contained in a `<contentInstance>` every time when the IPE creates new data. + + + +**Figure 6.3.2.2-1: Data message flow from IPE to CSE to AE** + +If the destination `<container>` does not exist, it shall be created. If the creation of a `<container>` requires a related `<AE>`, the `<AE>` shall be registered on the hosting CSE. The required URLs shall be available to the IPE during operation. + + + +**Figure 6.3.2.2-2: Configuration message flow for IPE to CSE direction** + +The detailed configuration steps are shown in Figure 6.3.2.2-2: +1) The IPE requests to register an `<AE>` resource on the hosting CSE. +2) The hosting CSE evaluates the request, performs the appropriate checks, and registers the `<AE>` resource. +3) The hosting CSE responds with a successful result message upon successful creation of the `<AE>` resource; otherwise, it responds with an error. +4) The IPE requests to create a `<container>` under the `<AE>`. +5) The hosting CSE evaluates the requests, performs the appropriate checks, and creates the `<container>` resource. +6) The hosting CSE responds with a successful result message upon successful creation of the `<container>` resource; otherwise, it responds with an error. # Proforma copyright release text block <mark>This text box shall immediately follow after the heading of an element (i.e. clause or annex) containing a proforma or template which is intended to be copied by the user. Such an element shall always start on a new page.</mark> diff --git a/media/config_cse1.png b/media/config_cse1.png new file mode 100644 index 0000000000000000000000000000000000000000..c9c2a569d39cd0a038154eedc4c4879c806895de Binary files /dev/null and b/media/config_cse1.png differ diff --git a/media/config_cse23.png b/media/config_cse23.png new file mode 100644 index 0000000000000000000000000000000000000000..f414f7084eb51f2aec7e2c9f372e851feb63a829 Binary files /dev/null and b/media/config_cse23.png differ diff --git a/media/config_cse_flow13.png b/media/config_cse_flow13.png new file mode 100644 index 0000000000000000000000000000000000000000..a29e00aafb0d715751aa4feeae5cb9d1961e9ebd Binary files /dev/null and b/media/config_cse_flow13.png differ diff --git a/media/config_cse_flow23.png b/media/config_cse_flow23.png new file mode 100644 index 0000000000000000000000000000000000000000..b0aeb99a64d5251a4d2b2d8aa23bf79de9759efe Binary files /dev/null and b/media/config_cse_flow23.png differ