Documentation/devicetree/bindings/phy/samsung-phy.txt

   1 Samsung S5P/EXYNOS SoC series MIPI CSIS/DSIM DPHY
   2 -------------------------------------------------
   3
   4 Required properties:
   5 - compatible : should be "samsung,s5pv210-mipi-video-phy";
   6 - reg : offset and length of the MIPI DPHY register set;
   7 - #phy-cells : from the generic phy bindings, must be 1;
   8
   9 For "samsung,s5pv210-mipi-video-phy" compatible PHYs the second cell in
  10 the PHY specifier identifies the PHY and its meaning is as follows:
  11   0 - MIPI CSIS 0,
  12   1 - MIPI DSIM 0,
  13   2 - MIPI CSIS 1,
  14   3 - MIPI DSIM 1.
  15
  16 Samsung EXYNOS SoC series Display Port PHY
  17 -------------------------------------------------
  18
  19 Required properties:
  20 - compatible : should be "samsung,exynos5250-dp-video-phy";
  21 - reg : offset and length of the Display Port PHY register set;
  22 - #phy-cells : from the generic PHY bindings, must be 0;
  23
  24 Samsung S5P/EXYNOS SoC series USB PHY
  25 -------------------------------------------------
  26
  27 Required properties:
  28 - compatible : should be one of the listed compatibles:
  29         - "samsung,exynos4210-usb2-phy"
  30         - "samsung,exynos4x12-usb2-phy"
  31         - "samsung,exynos5250-usb2-phy"
  32 - reg : a list of registers used by phy driver
  33         - first and obligatory is the location of phy modules registers
  34 - samsung,sysreg-phandle - handle to syscon used to control the system registers
  35 - samsung,pmureg-phandle - handle to syscon used to control PMU registers
  36 - #phy-cells : from the generic phy bindings, must be 1;
  37 - clocks and clock-names:
  38         - the "phy" clock is required by the phy module, used as a gate
  39         - the "ref" clock is used to get the rate of the clock provided to the
  40           PHY module
  41
  42 The first phandle argument in the PHY specifier identifies the PHY, its
  43 meaning is compatible dependent. For the currently supported SoCs (Exynos 4210
  44 and Exynos 4212) it is as follows:
  45   0 - USB device ("device"),
  46   1 - USB host ("host"),
  47   2 - HSIC0 ("hsic0"),
  48   3 - HSIC1 ("hsic1"),
  49
  50 Exynos 4210 and Exynos 4212 use mode switching and require that mode switch
  51 register is supplied.
  52
  53 Example:
  54
  55 For Exynos 4412 (compatible with Exynos 4212):
  56
  57 usbphy: phy@125b0000 {
  58         compatible = "samsung,exynos4x12-usb2-phy";
  59         reg = <0x125b0000 0x100>;
  60         clocks = <&clock 305>, <&clock 2>;
  61         clock-names = "phy", "ref";
  62         status = "okay";
  63         #phy-cells = <1>;
  64         samsung,sysreg-phandle = <&sys_reg>;
  65         samsung,pmureg-phandle = <&pmu_reg>;
  66 };
  67
  68 Then the PHY can be used in other nodes such as:
  69
  70 phy-consumer@12340000 {
  71         phys = <&usbphy 2>;
  72         phy-names = "phy";
  73 };
  74
  75 Refer to DT bindings documentation of particular PHY consumer devices for more
  76 information about required PHYs and the way of specification.
  77
  78 Samsung SATA PHY Controller
  79 ---------------------------
  80
  81 SATA PHY nodes are defined to describe on-chip SATA Physical layer controllers.
  82 Each SATA PHY controller should have its own node.
  83
  84 Required properties:
  85 - compatible        : compatible list, contains "samsung,exynos5250-sata-phy"
  86 - reg : offset and length of the SATA PHY register set;
  87 - #phy-cells : must be zero
  88 - clocks : must be exactly one entry
  89 - clock-names : must be "sata_phyctrl"
  90 - samsung,exynos-sataphy-i2c-phandle : a phandle to the I2C device, no arguments
  91 - samsung,syscon-phandle : a phandle to the PMU system controller, no arguments
  92
  93 Example:
  94         sata_phy: sata-phy@12170000 {
  95                 compatible = "samsung,exynos5250-sata-phy";
  96                 reg = <0x12170000 0x1ff>;
  97                 clocks = <&clock 287>;
  98                 clock-names = "sata_phyctrl";
  99                 #phy-cells = <0>;
 100                 samsung,exynos-sataphy-i2c-phandle = <&sata_phy_i2c>;
 101                 samsung,syscon-phandle = <&pmu_syscon>;
 102         };
 103
 104 Device-Tree bindings for sataphy i2c client driver
 105 --------------------------------------------------
 106
 107 Required properties:
 108 compatible: Should be "samsung,exynos-sataphy-i2c"
 109 - reg: I2C address of the sataphy i2c device.
 110
 111 Example:
 112
 113         sata_phy_i2c:sata-phy@38 {
 114                 compatible = "samsung,exynos-sataphy-i2c";
 115                 reg = <0x38>;
 116         };