readme and troubleshooting updates

Author: Mattboxx

README.md

@@ -52,6 +52,41 @@ Install the library directly from its public GitHub repository:
 lib_deps = https://github.com/mattbox03/Find_My_adv_ESP_library.git
 ```
 
+ESP32, ESP32-C3, and ESP32-S3 can use the stable PlatformIO platform:
+
+```ini
+[env:esp32c3]
+platform = espressif32@7.0.1
+board = esp32-c3-devkitm-1
+framework = arduino
+lib_deps = https://github.com/mattbox03/Find_My_adv_ESP_library.git
+```
+
+ESP32-C6 needs an Arduino-ESP32 3.x platform. This configuration is tested:
+
+```ini
+[env:esp32c6]
+platform = https://github.com/pioarduino/platform-espressif32/releases/download/55.03.39/platform-espressif32.zip
+platform_packages =
+    framework-arduinoespressif32 @ https://github.com/espressif/arduino-esp32/releases/download/3.3.9/esp32-core-3.3.9.tar.xz
+board = esp32-c6-devkitc-1
+framework = arduino
+lib_deps = https://github.com/mattbox03/Find_My_adv_ESP_library.git
+```
+
+On a Windows machine that has already installed Arduino-ESP32 2.x, PlatformIO
+may reuse that same-named framework package instead of the C6 override. Build
+the C6 environment with an isolated package directory to avoid the collision:
+
+```powershell
+$env:PLATFORMIO_PACKAGES_DIR="$PWD\.pio-packages-c6"
+pio run -e esp32c6
+```
+
+The first isolated build downloads the complete C6 toolchain and can take
+several minutes. Later builds reuse `.pio-packages-c6`. See
+[`docs/TROUBLESHOOTING.md`](docs/TROUBLESHOOTING.md) for the Bash equivalent.
+
 For a local checkout, copy the complete `FindMyAdv` directory into the
 project's `lib` directory:
 

docs/README.it.md

@@ -18,9 +18,39 @@ una radio Bluetooth.
 
 ## Installazione
 
-Con PlatformIO, copia l'intera cartella `FindMyAdv` nella cartella `lib` del
-progetto. Con Arduino IDE, installa lo ZIP della libreria tramite **Sketch >
-Include Library > Add .ZIP Library**.
+Con PlatformIO puoi installare direttamente la libreria pubblica:
+
+```ini
+lib_deps = https://github.com/mattbox03/Find_My_adv_ESP_library.git
+```
+
+ESP32, ESP32-C3 ed ESP32-S3 possono usare `espressif32@7.0.1`. Per ESP32-C6
+serve Arduino-ESP32 3.x; questa configurazione è verificata:
+
+```ini
+[env:esp32c6]
+platform = https://github.com/pioarduino/platform-espressif32/releases/download/55.03.39/platform-espressif32.zip
+platform_packages =
+    framework-arduinoespressif32 @ https://github.com/espressif/arduino-esp32/releases/download/3.3.9/esp32-core-3.3.9.tar.xz
+board = esp32-c6-devkitc-1
+framework = arduino
+lib_deps = https://github.com/mattbox03/Find_My_adv_ESP_library.git
+```
+
+Se su Windows è già presente Arduino-ESP32 2.x, PlatformIO può riutilizzare
+per errore quel pacchetto omonimo al posto del core C6. Usa una cache isolata:
+
+```powershell
+$env:PLATFORMIO_PACKAGES_DIR="$PWD\.pio-packages-c6"
+pio run -e esp32c6
+```
+
+Il primo avvio scarica l'intera toolchain e può richiedere diversi minuti; le
+compilazioni successive riutilizzano `.pio-packages-c6`.
+
+Per un'installazione locale puoi invece copiare l'intera cartella `FindMyAdv`
+nella cartella `lib` del progetto. Con Arduino IDE, installa lo ZIP della
+libreria tramite **Sketch > Include Library > Add .ZIP Library**.
 
 ## Uso minimo
 

docs/TROUBLESHOOTING.md

@@ -44,6 +44,27 @@ This cannot be solved transparently by two independent libraries.
 ## C6/H2 does not compile
 
 Use an Arduino-ESP32 3.x platform that includes NimBLE for the selected target.
-The standalone Find_My_Web project pins a known C6-compatible pioarduino
-platform as a reproducible reference.
+The repository's `ci/platformio.ini` pins a tested C6-compatible pioarduino
+platform and Arduino-ESP32 core.
 
+PlatformIO stores packages by canonical name. If Arduino-ESP32 2.x is already
+installed, it may be selected instead of a same-named 3.x override and cause an
+early framework error such as `FRAMEWORK_DIR None`. Isolate the C6 packages
+from the global cache:
+
+PowerShell:
+
+```powershell
+$env:PLATFORMIO_PACKAGES_DIR="$PWD\.pio-packages-c6"
+pio run -e esp32c6
+```
+
+Bash:
+
+```bash
+PLATFORMIO_PACKAGES_DIR="$PWD/.pio-packages-c6" pio run -e esp32c6
+```
+
+Keep the `platform` and `platform_packages` values shown in the main README.
+The first build downloads the complete framework and RISC-V toolchain; later
+builds reuse the isolated directory.