Merge branch 'next' into feature/ina2xx-reset-optional

Author: swoboda1337

content/changelog/2025.10.0.md

@@ -3,4 +3,4 @@ description: "Changelog"
 title: "Changelog"
 ---
 
-{{< redirect url="/changelog/2025.9.0.html" >}}
+{{< redirect url="/changelog/2025.10.0.html" >}}

content/changelog/_index.md

@@ -67,6 +67,7 @@ using an octal SPI bus, so references here to parallel and octal SPI are equival
 | WAVESHARE-4-TFT                      | Waveshare | <https://www.waveshare.com/4inch-tft-touch-shield.htm> |
 | PICO-RESTOUCH-LCD-3.5                | Waveshare | <https://www.waveshare.com/pico-restouch-lcd-3.5.htm> |
 | WAVESHARE-ESP32-S3-TOUCH-AMOLED-1.75 | Waveshare | <https://www.waveshare.com/esp32-s3-touch-amoled-1.75.htm> |
+| WAVESHARE-ESP32-S3-TOUCH-LCD-3.49    | Waveshare | <https://www.waveshare.com/esp32-s3-touch-lcd-3.49.htm> |
 | WT32-SC01-PLUS                       | Wireless-Tag | <https://www.wireless-tag.com/portfolio/wt32-sc01-plus/> |
 | ESP32-2432S028                       | Sunton | <https://www.espressif.com/en/products/devkits/esp32-2432s028> |
 | JC3248W535                           | Guition | <https://www.aliexpress.com/item/1005007566332450.html> |
@@ -125,7 +126,7 @@ most of the configuration will be set by default, but can be overridden if neede
 
 - **invert_colors** (*Optional*, boolean): Specifies whether the display colors should be inverted. Options are `true` or `false`. Defaults to `false`.
 - **rotation** (*Optional*): Rotate the display presentation in software. Choose one of `0°`, `90°`, `180°`, or `270°`. If the driver chip supports hardware rotation for the given orientation this will be translated to the appropriate hardware command. If hardware rotation is not supported, the display will be rotated in software.
-- **transform** (*Optional*): If `rotation` is not sufficient, use this to transform the display. If this option is specified, then the `dimensions` option must also be provided. Options are:
+- **transform** (*Optional*): If `rotation` is not sufficient, use this to transform the display. If this option is specified, then the `dimensions` option must also be provided. The value can either be the string `disabled` to disable hardware transform, or a dictionary. Options are:
 
   - **swap_xy** (**Required**, boolean): If true, exchange the x and y axes.
   - **mirror_x** (**Required**, boolean): If true, mirror the x axis.
@@ -201,6 +202,8 @@ dimensions:
   width: 320
 ```
 
+When using the `CUSTOM` model with rotation, if the chip does not support hardware transform use `transform: disabled` to disable hardware transform and ensure software rotation.
+
 ## LCD Backlights
 
 Many displays have an integrated backlight, which may need to be turned on for the display to show. This backlight is not controlled

content/changelog/images/changelog-2025.10.0.png

@@ -171,6 +171,10 @@ LWIP (Lightweight IP) behavior. Some options improve performance while others sa
 - **enable_lwip_check_thread_safety** (*Optional*, boolean): Enable LWIP thread safety checks to detect incorrect usage of
   the TCP/IP stack from multiple threads. This helps catch thread safety issues when core locking is enabled. Defaults to `true`.
 
+- **disable_libc_locks_in_iram** (*Optional*, boolean): Disable placing libc lock functions in IRAM. This saves approximately
+  1.3 KB of IRAM by placing these functions in flash memory instead. This is safe for ESPHome since no IRAM interrupt service
+  routines (ISRs that run while cache is disabled) use libc lock APIs. Defaults to `true` (IRAM placement disabled to save RAM).
+
 Some options can be disabled to save flash memory without affecting typical ESPHome functionality. The performance
 options (defaulting to `true`  ) improve socket operation performance but can be disabled if you need better
 multi-threaded scalability (which is uncommon since ESPHome uses an event loop).
@@ -189,6 +193,7 @@ esp32:
       enable_lwip_check_thread_safety: true  # Thread safety validation
 
       # Memory saving options
+      disable_libc_locks_in_iram: true  # Enabled by default, saves 1.3 KB IRAM
       enable_lwip_dhcp_server: false  # Disabled by default, only needed for AP mode
       enable_lwip_mdns_queries: false  # Enabled by default, can disable if not using .local hostnames
       enable_lwip_bridge_interface: false  # Disabled by default

content/components/display/mipi_spi.md

@@ -169,5 +169,5 @@ color:
 > - Setting `y_grid` will expand any specified range to the nearest multiple of grid spacings.
 > - Axis labels are currently not possible without manually placing them.
 > - The grid and border color is set with `it.graph()`, while the traces are defined separately.
-> - Legends are drawn separately using `it.graph_legend()` and can be positioned independently of the graph.
+> - Legends are drawn separately using `it.legend()` and can be positioned independently of the graph.
 > - Legend dimensions are automatically calculated if not specified, based on font sizes and trace count.

content/components/esp32.md

@@ -410,6 +410,8 @@ on_...:
 - **white** (*Optional*, [templatable](#config-templatable), percentage): The brightness to set the white channel
   to.
 
+## Light Conditions
+
 {{< anchor "light-is_on_condition" >}}
 {{< anchor "light-is_off_condition" >}}
 
@@ -427,6 +429,8 @@ on_...:
       light.is_on: my_light
 ```
 
