# 使用UDP服务网关接入设备

本文档使用SocketTool4工具模拟tcp客户端接入平台。

# 创建协议

请参考创建协议

# 创建产品

参考tcp接入设备示例中的创建产品创建id为udp-test的产品并发布

设备型号发布

# 创建设备实例

参考tcp接入设备示例中的创建设备创建id为udp-test-001的设备并激活

设备发布

# 创建UDP服务网络组件

  1. 选择 设备接入-->网络组件--> 点击新增组件按钮。

insert-udp-server

  1. 在创建完成的模块上点击启动按钮。

udp-server-start

# 创建UDP服务设备网关

  1. 选择 设备接入-->设备网关--> 点击新建按钮。

insert-udp-server-gateway

注意

和MQTT服务设备网关不同的是,udp必须指定消息协议,因为无法通过消息识别出对应的设备标识. 在消息解码时也无法通过上下文(MessageDecodeContext)获取到设备操作接口(DeviceOperator). 此处使用demo协议.

  1. 在操作列点击启动按钮启动网关。

udp-server-gateway-start

# 使用UDP模拟工具接入

  1. 下载并安装SocketTool4

注意

此处以json方式传输数据。

  1. 创建udp客户端。

create-udp-client

  1. 模拟设备设备属性上报

在SocketTool4工具的数据发送窗口填写发送的报文。
此处使用的报文为:

{
  "properties":{
      "temperature":36.5 //温度属性
     },
  "messageType": "REPORT_PROPERTY",//org.jetlinks.core.message.MessageType
  "deviceId": "udp-test-001",//设备id
  "key": "admin"//udp认证配置,udp_auth_key	
}

单击发送数据按钮发起发送数据。
online-send

收到上报的消息后平台中设备状态将变为上线。

设备上线

在设备运行状态中可以看到温度属性已发生变化。

温度属性变化

点击详情按钮可查看属性上报日志信息、图标展示。

属性日志

  1. 模拟设备上报事件

在SocketTool4工具的数据发送窗口填写发送的报文。
此处使用的报文为:

{
    "data": {
          "pname":"智能温控",
          "aid":105,
          "a_name":"未来科技城",
          "b_name":"C2 栋",
          "l_name":"12-05-201",
          "timestamp":"2019-11-06 16:28:50",
          "alarm_type":1,
          "alarm_describe":"火灾报警",
          "event_id":1,
          "event_count":1
    },
    "event": "fire_alarm",//事件标识
    "messageType": "EVENT",//org.jetlinks.core.message.MessageType
    "deviceId": "udp-test-001",//设备id
    "key": "admin"//udp认证配置,udp_auth_key	
}

单击发送数据按钮发起发送数据。
udp事件

在设备运行状态中可以看到事件已上报。

事件上报成功

点击详情按钮可查看属性上报日志信息、图标展示。

事件日志