U-Boot · source analysis

MMC 초기화와 block device 연결

MMC block child가 먼저 생기고, probe에서 카드가 초기화되며, 읽기는 별도 경로로 흐릅니다.

Series
12 / 22
Baseline
v2026.07
Commit
ece349ade297
Source
drivers/mmc/mmc.c:3107-3195 (발췌 범위)

block descriptor는 언제 만들어지고, 언제 믿을 수 있는가?

mmc_bind()는 block child를 묶으며 blk_desc를 기본 block 크기와 lba=0으로 만든다. 카드 용량이 알려졌다는 뜻은 아니다. blk_get_desc() 등이 그 child를 probe하면 mmc_blk_probe()가 mmc_init()을 호출한다.

이 글은 U-Boot v2026.07 고정 commit의 driver-model + block 구성에서 bind, 초기화, block 읽기를 구별한다. 보드의 host driver와 빌드 옵션에 따라 진입 경로·카드 협상은 달라질 수 있다.

host, MMC 객체, block child의 관계

그림 1. bind 시점에는 child와 descriptor가 존재하지만 카드 용량은 아직 0
parent udeviceMMC host driverhost ops와 struct mmc를 연결한다. 실제 controller probe는 host driver가 맡는다.
mmc_bindstruct mmccard protocol·host caps·has_init 상태를 보유하고 block child를 bind한다.
blk_create_devicefmmc_blk child + blk_desc초기 blksz=DEFAULT_BLKSZ, lba=0. probe 성공 뒤 실제 용량을 채운다.
객체의 존재 ≠ 사용 가능한 카드. mmc_startup()이 blksz·lba를 갱신한다.

근거: mmc-uclass.c L427–465, mmc.c L2764–2771.

probe와 읽기는 다른 경로다

그림 2. block child probe가 카드 초기화를 부르고, 이후 읽기는 cache를 거칠 수 있다
bind · 초기화
  1. mmc_bind: child bind
  2. blk_get_desc: child probe
  3. mmc_blk_probe: mmc_init
  4. mmc_start_init → mmc_startup
  5. descriptor의 lba 갱신
block 읽기
blk_read → cache 조회
HIT ↳요청 block 수 반환. host 명령 없음.
MISS ↳mmc_bread → hwpart·범위·blocklen 검사 → mmc_read_blocks

두 번째 줄은 첫 번째 줄의 필수 후속 호출이 아니다. 이미 probe된 장치의 I/O 경로이며 cache hit면 MMC 명령을 보내지 않는다. blk-uclass.c L432–468.

단계별로 신뢰할 수 있는 상태

고정 commit의 driver-model + block 경로 기준이다. mmc_init()을 직접 호출하거나 preinit을 사용하는 구성은 진입 시점이 달라질 수 있다.

경계진입/동작그때 신뢰할 상태아직 단정하면 안 되는 것
bindmmc_bind → blk_create_devicefblock child와 descriptor, 기본 block 크기, lba=0카드 존재·용량·probe 성공
probeblk_get_desc의 device_probe → mmc_blk_probe성공 시 mmc_init 반환 0모든 호출자가 같은 경로로 진입한다는 보장
card initmmc_start_init → mmc_complete_init/mmc_startup성공 시 has_init=1, 실제 blksz/lba실패 뒤 descriptor가 제거된다는 보장
readblk_read → cache 또는 mmc_bread완전한 읽기면 요청 block 수 반환cache hit에서 host 명령이 발생했다는 주장

원본 코드

아래 코드는 U-Boot v2026.07의 drivers/mmc/mmc.c에서 3107-3195줄을 그대로 가져온 것이다.

