From: Lubomir Rintel <lkundrak@xxxxx> Signed-off-by: Lubomir Rintel <lkundrak@xxxxx> Signed-off-by: Craig McGeachie <slapdau@xxxxxxxxxxxx> Signed-off-by: Eric Anholt <eric@xxxxxxxxxx> Acked-by: Lee Jones <lee.jones@xxxxxxxxxx> Acked-by: Stephen Warren <swarren@xxxxxxxxxxxxx> --- v2: Split into a separate patch for submitting to the devicetree list. Consistently start node docs with a capital letter. device's address in the example shouldn't have "0x". Drop machine-specific interrupt numbers from the docs. (changes by anholt). v3: Move the file to just bcm2835-mbox.txt, clean up formatting (changes by anholt, from review by Lee Jones). v4: Move file back by consensus from various Broadcom platform maintainers (changes by anholt, acked by Lee Jones). v5: Document that the mailbox cell should be 0 in clients, and add an example of a client (changes by anholt, from review by Jassi). .../bindings/mailbox/brcm,bcm2835-mbox.txt | 27 ++++++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 Documentation/devicetree/bindings/mailbox/brcm,bcm2835-mbox.txt diff --git a/Documentation/devicetree/bindings/mailbox/brcm,bcm2835-mbox.txt b/Documentation/devicetree/bindings/mailbox/brcm,bcm2835-mbox.txt new file mode 100644 index 0000000..731de34 --- /dev/null +++ b/Documentation/devicetree/bindings/mailbox/brcm,bcm2835-mbox.txt @@ -0,0 +1,27 @@ +Broadcom BCM2835 VideoCore mailbox IPC + +Required properties: + +- compatible: Should be "brcm,bcm2835-mbox" +- reg: Specifies base physical address and size of the registers +- interrupts: The interrupt number + See bindings/interrupt-controller/brcm,bcm2835-armctrl-ic.txt +- #mbox-cells: Specifies the number of cells needed to encode a mailbox + channel. The value shall be 1. Clients should supply a value + of 0 for the mailbox channel, because there is only one + exposed + +Example: + +mailbox: mailbox@7e00b800 { + compatible = "brcm,bcm2835-mbox"; + reg = <0x7e00b880 0x40>; + interrupts = <0 1>; + #mbox-cells = <1>; +}; + +firmware: firmware { + compatible = "raspberrypi,firmware"; + mboxes = <&mailbox 0>; + #power-domain-cells = <1>; +}; -- 2.1.4 -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html