Merge branch 'master' into patch-1

Author: barbudor

.github/workflows/main.yml

@@ -14,4 +14,5 @@ jobs:
           python-version: 3.x
       - run: pip install wheel
       - run: pip install -r requirements.txt
-      - run: mkdocs gh-deploy --force --strict
+      # - run: mkdocs gh-deploy --force --strict
+      - run: mkdocs gh-deploy --force 

.vscode/settings.json

@@ -3,7 +3,6 @@
         "en"
     ],
     "spellright.documentTypes": [
-        "markdown",
         "latex",
         "plaintext"
     ]

docs/ADC.md

@@ -6,7 +6,7 @@ The ESP8266 has a single ADC pin available. It may be used to read voltage at th
 !!! warning
      Check your Wi-Fi module! The ESP8266 A0 pin supports a maximum voltage of 1.0V. Many newer Wi-Fi modules have an on-board voltage divider to support a higher A0 input voltage range (typically in the range between 0 and 3.3 volts). You may need to use an external voltage divider to ensure your input voltage is in the right range.
 
-By default Tasmota uses the ADC pin to read voltage. The signal comes from an analog [peripheral](), or sometimes from the device itself (see [Shelly 2.5](/devices/Shelly-2.5)). 
+By default Tasmota uses the ADC pin to read voltage. The signal comes from an analog peripheral, or sometimes from the device itself (see [Shelly 2.5](devices/Shelly-2.5.md)). 
 
 After wiring a peripheral to GPIO17 (A0) pin you have to configure it in **Configure Module**:
 

docs/AM2301.md

@@ -8,7 +8,7 @@
     #endif
     ```
 
-AM2301 driver supports [AM2301 (DHT21)](http://www.haoyuelectronics.com/Attachment/AM2301/AM2301.pdf), [AM2302 (DHT22)](https://www.sparkfun.com/datasheets/Sensors/Temperature/DHT22.pdf), [AM2320](http://akizukidenshi.com/download/ds/aosong/AM2320.pdf) and [AM2321](http://akizukidenshi.com/download/ds/aosong/AM2321_e.pdf) temperature and humidity sensors. Introduced in Tasmota through [Sonoff AM2301](https://sonoff.tech/product/accessories/am2301) accessory for [Sonoff TH](/devices/Sonoff-TH).
+AM2301 driver supports [AM2301 (DHT21)](http://www.haoyuelectronics.com/Attachment/AM2301/AM2301.pdf), [AM2302 (DHT22)](https://www.sparkfun.com/datasheets/Sensors/Temperature/DHT22.pdf), [AM2320](http://akizukidenshi.com/download/ds/aosong/AM2320.pdf) and [AM2321](http://akizukidenshi.com/download/ds/aosong/AM2321_e.pdf) temperature and humidity sensors. Introduced in Tasmota through [Sonoff AM2301](https://sonoff.tech/product/accessories/am2301) accessory for [Sonoff TH](devices/Sonoff-TH.md).
 
 **This driver is ONLY for _single wire_ implementations of the sensor.**
 

docs/BUILDS.md

@@ -32,8 +32,8 @@ Note: `minimal` variant is not listed as it shouldn't be used outside of the [up
 | USE_SUNRISE               | x | x / x | x | x | x | x |
 | USE_RULES                 | x | x / x | x | x | x | x |
 | USE_SCRIPT                | - | - / - | - | - | - | - |
-| USE_EXPRESSION            | - | - / - | - | - | - | - |
-| SUPPORT_IF_STATEMENT      | - | - / - | - | - | - | - |
+| USE_EXPRESSION            | - | - / x | - | - | - | - | Every ESP32 + ESP8266 > 1MB
+| SUPPORT_IF_STATEMENT      | - | - / x | - | - | - | - | Every ESP32 + ESP8266 > 1MB
 | USE_HOTPLUG               | - | - / - | - | - | - | - |
 | USE_PROMETHEUS            | - | - / - | - | - | - | - |
 | USE_PING                  | - | - / - | - | - | - | - |
@@ -112,22 +112,28 @@ Note: `minimal` variant is not listed as it shouldn't be used outside of the [up
 | USE_ADS1115               | - | - / x | - | x | - | - |
 | USE_INA219                | - | - / x | - | x | - | - |
 | USE_INA226                | - | - / - | - | - | - | - |
+| USE_INA3221               | - | - / - | - | - | - | - |
 | USE_SHT3X                 | - | - / x | - | x | - | - |
 | USE_TSL2561               | - | - / - | - | - | - | - |
 | USE_TSL2591               | - | - / - | - | - | - | - |
 | USE_MGS                   | - | - / x | - | x | - | - |
 | USE_SGP30                 | - | - / x | - | x | - | - |
 | USE_SGP40                 | - | - / x | - | x | - | - |
+| USE_SGP4X                 | - | - / x | - | - | - | - |
 | USE_SEN5X                 | - | - / x | - | x | - | - |
 | USE_SI1145                | - | - / - | - | - | - | - |
 | USE_LM75AD                | - | - / x | - | x | - | - |
 | USE_APDS9960              | - | - / - | - | - | - | - |
 | USE_MCP230xx              | - | - / - | - | - | - | - |
+| USE_MCP23XXX_DRV          | - | - / - | - | - | - | - |
 | USE_PCA9632               | - | - / - | - | - | - | - |
 | USE_PCA9685               | - | - / - | - | - | - | - |
+| USE_PCA9685_V2            | - | - / - | - | - | - | - |
 | USE_MPR121                | - | - / - | - | - | - | - |
 | USE_CCS811                | - | - / - | - | x | - | - |
 | USE_CCS811_V2             | - | - / x | - | - | - | - |
+| USE_ENS16x                | - | - / - | - | - | - | - |
+| USE_ENS210                | - | - / - | - | - | - | - |
 | USE_MPU6050               | - | - / - | - | - | - | - |
 | USE_DS3231                | - | - / - | - | - | - | - |
 | USE_MGC3130               | - | - / - | - | - | - | - |
@@ -143,6 +149,11 @@ Note: `minimal` variant is not listed as it shouldn't be used outside of the [up
 | USE_CHIRP                 | - | - / - | - | - | - | - |
 | USE_PAJ7620               | - | - / - | - | - | - | - |
 | USE_PCF8574               | - | - / - | - | - | - | - |
+| USE_PMSA003I              | - | - / - | - | - | - | - |
+| USE_LOX_O2                | - | - / x | - | x | - | - |
+| USE_GDK101                | - | - / - | - | - | - | - |
+| USE_TC74                  | - | - / - | - | - | - | - |
+| USE_PCA9557               | - | - / - | - | - | - | - |
 |                           |   |       |   |   |   |   |
 | Feature or Sensor         | l | t     | k | s | i | d | Remarks
 | USE_HIH6                  | - | - / x | - | x | - | - |
@@ -209,6 +220,7 @@ Note: `minimal` variant is not listed as it shouldn't be used outside of the [up
 | USE_PROJECTOR_CTRL        | - | - / - | - | - | - | - |
 | USE_AS608                 | - | - / - | - | - | - | - |
 | USE_LD2410                | - | - / - | - | - | - | - |
+| USE_GM861                 | - | - / - | - | - | - | - |
 | USE_TCP_BRIDGE            | - | - / - | - | - | - | - | zbbridge / zbbrdgpro
 |                           |   |       |   |   |   |   |
 | USE_NRF24                 | - | - / - | - | - | - | - |
@@ -268,5 +280,6 @@ Note: `minimal` variant is not listed as it shouldn't be used outside of the [up
 | USE_SHELLY_PRO            |   |   / x |   |   |   |   |
 | USE_DALI                  |   |   / - |   |   |   |   |
 | USE_DINGTIAN_RELAY        |   |   / - |   |   |   |   |
+| USE_MATTER_DEVICE         |   |   / x |   |   |   |   | See SetOption151
 
-* USE_MQTT_TLS is enabled by default in every ESP32 variants
+* USE_MQTT_TLS is enabled by default in every ESP32 variants

docs/Berry-Cookbook.md

@@ -649,9 +649,10 @@ def netflip()
 end
 tasmota.set_timer(30000,netflip)              #4
 ```
