linux/Documentation/devicetree/bindings/soc/apple/apple,dockchannel.yaml at a8a69b12a2d4ac24a3ab6ebc7c6147c88527eccb · IntegralPilot/linux · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
# Copyright (c) 2025 The Asahi Linux contributors
%YAML 1.2
---
$id: http://devicetree.org/schemas/soc/apple/apple,dockchannel.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Apple DockChannel FIFO

maintainers:
  - Michael Reeves <[email protected]>

description: |
  DockChannel is a hardware FIFO and interrupt controller used on Apple SoCs
  for low-latency communication with co-processors.

properties:
  compatible:
    oneOf:
      - items:
          - const: apple,t8112-dockchannel
      - items:
          - const: apple,t6020-dockchannel
          - const: apple,t8112-dockchannel

  reg:
    maxItems: 1

  interrupts:
    maxItems: 1

  interrupt-controller: true

  "#interrupt-cells":
    const: 2

  ranges: true

  nonposted-mmio: true

  "#address-cells":
    const: 2

  "#size-cells":
    const: 2

patternProperties:
  "^input@[0-9a-f]+$":
    $ref: /schemas/input/apple,dockchannel-hid.yaml

required:
  - compatible
  - reg
  - interrupts
  - interrupt-controller
  - "#interrupt-cells"
  - ranges
  - "#address-cells"
  - "#size-cells"

additionalProperties: false

examples:
  - |
    #include <dt-bindings/interrupt-controller/apple-aic.h>
    #include <dt-bindings/interrupt-controller/irq.h>

    soc {
        #address-cells = <2>;
        #size-cells = <2>;

        fifo@2a9b14000 {
      		compatible = "apple,t6020-dockchannel", "apple,t8112-dockchannel";
      		reg = <0x2 0xa9b14000 0x0 0x4000>;

      		interrupt-parent = <&aic>;
      		interrupts = <AIC_IRQ 0 677 IRQ_TYPE_LEVEL_HIGH>;

      		ranges;
      		#address-cells = <2>;
      		#size-cells = <2>;

      		interrupt-controller;
      		#interrupt-cells = <2>;
        };
    };