ONENET设备终端接入协议3-MODBUS

MODBUS-TCP欢访问设备云门户网站注用户，获取最新文。版本号修订日V1.02014.10.30

新

修订内

说V1.2备录传项IDV1.32016/02/18V1.42016/07/061说

增加入流例实现01，，功码周查通过URL获务和设定时发送心包通restfullapi主动下在命基于《议.》现01，，，功期询。适于设备云定期主动发modbus-tcp命令到设备查询寄器值，备复寄存器值的情况。2名项目ID：在台账，新平成字；Api-key：理项资用restful鉴权。3接

访设备云门户注册用户，可以查看（项和master_key(api-key)业务平台调用API增设，指定下设属性备属名intervalauth_info

明设备云主动查询设备的时间间隔，单位设备鉴信息，格式如：{“登文phone段”登录报文SVRPWD字段}3

设备上电，送登录报文（字）备云入务器进行权设备通链接/s?t=6&v=1拉服务器IPPORT其中式如：登录报固定格式如下中绿项填）报文段度明type11字节前作为保留用。namephoneid

9字节，前为保留用途。字节设时作为属性域对象的，用于鉴权。9字节注册备时作为属性域对象的，用于鉴权。字节分的目字符串。4

设备录成后服务器不会回数，果登录失败服务会动断开连接。4流

业务平调用api为备新增数据流，数据需要指定如下属：数据流性名明cmdformula

设备云为获取数据定期下访问寄存器的命令，用十六进制标示如“83A245”表个节命令。可选置。对命令返回个存器值的处理公，个公式用号间隔例如表示令回前两个寄存器值的再乘上三寄存器值到综合果。注意：式不能成，去外层的效括，否则公式会被认为不合法，不会生01、命令返结（不持formula属性）{“起地”线圈2,…,线值n”}其中每线值应备回数的个byte起始地址、线值都以进表示03命令返回结（支属）4.3.1未置属性{“址:”寄器值”地址:”寄存器值…址”:值其，地址、寄存器值都以制表示4.3.2已置属性{“1””formula计算果”,“2”:果”,…“n”:结果其中，算结果为值属性可以有多个计算公式组一通”;。1、、…、，分别表示第、、n个计算公式、、…An,分示第、、…、个寄存器值例：–+A9fA10目前支如：+-/%()f

表示后操数作为，然后合并组成例如A0fA1union{uint32_tfloat}u_f;u_f.u32=(((uint32_t)(uint16_t)A0)<<16)|(uint16_t)A1;即为运算符运算结果04命返回果不支持）“地址存值,地址”器值,„地址”寄存值}其中，址、寄存器值以进制示

注意事数据中时发命尽保持同5备线当设备处于空的时候，为了保与ONENET平台的连接断开，需要定期发送心跳包（推荐0x0000确网络接不开。中时间隔小5，推1～3分钟。6过restfull发备区于据的定时下命到备resfullapi通用HTTP请求的方式动发令到设。其通过api主动下发的命令，尽量与数据流中定时发的命令保持不同。HTTP方法

/cmdsHTTP头部，须URL参数的设备，填。HTTP内成功回

{”xxxxxxxx”MODBUS设的命令（进字符串}{0,"error":succ，"data":{//不4“2302-312-FWs”}}查看令发状HTTP方法

HTTP头部，须成功回

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

不在notonline已创Created命令往设CommandSendFailedCommandReceivedCommandResponseTimeoutCommandResponseLargesending”}}获取端执命后的响应内。HTTP方法

>/respHTTP头部，须HTTPbody备应据二制响的状态码对应错误信息如下400Noapi-key403AuthFailed404Not400InvalidParameterCommandCommandSent520SendCommandFailed200CommandResponseCommandResponseTimeoutResponseTooLarge7接入例子命令03取持寄存器（以下截图来自MODBUS协.pdf》）1.利用api创备POST/devicesHTTP/1.1须为Host:Content-Length:155{

注意度和行使用调，会自动填充长度填写设号"desc":"test"protocol":"HTTP",/*填写没有专门的协议"auth_info":{"12345670":"12345670"},/*这里是鉴权信息的卡号和密码，长度限制参考登录报文格式"interval":20/*命的查间}此没针对相关配置出错处理返，必须细填写各个字段。2.该备建据使用api创建请求数据如下：POSTHTTP/1.1备的或masterkey*/Host:Content-Length:66{"id":"test_cmd","cmd":"1103006B00038776",

注意度和行使用调，会自动填充长度"interval":20}CMD字释："1103006B00038776"对的RTU命令下图所：{0x11,0x03,0x0,0x6B,0x0,0x3,0x87,0x76}中和存是结果，从0x11开始计算到最后一个寄存器地址此处为。3.上传登报如前登录文式，例子如：unsignedreq[52];type[11]=unsignedname[9]=unsignedphone[12]填创设备的卡号unsignedpwd[9]填写创设备的密码charp_id[11]"47434";//modbus设所在项目的memset(req,0,52);memcpy(req,type,11);+11,name,+11+9,phone,+11+9+12,pwd,9);+11+9++9,p_id,11);向录服务器上传整个即，登录成功返回，否则服务断开连接。数如下：0x790x700x650x00x00x00x00x6e0x610x6d0x650x00x00x00x00x320x340x350x370x300x00x00x00x310x320x330x340x360x370x00x330x00x00x00x00x00x0四个色标的据依次对应录报的字段4.与务器端建后，并成，设备云送查询备一分钟无回复，务器会断开连。设备收到命令数如：0x110x00x3和增加数据流时配置的数据一模一样，如。5.设备端复查询命令的结按如下截图RTU格复进制数据360x22b0x0x00x64，采用CRC16校，不需要转字符串。6.查看上结1.在台的显示，进入对应项目和设备的页面查看情况如：2.利api查结这用具查备点令核对数据是是我们上传。传数：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