Difference between revisions of "EIS Service Protocol"
Eric.liang (talk | contribs) |
Eric.liang (talk | contribs) |
||
| Line 129: | Line 129: | ||
*Direction: Agent -> Server | *Direction: Agent -> Server | ||
*Topic: /cagent/admin/<devID>/eventnotify | *Topic: /cagent/admin/<devID>/eventnotify | ||
| − | *QoS: | + | *QoS: 0 |
| − | *Retained: | + | *Retained: 0 |
*Payload: | *Payload: | ||
| − | < | + | |
| − | + | { <br/> "susiCommData":{ <br/> "commCmd":2059,<br/> "requestID":2001,<br/> "agentID":"0027000E40000001",<br/> "handlerName":"general",<br/> "sendTS":1453356274,<br/> "eventnotify":{ <br/> "subtype":"predictError", #predictError/predictInfo<br/> "msg":"HDD smart 5 over the threshold",<br/> "severity":2,<br/> "handler":"MsgGen",<br/> "extMsg":{<br/> "predictMsg":{<br/> "health":"Sick",<br/> "suggestion1":"Please back up your HDD data. The HDD has the probability to break down in 30 days.",<br/> "deviceName":"ST9250315AS"<br/> },<br/> "alertMsg":{<br/> "warning":"Yes",<br/> "suggestion1":"Please lower the environment temperature under 40C.",<br/> "suggestion2":"Please make sure the cooling system is working properly.",<br/> "deviceName":"ST9250315AS"<br/> }<br/> }<br/> }<br/> }<br/>} | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | }</ | ||
Revision as of 06:14, 9 March 2017
Contents
Overview
- Introduction for "WISE-Snail communication protocol for EIS Service". WISEAgent communication protocol is base on standard MQTT protocol. We also define Advantech IoT Topic and message in JSON format. Follow standard to design our [Sensor Format in JSON ]
Protocol
Connect
- Description: Agent Client sends the "Connect Info" to RMM Server for on-line notification.
- Type: Info
- Direction: Agent -> Server
- Topic: /cagent/admin/<devID>/agentinfoack
- QoS: 2
- Retained: 0
- Payload:
"susiCommData": {
"devID":"0027000E40000001", // User Define, NULL-> Auto <span style="color:#FF0000;">UUID-like</span>
"hostname":"<ServiceName>", // The same with Handler Name
"sn":"0027000E40000001",
"mac":"0027000E40000001",
"version":"3.1.23",
"type":"Service", // Fixed: Service
"product":"<ServiceName>",
"manufacture":"",
"status":"1",
"commCmd":1,
"requestID":30002,
"agentID":"0027000E40000001",
"handlerName":"general",
"sendTS":160081026
}
}
OS Info
- Description: Agent Client sends the OS Info" to RMM Server for device OS information.
- Type: Info
- Direction: Agent -> Server
- Topic: /cagent/admin/<devID>/agentactionreq
- QoS: 0
- Retained: 0
- Payload:
{
"susiCommData":{
"osInfo":
{
"cagentVersion":"3.1.23",
"cagentType":"<ServiceName>", // The same with Handler Name
"osVersion":"SnailOS",
"biosVersion":"",
"platformName":"",
"processorName":"SnailGW",
"osArch":"SnailX86",
"totalPhysMemKB":123,
"macs":"000E40ABCDEF",
"IP":"192.168.0.100"
},
"commCmd":116,
"requestID":109,
"agentID":"0027000E40000001",
"handlerName":"general",
"sendTS":1466730390
}
}
Disconnect
- Description: Agent Client sends the "Disconnect Info" to Server for off-line notification.
- Type: Info
- Direction: Agent -> Server
- Topic: /cagent/admin/<devID>/agentinfoack
- QoS: 2
- Retained: 0
- Payload:
{
"susiCommData": {
"devID":"0027000E40000001",
"hostname":"<ServiceName>",
"sn":"0027000E40000001",
"mac":"0027000E40000001",
"version":"3.1.23",
"type":"Service",
"product":"<ServiceName>",
"manufacture":"",
"status":"0",
"commCmd":1,
"requestID":30002,
"agentID":"0027000E40000001",
"handlerName":"general",
"sendTS":160081026
}
}
Info or Update Service's Capability
- Description: Agent will send it's capability to Server for description all resource.
- Type: Auto update
- Direction: Agent-> Server
- Topic: /cagent/admin/<devID>/agentactionreq
- QoS: 0
- Retained: 0
- Payload:
Example: Service's Capability
{
"susiCommData":{
"infoSpec": {
"<ServiceName>": {
"Info": {"e":[ {"n":"Temperature","u":"Cel","v":0.000000,"min":-100.000000,"max":200.000000,"asm":"r","type":"d","rt":"ucum.Cel","st":"ipso","exten":""},
{"n":"Humidity","u":"%","v":0.000000,"min":0.000000,"max":100.000000,"asm":"r","type":"d","rt":"ucum.%","st":"ipso","exten":""},
{"n":"SmartML", "sv":"<xml>", "asm":"rw", "format":"xml", "encoding":"base64"},
{"n":"SmartData", "sv":"<json>", "asm":"r", "format":"json", "encoding":"base64"}
],
"bn":"Info"
},
"bn":"<ServiceName>"
}
},
"commCmd":2052,
"requestID":2001,
"agentID":"0027000E40000001",
"handlerName":"general",
"sendTS":160081024
}
}
Auto Update Sensor Data Value
- Description: Agent will update latest value to server.
- Type: Auto update
- Direction: Agent-> Server
- Topic: /cagent/admin/<devID>/deviceinfo
- QoS: 0
- Retained: 0
- Payload:
{
"susiCommData":{
"data":{
"<ServiceName>":{
"Info":{
"e":[
{"n":"SmartData", "sv":"<json>"}
]
"bn":"Info"
},
"ver":1
"bn":"<ServiceName>"
}
},
"commCmd":2055,
"requestID":2001,
"agentID":"0027000E40000001",
"handlerName":"general",
"sendTS":160081031
}
}
Get Sensor Data
- Description: Server can send mqtt message to get sensor data value.
- Type: Request
- Direction: Server -> Agent
- Topic: /cagent/admin/<devID>/agentcallbackreq
- QoS: 0
- Retained: 0
- Payload:
{
"susiCommData":{
"sessionID":"2746E3B65BAB115338B9668CDC5C35C4",
"sensorIDList":{
"e":[
{
"n":"ServiceName/Info/SmartML"
}
]
},
"commCmd":523,
"requestID":0,
"agentID":"",
"handlerName":"<ServiceName>",
"sendTS":1466057267
}
}
- Description: Agent will reply its data value.
- Type: Reply
- Direction: Agent -> Server
- Topic: /cagent/admin/<devID>/agentactionreq
- QoS: 0
- Retained: 0
- Payload:
{
"susiCommData":{
"commCmd":524,
"handlerName":"<ServiceName>",
"sessionID":"2746E3B65BAB115338B9668CDC5C35C4",
"sensorInfoList":{
"e":[
{
"n":"<ServiceName>/Info/SmartML",
"sv":"<xml>",
"StatusCode":200
}
]
}
}
}
Set Sensor Data
- Description: Server can send mqtt message to set sensor data value.
- Type: Request
- Direction: Server -> Agent
- Topic: /cagent/admin/<devID>/agentcallbackreq
- QoS: 0
- Retained: 0
- Payload:
{
"susiCommData":{
"sessionID":"4DDF0B6DE2773176095F55E8C930507A",
"commCmd":525,
"requestID":0,
"agentID":"",
"handlerName":"<ServiceName>",
"sendTS":1466088605
"sensorIDList":{
"e":[
{
"sv":"<xml>",
"n":"<ServiceName>/Info/SmartML"
}
]
}
}
}
- Description: Agent will reply accept this command
- Type: Reply
- Direction: Agent -> Server
- Topic: /cagent/admin/<devID>/agentactionreq
- QoS: 0
- Retained: 0
- Payload:
{
"susiCommData":{
"commCmd":526,
"handlerName":"<ServiceName>",
"sessionID":"4DDF0B6DE2773176095F55E8C930507A",
"sensorInfoList":{
"e":[
{
"n":"<ServiceName>/Info/SmartML",
"StatusCode":202
}
]
}
}
}
- Description: Agent will reply its result.
- Type: Reply
- Direction: Agent -> Server
- Topic: /cagent/admin/<devID>/agentactionreq
- QoS: 0
- Retained: 0
- Payload:
{
"susiCommData":{
"commCmd":526,
"handlerName":"<ServiceName>",
"sessionID":"4DDF0B6DE2773176095F55E8C930507A",
"sensorInfoList":{
"e":[
{
"n":"<ServiceName>/Info/SmartML",
"sv":"<xml>",
"StatusCode":200
}
]
}
}
}
EventNotify
- Description:
- Type: Auto update
- Direction: Agent -> Server
- Topic: /cagent/admin/<devID>/eventnotify
- QoS: 0
- Retained: 0
- Payload:
{
"susiCommData":{
"commCmd":2059,
"requestID":2001,
"agentID":"0027000E40000001",
"handlerName":"general",
"sendTS":1453356274,
"eventnotify":{
"subtype":"predictError", #predictError/predictInfo
"msg":"HDD smart 5 over the threshold",
"severity":2,
"handler":"MsgGen",
"extMsg":{
"predictMsg":{
"health":"Sick",
"suggestion1":"Please back up your HDD data. The HDD has the probability to break down in 30 days.",
"deviceName":"ST9250315AS"
},
"alertMsg":{
"warning":"Yes",
"suggestion1":"Please lower the environment temperature under 40C.",
"suggestion2":"Please make sure the cooling system is working properly.",
"deviceName":"ST9250315AS"
}
}
}
}
}
severity:
Severity_Emergency = 0,
Severity_Alert = 1,
Severity_Critical = 2,
Severity_Error = 3,
Severity_Warning = 4,
Severity_Informational = 5,
Severity_Debug = 6,
subtype:
THRESHOLD_CHECK_INFO
THRESHOLD_CHECK_ERROR