CoCalc -- allwinner,sun4i-a10-tcon.yaml

GitHub Repository: torvalds/linux
Path: blob/master/Documentation/devicetree/bindings/display/allwinner,sun4i-a10-tcon.yaml
²⁶³⁰⁸ views
1
# SPDX-License-Identifier: GPL-2.0
2
%YAML 1.2
3
---
4
$id: http://devicetree.org/schemas/display/allwinner,sun4i-a10-tcon.yaml#
5
$schema: http://devicetree.org/meta-schemas/core.yaml#
6

7
title: Allwinner A10 Timings Controller (TCON)
8

9
maintainers:
10
  - Chen-Yu Tsai <wens@csie.org>
11
  - Maxime Ripard <mripard@kernel.org>
12

13
description: |
14
  The TCON acts as a timing controller for RGB, LVDS and TV
15
  interfaces.
16

17
properties:
18
  "#clock-cells":
19
    const: 0
20

21
  compatible:
22
    oneOf:
23
      - const: allwinner,sun4i-a10-tcon
24
      - const: allwinner,sun5i-a13-tcon
25
      - const: allwinner,sun6i-a31-tcon
26
      - const: allwinner,sun6i-a31s-tcon
27
      - const: allwinner,sun7i-a20-tcon
28
      - const: allwinner,sun8i-a23-tcon
29
      - const: allwinner,sun8i-a33-tcon
30
      - const: allwinner,sun8i-a83t-tcon-lcd
31
      - const: allwinner,sun8i-a83t-tcon-tv
32
      - const: allwinner,sun8i-r40-tcon-tv
33
      - const: allwinner,sun8i-v3s-tcon
34
      - const: allwinner,sun9i-a80-tcon-lcd
35
      - const: allwinner,sun9i-a80-tcon-tv
36
      - const: allwinner,sun20i-d1-tcon-lcd
37
      - const: allwinner,sun20i-d1-tcon-tv
38

39
      - items:
40
          - enum:
41
              - allwinner,sun7i-a20-tcon0
42
              - allwinner,sun7i-a20-tcon1
43
          - const: allwinner,sun7i-a20-tcon
44

45
      - items:
46
          - enum:
47
              - allwinner,sun50i-a64-tcon-lcd
48
          - const: allwinner,sun8i-a83t-tcon-lcd
49

50
      - items:
51
          - enum:
52
              - allwinner,sun8i-h3-tcon-tv
53
              - allwinner,sun50i-a64-tcon-tv
54
          - const: allwinner,sun8i-a83t-tcon-tv
55

56
      - items:
57
          - enum:
58
              - allwinner,sun50i-h6-tcon-tv
59
          - const: allwinner,sun8i-r40-tcon-tv
60

61
  reg:
62
    maxItems: 1
63

64
  interrupts:
65
    maxItems: 1
66

67
  clocks:
68
    minItems: 1
69
    maxItems: 4
70

71
  clock-names:
72
    minItems: 1
73
    maxItems: 4
74

75
  clock-output-names:
76
    description:
77
      Name of the LCD pixel clock created.
78
    maxItems: 1
79

80
  dmas:
81
    maxItems: 1
82

83
  resets:
84
    anyOf:
85
      - items:
86
          - description: TCON Reset Line
87

88
      - items:
89
          - description: TCON Reset Line
90
          - description: TCON LVDS Reset Line
91

92
      - items:
93
          - description: TCON Reset Line
94
          - description: TCON eDP Reset Line
95

96
      - items:
97
          - description: TCON Reset Line
98
          - description: TCON eDP Reset Line
99
          - description: TCON LVDS Reset Line
100

101
  reset-names:
102
    oneOf:
103
      - const: lcd
104

105
      - items:
106
          - const: lcd
107
          - const: lvds
108

109
      - items:
110
          - const: lcd
111
          - const: edp
112

113
      - items:
114
          - const: lcd
115
          - const: edp
116
          - const: lvds
117

118
  ports:
119
    $ref: /schemas/graph.yaml#/properties/ports
120

121
    properties:
122
      port@0:
123
        $ref: /schemas/graph.yaml#/properties/port
124
        description: |
125
          Input endpoints of the controller.
126

127
      port@1:
128
        $ref: /schemas/graph.yaml#/$defs/port-base
129
        unevaluatedProperties: false
130
        description: |
131
          Output endpoints of the controller.
132

