1 # SPDX-License-Identifier: GPL-2.0 1 # SPDX-License-Identifier: GPL-2.0
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/i2c/i2c-rk3 4 $id: http://devicetree.org/schemas/i2c/i2c-rk3x.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Rockchip RK3xxx I2C controller 7 title: Rockchip RK3xxx I2C controller
8 8
9 description: 9 description:
10 This driver interfaces with the native I2C c 10 This driver interfaces with the native I2C controller present in Rockchip
11 RK3xxx SoCs. 11 RK3xxx SoCs.
12 12
13 allOf: 13 allOf:
14 - $ref: /schemas/i2c/i2c-controller.yaml# 14 - $ref: /schemas/i2c/i2c-controller.yaml#
15 15
16 maintainers: 16 maintainers:
17 - Heiko Stuebner <heiko@sntech.de> 17 - Heiko Stuebner <heiko@sntech.de>
18 18
19 # Everything else is described in the common f 19 # Everything else is described in the common file
20 properties: 20 properties:
21 compatible: 21 compatible:
22 oneOf: 22 oneOf:
23 - const: rockchip,rv1108-i2c 23 - const: rockchip,rv1108-i2c
24 - const: rockchip,rk3066-i2c 24 - const: rockchip,rk3066-i2c
25 - const: rockchip,rk3188-i2c 25 - const: rockchip,rk3188-i2c
26 - const: rockchip,rk3228-i2c 26 - const: rockchip,rk3228-i2c
27 - const: rockchip,rk3288-i2c 27 - const: rockchip,rk3288-i2c
28 - const: rockchip,rk3399-i2c 28 - const: rockchip,rk3399-i2c
29 - items: 29 - items:
30 - enum: 30 - enum:
31 - rockchip,rk3036-i2c 31 - rockchip,rk3036-i2c
32 - rockchip,rk3128-i2c 32 - rockchip,rk3128-i2c
33 - rockchip,rk3368-i2c 33 - rockchip,rk3368-i2c
34 - const: rockchip,rk3288-i2c 34 - const: rockchip,rk3288-i2c
35 - items: 35 - items:
36 - enum: 36 - enum:
37 - rockchip,px30-i2c 37 - rockchip,px30-i2c
38 - rockchip,rk3308-i2c 38 - rockchip,rk3308-i2c
39 - rockchip,rk3328-i2c 39 - rockchip,rk3328-i2c
40 - rockchip,rk3568-i2c 40 - rockchip,rk3568-i2c
41 - rockchip,rk3576-i2c 41 - rockchip,rk3576-i2c
42 - rockchip,rk3588-i2c 42 - rockchip,rk3588-i2c
43 - rockchip,rv1126-i2c 43 - rockchip,rv1126-i2c
44 - const: rockchip,rk3399-i2c 44 - const: rockchip,rk3399-i2c
45 45
46 reg: 46 reg:
47 maxItems: 1 47 maxItems: 1
48 48
49 interrupts: 49 interrupts:
50 maxItems: 1 50 maxItems: 1
51 51
52 clocks: 52 clocks:
53 minItems: 1 53 minItems: 1
54 items: 54 items:
55 - description: 55 - description:
56 For older hardware (rk3066, rk3188, 56 For older hardware (rk3066, rk3188, rk3228, rk3288)
57 there is one clock that is used both 57 there is one clock that is used both to derive the functional clock
58 for the device and as the bus clock. 58 for the device and as the bus clock.
59 For newer hardware (rk3399) this clo 59 For newer hardware (rk3399) this clock is used to derive
60 the functional clock 60 the functional clock
61 - description: 61 - description:
62 For newer hardware (rk3399) this is 62 For newer hardware (rk3399) this is the bus clock
63 63
64 clock-names: 64 clock-names:
65 minItems: 1 65 minItems: 1
66 items: 66 items:
67 - const: i2c 67 - const: i2c
68 - const: pclk 68 - const: pclk
69 69
70 rockchip,grf: 70 rockchip,grf:
71 $ref: /schemas/types.yaml#/definitions/pha 71 $ref: /schemas/types.yaml#/definitions/phandle
72 description: 72 description:
73 Required on RK3066, RK3188 the phandle o 73 Required on RK3066, RK3188 the phandle of the syscon node for
74 the general register file (GRF) 74 the general register file (GRF)
75 On those SoCs an alias with the correct 75 On those SoCs an alias with the correct I2C bus ID
76 (bit offset in the GRF) is also required 76 (bit offset in the GRF) is also required.
77 77
78 clock-frequency: 78 clock-frequency:
79 default: 100000 79 default: 100000
80 description: 80 description:
81 SCL frequency to use (in Hz). If omitted 81 SCL frequency to use (in Hz). If omitted, 100kHz is used.
82 82
83 i2c-scl-rising-time-ns: 83 i2c-scl-rising-time-ns:
84 default: 1000 84 default: 1000
85 description: 85 description:
86 Number of nanoseconds the SCL signal tak 86 Number of nanoseconds the SCL signal takes to rise
87 (t(r) in I2C specification). If not spec 87 (t(r) in I2C specification). If not specified this is assumed to be
88 the maximum the specification allows(100 88 the maximum the specification allows(1000 ns for Standard-mode,
89 300 ns for Fast-mode) which might cause 89 300 ns for Fast-mode) which might cause slightly slower communication.
90 90
91 i2c-scl-falling-time-ns: 91 i2c-scl-falling-time-ns:
92 default: 300 92 default: 300
93 description: 93 description:
94 Number of nanoseconds the SCL signal tak 94 Number of nanoseconds the SCL signal takes to fall
95 (t(f) in the I2C specification). If not 95 (t(f) in the I2C specification). If not specified this is assumed to
96 be the maximum the specification allows 96 be the maximum the specification allows (300 ns) which might cause
97 slightly slower communication. 97 slightly slower communication.
98 98
99 i2c-sda-falling-time-ns: 99 i2c-sda-falling-time-ns:
100 default: 300 100 default: 300
101 description: 101 description:
102 Number of nanoseconds the SDA signal tak 102 Number of nanoseconds the SDA signal takes to fall
103 (t(f) in the I2C specification). If not 103 (t(f) in the I2C specification). If not specified we will use the SCL
104 value since they are the same in nearly 104 value since they are the same in nearly all cases.
105 105
106 required: 106 required:
107 - compatible 107 - compatible
108 - reg 108 - reg
109 - interrupts 109 - interrupts
110 - clocks 110 - clocks
111 - clock-names 111 - clock-names
112 112
113 if: 113 if:
114 properties: 114 properties:
115 compatible: 115 compatible:
116 contains: 116 contains:
117 enum: 117 enum:
118 - rockchip,rk3066-i2c 118 - rockchip,rk3066-i2c
119 - rockchip,rk3188-i2c 119 - rockchip,rk3188-i2c
120 120
121 then: 121 then:
122 required: 122 required:
123 - rockchip,grf 123 - rockchip,grf
124 124
125 unevaluatedProperties: false 125 unevaluatedProperties: false
126 126
127 examples: 127 examples:
128 - | 128 - |
129 #include <dt-bindings/clock/rk3188-cru-com 129 #include <dt-bindings/clock/rk3188-cru-common.h>
130 #include <dt-bindings/interrupt-controller 130 #include <dt-bindings/interrupt-controller/arm-gic.h>
131 #include <dt-bindings/interrupt-controller 131 #include <dt-bindings/interrupt-controller/irq.h>
132 i2c0: i2c@2002d000 { 132 i2c0: i2c@2002d000 {
133 compatible = "rockchip,rk3188-i2c"; 133 compatible = "rockchip,rk3188-i2c";
134 reg = <0x2002d000 0x1000>; 134 reg = <0x2002d000 0x1000>;
135 interrupts = <GIC_SPI 40 IRQ_TYPE_LEVEL_ 135 interrupts = <GIC_SPI 40 IRQ_TYPE_LEVEL_HIGH>;
136 clocks = <&cru PCLK_I2C0>; 136 clocks = <&cru PCLK_I2C0>;
137 clock-names = "i2c"; 137 clock-names = "i2c";
138 rockchip,grf = <&grf>; 138 rockchip,grf = <&grf>;
139 i2c-scl-falling-time-ns = <100>; 139 i2c-scl-falling-time-ns = <100>;
140 i2c-scl-rising-time-ns = <800>; 140 i2c-scl-rising-time-ns = <800>;
141 #address-cells = <1>; 141 #address-cells = <1>;
142 #size-cells = <0>; 142 #size-cells = <0>;
143 }; 143 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.