使用Windows模拟程序上报数据,通过该模拟程序模拟车载设备连接物联网平台,并上报车载设备采集的相关数据到平台,用户可快速体验设备如何接入及上报物模型数据至平台以及如何在控制台查看上报的设备数据。
前提条件
1. 已开通企业实例。
2. 已按创建企业实例及产品设备指引在用户自有账号下创建完产品、导入对应的物模型以及创建完一个设备。
说明:
使用本文的Windows设备模拟程序,必须要按指引导入对应的物模型格式,用户也可自由定义物模型,该模拟程序可根据根据JSON文件中的物模型定义随机上报物模型属性、事件数据至平台。
操作步骤
下载MQTT客户端模拟程序
1. 若用户系统为Windows系统且版本为Win10及以上,则可以下载平台提供的模拟程序到PC端。
2. 下载模拟程序到用户Windows本地磁盘并解压缩。
运行模拟程序上报数据
1. 进入Windows终端命令行,进入模拟程序解压目录,假设用户解压目录为 e:\\mqtt_client。注意,解压后将看到mqtt_connect.exe和tbox.json两个文件。
2. 运行以下命令。
e:\\mqtt_client>mqtt_connect.exe -s tbox.json -i 用户产品id -n 用户创建的DeviceName -k 设备密钥 -d 用户产品id.iotcloud.tencentdevices.com -l 50
3. 上述命令行中的用户产品id、用户创建的DeviceName、设备密钥分别从刚创建的设备信息页中复制粘贴。如下图所示:
命令行参数 | 描述 |
-s | 创建产品导出的物模型JSON文件,模拟程序将根据该JSON文件定义的属性、事件随机上报数据至平台 |
-i | 指定产品ID,从控制台创建的产品ID |
-n | 指定设备名称,注意动态注册一般是由设备端随机生成设备名称,无需在控制台创建设备 |
-k | 指设备密钥,从控制台所创建的设备信息页中获取设备密钥 |
-d | mqtt服务器地址,替换为自己的产品ID,平台MQTT服务地址为 “产品ID.iotcloud.tencentdevices.com” |
-l | 指定循环次数,循环上报数据次数达到后模拟程序自动关闭mqtt连接并退出 |
4. 运行成功后,模拟程序将打印如下日志,用户无需关闭窗口,模拟程序将会随机上报数据至平台。
控制台查看设备上报数据
查看物模型日志数据
1. 进入该模拟设备控制台页面,进入设备云端日志 > 物模型日志 > 属性。
2. 当模拟程序在运行时,将会在如下页面查看到模拟程序上报的最新属性值以及对应的更新时间。
查看内容日志
1. 进入该模拟设备控制台页面,进入设备云端日志 > 内容日志 > 属性。
2. 当模拟程序在运行后并成功上报数据后,将会在如下页面查看到模拟程序上行的JSON报文以及平台返回至设备的下行JSON报文。详细的物模型协议格式可参考 物模型协议。
查看设备上线/离线日志
1. 进入该模拟设备控制台页面,进入设备云端日志 >上下线日志,可查询设备上下线行为以及下线原因。
2. 当模拟程序在运行后并成功上报数据后,将会在如下页面查看到设备连接到平台的事件,动作类型为“上线”;若模拟程序主动关闭或者因心跳超时,则动作类型都显示为“下线”,具体的原因如下图红色线框显示。
控制台查看设备轨迹日志
当设备出现无法上报数据或无法接收控制指令或规则引擎无法转发消息时,平台提供了云端轨迹日志查询功能,便于用户分析哪个环节出现问题,用于定位是否是设备侧或用户业务系统相关问题。
1. 进入该模拟设备控制台页面,进入设备云端日志 > 云端诊断日志,选择合适的时间范围。
2. 当模拟程序在运行后并成功上报数据后,将会在如下页面查看到模拟设备在平台的端到端行为轨迹。
3. 若某个行为出现失败,失败的原因分析可参考 异常原因。