更改控制指令模式

更新时间:2024-06-18 06:03:39下载pdf

本文介绍了如何在涂鸦开发者平台上更改设备的云开发控制指令模式。

模式说明

云开发支持以下两种控制指令模式:

模式
介绍 适用场景
标准指令集 标准指令集是设备可下发的控制功能的指令集合,是一套标准的设备功能描述方式。您通过 JSON 格式下发标准指令,涂鸦通过云端转义为设备 DP(Data Point),进而控制设备。 云开发默认使用 标准指令集 模式控制设备。标准指令集无法覆盖全部的涂鸦生态设备的功能,支持标准指令集控制的产品品类,请参考 标准指令集 系列文档。
DP 透传指令 使用设备原始 DP 指令进行控制,可以访问产品的原始 DP 信息。适用于部分含有非标准指令集的产品。 当您通过标准指令集无法控制智能产品时,可以更改为 DP 透传指令模式,使用设备原始定义的 DP 进行控制。部分非标准 DP 是厂商自定义的协议,DP 透传后涂鸦仅传输数据,此时您可以咨询厂商进行数据解析。

如果某个产品修改了功能 DP,DP 透传指令 模式的配置也会自动更新,但有一定更新同步时间,一般情况下是四小时左右。

前提条件

  • 您已经在云项目中,关联了设备。详细步骤,请参考 关联设备
  • 您使用的是 IoT 主账号进行操作。

第一步:查看云项目的产品列表

  1. 登录 涂鸦开发者平台

  2. 访问 我的云项目

  3. 单击目标项目 操作 栏里的 进入项目

  4. 在顶部导航栏,单击 设备 页面,查看 全部设备 页面。

  5. 从产品维度查看设备信息 标签内,单击 产品列表 按钮。

    更改控制指令模式

    产品列表内的 PID 集合,为关联云项目中的 App 或 App 账号所有绑定设备的产品集合。

第二步:更改控制指令模式

  1. 鼠标悬浮至设备卡片,单击 查看 按钮,或者 更改控制指令模式 按钮,进入配置模式界面。

    更改控制指令模式

    页面内展示的产品列表为非全部,如若没找到需要更改的产品,请使用产品名称或产品 ID 进行搜索。

  2. 在产品控制指令模式界面:

    1. 查询产品的标准指令集详情,然后单击 变更指令模式 修改控制指令模式。

    2. 修改控制指令模式为 DP 透传指令
      更改控制指令模式

    3. 单击 保存配置

    4. 单击 刷新配置 重新查看详情页面。

      更改控制指令模式后,中国数据中心 会立即生效,其他数据中心将在四小时左右自动同步。如果需要立即生效,请在对应数据中心的页面下,单击 刷新配置 按钮手动刷新。
      更改控制指令模式

后续您通过云开发控制设备时,需要符合您设置的指令模式。

第三步:调整指令下发方式

以智能灯的光照颜色 colour_data DP 为例:

  • 标准化指令模式:以 JSON 格式下发指令。

    {
        "code": "colour_data",
        "value":
        {
            "h": 37,
            "s": 255,
            "v": 188
        }
    }
    
  • DP 透传指令模式:按照产品品类的 DP 协议 下发指令。透传后,标准化指令模式中的 value 参数需要按照 String 格式下发,并且您需要自行拼接参数。

    数据类型 取值范围 指令示例
    字符型 000011112222,其中:
    • 0000:表示色度 H(0 ~ 360,0X0000 ~ 0X0168)
    • 1111:表示饱和度 S(0 ~ 1000,0X0000 ~ 0X03E8)
    • 2222:表示明度 V(0 ~ 1000,0X0000 ~ 0X03E8)
    {"code": "colour_data", "value": "00DC004B004E"}

    HSV 十六进制 00DC 004B 004E 表示十进制 220 度、75%、78%。