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>

components/sensor/mopeka_pro_check.rst

@@ -19,6 +19,9 @@ sensor sends out a BLE broadcast.
       + Mopeka Pro Check devices
       + Mopeka Pro Plus devices
       + 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_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
 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:
 
 .. 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
 ``sensor.mopeka_pro_check`` platform entry like in the configuration example at the top.

components/sensor/mopeka_std_check.rst

@@ -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`

index.rst

@@ -214,6 +214,7 @@ Bluetooth Low Energy (BLE)
     BLE RSSI, components/sensor/ble_rssi, bluetooth.svg
     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 Standard Check LP, components/sensor/mopeka_std_check, mopeka_std_check.jpg, tank level
     RuuviTag, components/sensor/ruuvitag, ruuvitag.jpg, Temperature & Humidity & Accelerometer
     Xiaomi BLE, components/sensor/xiaomi_ble, xiaomi_mijia_logo.jpg, Various