简体中文
简体中文
English
联系我们
注册
登录
layout空间导航

自定义功能

更新时间:2022-03-02 01:52:38下载pdf

如果您需要的产品功能不在标准功能中时,您可以自定义功能。设置自定义功能时,需要您为功能自行设定 DPID、功能点、标识符、数据类型、数据传输类型等。本文重点介绍了功能点和数据类型。

说明:为产品稳定性考虑,建议您的每个产品的标准功能点和自定义功能点累计不超过40个。若超过,请注意产品稳定性测试。

功能点

功能点是对产品功能的抽象表示,是具体智能设备功能的抽象,用于描述产品功能及其参数。

  • 功能点 ID:功能点的编码。设备与云端的功能数据通过功能点 ID 进行传输。

  • 功能点名称:自定义的功能名称。

  • 标识名:功能点 Code 值,用于 App 显示功能名称的多语言管理。支持字母、数字和下划线,以字母开头。

  • 数据类型

    类型 参数名 说明 示例
    布尔型 bool 非真即假的二值型变量。 开关功能的开或者关。
    数值型 value 可线性调节类型的数据。 温度调节,温度范围 20-40℃。
    枚举型 enum 自定义的有限集合值。 工作档位,低档/中档/高档。
    故障型 fault 用于上报和统计故障的功能点,支持多故障,数据只上报。 温度传感器故障、电机故障和高温故障等。
    字符串型 string 以字符串形式传输的功能点。 -
    透传型 raw 以二进制形式透传的功能点。 -
  • 数据传输类型

    • 可下发可上报:指令数据可以发送给设备,设备数据可以传输给云端。
    • 只上报:数据只支持从设备传输给云端。
    • 只下发:数据只支持从云端发送给设备。

数据类型

每种功能都可以通过不同数据类型定义,涂鸦支持布尔型、数值型、枚举型、故障型、字符串型、透传型这 6 种数据类型。

  • 布尔型、数值型和枚举型是基础类型,大部分功能可通过这 3 种数据类型定义。
  • 故障型专门用于故障定义,便于在后台统计故障。
  • 字符串型和透传型用于较复杂功能,只有当其他类型无法满足需求时,才推荐使用。

布尔型

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

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

    自定义功能

数值型

  • 适用功能:可线性调节类型的数据。

  • 功能案例:

    • 温度调节,温度范围 20-40,间距为 1,单位为 ℃,表达含义为该产品可调节温度 20-40℃,每操作一次变化 1℃。

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

      自定义功能

枚举型

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

  • 功能案例:

    • 档位:低档,中档和高档。
    • 模式:舒适模式、睡眠模式、智能模式和节能模式。
    • 颜色:红色、蓝色、绿色、黑色。
  • 注意事项:编辑功能点时,枚举值支持字母、数字和下划线。按回车键后,枚举值自动生成。枚举值编码从 0 开始,在硬件联调中以枚举值编码进行传输。每个枚举值长度不超过 15 字符,最多支持定义 10 个枚举值。

    自定义功能

故障型

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

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

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

    自定义功能

字符串型

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

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

    自定义功能

透传型

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

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

    自定义功能

相关文档

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