跳转到内容
ESPHome - 智能家居，简单易用

Mopeka Pro Check BLE 传感器

mopeka_pro_check 传感器平台允许您通过 Esp32 Ble Tracker 跟踪 Mopeka Pro Check LP、Mopeka Pro Plus、Mopeka Pro Universal 或 Lippert 丙烷罐传感器的输出，这些是蓝牙低功耗设备。此组件 每次传感器发送 BLE 广播时都会跟踪设备的罐体液位、距离、温度、电池百分比和传感器读取质量。还有其他配置选项 用于控制低质量读数的处理和报告读取质量问题。

WARNING

此传感器组件仅支持以下传感器：

  • Mopeka Pro Check 设备
  • Mopeka Pro Plus 设备
  • Mopeka Pro Check Universal 传感器
  • Lippert 丙烷罐传感器，零件号 2021130655

传感器仅针对丙烷进行校准。

有关原始 Mopeka Check 传感器的支持，请参阅 Mopeka Std Check。

Mopeka Pro Check LP 通过 BLE。
Lippert™ 丙烷罐传感器

原始 Mopeka Check 传感器不受支持。

Mopeka Pro Check LP 通过 BLE

Section titled “Mopeka Pro Check LP 通过 BLE”
esp32_ble_tracker:


sensor:
  # 示例：使用 20 磅立式丙烷罐。
  - platform: mopeka_pro_check
    mac_address: XX:XX:XX:XX:XX:XX
    tank_type: 20LB_V
    temperature:
        name: "Propane test temp"
    level:
        name: "Propane test level"
    distance:
        name: "Propane test distance"
    battery_level:
        name: "Propane test battery level"
    signal_quality:
        name: "Propane test read quality"
    ignored_reads:
        name: "Propane test ignored reads"
    # 报告所有等于或大于指定信号质量的传感器距离/液位数据
    minimum_signal_quality: "LOW"


  # 自定义示例 - 用户定义的空/满点
  - platform: mopeka_pro_check
    mac_address: XX:XX:XX:XX:XX:XX
    tank_type: CUSTOM
    custom_distance_full: 40cm
    custom_distance_empty: 10mm
    temperature:
        name: "Propane c test temp"
    level:
        name: "Propane c test level"
    distance:
        name: "Propane c test distance"
    battery_level:
        name: "Propane c test battery level"

配置变量

Section titled “配置变量”

  • mac_address (必需, MAC 地址): Mopeka/Lippert 设备的 MAC 地址。

  • tank_type (必需): 传感器测量的罐体类型。见下文。

  • custom_distance_full (可选): 当罐体应被视为满（100%）时 距离传感器的读数。仅在 tank_type = CUSTOM 时使用。

  • custom_distance_empty (可选): 当罐体应被视为空（0%）时 距离传感器的读数。仅在 tank_type = CUSTOM 时使用。

  • level (可选): 罐体传感器的满百分比。如果 读数因质量问题被忽略，此传感器将不会更新。

  • distance (可选): 传感器的液体原始距离/深度，单位 mm。 如果读数因质量问题被忽略，此传感器将不会更新。

  • temperature (可选): 温度传感器的信息。 此温度位于传感器上，未校准到环境温度。

  • battery_level (可选): 电池百分比传感器的信息。 传感器使用标准 CR2032 电池。

  • signal_quality (可选): 读取质量传感器的信息。

  • ignored_reads (可选): 指示连续忽略读取次数的诊断传感器。 每次读数等于或大于配置的忽略质量时，此值重置为零。 只有距离和液位传感器不会报告。

  • minimum_signal_quality (可选, 枚举): 传感器的每个报告 都指示传感器计算距离的质量或置信度。物理 传感器放置、罐体材料或质量或其他因素可能会影响 传感器自信读取的能力。随着质量降低，距离读数的 准确性可能与预期不符。此值允许配置 应该评估/报告距离的最低质量级别。 可接受的值：

    • HIGH : 高质量
    • MEDIUM : 中等质量（默认值）
    • LOW : 低质量
    • ZERO : 零质量

罐体类型

Section titled “罐体类型”

当前支持的罐体类型有：

  • 20LB_V - 20 磅立式罐
  • 30LB_V - 30 磅立式罐
  • 40LB_V - 40 磅立式罐
  • EUROPE_6KG - 6 公斤立式罐
  • EUROPE_11KG - 11 公斤立式罐
  • EUROPE_14KG - 14 公斤立式罐
  • CUSTOM - 允许您定义自己的满和空点

设置设备

Section titled “设置设备”

要设置传感器设备，您首先需要找到 MAC 地址，以便 ESPHome 能够识别它。首先，使用 esp32_ble_tracker 和 mopeka_ble 组件创建一个简单的配置，如下所示：

esp32_ble_tracker:


mopeka_ble:

上传后，ESP32 将立即尝试扫描 BLE 设备。按住同步按钮以识别设备。 或者设置配置标志 show_sensors_without_sync: true 以查看所有设备。 对于找到的所有传感器，mopeka_ble 组件将打印如下消息：

[20:43:26][I][mopeka_ble:074]: MOPEKA PRO (NRF52) SENSOR FOUND: XX:XX:XX:XX:XX:XX

然后将地址（XX:XX:XX:XX:XX:XX）复制到新的 sensor.mopeka_pro_check 平台条目中，如顶部的配置示例所示。

NOTE

ESPHome Mopeka Pro Check BLE 组件被动监听 Mopeka/Lippert 设备自行发送的数据包。 因此，ESPHome 对设备的电池寿命没有影响。

另见

Section titled “另见”