View source for Alleantia Service

= Introduction =

<span style="font-size:medium;">&nbsp;[https://www.alleantia.com/ Alleantia]’s IOT SCADA Software implements easily complete supervisory and control systems for industrial devices, single machine and sensors.&nbsp;Expandable without programming, with a native Web architecture and extended functionalities of integrazione for external applications.</span>



<span style="font-size:medium;">Through MQTT Service , IoT SCADA application can publish data collected from different devices and sensors on a listening MQTT broker.&nbsp;The exchange through MQTT protocol happens according to publish/subscribe type, indicating with publisher a device that can publish the data on a specific broker, and subscriber a device that can “subscribe” to a broker to receive different messages from the publishers.</span>



<span style="font-size:medium;">For the purpose of the integration with WISE-PaaS/EdgeSense, sensor data that collected by Alleantia’s IOT SCADA software can publish to&nbsp;MQTT broker for WISEAgent Alleantia-Plugin to&nbsp;subscribe, after WISEAgent receive the data, it will be transfer them to WISE-PaaS/EdgeSense.</span>

= System Architecture =

<span style="font-size:large;">[[File:AlleantiaISC WISEPaaS 01.png|800x600px|AlleantiaISC WISEPaaS 01.png]]</span>

= How to =

== Alleantia IoT SCADA software Installation & Configuration ==

=== Installation and Configuration ===

<span style="font-size:medium;">Please refer to the user manual: [http://ess-wiki.advantech.com.tw/wiki/images/4/45/Alleantia_ISC_User_Manual_ENG.pdf Alleantia_ISC_User_Manual_ENG.pdf]</span>



=== MQTT Service Configuration ===

1. Click MQTT Service from Alleantia IoT SCADA main screen.

[[File:Alleantia-02-0.png|border|900x560px|Alleantia-02-0.png]]

2. Select Nuovo Broker at MQTT service screen.

3. Check "Enable MQTT service" to activate&nbsp;MQTT function.

4. Select the format "Normal Telemetry" for the message to send to MQTT broker.

[[File:Alleantia-02-4.png|border|900x720px|Alleantia-02-4.png]]

5. Click "Select variables" to select what sensors data you like to publish to MQTT broker.

6. Click "Select custom alarms"&nbsp;to select what alarms&nbsp;you like to publish to MQTT broker.

7.Click "Select events to select what events you like to publish to MQTT broker.

8. Click "Save" to apply your configuration.

'''NOTE:''' After&nbsp;you changed the settings of Alleantia SCADA, include&nbsp;add,&nbsp;delete or modify sensor configurations, you need to restart Alleantia plugin.

== WISE Agent Installation & Configuration ==

=== Installation ===

1. Open and login WISE-PaaS/EdgeSense Portal by using your user id and password.

2.&nbsp;&nbsp;Select "Settings" - "System" from function list to open "System Management" page.

3.&nbsp; Select "Agent Credential" from top-right pull-down menu.

4. Click "Download" to get WISE&nbsp;Agent&nbsp;and install it to your gateway.

5. Copy&nbsp;the string of "Credential URL" and "IoTKey" from&nbsp;Agent Credential page&nbsp;and paste them to WISE&nbsp;Agent Setup&nbsp;dialog when asking.

=== Configuration ===

1.&nbsp;Double click the icon "ServerSetting" on desktop and set password for your WISE Agent.

2. Set "Device Name" for your gateway, it will show your host name by default.

3. The fields&nbsp;"Credential URL" and "IoTKey" are as the same value&nbsp;that you assigned when installing.

4. Select "Enable SSL" if your network support SSL.

5. Select "Assign to Account" if this gateway is assigned to your account.

6. Click "Save" to apply your change or "Cancel" to exit the configuration.

7. Open WISE-PaaS/EdgeSense Portal and click&nbsp; "Device" from function list.

8. Click "add device" to involve your gateway.

== Alleantia-Plugin Installation & Configuration ==

=== Installation ===

1. Download [https://www.dropbox.com/s/wyt3gnenyf7xv3d/MQTTBrokerSetup_1.0.3.exe?dl=0 MQTTBrokerSetup]&nbsp;and install it to your&nbsp;gateway.

2. Download [https://www.dropbox.com/s/xfvielko3jx5w8r/Agent_AlleantiaHandler_1.0.2.exe?dl=0 Agent_AlleantiaHandler]&nbsp;and install it to your&nbsp;gateway.

=== Configuration ===

1. Open the file AlleantiaHandler.ini from Agent_AlleantiaHandler installation folder.

2. Edit&nbsp;[Platform] session's parameters and save the modification:

&nbsp; &nbsp; SerialNumber= [Serial number of Alleantia IoT SCADA software]<br/>&nbsp; &nbsp; PrefixDevId= [Prefix string for devId]<br/>&nbsp; &nbsp; PrefixVarId= [Prefix string for varId]

3. Edit&nbsp; [MQTT_Broker] session's parameters and save the modification:

&nbsp; &nbsp; IP= [IP address of MQTT broker]<br/>&nbsp; &nbsp; Port= [Port of MQTT broker]

Example:&nbsp;

C:\Program Files (x86)\Advantech\Agent_AlleantiaHandler\AlleantiaHandler.ini.
<pre>[Platform]
SerialNumber=acbdef123-1234-5678-9012-998877665500
PrefixDevId=devId_
PrefixVarId=varId_
Interval=1

[MQTT_Broker]
IP=127.0.0.1
Port=1883</pre>



4. Open&nbsp;Windows Task Manager and switch to [Service] tab, restart Agent_AlleantiaHandler service.

&nbsp; &nbsp; &nbsp;<span style="color:#FF0000;">NOTE: Before restart&nbsp;Agent_AlleantiaHandler service, you need make sure Alleantia SCADA is initialized and running.</span>

5. Login WISE-PaaD/EdgeSense Portal, switch to "Device" page, click on the "Grafana" button to open Grafana dashboard for alleantia plugin.

[[File:Alleantia-grafana-01.png|800x480px|Alleantia-grafana-01.png]]

= JSON Data Format =
<pre>{
  "AlleantiaHandler": {
    "Plugin": {
      "bn": "Plugin",
      "e": [
        {
          "n": "Version",
          "sv": "1.0.1",
          "asm": "r"
        },
        {
          "n": "Description",
          "sv": "This service is Alleantia SCADA Service",
          "asm": "r"
        }
      ]
    },
    "info": {
      "bn": "info",
      "e": [
        {
          "n": "devSn",
          "sv": "4b322d2b8-19f2-32dd-9de5-991136f983bd",
          "asm": "r"
        }
      ]
    },
    "devId_1": {
      "bn": "devId_1",
      "e": [
        {
          "n": "varId_5",
          "v": 0,
          "asm": "r"
        },
        {
          "n": "varId_16",
          "bv": false,
          "asm": "rw"
        }
      ],
      "opTS": {
        "$date": 0
      }
    },
    "devId_2": {
      "bn": "devId_2",
      "e": [
        {
          "n": "varId_1",
          "bv": false,
          "asm": "r"
        },
        {
          "n": "varId_6",
          "bv": false,
          "asm": "r"
        }
      ],
      "opTS": {
        "$date": 0
      }
    }
  }
}

</pre>


= Release =

{| border="1" cellspacing="1" cellpadding="1" style="width: 788px;"
|-
| style="text-align: center; width: 44px;" | <span style="font-size:medium;">Index</span>
| style="text-align: center; width: 91px;" | <span style="font-size:medium;">Version</span><br/>
| style="text-align: center; width: 90px;" | <span style="font-size:medium;">Date</span><br/>
| style="text-align: center; width: 79px;" | <span style="font-size:medium;">Platform</span><br/>
| style="text-align: center; width: 81px;" | <span style="font-size:medium;">OS</span><br/>
| style="text-align: center; width: 205px;" | <span style="font-size:medium;">Release Note</span><br/>
| style="text-align: center; width: 164px;" | <span style="font-size:medium;">Download Link</span>
|-
| style="text-align: center; width: 44px;" | <font size="3">1</font>
| style="text-align: center; width: 91px;" | <span style="font-size:medium;">1.0.2</span>
| style="text-align: center; width: 90px;" | <span style="font-size:medium;">2019/04/18</span>
| style="text-align: center; width: 79px;" | <span style="font-size:medium;">x86_64 CPU</span><br/>
| style="text-align: center; width: 81px;" | <span style="font-size:medium;">Windows</span><br/>
| style="width: 205px; text-align: center;" | <span style="font-size:medium;">&nbsp;[[Media:Agent_AlleantiaHandler_ReleaseNote_1.0.2.txt|Release Note v1.0.2]]</span><br/>
| style="width: 164px; text-align: center;" | <span style="font-size:medium;">&nbsp;[file://eossfs/ESS-Release/EdgeSense/Release/Windows/AlleantiaHandler/1.0.2/ AlleantiaHandler_1.0.2.exe]</span>
|-
| style="text-align: center; width: 44px;" | <font size="3">2</font>
| style="text-align: center; width: 91px;" | <span style="font-size:medium;">1.0.3</span>
| style="text-align: center; width: 90px;" | <span style="font-size:medium;">2020/11/09</span>
| style="text-align: center; width: 79px;" | <span style="font-size:medium;">x86_64 CPU</span><br/>
| style="text-align: center; width: 81px;" | <span style="font-size:medium;">Windows</span><br/>
| style="width: 205px; text-align: center;" | <span style="font-size:medium;">&nbsp;[[Media:Agent_AlleantiaHandler_ReleaseNote_1.0.3.txt|Release Note v1.0.3]]</span><br/>
| style="width: 164px; text-align: center;" | <span style="font-size:medium;">&nbsp;[file://eossfs/ESS-Release/EdgeSense/Release/Windows/AlleantiaHandler/1.0.3/ device-alleantia-1.0.3.exe]</span>
|}

<span style="font-size:larger;"><span style="color:#FF0000;">Note: Above files are available at local server, please paste file's&nbsp;url in File Explorer&nbsp;to copy file</span>. &nbsp;([[EdgeSense_FAQ|How to access to EOSSFS file server]]&nbsp;)</span>