PetLibro宠物喂食器OneRFIDFeeder的LED矩阵显示控制功能解析

PetLibro宠物喂食器OneRFIDFeeder的LED矩阵显示控制功能解析

petlibro Petlibro | Home Assistant integration 项目地址: https://gitcode.com/gh_mirrors/pe/petlibro

功能概述

PetLibro OneRFIDFeeder智能宠物喂食器(型号PLAF301)配备了一个LED矩阵显示屏，可以显示多种预设图案和自定义文字。本文将深入解析该功能的实现原理和技术细节。

显示开关控制

通过API接口可以实现LED矩阵显示屏的开关控制：

• 关闭显示的请求示例：

{
  "deviceSn": "AF06013AF056214A2",
  "screenDisplayAgingType": 1,
  "screenDisplayStartTime": null,
  "screenDisplayEndTime": null,
  "screenDisplaySwitch": false
}

• 开启显示的请求示例：

{
  "deviceSn": "AF06013AF056214A2",
  "screenDisplayAgingType": 1,
  "screenDisplayStartTime": null,
  "screenDisplayEndTime": null,
  "screenDisplaySwitch": true
}

API接口地址为设备设置更新接口，返回数据格式统一为：

{
  "code": 0,
  "msg": null,
  "data": null
}

显示内容控制

除了开关控制外，还可以设置显示内容，包括预设图案和自定义文字：

预设图案显示

设备内置了多种图案，通过不同的ID调用：

• ID 5：心形图案
• ID 7：猫图案
• ID 6：狗图案
• ID 8：麋鹿图案

请求示例：

{
  "deviceSn": "AF06013AF056214A2",
  "screenDisplayId": 5,
  "screenDisplayMatrix": null,
  "screenLetter": "HELLO"
}

自定义文字显示

当需要显示自定义文字时，将screenDisplayId设为null，并在screenLetter字段中输入文字：

{
  "deviceSn": "AF06013AF056214A2",
  "screenDisplayId": null,
  "screenDisplayMatrix": null,
  "screenLetter": "自定义文字"
}

文字限制条件：

1. 最大长度：20个字符
2. 仅支持字母、数字和空格
3. 不能以单独的空格开头
4. 最少需要1个字符

实现建议

在智能家居集成中，可以设计以下控制元素：

1. 显示开关按钮：提供"开启显示"和"关闭显示"两个独立按钮
2. 图案选择器：下拉菜单选择预设图案
3. 文字输入框：用于输入自定义文字，带长度和字符限制验证

技术实现

在实际代码实现中，可以创建三个按钮实体：

PetLibroButtonEntityDescription[OneRFIDSmartFeeder](
    key="manual_lid_open",
    translation_key="manual_lid_open",
    set_fn=lambda device: device.set_manual_lid_open(),
    name="Open Lid"
),
PetLibroButtonEntityDescription[OneRFIDSmartFeeder](
    key="display_matrix_on",
    translation_key="display_matrix_on",
    set_fn=lambda device: device.set_display_matrix_on(),
    name="Turn On Display"
),
PetLibroButtonEntityDescription[OneRFIDSmartFeeder](
    key="display_matrix_off",
    translation_key="display_matrix_off",
    set_fn=lambda device: device.set_display_matrix_off(),
    name="Turn Off Display"
)

总结

PetLibro OneRFIDFeeder的LED矩阵显示功能提供了丰富的自定义选项，既可以通过API精确控制显示开关，又能灵活设置显示内容。这一功能不仅增加了产品的趣味性，也为宠物主人提供了更多个性化表达的方式。通过合理的接口设计和参数验证，可以确保功能稳定可靠地运行。

petlibro Petlibro | Home Assistant integration 项目地址: https://gitcode.com/gh_mirrors/pe/petlibro