new file mode 100644
@@ -0,0 +1,86 @@
+# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/media/allegrodvt,al300-vdec.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Allegro DVT Video IP Decoder Gen 3
+
+maintainers:
+ - Yassine OUAISSA <yassine.ouaissa@allegrodvt.com>
+
+description: |-
+ The al300-vdec represents the latest generation of Allegro DVT IP decoding technology, offering
+ significant advancements over its predecessors. This new decoder features
+ enhanced processing capabilities with improved throughput and reduced latency.
+
+ Communication between the host driver software and the MCU is implemented through
+ a specialized mailbox interface mechanism. This mailbox system provides a
+ structured channel for exchanging commands, parameters, and status information
+ between the host CPU and the MCU controlling the codec engines.
+
+properties:
+ compatible:
+ const: allegrodvt,al300-vdec
+
+ reg:
+ items:
+ - description: The registers
+ - description: the MCU APB register
+
+ reg-names:
+ items:
+ - const: regs
+ - const: apb
+
+ interrupts:
+ maxItems: 1
+
+ clocks:
+ items:
+ - description: MCU clock
+
+ clock-names:
+ items:
+ - const: mcu_clk
+
+ memory-region:
+ items:
+ - description: Used to allocate memory for the MCU firmware,
+ and is also used for various operational buffers required by the MCU during codec operations.
+
+ firmware-name:
+ $ref: /schemas/types.yaml#/definitions/string
+ description:
+ If present, name of the file within the firmware search path containing
+ the MCU firmware.
+
+required:
+ - compatible
+ - reg
+ - reg-names
+ - interrupts
+ - clocks
+ - clock-names
+
+additionalProperties: False
+
+examples:
+ - |
+ axi {
+ #address-cells = <2>;
+ #size-cells = <2>;
+
+ ald300: ald300@a0120000 {
+ compatible = "allegrodvt,al300-vdec";
+ reg = <0 0xa0120000 0 0x80000>,
+ <0x01 0x8000000 0x00 0x8000000>;
+ reg-names = "regs", "apb";
+ interrupts = <0 96 4>;
+ clocks = <&mcu_clock_dec>;
+ clock-names = "mcu_clk";
+ firmware-name = "al300_vdec.fw";
+ };
+ };
+
+...
@@ -807,6 +807,7 @@ R: Pengutronix Kernel Team <kernel@pengutronix.de>
L: linux-media@vger.kernel.org
S: Maintained
F: Documentation/devicetree/bindings/media/allegro,al5e.yaml
+F: Documentation/devicetree/bindings/media/allegrodvt,al300-vdec.yaml
F: drivers/media/platform/allegro-dvt/al300
F: drivers/media/platform/allegro-dvt/zynqmp
Add the device-tree bindings for the allegro-dvt Gen 3 IP decoders, and update the MAINTAINERS file. Signed-off-by: Yassine Ouaissa <yassine.ouaissa@allegrodvt.com> --- .../bindings/media/allegrodvt,al300-vdec.yaml | 86 +++++++++++++++++++ MAINTAINERS | 1 + 2 files changed, 87 insertions(+) create mode 100644 Documentation/devicetree/bindings/media/allegrodvt,al300-vdec.yaml