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

dt-bindings: mailbox: Convert rockchip,rk3368-mailbox to DT schema

Convert the rockchip,rk3368-mailbox binding to DT schema format. Add
the missing 'clocks' and 'clock-names' properties. Document that it's
one interrupt per mailbox channel (and there are 4 channels).

Link: https://lore.kernel.org/r/20250812181348.62137-1-robh@kernel.org
Signed-off-by: Rob Herring (Arm) <robh@kernel.org>

+56 -32
+56
Documentation/devicetree/bindings/mailbox/rockchip,rk3368-mailbox.yaml
··· 1 + # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/mailbox/rockchip,rk3368-mailbox.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: Rockchip RK3368 Mailbox Controller 8 + 9 + maintainers: 10 + - Heiko Stuebner <heiko@sntech.de> 11 + 12 + description: 13 + The Rockchip mailbox is used by the Rockchip CPU cores to communicate 14 + requests to MCU processor. 15 + 16 + properties: 17 + compatible: 18 + const: rockchip,rk3368-mailbox 19 + 20 + reg: 21 + maxItems: 1 22 + 23 + clocks: 24 + maxItems: 1 25 + 26 + clock-names: 27 + const: pclk_mailbox 28 + 29 + interrupts: 30 + description: One interrupt for each channel 31 + maxItems: 4 32 + 33 + '#mbox-cells': 34 + const: 1 35 + 36 + required: 37 + - compatible 38 + - reg 39 + - interrupts 40 + - '#mbox-cells' 41 + 42 + additionalProperties: false 43 + 44 + examples: 45 + - | 46 + #include <dt-bindings/interrupt-controller/arm-gic.h> 47 + 48 + mailbox@ff6b0000 { 49 + compatible = "rockchip,rk3368-mailbox"; 50 + reg = <0xff6b0000 0x1000>; 51 + interrupts = <GIC_SPI 146 IRQ_TYPE_LEVEL_HIGH>, 52 + <GIC_SPI 147 IRQ_TYPE_LEVEL_HIGH>, 53 + <GIC_SPI 148 IRQ_TYPE_LEVEL_HIGH>, 54 + <GIC_SPI 149 IRQ_TYPE_LEVEL_HIGH>; 55 + #mbox-cells = <1>; 56 + };
-32
Documentation/devicetree/bindings/mailbox/rockchip-mailbox.txt
··· 1 - Rockchip mailbox 2 - 3 - The Rockchip mailbox is used by the Rockchip CPU cores to communicate 4 - requests to MCU processor. 5 - 6 - Refer to ./mailbox.txt for generic information about mailbox device-tree 7 - bindings. 8 - 9 - Required properties: 10 - 11 - - compatible: should be one of the following. 12 - - "rockchip,rk3368-mbox" for rk3368 13 - - reg: physical base address of the controller and length of memory mapped 14 - region. 15 - - interrupts: The interrupt number to the cpu. The interrupt specifier format 16 - depends on the interrupt controller. 17 - - #mbox-cells: Common mailbox binding property to identify the number 18 - of cells required for the mailbox specifier. Should be 1 19 - 20 - Example: 21 - -------- 22 - 23 - /* RK3368 */ 24 - mbox: mbox@ff6b0000 { 25 - compatible = "rockchip,rk3368-mailbox"; 26 - reg = <0x0 0xff6b0000 0x0 0x1000>, 27 - interrupts = <GIC_SPI 146 IRQ_TYPE_LEVEL_HIGH>, 28 - <GIC_SPI 147 IRQ_TYPE_LEVEL_HIGH>, 29 - <GIC_SPI 148 IRQ_TYPE_LEVEL_HIGH>, 30 - <GIC_SPI 149 IRQ_TYPE_LEVEL_HIGH>; 31 - #mbox-cells = <1>; 32 - };