跳转到内容
ESPHome - 让智能家居更简单2026.7.0

Mopeka Pro Check BLE 传感器

mopeka_pro_check 传感器平台允许您使用 Esp32 Ble Tracker 跟踪 Mopeka Pro Check LP、Mopeka Pro Plus、Mopeka Pro Universal 或 Lippert Propane Tank 传感器、蓝牙低功耗 设备的输出。此组件将在传感器每次发送 BLE 广播时跟踪 设备的罐量、距离、温度、电池百分比和传感器读数质量。还有额外的配置选项 来控制低质量读数的处理和报告读数质量问题。

WARNING

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

  • Mopeka Pro Check 设备
  • Mopeka Pro Plus 设备
  • Mopeka Pro Check Universal 传感器
  • Lippert Propane Tank Sensor，部件号 2021130655

传感器仅针对丙烷校准。

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

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

不支持原始 Mopeka Check 传感器。

通过 BLE 的 Mopeka Pro Check LP

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


sensor:
  # 使用 20lb 垂直丙烷罐的示例。
  - 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 (可选): 罐传感器的满百分比。如果 因质量问题而忽略读取，此传感器将不会更新。

    • 来自 Sensor 的所有选项。

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

    • 来自 Sensor 的所有选项。

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

    • 来自 Sensor 的所有选项。

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

    • 来自 Sensor 的所有选项。

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

    • 来自 Sensor 的所有选项。

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

    • 来自 Sensor 的所有选项。

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

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

罐类型

Section titled “罐类型”

当前支持的罐类型有：

  • 20LB_V - 20 LB 垂直罐
  • 30LB_V - 30 LB 垂直罐
  • 40LB_V - 40 LB 垂直罐
  • EUROPE_6KG - 6kg 垂直罐
  • EUROPE_11KG - 11kg 垂直罐
  • EUROPE_14KG - 14kg 垂直罐
  • 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 “参见”