[PATCH v3 3/4] dt-bindings: arm: keystone: Convert keystone.txt to YAML

From: Andrew Davis
Date: Thu Feb 01 2024 - 17:50:48 EST


Convert keystone.txt to ti,keystone.yaml.

Signed-off-by: Andrew Davis <afd@xxxxxx>
Reviewed-by: Rob Herring <robh@xxxxxxxxxx>
---

Changes for v3:
- Add tags and rebase

Documentation/arch/arm/keystone/overview.rst | 2 +-
.../bindings/arm/keystone/keystone.txt | 42 ---------------
.../bindings/arm/keystone/ti,keystone.yaml | 53 +++++++++++++++++++
3 files changed, 54 insertions(+), 43 deletions(-)
delete mode 100644 Documentation/devicetree/bindings/arm/keystone/keystone.txt
create mode 100644 Documentation/devicetree/bindings/arm/keystone/ti,keystone.yaml

diff --git a/Documentation/arch/arm/keystone/overview.rst b/Documentation/arch/arm/keystone/overview.rst
index cd90298c493c7..6d8896ba9a6e2 100644
--- a/Documentation/arch/arm/keystone/overview.rst
+++ b/Documentation/arch/arm/keystone/overview.rst
@@ -65,7 +65,7 @@ specified through DTS. Following are the DTS used:

The device tree documentation for the keystone machines are located at

- Documentation/devicetree/bindings/arm/keystone/keystone.txt
+ Documentation/devicetree/bindings/arm/keystone/ti,keystone.yaml

Document Author
---------------
diff --git a/Documentation/devicetree/bindings/arm/keystone/keystone.txt b/Documentation/devicetree/bindings/arm/keystone/keystone.txt
deleted file mode 100644
index f310bad044830..0000000000000
--- a/Documentation/devicetree/bindings/arm/keystone/keystone.txt
+++ /dev/null
@@ -1,42 +0,0 @@
-TI Keystone Platforms Device Tree Bindings
------------------------------------------------
-
-Boards with Keystone2 based devices (TCI66xxK2H) SOC shall have the
-following properties.
-
-Required properties:
- - compatible: All TI specific devices present in Keystone SOC should be in
- the form "ti,keystone-*". Generic devices like gic, arch_timers, ns16550
- type UART should use the specified compatible for those devices.
-
-SoC families:
-
-- Keystone 2 generic SoC:
- compatible = "ti,keystone"
-
-SoCs:
-
-- Keystone 2 Hawking/Kepler
- compatible = "ti,k2hk", "ti,keystone"
-- Keystone 2 Lamarr
- compatible = "ti,k2l", "ti,keystone"
-- Keystone 2 Edison
- compatible = "ti,k2e", "ti,keystone"
-- K2G
- compatible = "ti,k2g", "ti,keystone"
-
-Boards:
-- Keystone 2 Hawking/Kepler EVM
- compatible = "ti,k2hk-evm", "ti,k2hk", "ti,keystone"
-
-- Keystone 2 Lamarr EVM
- compatible = "ti,k2l-evm", "ti, k2l", "ti,keystone"
-
-- Keystone 2 Edison EVM
- compatible = "ti,k2e-evm", "ti,k2e", "ti,keystone"
-
-- K2G EVM
- compatible = "ti,k2g-evm", "ti,k2g", "ti-keystone"
-
-- K2G Industrial Communication Engine EVM
- compatible = "ti,k2g-ice", "ti,k2g", "ti-keystone"
diff --git a/Documentation/devicetree/bindings/arm/keystone/ti,keystone.yaml b/Documentation/devicetree/bindings/arm/keystone/ti,keystone.yaml
new file mode 100644
index 0000000000000..60af461af5ff9
--- /dev/null
+++ b/Documentation/devicetree/bindings/arm/keystone/ti,keystone.yaml
@@ -0,0 +1,53 @@
+# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/arm/keystone/ti,keystone.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Texas Instruments Keystone SoC architecture
+
+maintainers:
+ - Andrew Davis <afd@xxxxxx>
+
+description: |
+ Platforms based on Texas Instruments Keystone2 Multicore SoC architecture
+ shall have the following properties.
+
+properties:
+ $nodename:
+ const: '/'
+ compatible:
+ oneOf:
+
+ - description: Keystone 2 Hawking/Kepler
+ items:
+ - enum:
+ - ti,k2hk-evm # Keystone 2 Hawking/Kepler EVM
+ - const: ti,k2hk
+ - const: ti,keystone
+
+ - description: Keystone 2 Lamarr
+ items:
+ - enum:
+ - ti,k2l-evm # Keystone 2 Lamarr EVM
+ - const: ti,k2l
+ - const: ti,keystone
+
+ - description: Keystone 2 Edison
+ items:
+ - enum:
+ - ti,k2e-evm # Keystone 2 Edison EVM
+ - const: ti,k2e
+ - const: ti,keystone
+
+ - description: K2G
+ items:
+ - enum:
+ - ti,k2g-evm # K2G EVM
+ - ti,k2g-ice # K2G Industrial Communication Engine EVM
+ - const: ti,k2g
+ - const: ti,keystone
+
+additionalProperties: true
+
+...
--
2.39.2