QUERY · ISSUE

docs: machine.SDCard: clarify, which SPI device is used

openby sebert007opened 2023-03-10updated 2025-11-06

docs

I am using this code here:

    sd = machine.SDCard(slot=SD_SLOT,
                        width=SD_WIDTH,
                        sck=SD_SCK_PIN,
                        mosi=SD_MOSI_PIN,
                        miso=SD_MISO_PIN,
                        cs=SD_CS,
                        freq=SD_FREQ)

However it's not clear, which hardware SPI device is used.

I am using the ESP32-S3 (quad SPIRAM). It seems that SPI id=2 is used.

Is it possible to clarify this on the documentation? Or even let the user specify a parameter?

CANDIDATE · PULL REQUEST

Fixed bug in SPI card suport

closedby nickovsopened 2019-06-16updated 2019-06-17

port-esp32

Fixed a cut-and-paste error that had broken SPI interface support due to changes in the handling of slot numbers.

Also corrected typo in documentation resulting from the move of the SDCard class from the putative storage module to machine.

Assessment

S Sonnet · high

PR #4851 fixes a bug in SPI slot number handling for SDCard and corrects a documentation typo (wrong module name). The query issue #11000 asks for documentation clarification on which hardware SPI device is selected when using machine.SDCard with explicit pin arguments on ESP32-S3. These share the same code area (ports/esp32/machine_sdcard.c, docs/library/machine.SDCard.rst) and general topic (ESP32 SDCard SPI configuration), but PR #4851 does not address the query's specific request: documenting which SPI host is implicitly chosen, or adding a parameter for the user to specify it.

Suggested action

No action needed — PR #4851 is historical context only. The query's documentation request (clarifying implicit SPI device selection on ESP32-S3 when pins are specified directly) remains open and unaddressed.

docs: machine.SDCard: clarify, which SPI device is used

Fixed bug in SPI card suport

Keyboard