+## Light Triggers
+
 {{< anchor "light-on_turn_on_off_trigger" >}}
 
 ### `light.on_turn_on` / `light.on_turn_off` Trigger

content/components/graph.md

@@ -443,8 +443,8 @@ Here is the complete example configuration for {{< docref "ld2450/" >}}.
 
 ```yaml
 esphome:
-  name: ld2540-radar
-  friendly_name: ld2540-radar
+  name: ld2450-radar
+  friendly_name: ld2450-radar
 
 esp32:
   board: wemos_d1_mini32

content/components/light/_index.md

@@ -18,6 +18,7 @@ possible to configure devices directly in this component, but this has no applic
 # Example configuration entry
 usb_host:
   enable_hubs: true
+  max_transfer_requests: 32  # For high-throughput devices like USB UART at 115200+ baud
   devices:
     - id: device_0
       vid: 0x1725
@@ -28,6 +29,7 @@ usb_host:
 
 - **id** (*Optional*, [ID](#config-id)): The id to use for this component.
 - **enable_hubs** (*Optional*, boolean): Whether to include support for hubs. Defaults to `false`.
+- **max_transfer_requests** (*Optional*, int): Maximum number of concurrent USB transfer requests. Range: 1-32. Defaults to `16`. Increase this value for high-throughput devices (e.g., USB UART at 115200+ baud) if you see "All X transfer slots in use" errors.
 - **devices** (*Optional*, list): A list of devices to configure.
 
 ## Device configuration options

content/components/sensor/ld2450.md

@@ -10,8 +10,10 @@ params:
 Starting with ESPHome 2026.1.0, the default framework for ESP32 will change from Arduino to ESP-IDF. This guide will
 help you migrate your existing configurations or make an informed choice about which framework to use.
 
-Note: The Arduino framework is integrated as an ESP-IDF component, providing Arduino API compatibility
-within the ESP-IDF build system.
+> [!NOTE]
+> The Arduino framework is built as an ESP-IDF component on top of ESP-IDF, providing Arduino API compatibility
+> within the ESP-IDF build system. This means Arduino builds include both the ESP-IDF framework and the Arduino
+> compatibility layer, resulting in longer build times, more flash usage, and more RAM usage compared to native ESP-IDF.
 
 > [!NOTE]
 > This change only affects ESP32, ESP32-S2, ESP32-S3, and ESP32-C3 variants.
@@ -113,15 +115,15 @@ when available:
 
 **Arduino-Only Components:**
 
-The following components currently require Arduino framework and don't have ESP-IDF alternatives yet:
+The following components currently require Arduino framework and don't have ESP-IDF alternatives or native ESP-IDF support yet:
 
 - {{< docref "/components/output/ac_dimmer" "ac_dimmer" >}} - AC dimmer control
 - {{< docref "/components/sensor/dsmr" "dsmr" >}} - Dutch Smart Meter integration
 - {{< docref "/components/climate/climate_ir" "heatpumpir" >}} - IR-based heat pump control
 - {{< docref "/components/climate/midea" "midea" >}} - Midea air conditioner control
 - {{< docref "/components/light/index" "WLED Effect" >}} - WLED UDP Realtime Control integration
 
-If you need these components, you should continue using the Arduino framework.
+If you need these components, you will need to continue using the Arduino framework.
 
 > [!NOTE]
 > Component compatibility is constantly improving. Check the component documentation
@@ -140,13 +142,15 @@ If you encounter compilation errors after switching to ESP-IDF:
 
 ### Build Time
 
-ESP-IDF compilation takes approximately 25% longer than Arduino:
+ESP-IDF compilation is significantly faster than Arduino:
+
+- **ESP-IDF is 2-3x faster** than Arduino framework
+- On modern desktop systems: ESP-IDF saves 30-60 seconds per build
+- On Raspberry Pi 5: ESP-IDF saves 2-4 minutes per build
+- On Raspberry Pi 4 or older: ESP-IDF saves 6-10 minutes or more per build
+- Subsequent builds maintain the same relative performance advantage
 
-- On modern desktop systems: ~15-30 seconds additional time
-- On Raspberry Pi 5: ~1 minute additional time
-- On Raspberry Pi 4 or older: 3-5 minutes additional time
-- Subsequent builds are faster but still proportionally slower
-- The longer build time is due to ESP-IDF's more comprehensive optimization process
+The faster build times are due to ESP-IDF's optimized build system and the elimination of the Arduino compatibility layer overhead.
 
 ### Performance Considerations