该内容对您有帮助吗?
是否更新时间:2022-03-02 01:52:38下载pdf
如果您需要的产品功能不在标准功能中时,您可以自定义功能。设置自定义功能时,需要您为功能自行设定 DPID、功能点、标识符、数据类型、数据传输类型等。本文重点介绍了功能点和数据类型。
说明:为产品稳定性考虑,建议您的每个产品的标准功能点和自定义功能点累计不超过40个。若超过,请注意产品稳定性测试。
功能点是对产品功能的抽象表示,是具体智能设备功能的抽象,用于描述产品功能及其参数。
功能点 ID:功能点的编码。设备与云端的功能数据通过功能点 ID 进行传输。
功能点名称:自定义的功能名称。
标识名:功能点 Code 值,用于 App 显示功能名称的多语言管理。支持字母、数字和下划线,以字母开头。
数据类型:
类型 | 参数名 | 说明 | 示例 |
---|---|---|---|
布尔型 | bool | 非真即假的二值型变量。 | 开关功能的开或者关。 |
数值型 | value | 可线性调节类型的数据。 | 温度调节,温度范围 20-40℃。 |
枚举型 | enum | 自定义的有限集合值。 | 工作档位,低档/中档/高档。 |
故障型 | fault | 用于上报和统计故障的功能点,支持多故障,数据只上报。 | 温度传感器故障、电机故障和高温故障等。 |
字符串型 | string | 以字符串形式传输的功能点。 | - |
透传型 | raw | 以二进制形式透传的功能点。 | - |
数据传输类型:
每种功能都可以通过不同数据类型定义,涂鸦支持布尔型、数值型、枚举型、故障型、字符串型、透传型这 6 种数据类型。
适用功能:非真即假的二值型变量功能。
功能范例:设备的开关、取暖器的童锁、电风扇的摇头、空气净化器的滤芯复位等功能,均可采用布尔型表示。
适用功能:可线性调节类型的数据。
功能案例:
温度调节,温度范围 20-40,间距为 1,单位为 ℃,表达含义为该产品可调节温度 20-40℃,每操作一次变化 1℃。
预约功能,可预约 1、2、3……12 小时开关机,则可设置数值范围为:1-12,间距:1,单位:小时。
适用功能:该功能下存在有限的自定义值集合。枚举值每输入一个,需要回车一次,枚举值将确认生成。
功能案例:
注意事项:编辑功能点时,枚举值支持字母、数字和下划线。按回车键后,枚举值自动生成。枚举值编码从 0 开始,在硬件联调中以枚举值编码进行传输。每个枚举值长度不超过 15 字符,最多支持定义 10 个枚举值。
适用功能:专门用于上报和统计故障的功能点,后续此类型功能将被用于统计。
功能案例:温度传感器故障、电机故障和高温故障等。
注意事项:故障型的数据格式为 bitmap 型,可支持多故障定义。故障型功能只支持数据上报,因此数据传输类型只能选择 只上报。
适用功能:以字符串形式传输的功能点。如果以上 4 种数据类型不能满足产品功能定义,可约定通过字符串形式传输数据。
注意事项:字符串型最大长度不超过 255 字节。
适用功能:以二进制形式透传的功能点。一般不建议使用,上述功能点无法满足的复杂功能,可采用透传型数据。
注意事项:透传型数据的最大长度不超过 255 字节。
更多详情,请参考 自定义功能常见问题。
该内容对您有帮助吗?
是否该内容对您有帮助吗?
是否