133
        patternProperties:
134
          "^endpoint(@[0-9])$":
135
            $ref: /schemas/graph.yaml#/$defs/endpoint-base
136
            unevaluatedProperties: false
137

138
            properties:
139
              allwinner,tcon-channel:
140
                $ref: /schemas/types.yaml#/definitions/uint32
141
                description: |
142
                  TCON can have 1 or 2 channels, usually with the
143
                  first channel being used for the panels interfaces
144
                  (RGB, LVDS, etc.), and the second being used for the
145
                  outputs that require another controller (TV Encoder,
146
                  HDMI, etc.).
147

148
                  If that property is present, specifies the TCON
149
                  channel the endpoint is associated to. If that
150
                  property is not present, the endpoint number will be
151
                  used as the channel number.
152

153
    required:
154
      - port@0
155
      - port@1
156

157
required:
158
  - compatible
159
  - reg
160
  - interrupts
161
  - clocks
162
  - clock-names
163
  - resets
164
  - ports
165

166
additionalProperties: false
167

168
allOf:
169
  - if:
170
      properties:
171
        compatible:
172
          contains:
173
            enum:
174
              - allwinner,sun4i-a10-tcon
175
              - allwinner,sun5i-a13-tcon
176
              - allwinner,sun7i-a20-tcon
177

178
    then:
179
      properties:
180
        clocks:
181
          minItems: 3
182

183
        clock-names:
184
          items:
185
            - const: ahb
186
            - const: tcon-ch0
187
            - const: tcon-ch1
188

189
  - if:
190
      properties:
191
        compatible:
192
          contains:
193
            enum:
194
              - allwinner,sun6i-a31-tcon
195
              - allwinner,sun6i-a31s-tcon
196

197
    then:
198
      properties:
199
        clocks:
200
          minItems: 4
201

202
        clock-names:
203
          items:
204
            - const: ahb
205
            - const: tcon-ch0
206
            - const: tcon-ch1
207
            - const: lvds-alt
208

209
  - if:
210
      properties:
211
        compatible:
212
          contains:
213
            enum:
214
              - allwinner,sun8i-a23-tcon
215
              - allwinner,sun8i-a33-tcon
216

217
    then:
218
      properties:
219
        clocks:
220
          minItems: 3
221

222
        clock-names:
223
          items:
224
            - const: ahb
225
            - const: tcon-ch0
226
            - const: lvds-alt
227

228
  - if:
229
      properties:
230
        compatible:
231
          contains:
232
            enum:
233
              - allwinner,sun8i-a83t-tcon-lcd
234
              - allwinner,sun8i-v3s-tcon
235
              - allwinner,sun9i-a80-tcon-lcd
236
              - allwinner,sun20i-d1-tcon-lcd
237

238
    then:
239
      properties:
240
        clocks:
241
          minItems: 2
242

243
        clock-names:
244
          items:
245
            - const: ahb
246
            - const: tcon-ch0
247

248
  - if:
249
      properties:
250
        compatible:
251
          contains:
252
            enum:
253
              - allwinner,sun8i-a83t-tcon-tv
254
              - allwinner,sun8i-r40-tcon-tv
255
              - allwinner,sun9i-a80-tcon-tv
256
              - allwinner,sun20i-d1-tcon-tv
257

258
    then:
259
      properties:
260
        clocks:
261
          minItems: 2
262

263
        clock-names:
264
          items:
265
            - const: ahb
266
            - const: tcon-ch1
267

268
  - if:
269
      properties:
270
        compatible:
271
          contains:
272
            enum:
273
              - allwinner,sun5i-a13-tcon
274
              - allwinner,sun6i-a31-tcon
275
              - allwinner,sun6i-a31s-tcon
276
              - allwinner,sun7i-a20-tcon
277
              - allwinner,sun8i-a23-tcon
278
              - allwinner,sun8i-a33-tcon
279
              - allwinner,sun8i-v3s-tcon
280
              - allwinner,sun9i-a80-tcon-lcd
281
              - allwinner,sun4i-a10-tcon
282
              - allwinner,sun8i-a83t-tcon-lcd
283
              - allwinner,sun20i-d1-tcon-lcd
284

285
    then:
286
      required:
287
        - "#clock-cells"
288
        - clock-output-names
289

290
  - if:
291
      properties:
292
        compatible:
293
          contains:
294
            enum:
