Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux
1
fork

Configure Feed

Select the types of activity you want to include in your feed.

dt-bindings: display: ti: Add schema for AM625 OLDI Transmitter

The OLDI transmitters (TXes) do not have registers of their own, and are
dependent on the source video-ports (VPs) from the DSS to provide
configuration data. This hardware doesn't directly sit on the internal
bus of the SoC, but does so via the DSS. Hence, the OLDI TXes are
supposed to be child nodes under the DSS, and not independent devices.

Two of the OLDI TXes can function in tandem to output dual-link OLDI
output, or cloned single-link outputs. In these cases, one OLDI will be
the primary OLDI, and the other one, a companion. The following diagram
represents such a configuration.

+-----+-----+ +-------+
| | | | |
| | VP1 +----+--->+ OLDI0 | (Primary - may need companion)
| | | | | |
| DSS +-----+ | +-------+
| | | |
| | VP2 | | +-------+
| | | | | |
+-----+-----+ +--->+ OLDI1 | (Companion OLDI)
| |
+-------+

The DSS in AM625 SoC has a configuration like the one above. The AM625
DSS VP1 (port@0) can connect and control 2 OLDI TXes, to use them in
dual-link or cloned single-link OLDI modes. It is only the VP1 that can
connect to either OLDI TXes for the AM625 DSS, and not the VP2.

Alternatively, on some future TI SoCs, along with the above
configuration, the OLDI TX can _also_ connect to separate video sources,
making them work entirely independent of each other. In this case,
neither of the OLDIs are "companion" or "secondary" OLDIs, and nor do
they require one. They both are independent and primary OLDIs. The
following diagram represents such a configuration.

+-----+-----+ +-------+
| | | | |
| | VP1 +--+----------->+ OLDI0 | (Primary - may need companion)
| | | | | |
| +-----+ | +-------+
| | | |
| | VP2 | |
| | | |
| DSS +-----+ | +---+ +-------+
| | | +-->+ M | | |
| | VP3 +----->+ U +--->+ OLDI1 | (Companion or Primary)
| | | | X | | |
| +-----+ +---+ +-------+
| | |
| | VP4 |
| | |
+-----+-----+

Note that depending on the mux configuration, the OLDIs can either be
working together in tandem - sourced by VP1, OR, they could be working
independently sourced by VP1 and VP3 respectively.
The idea is to support all the configurations with this OLDI TX schema.

The OLDI functionality is further supported by a system-control module,
which contains a few registers to control OLDI IO power and other
electrical characteristics of the IO lanes.

Add devicetree binding schema for the OLDI TXes to support various
configurations, and extend their support to the AM625 DSS.

Signed-off-by: Aradhya Bhatia <a-bhatia1@ti.com>
Signed-off-by: Aradhya Bhatia <aradhya.bhatia@linux.dev>
Reviewed-by: "Rob Herring (Arm)" <robh@kernel.org>
Reviewed-by: Tomi Valkeinen <tomi.valkeinen@ideasonboard.com>
Link: https://lore.kernel.org/r/20250528122544.817829-3-aradhya.bhatia@linux.dev
Signed-off-by: Tomi Valkeinen <tomi.valkeinen@ideasonboard.com>

authored by

Aradhya Bhatia and committed by
Tomi Valkeinen
90090f49 adc8f6ff

