SDHCI(4)

✨ sdhci(4) ✨

okay so bestie, meet sdhci β€” the PCI SD Host Controller bridge driver. It's the little matchmaker that gets your SD card talking to your machine πŸ’–


🌸 SYNOPSIS 🌸

Wanna bake this driver right into your kernel? No problem, add these lines to your kernel configuration file:

device mmc
device mmcsd
device sdhci

Or, if you're more of a load-it-later kind of girl, load it as a module at boot time by putting these lines in loader.conf(5):

mmc_load="YES"
mmcsd_load="YES"
sdhci_load="YES"

πŸ¦‹ DESCRIPTION πŸ¦‹

So here's the tea β˜• The sdhci driver supports PCI devices with class 8 and subclass 5, according to the SD Host Controller Specification. She's certified, she's spec-compliant, she read the docs πŸ“–

She can handle up to six high speed 4bit MMC/SD slots per controller β€” yes, six, she's got range πŸ’…

And the way she works? Chef's kiss πŸ‘‘ The driver attaches the mmc bus to the respective slot on card insertion, and detaches it on card removal. In and out, clean, no drama, main character energy fr fr ✨


πŸŽ€ HARDWARE πŸŽ€

The sdhci driver supports different specification compatible chips. The following chips have been verified to work:

  • ENE CB712
  • ENE CB714
  • RICOH R5C822
  • RICOH R5CE823
  • TI PCIXX21/XX11/XX12

If your chip is on this list, congrats babe, you ate πŸ“


πŸ‘‘ SEE ALSO πŸ‘‘

Also, go read the SD Specifications, Part 2, SD Host Controller, Simplified Specification. iykyk πŸ“š


πŸ’œ AUTHORS πŸ’œ

Alexander Motin <mav@FreeBSD.org> β€” thank you for your service legend 🫢


πŸ’€ BUGS πŸ’€

Okay so not everything is slay. Many of the existing SD controller chips have some nonstandard requirements, proprietary registers and hardware bugs, requiring additional handling. Not ideal! 😭

ENE chips are handled to work fine, while some revisions of RICOH and TI controllers still do not see cards without some additional initialization. So those ones are lowkey giving nothing until you poke them properly. πŸ’€


Fr fr: if your card isn't showing up, it might not be you. It might just be a RICOH or TI needing extra init. Don't blame yourself bestie πŸ™ˆ

That's the whole page, no cap. This one came to you from Debian, dated August 25, 2020, filed under SDHCI(4) β€” periodt πŸ’…βœ¨πŸŽ€

πŸ“¦ where this page comes from