commitece349ade2973e220f524ce59e59711cc919263fanchor · L3131int mmc_init(struct mmc *mmc)
3107
3108	if (!err)
3109		err = mmc_startup(mmc);
3110	if (err)
3111		mmc->has_init = 0;
3112	else
3113		mmc->has_init = 1;
3114	return err;
3115}
3116
3117static void mmc_cyclic_cd_poll(struct cyclic_info *c)
3118{
3119	struct mmc *m = container_of(c, struct mmc, cyclic);
3120
3121	if (!m->has_init)
3122		return;
3123
3124	if (mmc_getcd(m))
3125		return;
3126
3127	mmc_deinit(m);
3128	m->has_init = 0;
3129}
3130
3131int mmc_init(struct mmc *mmc)
3132{
3133	int err = 0;
3134	__maybe_unused ulong start;
3135#if CONFIG_IS_ENABLED(DM_MMC)
3136	struct mmc_uclass_priv *upriv = dev_get_uclass_priv(mmc->dev);
3137
3138	upriv->mmc = mmc;
3139#endif
3140	if (mmc->has_init)
3141		return 0;
3142
3143	start = get_timer(0);
3144
3145	if (!mmc->init_in_progress)
3146		err = mmc_start_init(mmc);
3147
3148	if (!err)
3149		err = mmc_complete_init(mmc);
3150	if (err) {
3151		pr_info("%s: %d, time %lu\n", __func__, err, get_timer(start));
3152		return err;
3153	}
3154
3155	if (CONFIG_IS_ENABLED(CYCLIC, (!mmc->cyclic.func), (NULL))) {
3156		/* Register cyclic function for card detect polling */
3157		cyclic_register(&mmc->cyclic, mmc_cyclic_cd_poll, 100 * 1000,
3158				mmc->cfg->name);
3159	}
3160
3161	return err;
3162}
3163
3164int mmc_deinit(struct mmc *mmc)
3165{
3166	u32 caps_filtered;
3167
3168	if (CONFIG_IS_ENABLED(CYCLIC, (mmc->cyclic.func), (NULL)))
3169		cyclic_unregister(&mmc->cyclic);
3170
3171	if (!CONFIG_IS_ENABLED(MMC_UHS_SUPPORT) &&
3172	    !CONFIG_IS_ENABLED(MMC_HS200_SUPPORT) &&
3173	    !CONFIG_IS_ENABLED(MMC_HS400_SUPPORT))
3174		return 0;
3175
3176	if (!mmc->has_init)
3177		return 0;
3178
3179	if (IS_SD(mmc)) {
3180		caps_filtered = mmc->card_caps &
3181			~(MMC_CAP(UHS_SDR12) | MMC_CAP(UHS_SDR25) |
3182			  MMC_CAP(UHS_SDR50) | MMC_CAP(UHS_DDR50) |
3183			  MMC_CAP(UHS_SDR104));
3184
3185		return sd_select_mode_and_width(mmc, caps_filtered);
3186	} else {
3187		caps_filtered = mmc->card_caps &
3188			~(MMC_CAP(MMC_HS_200) | MMC_CAP(MMC_HS_400) | MMC_CAP(MMC_HS_400_ES));
3189
3190		return mmc_select_mode_and_width(mmc, caps_filtered);
3191	}
3192}
3193
3194int mmc_set_dsr(struct mmc *mmc, u16 val)
3195{

발췌 범위와 읽기 기준

원본 89행은 고정 commit의 drivers/mmc/mmc.c L3107–3195와 줄마다 일치한다. L3107은 mmc_complete_init()의 말미이고 L3131에서 mmc_init()이 시작한다. 마지막은 mmc_set_dsr()의 시작이다.

L3140–3141의 has_init 재사용, L3145–3149의 분할 초기화, L3155–3159의 조건부 card-detect cyclic 등록을 읽는다. block child의 생성·probe와 descriptor 용량 설정은 이 발췌 밖의 mmc-uclass.c 및 mmc_startup()에서 확인한다.

세 가지 경계를 따라 원본 읽기

01

bind는 초기화 완료가 아니다

mmc_bind()는 ops를 확인하고 mmc_blk child를 만든다. descriptor는 이때 이미 생기지만 LBA는 0이다. parent host의 probe와 card negotiation을 이 단계에 합치지 않는다.

02

block child probe에서 카드 초기화

blk_get_desc()는 선택한 block child를 device_probe()한다. mmc_blk_probe()가 mmc_init()을 호출하며, 실패한 errno를 위로 돌려보낸다. 이미 has_init이면 mmc_init()은 즉시 성공한다.

03

카드 협상과 실제 geometry

mmc_start_init()은 카드 감지 및 operating condition 협상을 진행하고, mmc_complete_init()이 mmc_startup()을 호출한다. startup은 카드 정보를 바탕으로 모드/폭을 선택한 뒤 descriptor의 blksz와 lba를 채운다. 실패하면 has_init=0이다.

04

block read의 별도 조건

blk_read()는 block cache를 먼저 확인한다. miss에서 MMC ops의 mmc_bread()가 hardware partition 선택, LBA 범위, block length를 검사한 다음 chunk별로 읽는다. cache hit를 host I/O로 세면 분석이 틀어진다.

LBA가 0이 아니어도 초기화 완료는 아니다. mmc_startup() 앞부분의 mmc_set_capacity()가 먼저 descriptor의 LBA를 갱신하고, 이후 mode 선택은 실패할 수 있다. 최종 geometry와 has_init, 함수 반환값을 함께 봐야 한다. mmc_bind()도 block child 생성 뒤 bootdev_setup_for_sibling_blk()에서 실패할 수 있으며 이 함수 안에서 child를 되돌리는 경로는 없다.

blk_read()는 read 연산이 없으면 -ENOSYS, bounce buffer 준비가 실패하면 그 오류를 반환할 수 있다. 이는 MMC 하위 읽기 함수의 0 반환과 별개다. mmc_bread()가 뒤쪽 chunk에서 실패해 0을 반환해도 앞선 chunk가 이미 목적 버퍼에 기록됐을 수 있다. 0을 버퍼 불변이나 I/O 미실행의 증거로 쓰지 않는다.

poll 경로는 mmc_deinit()의 반환값을 검사하지 않고 has_init=0을 기록한다. mmc_deinit() 자체가 항상 이 flag를 지우는 것은 아니다. 카드 제거 감지, mode 변경 성공, 초기화 flag를 같은 사건으로 합치지 않는다.

초기화 성공과 읽기 성공의 계약

그림 3. descriptor의 두 시점: 객체 생성과 geometry 확정
boundlba = 0blk_create_devicef()가 descriptor를 만들지만, 아직 카드 용량은 확정되지 않았다.
card startup succeededlba = capacity / read_bl_lenmmc_startup()이 실제 block length와 LBA를 채우고, mmc_complete_init()이 has_init=1로 표시한다.
01

SD/eMMC·빌드 옵션의 분기

mmc_startup()은 SD와 MMC에서 capability 및 mode/width 선택 함수를 나눈다. MMC_TINY는 별도 legacy 설정 경로다. 이 차이를 하나의 필수 clock 전환으로 그릴 수 없다.

02

hardware partition과 cache

mmc_bread()은 현재 hwpart를 선택한다. mmc_select_hwpart()은 전환 성공 시 block cache를 무효화한다. 같은 LBA라도 hwpart가 바뀌면 다른 주소 공간이다.

03

재사용과 카드 제거

기존 has_init이면 mmc_init()은 재협상 없이 0을 반환한다. 조건부 cyclic card-detect poll은 카드가 사라지면 mmc_deinit()을 부르고 has_init=0으로 바꾼다. 이것을 모든 구성의 상시 감지로 일반화하지 않는다.

누가 만들고 누가 소비하는가

대상생성/갱신소비자와 확인점
MMC parent udevicehost driver의 bind/probe 경로mmc_blk_probe가 parent의 mmc_uclass_priv를 읽는다.
struct mmcmmc_bind가 config와 parent를 연결; mmc_init이 card 상태 갱신has_init과 init_in_progress를 구분한다.
mmc_blk childmmc_bind의 blk_create_devicefblock API가 probe할 때 mmc_blk_probe 실행.
struct blk_descbind 때 lba=0; startup 성공 뒤 capacity 반영block 읽기의 hwpart·LBA 경계가 된다.

어느 경계에서 멈췄는가

그림 4. 오류는 bind, card init, read에서 서로 다르게 돌아온다
bindops 없음 / child 생성 실패mmc_bind()가 오류를 반환한다. card 초기화까지 간 것이 아니다.
probe카드 없음 / 협상 실패mmc_start_init() 또는 mmc_complete_init()의 오류가 mmc_blk_probe()로 전파된다.
readhwpart·범위·전송 실패mmc_bread()는 이 경로에서 읽은 block 수 대신 0을 반환한다.
조건고정 소스의 결과확인할 값
카드가 없다는 감지 결과mmc_start_init의 -ENOMEDIUM, has_init=0detect 신호와 host ops
startup 실패mmc_complete_init이 has_init=0, probe 오류실패한 command/response와 mode
LBA가 descriptor 범위 밖mmc_bread이 0 block 반환start, blkcnt, lba, hwpart

고정 소스와 보드에서 확인할 증거

보드 명령은 해당 U-Boot 구성에서 제공될 때만 사용한다. nm은 C 선언문이 아니라 심볼 이름을 출력한다.

목적명령/관찰판정
구성 확인grep -E 'CONFIG_(DM_MMC|BLK|MMC_TINY)=' .config이 글의 driver-model + block 경로가 활성화됐는지 확인.
심볼 확인${CROSS_COMPILE}nm -n u-boot | grep -E ' (T|t) mmc_init$'해당 이미지에 함수 심볼이 있는지 확인. 최적화·구성에 따라 없을 수 있다.
device treedm treeMMC parent와 block child의 bind/probe 상태를 구별.
card 상태mmc list, mmc dev <n>, mmc info선택·probe가 상태를 바꿀 수 있으므로 호출 전후를 함께 기록.
원본 대조blk-uclass.c와 mmc-uclass.cprobe와 read의 서로 다른 함수 경계를 확인.

단계를 구분해 확인하기

  1. 01
    bind와 probe 구분

    dm tree에서 MMC parent와 block child를 찾고, 카드 조회 전후의 probe 상태를 기록한다. block child가 보인다는 사실만으로 lba가 채워졌다고 판단하지 않는다.

  2. 02
    카드 협상 경계

    mmc_init, mmc_start_init, mmc_complete_init의 반환값과 has_init, 카드 감지 결과를 함께 기록해 첫 오류 지점을 찾는다.

  3. 03
    읽기 경계

    검증용 카드에서 block read의 hwpart, 요청 LBA/개수, 반환 block 수를 기록한다. cache hit 여부도 함께 확인해 host command 수와 API 호출 수를 혼동하지 않는다.

원문과 다음 글