295
              - allwinner,sun6i-a31-tcon
296
              - allwinner,sun6i-a31s-tcon
297
              - allwinner,sun8i-a23-tcon
298
              - allwinner,sun8i-a33-tcon
299
              - allwinner,sun8i-a83t-tcon-lcd
300
              - allwinner,sun20i-d1-tcon-lcd
301

302
    then:
303
      properties:
304
        resets:
305
          minItems: 2
306

307
        reset-names:
308
          items:
309
            - const: lcd
310
            - const: lvds
311

312
  - if:
313
      properties:
314
        compatible:
315
          contains:
316
            enum:
317
              - allwinner,sun9i-a80-tcon-lcd
318

319
    then:
320
      properties:
321
        resets:
322
          minItems: 3
323

324
        reset-names:
325
          items:
326
            - const: lcd
327
            - const: edp
328
            - const: lvds
329

330
  - if:
331
      properties:
332
        compatible:
333
          contains:
334
            enum:
335
              - allwinner,sun9i-a80-tcon-tv
336

337
    then:
338
      properties:
339
        resets:
340
          minItems: 2
341

342
        reset-names:
343
          items:
344
            - const: lcd
345
            - const: edp
346

347
  - if:
348
      properties:
349
        compatible:
350
          contains:
351
            enum:
352
              - allwinner,sun4i-a10-tcon
353
              - allwinner,sun5i-a13-tcon
354
              - allwinner,sun6i-a31-tcon
355
              - allwinner,sun6i-a31s-tcon
356
              - allwinner,sun7i-a20-tcon
357
              - allwinner,sun8i-a23-tcon
358
              - allwinner,sun8i-a33-tcon
359

360
    then:
361
      required:
362
        - dmas
363

364
examples:
365
  - |
366
    #include <dt-bindings/dma/sun4i-a10.h>
367

368
    /*
369
     * This comes from the clock/sun4i-a10-ccu.h and
370
     * reset/sun4i-a10-ccu.h headers, but we can't include them since
371
     * it would trigger a bunch of warnings for redefinitions of
372
     * symbols with the other example.
373
     */
374

375
    #define CLK_AHB_LCD0	56
376
    #define CLK_TCON0_CH0	149
377
    #define CLK_TCON0_CH1	155
378
    #define RST_TCON0		11
379

380
    lcd-controller@1c0c000 {
381
        compatible = "allwinner,sun4i-a10-tcon";
382
        reg = <0x01c0c000 0x1000>;
383
        interrupts = <44>;
384
        resets = <&ccu RST_TCON0>;
385
        reset-names = "lcd";
386
        clocks = <&ccu CLK_AHB_LCD0>,
387
                 <&ccu CLK_TCON0_CH0>,
388
                 <&ccu CLK_TCON0_CH1>;
389
        clock-names = "ahb",
390
                      "tcon-ch0",
391
                      "tcon-ch1";
392
        clock-output-names = "tcon0-pixel-clock";
393
        #clock-cells = <0>;
394
        dmas = <&dma SUN4I_DMA_DEDICATED 14>;
395

396
        ports {
397
            #address-cells = <1>;
398
            #size-cells = <0>;
399

400
            port@0 {
401
                #address-cells = <1>;
402
                #size-cells = <0>;
403
                reg = <0>;
404

405
                endpoint@0 {
406
                    reg = <0>;
407
                    remote-endpoint = <&be0_out_tcon0>;
408
                };
409

410
                endpoint@1 {
411
                    reg = <1>;
412
                    remote-endpoint = <&be1_out_tcon0>;
413
                };
414
            };
415

416
            port@1 {
417
                #address-cells = <1>;
418
                #size-cells = <0>;
419
                reg = <1>;
420

421
                endpoint@1 {
422
                    reg = <1>;
423
                    remote-endpoint = <&hdmi_in_tcon0>;
424
                    allwinner,tcon-channel = <1>;
425
                };
426
            };
427
        };
428
    };
429

430
    #undef CLK_AHB_LCD0
431
    #undef CLK_TCON0_CH0
432
    #undef CLK_TCON0_CH1
433
    #undef RST_TCON0
434

435
  - |
436
    #include <dt-bindings/interrupt-controller/arm-gic.h>
437

438
    /*
439
     * This comes from the clock/sun6i-a31-ccu.h and
440
     * reset/sun6i-a31-ccu.h headers, but we can't include them since
441
     * it would trigger a bunch of warnings for redefinitions of
442
     * symbols with the other example.
443
     */
