xref: /freebsd/sys/contrib/device-tree/Bindings/mailbox/brcm,iproc-pdc-mbox.txt (revision 8b959dd6a3921c35395bef4a6d7ad2426a3bd88e)
1The PDC driver manages data transfer to and from various offload engines
2on some Broadcom SoCs. An SoC may have multiple PDC hardware blocks. There is
3one device tree entry per block.  On some chips, the PDC functionality is
4handled by the FA2 (Northstar Plus).
5
6Required properties:
7- compatible : Should be "brcm,iproc-pdc-mbox" or "brcm,iproc-fa2-mbox" for
8  FA2/Northstar Plus.
9- reg: Should contain PDC registers location and length.
10- interrupts: Should contain the IRQ line for the PDC.
11- #mbox-cells: 1
12- brcm,rx-status-len: Length of metadata preceding received frames, in bytes.
13
14Optional properties:
15- brcm,use-bcm-hdr:  present if a BCM header precedes each frame.
16
17Example:
18	pdc0: iproc-pdc0@612c0000 {
19		compatible = "brcm,iproc-pdc-mbox";
20		reg = <0 0x612c0000 0 0x445>;  /* PDC FS0 regs */
21		interrupts = <GIC_SPI 187 IRQ_TYPE_LEVEL_HIGH>;
22		#mbox-cells = <1>;   /* one cell per mailbox channel */
23		brcm,rx-status-len = <32>;
24		brcm,use-bcm-hdr;
25	};
26