dt-bindings: net: bluetooth: convert MT7622 Bluetooth to the json-schema
authorRafał Miłecki <rafal@milecki.pl>
Fri, 28 Jun 2024 05:46:35 +0000 (07:46 +0200)
committerLuiz Augusto von Dentz <luiz.von.dentz@intel.com>
Mon, 15 Jul 2024 14:11:25 +0000 (10:11 -0400)
This helps validating DTS files. Introduced changes:
1. Dropped serial details from example
2. Added required example include

Signed-off-by: Rafał Miłecki <rafal@milecki.pl>
Reviewed-by: Rob Herring (Arm) <robh@kernel.org>
Signed-off-by: Luiz Augusto von Dentz <luiz.von.dentz@intel.com>
Documentation/devicetree/bindings/net/bluetooth/mediatek,mt7622-bluetooth.yaml [new file with mode: 0644]
Documentation/devicetree/bindings/net/mediatek-bluetooth.txt

diff --git a/Documentation/devicetree/bindings/net/bluetooth/mediatek,mt7622-bluetooth.yaml b/Documentation/devicetree/bindings/net/bluetooth/mediatek,mt7622-bluetooth.yaml
new file mode 100644 (file)
index 0000000..3f9e692
--- /dev/null
@@ -0,0 +1,51 @@
+# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/net/bluetooth/mediatek,mt7622-bluetooth.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: MediaTek SoC built-in Bluetooth
+
+description:
+  This device is a serial attached device to BTIF device and thus it must be a
+  child node of the serial node with BTIF. The dt-bindings details for BTIF
+  device can be known via Documentation/devicetree/bindings/serial/8250.yaml.
+
+maintainers:
+  - Sean Wang <sean.wang@mediatek.com>
+
+allOf:
+  - $ref: bluetooth-controller.yaml#
+
+properties:
+  compatible:
+    const: mediatek,mt7622-bluetooth
+
+  clocks:
+    maxItems: 1
+
+  clock-names:
+    const: ref
+
+  power-domains:
+    maxItems: 1
+
+required:
+  - clocks
+  - clock-names
+  - power-domains
+
+unevaluatedProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/power/mt7622-power.h>
+
+    serial {
+        bluetooth {
+            compatible = "mediatek,mt7622-bluetooth";
+            power-domains = <&scpsys MT7622_POWER_DOMAIN_WB>;
+            clocks = <&clk25m>;
+            clock-names = "ref";
+        };
+    };
index 9ef5bacda8c18ce4dca582547fada019f00fd794..988c72685cbfd4710547ad7156863b13187a86ef 100644 (file)
@@ -1,39 +1,3 @@
-MediaTek SoC built-in Bluetooth Devices
-==================================
-
-This device is a serial attached device to BTIF device and thus it must be a
-child node of the serial node with BTIF. The dt-bindings details for BTIF
-device can be known via Documentation/devicetree/bindings/serial/8250.yaml.
-
-Required properties:
-
-- compatible:  Must be
-                 "mediatek,mt7622-bluetooth": for MT7622 SoC
-- clocks:      Should be the clock specifiers corresponding to the entry in
-               clock-names property.
-- clock-names: Should contain "ref" entries.
-- power-domains: Phandle to the power domain that the device is part of
-
-Example:
-
-       btif: serial@1100c000 {
-               compatible = "mediatek,mt7622-btif",
-                            "mediatek,mtk-btif";
-               reg = <0 0x1100c000 0 0x1000>;
-               interrupts = <GIC_SPI 90 IRQ_TYPE_LEVEL_LOW>;
-               clocks = <&pericfg CLK_PERI_BTIF_PD>;
-               clock-names = "main";
-               reg-shift = <2>;
-               reg-io-width = <4>;
-
-               bluetooth {
-                       compatible = "mediatek,mt7622-bluetooth";
-                       power-domains = <&scpsys MT7622_POWER_DOMAIN_WB>;
-                       clocks = <&clk25m>;
-                       clock-names = "ref";
-               };
-       };
-
 MediaTek UART based Bluetooth Devices
 ==================================