zephyr,sdhc-emul

Description

These nodes are “sd” bus nodes.

Zephyr SDHC emulator

Software emulation of an SD host controller that supports SD, SDHC,
SDXC, eMMC, and SDIO card personalities.  Intended for native_sim
testing and CI pipelines.

Properties

Properties not inherited from the base binding file.

Name

Type

Details

max-current-330

int

Max drive current in mA at 3.3V. A value of zero indicates no maximum
is specified by the driver.

Default value: 0

max-current-300

int

Max drive current in mA at 3.0V. A value of zero indicates no maximum
is specified by the driver.

Default value: 0

max-current-180

int

Max drive current in mA at 1.8V. A value of zero indicates no maximum
is specified by the driver.

Default value: 0

max-bus-freq

int

Maximum bus frequency for SD card. This should be the highest frequency
the SDHC is capable of negotiating with cards on the bus.

Default value: 400000

min-bus-freq

int

Minimum bus frequency for SD card. This should be the frequency that
cards first will select when attached to the SDHC bus

Default value: 400000

power-delay-ms

int

time in ms for SDHC to delay when toggling power to the SD card. This
delay gives the card time to power up or down fully

Default value: 500

sd-uhs-modes

string-array

UHS-I bus speed modes the slot supports for SD and SDIO cards. The
host reports a mode only if it is in this list and the controller
supports it. Without this property, the modes the controller
supports are not restricted.

Use this property when a mode the controller supports is not
reliable on the board, for example on a bus that is shared between
slots. A slot where SDR104 tuning fails can be limited to DDR50:

  sd-uhs-modes = "ddr50";

Legal values: sdr50, ddr50, sdr104

mmc-hs200-1_8v

boolean

The host controller supports HS200 at 1.8V

mmc-hs400-1_8v

boolean

The host controller supports HS400 at 1.8V

mmc-hs400-enhanced-strobe

boolean

The host controller and board support eMMC HS400 enhanced strobe.
This mode also requires HS400 at 1.8V and an 8-bit data bus.

bus-width

int

SDHC data bus width (in bits).

Default value: 4

Legal values: 1, 4, 8

high-speed

boolean

Host controller supports SD/eMMC high speed (up to 50 MHz) timing.

voltage-330

boolean

Host controller can supply 3.3 V to the card.

voltage-180

boolean

Host controller can supply 1.8 V signalling.

card-type

string

Virtual card personality.
  sd    - SDSC up to 2 GB
  sdhc  - SDHC 4-32 GB (default)
  sdxc  - SDXC above 32 GB
  emmc  - eMMC 5.1, supports CMD6 EXT_CSD, HS200/HS400
  sdio  - SDIO-only, triggers function enumeration

Default value: sdhc

Legal values: sd, sdhc, sdxc, emmc, sdio

capacity-blocks

int

Number of blocks in the virtual storage.
Default 131072 blocks = 64 MiB at 512 bytes/block.

Default value: 131072

sector-size

int

Block size in bytes. The emulator only supports 512-byte blocks.
Any other value is rejected.

Default value: 512

Constant value: 512

inject-error-cmd

int

CMD index that returns an error for fault injection.
255 disables fault injection.

Default value: 255

card-inserted

boolean

If present, the virtual card is inserted at boot.

host-ocr

int

OCR (Operating Conditions Register) value reported by the emulated
card in response to CMD1 (eMMC) or ACMD41 (SD).

The default 0x00FF8000 sets bits 15-23, advertising every supported
VDD window from 2.7 V to 3.6 V (equivalent to MMC_OCR_VDD27_36FLAG).

Notable bits:
bit 7      - VDD 1.65-1.95 V supported (eMMC only)
bits 15-23 - VDD 2.7-3.6 V windows, one bit per 100 mV step
bit 24     - S18A: card supports switching to 1.8 V signalling
bit 30     - Sector mode for eMMC; for SD cards, CCS is derived
            from card-type
bit 31     - Power-up busy status; set by the emulator at
            runtime and must not be set here

For SD cards, the emulator sets CCS for "sdhc" and "sdxc" and
clears it for "sd", regardless of bit 30 in this property.

Default value: 0xff8000

sdio-func-count

int

Number of SDIO functions to emulate (1-7).

Default value: 1