设备接入 IoTDA设备接入 IoTDA

计算
弹性云服务器 ECS
裸金属服务器 BMS
云手机 CPH
专属主机 DeH
弹性伸缩 AS
镜像服务 IMS
函数工作流 FunctionGraph
云耀云服务器 HECS
VR云渲游平台 CVR
特惠算力专区
存储
对象存储服务 OBS
云硬盘 EVS
云备份 CBR
弹性文件服务 SFS
存储容灾服务 SDRS
云硬盘备份 VBS
云服务器备份 CSBS
数据快递服务 DES
专属企业存储服务
云存储网关 CSG
专属分布式存储服务 DSS
CDN与智能边缘
内容分发网络 CDN
智能边缘云 IEC
智能边缘小站 IES
智能边缘平台 IEF
人工智能
AI开发平台ModelArts
华为HiLens
图引擎服务 GES
图像识别 Image
文字识别 OCR
自然语言处理 NLP
内容审核 Moderation
图像搜索 ImageSearch
医疗智能体 EIHealth
园区智能体 CampusGo
企业级AI应用开发专业套件 ModelArts Pro
人脸识别服务 FRS
对话机器人服务 CBS
视频分析服务 VAS
语音交互服务 SIS
知识图谱 KG
人证核身服务 IVS
IoT物联网
设备接入 IoTDA
设备管理 IoTDM(联通用户专用)
全球SIM联接 GSL
IoT数据分析
路网数字化服务 DRIS
IoT边缘 IoTEdge
设备发放 IoTDP
开发与运维
软件开发平台 DevCloud
项目管理 ProjectMan
代码托管 CodeHub
流水线 CloudPipeline
代码检查 CodeCheck
编译构建 CloudBuild
部署 CloudDeploy
云测 CloudTest
发布 CloudRelease
移动应用测试 MobileAPPTest
CloudIDE
Classroom
开源镜像站 Mirrors
应用魔方 AppCube
云性能测试服务 CPTS
应用管理与运维平台 ServiceStage
云应用引擎 CAE
视频
实时音视频 SparkRTC
视频直播 Live
视频点播 VOD
媒体处理 MPC
视频接入服务 VIS
管理与监管
统一身份认证服务 IAM
消息通知服务 SMN
云监控服务 CES
应用运维管理 AOM
应用性能管理 APM
云日志服务 LTS
云审计服务 CTS
标签管理服务 TMS
资源管理服务 RMS
应用身份管理服务 OneAccess
区块链
区块链服务 BCS
可信跨链服务 TCS
可信分布式身份服务
智能协作
IdeaHub
开发者工具
SDK开发指南
API签名指南
DevStar
HCloud CLI
Terraform
Ansible
云生态
云市场
合作伙伴中心
华为云培训中心
其他
管理控制台
消息中心
产品价格详情
系统权限
我的凭证
客户关联华为云合作伙伴须知
公共问题
宽限期保留期
奖励推广计划
活动
容器
云容器引擎 CCE
云容器实例 CCI
容器镜像服务 SWR
应用编排服务 AOS
多云容器平台 MCP
基因容器 GCS
容器洞察引擎 CIE
云原生服务中心 OSC
容器批量计算 BCE
容器交付流水线 ContainerOps
应用服务网格 ASM
网络
虚拟私有云 VPC
弹性公网IP EIP
弹性负载均衡 ELB
NAT网关 NAT
云专线 DC
虚拟专用网络 VPN
云连接 CC
VPC终端节点 VPCEP
数据库
云数据库 RDS
数据复制服务 DRS
文档数据库服务 DDS
分布式数据库中间件 DDM
云数据库 GaussDB (for openGauss)
云数据库 GaussDB(for MySQL)
云数据库 GaussDB NoSQL
数据管理服务 DAS
数据库和应用迁移 UGO
大数据
MapReduce服务 MRS
数据湖探索 DLI
表格存储服务 CloudTable
可信智能计算服务 TICS
推荐系统 RES
云搜索服务 CSS
数据可视化 DLV
数据湖治理中心 DGC
数据接入服务 DIS
数据仓库服务 GaussDB(DWS)
应用中间件
微服务引擎 CSE
分布式消息服务Kafka版
分布式消息服务RabbitMQ版
API网关 APIG
分布式缓存服务 DCS
分布式消息服务RocketMQ版
企业应用
域名注册服务 Domains
云解析服务 DNS
云速建站 CloudSite
网站备案
商标注册
华为云WeLink
会议
隐私保护通话 PrivateNumber
语音通话 VoiceCall
消息&短信 MSGSMS
云管理网络
SD-WAN 云服务
边缘数据中心管理 EDCM
云桌面 Workspace
应用与数据集成平台 ROMA Connect
ROMA资产中心 ROMAExchange
API全生命周期管理 ROMA API
安全与合规
安全技术与应用
DDoS防护 ADS
Web应用防火墙 WAF
云防火墙 CFW
应用信任中心 ATC
企业主机安全 HSS
容器安全服务 CGS
云堡垒机 CBH
数据库安全服务 DBSS
数据加密服务 DEW
数据安全中心 DSC
云证书管理服务 CCM
SSL证书管理 SCM
漏洞扫描服务 VSS
态势感知 SA
威胁检测服务 MTD
管理检测与响应 MDR
安全治理云图 Compass
认证测试中心 CTC
迁移
主机迁移服务 SMS
对象存储迁移服务 OMS
云数据迁移 CDM
专属云
专属计算集群 DCC
解决方案
高性能计算 HPC
SAP
混合云灾备
华为工业云平台 IMC
价格
成本优化最佳实践
专属云商业逻辑
用户服务
帐号中心
费用中心
成本中心
资源中心
企业管理
工单管理
客户运营能力
国际站常见问题
支持计划
专业服务
合作伙伴支持计划
文档首页> 设备接入 IoTDA> 最佳实践> 设备接入> 模拟NB设备的接入与调试
更新时间:2021-10-12 GMT+08:00
分享

