自定义功能

如果标准功能不能满足需求,可以使用自定义功能进行个性化定制。设置自定义功能时,需要为功能设定功能名称、功能标识、功能属性等。

功能名称

描述:自定义的功能名称。

格式要求:支持字母、数字、横线、汉字。

使用范围:用于管理中心的功能列表展示使用,也用于创建命令时的选择项展示。

功能标识

描述:自定义的功能 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 信号强弱上报,应勾选此项。
  • 属性描述

    描述:对属性进行的详细描述。

    使用范围:用于管理中心展示使用。

results matching ""

    No results matching ""