.../devicetree/bindings/arm/omap/l4.txt | 37 -------- .../bindings/arm/omap/ti,omap-l4.yaml | 93 +++++++++++++++++++ 2 files changed, 93 insertions(+), 37 deletions(-) delete mode 100644 Documentation/devicetree/bindings/arm/omap/l4.txt create mode 100644 Documentation/devicetree/bindings/arm/omap/ti,omap-l4.yaml
Convert the Texas Instruments OMAP L4 interconnect bus bindings
to DT schema.
During the conversion, several updates were made:
- Defined the compatible property as an array to require
the TI-specific string first, followed by either 'simple-bus' or
'simple-pm-bus'.
- Added a 'select' block to ensure this schema is only
applied to TI-specific nodes, preventing duplicate
schema warnings against the core simple-pm-bus.yaml.
- Made 'reg' and 'reg-names' optional.
Signed-off-by: Eduard Bostina <egbostina@gmail.com>
---
.../devicetree/bindings/arm/omap/l4.txt | 37 --------
.../bindings/arm/omap/ti,omap-l4.yaml | 93 +++++++++++++++++++
2 files changed, 93 insertions(+), 37 deletions(-)
delete mode 100644 Documentation/devicetree/bindings/arm/omap/l4.txt
create mode 100644 Documentation/devicetree/bindings/arm/omap/ti,omap-l4.yaml
diff --git a/Documentation/devicetree/bindings/arm/omap/l4.txt b/Documentation/devicetree/bindings/arm/omap/l4.txt
deleted file mode 100644
index 6816adcdc15f..000000000000
--- a/Documentation/devicetree/bindings/arm/omap/l4.txt
+++ /dev/null
@@ -1,37 +0,0 @@
-L4 interconnect bindings
-
-These bindings describe the OMAP SoCs L4 interconnect bus.
-
-Required properties:
-- compatible : Should be "ti,omap2-l4" for OMAP2 family l4 core bus
- Should be "ti,omap2-l4-wkup" for OMAP2 family l4 wkup bus
- Should be "ti,omap3-l4-core" for OMAP3 family l4 core bus
- Should be "ti,omap4-l4-cfg" for OMAP4 family l4 cfg bus
- Should be "ti,omap4-l4-per" for OMAP4 family l4 per bus
- Should be "ti,omap4-l4-wkup" for OMAP4 family l4 wkup bus
- Should be "ti,omap5-l4-cfg" for OMAP5 family l4 cfg bus
- Should be "ti,omap5-l4-wkup" for OMAP5 family l4 wkup bus
- Should be "ti,dra7-l4-cfg" for DRA7 family l4 cfg bus
- Should be "ti,dra7-l4-wkup" for DRA7 family l4 wkup bus
- Should be "ti,am3-l4-wkup" for AM33xx family l4 wkup bus
- Should be "ti,am4-l4-wkup" for AM43xx family l4 wkup bus
-- ranges : contains the IO map range for the bus
-- reg : registers link agent and interconnect agent and access protection
-- reg-names : "la" for link agent, "ia0" to "ia3" for one to three
- interconnect agent instances, "ap" for access if it exists
-
-Examples:
-
-l4: interconnect@48000000 {
- compatible "ti,omap4-l4-per", "simple-bus";
- reg = <0x48000000 0x800>,
- <0x48000800 0x800>,
- <0x48001000 0x400>,
- <0x48001400 0x400>,
- <0x48001800 0x400>,
- <0x48001c00 0x400>;
- reg-names = "ap", "la", "ia0", "ia1", "ia2", "ia3";
- #address-cells = <1>;
- #size-cells = <1>;
- ranges = <0 0x48000000 0x100000>;
-};
diff --git a/Documentation/devicetree/bindings/arm/omap/ti,omap-l4.yaml b/Documentation/devicetree/bindings/arm/omap/ti,omap-l4.yaml
new file mode 100644
index 000000000000..465d48f44730
--- /dev/null
+++ b/Documentation/devicetree/bindings/arm/omap/ti,omap-l4.yaml
@@ -0,0 +1,93 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/arm/omap/ti,omap-l4.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: TI OMAP SoCs L4 interconnect bus
+
+maintainers:
+ - Eduard Bostina <egbostina@gmail.com>
+
+description:
+ These bindings describe the OMAP SoCs L4 interconnect bus.
+
+select:
+ properties:
+ compatible:
+ contains:
+ enum:
+ - ti,omap2-l4
+ - ti,omap2-l4-wkup
+ - ti,omap3-l4-core
+ - ti,omap4-l4-cfg
+ - ti,omap4-l4-per
+ - ti,omap4-l4-wkup
+ - ti,omap5-l4-cfg
+ - ti,omap5-l4-wkup
+ - ti,dra7-l4-cfg
+ - ti,dra7-l4-wkup
+ - ti,am3-l4-wkup
+ - ti,am4-l4-wkup
+ required:
+ - compatible
+
+properties:
+ compatible:
+ items:
+ - enum:
+ - ti,omap2-l4
+ - ti,omap2-l4-wkup
+ - ti,omap3-l4-core
+ - ti,omap4-l4-cfg
+ - ti,omap4-l4-per
+ - ti,omap4-l4-wkup
+ - ti,omap5-l4-cfg
+ - ti,omap5-l4-wkup
+ - ti,dra7-l4-cfg
+ - ti,dra7-l4-wkup
+ - ti,am3-l4-wkup
+ - ti,am4-l4-wkup
+ - enum:
+ - simple-bus
+ - simple-pm-bus
+
+ reg:
+ minItems: 1
+ maxItems: 6
+
+ reg-names:
+ minItems: 1
+ maxItems: 6
+ items:
+ enum:
+ - ap
+ - la
+ - ia0
+ - ia1
+ - ia2
+ - ia3
+
+ ranges: true
+
+required:
+ - compatible
+ - ranges
+
+additionalProperties: true
+
+examples:
+ - |
+ l4: interconnect@48000000 {
+ compatible = "ti,omap4-l4-per", "simple-bus";
+ reg = <0x48000000 0x800>,
+ <0x48000800 0x800>,
+ <0x48001000 0x400>,
+ <0x48001400 0x400>,
+ <0x48001800 0x400>,
+ <0x48001c00 0x400>;
+ reg-names = "ap", "la", "ia0", "ia1", "ia2", "ia3";
+ #address-cells = <1>;
+ #size-cells = <1>;
+ ranges = <0 0x48000000 0x100000>;
+ };
--
2.43.0
On Wed, 22 Jul 2026 17:18:40 +0000, Eduard Bostina wrote: > Convert the Texas Instruments OMAP L4 interconnect bus bindings > to DT schema. > > During the conversion, several updates were made: > - Defined the compatible property as an array to require > the TI-specific string first, followed by either 'simple-bus' or > 'simple-pm-bus'. > - Added a 'select' block to ensure this schema is only > applied to TI-specific nodes, preventing duplicate > schema warnings against the core simple-pm-bus.yaml. > - Made 'reg' and 'reg-names' optional. > > Signed-off-by: Eduard Bostina <egbostina@gmail.com> > --- > .../devicetree/bindings/arm/omap/l4.txt | 37 -------- > .../bindings/arm/omap/ti,omap-l4.yaml | 93 +++++++++++++++++++ > 2 files changed, 93 insertions(+), 37 deletions(-) > delete mode 100644 Documentation/devicetree/bindings/arm/omap/l4.txt > create mode 100644 Documentation/devicetree/bindings/arm/omap/ti,omap-l4.yaml > My bot found errors running 'make dt_binding_check' on your patch: yamllint warnings/errors: dtschema/dtc warnings/errors: /builds/robherring/dt-review-ci/linux/Documentation/devicetree/bindings/arm/omap/ti,omap-l4.example.dtb: interconnect@48000000 (ti,omap4-l4-per): $nodename:0: 'interconnect@48000000' does not match '^([a-z][a-z0-9\\-]+-bus|bus|localbus|soc|axi|ahb|apb)(@.+)?$' from schema $id: http://devicetree.org/schemas/simple-bus.yaml doc reference errors (make refcheckdocs): See https://patchwork.kernel.org/project/devicetree/patch/20260722171840.299303-1-egbostina@gmail.com The base for the series is generally the latest rc1. A different dependency should be noted in *this* patch. If you already ran 'make dt_binding_check' and didn't see the above error(s), then make sure 'yamllint' is installed and dt-schema is up to date: pip3 install dtschema --upgrade Please check and re-submit after running the above command yourself. Note that DT_SCHEMA_FILES can be set to your schema file to speed up checking your schema. However, it must be unset to test all examples with your schema.
© 2016 - 2026 Red Hat, Inc.