Documentation/devicetree/bindings/mmc/rockchip-dw-mshc.txt

   1 * Rockchip specific extensions to the Synopsys Designware Mobile
   2   Storage Host Controller
   3
   4 The Synopsys designware mobile storage host controller is used to interface
   5 a SoC with storage medium such as eMMC or SD/MMC cards. This file documents
   6 differences between the core Synopsys dw mshc controller properties described
   7 by synopsys-dw-mshc.txt and the properties used by the Rockchip specific
   8 extensions to the Synopsys Designware Mobile Storage Host Controller.
   9
  10 Required Properties:
  11
  12 * compatible: should be
  13         - "rockchip,rk2928-dw-mshc": for Rockchip RK2928 and following,
  14                                                         before RK3288
  15         - "rockchip,rk3288-dw-mshc": for Rockchip RK3288
  16         - "rockchip,rv1108-dw-mshc", "rockchip,rk3288-dw-mshc": for Rockchip RV1108
  17         - "rockchip,rk3036-dw-mshc", "rockchip,rk3288-dw-mshc": for Rockchip RK3036
  18         - "rockchip,rk3228-dw-mshc", "rockchip,rk3288-dw-mshc": for Rockchip RK322x
  19         - "rockchip,rk3328-dw-mshc", "rockchip,rk3288-dw-mshc": for Rockchip RK3328
  20         - "rockchip,rk3368-dw-mshc", "rockchip,rk3288-dw-mshc": for Rockchip RK3368
  21         - "rockchip,rk3399-dw-mshc", "rockchip,rk3288-dw-mshc": for Rockchip RK3399
  22
  23 Optional Properties:
  24 * clocks: from common clock binding: if ciu_drive and ciu_sample are
  25   specified in clock-names, should contain handles to these clocks.
  26
  27 * clock-names: Apart from the clock-names described in synopsys-dw-mshc.txt
  28   two more clocks "ciu-drive" and "ciu-sample" are supported. They are used
  29   to control the clock phases, "ciu-sample" is required for tuning high-
  30   speed modes.
  31
  32 * rockchip,default-sample-phase: The default phase to set ciu_sample at
  33   probing, low speeds or in case where all phases work at tuning time.
  34   If not specified 0 deg will be used.
  35
  36 * rockchip,desired-num-phases: The desired number of times that the host
  37   execute tuning when needed. If not specified, the host will do tuning
  38   for 360 times, namely tuning for each degree.
  39
  40 Example:
  41
  42         rkdwmmc0@12200000 {
  43                 compatible = "rockchip,rk3288-dw-mshc";
  44                 reg = <0x12200000 0x1000>;
  45                 interrupts = <0 75 0>;
  46                 #address-cells = <1>;
  47                 #size-cells = <0>;
  48         };