EdgeSense Southbound Service Development

Introduction

You will need SRP-Plugin and Agentlite.

SRP-Plugin is xxx

Agentlite is a run-time collections for Plugin to execute. Plugin have to put in module folder.

Development

Requirement

For Windows development,

• Please install Visual Studio 2008 or above. Visual Studio is available at official website.

For Ubuntu 16.04 development, please install below software,

$ sudo apt install autoconf autotools-dev libtool libmosquitto1 sqlite3 libxml2-dev libcurl4-openssl-dev libx11-dev libxtst-dev libxext-dev libmosquitto-dev libssl-dev

To run Southbound Plugin, need local MQTT Broker, please download and setup.

MQTT Broker For Windows

• download

MQTT Broker for Ubuntu 16.04

• download

$ sudo chmod +x MQTTBrokerSetup-1.0.5-Ubuntu_16.04-x86_64.run
$ sudo ./MQTTBrokerSetup-1.0.5-Ubuntu_16.04-x86_64.run

Download SRP-Plugin and Agentlite

Download SRP-Plugin

git clone http://advgitlab.eastasia.cloudapp.azure.com/SRP-Connect/SRP-Plugin.git

Download Agentlite

git clone https://github.com/ADVANTECH-Corp/agentlite.git

Development for Windows

1. Open SRP-Plugin\SRP-Plugin.sln with Visual Studio.

2. Change Solution Configurations to Release , change Solution Platforms to Win32.

3. In Solution Explorer, choose HandlerSample and build it.

4. After build is completed, HandlerSample plugin is generated in SRP-Plugin\Release\module folder.

5. Copy HandlerSample.dll, module_config.xml to agentlite\prebuilt\module folder.

When we download agentlite, it looks like this picture:

Copy HandlerSample.dll, module_config.xml to agentlite\prebuilt\module folder.

6. Modify agentlite\prebuilt\module\module_config.xml

<ModuleNum>1</ModuleNum>
<ModuleName1>HandlerSample</ModuleName1>
<ModulePath1>\module\HandlerSample.dll</ModulePath1>
<ModuleEnable1>TRUE</ModuleEnable1>

7. Modify agentlite\prebuilt\agent_config.xml

<DeviceName>HandlerSample</DeviceName>
<DevID>HandlerSample</DevID>
<SN>HandlerSample</SN>
<DevType>Service</DevType>
<WorkDir></WorkDir>
<ServiceName>Agent_HandlerSample</ServiceName>

8. Run Southbound plug-in.

cd agentlite\prebuilt
CAgent.exe -n  

Development for Ubuntu 16.04

1. Build SRP-Plugin and HandlerSample plugin

$ cd SRP-Plugin
$ sudo ./pre-install_ubuntu.sh
$ ./build-srpplugin.sh

After build is complete, HandlerSample plugin is generated in SRP-Plugin\Release\module folder.

$ ls -1 Release/module/
HandlerSample.so
HandlerSample.so.0
HandlerSample.so.0.0.0
ModbusSample.so
ModbusSample.so.0
ModbusSample.so.0.0.0
module_config.xml

6. Modify agentlite/prebuilt/module/module_config.xml

<ModuleNum>1</ModuleNum>
<ModuleName1>HandlerSample</ModuleName1>
<ModulePath1>/module/HandlerSample.so</ModulePath1>
<ModuleEnable1>TRUE</ModuleEnable1>

7. Modify agentlite/prebuilt/agent_config.xml

<DeviceName>HandlerSample</DeviceName>
<DevID>HandlerSample</DevID>
<SN>HandlerSample</SN>
<DevType>Service</DevType>
<WorkDir></WorkDir>
<ServiceName>Agent_HandlerSample</ServiceName>

8. Run Southbound plug-in.

$ cd agentlite/prebuilt
$ ./cagent -n

Then you will see HandlerSample is loaded.

$ ./cagent -n
[XMLBase] DllInitializer
Current path: /home/adv/work/SouthboundAgent/Release/
Couldn't open /var/run/Agent_HandlerSample.pid for writing.
ens3 MAC: 525400175C4A
ens3 MAC: 52:54:00:17:5C:4A
[SAManager] DllInitializer
[SAManager] DllFinalizer
[SAManager] DllInitializer
HandlerLoader loaded
NamedPipe: /tmp/SAWatchdogFifo, CommID: 1, IPC Connect failed!
DllInitializer
DllFinalizer
DllInitializer
GeneralHandler loaded
 general> Initialize
Cannot find Rule Engine!
  /home/adv/work/SouthboundAgent/Release/libRuleEngine.so: cannot open shared object file: No such file or directory!!
DllInitializer
Load HandlerSample Successful

 HandlerSample> InitializeSADataSync_Initialize()

Cannot find SADataSync!

> HandlerSample StartAgent Initialized
Agent_HandlerSample no-service is start successfully!