自定义功能
如果标准功能不能满足需求,可以使用自定义功能进行个性化定制。设置自定义功能时,需要为功能设定功能名称、功能标识、功能属性等。
功能名称
描述:自定义的功能名称。
格式要求:支持字母、数字、横线、汉字。
使用范围:用于管理中心的功能列表展示使用,也用于创建命令时的选择项展示。
功能标识
描述:自定义的功能 Code 值。
格式要求:支持大写字母、数字。
使用范围:用于创建命令时的选择项展示,也作为控制端和设备进行指令交互时的功能识别标记。
功能属性
每种功能都可以通过不同数据类型定义,物栖支持布尔型、数值型、枚举型、字符型,共计 4 种数据类型。
数据类型
类型 | 参数名 | 说明 | 示例 |
---|---|---|---|
布尔型 | bool | 非真即假的二值型变量。 | 开关功能的开或者关。 |
数值型 | value | 可线性调节类型的数据。 | 温度调节,温度范围 20-40℃。 |
枚举型 | enum | 自定义的有限集合值。 | 工作档位,低档/中档/高档。 |
字符型 | string | 以字符串形式传输。 | 文字消息 |
布尔型
适用功能:非真即假的二值型变量功能。
功能范例:设备的开关、电风扇的转头、取暖设备的童锁等功能,均可采用布尔型表示。
数值型
适用功能:可线性调节类型的数据。
功能范例:
空调温度调节,温度范围 20-40,间距为 1,单位为 ℃,表达含义为可调节温度 20-40℃,每操作一次变化 1℃。
定时功能,可定时 1、2、3……12 小时开关机,则可设置数值范围为:1-12,间距:1,单位:小时。
枚举型
- 适用功能:该功能下存在有限的自定义值集合。枚举值每输入一个,需要回车一次,枚举值将确认生成。
功能案例:
- 档位:低档,中档和高档。
- 模式:舒适模式、睡眠模式、智能模式和节能模式。
- 颜色:红色、蓝色、绿色、黑色。
- 格式要求:枚举值支持数字、字母、汉字、短横线,不超过 50 个字符。枚举值编码从 1 开始,在硬件联调中以枚举值编码进行传输。每个枚举值长度不超过 50 字符,最多支持定义 50 个枚举值。
字符型
- 适用功能:以字符形式传输的功能点。如果以上数据类型不能满足产品功能定义,可约定通过字符形式传输数据。
- 格式要求:需要定义字符的长度,定义范围为 1 至 1000 的整数。
其他参数
属性编号:
描述:系统自动生成的序号。
使用范围:用于管理中心展示使用,也作为控制端和设备进行指令交互时的功能属性识别标记。
属性标识:
描述:自定义的属性 Code 值。
格式要求:
使用范围:用于管理中心展示使用。
操作权限:
- 下发:数据只可从云端发送给设备。例如:功能为控制电扇开关,应勾选此项。
- 获取:数据通过云端发送给设备,也可以从设备传输给云端。例如:功能为电动车的电量统计,应勾选此项。
- 上报:数据只可从设备传输给云端。例如:功能为设备的 Wi-Fi 信号强弱上报,应勾选此项。
属性描述:
描述:对属性进行的详细描述。
使用范围:用于管理中心展示使用。