diff --git a/apps/OrionContextBroker/README.md b/apps/OrionContextBroker/README.md index 41644a4..51b63b4 100644 --- a/apps/OrionContextBroker/README.md +++ b/apps/OrionContextBroker/README.md @@ -1,6 +1,6 @@ # Introduction -OrionContextBroker is an OpenMTC AE to forward OpenMTC sensor data (via Subscription) to an instance of the Orion Context Broker. Additionally OpenMTC actuators are handled by forwarding changes on the OCB side via OpenMTC to the actuator. +OrionContextBroker (OCB) is an OpenMTC AE to forward OpenMTC sensor data (via Subscription) to an instance of the Orion Context Broker. Additionally OpenMTC actuators are handled by forwarding changes on the OCB side via OpenMTC to the actuator. All Content Instances are expected to use the SenML format. It is possible to connect the AE either to an OpenMTC Gateway or an OpenMTC Backend. # Getting started @@ -27,6 +27,185 @@ The most important parameters are: * orion_host (hostname:port of the Orion CB) * accumulate_address (Subscription Sink (RESTful HTTP) used for subscriptions to the OCB (actuator functionality)) +## Example Setup with Docker + +![](docker_setup.png) + +The illustration above shows an example setup, which can be created using docker-compose with the docker-compose.yml file listed at the end of this section. +For this example an OpenMTC Interworking Proxy called CUL868IPE is used in simulation mode, in order to periodically generate sensor data without the need of real physical sensors. This IPE will exchange data with an OpenMTC Gateway. The Gateway itself is connected to an OpenMTC Backend. The OpenMTC OCB-App will on one hand forward sensor data to the OrionContextBroker and on the other hand will forward actuator events to the simulated actuator on the CUL868IPE. + +The following docker-compose.yml shows the necessary configuration: + +``` +version: "2" + +services: + gateway: + image: openmtc/gateway-amd64 + ports: + - "8000:8000" + environment: + - ONEM2M_NOTIFICATION_DISABLED=false + - ONEM2M_CSE_ID=TESTUSER~TESTTENANT + - ONEM2M_REGISTRATION_DISABLED=false + - ONEM2M_REMOTE_CSE_POA=http://backend:18000 + - ONEM2M_REMOTE_CSE_OWN_POA=http://gateway:8000 + container_name: gateway + networks: + - main + + backend: + image: openmtc/backend-amd64 + ports: + - "18000:18000" + environment: + - ONEM2M_NOTIFICATION_DISABLED=false + - ONEM2M_HTTP_TRANSPORT_DISABLED=false + - ONEM2M_HTTP_TRANSPORT_SSL_ENABLED=false + container_name: backend + networks: + - main + + orioncontextbroker-app: + image: openmtc/orion-context-broker-app-amd64 + container_name: orioncontextbroker-app + links: + - backend + ports: + - "8086:8086" + - "8080:8080" + environment: + - EP=http://backend:18000 + - ORION_HOST=http://orion:1026 + - ORION_API=v2 + - ACCUMULATE_ADDRESS=http://orioncontextbroker-app:8080 + networks: + - main + + culipe: + image: openmtc/cul868-ipe-amd64 + links: + - gateway + - orioncontextbroker-app + + environment: + - EP=http://gateway:8000 + - DEVICES=["fs20:16108-1"] + - SIM=true + - DEVICE_MAPPINGS={"S300TH_1":"kitchen","FS20_ST3_16108_1":"bath"} + container_name: culipe + networks: + - main + + mongo: + image: mongo:3.4 + command: --nojournal + container_name: mongo + networks: + - main + + orion: + image: fiware/orion + ports: + - "1026:1026" + command: -dbhost mongo -logLevel debug + container_name: orion + networks: + - main + +networks: + main: + driver: bridge +``` + +### Tests with the Docker setup + +After the setup is started, the CUL868IPE will simulate sensor data. In order to get the current temperature value measured by the sensor, it is possible to send a request either to the OpenMTC Backend, OpenMTC Gateway or the OrionContextBroker. + +*OpenMTC Backend* +``` +curl -X "GET" localhost:18000/~/mn-cse-1/onem2m/CUL868IPE/S300TH_1/temperature/latest -s | \ + jq -r '."m2m:cin".con' | \ + base64 -d | jq '.' +``` +```json +[ + { + "bn": "urn:dev:s300th:1", + "v": 3.5796869716517135, + "u": "Cel", + "t": "1527087517.700", + "n": "temperature" + } +] +``` + +*OpenMTC Gateway* +``` +curl -X "GET" localhost:8000/onem2m/CUL868IPE/S300TH_1/temperature/latest -s | \ + jq -r '."m2m:cin".con' | \ + base64 -d | jq '.' +``` +```json +[ + { + "bn": "urn:dev:s300th:1", + "v": 3.5796869716517135, + "u": "Cel", + "t": "1527087517.700", + "n": "temperature" + } +] +``` + +*OrionContextBroker* + +``` +curl localhost:1026/v2/entities/mn-cse-1-Wohnzimmer/ -s -S | jq '."temperature"' +``` +```json +{ + "type": "Float", + "value": 20.569353172, + "metadata": { + "bn": { + "type": "String", + "value": "urn:dev:s300th:1" + }, + "timestamp": { + "type": "String", + "value": "1527093220.104" + }, + "unit": { + "type": "String", + "value": "Cel" + } + } +} +``` + +The following command will switch the current state of the actuator to "ON" by sending a request to the OCB: + +```bash +curl localhost:1026/v2/entities/mn-cse-1-Bad/attrs -s -S \ + --header 'Content-Type: application/json' \ + -X PATCH -d @- <