xref: /freebsd/sys/contrib/device-tree/Bindings/display/tegra/nvidia,tegra124-dpaux.yaml (revision 058ac3e8063366dafa634d9107642e12b038bf09)
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/display/tegra/nvidia,tegra124-dpaux.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: NVIDIA Tegra DisplayPort AUX Interface
8
9maintainers:
10  - Thierry Reding <thierry.reding@gmail.com>
11  - Jon Hunter <jonathanh@nvidia.com>
12
13description: |
14  The Tegra Display Port Auxiliary (DPAUX) pad controller manages two
15  pins which can be assigned to either the DPAUX channel or to an I2C
16  controller.
17
18  When configured for DisplayPort AUX operation, the DPAUX controller
19  can also be used to communicate with a DisplayPort device using the
20  AUX channel.
21
22properties:
23  $nodename:
24    pattern: "^dpaux@[0-9a-f]+$"
25
26  compatible:
27    oneOf:
28      - enum:
29          - nvidia,tegra124-dpaux
30          - nvidia,tegra210-dpaux
31          - nvidia,tegra186-dpaux
32          - nvidia,tegra194-dpaux
33
34      - items:
35          - const: nvidia,tegra132-dpaux
36          - const: nvidia,tegra124-dpaux
37
38  reg:
39    maxItems: 1
40
41  interrupts:
42    maxItems: 1
43
44  clocks:
45    items:
46      - description: clock input for the DPAUX hardware
47      - description: reference clock
48
49  clock-names:
50    items:
51      - const: dpaux
52      - const: parent
53
54  resets:
55    items:
56      - description: module reset
57
58  reset-names:
59    items:
60      - const: dpaux
61
62  power-domains:
63    maxItems: 1
64
65  i2c-bus:
66    description: Subnode where I2C slave devices are listed. This
67      subnode must be always present. If there are no I2C slave
68      devices, an empty node should be added. See ../../i2c/i2c.yaml
69      for more information.
70    type: object
71
72  aux-bus:
73    $ref: /schemas/display/dp-aux-bus.yaml#
74
75  vdd-supply:
76    description: phandle of a supply that powers the DisplayPort
77      link
78
79patternProperties:
80  "^pinmux-[a-z0-9]+$":
81    description:
82      Since only three configurations are possible, only three child
83      nodes are needed to describe the pin mux'ing options for the
84      DPAUX pads. Furthermore, given that the pad functions are only
85      applicable to a single set of pads, the child nodes only need
86      to describe the pad group the functions are being applied to
87      rather than the individual pads.
88    type: object
89    properties:
90      groups:
91        const: dpaux-io
92
93      function:
94        enum:
95          - aux
96          - i2c
97          - off
98
99    additionalProperties: false
100
101    required:
102      - groups
103      - function
104
105additionalProperties: false
106
107required:
108  - compatible
109  - reg
110  - interrupts
111  - clocks
112  - clock-names
113  - resets
114  - reset-names
115
116examples:
117  - |
118    #include <dt-bindings/clock/tegra210-car.h>
119    #include <dt-bindings/interrupt-controller/arm-gic.h>
120
121    dpaux: dpaux@545c0000 {
122        compatible = "nvidia,tegra210-dpaux";
123        reg = <0x545c0000 0x00040000>;
124        interrupts = <GIC_SPI 159 IRQ_TYPE_LEVEL_HIGH>;
125        clocks = <&tegra_car TEGRA210_CLK_DPAUX>,
126                 <&tegra_car TEGRA210_CLK_PLL_DP>;
127        clock-names = "dpaux", "parent";
128        resets = <&tegra_car 181>;
129        reset-names = "dpaux";
130        power-domains = <&pd_sor>;
131        status = "disabled";
132
133        state_dpaux_aux: pinmux-aux {
134            groups = "dpaux-io";
135            function = "aux";
136        };
137
138        state_dpaux_i2c: pinmux-i2c {
139            groups = "dpaux-io";
140            function = "i2c";
141        };
142
143        state_dpaux_off: pinmux-off {
144            groups = "dpaux-io";
145            function = "off";
146        };
147
148        i2c-bus {
149            #address-cells = <1>;
150            #size-cells = <0>;
151        };
152    };
153