Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings: mailbox: Convert brcm,iproc-pdc-mbox to DT schema
Convert the Broadcom iProc PDC mailbox binding to DT schema format. It's
a straightforward conversion.
Link: https://lore.kernel.org/r/20250812181406.65390-1-robh@kernel.org
Signed-off-by: Rob Herring (Arm) <robh@kernel.org>
+66
-25
-25
Documentation/devicetree/bindings/mailbox/brcm,iproc-pdc-mbox.txt
-25
Documentation/devicetree/bindings/mailbox/brcm,iproc-pdc-mbox.txt
···
1
-
The PDC driver manages data transfer to and from various offload engines
2
-
on some Broadcom SoCs. An SoC may have multiple PDC hardware blocks. There is
3
-
one device tree entry per block. On some chips, the PDC functionality is
4
-
handled by the FA2 (Northstar Plus).
5
-
6
-
Required 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
-
14
-
Optional properties:
15
-
- brcm,use-bcm-hdr: present if a BCM header precedes each frame.
16
-
17
-
Example:
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
-
};
+66
Documentation/devicetree/bindings/mailbox/brcm,iproc-pdc-mbox.yaml
+66
Documentation/devicetree/bindings/mailbox/brcm,iproc-pdc-mbox.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/brcm,iproc-pdc-mbox.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: Broadcom iProc PDC mailbox
8
+
9
+
maintainers:
10
+
- Ray Jui <rjui@broadcom.com>
11
+
- Scott Branden <sbranden@broadcom.com>
12
+
13
+
description:
14
+
The PDC driver manages data transfer to and from various offload engines on
15
+
some Broadcom SoCs. An SoC may have multiple PDC hardware blocks. There is one
16
+
device tree entry per block. On some chips, the PDC functionality is handled
17
+
by the FA2 (Northstar Plus).
18
+
19
+
properties:
20
+
compatible:
21
+
enum:
22
+
- brcm,iproc-pdc-mbox
23
+
- brcm,iproc-fa2-mbox
24
+
25
+
reg:
26
+
maxItems: 1
27
+
28
+
dma-coherent: true
29
+
30
+
interrupts:
31
+
maxItems: 1
32
+
33
+
'#mbox-cells':
34
+
const: 1
35
+
36
+
brcm,rx-status-len:
37
+
description:
38
+
Length of metadata preceding received frames, in bytes.
39
+
$ref: /schemas/types.yaml#/definitions/uint32
40
+
41
+
brcm,use-bcm-hdr:
42
+
type: boolean
43
+
description:
44
+
Present if a BCM header precedes each frame.
45
+
46
+
required:
47
+
- compatible
48
+
- reg
49
+
- interrupts
50
+
- '#mbox-cells'
51
+
- brcm,rx-status-len
52
+
53
+
additionalProperties: false
54
+
55
+
examples:
56
+
- |
57
+
#include <dt-bindings/interrupt-controller/arm-gic.h>
58
+
59
+
mailbox0@612c0000 {
60
+
compatible = "brcm,iproc-pdc-mbox";
61
+
reg = <0x612c0000 0x445>;
62
+
interrupts = <GIC_SPI 187 IRQ_TYPE_LEVEL_HIGH>;
63
+
#mbox-cells = <1>;
64
+
brcm,rx-status-len = <32>;
65
+
brcm,use-bcm-hdr;
66
+
};