快速入门

    产品名称输入`智能灯`，虽然平台已内置智能灯的标准物模型，但为了演示自定义物模型的步骤，这里选择`自定义品类`，节点类型选择`直连设备`，设置完成后点击保存（若不在`高级配置`中手动输入产品编码，则产品编码由平台自动生成。
          

:::tip 提示
新增产品时各配置项的含义可以通过配置项右上角的提示查看，也可以详细参考创建单个产品。
:::

</Step>
<Step title="">
    ### **自定义物模型**
    点击上一步添加的`智能灯`产品名称，进入`产品详情`页，接着点击`物模型`Tab按钮，并点击`编辑草稿`，进入物模型编辑模式：
    ![进入物模型编辑界面.gif](https://api.apifox.com/api/v1/projects/2703425/resources/450586/image-preview)
    
    在物模型草稿编辑页面，点击`自定义添加`，这里我们希望`智能灯`设备具有`整数（int）`类型的`亮度（Brightness）`属性，并且阈值在0~100之间。输入完成后点击`确定`。
    

:::tip
新增物模型信息时各配置项的含义可以通过配置项右上角的提示查看，也可以详细查看单个添加物模型
:::

    添加完成后，点击`发布上线`，勾选`我已核实`后，点击确认，物模型成功发布上线。
    

### 设备注册
进入设备管理菜单，点击添加设备，选择上一步中添加的智能灯产品，并将设备名称命名为智能灯设备1，在不输入设备编码的情况下，平台会自动进行生成：

</Step>
<Step title="">
    ### **在线调试**
    

:::tip
在线调试并非设备数据接入物联网平台的必要条件，在实际使用中此功能用于直接触发平台向设备下发指令的动作，辅助设备端开发人员进行调试工作。
:::
点击之前步骤中添加的智能灯设备1的设备名词，进入设备详情页，点击连接参数按钮，查看设备连接参数：

:::tip
为便于演示，我们使用MQTT工具模拟设备进行连接与数据监听，值得说明的是MQTT连接参数并非固定值，在实际设备接入过程中，连接参数是通过设备的三元组：产品ID（productId，即产品编码），设备ID（deviceId，即设备编码），设备密钥加签得到的，具体加签规范可以参考MQTT协议接入。

    此外，我们在演示步骤中直接订阅了当前设备的所有物模型相关Topic，而IoT平台的所有可用Topic可以参考[Topic定义](doc-2540875/?nav=3)。

:::
接着我们使用MQTT工具模拟设备进行连接（此处使用的MQTT客户端工具为MQTT Explorer )并订阅Topic：

    连接完成后，在平台查看设备状态，由`未激活`变为`在线`：

    然后我们切换到`在线调试`Tab，在`期望值`一栏，设置`亮度`的期望值为`100`并点击`发送指令`，此时通过MQTT工具我们可以监听到下发的数据，说明设备能够正确订阅到平台下发的指令：
    

### 数据上报与查询
最后，我们使用MQTT工具模拟设备进行属性上报，Topic以及报文格式参考设备 - 属性 - 属性上报，上报完成后，通过MQTT工具可以看到平台响应：

    此时，在设备详情的物模型Tab框内的属性卡片以及历史记录中，能够查询到设备的实时属性值以及历史记录值：