chore(docs): enhance libraries structure (part 2)

Signed-off-by: Frederic Pillon <frederic.pillon@st.com>
Assisted-by: GitHub Copilot: GPT-6 Luna

Author: fpistm

CI/update/README.md

@@ -16,3 +16,21 @@ The path have to be defined in `update_config.json`.
 
 After file generation, review them carefully and please report any issue
 [here](https://github.com/stm32duino/Arduino_Core_STM32/issues).
+
+## Update the STM32duino library list
+
+Run `python CI/update/stm32libraries.py` from the `Arduino_Core_STM32` repository
+to fetch public STM32duino repositories that contain a root-level
+`library.properties` and refresh the generated section in
+`docs/libraries/index.md`. The script groups libraries by their declared
+category, puts expansion-board libraries in a separate section, includes
+declared dependencies (linking STM32duino dependencies when available), and
+sorts entries alphabetically. Review and commit the updated documentation
+manually; this script is not run by CI.
+
+`REPO_STM32DUINO` in `update_config.json` selects the local directory where
+library repositories are cloned or fetched. Absolute paths are used as
+configured; relative paths are resolved from the `Arduino_Core_STM32` repository
+root. If the file or setting is missing, the script writes the default
+`REPO_STM32DUINO` path (the core repository root), asks you to check the
+configuration, and exits; run it again after reviewing the generated setting.

docs/index.md

@@ -17,7 +17,7 @@ After installation, try the [Blink example](examples/Blink-example.md). For help
 
 - [Supported boards](supported-boards/index.md)
 - [Arduino API reference](API.md)
-- [Libraries](libraries/index.md), including built-in, dedicated, and expansion-board libraries
+- [Libraries](libraries/index.md), including built-in, STM32-specific libraries, and expansion-board libraries
 - [Hosted library API documentation](libraries/Hosted-library-documentation.md)
 
 ## Develop and customize

docs/libraries/additional-libraries.md

@@ -0,0 +1,41 @@
+# Additional Libraries and Compatibility
+
+This page lists Arduino libraries known to work with the STM32 core and
+community-reported library tests. Compatibility can vary by library version,
+board, STM32 device, and connected hardware; check the linked project
+documentation for details. Contributions with additional tested combinations
+are welcome.
+
+## Official Arduino libraries
+
+- [TFT](https://github.com/arduino-libraries/TFT/): use release [1.0.6](https://github.com/arduino-libraries/TFT/releases/tag/1.0.6) or later; otherwise use [Ucglib_Arduino](https://github.com/olikraus/Ucglib_Arduino)
+- [LiquidCrystal](https://github.com/arduino-libraries/LiquidCrystal)
+- [Ethernet](https://github.com/arduino-libraries/Ethernet)
+- [WiFi](https://github.com/arduino-libraries/WiFi)
+
+## Community-tested libraries
+
+| Library | Reported test |
+| --- | --- |
+| [arduino-LoRa](https://github.com/sandeepmistry/arduino-LoRa) | Tested with B-L072Z-LRWAN1 |
+| [Firmata](https://github.com/firmata/arduino) | Supported since release 2.5.7 |
+| [OneWire](https://github.com/PaulStoffregen/OneWire) | Library for Dallas/Maxim 1-Wire chips |
+| [PubSubClient](https://github.com/knolleary/PubSubClient) | Tested on L475 Discovery IoT using Wi-Fi |
+| [RTClib](https://github.com/adafruit/RTClib) | Tested with Adafruit module 3296 |
+| [Ucglib_Arduino](https://github.com/olikraus/Ucglib_Arduino) | Tested with ST7735 |
+| [UIPEthernet](https://github.com/UIPEthernet/UIPEthernet) | Tested with ENC28J60 module |
+
+## Library compatibility
+
+When a library needs to distinguish STM32duino from other Arduino cores, use
+the `ARDUINO_ARCH_STM32` preprocessor macro. The core defines it when compiling
+for STM32duino. For example:
+
+```cpp
+#if defined(ARDUINO_ARCH_STM32)
+// STM32duino-specific code
+#endif
+```
+
+See the [FAQ example](../FAQ.md#how-do-i-know-which-stm32duinolibmaple-core-am-i-running-on)
+for how this macro distinguishes STM32duino from the legacy libmaple core.