模拟NB设备的接入与调试

场景说明

本文以“智慧路灯”为示例,通过设备接入控制台提供的设备模拟器和应用模拟器替代真实的设备和应用,带您快速体验设备上报数据到物联网平台和远程下发控制命令到设备的全过程。

假设:

路灯设备上报一条数据消息,包含路灯的光照强度(light_intensity)和路灯的开关状态(light_status);支持远程控制路灯开关状态的命令(SWITCH_LIGHT),上报数据的格式为二进制格式。

前提条件

  • 已注册华为云官方帐号。未注册可单击注册页面完成注册。
  • 已完成实名制认证。未完成可在华为云上单击实名认证完成认证,否则无法使用设备接入功能。
  • 已开通设备接入服务。未开通则访问设备接入服务,单击“立即使用”后开通该服务。

(可选)创建资源空间

资源空间是物联网平台提供物联网应用和设备的调测空间,您可以根据场景的不同创建不同资源空间分别调测。

系统为您预置了一个资源空间,您可以直接在预置的资源空间下,在线开发设备的产品模型文件和编解码插件;也可以新建一个资源空间,具体步骤如下。

  1. 访问设备接入服务,单击“立即使用”进入设备接入控制台。
  2. 选择左侧导航栏的“资源空间”,单击右上角“新建资源空间”。
  3. 在弹出的页面填写“空间名称”,然后单击“确定”。

创建产品

基于开发的产品,用户可以在线开发设备的产品模型文件和编解码插件;另外,物联网平台提供了设备和应用模拟器,可以便捷地调测开发的产品模型文件和编解码插件的正确性。

  1. 访问设备接入服务,单击“立即使用”进入设备接入控制台。
  2. 选择左侧导航栏的“产品”,单击右上角下拉框,选择新建产品所属的资源空间。

  3. 单击右上角的“创建产品”,创建一个基于LwM2M/CoAP协议的产品,填写参数后,单击“立即创建”

    基本信息

    所属资源空间

    选择新建产品所属的资源空间。

    产品名称

    自定义,如StreetLight。

    协议类型

    选择“LwM2M/CoAP”。

    数据格式

    选择“二进制码流”。

    说明:

    当“数据格式”配置为“二进制码流”时,该产品下需要进行编解码插件开发;当“数据格式”配置为“JSON”时,该产品下不需要进行编解码插件开发。

    厂商名称

    自定义

    所属行业

    设备类型

    streetlight

定义产品模型

  1. 找到步骤3创建的产品,单击产品进入产品界面。
  2. 在产品详情模型定义页面,单击“自定义模型”,配置产品的服务,然后单击“确认”。

    • “服务ID”:StreetLight
    • “服务类型”:建议和服务ID保持一致
    • “服务描述”:路灯上报的环境光强度和路灯开关状态的属性。

  3. 单击步骤2新增的服务ID,在展开的页面单击“添加属性”,定义一条属性为路灯采集的当前环境的光照强度。

    • “属性名称”:light_intensity
    • “数据类型”:int(整型)
    • “访问权限”:可读、可写
    • “取值范围”:0~100,光照强度范围。

  4. 单击“添加属性”,定义一条属性为路灯当前的开关灯状态。

    • “属性名称”:light_status
    • “数据类型”:int(整型)
    • “访问权限”:可读、可写
    • “取值范围”:0~1,0代表关闭,1代表打开状态

  5. 接下来定义远程控制开关灯状态的命令。

    1. 单击“添加命令”,定义命令名称:SWITCH_LIGHT。
    2. 单击“新增输入参数”,参数名称:SWITCH_LIGHT,数据类型为:string,长度为:3个字符,枚举值为:ON,OFF。
      图1 新增参数
    3. 单击“新增响应参数”,参数名称:result,数据类型:int。

  6. 单击“确认”,完成该路灯的产品模型文件开发。

在线开发插件

通常情况下设备为了省电,设备会采用“二进制”格式上报数据,编解码插件的作用就是将设备上报的“二进制”格式数据,按照产品模型文件的定义的属性转换为“JSON”格式数据,便于物联网平台和应用服务器识别。同时,用户远程下发控制命令时,物联网平台会将“JSON”格式的命令转换为“二进制”格式数据下发给设备。

如果设备本身上报的是JSON格式数据,则不需要定义编解码插件。

  1. 在智慧路灯产品的开发空间,选择“插件开发”,单击“图形化开发”。
  2. 单击“新增消息”,配置数据上报消息,上报路灯的数据消息。

    • 消息名:LightData
    • 消息类型:数据上报
    • 添加响应字段:是。添加响应字段后,物联网平台在收到设备上报的数据后,会下发用户设置的响应数据到设备。
    • 响应数据:AAAA0000(默认)

    1. 单击“添加字段”,添加messageID字段,表示消息种类。

    2. 添加LightIntensity字段,表示光照强度,数据类型:int8u(8位无符号整型),长度:1字节。

    3. 添加LightStatus字段,表示路灯上报的路灯开关状态数据。数据类型:int8u(8位无符号整型),长度:1字节。

  3. 再次单击“新增消息”,定义远程控制路灯开关的命令对应的编解码插件消息。

    • 消息名:SwitchStatus
    • 消息类型:命令下发
    • 添加响应字段:是。添加响应字段后,设备在接收命令后,会上报命令执行结果。

    1. 单击“添加字段”,添加messageID字段,表示消息种类。

    2. 添加mid字段,用于将下发的命令和命令执行结果进行关联。

    3. 添加SwitchStatus字段,数据类型:string(字符串类型),长度:3字符。

    4. 单击“添加响应字段”,配置命令下发响应消息。
      • 添加messageId,表示消息种类。命令执行结果为上行消息,需要通过messageId和数据上报消息进行区分。

      • 添加mid字段,用于将下发的命令和命令执行结果进行关联。

      • 添加errcode字段,用于表示命令执行状态:00表示成功,01表示失败,如果未携带该字段,则默认命令执行成功。

      • 添加result字段,用于表示命令执行结果。

  4. 拖动右侧“设备模型”区域的属性字段和命令字段(产品模型文件定义的字段),与编解码插件定义的数据上报消息和命令下发消息的相应字段建立映射关系。

  5. 编解码插件与产品模型文件建立映射完成后,单击右上角“保存”,并单击“部署”,完成编解码插件的部署。

使用真实设备在线调试

模拟器在线调测具备设备模拟和应用模拟功能,可以对定义的产品模型文件和编解码插件进行调试,用户可以直观的感受设备上报数据到物联网平台,以及使用物联网平台下发远程控制命令。

  1. 在智慧路灯产品的开发空间,选择“在线调试”,单击“新增测试设备”。
  2. 在新增测试设备页面,完成设备参数的填写后,单击“确定”

    • 设备类型:真实设备。
    • 设备名称:自定义。
    • 设备标识码:设备的IMEI号,用于设备在接入物联网平台时携带该标识信息完成接入鉴权,可在NB模组上查看。
    • 设备注册方式:不加密。如果使用DTLS传输层安全协议接入时,设备注册方式选择“加密”,且请妥善保存密钥。

    新添加的设备处于未激活状态,此时不能进行在线调试,可参考连接鉴权,待设备接入平台后,进行调试。

  3. 单击“调试”,进入调试界面。

  4. 模拟远程下发控制命令场景,在应用模拟器中,选择服务:StreetLight,命令:SWITCH_LIGHT,命令取值为:ON,单击“立即发送”,我们可以看到路灯被点亮。

使用虚拟设备在线调试

  1. 在智慧路灯产品的开发空间,选择“在线调试”,单击“新增测试设备”。
  2. 在新增测试设备页面,选择“模拟设备”,然后单击“确定”,创建一个虚拟设备。虚拟设备名称包含 “Simulator”字样,每款产品下只能创建一个虚拟设备。

  3. 单击“调试”,进入调试界面。

  4. 模拟设备数据上报场景,在设备模拟器中,输入十六进制码流:002000(00为地址域meaasgeID,长度为1个字节;20表示光照强度,长度为1个字节;00表示路灯开关状态为关闭状态,长度为1个字节),然后单击“发送”,我们可以在应用模拟器中看到转换为JSON格式的数据为:"Light_Intensity":32, "Light_Status":0。

  5. 模拟远程下发控制命令场景,在应用模拟器中,选择服务:StreetLight,命令:SWITCH_LIGHT,命令取值为:ON,单击“立即发送”,我们可以在设备模拟器中看到转换为十六进制的码流:0100184F4E(经ASCLL码转为为十六进制)。

使用离线模拟器调试

NB-IoT设备模拟器用于模拟以LwM2M/CoAP协议接入物联网平台的NB设备,实现数据上报和命令下发功能。

  1. 获取2中注册设备时的设备标识码,密钥。
  2. 下载并解压NB-IoT设备模拟器,然后双击“NB-IoTDeviceSimulator_zh.jar”,运行模拟器。

    • 推荐在Windows系统下运行,暂不支持MAC OS。
    • 请确保已经安装jdk,否则,无法运行jar文件。

    NB-IoT设备模拟器的文件说明如下:

    • NB-IoTDeviceSimulator_zh.jar:中文版模拟器。
    • Californium.properties:模拟器的配置文件。
    • setting.properties:设备模拟器接入物联网平台的配置文件。

  3. 模拟器启动后,会提示“是否开启DTLS加密传输?”。若注册设备时,没有填写密钥,单击“否”,若注册设备时,已填写密钥,单击“是”。

  4. 填写“IP地址”“VerifyCode”“PSK”,单击“注册设备”,将模拟器与物联网平台进行绑定。

    :如果未开启DTLS加密传输,则无需填写密钥。

    如下信息根据实际情况填写:
    • IP地址:物联网平台的接入域名(也可以使用IP,通过ping命令“ping 域名”可以获得IP地址)。
    • VerifyCode:设备标识码,如:aaaaa11111。
    • PSK:注册设备时预置的密钥,如:aaaaa11111aaaaa。

    设备绑定成功,可以回到管理控制台,选择设备 > 所有设备,看见设备“aaaaa11111”显示“在线”,表示模拟器绑定成功。

  5. 模拟设备数据上报场景,则在NB-IoT设备模拟器中,输入十六进制码流:001400(00为地址域meaasgeID,长度为1个字节;14表示光照强度,长度为1个字节;00表示路灯开关状态为关闭状态,长度为1个字节),然后单击“发送数据”

    数据上报成功,可以回到管理控制台,在“aaaaa11111”设备详情页面中查看到转换为JSON格式的数据为:"Light_Intensity": 20, "Light_Status": 0。

  6. 模拟远程下发控制命令场景,在管理控制台,找到对应的产品,单击产品进入产品界面,选择“在线调试”页签,单击设备“aaaaa11111”右边的“调试”,进入调试界面。

    在应用模拟器中,选择服务:StreetLight,命令:SWITCH_LIGHT,命令取值为:ON,单击“立即发送”

    我们可以在“日志”栏看到CIG下发的数据内容:ON,且模拟器会提示“收到平台的下行消息,是否应答?”,单击“是”,可以在管理控制台的应用模拟器看到命令状态为“已送达”

    由于插件中的string类型是按照ascii码解析的,因此需要下发可显示字符,非可显示字符在模拟器中不会显示。

分享:

    相关文档

    相关产品

关闭导读