+
 1. store variable "eth" with Ethernet status - "true" if Ethernet IP exists and "false" if not
 2. check if wifi status is true and compare to eth status
-3. send command `Wifi` with parameter depending on eth variable. `..` is to concatenate a string. See Berry [manualg(https://github.com/berry-lang/berry/wiki/Chapter-3#-operator-1)
+3. send command `Wifi` with parameter depending on eth variable. `..` is to concatenate a string. See Berry [manual](https://github.com/berry-lang/berry/wiki/Chapter-3#-operator-1)
 4. set a timer to execute the netflip function 30000ms (30 seconds) after loading `autoexec.be`
 
 ## TMP117 Driver
@@ -753,4 +754,28 @@ def flash_to_file(filename, addr, len)
 end
 
 flash_to_file("safe_boot_flashed.bin", 0x10000, 768320)
-```
+```
+
+## Tank Sensor
+
+Tank Sensor for fuel-oil volume measurement using a VL53L1X or SR04 sensor
+
+[https://github.com/trlafleur/Tasmota-Tank-Sensor](https://github.com/trlafleur/Tasmota-Tank-Sensor)
+
+## Home Assistant Controls for Tasmota
+
+This is a Tasmota Berry Script library to greatly simplify the process of exposing Home Assistant controls (e.g. Pull-down Lists, Number Sliders, Sensors, etc.) from a Tasmota device - and handling the communication between both sides.
+
+[https://github.com/fmtr/hct](https://github.com/fmtr/hct)
+
+## Build MQTT topic string based on FullTopic configuration
+
+This code bit illustrates how you can create a topic string in the form of the FullTopic specification. Details like whech %prefix% you want and what last level of the topic is obviously variable.
+
+```berry
+var topic = string.replace(string.replace(
+              tasmota.cmd('FullTopic',true)['FullTopic'],
+              '%topic%', tasmota.cmd('Topic',true)['Topic']),
+              '%prefix%', tasmota.cmd('Prefix',true)['Prefix3'])
+            + 'SENSOR'
+```