dt-bindings: phy-rockchip-typec: deprecate some register properties.
authorEnric Balletbo i Serra <enric.balletbo@collabora.com>
Fri, 16 Feb 2018 12:09:52 +0000 (13:09 +0100)
committerKishon Vijay Abraham I <kishon@ti.com>
Fri, 16 Mar 2018 11:25:32 +0000 (16:55 +0530)
As now the following register properties are in the driver, document as
deprecated these properties and recommend to not use them on new bindings.

The deprecated properties are:

- rockchip,typec-conn-dir : the register of type-c connector direction
- rockchip,usb3tousb2-en : the register of type-c force usb3 to usb2
                           enable control.
- rockchip,external-psm : the register of type-c phy external psm clock
                          selection.
- rockchip,pipe-status : the register of type-c phy pipe status.

Signed-off-by: Enric Balletbo i Serra <enric.balletbo@collabora.com>
Reviewed-by: Heiko Stuebner <heiko@sntech.de>
Reviewed-by: Rob Herring <robh@kernel.org>
Signed-off-by: Kishon Vijay Abraham I <kishon@ti.com>
Documentation/devicetree/bindings/phy/phy-rockchip-typec.txt

index 6ea867e..f95cd49 100644 (file)
@@ -16,24 +16,6 @@ Required properties:
                 "uphy", "uphy-pipe", "uphy-tcphy"
  - extcon : extcon specifier for the Power Delivery
 
-Note, there are 2 type-c phys for RK3399, and they are almost identical, except
-these registers(description below), every register node contains 3 sections:
-offset, enable bit, write mask bit.
- - rockchip,typec-conn-dir : the register of type-c connector direction,
-   for type-c phy0, it must be <0xe580 0 16>;
-   for type-c phy1, it must be <0xe58c 0 16>;
- - rockchip,usb3tousb2-en : the register of type-c force usb3 to usb2 enable
-   control.
-   for type-c phy0, it must be <0xe580 3 19>;
-   for type-c phy1, it must be <0xe58c 3 19>;
- - rockchip,external-psm : the register of type-c phy external psm clock
-   selection.
-   for type-c phy0, it must be <0xe588 14 30>;
-   for type-c phy1, it must be <0xe594 14 30>;
- - rockchip,pipe-status : the register of type-c phy pipe status.
-   for type-c phy0, it must be <0xe5c0 0 0>;
-   for type-c phy1, it must be <0xe5c0 16 16>;
-
 Required nodes : a sub-node is required for each port the phy provides.
                 The sub-node name is used to identify dp or usb3 port,
                 and shall be the following entries:
@@ -43,6 +25,13 @@ Required nodes : a sub-node is required for each port the phy provides.
 Required properties (port (child) node):
 - #phy-cells : must be 0, See ./phy-bindings.txt for details.
 
+Deprecated properties, do not use in new device tree sources, these
+properties are determined by the compatible value:
+ - rockchip,typec-conn-dir
+ - rockchip,usb3tousb2-en
+ - rockchip,external-psm
+ - rockchip,pipe-status
+
 Example:
        tcphy0: phy@ff7c0000 {
                compatible = "rockchip,rk3399-typec-phy";
@@ -58,10 +47,6 @@ Example:
                         <&cru SRST_UPHY0_PIPE_L00>,
                         <&cru SRST_P_UPHY0_TCPHY>;
                reset-names = "uphy", "uphy-pipe", "uphy-tcphy";
-               rockchip,typec-conn-dir = <0xe580 0 16>;
-               rockchip,usb3tousb2-en = <0xe580 3 19>;
-               rockchip,external-psm = <0xe588 14 30>;
-               rockchip,pipe-status = <0xe5c0 0 0>;
 
                tcphy0_dp: dp-port {
                        #phy-cells = <0>;
@@ -86,10 +71,6 @@ Example:
                         <&cru SRST_UPHY1_PIPE_L00>,
                         <&cru SRST_P_UPHY1_TCPHY>;
                reset-names = "uphy", "uphy-pipe", "uphy-tcphy";
-               rockchip,typec-conn-dir = <0xe58c 0 16>;
-               rockchip,usb3tousb2-en = <0xe58c 3 19>;
-               rockchip,external-psm = <0xe594 14 30>;
-               rockchip,pipe-status = <0xe5c0 16 16>;
 
                tcphy1_dp: dp-port {
                        #phy-cells = <0>;