444

445
    #define CLK_PLL_MIPI	15
446
    #define CLK_AHB1_LCD0	47
447
    #define CLK_LCD0_CH0	127
448
    #define CLK_LCD0_CH1	129
449
    #define RST_AHB1_LCD0	27
450
    #define RST_AHB1_LVDS	41
451

452
    lcd-controller@1c0c000 {
453
        compatible = "allwinner,sun6i-a31-tcon";
454
        reg = <0x01c0c000 0x1000>;
455
        interrupts = <GIC_SPI 86 IRQ_TYPE_LEVEL_HIGH>;
456
        dmas = <&dma 11>;
457
        resets = <&ccu RST_AHB1_LCD0>, <&ccu RST_AHB1_LVDS>;
458
        reset-names = "lcd", "lvds";
459
        clocks = <&ccu CLK_AHB1_LCD0>,
460
                 <&ccu CLK_LCD0_CH0>,
461
                 <&ccu CLK_LCD0_CH1>,
462
                 <&ccu CLK_PLL_MIPI>;
463
        clock-names = "ahb",
464
                      "tcon-ch0",
465
                      "tcon-ch1",
466
                      "lvds-alt";
467
        clock-output-names = "tcon0-pixel-clock";
468
        #clock-cells = <0>;
469

470
        ports {
471
            #address-cells = <1>;
472
            #size-cells = <0>;
473

474
            port@0 {
475
                #address-cells = <1>;
476
                #size-cells = <0>;
477
                reg = <0>;
478

479
                endpoint@0 {
480
                    reg = <0>;
481
                    remote-endpoint = <&drc0_out_tcon0>;
482
                };
483

484
                endpoint@1 {
485
                    reg = <1>;
486
                    remote-endpoint = <&drc1_out_tcon0>;
487
                };
488
            };
489

490
            port@1 {
491
                #address-cells = <1>;
492
                #size-cells = <0>;
493
                reg = <1>;
494

495
                endpoint@1 {
496
                    reg = <1>;
497
                    remote-endpoint = <&hdmi_in_tcon0>;
498
                    allwinner,tcon-channel = <1>;
499
                };
500
            };
501
        };
502
    };
503

504
    #undef CLK_PLL_MIPI
505
    #undef CLK_AHB1_LCD0
506
    #undef CLK_LCD0_CH0
507
    #undef CLK_LCD0_CH1
508
    #undef RST_AHB1_LCD0
509
    #undef RST_AHB1_LVDS
510

511
  - |
512
    #include <dt-bindings/interrupt-controller/arm-gic.h>
513

514
    /*
515
     * This comes from the clock/sun9i-a80-ccu.h and
516
     * reset/sun9i-a80-ccu.h headers, but we can't include them since
517
     * it would trigger a bunch of warnings for redefinitions of
518
     * symbols with the other example.
519
     */
520

521
    #define CLK_BUS_LCD0	102
522
    #define CLK_LCD0		58
523
    #define RST_BUS_LCD0	22
524
    #define RST_BUS_EDP		24
525
    #define RST_BUS_LVDS	25
526

527
    lcd-controller@3c00000 {
528
        compatible = "allwinner,sun9i-a80-tcon-lcd";
529
        reg = <0x03c00000 0x10000>;
530
        interrupts = <GIC_SPI 86 IRQ_TYPE_LEVEL_HIGH>;
531
        clocks = <&ccu CLK_BUS_LCD0>, <&ccu CLK_LCD0>;
532
        clock-names = "ahb", "tcon-ch0";
533
        resets = <&ccu RST_BUS_LCD0>, <&ccu RST_BUS_EDP>, <&ccu RST_BUS_LVDS>;
534
        reset-names = "lcd", "edp", "lvds";
535
        clock-output-names = "tcon0-pixel-clock";
536
        #clock-cells = <0>;
537

538
        ports {
539
            #address-cells = <1>;
540
            #size-cells = <0>;
541

542
            port@0 {
543
                reg = <0>;
544

545
                endpoint {
546
                    remote-endpoint = <&drc0_out_tcon0>;
547
                };
548
            };
549

550
            port@1 {
551
                reg = <1>;
552
            };
553
        };
554
    };
555

556
    #undef CLK_BUS_TCON0
557
    #undef CLK_TCON0
