h3n3/NSPanel_HA_Blueprint
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Merge pull request #1801 from illuzn/doc_update

Browse Source 
Documentation Enhancement: Add note about bluetooth proxy RAM usage
This commit is contained in:
Edward Firmo
2024-02-16 00:53:41 +01:00
committed by GitHub
parent d411a207cb 3fa3552768
commit fbfdaa6d3b
1 changed files with 10 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
docs/customization.md
View File

@@ -566,10 +566,20 @@ esp32:
``` ```
### Bluetooth proxy ### Bluetooth proxy
<!-- markdownlint-disable MD028 -->
> [!IMPORTANT] > [!IMPORTANT]
> The [ESP32 Platform](#framework-esp-idf) component should be configured to use the `esp-idf` framework, > The [ESP32 Platform](#framework-esp-idf) component should be configured to use the `esp-idf` framework,
> as the `arduino` framework uses significantly more memory and performs poorly with the Bluetooth proxy enabled. > as the `arduino` framework uses significantly more memory and performs poorly with the Bluetooth proxy enabled.
> [!NOTE]
> The Bluetooth proxy component significantly reduces device RAM, leaving less than 10k RAM free.
> Enabling this with additional customizations/components may lead to crashes due to low memory.
> HTTPS connections might be erratic, and local TFT flashing could fail due to insufficient RAM.
>
> Solutions include:
> 1. Flash the device (remove Bluetooth proxy) while updating TFT.
> 2. Flash from a local (HTTP) source at a low baud rate (9600 or lower) to avoid memory crashes. This method is slower, taking over 10 minutes.
<!-- markdownlint-enable MD028 -->
```yaml ```yaml
# Enable Bluetooth proxy # Enable Bluetooth proxy
bluetooth_proxy: bluetooth_proxy: