xref: /freebsd/sys/contrib/device-tree/Bindings/mmc/samsung,s3cmci.txt (revision c66ec88fed842fbaad62c30d510644ceb7bd2d71)
1*c66ec88fSEmmanuel Vadot* Samsung's S3C24XX MMC/SD/SDIO controller device tree bindings
2*c66ec88fSEmmanuel Vadot
3*c66ec88fSEmmanuel VadotSamsung's S3C24XX MMC/SD/SDIO controller is used as a connectivity interface
4*c66ec88fSEmmanuel Vadotwith external MMC, SD and SDIO storage mediums.
5*c66ec88fSEmmanuel Vadot
6*c66ec88fSEmmanuel VadotThis file documents differences between the core mmc properties described by
7*c66ec88fSEmmanuel Vadotmmc.txt and the properties used by the Samsung S3C24XX MMC/SD/SDIO controller
8*c66ec88fSEmmanuel Vadotimplementation.
9*c66ec88fSEmmanuel Vadot
10*c66ec88fSEmmanuel VadotRequired SoC Specific Properties:
11*c66ec88fSEmmanuel Vadot- compatible: should be one of the following
12*c66ec88fSEmmanuel Vadot  - "samsung,s3c2410-sdi": for controllers compatible with s3c2410
13*c66ec88fSEmmanuel Vadot  - "samsung,s3c2412-sdi": for controllers compatible with s3c2412
14*c66ec88fSEmmanuel Vadot  - "samsung,s3c2440-sdi": for controllers compatible with s3c2440
15*c66ec88fSEmmanuel Vadot- reg: register location and length
16*c66ec88fSEmmanuel Vadot- interrupts: mmc controller interrupt
17*c66ec88fSEmmanuel Vadot- clocks: Should reference the controller clock
18*c66ec88fSEmmanuel Vadot- clock-names: Should contain "sdi"
19*c66ec88fSEmmanuel Vadot
20*c66ec88fSEmmanuel VadotRequired Board Specific Properties:
21*c66ec88fSEmmanuel Vadot- pinctrl-0: Should specify pin control groups used for this controller.
22*c66ec88fSEmmanuel Vadot- pinctrl-names: Should contain only one value - "default".
23*c66ec88fSEmmanuel Vadot
24*c66ec88fSEmmanuel VadotOptional Properties:
25*c66ec88fSEmmanuel Vadot- bus-width: number of data lines (see mmc.txt)
26*c66ec88fSEmmanuel Vadot- cd-gpios: gpio for card detection (see mmc.txt)
27*c66ec88fSEmmanuel Vadot- wp-gpios: gpio for write protection (see mmc.txt)
28*c66ec88fSEmmanuel Vadot
29*c66ec88fSEmmanuel VadotExample:
30*c66ec88fSEmmanuel Vadot
31*c66ec88fSEmmanuel Vadot	mmc0: mmc@5a000000 {
32*c66ec88fSEmmanuel Vadot		compatible = "samsung,s3c2440-sdi";
33*c66ec88fSEmmanuel Vadot		pinctrl-names = "default";
34*c66ec88fSEmmanuel Vadot		pinctrl-0 = <&sdi_pins>;
35*c66ec88fSEmmanuel Vadot		reg = <0x5a000000 0x100000>;
36*c66ec88fSEmmanuel Vadot		interrupts = <0 0 21 3>;
37*c66ec88fSEmmanuel Vadot		clocks = <&clocks PCLK_SDI>;
38*c66ec88fSEmmanuel Vadot		clock-names = "sdi";
39*c66ec88fSEmmanuel Vadot		bus-width = <4>;
40*c66ec88fSEmmanuel Vadot		cd-gpios = <&gpg 8 GPIO_ACTIVE_LOW>;
41*c66ec88fSEmmanuel Vadot		wp-gpios = <&gph 8 GPIO_ACTIVE_LOW>;
42*c66ec88fSEmmanuel Vadot	};
43