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,px30-dw-mshc", "rockchip,rk3288-dw-mshc": for Rockchip PX30
  18         - "rockchip,rk3036-dw-mshc", "rockchip,rk3288-dw-mshc": for Rockchip RK3036
  19         - "rockchip,rk3228-dw-mshc", "rockchip,rk3288-dw-mshc": for Rockchip RK322x
  20         - "rockchip,rk3328-dw-mshc", "rockchip,rk3288-dw-mshc": for Rockchip RK3328
  21         - "rockchip,rk3368-dw-mshc", "rockchip,rk3288-dw-mshc": for Rockchip RK3368
  22         - "rockchip,rk3399-dw-mshc", "rockchip,rk3288-dw-mshc": for Rockchip RK3399
  23
  24 Optional Properties:
  25 * clocks: from common clock binding: if ciu-drive and ciu-sample are
  26   specified in clock-names, should contain handles to these clocks.
  27
  28 * clock-names: Apart from the clock-names described in synopsys-dw-mshc.txt
  29   two more clocks "ciu-drive" and "ciu-sample" are supported. They are used
  30   to control the clock phases, "ciu-sample" is required for tuning high-
  31   speed modes.
  32
  33 * rockchip,default-sample-phase: The default phase to set ciu-sample at
  34   probing, low speeds or in case where all phases work at tuning time.
  35   If not specified 0 deg will be used.
  36
  37 * rockchip,desired-num-phases: The desired number of times that the host
  38   execute tuning when needed. If not specified, the host will do tuning
  39   for 360 times, namely tuning for each degree.
  40
  41 Example:
  42
  43         rkdwmmc0@12200000 {
  44                 compatible = "rockchip,rk3288-dw-mshc";
  45                 reg = <0x12200000 0x1000>;
  46                 interrupts = <0 75 0>;
  47                 #address-cells = <1>;
  48                 #size-cells = <0>;
  49         };