ONENET設(shè)備終端接入?yún)f(xié)議3-MODBUS

MODBUS-TCP歡訪問設(shè)備云門戶網(wǎng)站注用戶，獲取最新文。版本號修訂日V1.02014.10.30

新

修訂內(nèi)

說V1.2備錄傳項IDV1.32016/02/18V1.42016/07/061說

增加入流例實現(xiàn)01，，功碼周查通過URL獲務(wù)和設(shè)定時發(fā)送心包通restfullapi主動下在命基于《議.》現(xiàn)01，，，功期詢。適于設(shè)備云定期主動發(fā)modbus-tcp命令到設(shè)備查詢寄器值，備復(fù)寄存器值的情況。2名項目ID：在臺賬，新平成字；Api-key：理項資用restful鑒權(quán)。3接

訪設(shè)備云門戶注冊用戶，可以查看（項和master_key(api-key)業(yè)務(wù)平臺調(diào)用API增設(shè)，指定下設(shè)屬性備屬名intervalauth_info

明設(shè)備云主動查詢設(shè)備的時間間隔，單位設(shè)備鑒信息，格式如：{“登文phone段”登錄報文SVRPWD字段}3

設(shè)備上電，送登錄報文（字）備云入務(wù)器進行權(quán)設(shè)備通鏈接/s?t=6&v=1拉服務(wù)器IPPORT其中式如：登錄報固定格式如下中綠項填）報文段度明type11字節(jié)前作為保留用。namephoneid

9字節(jié)，前為保留用途。字節(jié)設(shè)時作為屬性域?qū)ο蟮?，用于鑒權(quán)。9字節(jié)注冊備時作為屬性域?qū)ο蟮模糜阼b權(quán)。字節(jié)分的目字符串。4

設(shè)備錄成后服務(wù)器不會回數(shù)，果登錄失敗服務(wù)會動斷開連接。4流

業(yè)務(wù)平調(diào)用api為備新增數(shù)據(jù)流，數(shù)據(jù)需要指定如下屬：數(shù)據(jù)流性名明cmdformula

