Difference between revisions of "WISE-Agent"
(Add RFID report image) |
(add GPS report image) |
||
| Line 56: | Line 56: | ||
Mode 3 means the GPS support three-dimensional information with Altitude. | Mode 3 means the GPS support three-dimensional information with Altitude. | ||
| + | |||
| + | [[File:GPS Reader.png]] | ||
The GPS Handler config file is only need to define the serial port attribute, include: Serial Port and Baud Rate. | The GPS Handler config file is only need to define the serial port attribute, include: Serial Port and Baud Rate. | ||
| Line 74: | Line 76: | ||
The report information include: Serial Port, Baud Rate, Parity Mode, Stop Bits, Byte Size, Manufacturer Name, Product Name, Serial Number and EPC Code. | The report information include: Serial Port, Baud Rate, Parity Mode, Stop Bits, Byte Size, Manufacturer Name, Product Name, Serial Number and EPC Code. | ||
| − | [[File:RFID.png]] | + | [[File:RFID.png|RTENOTITLE]] |
The RFID Handler config file is only need to define the serial port attribute, include: Serial Port and Baud Rate. | The RFID Handler config file is only need to define the serial port attribute, include: Serial Port and Baud Rate. | ||
Revision as of 11:44, 30 September 2016
Contents
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.
- GPS Handler - version 1.0 only support NMEA 0183 format with serial port.
GPS Handler is used to parse the GPS stream in NMEA 0183 format and report current postion to server continuously.
The report information include: Serial Port Name, Mode, Timestamp, Latitude, Longitude and Altitude.
Mode 2 means the GPS device only support two-dimensional information without Altitude.
Mode 3 means the GPS support three-dimensional information with Altitude.
The GPS Handler config file is only need to define the serial port attribute, include: Serial Port and Baud Rate.
The default GPSHandler.ini is read stream from com 1, and the baud rate is 9200.
| [Platform] SerialPortNum=1 Baud=9200 |
- RFID Handler - version 1.0 only support FAVITE low level command protocol.
RFID Handler is interacted with FAVITE RFID Reader with low level command protocol through serial port.
The report information include: Serial Port, Baud Rate, Parity Mode, Stop Bits, Byte Size, Manufacturer Name, Product Name, Serial Number and EPC Code.
The RFID Handler config file is only need to define the serial port attribute, include: Serial Port and Baud Rate.
The default RFIDHandler.ini define the serial port with read stream form com1, baud rate is 115200, stop bits is 1, parity mode is none and byte size is 8.
And enable the debounce with set the toggle target to disable and query command inventory session flag to 1.
| [Platform] SerialPortNum=1 Baud=115200 StopBits=1 Parity=0 ByteSize=8 # Toggle 0:disable, 1:enable. # Inventory Session 0:s0, 1:s1, 2:s2, 3:s3 # Set toggle:0 with Session:0~4 in different trigger rule to support debounce. Toggle=0 Session=1 |
WISE-Agent Verification Tool
- Agent Tester