Skip to contentSkip to conversation

dt-bindings: mailbox: sti-mailbox: convert to DT schema

PATCH In review Alain Volmat 3 participants 5 messages Feb 14, 2023 – Apr 8, 2023

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

PATCH v3 1/1 dt-bindings: mailbox: sti-mailbox: convert to DT schema

Convert the sti-mailbox.txt file into st,sti-mailbox.yaml

---
v3: remove quotes around $ref
v2: update commit log
remove quotes around urls
add mbox-name $ref
remove mbox-name from required properties since not mandatory in the driver fix IRQ type in example

 .../bindings/mailbox/st,sti-mailbox.yaml      | 53 +++++++++++++++++++
 .../bindings/mailbox/sti-mailbox.txt          | 51 ------------------
 2 files changed, 53 insertions(+), 51 deletions(-)
 create mode 100644 Documentation/devicetree/bindings/mailbox/st,sti-mailbox.yaml
 delete mode 100644 Documentation/devicetree/bindings/mailbox/sti-mailbox.txt
Documentation/devicetree/bindings/mailbox/st,sti-mailbox.yaml new file +53 -0
new file mode 100644
index 000000000000..a023c28dff49
@@ -0,0 +1,53 @@
+# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/mailbox/st,sti-mailbox.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: STMicroelectronics Mailbox Driver for STi platform
+
+description:
+  Each ST Mailbox IP currently consists of 4 instances of 32 channels.
+  Messages are passed between Application and Remote processors using
+  shared memory.
+
+maintainers:
+  - Patrice Chotard <[email protected]>
+
+properties:
+  compatible:
+    const: st,stih407-mailbox
+
+  reg:
+    maxItems: 1
+
+  mbox-name:
+    $ref: /schemas/types.yaml#/definitions/string
+    description: name of the mailbox IP
+
+  interrupts:
+    description: the irq line for the RX mailbox
+    maxItems: 1
+
+  "#mbox-cells":
+    const: 2
+
+required:
+  - compatible
+  - reg
+  - "#mbox-cells"
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/interrupt-controller/arm-gic.h>
+    mailbox0: mailbox@8f00000  {
+        compatible = "st,stih407-mailbox";
+        reg = <0x8f00000 0x1000>;
+        interrupts = <GIC_SPI 1 IRQ_TYPE_LEVEL_HIGH>;
+        #mbox-cells = <2>;
+        mbox-name = "a9";
+    };
+
+...
Documentation/devicetree/bindings/mailbox/sti-mailbox.txt deleted +0 -51

51 lines not on this page · raw message

Signature · 1 line
2.34.1
Reviewed-by on v3 1/1
#1 lore raw
Quoted 11 lines · Alain Volmat

Convert the sti-mailbox.txt file into st,sti-mailbox.yaml

---
v3: remove quotes around $ref
v2: update commit log
remove quotes around urls
add mbox-name $ref
remove mbox-name from required properties since not mandatory in the driver fix IRQ type in example

Quoted 2 lines
 .../bindings/mailbox/st,sti-mailbox.yaml      | 53 +++++++++++++++++++
 .../bindings/mailbox/sti-mailbox.txt          | 51 ------------------

Best regards,
Krzysztof

#2 lore raw

Gentle reminder, could someone take this patch into his branch ?

Regards,
Alain

Quoted 21 lines · Krzysztof Kozlowski
Quoted 11 lines · Alain Volmat

Convert the sti-mailbox.txt file into st,sti-mailbox.yaml

---
v3: remove quotes around $ref
v2: update commit log
remove quotes around urls
add mbox-name $ref
remove mbox-name from required properties since not mandatory in the driver fix IRQ type in example

Quoted 2 lines
 .../bindings/mailbox/st,sti-mailbox.yaml      | 53 +++++++++++++++++++
 .../bindings/mailbox/sti-mailbox.txt          | 51 ------------------

Best regards,
Krzysztof

#3 lore raw
Quoted 1 line · Alain Volmat

Gentle reminder, could someone take this patch into his branch ?

You addressed the email to me, but I am not the maintainer to take this patch.

Best regards,
Krzysztof

maintainer
#4 lore raw
In reply to Alain Volmat
Quoted 3 lines · Alain Volmat

Gentle reminder, could someone take this patch into his branch ?

Why do you think it's not picked yet?
Please have a look at v6.3-rc1

cheers
-jassi