dt-bindings: input: apple: Add Dockchannel HID bindings

This adds device tree bindings for the DockChannel HID node
required to enable internal keyboard/trackpad support on
Apple Silicon M2 and later laptops.

Signed-off-by: Michael Reeves <[email protected]>

Author: IntegralPilot

Documentation/devicetree/bindings/input/apple,dockchannel-hid.yaml

@@ -0,0 +1,102 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/input/apple,dockchannel-hid.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Apple DockChannel HID Transport
+
+maintainers:
+  - Michael Reeves <[email protected]>
+
+description: |
+  Transport layer for HID devices (keyboard, trackpad) connected via the
+  DockChannel FIFO interface on Apple Silicon SoCs. Contains a minimal
+  coprocessor called the MTP (Multi-Touch Coprocessor) which assists with
+  this and must be booted for it to work.
+
+properties:
+  compatible:
+    oneOf:
+      - items:
+          - const: apple,t8112-dockchannel-hid
+      - items:
+          - const: apple,t6020-dockchannel-hid
+          - const: apple,t8112-dockchannel-hid
+
+  reg:
+    items:
+      - description: Config interface registers
+      - description: Data interface registers
+      - description: Coprocessor ASC registers
+      - description: Coprocessor SRAM/mailbox registers
+
+  reg-names:
+    items:
+      - const: config
+      - const: data
+      - const: coproc-asc
+      - const: coproc-sram
+
+  interrupts:
+    items:
+      - description: TX interrupt
+      - description: RX interrupt
+
+  interrupt-names:
+    items:
+      - const: tx
+      - const: rx
+
+  mboxes:
+    maxItems: 1
+
+  iommus:
+    maxItems: 1
+
+  keyboard:
+    type: object
+    description: |
+      Optional properties for the internal keyboard.
+    properties:
+      hid-country-code:
+        $ref: /schemas/types.yaml#/definitions/uint32
+        description: The USB HID country code for the keyboard layout.
+    additionalProperties: false
+
+required:
+  - compatible
+  - reg
+  - reg-names
+  - interrupts
+  - interrupt-names
+  - mboxes
+  - iommus
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/interrupt-controller/irq.h>
+
+    soc {
+        #address-cells = <2>;
+        #size-cells = <2>;
+
+        input@8000 {
+            compatible = "apple,t8112-dockchannel-hid";
+            reg = <0x2 0xfab30000 0x0 0x4000>,
+                  <0x2 0xfab34000 0x0 0x4000>,
+                  <0x2 0xfa400000 0x0 0x4000>,
+                  <0x2 0xfa050000 0x0 0x100000>;
+            reg-names = "config", "data", "coproc-asc", "coproc-sram";
+            mboxes = <&mtp_mbox>;
+            iommus = <&mtp_dart 1>;
+            interrupts = <2 IRQ_TYPE_LEVEL_HIGH>, <3 IRQ_TYPE_LEVEL_HIGH>;
+            interrupt-names = "tx", "rx";
+
+            keyboard {
+                hid-country-code = <0>;
+            };
+        };
+    };