設(shè)備云為獲取數(shù)據(jù)定期下訪問寄存器的命令，用十六進制標示如“83A245”表個節(jié)命令?？蛇x置。對命令返回個存器值的處理公，個公式用號間隔例如表示令回前兩個寄存器值的再乘上三寄存器值到綜合果。注意：式不能成，去外層的效括，否則公式會被認為不合法，不會生01、命令返結(jié)（不持formula屬性）{“起地”線圈2,…,線值n”}其中每線值應(yīng)備回數(shù)的個byte起始地址、線值都以進表示03命令返回結(jié)（支屬）4.3.1未置屬性{“址:”寄器值”地址:”寄存器值…址”:值其，地址、寄存器值都以制表示4.3.2已置屬性{“1””formula計算果”,“2”:果”,…“n”:結(jié)果其中，算結(jié)果為值屬性可以有多個計算公式組一通”;。1、、…、，分別表示第、、n個計算公式、、…An,分示第、、…、個寄存器值例：–+A9fA10目前支如：+-/%()f

表示后操數(shù)作為，然后合并組成例如A0fA1union{uint32_tfloat}u_f;u_f.u32=(((uint32_t)(uint16_t)A0)<<16)|(uint16_t)A1;即為運算符運算結(jié)果04命返回果不支持）“地址存值,地址”器值,?地址”寄存值}其中，址、寄存器值以進制示

注意事數(shù)據(jù)中時發(fā)命盡保持同5備線當設(shè)備處于空的時候，為了保與ONENET平臺的連接斷開，需要定期發(fā)送心跳包（推薦0x0000確網(wǎng)絡(luò)接不開。中時間隔小5，推1～3分鐘。6過restfull發(fā)備區(qū)于據(jù)的定時下命到備resfullapi通用HTTP請求的方式動發(fā)令到設(shè)。其通過api主動下發(fā)的命令，盡量與數(shù)據(jù)流中定時發(fā)的命令保持不同。HTTP方法

/cmdsHTTP頭部，須URL參數(shù)的設(shè)備，填。HTTP內(nèi)成功回

{”xxxxxxxx”MODBUS設(shè)的命令（進字符串}{0,"error":succ，"data":{//不4“2302-312-FWs”}}查看令發(fā)狀HTTP方法

HTTP頭部，須成功回

{0,"error":succ，"data":{//0

不在notonline已創(chuàng)Created命令往設(shè)CommandSendFailedCommandReceivedCommandResponseTimeoutCommandResponseLargesending”}}獲取端執(zhí)命后的響應(yīng)內(nèi)。HTTP方法

>/respHTTP頭部，須HTTPbody備應(yīng)據(jù)二制響的狀態(tài)碼對應(yīng)錯誤信息如下400Noapi-key403AuthFailed404Not400InvalidParameterCommandCommandSent520SendCommandFailed200CommandResponseCommandResponseTimeoutResponseTooLarge7接入例子命令03取持寄存器（以下截圖來自MODBUS協(xié).pdf》）1.利用api創(chuàng)備POST/devicesHTTP/1.1須為Host:Content-Length:155{

注意度和行使用調(diào)，會自動填充長度填寫設(shè)號"desc":"test"protocol":"HTTP",/*填寫沒有專門的協(xié)議"auth_info":{"12345670":"12345670"},/*這里是鑒權(quán)信息的卡號和密碼，長度限制參考登錄報文格式"interval":20/*命的查間}此沒針對相關(guān)配置出錯處理返，必須細填寫各個字段。2.該備建據(jù)使用api創(chuàng)建請求數(shù)據(jù)如下：POSTHTTP/1.1備的或masterkey*/Host:Content-Length:66{"id":"test_cmd","cmd":"1103006B00038776",

注意度和行使用調(diào)，會自動填充長度"interval":20}CMD字釋："1103006B00038776"對的RTU命令下圖所：{0x11,0x03,0x0,0x6B,0x0,0x3,0x87,0x76}中和存是結(jié)果，從0x11開始計算到最后一個寄存器地址此處為。3.上傳登報如前登錄文式，例子如：unsignedreq[52];type[11]=unsignedname[9]=unsignedphone[12]填創(chuàng)設(shè)備的卡號unsignedpwd[9]填寫創(chuàng)設(shè)備的密碼charp_id[11]"47434";//modbus設(shè)所在項目的memset(req,0,52);memcpy(req,type,11);+11,name,+11+9,phone,+11+9+12,pwd,9);+11+9++9,p_id,11);向錄服務(wù)器上傳整個即，登錄成功返回，否則服務(wù)斷開連接。數(shù)如下：0x790x700x650x00x00x00x00x6e0x610x6d0x650x00x00x00x00x320x340x350x370x300x00x00x00x310x320x330x340x360x370x00x330x00x00x00x00x00x0四個色標的據(jù)依次對應(yīng)錄報的字段4.與務(wù)器端建后，并成，設(shè)備云送查詢備一分鐘無回復(fù)，務(wù)器會斷開連。設(shè)備收到命令數(shù)如：0x110x00x3和增加數(shù)據(jù)流時配置的數(shù)據(jù)一模一樣，如。5.設(shè)備端復(fù)查詢命令的結(jié)按如下截圖RTU格復(fù)進制數(shù)據(jù)360x22b0x0x00x64，采用CRC16校，不需要轉(zhuǎn)字符串。6.查看上結(jié)1.在臺的顯示，進入對應(yīng)項目和設(shè)備的頁面查看情況如：2.利api查結(jié)這用具查備點令核對數(shù)據(jù)是是我們上傳。傳數(shù)：0x30x60x00xc8，0x22b=555,0x00=0,0x64=100，傳正。附測用api：POST/devicesHTTP/1.1User-Agent:FiddleryoursHost:155{"title":"12345670","desc":"test"protocol":"HTTP","auth_info":{"12345670":"12345670"},"interval":20}/devi