QUESTION
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와 빌드 옵션에 따라 진입 경로·카드 협상은 달라질 수 있다.
STRUCTURE
host, MMC 객체, block child의 관계
struct mmc를 연결한다. 실제 controller probe는 host driver가 맡는다.has_init 상태를 보유하고 block child를 bind한다.blksz=DEFAULT_BLKSZ, lba=0. probe 성공 뒤 실제 용량을 채운다.mmc_startup()이 blksz·lba를 갱신한다.CALL PATH
probe와 읽기는 다른 경로다
mmc_bind: child bindblk_get_desc: child probemmc_blk_probe:mmc_initmmc_start_init→mmc_startup- descriptor의
lba갱신
blk_read → cache 조회mmc_bread → hwpart·범위·blocklen 검사 → mmc_read_blocks두 번째 줄은 첫 번째 줄의 필수 후속 호출이 아니다. 이미 probe된 장치의 I/O 경로이며 cache hit면 MMC 명령을 보내지 않는다. blk-uclass.c L432–468.
STATE LEDGER
단계별로 신뢰할 수 있는 상태
고정 commit의 driver-model + block 경로 기준이다. mmc_init()을 직접 호출하거나 preinit을 사용하는 구성은 진입 시점이 달라질 수 있다.
| 경계 | 진입/동작 | 그때 신뢰할 상태 | 아직 단정하면 안 되는 것 |
|---|---|---|---|
| bind | mmc_bind → blk_create_devicef | block child와 descriptor, 기본 block 크기, lba=0 | 카드 존재·용량·probe 성공 |
| probe | blk_get_desc의 device_probe → mmc_blk_probe | 성공 시 mmc_init 반환 0 | 모든 호출자가 같은 경로로 진입한다는 보장 |
| card init | mmc_start_init → mmc_complete_init/mmc_startup | 성공 시 has_init=1, 실제 blksz/lba | 실패 뒤 descriptor가 제거된다는 보장 |
| read | blk_read → cache 또는 mmc_bread | 완전한 읽기면 요청 block 수 반환 | cache hit에서 host 명령이 발생했다는 주장 |
UPSTREAM SOURCE
원본 코드
아래 코드는 U-Boot v2026.07의 drivers/mmc/mmc.c에서 3107-3195줄을 그대로 가져온 것이다.
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{
READING CONTRACT
발췌 범위와 읽기 기준
원본 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()에서 확인한다.
DETAILS
세 가지 경계를 따라 원본 읽기
bind는 초기화 완료가 아니다
mmc_bind()는 ops를 확인하고 mmc_blk child를 만든다. descriptor는 이때 이미 생기지만 LBA는 0이다. parent host의 probe와 card negotiation을 이 단계에 합치지 않는다.
block child probe에서 카드 초기화
blk_get_desc()는 선택한 block child를 device_probe()한다. mmc_blk_probe()가 mmc_init()을 호출하며, 실패한 errno를 위로 돌려보낸다. 이미 has_init이면 mmc_init()은 즉시 성공한다.
카드 협상과 실제 geometry
mmc_start_init()은 카드 감지 및 operating condition 협상을 진행하고, mmc_complete_init()이 mmc_startup()을 호출한다. startup은 카드 정보를 바탕으로 모드/폭을 선택한 뒤 descriptor의 blksz와 lba를 채운다. 실패하면 has_init=0이다.
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를 같은 사건으로 합치지 않는다.
IMPLEMENTATION NOTES
초기화 성공과 읽기 성공의 계약
blk_create_devicef()가 descriptor를 만들지만, 아직 카드 용량은 확정되지 않았다.mmc_startup()이 실제 block length와 LBA를 채우고, mmc_complete_init()이 has_init=1로 표시한다.SD/eMMC·빌드 옵션의 분기
mmc_startup()은 SD와 MMC에서 capability 및 mode/width 선택 함수를 나눈다. MMC_TINY는 별도 legacy 설정 경로다. 이 차이를 하나의 필수 clock 전환으로 그릴 수 없다.
hardware partition과 cache
mmc_bread()은 현재 hwpart를 선택한다. mmc_select_hwpart()은 전환 성공 시 block cache를 무효화한다. 같은 LBA라도 hwpart가 바뀌면 다른 주소 공간이다.
재사용과 카드 제거
기존 has_init이면 mmc_init()은 재협상 없이 0을 반환한다. 조건부 cyclic card-detect poll은 카드가 사라지면 mmc_deinit()을 부르고 has_init=0으로 바꾼다. 이것을 모든 구성의 상시 감지로 일반화하지 않는다.
OBJECT LIFETIME
누가 만들고 누가 소비하는가
| 대상 | 생성/갱신 | 소비자와 확인점 |
|---|---|---|
MMC parent udevice | host driver의 bind/probe 경로 | mmc_blk_probe가 parent의 mmc_uclass_priv를 읽는다. |
struct mmc | mmc_bind가 config와 parent를 연결; mmc_init이 card 상태 갱신 | has_init과 init_in_progress를 구분한다. |
mmc_blk child | mmc_bind의 blk_create_devicef | block API가 probe할 때 mmc_blk_probe 실행. |
struct blk_desc | bind 때 lba=0; startup 성공 뒤 capacity 반영 | block 읽기의 hwpart·LBA 경계가 된다. |
FAILURE PATH
어느 경계에서 멈췄는가
mmc_bind()가 오류를 반환한다. card 초기화까지 간 것이 아니다.mmc_start_init() 또는 mmc_complete_init()의 오류가 mmc_blk_probe()로 전파된다.mmc_bread()는 이 경로에서 읽은 block 수 대신 0을 반환한다.| 조건 | 고정 소스의 결과 | 확인할 값 |
|---|---|---|
| 카드가 없다는 감지 결과 | mmc_start_init의 -ENOMEDIUM, has_init=0 | detect 신호와 host ops |
| startup 실패 | mmc_complete_init이 has_init=0, probe 오류 | 실패한 command/response와 mode |
| LBA가 descriptor 범위 밖 | mmc_bread이 0 block 반환 | start, blkcnt, lba, hwpart |
EVIDENCE
고정 소스와 보드에서 확인할 증거
보드 명령은 해당 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 tree | dm tree | MMC parent와 block child의 bind/probe 상태를 구별. |
| card 상태 | mmc list, mmc dev <n>, mmc info | 선택·probe가 상태를 바꿀 수 있으므로 호출 전후를 함께 기록. |
| 원본 대조 | blk-uclass.c와 mmc-uclass.c | probe와 read의 서로 다른 함수 경계를 확인. |
LAB
단계를 구분해 확인하기
- 01bind와 probe 구분
dm tree에서 MMC parent와 block child를 찾고, 카드 조회 전후의 probe 상태를 기록한다. block child가 보인다는 사실만으로lba가 채워졌다고 판단하지 않는다. - 02카드 협상 경계
mmc_init,mmc_start_init,mmc_complete_init의 반환값과has_init, 카드 감지 결과를 함께 기록해 첫 오류 지점을 찾는다. - 03읽기 경계
검증용 카드에서 block read의
hwpart, 요청 LBA/개수, 반환 block 수를 기록한다. cache hit 여부도 함께 확인해 host command 수와 API 호출 수를 혼동하지 않는다.
PRIMARY REFERENCES