主题
入门必读
本节面向首次使用平台的用户，介绍从“创建产品分类”到“设备固件开发”的完整链路，帮助你在几分钟内建立从云到端的基本通路。内容结构参考了业内常见的入门流程，便于快速上手。
本文不包含截图，稍后将补充；流程与字段说明已完整给出。
使用流程概览
- 新建产品
- 定义并发布产品物模型
- 新建设备（或由设备首次认证自动创建）
- 获取设备凭证并在 SDK/固件中配置
- 设备上电联网，连接平台完成激活
一、创建产品分类
当默认产品类别无法满足标识需求时，可新增自定义类别：
- 进入“设备管理 → 产品分类”，点击“新增”。
- 在“新建产品分类”中填写名称、标识等信息后提交。
建议：根据业务线或设备形态（如“照明/路灯”“环境/网关”）建立清晰层级，便于后续检索与权限管理。
二、创建产品
在设备接入前，需要先创建承载设备模型的“产品”：
- 进入“设备管理 → 产品管理”，点击“新增”。
- 填写“产品名称”等基础信息并提交（其他参数可按默认）。
示例：创建“智能开关”产品，后续将为其定义“开关功能”和“工作电流”等物模型项。
三、定义物模型
平台通过“物模型”统一抽象设备的数据与能力，典型由“属性、功能、事件”构成。定义完成并“发布产品”后，产品下新建的设备将自动继承相同模型。
操作步骤：
- 打开产品详情页的“物模型”页签，点击“新增”。
- 根据设备能力添加条目，并设置标识符、数据类型、读写权限、取值范围/枚举等。
- 确认无误后，点击“发布产品”。
注意事项：
- 物模型标识符必须唯一。
- 产品需“发布”后才能新建设备或接入设备。
- 如涉及视频/大流量能力，请评估带宽与协议适配策略。
示例条目（建议）：
- 功能：
switch（设备开关，布尔，读写） - 属性：
workCurrent（工作电流，数值，单位 mA，范围由设备规格定义）
四、接入设备
产品发布完成后，即可接入设备。你可以选择先在平台“新建设备”，也可以直接在 SDK 中配置设备凭证，让设备首次认证时由系统自动生成实体。
方式 A：平台先建设备
- 进入“设备管理 → 设备管理”，点击“新增”。
- 选择所属产品并填写设备参数，提交即可。
方式 B：设备首次认证自动创建设备（适合批量生产）
- 在固件内配置产品 Key/设备标识/鉴权参数，设备联网后认证成功，系统自动生成对应设备实体。
注意事项：
- 自定义设备编号请避免使用特殊字符。
- 启用“设备影子”后，离线状态也可下发目标期望；设备上线将立即对齐执行。
- 定位/地理信息相关字段按业务需要填写（默认自动定位到城市级）。
五、固件开发（示例指引）
目标：完成设备认证、MQTT 交互与基础配网（以常见 Wi‑Fi 设备为例）。
步骤建议：
- 准备接入参数：收集产品/设备的鉴权字段（如产品 Key、设备名称、设备密钥等），写入 SDK/固件配置。
- 获取并编译示例 SDK：根据目标芯片与开发环境选择合适示例（如 ESP8266/ESP32/STM32 + MQTT 客户端）。
- 在配置文件中填写接入参数与物模型映射（如将本地
GPIO控制映射到switch功能，将电流采样映射到workCurrent属性上报）。 - 烧录并上电，串口/日志观察设备连接平台并完成激活。
- 在平台侧订阅或查看设备数据：验证属性上报、功能下发（开关控制）是否与期望一致。
排障建议：
- 频繁重启（如看门狗复位）时，检查主循环负载与喂狗策略。
- 连接失败时，先确认网络与鉴权字段是否正确，再抓包/日志定位 TLS/MQTT 握手阶段错误码。
- 如出现物模型字段不匹配，校验标识符、数据类型与读写权限设置。
后续阅读
- 完成本节后，建议继续阅读“DRML37多传感器设备接入”，获取一个完整的多传感器产品接入范例，包括物模型设计、联网配置与联调技巧。