云監(jiān)控卡動(dòng)環(huán)及SNMP資料 云卡API接口說明
CLOUD云智能管理卡動(dòng)環(huán)API接口
智能管理卡，對于動(dòng)環(huán)系統(tǒng)，除提供Modbus接口(見"CLOUD云-MODBUS協(xié)議.pdf"）以外，還提供Http,TCP/IP兩種純IP方式的通訊API接口。
1，Http模式設(shè)置：
不需任何設(shè)置，CLOUD云智能管理卡即提供Http模式的通訊功能。CLOUD云管理卡與動(dòng)環(huán)系統(tǒng)可互為服務(wù)端和客戶端，相互使用POST方式傳送數(shù)據(jù)。
2，TCP/IP模式設(shè)置：
CLOUD云管理卡為服務(wù)端。
打開瀏覽器（如IE等），在地址欄輸入管理卡的IP地址。（如何設(shè)置和獲取管理卡的IP地址，請參考文檔“CLOUD云-設(shè)置IP地址“）。
2，選擇：集成設(shè)置：
設(shè)置TCP端口為2390即可。
3，TCP/IP要保持常連模式。
以上兩種API接口(Http,TCP/IP)模式，均不影響智能管理卡遠(yuǎn)程控制管理功能。
3,通訊協(xié)議：
a, 發(fā)送指令和數(shù)據(jù)：
向CLOUD云智能管理卡按標(biāo)準(zhǔn)JSON格式發(fā)送指令和數(shù)據(jù)。
如：
{
"session":"1234",
"pass":"123456",
"new_pass":"AYI9 123456",
"host":"http://192.168.0.100:9000/post",
"cmd":"QAD",
}
其中：
(1) sessoin：為指令序號(hào)，以此辨別返回結(jié)果是否屬于本次指令；
(2) pass ：為管理卡密碼，初始密碼為空。如果密碼為空，該字段可以不需要；
(3)new_pass ：為管理卡設(shè)置新的密碼。如果字段內(nèi)容為 clear,表示要清空密碼，否則，字段內(nèi)容不能為空。
(3) host ： 返回結(jié)果的目標(biāo)地址；如果使用TCP/IP方式，該字段可以不要；
(4) cmd ：發(fā)送要CLOUD云管理卡的指令(大寫）。
包括但不限于以下指令：RTD，QAD，SON，SOFF，BZON，BZOFF，T
b，返回?cái)?shù)據(jù)格式：
返回?cái)?shù)據(jù)格式同樣也為標(biāo)準(zhǔn)JSON格式：
(1)結(jié)果錯(cuò)誤或者無法執(zhí)行的指令，返回格式為：
{
"result":"xxx",
原指令，不包括{}號(hào)
}
或者
{
"result":"xxx",
"uid":"201701013805",
"session":"1234",
"cmd":"QAD",
}
其中xxx為錯(cuò)誤代碼：
101 -- JSON_FORMAT ，JSON格式錯(cuò)誤；
102 -- SESSION_LOSS，沒有session 字段；
103 -- PASSWORD_ERROR ,密碼錯(cuò)誤；
104 -- HOST_NO ，沒有host 字段；
105 -- COMMAND_NO ， 沒有指令字段；
106 -- PASSTOOLENGTH，密碼太長，超過15位了。
201 -- BUSY ,系統(tǒng)繁忙。
(2) 結(jié)果正確的返回格式：
{
"uid":"201701013805",
"session":"1234",
"cmd":"QAD",
"value":"xxxxxxxxxxxxxxxxxxxxxxxxx",
}
value返回結(jié)果：所有返回值均以 ( 開頭 。
(1) RTD指令，查詢UPS（電源）設(shè)備的額定信息， 返回格式：
（工廠名稱 硬件版本 機(jī)型 額定輸入電壓 額定輸出電壓 額定電流 輸出頻率 額定電池電壓 輸入輸出相數(shù) 額定功率,
如：
(Sunshine V1.0 C10KS 220 220 20 50.0 192 1/1 10000
返回格式以 ( 開頭， 各字段間用一個(gè)空格分隔。電壓單位為V，電流單位為 A，頻率單位為Hz ,功率單位為VA. 如果該字段沒有值，用---代替。共10個(gè)字段。
(2) QAD指令， 查詢UPS（電源）設(shè)備的實(shí)時(shí)數(shù)據(jù)，返回格式：
（輸入電壓(R,S,T) 輸入頻率 輸入電流（R,S,T) 故障電壓 輸出電壓(R,S,T) 輸出頻率 輸出電流(R,S,T) 負(fù)載百分比(R,S,T) 電池電壓 電池剩余時(shí)間 電池容量百分比 機(jī)內(nèi)溫度 工作狀態(tài)
如：
(220.1 220.2 220.3 50.1 ---.- ---.- ---.- 149.5 221 222 223 50 5 6 7 20 30 25 216.5 31687 90 37.5 0000100000000011
返回格式以 ( 開頭， 各字段間用一個(gè)空格分隔。電壓單位為V，電流單位為 A，頻率單位為Hz ,功率單位為VA. 如果該字段沒有值，用---代替。共23個(gè)字段。
工作狀態(tài)b15(在前)~b0(在后)分別為：
b15: UPS類型: 0=ONLINE,1=BAKCUP ；
b14~b12: 保留未用；
b10~b11: 電池自檢放電結(jié)果: 00==未知, 1==失敗,2==成功；
b9: 保留未用；
b8: 0==不過載, 1==過載 ；
b7: 市電正常==0 ,不正常 == 1 ；
b6: 電池電壓: 0=不低,1=低 ；
b5: 0== 運(yùn)行狀態(tài), 1==正在關(guān)機(jī)或關(guān)機(jī)狀態(tài) ；
b4: 0==打開狀態(tài),1==蜂鳴器靜音狀態(tài) ；
b0~b3: UPS狀態(tài):
0=POWE ON 上電狀態(tài)
1=STANDBY 待機(jī)狀態(tài)
2=BYPASS 旁路狀態(tài)
3=LINE 市電工作狀態(tài)
4=BAT 電池供電狀態(tài)
5=TEST 測試自檢放電狀態(tài)
6=FAULT 故障狀態(tài)
7=CONVERTER
8=HE 經(jīng)濟(jì)狀態(tài)，基本等同于BYPASS
9=SHUTDOWN 關(guān)機(jī)狀態(tài)
(3)SON(),SOFF(),BZON(),BZOFF(),T() 指令，控制UPS狀態(tài)，返回結(jié)果：
a,執(zhí)行成功返回：(OK
b,不能執(zhí)行或執(zhí)行失敗返回： (FAILED
(4) 其他對設(shè)備的查詢，根據(jù)設(shè)備內(nèi)的協(xié)議返回結(jié)果；
控制指令執(zhí)行成功，返回: (OK, 失敗返回：(FAILED .
