1b543df9fSSamuel Holland# SPDX-License-Identifier: GPL-2.0 2b543df9fSSamuel Holland%YAML 1.2 3b543df9fSSamuel Holland--- 4b543df9fSSamuel Holland$id: http://devicetree.org/schemas/mailbox/allwinner,sun6i-a31-msgbox.yaml# 5b543df9fSSamuel Holland$schema: http://devicetree.org/meta-schemas/core.yaml# 6b543df9fSSamuel Holland 7b543df9fSSamuel Hollandtitle: Allwinner sunxi Message Box 8b543df9fSSamuel Holland 9b543df9fSSamuel Hollandmaintainers: 10b543df9fSSamuel Holland - Samuel Holland <samuel@sholland.org> 11b543df9fSSamuel Holland 12b543df9fSSamuel Hollanddescription: | 13b543df9fSSamuel Holland The hardware message box on sun6i, sun8i, sun9i, and sun50i SoCs is a 14b543df9fSSamuel Holland two-user mailbox controller containing 8 unidirectional FIFOs. An interrupt 15b543df9fSSamuel Holland is raised for received messages, but software must poll to know when a 16b543df9fSSamuel Holland transmitted message has been acknowledged by the remote user. Each FIFO can 17b543df9fSSamuel Holland hold four 32-bit messages; when a FIFO is full, clients must wait before 18b543df9fSSamuel Holland attempting more transmissions. 19b543df9fSSamuel Holland 20b543df9fSSamuel Holland Refer to ./mailbox.txt for generic information about mailbox device-tree 21b543df9fSSamuel Holland bindings. 22b543df9fSSamuel Holland 23b543df9fSSamuel Hollandproperties: 24b543df9fSSamuel Holland compatible: 25b543df9fSSamuel Holland oneOf: 26b543df9fSSamuel Holland - items: 27b543df9fSSamuel Holland - enum: 28b543df9fSSamuel Holland - allwinner,sun8i-a83t-msgbox 29b543df9fSSamuel Holland - allwinner,sun8i-h3-msgbox 30b543df9fSSamuel Holland - allwinner,sun9i-a80-msgbox 31b543df9fSSamuel Holland - allwinner,sun50i-a64-msgbox 32b543df9fSSamuel Holland - allwinner,sun50i-h6-msgbox 33b543df9fSSamuel Holland - const: allwinner,sun6i-a31-msgbox 34b543df9fSSamuel Holland - const: allwinner,sun6i-a31-msgbox 35b543df9fSSamuel Holland 36b543df9fSSamuel Holland reg: 37b543df9fSSamuel Holland maxItems: 1 38b543df9fSSamuel Holland 39b543df9fSSamuel Holland clocks: 40b543df9fSSamuel Holland maxItems: 1 41b543df9fSSamuel Holland description: bus clock 42b543df9fSSamuel Holland 43b543df9fSSamuel Holland resets: 44b543df9fSSamuel Holland maxItems: 1 45b543df9fSSamuel Holland description: bus reset 46b543df9fSSamuel Holland 47b543df9fSSamuel Holland interrupts: 48b543df9fSSamuel Holland maxItems: 1 49b543df9fSSamuel Holland 50b543df9fSSamuel Holland '#mbox-cells': 51b543df9fSSamuel Holland const: 1 52b543df9fSSamuel Holland description: first cell is the channel number (0-7) 53b543df9fSSamuel Holland 54b543df9fSSamuel Hollandrequired: 55b543df9fSSamuel Holland - compatible 56b543df9fSSamuel Holland - reg 57b543df9fSSamuel Holland - clocks 58b543df9fSSamuel Holland - resets 59b543df9fSSamuel Holland - interrupts 60b543df9fSSamuel Holland - '#mbox-cells' 61b543df9fSSamuel Holland 62b543df9fSSamuel HollandadditionalProperties: false 63b543df9fSSamuel Holland 64b543df9fSSamuel Hollandexamples: 65b543df9fSSamuel Holland - | 66b543df9fSSamuel Holland #include <dt-bindings/clock/sun8i-h3-ccu.h> 67b543df9fSSamuel Holland #include <dt-bindings/interrupt-controller/arm-gic.h> 68b543df9fSSamuel Holland #include <dt-bindings/reset/sun8i-h3-ccu.h> 69b543df9fSSamuel Holland 70b543df9fSSamuel Holland msgbox: mailbox@1c17000 { 71b543df9fSSamuel Holland compatible = "allwinner,sun8i-h3-msgbox", 72b543df9fSSamuel Holland "allwinner,sun6i-a31-msgbox"; 73b543df9fSSamuel Holland reg = <0x01c17000 0x1000>; 74b543df9fSSamuel Holland clocks = <&ccu CLK_BUS_MSGBOX>; 75b543df9fSSamuel Holland resets = <&ccu RST_BUS_MSGBOX>; 76b543df9fSSamuel Holland interrupts = <GIC_SPI 49 IRQ_TYPE_LEVEL_HIGH>; 77b543df9fSSamuel Holland #mbox-cells = <1>; 78b543df9fSSamuel Holland }; 79b543df9fSSamuel Holland 80b543df9fSSamuel Holland... 81