reword ESP32-S3 octal SPI pins warning

schlimmchen · Sep 9, 2024 · 2e8698e · 2e8698e
1 parent 4cf6332
commit 2e8698e
Show file tree

Hide file tree

Showing 2 changed files with 11 additions and 7 deletions.
diff --git a/docs/hardware/esp32s3_devkit.md b/docs/hardware/esp32s3_devkit.md
@@ -10,9 +10,11 @@ guide](https://docs.espressif.com/projects/esp-idf/en/stable/esp32s3/hw-referenc
 
 !!!warning "Reserved Pins"
     Modules with 8 MB of PSRAM or 16 MB or more of flash memory use an octal
-    SPI interface. Pins GPIO35, GPIO36 and GPIO37 are used for the internal
-    communication between ESP32-S3 and SPI flash/PSRAM memory, thus not
-    available for external use.
+    SPI interface. On these modules, pins GPIO 35, 36, and 37, which are
+    usually wired to the DevKit board's pin header, are in use for the internal
+    communication between ESP32-S3 and SPI flash/PSRAM memory. Thus these pins
+    are **not** available for external use, even though they are wired to the
+    DevKit board's pin header.
 
 !!!warning "Avoid UART0"
     Avoid using UART0 (GPIO43, GPIO44) to connect a peripheral, as it is

diff --git a/docs/hardware/recommendations.md b/docs/hardware/recommendations.md
@@ -21,11 +21,13 @@ is possibly not connected natively to the USB port. There are boards with two
 USB connectors, where one does connect natively to the ESP32. In that case, the
 board is fine.
 
-!!!warning
+!!!warning "ESP32-S3 Reserved Pins"
     Modules with 8 MB of PSRAM or 16 MB or more of flash memory use an octal
-    SPI interface. Pins GPIO35, GPIO36 and GPIO37 are used for the internal
-    communication between ESP32-S3 and SPI flash/PSRAM memory, thus not
-    available for external use.
+    SPI interface. On these modules, pins GPIO 35, 36, and 37, which are
+    usually wired to the DevKit board's pin header, are in use for the internal
+    communication between ESP32-S3 and SPI flash/PSRAM memory. Thus these pins
+    are **not** available for external use, even though they are wired to the
+    DevKit board's pin header.
 
 | Name                    | Flash | PSRAM | Antenna   |
 | ----------------------- | ----- | ----- | --------- |