自定义功能

更新时间:2024-06-24 10:10:15下载pdf

产品功能是具体智能设备功能的抽象,用于描述产品功能及参数。如果您需要的产品功能不在标准功能中时,您可以自定义功能。

功能说明

  • 添加自定义功能时,您需要考虑功能点、功能点 ID、功能点名称、标识名、数据类型、数据传输类型等属性。更多详情,请参考 产品功能
  • 为产品稳定性考虑,建议您的每个产品的标准功能点和自定义功能点累计不超过 40 个。若超过,请注意产品稳定性测试。
  • 每种功能都可以通过不同数据类型定义,涂鸦支持布尔型、数值型、枚举型、故障型、字符串型、透传型这 6 种数据类型。
    • 布尔型、数值型和枚举型是基础类型,大部分功能可通过这 3 种数据类型定义。
    • 故障型专门用于故障定义,便于在后台统计故障。
    • 字符串型和透传型用于较复杂功能,只有当其他类型无法满足需求时,才推荐使用。
  • 极速免开发产品不支持添加自定义功能。
  • 自定义功能支持在嵌入式开发过程中,针对 DP(Data Point)进行特殊配置,您可以按需选择。具体规则如下:
    • 被动上报:如果不是主动上报,必须下发指令才能上报,防止上报过于频繁。
    • 重复上报:表示该 DP 支持重复上报相同值。
    • DP 路由:用来控制蜂窝网络和蓝牙双协议 模组 的 DP 选择的接入协议。支持以下三种模式:
      • 不设置:优先选择蜂窝网络,当蜂窝网络断开后,选择蓝牙协议。
      • 蓝牙优先:优先选择蓝牙,当蓝牙未连接时,选择蜂窝网络。
      • 强制蓝牙:强制选择蓝牙,当蓝牙未连接时,面板需要有错误提示。
    • 无需上云:针对配置类型 DP,嵌入式 SDK 在配网时读取配置项,SDK 可以仅上报给 App 而无需上报到云端。

前提条件

您已经创建了至少一款产品。详细步骤,请参考 创建产品

操作步骤

  1. 登录 涂鸦开发者平台
  2. 产品列表 中,找到一款开发中的产品。
    自定义功能
  3. 查看产品的 自定义功能,按照需求,您可以:
    • 单击 添加功能 新增自定义功能。
    • 单击 删除 删除指定自定义功能。
    • 单击 编辑 编辑指定自定义功能。
      自定义功能

功能示例

布尔型

  • 适用功能:非真即假的二值型变量功能。

  • 功能示例:设备的开关、取暖器的童锁、电风扇的摇头、空气净化器的滤芯复位等功能,均可采用布尔型表示。

    自定义功能

数值型

  • 适用功能:可线性调节类型的数据。
  • 功能示例:
    • 温度调节,温度范围 20-40,间距为 1,单位为 ℃,表达含义为该产品可调节温度 20-40℃,每操作一次变化 1℃。

    • 预约功能,可预约 1、2、3……12 小时开关机,则可设置数值范围为:1-12,间距:1,单位:小时。

      自定义功能

枚举型

  • 适用功能:该功能下存在有限的自定义值集合。枚举值每输入一个,需要回车一次,枚举值将确认生成。

  • 功能示例:

    • 档位:低档,中档和高档。
    • 模式:舒适模式、睡眠模式、智能模式和节能模式。
    • 颜色:红色、蓝色、绿色、黑色。

    编辑功能时,枚举值支持小写拉丁字母、数字和下划线。按回车键后,枚举值自动生成。枚举值编码从 0 开始,在硬件联调中以枚举值编码进行传输。每个枚举值长度不超过 15 字符,最多支持定义 30 个枚举值。

    自定义功能

故障型

  • 适用功能:专门用于上报和统计故障的功能,后续此类型功能将被用于统计。

  • 功能示例:温度传感器故障、电机故障和高温故障等。

    故障型的数据格式为 bitmap 型,可支持多故障定义。故障型功能只支持数据上报,因此数据传输类型只能选择 只上报

    自定义功能

字符串型

  • 适用功能:以字符串形式传输的功能。如果以上 4 种数据类型不能满足产品功能定义,可约定通过字符串形式传输数据。

  • 注意事项:字符串型最大长度不超过 255 字节。

    自定义功能

透传型

  • 适用功能:以二进制形式透传的功能。一般不建议使用。针对其他功能类型无法满足的复杂功能,可采用透传型数据。

  • 注意事项:透传型数据的最大长度不超过 255 字节。

    自定义功能

下一步

完成自定义功能设置后,您可以考虑:

常见问题

更多详情,请参考 自定义功能常见问题