ra8_sdcard_cfg_t Struct Reference

User-supplied configuration for ra8_sdcard_init. More...

#include <ra8_sdcard.h>

Data Fields
uint8_t	instance
	SDHI instance index (0 or 1).
ra8_sdhi_bus_width_t	bus_width
	Target bus width (0/1-bit default, 4-bit).

Detailed Description

User-supplied configuration for ra8_sdcard_init.

The driver owns its own internal state instance – one card per host instance, which matches the RA8D2 SDHI silicon.

bus_width selects the data-bus width the init sequence tries to reach after the card is parked in TRAN state:

• 0 (zero-initialized default) or k_ra8_sdhi_bus_width_1bit – stay 1-bit; no bus-width negotiation is attempted.
• k_ra8_sdhi_bus_width_4bit – negotiate the SD 4-bit bus with CMD55 + ACMD6 (ra8_sdhi_set_bus_width_4bit). Best-effort: a card that declines is left at 1-bit and init still succeeds.

The 8-bit width is an eMMC-only capability and is NOT an SD-card option, so it is not accepted here; drive an eMMC device's 8-bit bus directly through ra8_sdhi_set_bus_width_8bit.

Invariant

Only 0 / 1-bit / 4-bit are honored; any other value is treated as "stay 1-bit".

Definition at line 88 of file ra8_sdcard.h.

Field Documentation

bus_width

ra8_sdhi_bus_width_t ra8_sdcard_cfg_t::bus_width

Target bus width (0/1-bit default, 4-bit).

Definition at line 90 of file ra8_sdcard.h.

Referenced by ra8_sdcard_init().

instance

uint8_t ra8_sdcard_cfg_t::instance

SDHI instance index (0 or 1).

Definition at line 89 of file ra8_sdcard.h.

Referenced by ra8_sdcard_init().

---

The documentation for this struct was generated from the following file:

• libs/ra8_hal/inc/ra8_sdcard.h