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

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

新

修訂內(nèi)

說V1.2備錄傳項(xiàng)IDV1.32016/02/18V1.42016/07/061說

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

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

明設(shè)備云主動(dòng)查詢?cè)O(shè)備的時(shí)間間隔，單位設(shè)備鑒信息，格式如：{“登文phone段”登錄報(bào)文SVRPWD字段}3

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

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

設(shè)備錄成后服務(wù)器不會(huì)回?cái)?shù)，果登錄失敗服務(wù)會(huì)動(dòng)斷開連接。4流

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

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

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

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

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

{”xxxxxxxx”MODBUS設(shè)的命令（進(jìn)字符串}{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)碼對(duì)應(yīng)錯(cuò)誤信息如下400Noapi-key403AuthFailed404Not400InvalidParameterCommandCommandSent520SendCommandFailed200CommandResponseCommandResponseTimeoutResponseTooLarge7接入例子命令03取持寄存器（以下截圖來自MODBUS協(xié).pdf》）1.利用api創(chuàng)備POST/devicesHTTP/1.1須為Host:Content-Length:155{

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

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