devb-sdmmc-*

Updated: April 19, 2023

Generic information for SDHI memory card, MMC, and eMMC drivers

Note: You must be root or have the right abilities to start this driver.

Syntax:

devb-sdmmc-variant [blk option[,option]..
                   [cam option[,option]...]
                   [disk option[,option]...]
                   [sdmmc option[,option]...]
                   [sdio option[,option]...]
                   [fs_type options]

Runs on:

QNX Neutrino

Options:

Note: Use commas (,) to separate the options. You can put the blk, cam, sdmmc, sdio, and disk groups of options in any order.
blk options
The blk options control the io-blk.so driver. If specified, they must follow the blk keyword. For more information, see io-blk.so.
cam options
The cam options control libcam.so. If specified, they must follow the cam keyword.
disk options
The disk options control the driver's interface to cam-disk.so. If specified, they must follow the disk keyword.
sdmmc options:
The sdmmc options control the driver's interface to the SD/MMC device. If there are multiple SD/MMC devices, you can repeat these options for each controller. Remember, however, to specify the sdmmc keyword before each controller's set of options.
bkops=on|auto
This option is specific to the firmware that runs on the eMMC device. With this option, you enable the background operations using one of the following values:
  • on—indicates to the firmware that background operations are required and that the driver will issue commands to allow the eMMC device to perform background operations
  • auto—indicates to the firmware to handle all operations autonomously (as supported in the eMMC 5.1 specification)
By default, this option isn’t enabled.
busno=bus
The bus number of the SDIO controller.
cache=on
Enable eMMC volatile cache. The default is off.
partitions=on
Enable the eMMC partitions. The default is off.
priority=prio
Set the priority of the processing thread. The default is 21.
pwroff_notify=[short|long]
Set power off notification mode for the eMMC. The notification can either be short or long.
verbose=[level]
Set the verbosity level.
sdio options:
The sdio options control the driver's interface to the SD/MMC host controller. If there are multiple host controllers, you can repeat these options for each controller. Remember, however, to specify the sdio keyword before each controller's set of options.
~ac12
Disable AC12. The default is on.
~ac23
Disable AC23. The default is on.
addr=addr
The address of the interface.
~bmstr
Disable DMA.
bs=board-specific
Board-specific options. Run the use message on the target to get more information about the board-specific options available on your target for your driver.
bw=[~]bw
Set/Clear bus widths (4, 8).
clk=clk
Set the operational clock.
did=device_id
The device ID of the controller.
dma=channel
The DMA channel to use.
drv_type=drv_strength
Set the driver strength value for the HS_TIMING register. The driver strength value controls the impedance at which the HS200- or HS400-compatible eMMC chip drives communication lines to the SoC. The accepted values are 0–4. These values align with the I/O driver strength types listed in the JEDEC eMMC standard (document JESD84).
Note: Not all eMMC chips support driver strength values greater than 0. The default value is 0.
emmc
An eMMC device is connected to the interface.
idx=idx
The index of the controller in the machine, where idx is a value between 0 and the number of adapters.
irq=req
The interrupt used by the controller.
hc=name
The name of the host controller.
pm=idle:sleep
Set the power management idle/sleep time in milliseconds (ms). The default is 100:10000 ms.
timing=[~]timing
Set/Clear timings. The valid values to use are hs, ddr, sdr12, sdr25, sdr50, sdr104, hs200, hs400.
verbose=[level]
Set the SDIO verbosity level.
fs_type options
The fs_type options control any filesystem (fs-*.so) module being loaded. Here, fs_type is the filesystem type, such as qnx6 for the Power-Safe filesystem. For the list of supported filesystem options, see the reference for the corresponding shared object. For example, for qnx6, see fs-qnx6.so.

Examples:

These are examples for the devb-sdmmc-rcar-gen3 driver.

For an SD memory card:
devb-sdmmc-rcar_gen3 blk cache=64m cam pnp, bounce=128k sdio idx=0
For eMMC Flash:
devb-sdmmc-rcar_gen3 blk cache=64m cam bounce=128k mem name=below4G
                     sdio idx=2, emmc disk name=mmc