Add Mopeka standard to next docs. (#2624)

Co-authored-by: Your Name <you@example.com>
Co-authored-by: H. Árkosi Róbert <robreg@zsurob.hu>
Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
This commit is contained in:
Fabian 2023-02-21 22:49:15 +01:00 committed by GitHub
parent e710582826
commit 52b2e857ea
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
5 changed files with 156 additions and 1 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 6.4 KiB

View File

@ -19,6 +19,9 @@ sensor sends out a BLE broadcast.
+ Mopeka Pro Check devices + Mopeka Pro Check devices
+ Mopeka Pro Plus devices + Mopeka Pro Plus devices
+ Lippert Propane Tank Sensor, part number 2021130655 + Lippert Propane Tank Sensor, part number 2021130655
See :doc:`/components/sensor/mopeka_std_check` for original Mopeka Check sensors support.
(images/mopeka_pro_check.jpg) (images/mopeka_pro_check.jpg)
(images/mopeka_pro_check_lippert.jpg) (images/mopeka_pro_check_lippert.jpg)
@ -119,11 +122,12 @@ and the ``mopeka_ble`` component like so:
After uploading, the ESP32 will immediately try to scan for BLE devices. For Mopeka Pro After uploading, the ESP32 will immediately try to scan for BLE devices. For Mopeka Pro
Check / Pro Plus / Lippert devices you must press and hold the green sync button for it to be identified. Check / Pro Plus / Lippert devices you must press and hold the green sync button for it to be identified.
Or alternativly set the configuration flag ``show_sensors_without_sync: true`` to see all devices.
For all sensors found the ``mopeka_ble`` component will print a message like this one: For all sensors found the ``mopeka_ble`` component will print a message like this one:
.. code:: .. code::
[20:43:26][I][mopeka_ble:040]: SENSOR FOUND: D3:75:F2:DC:16:91 [20:43:26][I][mopeka_ble:074]: MOPEKA PRO (NRF52) SENSOR FOUND: D3:75:F2:DC:16:91
Then just copy the address (``D3:75:F2:DC:16:91``) into a new Then just copy the address (``D3:75:F2:DC:16:91``) into a new
``sensor.mopeka_pro_check`` platform entry like in the configuration example at the top. ``sensor.mopeka_pro_check`` platform entry like in the configuration example at the top.

View File

@ -0,0 +1,150 @@
Mopeka Standard Check BLE Sensor
================================
.. seo::
:description: Instructions for setting up Mopeka Standard Check bluetooth-based sensors in ESPHome.
:image: mopeka_std_check.jpg
:keywords: Mopeka, Mopeka Standard Check, Mopeka Std Check, BLE, Bluetooth
The ``mopeka_std_check`` sensor platform lets you track the output of Mopeka
Standard Check LP Bluetooth Low Energy devices using the
:doc:`/components/esp32_ble_tracker`. This component will track the tank level,
distance, temperature, and battery percentage of a Mopeka Standard Check LP BLE
device every time the sensor sends out a BLE broadcast.
.. warning::
This sensor component only supports the Mopeka Standard Check devices.
See :doc:`/components/sensor/mopeka_pro_check` for Mopeka Pro Check sensors support.
.. figure:: images/mopeka_std_check.jpg
:align: center
Mopeka Std Check LP over BLE.
.. code-block:: yaml
esp32_ble_tracker:
sensor:
# Example using 11kg 100% propane tank.
- platform: mopeka_std_check
mac_address: D3:75:F2:DC:16:91
tank_type: Europe_11kg
temperature:
name: "Propane test temp"
level:
name: "Propane test level"
distance:
name: "Propane test distance"
battery_level:
name: "Propane test battery level"
# Custom example - user defined empty / full points and 80% butane and 20% propane.
- platform: mopeka_std_check
mac_address: D3:75:F2:DC:16:91
tank_type: CUSTOM
custom_distance_full: 40cm
custom_distance_empty: 32mm
propane_butane_mix: 20%
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"
Configuration variables:
------------------------
- **mac_address** (**Required**, MAC Address): The MAC address of the Mopeka
device.
- **tank_type** (**Required**): The tank type the sensor is measuring. See below.
- **custom_distance_full** (*Optional*): distance sensor will read when it should be
considered full (100%). This is only used when tank_type = CUSTOM
- **custom_distance_empty** (*Optional*): distance sensor will read when it should be
considered empty (0%). This is only used when tank_type = CUSTOM
- **propane_butane_mix** (*Optional*): Mixture of propane and butane.
- 100% - (*default*) 100% Propane
- 80% - 80% Propane and 20% Butane
- 20% - 20% Propane and 80% Butane
- 0% - 100% Butane
- **level** (*Optional*): The percentage of full for the tank sensor
- All options from :ref:`Sensor <config-sensor>`.
- **distance** (*Optional*): The raw distance/depth of the liquid for the sensor in mm.
- All options from :ref:`Sensor <config-sensor>`.
- **temperature** (*Optional*): The information for the temperature sensor.
This temperature is on the sensor and is not calibrated to ambient temperature.
- All options from :ref:`Sensor <config-sensor>`.
- **battery_level** (*Optional*): The information for the battery percentage
sensor. Sensor uses a standard CR2032 battery.
- All options from :ref:`Sensor <config-sensor>`.
Tank Types
----------
Currently supported Tank types are:
- ``NORTH_AMERICA_20LB_VERTICAL`` - 20 LB vertical tank
- ``NORTH_AMERICA_30LB_VERTICAL`` - 30 LB vertical tank
- ``NORTH_AMERICA_40LB_VERTICAL`` - 40 LB vertical tank
- ``EUROPE_6KG`` - 6kg vertical tank
- ``EUROPE_11KG`` - 11kg vertical tank
- ``EUROPE_14KG`` - 14kg vertical tank
- ``CUSTOM`` - Allows you to define your own full and empty points
Setting Up Devices
------------------
To set up Mopeka Standard Check devices you first need to find their MAC Address so that
ESPHome can identify them. So first, create a simple configuration with the ``esp32_ble_tracker``
and the ``mopeka_ble`` component like so:
.. code-block:: yaml
esp32_ble_tracker:
mopeka_ble:
After uploading, the ESP32 will immediately try to scan for BLE devices. For Mopeka Standard devices you must press and hold the green sync button for it to be identified.
Or alternativly set the configuration flag ``show_sensors_without_sync: true`` to see all devices.
For all sensors found the ``mopeka_ble`` component will print a message like this one:
.. code::
[20:43:26][I][mopeka_ble:056]: MOPEKA STD (CC2540) SENSOR FOUND: D3:75:F2:DC:16:91
Then just copy the address (``D3:75:F2:DC:16:91``) into a new
``sensor.mopeka_std_check`` platform entry like in the configuration example at the top.
.. note::
The ESPHome Mopeka Standard Check BLE integration listens passively to packets the Mopeka device sends by itself.
ESPHome therefore has no impact on the battery life of the device.
See Also
--------
- :doc:`/components/esp32_ble_tracker`
- :doc:`/components/sensor/index`
- :apiref:`mopeka_std_check/mopeka_std_check.h`
- :ghedit:`Edit`

BIN
images/mopeka_std_check.jpg Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 6.4 KiB

View File

@ -214,6 +214,7 @@ Bluetooth Low Energy (BLE)
BLE RSSI, components/sensor/ble_rssi, bluetooth.svg BLE RSSI, components/sensor/ble_rssi, bluetooth.svg
Inkbird IBS-TH1 Mini, components/sensor/inkbird_ibsth1_mini, inkbird_isbth1_mini.jpg, Temperature & Humidity Inkbird IBS-TH1 Mini, components/sensor/inkbird_ibsth1_mini, inkbird_isbth1_mini.jpg, Temperature & Humidity
Mopeka Pro Check LP, components/sensor/mopeka_pro_check, mopeka_pro_check.jpg, tank level Mopeka Pro Check LP, components/sensor/mopeka_pro_check, mopeka_pro_check.jpg, tank level
Mopeka Standard Check LP, components/sensor/mopeka_std_check, mopeka_std_check.jpg, tank level
RuuviTag, components/sensor/ruuvitag, ruuvitag.jpg, Temperature & Humidity & Accelerometer RuuviTag, components/sensor/ruuvitag, ruuvitag.jpg, Temperature & Humidity & Accelerometer
Xiaomi BLE, components/sensor/xiaomi_ble, xiaomi_mijia_logo.jpg, Various Xiaomi BLE, components/sensor/xiaomi_ble, xiaomi_mijia_logo.jpg, Various