xref: /freebsd/sys/contrib/device-tree/Bindings/mailbox/brcm,iproc-pdc-mbox.txt (revision 06c3fb2749bda94cb5201f81ffdb8fa6c3161b2e)
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