Difference between revisions of "EnOcean Link Solution"

From ESS-WIKI
Jump to: navigation, search
(.)
(.)
Line 326: Line 326:
 
| style="width: 72px; text-align: center;" | Windows 10<br/>
 
| style="width: 72px; text-align: center;" | Windows 10<br/>
 
| style="width: 409px;" |  
 
| style="width: 409px;" |  
 +
*Implement white list
 +
*Use source ID as device name
 
*Run as Windows service
 
*Run as Windows service
 
*Verified&nbsp;by <span style="color:#FF0000;">EdgeSense 1.0.98 on Azure</span>
 
*Verified&nbsp;by <span style="color:#FF0000;">EdgeSense 1.0.98 on Azure</span>

Revision as of 12:38, 6 February 2020

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


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

Notice: Please wire the gateway to Internet with Network cable before install.

Install Steps

  1. Install USB receiver driver
  2. Install MQTT Broker
  3. Install API-GW
  4. Install EoLinkManager , edit config, then restart service.
  5. Install WISE-Agent

Uninstall Steps

  • Select the Start button, then select Settings > Apps. Choose the program you want to remove, and then select Uninstall.
  1. WISE-Agent
  2. EoLinkManager
  3. API-GW
  4. 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]
InterfaceName=EoLinkReceiver
ServerURL=127.0.0.1
ServerPort=1883
ModuleName=EoLinkManager
SensorName=LightSensor
SerialPort=COM3
Interval=1
#Interval: The time delay between data access round in second. 

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

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

Debug

1. Check if service is running

  • Make sure EoLinkManager service is running.
  • Make sure WISEAgent service is running.
  • Make sure APIGateway service is running.
  • Make sure mosquitto service is running.

2. Check EoLinkManger log file

  • log files is available at EoLinkManager installed folder, (ex: C:\Program Files (x86)\Advantech\EoLinkManager\logs)
  • View logs files to check if there are any error messages.

3. Check EoLinkManager configuration

  • Make sure SerialPort setting is the port number USB receiver (USB300) is using.
  • Make sure Tower Light Sensor module id is correct and assigned in Sensors section in configuration file.

4. Check if device id of Tower Light Module is listed in Sensor Hub List

In web browser and open url : http://GATEWAY_IP:3000/restapi/WSNManage/SenHub/AllSenHubList

Once Tower Light Module is managed by EoLinkManager, its device id will be listed in Sensor Hub List as shown on below picture.

RTENOTITLE

5. Check WISE-Agent connection status

  • Launch WISE-Agent shortcut in Windows Desktop.
    RTENOTITLE
  • Check if WISE-Agent is connected as below picture.
    RTENOTITLE

6. Check if sensor data is published to WISE-PaaS/EdgeSense

  • Use web browser to open WISE-PaaS/EdgeSense web pages.
  • Go to Device Page and choose the LightSensor device you are using, click on Monitor icon.
  • In Monitor page, select SenHub , then you can monitor the LightSensor data payload.


Grafana Dashboard

1. Sign in WISE-PaaS Dashboard using your User ID and Password:

Tower Light 03-1.png

2. Create Data Sources

Choose Configuration -> Data Source -> RMM-SimpleJson

RTENOTITLE

Edit settings as follow

RTENOTITLE

Name: RMM-SimpleJson

HTTP
URL: http://168.63.200.38/rmm/v1/grafana/simplejson/
* Notice: you need to change url for your environment.
Access: Server (default)

Auth
Basic Auth : V

Basic Auth Details
User: xxx
Password:  xxx
* Notice: you need to assign user and password for your EdgeSense authentication.

A static Tower Light Sensor 

3. Create Dashboard

Choose Create -> Import -> Or paste JSON

Paste content of Tower Light dashboard Grafana Dashboard json, then choose Load.

RTENOTITLE

In RMM-EIOT , choose RMM-SimpleJSON , then choose Import to save and apply.

RTENOTITLE


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

Tower Light 04-1.png

Tower Light 05-1.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. Define RMM SimpleJSON url in the widget’s HTML for each light.

Notice: you need to change url for your environment. 

url format is <EDGESENSE_URL>  /rmm/v1/grafana/simplejson/query

replace <EDGESENSE_URL> with your EdgeSense url.

After editing, need to save dashboard.

RTENOTITLE

8. Back to dashboard, choose Edit for Light1 and Light2, Light3, Light4 to modify setting.

RTENOTITLE

In Device, choose Device Id for Tower Light Sensor module.

In Plugin, choose SenHub.

In Sensor, choose SenData/Light1  for Light1

RTENOTITLE

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

RTENOTITLE

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

RTENOTITLE

Notice:

  • If left tower widget won't change, it is because that lef tower widget need cross-site access to EdgeSense.
  • You need to login EdgeSense and save password in web browser so that left tower widget can use it.

RTENOTITLE

A Gantt chart panel for TLS on Grafana

Release

Index Version Date
Platform
OS
Release Note
Download Link
1 1.0.2 2018// x86_64 CPU
Windows 10

EoLinkManager 1.0.2

MQTTBrokerSetup 1.0.3

USB receiver driver:
CDM21228_Setup.exe

Grafana dashboard:
Advantech EIoT DTOS Tower Light Monitoring-Graph-04016943-ADF-20180430.json

2 1.0.3 2019/5/10 x86_64 CPU
Windows 10
  • Implement white list
  • Use source ID as device name
  • Run as Windows service
  • Verified by EdgeSense 1.0.98 on Azure
  • Verified by WISE-Agent 1.2.4
  • Verified by Grafana 5.4.3

API-GW 2.0.7

EoLinkManager 1.0.3

MQTTBrokerSetup 1.0.3

USB receiver driver:
CDM21228_Setup.exe

Grafana dashboard:
Advantech EIoT DTOS Tower Light Monitoring-Graph-04016943-20190510.json

Patch Steps:

  1. First, install EoLinkManager v1.0.3
  2. Stop ​EoLinkManager service
  3. Copy patch files EoLinkManager-1.0.3-patch.zip into EoLinkManager installed folder (ex: C:\Program Files (x86)\Advantech\EoLinkManager\)
  4. Uncompress EoLinkManager-1.0.3-patch.zip to overwrite files.
  5. Start EoLinkManager service


3 1.0.4 2019/12/20 x86_64 CPU x86_64 CPU
  • Add log message
  • Fix no sensor data received cause lost connection
  • Verified by EdgeSense 1.0.106
  • Verified by WISE-Agent 1.2.17

API-GW 2.0.7

EoLinkManager 1.0.4

MQTTBrokerSetup 1.0.4

USB receiver driver:
CDM21228_Setup.exe

Grafana dashboard:
Advantech EIoT DTOS Tower Light Monitoring-Graph-04016943-20190510.json

Above release files are available at local server, please paste file's url in File Explorer to copy file. Refer to Access EdgeSesense release folder