diff --git a/changelog/2022.8.0.rst b/changelog/2022.8.0.rst index e43362797..0ffbd59bc 100644 --- a/changelog/2022.8.0.rst +++ b/changelog/2022.8.0.rst @@ -63,6 +63,11 @@ Release 2022.8.2 - September 6 - Ignore NaN states in the integration component :esphomepr:`3767` by :ghuser:`anatoly-savchenkov` - Update modbus_controller.cpp :esphomepr:`3768` by :ghuser:`Avirsaam` +Release 2022.8.3 - September 6 +------------------------------ + +- Fix HA addon auth using HA credentials :esphomepr:`3758` by :ghuser:`jesserockz` + Full list of changes -------------------- diff --git a/components/bluetooth_proxy.rst b/components/bluetooth_proxy.rst index 39f6c1c47..e9cb2ef4f 100644 --- a/components/bluetooth_proxy.rst +++ b/components/bluetooth_proxy.rst @@ -14,6 +14,10 @@ If you're looking to create a device that is just a Bluetooth Proxy, see our `Bl The Bluetooth proxy depends on :doc:`esp32_ble_tracker` so make sure to add that to your configuration. +.. note:: + + Bluetooth proxy requires Home Assistant 2022.9 or later. + .. code-block:: bluetooth_proxy: diff --git a/components/climate/index.rst b/components/climate/index.rst index dd9c13aee..927e217ad 100644 --- a/components/climate/index.rst +++ b/components/climate/index.rst @@ -27,9 +27,9 @@ All climate platforms in ESPHome inherit from the climate configuration schema. climate: - platform: ... visual: - min_temperature: 18 °C - max_temperature: 25 °C - temperature_step: 0.1 °C + min_temperature: 18 + max_temperature: 25 + temperature_step: 0.1 Configuration variables: diff --git a/components/cover/feedback.rst b/components/cover/feedback.rst index 4f5fd4607..e82836d1f 100644 --- a/components/cover/feedback.rst +++ b/components/cover/feedback.rst @@ -68,7 +68,7 @@ Movement Sensors If movement feedback is available, the cover no longer operates in *optimistic mode* (assuming that movement starts as soon as an action is triggered) and can also react to commands issued to cover from an external control and still -keep states in sync (useful for "smartization" of and existing cover). +keep states in sync (useful for "smartization" of an existing cover). When there are no specific endstop sensors, and if the cover has builtin endstops and no external control logic, these movement sensors can optionally be use to infer the endstop state. diff --git a/components/esp32_ble_tracker.rst b/components/esp32_ble_tracker.rst index eff6bb3bd..46725292c 100644 --- a/components/esp32_ble_tracker.rst +++ b/components/esp32_ble_tracker.rst @@ -72,7 +72,8 @@ Configuration variables: impact on the device but can be used to debug the BLE stack. Defaults to ``5min``. - **active** (*Optional*, boolean): Whether to actively send scan requests to request more data after having received an advertising packet. With some devices this is necessary to receive all data, - but also drains those devices' power a (tiny) bit more. Defaults to ``true``. + but also drains those devices' power a bit more. Some devices don't need this, in that case + you can save power and RF pollution by setting it to ``false``. Defaults to ``true``. - **continuous** (*Optional*, boolean): Whether to scan continuously (forever) or to only scan when asked to start a scan (with start_scan action). Defaults to ``true``. @@ -256,7 +257,16 @@ Stops the bluetooth scanning. It can be started again with the above start scan See Also -------- -- :doc:`binary_sensor/ble_presence` +- :doc:`text_sensor/ble_scanner` +- :doc:`sensor/ble_rssi` +- :doc:`sensor/b_parasite` +- :doc:`sensor/xiaomi_ble` +- :doc:`sensor/xiaomi_miscale` +- :doc:`sensor/inkbird_ibsth1_mini` +- :doc:`sensor/mopeka_pro_check` +- :doc:`sensor/ruuvitag` +- :doc:`ble_client` +- :doc:`bluetooth_proxy` - :apiref:`esp32_ble_tracker/esp32_ble_tracker.h` - `ESP32 BLE for Arduino `__ by `Neil Kolban `__. - :ghedit:`Edit` diff --git a/components/sensor/xiaomi_ble.rst b/components/sensor/xiaomi_ble.rst index effa1d39c..22bd21d12 100644 --- a/components/sensor/xiaomi_ble.rst +++ b/components/sensor/xiaomi_ble.rst @@ -6,7 +6,7 @@ Xiaomi Mijia BLE Sensors :image: xiaomi_mijia_logo.jpg :keywords: Xiaomi, Mi Home, Mijia, BLE, Bluetooth, HHCCJCY01, GCLS002, HHCCPOT002, LYWSDCGQ, LYWSD02, CGG1, LYWSD03MMC, CGD1, JQJCY01YM, MUE4094RT, WX08ZM, MHO, C401, MHOC401 -The ``xiaomi_ble`` sensor platform lets you track the output of Xiaomi Bluetooth Low Energy devices using the :doc:`/components/esp32_ble_tracker`. This component will track, for example, the temperature, humidity, moisture, conductivity, illuminance, formaldehyde, mosquito tablet and battery level of the device every time the sensor sends out a BLE broadcast. Contrary to other implementations, ``xiaomi_ble`` listens passively to advertisement packets and does not pair with the device. Hence ESPHome has no impact on battery life. +The ``xiaomi_ble`` sensor platform lets you track the output of Xiaomi Bluetooth Low Energy devices using the :doc:`/components/esp32_ble_tracker`. This component will track, for example, the temperature, humidity, moisture, conductivity, illuminance, formaldehyde, mosquito tablet and battery level of the device every time the sensor sends out a BLE broadcast. Contrary to other implementations, ``xiaomi_ble`` listens passively to advertisement packets and does not pair with the device. Hence ESPHome has no impact on battery life. Thus, if you only use such sensors, you can safely set ``active: false`` in ``esp32_ble_tracker`` configuration, to save from spamming your RF environment with useless scan requests. Supported Devices ----------------- @@ -567,7 +567,7 @@ It can sometimes take some time for the first BLE broadcast to be received. Once Obtaining The Bindkey --------------------- -To set up an encrypted device such as the LYWSD03MMC (with Xiaomi stock firmware) and CGD1, you first need to obtain the bind key. The ``xiaomi_ble`` sensor component is not able to automatically generate a bind key so other workarounds are necessary. +To set up an encrypted device such as the LYWSD03MMC (with Xiaomi stock firmware) and CGD1, you first need to obtain the bind key. The ``xiaomi_ble`` sensor component is not able to automatically generate a bindkey so other workarounds are necessary. LYWSD03MMC/MHO-C401 ******************* @@ -635,7 +635,11 @@ Avoid placing the ESP node in racks, close to routers/switches or other network Security considerations ----------------------- -You should at least protect your sensors with a custom pairing PIN code. +You should at least protect your sensors with a custom pairing PIN code. Choose a method employing bindkey in order to use encrypted communication over the air. + +.. note:: + + Devices flashed with `PVVX MiThermometer `__ custom firmware also support the `BTHome protocol `__ which can be used in conjunction with ESPHome's :doc:`/components/bluetooth_proxy` component to forward sensor data to Home Assistant. See Also @@ -646,6 +650,7 @@ See Also - :doc:`/components/display/pvvx_mithermometer` - :apiref:`xiaomi_lywsd03mmc/xiaomi_ble.h` - :doc:`/components/ethernet` +- :doc:`/components/bluetooth_proxy` - Passive BLE monitor integration for Home Assistant (ble_monitor custom component) ``__ by `@Magalex2x14 `__ and `@Ernst79 `__ - Custom firmware (PVVX) for the Xiaomi Thermometer LYWSD03MMC ``__