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 Upload 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:
Lighting Condition Data Format:
First 4 bits = pervious status
Last 4 bits = current status
Lighting Condition Value Definition:
0x0 Light off
0x1 Fast blink (0.5s per blink)
0x2 Blinking medium speed (1s per blink)
0x3 Slow flashing (2s per blink)
0x4 Light on
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":"Header", "u":"", "v":0, "min":0, "max":255, "asm":"r", "type":"d", "rt":"", "st":"ipso", "exten":"" }, { "n":"ExtendedTelegramType", "u":"", "v":0, "min":0, "max":255, "asm":"r", "type":"d", "rt":"", "st":"ipso", "exten":"" }, { "n":"OriginatorID", "u":"", "sv":"", "min":0, "max":0, "asm":"r", "type":"s", "rt":"", "st":"ipso", "exten":"" }, { "n":"FwVersion", "u":"", "v":0, "min":0, "max":255, "asm":"r", "type":"d", "rt":"", "st":"ipso", "exten":"" }, { "n":"PacketType", "u":"", "v":0, "min":0, "max":15, "asm":"r", "type":"d", "rt":"", "st":"ipso", "exten":"" }, { "n":"ActionMode", "u":"", "v":0, "min":0, "max":15, "asm":"r", "type":"d", "rt":"", "st":"ipso", "exten":"" }, { "n":"PacketIndex", "u":"", "v":0, "min":0, "max":255, "asm":"r", "type":"d", "rt":"", "st":"ipso", "exten":"" }, { "n":"TxType", "u":"", "v":0, "min":0, "max":15, "asm":"r", "type":"d", "rt":"", "st":"ipso", "exten":"" }, { "n":"BatteryVoltage", "u":"", "v":0, "min":0, "max":15, "asm":"r", "type":"d", "rt":"", "st":"ipso", "exten":"" }, { "n":"Light1", "u":"State", "v":0, "min":0, "max":4, "asm":"r", "type":"d", "rt":"", "st":"ipso", "exten":"" }, { "n":"Light2", "u":"State", "v":0, "min":0, "max":4, "asm":"r", "type":"d", "rt":"", "st":"ipso", "exten":"" }, { "n":"Light3", "u":"State", "v":0, "min":0, "max":4, "asm":"r", "type":"d", "rt":"", "st":"ipso", "exten":"" }, { "n":"Light4", "u":"State", "v":0, "min":0, "max":4, "asm":"r", "type":"d", "rt":"", "st":"ipso", "exten":"" }, { "n":"SignalStrength", "u":"dBm", "v":0, "min":0, "max":255, "asm":"r", "type":"d", "rt":"", "st":"ipso", "exten":"" } ], "bn":"SenData" }, "Info":{ "e":[ { "n":"Name", "u":"", "sv":"LightSensor", "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":"0017000004016943", "handlerName":"general", "sendTS":160081024 } }
Data Upload Format in JSON:
{ "susiCommData":{ "data":{ "SenHub":{ "SenData":{ "e":[ { "n":"Header", "v":47 }, { "n":"ExtendedTelegramType", "v":7 }, { "n":"OriginatorID", "sv":"000004016943" }, { "n":"FwVersion", "v":1 }, { "n":"PacketType", "v":0 }, { "n":"ActionMode", "v":0 }, { "n":"PacketIndex", "v":195 }, { "n":"TxType", "v":1 }, { "n":"BatteryVoltage", "v":15 }, { "n":"Light1", "v":0 }, { "n":"Light2", "v":0 }, { "n":"Light3", "v":0 }, { "n":"Light4", "v":0 }, { "n":"SignalStrength", "v":54 } ], "bn":"SenData" }, "ver":1 } }, "commCmd":2055, "requestID":2001, "agentID":"0017000004016943", "handlerName":"general", "sendTS":160081115 } }
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:
Dashboard HTML:
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:
For the user of WISE-PaaS/EdgeSense
1. Download RMM EI Agent 1.2.4 (or newer) from https://portal-rmm.wise-paas.com/main/system and install it to the Gateway.
2. Double click "ServerSettings" icon on Gateway's desktop.
2.1 Input Password for the Password Authentications dialog and press [Confirm] button to close the dialog.
2.2 Input Credential URL and IoTKey for the Server Setting dialog. Press [Save] to close the dialog.
Note. You can get your "Credential URL" and "IoTKey" from Agent Credential screen in the WISE-PaaS portal: https://portal-rmm.wise-paas.com/main/system
Install additional software modules
1. Download USB receiver driver from https://www.dropbox.com/s/6bguuh4nfynuekn/CDM21228_Setup.zip?dl=0 and install it to the Gateway.
2. 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.
3. Download API-GW 2.0.7 and install it to the Gateway.
4. Download EoLinkManager 1.0.2 from https://www.dropbox.com/s/2ggh18mijhj2fm8/EoLinkManagerSetup_1.0.2.exe?dl=0 and install it to the Gateway.
5. Open EoLinkManager.ini and set the configurations:
> notepad C:\Program Files (x86)\Advantech\EoLinkManager\EoLinkManager.ini
[Platform] [Sensors] |
6. Open WISE-PaaS/EdgeSense portal and add your device, then you can see the data you uploaded from monitor page of WISE-PaaS/EdgeSense or RMM.