zephyr,sdhc-emul-card (on sd bus)

Description

Zephyr SDHC emulated card peripheral

Emulates SD, SDHC, SDXC, eMMC, or SDIO card personalities.
Must be a child of a "zephyr,sdhc-emul-controller" node.

Properties

Properties not inherited from the base binding file.

Name

Type

Details

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