AirThings BLE 传感器

airthings_wave_plus 和 airthings_wave_mini 传感器平台让您可以追踪 AirThings 蓝牙低功耗设备的输出。

此组件将追踪氡气、空气中化学物质、CO2、温度和湿度以及其他取决于设备传感器的数据。

设备发现

可以使用 airthings_ble ble 扫描器发现 AirThings 设备。

要找到设备的 MAC 地址，请将以下内容添加到您的 ESPHome 配置中：

logger:
  level: DEBUG # 跟踪器显示设备所必需

esp32_ble_tracker:
airthings_ble:

设备将监听附近的设备，并显示如下消息：

[D][airthings_ble:019]:
Found AirThings device Serial: 123456789 (MAC: XX:XX:XX:XX:XX:XX)

找到设备后，从配置中删除 airthings_ble 设备跟踪器，并记录设备 MAC 地址，在下面配置传感器时使用。

支持的设备

Airthings Wave Plus 传感器

AirThings Wave Plus 追踪氡气（24小时和长期）、空气中化学物质、CO2、温度、大气压力和湿度。

配置示例

sensor:
  - platform: airthings_wave_plus
    name: wave_plus
    ble_client_id: airthings01
    update_interval: 5min # 默认
    battery_update_interval: 24h # 默认
    temperature:
      name: "WavePlus 温度"
    radon:
      name: "WavePlus 氡气"
    radon_long_term:
      name: "WavePlus 长期氡气"
    pressure:
      name: "WavePlus 气压"
    humidity:
      name: "WavePlus 湿度"
    co2:
      name: "WavePlus CO2"
    tvoc:
      name: "WavePlus VOC"
    illuminance:
      name: "WavePlus 环境光"
    battery_voltage:
      name: "WavePlus 电池电压"

ble_client:
  - mac_address: XX:XX:XX:XX:XX:XX
    id: airthings01

esp32_ble_tracker:

Airthings Wave Mini 传感器

AirThings Wave Mini 追踪空气中化学物质、温度、压力和湿度。

配置示例：

sensor:
  - platform: airthings_wave_mini
    ble_client_id: airthingsmini
    update_interval: 5min # 默认
    battery_update_interval: 24h # 默认
    temperature:
      name: "WaveMini 温度"
    pressure:
      name: "WaveMini 气压"
    humidity:
      name: "WaveMini 湿度"
    tvoc:
      name: "WaveMini VOC"
    battery_voltage:
      name: "WaveMini 电池电压"

ble_client:
  - mac_address: XX:XX:XX:XX:XX:XX
    id: airthingsmini

esp32_ble_tracker:

NOTE

传感器按照设备报告的内部刷新超时，每 5 分钟主动轮询设备一次。

NOTE

电池电压报告默认为每 24 小时一次，以减少 BLE 流量（获取电池电压需要相当多的 BLE 命令/响应）；如果您希望更频繁地报告，请配置 battery_update_interval。主传感器 update_interval 控制整体轮询频率，因此将电池电压的间隔设置为更低的值将导致电池电压在每个轮询间隔报告一次。

Airthings Wave Radon (Gen 2) 传感器

AirThings Wave Radon (Gen 2) 追踪氡气（24小时和长期）、温度、大气压力和湿度。

NOTE

Wave Gen2 设备不支持 CO2 或 TVOC 传感器 - 只有氡气、温度、压力、湿度和照度可用。

配置变量

device_type (可选): 指定 AirThings Wave 设备的类型。默认为 WAVE_PLUS。
- WAVE_PLUS : 用于 AirThings Wave Plus 设备（支持包括 CO2 和 TVOC 在内的所有传感器）
- WAVE_GEN2 : 用于 AirThings Wave Radon Gen 2 设备（不支持 CO2 或 TVOC 传感器）

配置示例

sensor:
  - platform: airthings_wave_plus
    name: wave_gen2
    ble_client_id: airthings01
    device_type: WAVE_GEN2  # Wave Gen2 设备必需（默认为 WAVE_PLUS）
    update_interval: 5min # 默认
    battery_update_interval: 24h # 默认
    temperature:
      name: "WaveG2 温度"
    radon:
      name: "WaveG2 氡气"
    radon_long_term:
      name: "WaveG2 长期氡气"
    pressure:
      name: "WaveG2 气压"
    humidity:
      name: "WaveG2 湿度"
    illuminance:
      name: "WaveG2 环境光"
    battery_voltage:
      name: "WaveG2 电池电压"

ble_client:
  - mac_address: XX:XX:XX:XX:XX:XX
    id: airthings01

esp32_ble_tracker:

电池电量报告

如果您希望将”剩余电池寿命百分比”作为传感器报告，可以使用复制传感器组件。

以下示例基于标准碱性电池；如果您使用其他类型的电池，可能需要调整参考电压以获得正确的 0-100% 范围。电压参考值选择为与 AirThings 移动应用显示的 0-100% 范围紧密匹配。

sensor:
  - platform: airthings_wave_mini
    ble_client_id: airthingsmini
    battery_voltage:
      id: bv
      name: "WaveMini 电池电压"
  - platform: copy
    source_id: bv
    name: "WaveMini 电池电量"
    unit_of_measurement: "%"
    device_class: battery
    accuracy_decimals: 0
    filters:
      - calibrate_linear:
        - 2.7 -> 0
        - 4.5 -> 100

sensor:
  - platform: airthings_wave_plus
    ble_client_id: airthings01
    battery_voltage:
      id: bv
      name: "WavePlus 电池电压"
  - platform: copy
    source_id: bv
    name: "WavePlus 电池电量"
    unit_of_measurement: "%"
    device_class: battery
    accuracy_decimals: 0
    filters:
      - calibrate_linear:
        - 2.2 -> 0
        - 3.1 -> 100

另见

ESP32 蓝牙低功耗跟踪器集线器