Difference between revisions of "WISE-Agent"

Revision as of 08:07, 3 June 2016

Introduction

WISE Agnet – a software development framework to communicate between device and RMM Server.
Advantech provides a software development framework to communicate and exchange information between a device and RMM Server, called a WISE Agent framework.
The WISE Agent framework provides a rich set of user-friendly, intelligent and integrated interfaces, which speeds development, enhances security and makes agent application easier and simpler to communicate with RMM Server.
The framework has three benefits:

• Standardization - The communication protocol is based on the MQTT protocol to communicate and exchange data with WISE-PaaS/RMM Server. The IoT sensor data report format is following the IPSO Spec. in JSON format.
  
• Portability - Whole framework is written in C language and follow the ANSI C Standard, that C compilers are available for most systems and are often the first compiler provided for a new system.
  
• Scalability - The WISE Agent Framework is functional partitioning into discrete scalable, reusable modules, and plug & playable.
  

Architecture

TBD

Handlers

In RMM Agent we provide several handlers and can be classified in three different categories:

• Monitoring Handlers - sensor data monitoring and control.
  

Such as: Hard-disk Monitor, SUSI Control, Network Monitor, Process Monitor, IoT Gateway and Modbus.

• Control Handlers - remote control target device.
  

Such as: Power On/Off, Remote KVM, Screenshot, Terminal, Protection and Recovery.

• Agent Improvement Handlers - to increase the agent reliability or functionality.
  

Such as: Server Redundancy.

WISE-Agent Sample Handler

• Modbus Handler - version 2.0 only support Modbus-TCP, Modbus-RTU supported since version 3.0.

Modbus handler is one of handlers in WISE Agent framework and is used to collect devices’ data based on Modbus TCP protocol.
The library used in Modbus handler is libmodbus, which is a 3rd party free library to send/receive data according to the Modbus protocol.
This library is written in C and supports RTU (serial) and TCP (Ethernet) communication. The license of libmodbus is LGPL v2.1v.

The flow of WISE Agent communicating with a device based on Modbus by Modbus handler is described as follows.
The WISE Agent uses the Modbus handler as the interface to handle all the communication with the device based on Modbus protocol.

• Steps of Modbus Handler:
  • Step1 Modbus handler reads in INI file and is ready to set up connection with device according to the configuration in the INI file.
  • Step2 Modbus handler establishes a Modbus connection
  • Step3 WISE Agent communicates with the device.
  • Step4 If you no more need the communication, WISE Agent can disconnect with the device.

WISE-Agent Verification Tool

• Agent Tester

Document

• RMM 3.1 WISE-Agent Developer Guide
• RMM 3.1 WISE-Agent Modbus Handler Developer Guide
• RMM 3.1 WISE-Agent Command Format Developer Guide