TCP协议设备接入

准备工作

启动物联网平台

请参考教程5分钟快速运行

创建产品

访问产品管理菜单栏，点击创建产品按钮，根据页面提示填写参数，然后单击“确定”，完成产品的创建。

参数	参数值
产品名称	电表
所属品类	标准品类
选择标准品类	进入选择品类页面，输入多功能电表，点击查询，选择搜索结果
节点类型	直连设备
接入协议	TCP
数据类型	标准物模型
网络类型	以太网
工厂	根据实际情况填写
描述	请根据实际情况填写

点击进入产品详情页面，点击"为发布"按钮，发布产品。

创建设备

访问设备管理菜单栏，点击添加设备按钮，添加方式选择单个设备，根据页面提示填写参数，然后单击“确定”，完成设备的创建。

参数	参数值
设备名称	test_001
所属产品	电表
关联驱动	不填写
设备描述	请根据实际情况填写

下载官方HTTP驱动

访问驱动镜像菜单栏，点击驱动市场，下载HTTP协议驱动。

下载成功后，会在我的驱动出现一条记录。

设备与驱动绑定

访问设备管理菜单栏，勾选刚刚创建的设备，点击批量驱动绑定按钮，弹出绑定页面，关联驱动选择TCP官方驱动开头的数据，点击确定按钮进行绑定。

绑定成功后，关联驱动一栏会出现驱动具体驱动名称。

启动驱动

访问我的驱动菜单栏，点击操作->编辑按钮。

打开Docker启动参数开关，输入-p 7653:7653 点击确定。

tcp粘包问题处理。

设备使用tcp协议传输数据时，可能造成粘包问题，对此蜂鸟物联网平台提供两种解决方案。

方法1、固定长度处理粘包

每次发送固定缓冲区大小数据。客户端和服务器约定每次发送请求的大小。例如客户端发送 1024 个字节，服务器接受 1024 个字节。

打开自定义参数开关，输入如下内容，其中bytes_len的值可以由用户自定义配置，如果未设置，则默认为1024。

{
    "rule_name":"fixedLength",
    "bytes_len":1024
}

方法2、使用分隔符处理粘包

基于定界符来判断是不是一个请求（结尾’\n’). 客户端发送过来的数据，每次以 \n 结束，服务器每接受到一个 \n 就以此作为一个请求。然后对其拆分后的头部部分与前一个包的剩余部分进行合并，这样就得到了一个完整的包。

打开自定义参数开关，输入如下内容。

{
    "rule_name":"delimiter"
}

注意

如果用户未打开自定义参数开关，则默认使用分隔符处理粘包，界定符为’\n’。

消息协议说明

参数名称	大小	示例	说明
package length	4byte	75	message数据包长度
header length	4byte	40	message数据包长度
version	2byte	1	版本号，传递时固定为1
operation	2byte	1	操作类型，分为11种类型，详情请参见下方
sequenceID	36byte	d7f2ece9-cd2b-4ec3-b18a-56777cf30290	传递uuid
message	n byte	"{}"	消息内容，详情请参见下方

操作类型

鉴权（发送）

operation = 1

message格式

{
  "device_id": "99735615",//设备id
  "product_id": "54289730",//产品id
  "token": ""//设备接入token，具体计算方法参见下方。
}

属性上报（发送）

operation = 2

message格式

{
  "sys": {
    "ack": true //如果ack设置为true，服务器会会属性上报做响应
  },
  "params": {
    "Ia": { //属性标识符
      "value": 40, //属性值
      "time": 1712473482000 //毫秒时间戳，如果不带此字段，平台会取当前时间
    }
  }
}

属性上报响应（接收）

operation = 3

message格式

{
    "code": 200,
    "msg": "success"
}

事件上报（发送）

operation = 4

message格式

{
  "sys": {
    "ack": true //如果ack设置为true，服务器会会属性上报做响应
  },
  "params":{
    "eventCode":"Error",//事件标识符
    "eventTime":1712474219000,//毫秒时间戳，如果不带此字段，平台会取当前时间
    "outputParams":{
      "M_STATUS":true
    }
  }
}

事件上报响应（接收）

operation = 5

message格式

{
  "code": 200,
  "msg": "success"
}

属性设置（接收）

operation = 6

message格式

{
  "params": {
    "breaker_control": true //breaker_control为属性标识符 ， true为属性值
  }
}

属性设置响应（发送）

operation = 7

message格式

{
  "success": true,
  "code": 200,
  "errorMessage": ""
}

属性获取（接收）

operation = 8

message格式

[
  "Ia",
  "Ib"
]

属性获取响应（发送）

operation = 9

message格式

{
  "params": [
    {
      "code": "Ia", //属性标识符
      "value": 10,  //属性值
      "time":1699412942089 //毫秒时间戳
    },
    {
      "code": "Ib", //属性标识符
      "value": 20,  //属性值
      "time":1699412942089 //毫秒时间戳
    }
  ]
}

服务调用（接收）

operation = 10

message格式

{
  "code": "reportlog", //服务标识符
  "inputParams": { //输入参数
    "text": "/temp" //属性值
  }
}

服务调用响应（发送）

operation = 11

message格式

{
  "code": "file", //服务标识符
  "outParams": { //输出参数
    "result": "/temp" //属性值
  }
}

状态码

状态码	信息	说明
200	-	成功
10001	system error	系统错误
10002	rpc request error	rpc请求错误
10003	too many requests	并发请求数据超过设定
10004	the format of result is error	请求数据格式错误
20001	device not found	未找到该设备
30001	product not found	未找到该产品
40001	data size is not within the defined range	上报数据大小未在指定区间
40002	data report type error	上报数据格式错误
40003	property code not found	属性标识符没有找到
40004	event code not found	事件标识符没有找到
40005	data length is greater than the defined	上报数据长度未在指定区间
40006	invalid Parameter	无效的uri参数
40007	auth PermissionDeny	token错误