+237
+79
Documentation/devicetree/bindings/display/ti/ti,am625-oldi.yaml
··· 1 + # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/display/ti/ti,am625-oldi.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: Texas Instruments AM625 OLDI Transmitter 8 + 9 + maintainers: 10 + - Tomi Valkeinen <tomi.valkeinen@ideasonboard.com> 11 + - Aradhya Bhatia <aradhya.bhatia@linux.dev> 12 + 13 + description: 14 + The AM625 TI Keystone OpenLDI transmitter (OLDI TX) supports serialized RGB 15 + pixel data transmission between host and flat panel display over LVDS (Low 16 + Voltage Differential Sampling) interface. The OLDI TX consists of 7-to-1 data 17 + serializers, and 4-data and 1-clock LVDS outputs. It supports the LVDS output 18 + formats "jeida-18", "jeida-24" and "vesa-18", and can accept 24-bit RGB or 19 + padded and un-padded 18-bit RGB bus formats as input. 20 + 21 + properties: 22 + reg: 23 + maxItems: 1 24 + 25 + clocks: 26 + maxItems: 1 27 + description: serial clock input for the OLDI transmitters 28 + 29 + clock-names: 30 + const: serial 31 + 32 + ti,companion-oldi: 33 + $ref: /schemas/types.yaml#/definitions/phandle 34 + description: 35 + phandle to companion OLDI transmitter. This property is required for both 36 + the OLDI TXes if they are expected to work either in dual-lvds mode or in 37 + clone mode. This property should point to the other OLDI TX's phandle. 38 + 39 + ti,secondary-oldi: 40 + type: boolean 41 + description: 42 + Boolean property to mark the OLDI transmitter as the secondary one, when the 43 + OLDI hardware is expected to run as a companion HW, in cases of dual-lvds 44 + mode or clone mode. The primary OLDI hardware is responsible for all the 45 + hardware configuration. 46 + 47 + ti,oldi-io-ctrl: 48 + $ref: /schemas/types.yaml#/definitions/phandle 49 + description: 50 + phandle to syscon device node mapping OLDI IO_CTRL registers found in the 51 + control MMR region. These registers are required to toggle the I/O lane 52 + power, and control its electrical characteristics. 53 + 54 + ports: 55 + $ref: /schemas/graph.yaml#/properties/ports 56 + 57 + properties: 58 + port@0: 59 + $ref: /schemas/graph.yaml#/properties/port 60 + description: Parallel RGB input port 61 + 62 + port@1: 63 + $ref: /schemas/graph.yaml#/properties/port 64 + description: LVDS output port 65 + 66 + required: 67 + - port@0 68 + - port@1 69 + 70 + required: 71 + - reg 72 + - clocks 73 + - clock-names 74 + - ti,oldi-io-ctrl 75 + - ports 76 + 77 + additionalProperties: false 78 + 79 + ...
+157
Documentation/devicetree/bindings/display/ti/ti,am65x-dss.yaml
··· 100 100 For AM62A7 DSS, the port is tied off inside the SoC. 101 101 For AM62L DSS, the DSS DPI output port node from video port 1 102 102 or DSI Tx controller node connected to video port 1. 103 + properties: 104 + endpoint@0: 105 + $ref: /schemas/graph.yaml#/properties/endpoint 106 + description: 107 + For AM625 DSS, VP Connection to OLDI0. 108 + For AM65X DSS, OLDI output from the SoC. 109 + 110 + endpoint@1: 111 + $ref: /schemas/graph.yaml#/properties/endpoint 112 + description: 113 + For AM625 DSS, VP Connection to OLDI1. 114 + 115 + anyOf: 116 + - required: 117 + - endpoint 118 + - required: 119 + - endpoint@0 120 + - endpoint@1 103 121 104 122 port@1: 105 123 $ref: /schemas/graph.yaml#/properties/port ··· 139 121 Input memory (from main memory to dispc) bandwidth limit in 140 122 bytes per second 141 123 124 + oldi-transmitters: 125 + description: 126 + Child node under the DSS, to describe all the OLDI transmitters connected 127 + to the DSS videoports. 128 + type: object 129 + additionalProperties: false 130 + 131 + properties: 132 + "#address-cells": 133 + const: 1 134 + 135 + "#size-cells": 136 + const: 0 137 + 138 + patternProperties: 139 + '^oldi@[0-1]$': 140 + $ref: ti,am625-oldi.yaml# 141 + description: OLDI transmitters connected to the DSS VPs 142 + 142 143 allOf: 143 144 - if: 144 145 properties: ··· 166 129 const: ti,am62a7-dss 167 130 then: 168 131 properties: 132 + oldi-transmitters: false 169 133 ports: 170 134 properties: 171 135 port@0: false ··· 180 142 ports: 181 143 properties: 182 144 port@1: false 145 + 146 + - if: 147 + properties: 148 + compatible: 149 + contains: 150 + enum: 151 + - ti,am62l-dss 152 + - ti,am65x-dss 153 + then: 154 + properties: 155 + oldi-transmitters: false 156 + ports: 157 + properties: 158 + port@0: 159 + properties: 160 + endpoint@1: false 183 161 184 162 required: 185 163 - compatible ··· 240 186 reg = <0>; 241 187 oldi_out0: endpoint { 242 188 remote-endpoint = <&lcd_in0>; 189 + }; 190 + }; 191 + }; 192 + }; 193 + 194 + - | 195 + #include <dt-bindings/interrupt-controller/arm-gic.h> 196 + #include <dt-bindings/interrupt-controller/irq.h> 197 + #include <dt-bindings/soc/ti,sci_pm_domain.h> 198 + 199 + bus { 200 + #address-cells = <2>; 201 + #size-cells = <2>; 202 + dss1: dss@30200000 { 203 + compatible = "ti,am625-dss"; 204 + reg = <0x00 0x30200000 0x00 0x1000>, /* common */ 205 + <0x00 0x30202000 0x00 0x1000>, /* vidl1 */ 206 + <0x00 0x30206000 0x00 0x1000>, /* vid */ 207 + <0x00 0x30207000 0x00 0x1000>, /* ovr1 */ 208 + <0x00 0x30208000 0x00 0x1000>, /* ovr2 */ 209 + <0x00 0x3020a000 0x00 0x1000>, /* vp1 */ 210 + <0x00 0x3020b000 0x00 0x1000>, /* vp2 */ 211 + <0x00 0x30201000 0x00 0x1000>; /* common1 */ 212 + reg-names = "common", "vidl1", "vid", 213 + "ovr1", "ovr2", "vp1", "vp2", "common1"; 214 + power-domains = <&k3_pds 186 TI_SCI_PD_EXCLUSIVE>; 215 + clocks = <&k3_clks 186 6>, 216 + <&vp1_clock>, 217 + <&k3_clks 186 2>; 218 + clock-names = "fck", "vp1", "vp2"; 219 + interrupts = <GIC_SPI 84 IRQ_TYPE_LEVEL_HIGH>; 220 + oldi-transmitters { 221 + #address-cells = <1>; 222 + #size-cells = <0>; 223 + oldi0: oldi@0 { 224 + reg = <0>; 225 + clocks = <&k3_clks 186 0>; 226 + clock-names = "serial"; 227 + ti,companion-oldi = <&oldi1>; 228 + ti,oldi-io-ctrl = <&dss_oldi_io_ctrl>; 229 + ports { 230 + #address-cells = <1>; 231 + #size-cells = <0>; 232 + port@0 { 233 + reg = <0>; 234 + oldi0_in: endpoint { 235 + remote-endpoint = <&dpi0_out0>; 236 + }; 237 + }; 238 + port@1 { 239 + reg = <1>; 240 + oldi0_out: endpoint { 241 + remote-endpoint = <&panel_in0>; 242 + }; 243 + }; 244 + }; 245 + }; 246 + oldi1: oldi@1 { 247 + reg = <1>; 248 + clocks = <&k3_clks 186 0>; 249 + clock-names = "serial"; 250 + ti,secondary-oldi; 251 + ti,companion-oldi = <&oldi0>; 252 + ti,oldi-io-ctrl = <&dss_oldi_io_ctrl>; 253 + ports { 254 + #address-cells = <1>; 255 + #size-cells = <0>; 256 + port@0 { 257 + reg = <0>; 258 + oldi1_in: endpoint { 259 + remote-endpoint = <&dpi0_out1>; 260 + }; 261 + }; 262 + port@1 { 263 + reg = <1>; 264 + oldi1_out: endpoint { 265 + remote-endpoint = <&panel_in1>; 266 + }; 267 + }; 268 + }; 269 + }; 270 + }; 271 + ports { 272 + #address-cells = <1>; 273 + #size-cells = <0>; 274 + port@0 { 275 + #address-cells = <1>; 276 + #size-cells = <0>; 277 + reg = <0>; 278 + dpi0_out0: endpoint@0 { 279 + reg = <0>; 280 + remote-endpoint = <&oldi0_in>; 281 + }; 282 + dpi0_out1: endpoint@1 { 283 + reg = <1>; 284 + remote-endpoint = <&oldi1_in>; 285 + }; 286 + }; 287 + port@1 { 288 + reg = <1>; 289 + dpi1_out: endpoint { 290 + remote-endpoint = <&hdmi_bridge>; 291 + }; 243 292 }; 244 293 }; 245 294 };
+1
MAINTAINERS
··· 8230 8230 L: dri-devel@lists.freedesktop.org 8231 8231 S: Maintained 8232 8232 T: git https://gitlab.freedesktop.org/drm/misc/kernel.git 8233 + F: Documentation/devicetree/bindings/display/ti/ti,am625-oldi.yaml 8233 8234 F: Documentation/devicetree/bindings/display/ti/ti,am65x-dss.yaml 8234 8235 F: Documentation/devicetree/bindings/display/ti/ti,j721e-dss.yaml 8235 8236 F: Documentation/devicetree/bindings/display/ti/ti,k2g-dss.yaml