mirror of
https://github.com/esphome/esphome-docs.git
synced 2025-01-12 20:10:50 +01:00
docs: Add airthings wave plus docs (#1081)
Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
This commit is contained in:
parent
82a7cf39d9
commit
926eb31d39
79
components/sensor/airthings_ble.rst
Normal file
79
components/sensor/airthings_ble.rst
Normal file
@ -0,0 +1,79 @@
|
|||||||
|
AirThings BLE Sensors
|
||||||
|
========================
|
||||||
|
|
||||||
|
.. seo::
|
||||||
|
:description: Instructions for setting up AirThings bluetooth-based sensors in ESPHome.
|
||||||
|
:keywords: AirThings, BLE, Bluetooth, Wave Plus
|
||||||
|
|
||||||
|
The ``airthings_wave_plus`` sensor platform lets you track the output of AirThings Bluetooth Low Energy devices.
|
||||||
|
|
||||||
|
This component will track radon, airborne chemicals, CO2, temperature and humidity and others depending on the device sensors.
|
||||||
|
|
||||||
|
Device Discovery
|
||||||
|
-----------------
|
||||||
|
|
||||||
|
AirThings devices can be found using the ``airthings_ble`` ble scanner.
|
||||||
|
|
||||||
|
To find out your device's MAC address, add the following to your ESPHome configuration:
|
||||||
|
|
||||||
|
.. code-block:: yaml
|
||||||
|
|
||||||
|
logger:
|
||||||
|
level: DEBUG # Required for the tracker to show the device
|
||||||
|
|
||||||
|
esp32_ble_tracker:
|
||||||
|
airthings_ble:
|
||||||
|
|
||||||
|
The device will then listen for nearby devices, and display a message like this one:
|
||||||
|
|
||||||
|
``
|
||||||
|
[D][airthings_ble:019]:
|
||||||
|
Found AirThings device Serial: 123456789 (MAC: 01:02:03:04:05:06)
|
||||||
|
``
|
||||||
|
|
||||||
|
Once the device is found, **remove the ``airthings_ble:`` device tracker** from your configuration and take note of the device MAC address, and use it when configuring a sensor below.
|
||||||
|
|
||||||
|
Supported Devices
|
||||||
|
-----------------
|
||||||
|
|
||||||
|
Wave Plus
|
||||||
|
*********
|
||||||
|
|
||||||
|
AirThings Wave Plus tracks radon (24h and long term), airborne chemicals, CO2, temperature, atmospheric pressure and humidity.
|
||||||
|
|
||||||
|
.. figure:: images/airthings_wave_plus.jpg
|
||||||
|
:align: center
|
||||||
|
:width: 60.0%
|
||||||
|
|
||||||
|
Configuration example:
|
||||||
|
|
||||||
|
.. code-block:: yaml
|
||||||
|
|
||||||
|
sensor:
|
||||||
|
- platform: airthings_wave_plus
|
||||||
|
ble_client_id: airthings01
|
||||||
|
update_interval: 5min # default
|
||||||
|
temperature:
|
||||||
|
name: "WavePlus Temperature"
|
||||||
|
radon:
|
||||||
|
name: "WavePlus Radon"
|
||||||
|
radon_long_term:
|
||||||
|
name: "WavePlus Radon Long Term"
|
||||||
|
pressure:
|
||||||
|
name: "WavePlus Pressure"
|
||||||
|
humidity:
|
||||||
|
name: "WavePlus Humidity"
|
||||||
|
co2:
|
||||||
|
name: "WavePlus CO2"
|
||||||
|
tvoc:
|
||||||
|
name: "WavePlus VOC"
|
||||||
|
|
||||||
|
ble_client:
|
||||||
|
- mac_address: 01:02:03:04:05:06
|
||||||
|
id: airthings01
|
||||||
|
|
||||||
|
esp32_ble_tracker:
|
||||||
|
|
||||||
|
.. note::
|
||||||
|
|
||||||
|
The sensor uses active polling of devices every 5 minutes as per the device reported internal refresh timeout.
|
BIN
components/sensor/images/airthings_wave_plus.jpg
Normal file
BIN
components/sensor/images/airthings_wave_plus.jpg
Normal file
Binary file not shown.
After Width: | Height: | Size: 48 KiB |
BIN
images/airthings_logo.png
Normal file
BIN
images/airthings_logo.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 22 KiB |
@ -163,6 +163,7 @@ Air Quality
|
|||||||
***********
|
***********
|
||||||
.. imgtable::
|
.. imgtable::
|
||||||
|
|
||||||
|
AirThings BLE, components/sensor/airthings_ble, airthings_logo.png, Radon, CO2, Volatile organics
|
||||||
CCS811, components/sensor/ccs811, ccs811.jpg, CO2 & Volatile organics
|
CCS811, components/sensor/ccs811, ccs811.jpg, CO2 & Volatile organics
|
||||||
HM3301, components/sensor/hm3301, hm3301.jpg, Particulate
|
HM3301, components/sensor/hm3301, hm3301.jpg, Particulate
|
||||||
MH-Z19, components/sensor/mhz19, mhz19.jpg, CO2 & Temperature
|
MH-Z19, components/sensor/mhz19, mhz19.jpg, CO2 & Temperature
|
||||||
@ -250,6 +251,7 @@ Environmental
|
|||||||
.. imgtable::
|
.. imgtable::
|
||||||
|
|
||||||
AHT10, components/sensor/aht10, aht10.jpg, Temperature & Humidity
|
AHT10, components/sensor/aht10, aht10.jpg, Temperature & Humidity
|
||||||
|
AirThings BLE, components/sensor/airthings_ble, airthings_logo.png, Temperature & Humidity & Pressure
|
||||||
AM2320, components/sensor/am2320, am2320.jpg, Temperature & Humidity
|
AM2320, components/sensor/am2320, am2320.jpg, Temperature & Humidity
|
||||||
BME280, components/sensor/bme280, bme280.jpg, Temperature & Humidity & Pressure
|
BME280, components/sensor/bme280, bme280.jpg, Temperature & Humidity & Pressure
|
||||||
BME680, components/sensor/bme680, bme680.jpg, Temperature & Humidity & Pressure & Gas
|
BME680, components/sensor/bme680, bme680.jpg, Temperature & Humidity & Pressure & Gas
|
||||||
|
Loading…
Reference in New Issue
Block a user