Merge tag 'mega-20231130' into mega_vurk_dmr

Release mega-20231130 Changes in mega-20231130 (since mega-20231013): Fabio Ancona (3): Update Custom-sample.h with missing Plugins and update description Update Custom-sample.h after review Details supported hardware TD-er (19): [WiFi] Fix force B/G mode on ESP8266 [WiFi] Limit WiFi speed to HT20 for 802.11n mode on ESP32 [Build] Fix compile error when using default Custom.h (letscontrolit#4870) [CDN URL] Add default CDN url with latest tag when no pygit2 installed [WiFi] Fix connect to Hidden SSID on Mikrotik AP (letscontrolit#4885) [WiFi] Only connect using BSSID when BSSID is available [ESP32 WiFi] Fix reconnect issue after WIFI_REASON_AUTH_EXPIRE [FactoryReset] Store settings to keep in ESP32 NVS storage [Custom CDN] Move Custom CDN URL to config.dat [Custom CDN] Move position of where Custom CDN URL is stored in settings [Factory Reset] Use NVS stored defaults on reset [Custom CDN] Fix storing empty CDN url. [Factory Reset] Store WiFi/Eth config in NVS [Factory Reset] Store log/console settings in NVS [Custom CDN] Add checkbox to store Custom CDN to NVS [Custom.h] Update Custom-sample.h with new CUSTOM_BUILD_CDN_URL [Factory Reset] Add new flag to NVS for slow connect to hidden SSID [ESP8266 build] Set all ESP8266 'normal' builds to use CDN for CSS/JS automatically updated release notes for mega-20231130 Ton Huisman (68): [Lib] HeatpumpIR update to 1.0.23 [Lib] HeatpumpIR Add compatibility with ESP32 Arduino 3.0/IDF 5.1.x [P023] Bugfix: Template parsing was overwriting the template [P159] Add LD2410 Radar presence detection [P023] Minor performance improvement [P159] Remove copy/paste evidence :-D [P159] Many improvements, add/update settings for sensitivity [P159] Fix compilation on LIMIT_BUILD_SIZE builds [P159] Small improvements [P159] Small improvements [P159] Add command for sensor factoryreset [Lib] LD2410: Fix bug (-1 for uint), add undocumented OutputPinState value [P159] Add OutputPinState option after AmbientLight option (breaking change!) [P159] Minor change to determine how that may influence the build [NEOPIXEL] Add NeoPixelBus_wrapper and implement in NeoPixel plugins [Lib] Adjust Adafruit_NeoMatrix to use NeoPixelBus_wrapper [ESP-IDF5.1] Update NeoPixelBus with Tasmota's patches for ESP-IDF5.1 [NeoPixel] Add changelogs for applying NeoPixelBus_wrapper library [Build] Fix pygit2 version [Build] Fix pygit2 version [Build] Restore pygit2 version [Build] Try older/current version of pip [Build] Explicit version of libgit2 [Build] Undo changes [ESP-IDF5.1] Fix build issue on older IDF based builds [Neopixel] Fixes and improvements [Build] Freeze pip dependencies [Build] Undo changes [Build] Try fix failing pygit2 install [Build] Try older Python version [Neopixel] Fix fall-through return value [Build] Fix some cherry-pick diffs [Build] Freeze Python to 3.11 to fix pygit2 build issue [P159] Add Gate0 energy values that where missing Add GetConfig support for fetching all available values Add ld2410,logall command for dumping all values in the log (INFO level) Code improvements [NeopixelWrapper] Code optimization [P021] Set Hysteresis value via config command [P021] Update documentation [Build] Freeze Python version to avoid build issue with pygit2 [Build] Freeze Python version on 3.11 so pygit2 will run as intended [P021] Change commands SetHysteresis and GetHysteresis for consistency [Lib] LD2410: Read all data that can be read in 5 msec, add errorcount and data_valid checks [P159] Rework processing, now near-instant response Add GetConfig support for sensitivity per gate values [Lib] LD2410: Reformat source (nearly all is changed!) Replace yield() by delay(0) [P159] Fix wrong use of F(""), should be EMPTY_STRING [Lib] IRremoteESP8266 update to v2.8.6, with ESPEasy patches applied - Disable some (more) IR protocols to make 1M build fit - Add IDF 5.x compatibility [Lib] Adafruit_NeoMatrix: Fix includes [Lib] Remove Adafruit_NeoPixel from repo [P131] Fix variable initialization, call begin() to start the NeoPixels [P041] Uncrustify source, minor improvements [P042] Fix initializations to avoid crash at start, minor improvements [P070] Minor improvements [Lib] Update library.properties for local copy of Adafruit_NeoMatrix [Docs] Updates and corrections Nov. 2023 [Docs] Updates and corrections Nov. 2023 [P159] Add documentation [P159] Update EasyColorMirror [P159] Update comments to explicitly name LD2410 [CDN] Set override url for CDN hosted files [CDN] Update documentation [CDN] Code improvements, Add to Provisioning [CDN] Update documentation [Provisioning] Split provisioning commands, add fallback for MAX builds, code cleanup [Provisioning] Update documentation [CDN] Replace system variables in url, update documentation [I2C] Add Device flag for 100 kHz-only devices [I2C] Devices that only support 100 kHz speed [Bugfix] [P159] Saving settings checkbox failed on ESP8266 [Docs] Fix some typos Nov. 2023 jfmennedy (8): P093 Mitsubishi HeatPump Add Support for SetRemoteTemperature Resolves P093 - Mitsubishi Heat Pump Add Remote Temperature letscontrolit#4711 Modify Changelog Order Help needed here - Fix float initialisaton, - Fix float comparator, - Still trying t get SetRemoteTemperature working... -Fix static const uint8_t RemoteTemperature - Implement remarks from review Documentation Documentation Review
ly1bwb · Feb 20, 2024 · b35dc9a · b35dc9a
2 parents 5ec6af1 + d360a72
commit b35dc9a
Show file tree

Hide file tree

Showing 458 changed files with 25,353 additions and 19,276 deletions.
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
@@ -66,7 +66,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v4
         with:
-          python-version: '3.x'
+          python-version: '3.11'
       - uses: actions/cache@v3
         with:
           path: ~/.cache/pip
@@ -86,6 +86,7 @@ jobs:
           sudo apt-get update
           sudo apt install binutils build-essential libffi-dev libgit2-dev
           pip3 install --upgrade pip
+          pip install wheel
           pip install -r requirements.txt
           platformio update
       - name: Build and archive

diff --git a/dist/Release_notes.txt b/dist/Release_notes.txt
@@ -1,3 +1,115 @@
+-------------------------------------------------
+Changes in release mega-20231130 (since mega-20231013)
+-------------------------------------------------
+
+Release date: Thu Nov 30 08:11:17 PM CET 2023
+
+Fabio Ancona (3):
+      Update Custom-sample.h with missing Plugins and update description
+      Update Custom-sample.h after review
+      Details supported hardware
+
+TD-er (18):
+      [WiFi] Fix force B/G mode on ESP8266
+      [WiFi] Limit WiFi speed to HT20 for 802.11n mode on ESP32
+      [Build] Fix compile error when using default Custom.h (#4870)
+      [CDN URL] Add default CDN url with latest tag when no pygit2 installed
+      [WiFi] Fix connect to Hidden SSID on Mikrotik AP (#4885)
+      [WiFi] Only connect using BSSID when BSSID is available
+      [ESP32 WiFi] Fix reconnect issue after WIFI_REASON_AUTH_EXPIRE
+      [FactoryReset] Store settings to keep in ESP32 NVS storage
+      [Custom CDN] Move Custom CDN URL to config.dat
+      [Custom CDN] Move position of where Custom CDN URL is stored in settings
+      [Factory Reset] Use NVS stored defaults on reset
+      [Custom CDN] Fix storing empty CDN url.
+      [Factory Reset] Store WiFi/Eth config in NVS
+      [Factory Reset] Store log/console settings in NVS
+      [Custom CDN] Add checkbox to store Custom CDN to NVS
+      [Custom.h] Update Custom-sample.h with new CUSTOM_BUILD_CDN_URL
+      [Factory Reset] Add new flag to NVS for slow connect to hidden SSID
+      [ESP8266 build] Set all ESP8266 'normal' builds to use CDN for CSS/JS
+
+Ton Huisman (68):
+      [Lib] HeatpumpIR update to 1.0.23
+      [Lib] HeatpumpIR Add compatibility with ESP32 Arduino 3.0/IDF 5.1.x
+      [P023] Bugfix: Template parsing was overwriting the template
+      [P159] Add LD2410 Radar presence detection
+      [P023] Minor performance improvement
+      [P159] Remove copy/paste evidence :-D
+      [P159] Many improvements, add/update settings for sensitivity
+      [P159] Fix compilation on LIMIT_BUILD_SIZE builds
+      [P159] Small improvements
+      [P159] Small improvements
+      [P159] Add command for sensor factoryreset
+      [Lib] LD2410: Fix bug (-1 for uint), add undocumented OutputPinState value
+      [P159] Add OutputPinState option after AmbientLight option (breaking change!)
+      [P159] Minor change to determine how that may influence the build
+      [NEOPIXEL] Add NeoPixelBus_wrapper and implement in NeoPixel plugins
+      [Lib] Adjust Adafruit_NeoMatrix to use NeoPixelBus_wrapper
+      [ESP-IDF5.1] Update NeoPixelBus with Tasmota's patches for ESP-IDF5.1
+      [NeoPixel] Add changelogs for applying NeoPixelBus_wrapper library
+      [Build] Fix pygit2 version
+      [Build] Fix pygit2 version
+      [Build] Restore pygit2 version
+      [Build] Try older/current version of pip
+      [Build] Explicit version of libgit2
+      [Build] Undo changes
+      [ESP-IDF5.1] Fix build issue on older IDF based builds
+      [Neopixel] Fixes and improvements
+      [Build] Freeze pip dependencies
+      [Build] Undo changes
+      [Build] Try fix failing pygit2 install
+      [Build] Try older Python version
+      [Neopixel] Fix fall-through return value
+      [Build] Fix some cherry-pick diffs
+      [Build] Freeze Python to 3.11 to fix pygit2 build issue
+      [P159] Add Gate0 energy values that where missing Add GetConfig support for fetching all available values Add ld2410,logall command for dumping all values in the log (INFO level) Code improvements
+      [NeopixelWrapper] Code optimization
+      [P021] Set Hysteresis value via config command
+      [P021] Update documentation
+      [Build] Freeze Python version to avoid build issue with pygit2
+      [Build] Freeze Python version on 3.11 so pygit2 will run as intended
+      [P021] Change commands SetHysteresis and GetHysteresis for consistency
+      [Lib] LD2410: Read all data that can be read in 5 msec, add errorcount and data_valid checks
+      [P159] Rework processing, now near-instant response Add GetConfig support for sensitivity per gate values
+      [Lib] LD2410: Reformat source (nearly all is changed!) Replace yield() by delay(0)
+      [P159] Fix wrong use of F(""), should be EMPTY_STRING
+      [Lib] IRremoteESP8266 update to v2.8.6, with ESPEasy patches applied - Disable some (more) IR protocols to make 1M build fit - Add IDF 5.x compatibility
+      [Lib] Adafruit_NeoMatrix: Fix includes
+      [Lib] Remove Adafruit_NeoPixel from repo
+      [P131] Fix variable initialization, call begin() to start the NeoPixels
+      [P041] Uncrustify source, minor improvements
+      [P042] Fix initializations to avoid crash at start, minor improvements
+      [P070] Minor improvements
+      [Lib] Update library.properties for local copy of Adafruit_NeoMatrix
+      [Docs] Updates and corrections Nov. 2023
+      [Docs] Updates and corrections Nov. 2023
+      [P159] Add documentation
+      [P159] Update EasyColorMirror
+      [P159] Update comments to explicitly name LD2410
+      [CDN] Set override url for CDN hosted files
+      [CDN] Update documentation
+      [CDN] Code improvements, Add to Provisioning
+      [CDN] Update documentation
+      [Provisioning] Split provisioning commands, add fallback for MAX builds, code cleanup
+      [Provisioning] Update documentation
+      [CDN] Replace system variables in url, update documentation
+      [I2C] Add Device flag for 100 kHz-only devices
+      [I2C] Devices that only support 100 kHz speed
+      [Bugfix] [P159] Saving settings checkbox failed on ESP8266
+      [Docs] Fix some typos Nov. 2023
+
+jfmennedy (8):
+      P093 Mitsubishi HeatPump Add Support for SetRemoteTemperature Resolves P093 - Mitsubishi Heat Pump Add Remote Temperature #4711
+      Modify Changelog Order
+      Help needed here
+      - Fix float initialisaton, - Fix float comparator, - Still trying t get SetRemoteTemperature working...
+      -Fix static const uint8_t RemoteTemperature
+      - Implement remarks from review
+      Documentation
+      Documentation Review
+
+
 -------------------------------------------------
 Changes in release mega-20231013 (since mega-20230930)
 -------------------------------------------------

diff --git a/docs/source/Config/Config.rst b/docs/source/Config/Config.rst
@@ -298,3 +298,15 @@ N.B. the maximum possible duration depends on the used core library version and
 Sleep on connection failure
 ---------------------------
 
+CDN (Content delivery network)
+------------------------------
+
+The **Custom CDN URL** can be set to a server url (https preferred, they are downloaded by the browser, **not** by the ESPEasy unit) that hosts *all* files as listed on :ref:`ExternalHostedStaticFiles` (System variables can be used to customize the URL).
+
+To reduce the build size where possible, some builds fetch the javascript (.js) and .css UI files from an external server, as this is used in the browser only. The default location for this data is the Content Delivery Network (CDN) of ``jsdelivr.net``, where these file are uploaded for specific releases.
+
+For users that want to host these files in their local network, or if the files on jsdeliver.net have expired, an alternative location for these .js and .css file can be configured.
+
+Setting this location will **override** the default CDN url, except for your Custom build that may already *have* the CDN url set, then this setting won't be available!
+
+**Warning**: If an invalid location is set, the UI will be distorted, though should still be usable.
diff --git a/docs/source/Controller/C014.rst b/docs/source/Controller/C014.rst
@@ -64,15 +64,15 @@ A home automation server/controller capable talking Homie like openHAB since 2.4
 Setup
 -------------
 
-- add the Homie **Homie MQTT (Version 4.0.0 dev)** or **Homie MQTT (Version 3.0.1 dev)** controller to your controller lists depending on your build.
-- insert your broker address
-- and user credentials if necessary
-- the publish scheme is fixed to meet the homie requirements to ``homie/%sysname%/%tskname%/%valname%``
-- the subscription scheme can be modified. Current defaults to ``homie/%sysname%/+/+/set`` to reduce incoming traffic to a minimum. Homie only expects messages via the ``homie/%sysname%/%tskname%/%valname%/set`` topic.
-- last will topic (LWT) should set to ``homie/%sysname%/$state``
+- Add the Homie **Homie MQTT (Version 4.0.0 dev)** or **Homie MQTT (Version 3.0.1 dev)** controller to your controller lists depending on your build.
+- Insert your broker address
+- And user credentials if necessary
+- The publish scheme is fixed to meet the homie requirements to ``homie/%sysname%/%tskname%/%valname%``
+- The subscription scheme can be modified. Current defaults to ``homie/%sysname%/+/+/set`` to reduce incoming traffic to a minimum. Homie only expects messages via the ``homie/%sysname%/%tskname%/%valname%/set`` topic.
+- Last will topic (LWT) should set to ``homie/%sysname%/$state``
 - LWT Connect Message to ``ready``
 - LWT Disconnect Message to ``lost``
-- save and reboot, best with connected serial monitor or syslog server with debug set to 4 (debug) or greater (alternatively use a MQTT client and subscribe to ``homie/%sysname%/#`` - replace %sysname% by the unit-name shown on the top of the webpage).
+- Save and reboot, best with connected serial monitor or syslog server with debug set to 4 (debug) or greater (alternatively use a MQTT client and subscribe to ``homie/%sysname%/#`` - replace %sysname% by the unit-name shown on the top of the webpage).
 
 .. image:: C0014_Setup_0.png
 
@@ -93,22 +93,22 @@ The auto-discover information is sent through a big number of messages (usual mo
 - More devices can be added or (re-)enabled later.
 - Disable already configured devices (devices without the enabled box ticked will be ignored)
 - Check with a MQTT client if all messages are sent. The last message sent is ``$nodes`` attribute listing minimum the ``SYSTEM`` node if no other devices are enabled.
-- check your WIFI connection. Perhaps bring your device nearer to your access point. (only necessary during the setup process because the messages should be stored by the broker)
-- check via syslog or serial console if the messages are sent successful (you normaly can't see the log output in the web log)
-- use the `mqqt-forget <https://www.npmjs.com/package/mqtt-forget>`_ tool to delete unused retained messages from your broker via wildcards
+- Check your WIFI connection. Perhaps bring your device nearer to your access point. (only necessary during the setup process because the messages should be stored by the broker)
+- Check via syslog or serial console if the messages are sent successful (you normaly can't see the log output in the web log)
+- Use the `mqqt-forget <https://www.npmjs.com/package/mqtt-forget>`_ tool to delete unused retained messages from your broker via wildcards
 
 Features
 --------
 
 The controller currently supports these features
 
-- send auto-discover nodes for all sending and enabled plug-ins to ``homie/%unitName%/%deviceName%/%valueName%``
-- receive commands through the ``homie/%unitName%/SYSTEM/cmd/set`` topic.
-- switch GPIOs through ``homie/%unitName%/SYSTEM/gpio#/set`` topic. The GPIO port must be set to **default low** or **default high** in the hardware tab to be included during auto-discover.
-- send updates of GPIO ports to ``homie/%unitName%/SYSTEM/gpio#`` regardless from where the change is triggered (to be fully tested).
-- in conjunction with :ref:`P086_page` actuators can be used according to the Homie convetion using rules.
-- receive values for dummy devices via ``homie/%unitName%/%dummyDeviceName%/%valueName%/set``. From there the values can be processed further by using rules.
-- handle ``$state`` attribute (for complete list see attribute table below)
+- Send auto-discover nodes for all sending and enabled plug-ins to ``homie/%unitName%/%deviceName%/%valueName%``
+- Receive commands through the ``homie/%unitName%/SYSTEM/cmd/set`` topic.
+- Switch GPIOs through ``homie/%unitName%/SYSTEM/gpio#/set`` topic. The GPIO port must be set to **default low** or **default high** in the hardware tab to be included during auto-discover.
+- Send updates of GPIO ports to ``homie/%unitName%/SYSTEM/gpio#`` regardless from where the change is triggered (to be fully tested).
+- In conjunction with :ref:`P086_page` actuators can be used according to the Homie convetion using rules.
+- Receive values for dummy devices via ``homie/%unitName%/%dummyDeviceName%/%valueName%/set``. From there the values can be processed further by using rules.
+- Handle ``$state`` attribute (for complete list see attribute table below)
 
   - ``init`` during boot process
   - ``ready`` during normal operation and as a heartbeat every 30sec (to be tested)
@@ -117,23 +117,23 @@ The controller currently supports these features
   - ``lost`` configured as LWT
   - ``disconnected`` sent to the old topic if the unit name changes to inform that the old topic is not valid any more. Auto-discover messages are sent automagically to the new topics afterwards.
 
-- acknowledge received message by the ``homie/%unitName%/%deviceName%/%valueName%/set`` topic to the corresponding value ``homie/%unitName%/%deviceName%/%valueName%`` even if the value was changed by a different source like HTTP or rule to keep the state in your home automation system allays up to date. (Needs further testing)
+- Acknowledge received message by the ``homie/%unitName%/%deviceName%/%valueName%/set`` topic to the corresponding value ``homie/%unitName%/%deviceName%/%valueName%`` even if the value was changed by a different source like HTTP or rule to keep the state in your home automation system allays up to date. (Needs further testing)
 
 Future / planned features
 -------------------------
 
-- a special Homie Plugin is in devolopment to pass ``\set`` messages to rules for further handling. Here ``$datatype`` and ``$format`` attributes for ``$setable`` values can be specified there. This will enable ESPEasy to handle direct inputs to plug-ins like dimmers (%,0:100), colors (RGB & HSV, 255,255,255), enum devices like remote controls (Play, Pause, Vol+, Vol-, ...). :yellow:`Testing` see :ref:`P086_page`
+- A special Homie Plugin is in devolopment to pass ``/set`` messages to rules for further handling. Here ``$datatype`` and ``$format`` attributes for ``$settable`` values can be specified there. This will enable ESPEasy to handle direct inputs to plug-ins like dimmers (%,0:100), colors (RGB & HSV, 255,255,255), enum devices like remote controls (Play, Pause, Vol+, Vol-, ...). See :ref:`P086_page` in :yellow:`Collection A` builds
 - Further in field testing with different MQTT brokers and home automation systems.
 - Handling units via the ``$unit`` attribute. As ESPEasy is currenty "unitless" this needs a global concept within ESPEasy
-- Handling ``$datatype`` attribute. Currenly all values (except cmd and gpio) are defined as ``float``. :yellow:`Testing` see :ref:`P086_page` 
+- Handling ``$datatype`` attribute. Currenly all values (except cmd and gpio) are defined as ``float``. See :ref:`P086_page` in :yellow:`Collection A` builds
 - Prepare some "working examples".
 
 Under the hood
 --------------
 
-Auto-dicover information is sent by several $attributes
+Auto-discover information is sent by several ``$attributes``
 
-currently the following attributes will be sent during boot
+Currently the following attributes will be sent during boot
 
 Unit (Device) attributes
 ^^^^^^^^^^^^^^^^^^^^^^^^

diff --git a/docs/source/Controller/C014_node_attributes.repl b/docs/source/Controller/C014_node_attributes.repl
@@ -4,4 +4,4 @@
 
         "``$name``","Friendly name of the Node","SYSTEM", "YES",":green:`required`", "YES",":green:`required`"
         "``$type``","Type of the node","System commands", "YES",":green:`required`", "YES",":green:`required`"
-        "``$properties``","Exposed properties. Separated by , for multiple ones.","value1,value2", "YES",":green:`required`", "YES",":green:`required`"
+        "``$properties``","Exposed properties. Separated by ``,`` for multiple properties.","value1,value2", "YES",":green:`required`", "YES",":green:`required`"
diff --git a/docs/source/Plugin/P021.rst b/docs/source/Plugin/P021.rst
@@ -91,6 +91,9 @@ Change log
 .. versionchanged:: 2.0
   ...
 
+  |added|
+  2023-10-28: Set Hysteresis via ``config`` command and get via ``[<Taskname>#GetHysteresis]`` variable.
+
   |added|
   2022-08-22: Auto-save interval option.
 

diff --git a/docs/source/Plugin/P021_DeviceConfiguration.png b/docs/source/Plugin/P021_DeviceConfiguration.png
diff --git a/docs/source/Plugin/P021_commands.repl b/docs/source/Plugin/P021_commands.repl
@@ -13,7 +13,22 @@
         Using this command, either from rules, via http or mqtt, the **Set Level** of the plugin can be changed. If the value differs from the currently set value, the settings are saved.
         "
         "
+        ``config,task,<taskname>,SetHysteresis,<value|calculation>``
+
+        Value: {Any valid numeric (float) value}
+
+        Calculation: {A valid calculation, as can be used in Rules}
+
+        ","
+        Using this command, either from rules, via http or mqtt, the **Hysteresis** of the plugin can be changed. If the new value differs from the currently set hysteresis, the settings are saved.
+        "
+        "
         ``[<taskname>#GetLevel]``
         ","
         Not a real command, but this plugin supports the ``GetLevel`` Config function, to retrieve the **Set Value** from the settings, by using the pseudo value ``GetLevel``.
         "
+        "
+        ``[<taskname>#GetHysteresis]``
+        ","
+        Not a real command, but this plugin supports the ``SetHysteresis`` Config function, to retrieve the **Hysteresis** from the settings, by using the pseudo value ``GetHysteresis``.
+        "
diff --git a/docs/source/Plugin/P093.rst b/docs/source/Plugin/P093.rst
@@ -74,7 +74,7 @@ See: :ref:`SerialHelper_page`
 
 Once we hit submit, the plugin will start sending messages through controller, i.e. MQTT with payload:
 
-``{"roomTemperature":25.5,"wideVane":"|","power":"OFF","mode":"COOL","fan":"AUTO","vane":"AUTO","iSee":true,"operating":true,"compressorFrequency":5,"temperature":24.0}``
+``{"roomTemperature":19.5,"wideVane":"|","power":"OFF","mode":"HEAT","fan":"AUTO","vane":"AUTO","iSee":false,"operating":false,"compressorFrequency":2,"temperature":22.0,"remoteTemperature":19.5}``
 
 Message is send every time a change is detected (i.e. one changes settings using IR remote control) and every X seconds, as set in the settings (60 seconds in above screenshot).
 
@@ -127,6 +127,12 @@ Special thanks
 Change log
 ----------
 
+.. versionchanged:: 2023/09/25
+  ...
+
+  |added|
+  Set Remote Temperature. (value > 0: Use external temperature sensor, value = 0: Use internal temperature sensor)
+
 .. versionchanged:: 2021/08/03
   ...
 

diff --git a/docs/source/Plugin/P093_commands.repl b/docs/source/Plugin/P093_commands.repl
@@ -32,3 +32,8 @@
         ","
         Value = ``<<``, ``<``, ``|``, ``>``, ``>>``, ``<>`` or ``SWING``
         "
+        "
+        ``MitsubishiHP,remotetemperature,<value>``
+        ","
+        Value > ``0.0``: Use external temperature sensor, Value = ``0.0``: Use internal temperature sensor.
+        "
diff --git a/docs/source/Plugin/P093_config_values.repl b/docs/source/Plugin/P093_config_values.repl
@@ -6,6 +6,7 @@
     | ``[<taskname>#roomTemperature]``
     ","
     | Value as received from the connected device, includes 1 decimal.
+    | When Remote Temperature is used, received value is rounded to the nearest 0.5 C.
     "
     "
     | ``[<taskname>#wideVane]``
@@ -52,3 +53,8 @@
     ","
     | Value as received from the connected device, when ``Include AC status`` is enabled.
     "
+    "
+    | ``[<taskname>#remoteTemperature]``
+    ","
+    | Value as received from the connected device, includes 1 decimal.
+    "