Skip to content
Snippets Groups Projects
Commit dd683e71 authored by Andreas Kraft's avatar Andreas Kraft
Browse files

Changed paths and image extensions

parent 77b5a22a
No related branches found
No related tags found
1 merge request!2TDE-2024-0034-Initial_conversion_of_TR-0039_to_Markdown
Pipeline #992 passed
......@@ -99,9 +99,9 @@ This clause describes a use case which helps to understand the devices abstracti
This guide is based on the following use case: an application on a Gateway, Cloud/Server, or Smartphone wants to monitor and control lightbulbs. Due to the abstraction layer provided by oneM2M, the monitoring and controlling processes can be performed independently from underlying connectivity technologies. This tutorial is based on the example of Philips Hue lightbulbs (these lightbulbs require dedicated bridge for connection with Gateway). Figure 5.1-1 presents the general architecture of the use case.
NOTE: The terms of use of Philips Hue API are available at https://developers.meethue.com/documentation/terms-use.
NOTE: The terms of use of Philips Hue API are available at https://developers.meethue.com/documentation/terms-use.<mark>Editor note: check this URL</mark>
![LightbulbsUseCase](/Users/akr/Sources/git/tr-0039/media/LightbulbsUseCase.svg)
![LightbulbsUseCase](media/LightbulbsUseCase.png)
**Figure 5.1-1: Overview of the lightbulbs use case**
......@@ -113,7 +113,7 @@ The main components are introduced as follows:
- The Smartphone hosts an application used to remotely control and monitor the lightbulbs in the home and supports the following capabilities:
- Discovery of the lightbulbs deployed in the home.
- Sending commands to change light state i.e. switch on/off and change colour.
- Receive state of a lightbulb.
- Receive state of a lightbulb.<!---->
# 6 Introduction to IPE and SDT
......@@ -130,7 +130,7 @@ The SDT (Smart Device Template) is a reference template to model most home appli
The SDT approach is to define re-usable basic functions (or services) (labelled "ModuleClass" in Figure 6.2-1) which can represent the typical functions found, for example, in many home automation systems, such as "on/off", "dim a lamp", "receive events from binary sensor", "read data from sensor", etc.
![SDTGenericDevice](/Users/akr/Sources/git/tr-0039/media/SDTGenericDevice.svg)
![SDTGenericDevice](media/SDTGenericDevice.png)
**Figure 6.2.1-1: SmartHome Device Template for a generic device**
......@@ -225,7 +225,7 @@ In reference to oneM2M terminology, when a new device is discovered the CSE shou
To allow current non-oneM2M devices ("NoDN", Non-oneM2M Device Node) to connect to the oneM2M system the specification provides "Interworking/Integration of non-oneM2M solutions and protocols" section (Annex F of oneM2M TS-0023 <a href="#_ref_i.2">[i.2]</a>). Figure 6.3-1 shows SDT in oneM2M architecture.
![DataModelTranslation](/Users/akr/Sources/git/tr-0039/media/DataModelTranslation.svg)
![DataModelTranslation](media/DataModelTranslation.png)
**Figure 6.3-1: Translation of non-oneM2M Data Model to SDT Data Model via the IPE**
......@@ -234,7 +234,7 @@ To allow current non-oneM2M devices ("NoDN", Non-oneM2M Device Node) to connect
Clause 7 describes how the elements of this use case are represented by corresponding oneM2M architectural entities. Figure 7-1 presents the functional architecture of this use case.
![FunctionalArchitecture](/Users/akr/Sources/git/tr-0039/media/FunctionalArchitecture.svg)
![FunctionalArchitecture](media/FunctionalArchitecture.png)
**Figure 7-1: oneM2M functional architecture of the bulbs use case**
......@@ -271,7 +271,7 @@ The procedure to register device adapter (IPE-AE) with gateway (MN-CSE) is as fo
- Device adapter (IPE-AE) sends registration request to Gateway (MN-CSE).
- Gateway (MN-CSE) responds with status of the registration and Content-Location header for the registered entity.
![AERegistration](/Users/akr/Sources/git/tr-0039/media/AERegistration.svg)
![AERegistration](media/AERegistration.png)
**Figure 8.2.1-1: AE registration with CSE request**
......@@ -286,7 +286,7 @@ The procedure to create resource tree for particular SDT Device (deviceLight in
- Device adapter (IPE-AE) sends a CREATE request to gateway (MN-CSE) to create _&lt;flexContainer>_ for a single Action. The _&lt;flexContainer>_ which represents Action is set as a child of _&lt;flexContainer>_ which represents Module.
- Gateway (MN-CSE) responds with URI for created Action.
![ResourceTreeSDTDevice](/Users/akr/Sources/git/tr-0039/media/ResourceTreeSDTDevice.svg)
![ResourceTreeSDTDevice](media/ResourceTreeSDTDevice.png)
**Figure 8.2.2-1: Creation of resource tree for SDT Device**
......@@ -300,7 +300,7 @@ The procedure to register utility application (ADN-AE-1) with server (IN-CSE) is
- Utility application (ADN-AE-1) sends registration request to gateway (IN-CSE).
- Server (IN-CSE) responds with status of the registration and Content-Location header for the registered entity.
![ADNAERegistration](/Users/akr/Sources/git/tr-0039/media/ADNAERegistration.svg)
![ADNAERegistration](media/ADNAERegistration.png)
**Figure 8.3.1-1: AE registration with CSE request**
......@@ -312,7 +312,7 @@ The procedure to discover SDT Device is as follows:
- Utility application (ADN-AE-1) sends a RETRIEVE request to server (IN-CSE) including filter criteria conditions, especially it could be a _containerDefinition_ attribute (e.g. org.onem2m.home.devices.deviceLight).
- Server (IN-CSE) responds with list of URIs of the discovered resources, if any (especially URI for deviceLight which represents a bulb).
![DiscoverySDTDevice](/Users/akr/Sources/git/tr-0039/media/DiscoverySDTDevice.svg)
![DiscoverySDTDevice](media/DiscoverySDTDevice.png)
**Figure 8.3.2-1: Discovery of SDT Device with filter criteria**
......@@ -326,7 +326,7 @@ The procedure to retrieve needed URIs for Modules which are associated with part
- Utility application (ADN-AE-1) sends a request to server (IN-CSE) with URI of the Device.
- Server (IN-CSE) responds with a list of the Modules URIs.
![DiscoveryModules](/Users/akr/Sources/git/tr-0039/media/DiscoveryModules.svg)
![DiscoveryModules](media/DiscoveryModules.png)
**Figure 8.3.3.1-1: Discovery of Modules related to SDT Device**
......@@ -340,7 +340,7 @@ The procedure to get values of all DataPoints which belong to particular ModuleC
- Utility application (ADN-AE-1) sends a RETRIEVE request to server (IN-CSE) with information which ModuleClass's DataPoints should be retrieved.
- Server (IN-CSE) responds with current values of all DataPoints which belong to the ModuleClass that was requested.
![DataPointRetrieve](/Users/akr/Sources/git/tr-0039/media/DataPointRetrieve.svg)
![DataPointRetrieve](media/DataPointRetrieve.png)
**Figure 8.3.3.2-1: DataPoint retrievement**
......@@ -351,7 +351,7 @@ The procedure to change DataPoint value is as follows:
- Utility application (ADN-AE-1) sends an UPDATE request to server (IN-CSE) with _&lt;flexContainer>_ which contains the new value of the DataPoint. There is also a possibility to change more than one DataPoint of particular ModuleClass in a single request (in this case the &lt;flexContainer> contains new values of all needed DataPoints.
- Server (IN-CSE) responds with status of DataPoint's UPDATE operation.
![DataPointValueChange](/Users/akr/Sources/git/tr-0039/media/DataPointValueChange.svg)
![DataPointValueChange](media/DataPointValueChange.png)
**Figure 8.3.3.3-1: Change value of a DataPoint**
......@@ -363,7 +363,7 @@ The procedure to trigger an Action with no arguments is as follows:
- Utility application (ADN-AE-1) sends an UPDATE request to server (IN-CSE) with empty _&lt;flexContainer>_.
- Server (IN-CSE) responds with status of UPDATE operation.
![ActionTriggering](/Users/akr/Sources/git/tr-0039/media/ActionTriggering.svg)
![ActionTriggering](media/ActionTriggering.png)
**Figure 8.3.3.4-1: Action triggering procedure**
......@@ -377,7 +377,7 @@ The procedure of creating a _&lt;subscription>_ resource is as follows:
- Utility application (ADN-AE-1) sends a CREATE request to server (IN-CSE).
- Server (IN-CSE) responds with all parameters of created _&lt;subscription>_ resource.
![SubscriptionCreation](/Users/akr/Sources/git/tr-0039/media/SubscriptionCreation.svg)
![SubscriptionCreation](media/SubscriptionCreation.png)
**Figure 8.3.3.5-1: Subscription creation procedure**
......@@ -386,7 +386,7 @@ There's a mechanism that allows Server to check listener's availability. The pro
- Server (IN-CSE) sends verification request to listener (ADN-AE-1).
- Listener (ADN-AE-1) responds with HTTP 200 OK status.
![ListenerVerification](/Users/akr/Sources/git/tr-0039/media/ListenerVerification.svg)
![ListenerVerification](media/ListenerVerification.png)
**Figure 8.3.3.5-2: Listener's status verification procedure**
......@@ -396,7 +396,7 @@ A change of DataPoint's value triggers a notification message with new DataPoint
- Server (IN-CSE) sends to utility application (ADN-AE-1) notification with new DataPoint value.
- Utility application (ADN-AE-1) sends confirmation of receiving the notification.
![NotificationMechanism](/Users/akr/Sources/git/tr-0039/media/NotificationMechanism.svg)
![NotificationMechanism](media/NotificationMechanism.png)
**Figure 8.3.3.5-3: Notification mechanism procedure**
......@@ -405,7 +405,7 @@ The procedure of deletion of a &lt;subsription> resource is as follows:
- Utility application (ADN-AE-1) sends a DELETE request to server (IN-CSE).
- Server (IN-CSE) responds with deletion confirmation.
![SubscriptionDeletion](/Users/akr/Sources/git/tr-0039/media/SubscriptionDeletion.svg)
![SubscriptionDeletion](media/SubscriptionDeletion.png)
**Figure 8.3.3.5-4: Deletion of &lt;subscription> resource procedure**
......@@ -922,7 +922,7 @@ class HSVColour {
Clause 9.4 describes registration of AE for utility application, discovery process and controlling and monitoring devices.
![Figure 9.4.0-1 Scope of 9.4 Developer of the utility application section](/Users/akr/Sources/git/tr-0039/media/ScopeUtilityApp.png)
![Figure 9.4.0-1 Scope of 9.4 Developer of the utility application section](media/ScopeUtilityApp.png)
**Figure 9.4.0-1 Scope of 9.4 Developer of the utility application section**
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment