- 产品介绍
- 价格说明
- 快速入门
- 开发指南
- 用户指南
- 最佳实践
- API参考
-
SDK参考
- SDK介绍（联通用户专用）
- 应用侧JAVA SDK API参考（联通用户专用）
- 应用侧Python SDK API参考（联通用户专用）
- 设备侧Agent Lite API参考(C)（联通用户专用）
- 设备侧Agent Lite API参考(Android)（联通用户专用）
- 设备侧Agent Lite API参考(Java)（联通用户专用）
-
常见问题
- 热门问题（联通用户专用）
-
方案咨询（联通用户专用）
- 开发中心、设备接入和设备管理的差异是什么？
- IAM子用户或子项目是否可以开通物联网平台服务？
- 物联网平台支持在华为云的哪些区域开通？
- 如何成为华为IoT生态合作伙伴？
- 物联网平台支持哪些接入方式和协议？
- 华为是否提供模组/硬件终端/应用软件等？
- 设备接入模拟器HubSimulator是否能在设备管理使用？
- 设备接入服务如何获取设备数据？
- 物联网平台的应用和设备可以无限创建吗？
- 物联网平台支持批量注册设备吗？
- 物联网平台对应用和设备有消息流控吗？
- 开发中心单个应用允许接入设备数是多少？
- 数据在物联网平台的保存时间是多久？
- 物联网平台支持的DTLS加密算法有哪些？
- 物联网平台支持二进制大小端模式切换吗？
- 什么是NB-IoT？
- 物联网平台支持的硬件架构和使用的相关组件有哪些？
-
设备集成（联通用户专用）
- 如何获取设备和应用对接地址？
- 如何下载LiteOS IDE/IoT Studio?
- 物联网平台允许一个IMEI号注册多个设备吗？
- 如何设置设备名称？
- IoT设备如何激活？
- 物联网平台如何切换设备的在线/离线状态？
- 通过网关接入的子设备，平台如何识别是哪一个设备？
- deviceId、nodeId和IMEI有什么对应关系？
- Agent Lite和Agent Tiny有什么区别？
- 使用Agent Lite接入的网关设备gwbindinfo.json文件丢失如何处理？
- 运行Agent Lite Java Demo报UnsatisfiedLinkError错误怎么处理？
- 设备如何发送文件至物联网平台？
- 开发中心模拟设备如何上报负数？
- 开发中心支持哪几种省电模式？
- 开发中心支持数据转发吗？
- 开发中心没有设备分组和批量添加设备，怎么办？
- 如何检测NB网络信号？
- NB模组附着网络失败如何处理？
- NB模组绑定设备失败怎么办？
- NB模组无法正常上报数据怎么办？
- NB设备上报数据为字符串时如何转换为二进制编码？
- NB设备接入时，出现513错误？
- 为什么执行AT+CUFN=1会返回error？
- 平台向NB-IoT设备缓存下发命令，为什么设备一直收到同一条控制命令？
- AT+CGDCONT=1, CTNB是什么？
- NB-IoT设备如何选择PSM、DRX、eDRX模式？
- 应用集成（联通用户专用）
-
订阅推送（联通用户专用）
- 调用订阅接口时，回调地址如何获取？
- 应用服务器如何收到命令状态变化的通知？
- 如何获取证书？
- 回调地址可以使用域名吗？
- 订阅后消息推送失败，例如提示503如何处理？
- 应用服务器收到数据，但是平台显示推送失败？
- 应用服务器只有内网地址，能否订阅成功？
- 调用订阅接口时，提示回调地址不合法？
- 物联网平台只支持HTTPS的回调地址吗？
- 回调地址可以修改吗？
- 推送证书失效怎么处理？
- 调用删除单个订阅接口时，subscriptionId如何获取？
- 设备数据变化通知和批量设备数据变化通知的区别是什么？
- 应用服务器如何获取物联网平台推送消息时使用的地址？
- 物联网平台订阅推送是否具有重推机制？
- 为什么设备上报一条数据后应用服务器会收到多条推送？
- 在同一个应用下，平台可以将不同设备上报的数据，推送到两个服务器吗？
- NB-IoT设备已订阅消息确认和命令响应通知，为何应用服务器收不到推送消息？
- 数据上报（联通用户专用）
- 命令下发（联通用户专用）
- 产品模型/Profile（联通用户专用）
- 编解码插件（联通用户专用）
- 软/固件升级（联通用户专用）
- 文档下载
- 通用参考
链接复制成功！
产品模型（联通用户专用）
概述
产品模型（也称Profile）用于描述设备具备的能力和特性。开发者通过定义Profile，在物联网平台构建一款设备的抽象模型，使平台理解该款设备支持的服务、属性、命令等信息，如颜色、开关等。当定义完一款产品模型后，在进行设备注册时，就可以选择已在控制台上导入的产品模型。
Profile包括产品信息、服务能力、维护能力三部分：
- 产品信息
描述一款设备的基本信息，包括厂商ID、厂商名称、设备类型、型号、协议类型。其中厂商ID和型号唯一标识一款产品。
例如：水表的厂商名称为“HZYB”，厂商ID为“TestUtf8ManuId”，设备类型为“WaterMeter”，型号为“NBIoTDevice”，协议类型为“CoAP”。
- 服务能力
描述设备具备的业务能力。将设备业务能力拆分成若干个服务后，再定义每个服务具备的属性、命令以及命令的参数。
以水表为例，水表具有多种能力，如上报水流、告警、电量、连接等各种数据，并且能够接受服务器下发的各种命令。Profile文件在描述水表的能力时，可以将水表的能力划分五个服务，每个服务都需要定义各自的上报属性或命令。说明如下：
服务名
描述
基础（WaterMeterBasic）
用于定义水表上报的水流量、水温、水压等参数，如果需要命令控制或修改这些参数，还需要定义命令的参数。
告警（WaterMeterAlarm）
用于定义水表需要上报的各种告警场景的数据，必要的话需要定义命令。
电池（Battery）
定义水表的电压、电流强度等数据。
传输规则（DeliverySchedule）
定义水表的一些传输规则，必要的话需要定义命令。
连接（Connectivity）
定义水表连接参数。
注：具体定义几个服务是非常灵活的，如上面的例子可以将告警服务拆分成水压告警服务和流量告警服务，也可以将告警服务合入到水表基础服务中。
- 维护能力
描述设备具备的维护能力，包括固件升级、软件升级、配置更新。
关于Profile文件的规范、含义和样例等，可参考如何离线开发？
开发产品模型
Profile的开发手段有在线开发和离线开发两种，我们推荐使用开发中心在线开发。
- 在线开发：即在开发中心上，通过界面操作进行开发Profile，开发完成后可以下载，并发布到产品中心
- 离线开发：是指开发者通过了解Profile格式规范，在本地进行开发、打包
新增产品模型
Profile开发完成并测试验证后，可以将profile文件导入到控制台上使用，有三种导入方式：
- 产品中心导入：在开发中心上完成profile的定义并发布到产品中心。
- 本地导入：指线下完成profile的开发，通过上传profile包的方式导入。
注：通过本地导入的profile不含编解码插件，如果设备上报采用的是二进制码流，请使用产品中心导入的方式。
- 手动创建：手动创建一个产品（支持CoAP/LWM2M、MQTT或LoRaWAN），不定义设备属性（不需要开发profile及编解码插件），仅透传数据，不解析数据（透传模式具体请参考数据上报（联通用户专用））。如使用手动创建的产品模型，建议仅开通设备接入服务即可。
说明：
- 登录物联网平台控制台，点击右上角“进入设备管理服务”。
- 单击左下角
，选择“产品模型”，单击“新增产品模型”。 - 产品模型可通过从产品中心导入和从本地导入两种方式。
- 从产品中心导入：
- 选择“从产品中心导入”，进入到产品中心页面。
- 导入自有产品：产品中心默认显示自有产品列表，可通过产品名称或者设备类型搜索产品。
- 导入第三方公开产品：“产品范围”选择“第三方公开”，可通过产品名称、设备类型或者厂商名称搜索产品。
- 导入第三方私有产品：单击页面右上角“第三方私有产品”，在弹出的窗口中输入产品验证码，该验证码由设备厂商提供。
- 在搜索的产品模型列表中单击需要导入的产品名称。
- 选择“从产品中心导入”，进入到产品中心页面。
- 从本地导入：
- 选择“本地导入”进入到本地导入产品的页面。
- 在弹出的窗口中输入产品名称，并上传资源文件。
- 单击“确定”，等待导入完成。
- 从产品中心导入：
- 在“产品模型”页面查看导入结果。
- 导入失败：可在“失败原因”中查看导入失败的原因，用户可根据失败原因定位错误。
- 导入成功：可单击“详情”，查看产品模型详情。
- 用户可以在产品列表中删除不再使用的产品，单击“删除”即可。
单击“详情”，用户可查看产品模型详细信息，包括查看该产品模型具备的服务列表，产品维护能力配置，以及自定义topic。
关于自定义topic，每个产品模型最多可以自定义10个，只有MQTT协议接入的设备支持自定义，参数信息配置如下：
- 设备操作权限：
- 发布： 设备侧消息上报时，可按配置中自定义的topic进行消息上报；数据流转时，设备消息中会携带topic参数标识该消息从哪个topic上报。
- 订阅：设备侧消息下发时，可在消息内容中指定此消息下发使用哪个topic；消息发往设备时，可以根据指定的topic下发。
- 发布和订阅：同时具备发布和订阅的权限。
- topic名称：自定义即可。支持英文字母、数字、下划线，+和#（仅权限是订阅时支持），长度限制64。
- 描述：关于该topic的描述。
说明：
- 如果还未使用该产品模型注册设备，则可以删除该产品模型。
- 如果已使用该产品模型注册过设备，则无法删除该产品模型。
- 设备操作权限：