558
    #undef RST_BUS_TCON0
559
    #undef RST_BUS_EDP
560
    #undef RST_BUS_LVDS
561

562
  - |
563
    #include <dt-bindings/interrupt-controller/arm-gic.h>
564

565
    /*
566
     * This comes from the clock/sun8i-a83t-ccu.h and
567
     * reset/sun8i-a83t-ccu.h headers, but we can't include them since
568
     * it would trigger a bunch of warnings for redefinitions of
569
     * symbols with the other example.
570
     */
571

572
    #define CLK_BUS_TCON0	36
573
    #define CLK_TCON0		85
574
    #define RST_BUS_TCON0	22
575
    #define RST_BUS_LVDS	31
576

577
    lcd-controller@1c0c000 {
578
        compatible = "allwinner,sun8i-a83t-tcon-lcd";
579
        reg = <0x01c0c000 0x1000>;
580
        interrupts = <GIC_SPI 86 IRQ_TYPE_LEVEL_HIGH>;
581
        clocks = <&ccu CLK_BUS_TCON0>, <&ccu CLK_TCON0>;
582
        clock-names = "ahb", "tcon-ch0";
583
        clock-output-names = "tcon-pixel-clock";
584
        #clock-cells = <0>;
585
        resets = <&ccu RST_BUS_TCON0>, <&ccu RST_BUS_LVDS>;
586
        reset-names = "lcd", "lvds";
587

588
        ports {
589
            #address-cells = <1>;
590
            #size-cells = <0>;
591

592
            port@0 {
593
                #address-cells = <1>;
594
                #size-cells = <0>;
595
                reg = <0>;
596

597
                endpoint@0 {
598
                    reg = <0>;
599
                    remote-endpoint = <&mixer0_out_tcon0>;
600
                };
601

602
                endpoint@1 {
603
                    reg = <1>;
604
                    remote-endpoint = <&mixer1_out_tcon0>;
605
                };
606
            };
607

608
            port@1 {
609
                reg = <1>;
610
            };
611
        };
612
    };
613

614
    #undef CLK_BUS_TCON0
615
    #undef CLK_TCON0
616
    #undef RST_BUS_TCON0
617
    #undef RST_BUS_LVDS
618

619
  - |
620
    #include <dt-bindings/interrupt-controller/arm-gic.h>
621

622
    /*
623
     * This comes from the clock/sun8i-r40-ccu.h and
624
     * reset/sun8i-r40-ccu.h headers, but we can't include them since
625
     * it would trigger a bunch of warnings for redefinitions of
626
     * symbols with the other example.
627
     */
628

629
    #define CLK_BUS_TCON_TV0	73
630
    #define RST_BUS_TCON_TV0	49
631

632
    tcon_tv0: lcd-controller@1c73000 {
633
        compatible = "allwinner,sun8i-r40-tcon-tv";
634
        reg = <0x01c73000 0x1000>;
635
        interrupts = <GIC_SPI 51 IRQ_TYPE_LEVEL_HIGH>;
636
        clocks = <&ccu CLK_BUS_TCON_TV0>, <&tcon_top 0>;
637
        clock-names = "ahb", "tcon-ch1";
638
        resets = <&ccu RST_BUS_TCON_TV0>;
639
        reset-names = "lcd";
640

641
        ports {
642
            #address-cells = <1>;
643
            #size-cells = <0>;
644

645
            port@0 {
646
                #address-cells = <1>;
647
                #size-cells = <0>;
648
                reg = <0>;
649

650
                endpoint@0 {
651
                    reg = <0>;
652
                    remote-endpoint = <&tcon_top_mixer0_out_tcon_tv0>;
653
                };
654

655
                endpoint@1 {
656
                    reg = <1>;
657
                    remote-endpoint = <&tcon_top_mixer1_out_tcon_tv0>;
658
                };
659
            };
660

661
            tcon_tv0_out: port@1 {
662
                #address-cells = <1>;
663
                #size-cells = <0>;
664
                reg = <1>;
665

666
                endpoint@1 {
667
                    reg = <1>;
668
                    remote-endpoint = <&tcon_top_hdmi_in_tcon_tv0>;
669
                };
670
            };
671
        };
672
    };
673

674
    #undef CLK_BUS_TCON_TV0
675
    #undef RST_BUS_TCON_TV0
676

677
...
678

679
Product

Resources

Company
