宠物喂食器产品功能定义

更新时间:2023-06-07 08:58:25下载pdf

本文介绍宠物喂食器产品的功能定义和部分功能的面板示意效果,定义后,相应功能需要抽象成不同的 DP(Data Point,功能),以实现数据传输和控制。有关功能定义更详细内容,请参考 产品功能

标准功能 DP

针对宠物喂食器,以公版产品定义为例,功能与 DP 的对应关系如下表所示。

DP ID 功能名称 标识符 数据传输类型 功能类型 功能属性 备注
1 喂食计划 meal_plan 可下发可上报 RAW 型 - 同步到设备端本地,即使设备离线,仍能正常喂食出粮,喂食计划最多支持 10 个
2 快速喂食 quick_feed 可下发可上报 布尔型 - 快速喂食功能,单击即下发。具体喂食份数由 MCU 决定默认参数
3 手动喂食 manual_feed 可下发可上报 数值型 数值范围:1-12
间距:1
倍数:0
单位:份
手动选择喂食份数
4 喂食状态 feed_state 只上报 枚举型 枚举值
standby
feeding
done
设备喂食状态,包括待机中,出粮中,出粮完成等,支持自定义喂食状态
5 单位转换 unit 可下发可上报 枚举型 枚举值
cup
oz
grid
用于切换食物单位
6 慢放喂食 slow_feed 可下发可上报 布尔型 - 使能开关,打开则设备执行慢放喂食
7 出粮校准 export_calibrate 可下发可上报 布尔型 - 出粮校准开关,单击下发,设备端自动执行,执行完成后,自动关闭
8 余粮校准 weight_calibrate 可下发可上报 布尔型 - 余粮校准开关,单击下发,设备端自动执行,执行完成后,自动关闭
9 恢复出厂 factory_reset 可下发可上报 布尔型 - 设备端进行恢复出厂设置开关
10 出粮校准状态 export_state 只上报 枚举型 枚举值
true
false
出粮校准状态上报
11 电池电量 battery_percentage 只上报 数值型 数值范围:0-100
间距:1
倍数:0
单位:%
在断电时,设备切换为电池供电模式,支持展示电池电量
12 充电状态 charge_state 只上报 布尔型 - 充电状态展示,充电中或者已充满
13 喂食盖状态 cover_state 只上报 枚举型 枚举值
on
off
上报喂食盖状态,App 端可做效果展示喂食盖开启情况
14 故障告警 fault 只上报 故障型 故障值
e1
e2
e3
展示故障告警信息
15 喂食结果上报 feed_report 只上报 数值型 数值范围:0-12
间距:1
倍数:0
单位:份
上报喂食结果,用于做数据统计使用
16 粮桶余粮 surplus_grain 只上报 数值型 数值范围:0-100
间距:1
倍数:0
单位:%
上报剩余百分比
17 余粮重量 weight 只上报 数值型 数值范围:0-10000
间距:1
倍数:0
单位:g
上报剩余重量,支持单位切换
18 语音播放次数 voice_times 可下发可上报 数值型 数值范围:0-10
间距:1
倍数:0
单位:次
设置播放次数,每次喂食前语音呼叫宠物过来进食
19 小夜灯 light 可下发可上报 布尔型 - 小夜灯开关
20 开关 switch 可下发可上报 布尔型 - 设备总开关

DP 详情说明

喂食计划

RAW 格式约定:按照 周期+时间+喂食份数+开关 来实现本地定时,具体如下:

  • 前 7 个比特位代表周一到周日,二进制转十六进制,占用一个字节,0 代表未设置,1 代表设置,如 0000001,表示周日生效,转换为 16 进制就是 01

  • 时间按照小时分钟格式,占用 2 个字节,分钟和小时,十进制转 16 进制,如 18:50,转为 16 进制为 1232

  • 喂食份数,占用 1 个字节,十进制转 16 进制,如 12,转为 16 进制为 0c

  • 开关,占用 1 个字节,00 表示关闭,01 表示开启

    上述举例,对于 App 端时间下发的结果为 0112320c01,表示周日,18:50,喂食 12 份,开启。

喂食结果上报

设备通过 喂食结果上报 DP 上报每次喂食份数,涂鸦云端会记录下每次喂食记录,并在 App 上呈现。

宠物喂食器产品功能定义

手动喂食与快速喂食

当 App 内未选中喂食份数时,单击 喂食 按钮下发的是 快速喂食 DP。当 App 内选中喂食份数时,单击 喂食 按钮下发的是 手动喂食 DP。

宠物喂食器产品功能定义

本地定时(喂食计划)

当添加 喂食计划 DP,不管是否勾选 云定时 功能时,此时启用的都为设备本地定时。

宠物喂食器产品功能定义 宠物喂食器产品功能定义

云定时

当未添加 喂食计划 DP,且勾选云定时功能时,此时启用的为云定时功能。目前云定时支持设置 手动喂食 功能。

宠物喂食器产品功能定义 宠物喂食器产品功能定义 宠物喂食器产品功能定义