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 How to
- 11 Grafana Dashboard
- 12 Release
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
How to
Software Requirements
- USB receiver driver
- MQTT broker
- WISE-Agent
- API-GW
Software Installation for Windows 10
Install Steps
- Install USB receiver driver
- Install MQTT Broker
- Install API-GW
- Install EoLinkManager , edit config, then restart service.
- Install WISE-Agent
Uninstall Steps
- Select the Start button, then select Settings > Apps. Choose the program you want to remove, and then select Uninstall.
- WISE-Agent
- EoLinkManager
- API-GW
- MQTT Broker
Configuration
In Windows 10
- You can edit C:\Program Files (x86)\Advantech\EoLinkManager\EoLinkManager.ini to change setting.
- Notice: Once config is changed, please using Windows Services Manager to restart EoLinkManager service or reboot gateway in order to apply new setting.
Setting File example:
|
[Platform] [Sensors] |
InterfaceName
- Assign Interface name
ServerURL
- Assign MQTT broker ip
ServerPort
- Assign MQTT broker port
ModuleName
- Assign module name
SerialPort
- Assign serial port which USB receiver (USB300) is using.
Interval
- The time delay between data access round in second.
NumberOfSensors
- Assign number of Tower Light Sensor module
Sensor0
- Assign id for Tower Light Sensor module. Format is Sensor0=<<MODULE_ID>>
- If you have multi Tower Light Sensor module, please start at a number 0 for the first module.
- Second module use Sensor1.
Service control
In Windows
Check if EoLinkManager service is running:
- Use Service to check status of EoLinkManager service
Restart EoLinkManager service:
- Use Service to restart EoLinkManager service
Start EoLinkManager service:
- Use Service start EoLinkManager service
Stop EoLinkManager service:
- Use Service stop EoLinkManager service
Grafana Dashboard
1. Sign in WISE-PaaS Dashboard using your User ID and Password:
2. Create Data Sources
Choose Configuration -> Data Source -> RMM-SimpleJson
Edit settings as follow
|
Name: RMM-SimpleJson HTTP Auth Basic Auth Details |
3. Create Dashboard
Choose Create -> Import -> Or paste JSON
Paste content of Tower Light dashboard Grafana Dashboard json, then choose Load.
In RMM-EIOT , choose RMM-SimpleJSON , then choose Import to save and apply.
4. Drop down “Home” and select Tower Light Board.
7. Drop down “Tower Light” and select “Edit” to edit the widget’s HTML:
8. Define Tower Light Sensor ID in the widget’s HTML:
9. Define RMM SimpleJSON url in the widget’s HTML
- Notice: you need to change url for your environment.
* url format is [http:// http://]<EDGESENSE_URL>/rmm/v1/grafana/simplejson/query , replace <EDGESENSE_URL> with your EdgeSense url.
5. You will see the board is showed like this when all lights off:
6. You will see the board is showed like this when all lights on:
Release
| Index | Version | Date |
Platform |
OS |
Release Note |
Download Link |
| 1 | 1.0.2 | 2018// | x86_64 CPU |
Windows 10 |
USB receiver driver: Grafana dashboard: Above files are available at local server, please paste file's url in File Explorer to copy file. | |
| 2 | 1.0.3 | coming soon | x86_64 CPU |
Windows 10 |
|
USB receiver driver: Grafana dashboard: Above files are available at local server, please paste file's url in File Explorer to copy file.
|
| 3 |
| |||||
| 4 | |
|