From afed1384bffb1870d1e144e36a3cfc1eb0f02791 Mon Sep 17 00:00:00 2001
From: BerlinJoker <40592241+BerlinJoker@users.noreply.github.com>
Date: Mon, 15 May 2023 20:30:58 +0200
Subject: [PATCH] add note about default SPI pin usage for
 stability/performance (#2921)

The current SPI documentation doesn't mention that there is a difference in how ESPs work depending on which GPIOs are chosen for the SPI setup. While in theory all regular GPIOs can be used (and might work for a lot of people/setups), using the dedicated default SPI pins can be the missing puzzle piece for unstable ESP/device combinations

https://techoverflow.net/2021/07/26/what-is-the-spi-pinout-of-the-esp32-esp-wroom-32/

https://randomnerdtutorials.com/esp8266-pinout-reference-gpios/
---
 components/spi.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/components/spi.rst b/components/spi.rst
index 8cac04e9c..5b61fa36b 100644
--- a/components/spi.rst
+++ b/components/spi.rst
@@ -44,6 +44,8 @@ Configuration variables:
 - **force_sw** (*Optional*, boolean): Whether software implementation should be used even if hardware one is available.
 - **id** (*Optional*, :ref:`config-id`): Manually specify the ID for this SPI hub if you need multiple SPI hubs.
 
+**Please note:** while both ESP8266 and ESP32 support the reassignment of the default SPI pins to other GPIO pins, using the dedicated SPI pins can improve performance and stability for certain ESP/device combinations.
+
 See Also
 --------