EnOcean Link Solution
Contents
- 1 System Architecture:
- 2 EnOcean Sensor and Light Tower (chip & demo kit vendor: ROHM)
- 3 Sensor Communication Protocol:
- 4 Tower Light Data Format:
- 5 EnOcean Sample Program:
- 6 Data type and Data Format:
- 7 Data Capability in JSON:
- 8 Data Format in JSON:
- 9 Protocol Specification:
- 10 Dashboard Configuration:
- 11 Gateway Configuration:
System Architecture:
EnOcean Sensor and Light Tower (chip & demo kit vendor: ROHM)
Sensor Communication Protocol:
Tower Light Data Format:
EnOcean Sample Program:
Data type and Data Format:
Agent ID (Sensor ID): String
Sensor Data: Unsigned Integer number
Data Capability in JSON:
{ "susiCommData":{ "infoSpec":{ "SenHub":{ "SenData":{ "e":[ { "n":"Light_1", "u":"State", "v":0, "min":0, "max":4, "asm":"r", "type":"d", "rt":"", "st":"ipso", "exten":"" }, { "n":"Light_2", "u":"State", "v":0, "min":0, "max":4, "asm":"r", "type":"d", "rt":"", "st":"ipso", "exten":"" }, { "n":"Light_3", "u":"State", "v":0, "min":0, "max":4, "asm":"r", "type":"d", "rt":"", "st":"ipso", "exten":"" }, { "n":"Light_4", "u":"State", "v":0, "min":0, "max":4, "asm":"r", "type":"d", "rt":"", "st":"ipso", "exten":"" } ], "bn":"SenData" }, "Info":{ "e":[ { "n":"Name", "u":"", "sv":"LightTower1", "min":0, "max":0, "asm":"r", "type":"s", "rt":"", "st":"ipso", "exten":"" }, { "n":"sw", "u":"", "sv":"1.0.00", "min":0, "max":0, "asm":"r", "type":"s", "rt":"", "st":"ipso", "exten":"" } ], "bn":"Info" }, "Net":{ "e":[ { "n":"sw", "u":"", "sv":"2.0.0.0", "min":0, "max":0, "asm":"r", "type":"s", "rt":"", "st":"ipso", "exten":"" }, { "n":"Neighbor", "u":"", "sv":"", "min":0, "max":0, "asm":"r", "type":"s", "rt":"", "st":"ipso", "exten":"" }, { "n":"Health", "u":"", "v":100, "min":0, "max":0, "asm":"r", "type":"d", "rt":"", "st":"ipso", "exten":"" } ], "bn":"Net" }, "Action":{ "e":[ ], "bn":"Action" }, "ver":1 } }, "commCmd":2052, "requestID":2001, "agentID":"0017000004016940", "handlerName":"general", "sendTS":160081024 } }
Data Format in JSON:
{ "susiCommData":{ "data":{ "SenHub":{ "SenData":{ "e":[ { "n":"Light_1", "v":0 }, { "n":"Light_2", "v":0 }, { "n":"Light_3", "v":0 }, { "n":"Light_4", "v":0 } ], "bn":"SenData" }, "ver":1 } }, "commCmd":2055, "requestID":2001, "agentID":"0017000004016940", "handlerName":"general", "sendTS":160081028 } }
Protocol Specification:
http://ess-wiki.advantech.com.tw/wiki/images/d/d9/Advantech_EnOcean_light_tower_2018.03.18.pdf
Dashboard Configuration:
1. Sign in WISE-PaaS Dashboard using your User ID and Password:
https://dashboard-grafana-eiot.wise-paas.com
2. Drop down “Home” and select Tower Light Board.
Board name: Advantech EIoT DTOS Tower Light Monitoring
3. You will see the board is showed like this when all lights off:
4. You will see the board is showed like this when all lights on:
5. Drop down “Tower Light” and select “Edit” to edit the widget’s HTML:
6. Define Tower Light Sensor ID in the widget’s HTML:
7. RESTful API and HTML request content:
RESTful API:
https://portal-rmm.wise-paas.com/rmm/v1/grafana/simplejson/query
Example:
cache: false
url: 'https://portal-rmm.wise-paas.com/rmm/v1/grafana/simplejson/query'
type: "post",
contentType: 'application/json'
dataType: 'json'
data: '{"timezone":"browser","panelId":2,"range":{"from":"2018-04-09T05:46:51.357Z","to":"2018-04-09T09:46:51.357Z","raw":{"from":"now-6h","to":"now"}},"rangeRaw":{"from":"now-6h","to":"now"},"interval":"20s","intervalMs":20000,"targets":[{"target":"00000001-0000-0000-0017-000004016940|SenHub|/SenData/Light1","device":"00000001-0000-0000-0017-000004016940","plugin":"SenHub","sensor":"/SenData/Light1","refId":"A","type":"table"}],"maxDataPoints":960,"scopedVars":{"__interval":{"text":"20s","value":"20s"},"__interval_ms":{"text":20000,"value":20000}}}'
xhrFields: {withCredentials: true}
8. Lights blinking status for the Tower Light:
Gateway Configuration:
1. Download RMM EI Agent 1.0.12 from https://portal-rmm.wise-paas.com/main/system and install it to the Gateway.
2. Stop services EI-AgentService and SAWatchdog from Task Manager.
3. Download CAgent_Patch_for_WSN-v1-2018-04-09.zip from https://www.dropbox.com/s/icyhvbfqbs1sw2s/CAgent_Patch_for_WSN-v1-2018-04-09.zip?dl=0, unzip and copy the files into the folder which RMM EI Agent installed, ex: C:\Program Files (x86)\Advantech\RMM EI Agent
4. Restart services EI-AgentService and SAWatchdog from Task Manager.
5. Download MQTTBroker 1.0.3 from https://www.dropbox.com/s/wyt3gnenyf7xv3d/MQTTBrokerSetup_1.0.3.exe?dl=0 and install it to the Gateway.
6. Download NodeRed Server IoTGateway v2.0.1 from https://www.dropbox.com/s/qvthwy4a5aeo2yx/NodeRed%20Server%20IoTGateway_v2.0.1.exe?dl=0 and install it to the Gateway.
7. Download EoLinkManager 1.0.1 from https://www.dropbox.com/s/jgvhhp0kqhmf7g2/EoLinkManagerSetup_1.0.1.exe?dl=0 and install it to the Gateway.
8. Open EoLinkManager.ini and set the configurations:
> notepad C:\Program Files (x86)\Advantech\EoLinkManager\EoLinkManager.ini
------------------------------------------
[Platform]
InterfaceName=EoLinkReceiver
ServerURL=127.0.0.1
ModuleName=EoLinkManager
SensorName=LightSensor
SerialPort=COM3
ServerPort=1883
------------------------------------------
9. Reboot Gateway, the program APIGateway and EoLinkManager will auto startup, in case of these two programs are closed, you can restart them manually:
9.1. Run APIGateway manually:
> cd C:\APIGateway
> node app.js
(Tips: You can also double click APIGateway icon on the Gateway's Desktop to run it)
9.2. Run EoLinkManager manually:
> cd C:\Program Files (x86)\Advantech\EoLinkManager
> EoLinkManager.exe
(Tips: You can also double click APIGateway icon on the Gateway's Desktop to run it)
10. Open https://portal-rmm.wise-paas.com/main/device and add your device.
11. Open https://dashboard-grafana-eiot.wise-paas.com to check Tower Light UI.