Difference between revisions of "EnOcean Link Solution"

From ESS-WIKI
Jump to: navigation, search
(.)
(.)
Line 500: Line 500:
 
Notice: 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 https://portal-rmm.wise-paas.com/main/system]
 
Notice: 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 https://portal-rmm.wise-paas.com/main/system]
  
== '''Install additional software modules''' ==
+
== Install additional software modules ==
  
 
1. Download USB receiver driver from [https://www.dropbox.com/s/6bguuh4nfynuekn/CDM21228_Setup.zip?dl=0 https://www.dropbox.com/s/6bguuh4nfynuekn/CDM21228_Setup.zip?dl=0] and install it to the Gateway.
 
1. Download USB receiver driver from [https://www.dropbox.com/s/6bguuh4nfynuekn/CDM21228_Setup.zip?dl=0 https://www.dropbox.com/s/6bguuh4nfynuekn/CDM21228_Setup.zip?dl=0] and install it to the Gateway.

Revision as of 04:56, 30 April 2019

System Architecture:

Rohm light tower sensor demokit 01.png

EnOcean Sensor and Light Tower (chip & demo kit vendor: ROHM)

EnOcean light sensor 01.png

Sensor Communication Protocol:

EnOcean light sensor 03.png

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 light sensor 02.png


EnOcean Sample Program:

EnOcean light sensor 04.png


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

Tower Light 03-1.png


2. Drop down “Home” and select Tower Light Board.

    Board name: Advantech EIoT DTOS Tower Light Monitoring


Tower Light 04-1.png




Tower Light 05-1.png


3. You will see the board is showed like this when all lights off:

Tower Light 01 .png


4. You will see the board is showed like this when all lights on:

Tower Light 02 .png


5. Drop down “Tower Light” and select “Edit” to edit the widget’s HTML:

Tower Light 06-2.png


6. Define Tower Light Sensor ID in the widget’s HTML:

Tower Light 10.png


7. RESTful API and HTML request content:

Tower Light 08-1.png


Dashboard HTML:

https://www.dropbox.com/s/mwtz64atix0uavb/Advantech%20EIoT%20DTOS%20Tower%20Light%20Monitoring-Graph-04016943-ADF-20180430.json?dl=0


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:

Tower Light 09.png

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.

  • Input Password for the Password Authentications dialog and press [Confirm] button to close the dialog. 
  • Input Credential URL and IoTKey for the Server Setting dialog. Press [Save] to close the dialog.

Notice: 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]
InterfaceName=EoLinkReceiver
ServerURL=127.0.0.1
ModuleName=EoLinkManager
SensorName=LightSensor
SerialPort=COM3
ServerPort=1883
Interval=1
#Interval: The time delay between data access round in second. 

[Sensors]
NumberOfSensors=2
Sensor0=04016943
Sensor1=0400E889

Notice: Once config is changed, need to restart service or reboot gateway in order to apply new setting.

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.