创建产品与设备
2025/10/12大约 3 分钟
创建产品与设备
使用物联网平台接入设备前,您需在物联网平台控制台创建产品和对应的设备,获取设备三元组(ProductKey、DeviceName、DeviceSecret)。
背景信息
- 产品相当于一类设备的集合,同一产品下的设备具有相同的功能定义(物模型)。您可以根据产品批量管理设备,如定义物模型、自定义Topic、OTA 升级等。
- 设备对应您的每一台实际设备。将平台颁发的设备三元组烧录到设备中,用于连接平台时的身份验证。
设备三元组说明:
| 参数 | 说明 |
|---|---|
| ProductKey | 设备所属产品的全局唯一标识符,由平台在创建产品时自动生成(16 位随机串) |
| DeviceName | 设备唯一标志,平台全局唯一(跨产品也不能重名),建议使用 SN / IMEI / MAC |
| DeviceSecret | 平台为设备颁发的密钥(32 位十六进制),用于 MQTT 连接密码签名,需与 DeviceName 成对使用 |
命名约束:ProductKey 与 DeviceName 用于拼接 MQTT ClientId 与 Topic,不要包含
.、&、|、/、+、#、:等特殊字符。
创建产品
登录物联网平台控制台。
在左侧导航栏,选择 物联网 > 产品管理,单击 新增产品。
在新建产品页面,配置参数后单击 确认。本文示例的产品名称为智能插座,其余保持默认。
新建产品 参数 说明 产品名称 仅用于展示,建议使用易识别的名称 ProductKey 默认随机生成 16 位,可单击重新生成;创建后不可修改 产品分类 / 设备类型 / 联网方式 业务归类字段,不影响通信协议 协议类型 保持默认 MQTT 序列化类型 保持默认 JSON 动态注册 可选;开启后支持设备一型一密动态注册(见 MQTT设备接入),体验阶段无需开启
创建设备
在产品列表中找到刚创建的产品,单击 管理 进入产品详情。
在 设备列表 页签,单击 添加设备,输入设备标志(DeviceName)为 device1,设置设备别名,启动状态保持启用,单击 确认。
新增设备 创建成功后,平台自动为设备生成 32 位十六进制的 DeviceSecret,并自动创建设备影子。
获取设备三元组
- ProductKey:在产品详情页顶部可直接查看。
- DeviceName / DeviceSecret:在 设备管理 中进入设备详情,DeviceSecret 默认以掩码显示,单击右侧 查看,按页面提示完成短信验证后即可获取。
注意
DeviceSecret 是设备身份凭证,泄露后他人可伪造该设备连接平台。请妥善保管,不要提交到代码仓库或写入公开文档。
批量创建设备
设备较多时可在设备列表页使用 批量新增,上传 CSV / XLS 文件(页面提供模板下载),单次最多 1000 台。
下一步
产品与设备就绪后,为产品定义物模型。