BLE Monitor集成新增Garnet SeeLevel水箱液位传感器支持

概述

BLE Monitor项目最新版本12.10.0中新增了对Garnet SeeLevel II 709-BTP3水箱液位监测系统的支持。这是一款专为房车(RV)和露营车设计的超声波水箱监测系统，能够准确测量淡水箱、灰水箱和黑水箱的液位百分比，同时还能监测系统电池电压。

技术背景

Garnet SeeLevel系统采用蓝牙低功耗(BLE)广播方式传输数据，设备作为广播者持续循环发送各传感器的数据。与常见BLE设备不同，它不需要建立连接即可读取数据，这使得集成更加简单可靠。

该系统特别适合房车使用场景，其超声波传感器能够穿透黑水箱中的固体物质，解决了传统液位传感器在黑水箱监测中不准确的问题。这是目前市场上少数能可靠监测黑水箱液位的解决方案之一。

数据协议解析

设备广播数据采用制造商特定数据结构，关键特征包括：

• 制造商ID：305 (Cypress Semiconductor)
• 数据长度：17字节
• 数据结构：
  • 字节0-2：设备唯一ID(硬件分配)
  • 字节3：传感器编号(0=淡水,1=黑水,2=灰水,13=电池电压)
  • 字节4-6：传感器数据(ASCII字符串表示)
  • 字节7-9：传感器体积(通常为"000")
  • 字节10-12：传感器总量(通常为"000")
  • 字节13：报警状态("0"或"1")

电池电压数据以10倍值传输(如"132"表示13.2V)，水箱液位以百分比表示(如" 81"表示81%)。

集成实现

BLE Monitor项目通过以下方式实现了对该设备的支持：

1. 在Oras解析器中新增Garnet SeeLevel专用处理逻辑
2. 添加了四种传感器类型：
   • 淡水箱液位传感器(百分比)
   • 灰水箱液位传感器(百分比)
   • 黑水箱液位传感器(百分比)
   • 电池电压传感器(伏特)
3. 实现了数据有效性检查，过滤无效数据
4. 添加了报警状态二进制传感器

使用注意事项

1. 设备广播频率较高，建议在HA中设置适当的更新间隔
2. 当传感器处于配置模式或故障状态时，可能发送非数值数据(如"STA")，集成已处理此类情况
3. 目前仅支持709-BTP3型号的4个基础传感器(3个水箱+电池)
4. 即将推出的新版BLE模块将支持最多7个监测点，未来将考虑扩展支持

技术优势

相比传统房车液位监测方案，Garnet SeeLevel系统具有以下优势：

1. 超声波技术不受水箱内物质影响，特别是黑水箱中的固体残留物
2. 非接触式测量，避免传感器污染
3. BLE无线传输，安装维护简便
4. 数据准确可靠，解决了房车液位监测的痛点

总结

BLE Monitor对Garnet SeeLevel系统的支持为房车爱好者提供了专业的液位监测解决方案，特别是解决了黑水箱监测这一长期存在的技术难题。该集成经过充分测试，能够稳定可靠地工作，为智能房车系统提供了重要的基础数据。