自定义功能

如果您需要的产品功能不在标准功能中时，您可以自定义功能。设置自定义功能时，需要您为功能自行设定 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 字节。

  

相关文档

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