scripts: dts: Simplify and improve 'compatible' matching

Instead of

    properties:
        compatible:
            constraint: "foo"

, just have

    compatible: "foo"

at the top level of the binding.

For backwards compatibility, the old 'properties: compatible: ...' form
is still accepted for now, and is treated the same as a single-element
'compatible:'.

The old syntax was inspired by dt-schema (though it isn't
dt-schema-compatible), which is in turn a thin wrapper around
json-schema (the idea is to transform .dts files into YAML and then
verify them).

Maybe the idea was to gradually switch the syntax over to dt-schema and
then be able to use unmodified dt-schema bindings, but dt-schema is
really a different kind of tool (a completely standalone linter), and
works very differently from our stuff (see schemas/dt-core.yaml in the
dt-schema repo to get an idea of just how differently).

Better to keep it simple.

This commit also piggybacks some clarifications to the binding template
re. '#cells:'.

Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>

doc/guides/dts/index.rst

@@ -414,6 +414,12 @@ the following node as an example:
 
 This node would get mapped to a binding with this in it:
 
+.. code-block:: yaml
+
+   compatible: "foo-company,bar-device"
+
+You might also run across this legacy syntax, which works the same way:
+
 .. code-block:: yaml
 
    ...

dts/binding-template.yaml

@@ -4,6 +4,29 @@ description: >
     Longer free-form description of the node.
     Can go over multiple lines.
 
+# Used to map nodes to bindings
+compatible: "manufacturer,device"
+
+# The 'compatible' above would match this node:
+#
+#     device {
+#         compatible = "manufacturer,device";
+#         ...
+#     };
+#
+# Assuming no binding has 'compatible: "manufacturer,device-v2"', it would also
+# match this node:
+#
+#     device {
+#         compatible = "manufacturer,device-v2", "manufacturer,device";
+#         ...
+#     };
+#
+# Strings in 'compatible' properties on nodes are tried from left to right, and
+# the first binding found is used.
+#
+# If more than one binding for a compatible is found, an error is raised.
+
 # Many bindings have common fields. These are stored in files given in
 # 'include', which are merged into the binding (with a recursive dictionary
 # merge).
@@ -99,11 +122,6 @@ sub-node:
 #   foo = <&label1 1 2>, <&label2 3 4>;         // Okay for 'type: phandle-array'
 #   etc.
 properties:
-    # An entry for 'compatible' must appear, as it's used to map nodes to
-    # bindings
-    compatible:
-        constraint: "foo-company,bar-device"
-
     # Describes a property like 'current-speed = <115200>;'. We pretend that
     # it's obligatory for the example node and set 'required: true'.
     current-speed:
@@ -137,20 +155,29 @@ properties:
         const: 1
 
 # If the binding describes an interrupt controller, GPIO controller, pinmux
-# device, or any other device referenced via a phandle plus a specifier (some
-# additional data besides the phandle), then the cells in the specifier must be
-# listed in '#cells', like below.
+# device, or any other node referenced by other nodes, then #cells should be
+# given.
 #
-# If the specifier is empty (e.g. '#clock-cells = <0>'), then '#cells' can
-# either be omitted (recommended) or set to an empty array. Note that an empty
-# array is specified as '"#cells": []' in YAML.
+# To understand the purpose of #cells, assume that some node has
 #
-# For example, say that some node has 'foo-gpios = <&gpio1 1 2>'. The <1 2>
-# part of the property value is the specifier, with two cells. The node pointed
-# at by &gpio1 is expected to have '#gpio-cells = <2>', and its binding should
-# have two elements in '#cells', corresponding to the 1 and 2 values above.
+#     foo-gpios = <&gpio-ctrl 1 2>;
+#
+# , where &gpio-ctrl refers to a node whose binding is this file.
+#
+# The <1 2> part of the property value is called a *specifier* (this
+# terminology is from the devicetree specification), and contains additional
+# data associated with the GPIO. Here, the specifier has two cells, and the
+# node pointed at by &gpio-ctrl is expected to have '#gpio-cells = <2>'.
+#
+# #cells gives a name to each cell in the specifier. These names are used
+# when generating identifiers.
+#
+# In this example, assume that 1 refers to a pin and that 2 is a flag value.
+# This gives a #cells assignment like below.
 "#cells":
-    - cell0    # name of first cell
-    - cell1    # name of second cell
-    - cell2    # name of third cell
-    - and so on and so forth
+    - pin  # name of first cell
+    - flag # name of second cell
+
+# If the specifier is empty (e.g. '#clock-cells = <0>'), then #cells can either
+# be omitted (recommended) or set to an empty array. Note that an empty array
+# is specified as '"#cells": []' in YAML.

dts/bindings/arc/arc,dccm.yaml

@@ -9,11 +9,10 @@ title: ARC DCCM
 description: >
     This binding gives a base representation of the ARC DCCM
 
+compatible: "arc,dccm"
+
 include: base.yaml
 
 properties:
-    compatible:
-      constraint: "arc,dccm"
-
     reg:
       required: true

dts/bindings/arc/arc,iccm.yaml

@@ -9,11 +9,10 @@ title: ARC ICCM
 description: >
     This binding gives a base representation of the ARC ICCM
 
+compatible: "arc,iccm"
+
 include: base.yaml
 
 properties:
-    compatible:
-      constraint: "arc,iccm"
-
     reg:
       required: true

dts/bindings/arm/arm,dtcm.yaml

@@ -4,11 +4,10 @@ title: DTCM
 description: >
   This binding gives a base representation of the Cortex M7 DTCM (Data Tightly Coupled Memory)
 
+compatible: "arm,dtcm"
+
 include: base.yaml
 
 properties:
-    compatible:
-      constraint: "arm,dtcm"
-
     reg:
       required: true

dts/bindings/arm/arm,scc.yaml

@@ -9,11 +9,10 @@ title: ARM Serial Configuration Control
 description: >
     This binding gives a base representation of the ARM SCC
 
+compatible: "arm,scc"
+
 include: base.yaml
 
 properties:
-    compatible:
-      constraint: "arm,scc"
-
     reg:
       required: true

dts/bindings/arm/atmel,sam0-device_id.yaml

@@ -3,11 +3,10 @@ title: Atmel Device ID (Serial Number) binding
 description: >
     Binding for locating the Device ID (serial number) on Atmel SAM0 devices.
 
+compatible: "atmel,sam0-id"
+
 include: base.yaml
 
 properties:
-    compatible:
-      constraint: "atmel,sam0-id"
-
     reg:
       required: true

dts/bindings/arm/atmel,sam0-dmac.yaml

@@ -3,12 +3,11 @@ title: Atmel DMAC binding
 description: >
     Binding for the Atmel SAM0 DMA controller.
 
+compatible: "atmel,sam0-dmac"
+
 include: base.yaml
 
 properties:
-    compatible:
-      constraint: "atmel,sam0-dmac"
-
     reg:
       required: true
 

dts/bindings/arm/atmel,sam0-sercom.yaml

@@ -3,12 +3,11 @@ title: Atmel SERCOM binding
 description: >
     Binding for the Atmel SAM0 multi-protocol (UART, SPI, I2C) SERCOM unit.
 
+compatible: "atmel,sam0-sercom"
+
 include: base.yaml
 
 properties:
-    compatible:
-      constraint: "atmel,sam0-sercom"
-
     reg:
       required: true
 

dts/bindings/arm/nordic,nrf-dppic.yaml

@@ -10,11 +10,10 @@ description: >
     Binding for the Nordic DPPIC
     Distributed Programmable Peripheral Interconnect Controller
 
+compatible: "nordic,nrf-dppic"
+
 include: base.yaml
 
 properties:
-    compatible:
-      constraint: "nordic,nrf-dppic"
-
     reg:
       required: true

dts/bindings/arm/nordic,nrf-ficr.yaml

@@ -3,11 +3,10 @@ title: Nordic FICR (Factory Information Configuration Registers)
 description: >
     Binding for the Nordic FICR (Factory Information Configuration Registers)
 
+compatible: "nordic,nrf-ficr"
+
 include: base.yaml
 
 properties:
-    compatible:
-      constraint: "nordic,nrf-ficr"
-
     reg:
       required: true

dts/bindings/arm/nordic,nrf-spu.yaml

@@ -3,12 +3,11 @@ title: Nordic SPU (System Protection Unit)
 description: >
     Binding for the Nordic SPU (System Protection Unit)
 
+compatible: "nordic,nrf-spu"
+
 include: base.yaml
 
 properties:
-    compatible:
-      constraint: "nordic,nrf-spu"
-
     reg:
       required: true
 

dts/bindings/arm/nordic,nrf-uicr.yaml

@@ -3,11 +3,10 @@ title: Nordic UICR (User Information Configuration Registers)
 description: >
     Binding for the Nordic UICR (User Information Configuration Registers)
 
+compatible: "nordic,nrf-uicr"
+
 include: base.yaml
 
 properties:
-    compatible:
-      constraint: "nordic,nrf-uicr"
-
     reg:
       required: true

dts/bindings/arm/nxp,imx-dtcm.yaml

@@ -9,11 +9,10 @@ title: i.MX DTCM (Data Tightly Coupled Memory)
 description: >
   This binding gives a base representation of the i.MX DTCM
 
+compatible: "nxp,imx-dtcm"
+
 include: base.yaml
 
 properties:
-    compatible:
-      constraint: "nxp,imx-dtcm"
-
     reg:
       required: true

dts/bindings/arm/nxp,imx-epit.yaml

@@ -9,12 +9,11 @@ title: IMX EPIT COUNTER
 description: >
     This binding gives a base representation of the i.MX Enhanced Periodic Interrupt Timer (EPIT)
 
+compatible: "nxp,imx-epit"
+
 include: base.yaml
 
 properties:
-  compatible:
-      constraint: "nxp,imx-epit"
-
   reg:
       required: true
 

dts/bindings/arm/nxp,imx-itcm.yaml

@@ -9,11 +9,10 @@ title: i.MX ITCM (Instruction Tightly Coupled Memory)
 description: >
   This binding gives a base representation of the i.MX ITCM
 
+compatible: "nxp,imx-itcm"
+
 include: base.yaml
 
 properties:
-    compatible:
-      constraint: "nxp,imx-itcm"
-
     reg:
       required: true

dts/bindings/arm/nxp,imx-mu.yaml

@@ -9,12 +9,11 @@ title: IMX MESSAGING UNIT
 description: >
     This binding gives a base representation of the i.MX Messaging Unit
 
+compatible: "nxp,imx-mu"
+
 include: base.yaml
 
 properties:
-  compatible:
-      constraint: "nxp,imx-mu"
-
   reg:
       required: true
 

dts/bindings/arm/nxp,kinetis-mcg.yaml

@@ -9,12 +9,11 @@ title: NXP Kinetis Multipurpose Clock Generator (MCG)
 description: >
     This is a representation of the NXP Kinetis MCG IP node
 
+compatible: "nxp,kinetis-mcg"
+
 include: [clock-controller.yaml, base.yaml]
 
 properties:
-    compatible:
-      constraint: "nxp,kinetis-mcg"
-
     reg:
       required: true
 

dts/bindings/arm/nxp,kinetis-pcc.yaml

@@ -9,12 +9,11 @@ title: NXP Kinetis PCC (Peripheral Clock Controller)
 description: >
     This is a representation of the NXP Kinetis PCC IP node
 
+compatible: "nxp,kinetis-pcc"
+
 include: [clock-controller.yaml, base.yaml]
 
 properties:
-    compatible:
-      constraint: "nxp,kinetis-pcc"
-
     reg:
       required: true
 

dts/bindings/arm/nxp,kinetis-scg.yaml

@@ -9,12 +9,11 @@ title: NXP Kinetis SCG (System Clock Generator)
 description: >
     This is a representation of the NXP Kinetis SCG IP node
 
+compatible: "nxp,kinetis-scg"
+
 include: [clock-controller.yaml, base.yaml]
 
 properties:
-    compatible:
-      constraint: "nxp,kinetis-scg"
-
     reg:
       required: true
 

dts/bindings/arm/nxp,kinetis-sim.yaml

@@ -9,12 +9,11 @@ title: Kinetis System Integration Module (SIM)
 description: >
     This is a representation of the Kinetis SIM IP node
 
+compatible: "nxp,kinetis-sim"
+
 include: base.yaml
 
 properties:
-    compatible:
-      constraint: "nxp,kinetis-sim"
-
     reg:
       required: true
 

dts/bindings/arm/nxp,lpc-mailbox.yaml

@@ -9,12 +9,11 @@ title: LPC MAILBOX
 description: >
     This binding gives a base representation of the LPC MAILBOX
 
+compatible: "nxp,lpc-mailbox"
+
 include: base.yaml
 
 properties:
-  compatible:
-      constraint: "nxp,lpc-mailbox"
-
   reg:
       required: true
 

dts/bindings/arm/st,stm32-ccm.yaml

@@ -4,11 +4,10 @@ title: STM32 CCM
 description: >
   This binding gives a base representation of the STM32 CCM (Core Coupled Memory)
 
+compatible: "st,stm32-ccm"
+
 include: base.yaml
 
 properties:
-    compatible:
-      constraint: "st,stm32-ccm"
-
     reg:
       required: true

dts/bindings/arm/ti,cc2650-prcm.yaml

@@ -5,11 +5,10 @@ description: >
     This binding gives a base representation of the TI CC2650
     Power, Reset, and Clock control Module.
 
+compatible: "ti,cc2650-prcm"
+
 include: base.yaml
 
 properties:
-    compatible:
-      constraint: "ti,cc2650-prcm"
-
     reg:
       required: true

dts/bindings/audio/st,mpxxdtyy-i2s.yaml

@@ -9,10 +9,10 @@ title: ST Microelectronics MPXXDTYY digital pdm microphone family
 description: >
     This binding gives a base representation of MPXXDTYY digital microphone family
 
+compatible: "st,mpxxdtyy"
+
 include: i2s-device.yaml
 
 properties:
-    compatible:
-      constraint: "st,mpxxdtyy"
     label:
       required: true

dts/bindings/audio/ti,tlv320dac.yaml

@@ -9,12 +9,11 @@ title: Texas Instruments TLV320DAC Audio DAC
 description: >
     This binding gives a base representation of TLV320DAC310x Audio DAC
 
+compatible: "ti,tlv320dac"
+
 include: i2c-device.yaml
 
 properties:
-    compatible:
-      constraint: "ti,tlv320dac"
-
     reset-gpios:
       type: phandle-array
       required: true

dts/bindings/bluetooth/zephyr,bt-hci-spi-slave.yaml

@@ -10,15 +10,14 @@ description: >
     This binding gives the base representation of a bluetooth controller node
     that provides HCI over SPI.
 
+compatible: "zephyr,bt-hci-spi-slave"
+
 include: base.yaml
 
 parent:
     bus: spi
 
 properties:
-    compatible:
-      constraint: "zephyr,bt-hci-spi-slave"
-
     irq-gpios:
       type: phandle-array
       required: true

dts/bindings/bluetooth/zephyr,bt-hci-spi.yaml

@@ -10,12 +10,11 @@ description: >
     This binding gives the base representation of a bluetooth module which use
     Zephyr's bluetooth Host Controller Interface SPI driver (e.g. nRF51822).
 
+compatible: "zephyr,bt-hci-spi"
+
 include: spi-device.yaml
 
 properties:
-    compatible:
-      constraint: "zephyr,bt-hci-spi"
-
     irq-gpios:
       type: phandle-array
       required: true

dts/bindings/can/can-device.yaml

@@ -4,10 +4,7 @@
 # SPDX-License-Identifier: Apache-2.0
 #
 
-title: CAN Device Base Structure
-
-description: >
-    This binding gives the base structures for all can devices
+# Common fields for CAN devices
 
 include: base.yaml
 

dts/bindings/can/microchip,mcp2515.yaml

@@ -9,11 +9,11 @@ title: MCP2515 CAN
 description: >
     This binding gives a base representation of the MCP2515 SPI CAN controller
 
+compatible: "microchip,mcp2515"
+
 include: [spi-device.yaml, can-controller.yaml]
 
 properties:
-    compatible:
-      constraint: "microchip,mcp2515"
     int-gpios:
       type: phandle-array
       required: true

dts/bindings/can/nxp,kinetis-flexcan.yaml

@@ -9,12 +9,11 @@ title: NXP FlexCAN
 description: >
     This binding gives a base representation of the NXP FlexCAN controller
 
+compatible: "nxp,kinetis-flexcan"
+
 include: can-controller.yaml
 
 properties:
-    compatible:
-      constraint: "nxp,kinetis-flexcan"
-
     reg:
       required: true
 

dts/bindings/can/st,stm32-can.yaml

@@ -3,12 +3,11 @@ title: STM32 CAN
 description: >
     This binding gives a base representation of the STM32 CAN controller
 
+compatible: "st,stm32-can"
+
 include: can-controller.yaml
 
 properties:
-    compatible:
-      constraint: "st,stm32-can"
-
     reg:
       required: true
 

dts/bindings/clock/fixed-clock.yaml

@@ -9,15 +9,11 @@ title: Generic fixed rate clock provider
 description: >
     This is a representation of a generic fixed rate clock provider.
 
+compatible: "fixed-clock"
+
 include: clock-controller.yaml
 
 properties:
-    compatible:
-      type: string
-      required: true
-      description: compatible strings
-      constraint: "fixed-clock"
-
     label:
       type: string
       required: false

dts/bindings/clock/nordic,nrf-clock.yaml

@@ -9,12 +9,11 @@ title: Nordic nRF clock control
 description: >
     This is a representation of the Nordic nRF clock control node
 
+compatible: "nordic,nrf-clock"
+
 include: base.yaml
 
 properties:
-    compatible:
-      constraint: "nordic,nrf-clock"
-
     label:
       required: true
 

dts/bindings/clock/nxp,imx-ccm.yaml

@@ -9,12 +9,11 @@ title: i.MX Clock Controller Module (CCM)
 description: >
     This is a representation of the i.MX CCM IP node
 
+compatible: "nxp,imx-ccm"
+
 include: [clock-controller.yaml, base.yaml]
 
 properties:
-    compatible:
-      constraint: "nxp,imx-ccm"
-
     reg:
       required: true
 

dts/bindings/clock/st,stm32-rcc.yaml

@@ -3,12 +3,11 @@ title: STM32 RCC
 description: >
     This binding gives a base representation of the STM32 Clock control
 
+compatible: "st,stm32-rcc"
+
 include: [clock-controller.yaml, base.yaml]
 
 properties:
-    compatible:
-      constraint: "st,stm32-rcc"
-
     reg:
       required: true
 

dts/bindings/cpu/arm,cortex-m0+.yaml

@@ -9,8 +9,6 @@ title: ARM Cortex-M0+ CPU
 description: >
     This binding gives a base representation for ARM Cortex-M0+ CPU.
 
-include: cpu.yaml
+compatible: "arm,cortex-m0+"
 
-properties:
-    compatible:
-      constraint: "arm,cortex-m0+"
+include: cpu.yaml

dts/bindings/cpu/arm,cortex-m0.yaml

@@ -9,8 +9,6 @@ title: ARM Cortex-M0 CPU
 description: >
     This binding gives a base representation for ARM Cortex-M0 CPU.
 
-include: cpu.yaml
+compatible: "arm,cortex-m0"
 
-properties:
-    compatible:
-      constraint: "arm,cortex-m0"
+include: cpu.yaml

dts/bindings/cpu/arm,cortex-m23.yaml

@@ -9,8 +9,6 @@ title: ARM Cortex-M23 CPU
 description: >
     This binding gives a base representation for ARM Cortex-M23 CPU.
 
-include: cpu.yaml
+compatible: "arm,cortex-m23"
 
-properties:
-    compatible:
-      constraint: "arm,cortex-m23"
+include: cpu.yaml

dts/bindings/cpu/arm,cortex-m3.yaml

@@ -9,8 +9,6 @@ title: ARM Cortex-M3 CPU
 description: >
     This binding gives a base representation for ARM Cortex-M3 CPU.
 
-include: cpu.yaml
+compatible: "arm,cortex-m3"
 
-properties:
-    compatible:
-      constraint: "arm,cortex-m3"
+include: cpu.yaml

dts/bindings/cpu/arm,cortex-m33.yaml

@@ -9,8 +9,6 @@ title: ARM Cortex-M33 CPU
 description: >
     This binding gives a base representation for ARM Cortex-M33 CPU.
 
-include: cpu.yaml
+compatible: "arm,cortex-m33"
 
-properties:
-    compatible:
-      constraint: "arm,cortex-m33"
+include: cpu.yaml

dts/bindings/cpu/arm,cortex-m4.yaml

@@ -9,8 +9,6 @@ title: ARM Cortex-M4 CPU
 description: >
     This binding gives a base representation for ARM Cortex-M4 CPU.
 
-include: cpu.yaml
+compatible: "arm,cortex-m4"
 
-properties:
-    compatible:
-      constraint: "arm,cortex-m4"
+include: cpu.yaml

dts/bindings/cpu/arm,cortex-m4f.yaml

@@ -9,8 +9,6 @@ title: ARM Cortex-M4F CPU
 description: >
     This binding gives a base representation for ARM Cortex-M4F CPU.
 
-include: cpu.yaml
+compatible: "arm,cortex-m4f"
 
-properties:
-    compatible:
-      constraint: "arm,cortex-m4f"
+include: cpu.yaml

dts/bindings/cpu/arm,cortex-m7.yaml

@@ -9,8 +9,6 @@ title: ARM Cortex-M7 CPU
 description: >
     This binding gives a base representation for ARM Cortex-M7 CPU.
 
-include: cpu.yaml
+compatible: "arm,cortex-m7"
 
-properties:
-    compatible:
-      constraint: "arm,cortex-m7"
+include: cpu.yaml

dts/bindings/cpu/cadence,tensilica-xtensa-lx6.yaml

@@ -9,8 +9,6 @@ title: Cadence Tensilica Xtensa LX6 CPU
 description: >
     This binding gives a base representation for Cadence Tensilica Xtensa LX6 CPU.
 
-include: cpu.yaml
+compatible: "cadence,tensilica-xtensa-lx6"
 
-properties:
-    compatible:
-      constraint: "cadence,tensilica-xtensa-lx6"
+include: cpu.yaml

dts/bindings/cpu/sample_controller.yaml

@@ -9,8 +9,6 @@ title: Sample Controller CPU
 description: >
     This binding gives a base representation for Sample Controller CPU.
 
-include: cpu.yaml
+compatible: "sample_controller"
 
-properties:
-    compatible:
-      constraint: "sample_controller"
+include: cpu.yaml

dts/bindings/cpu/snps,arcem.yaml

@@ -9,8 +9,6 @@ title: Synopsys ARC EM CPU
 description: >
     This binding gives a base representation for Synopsys ARC EM CPU.
 
-include: cpu.yaml
+compatible: "snps,arcem"
 
-properties:
-    compatible:
-      constraint: "snps,arcem"
+include: cpu.yaml

dts/bindings/crypto/arm,cryptocell-310.yaml

@@ -9,12 +9,11 @@ title: ARM TrustZone CryptoCell 310
 description: >
     This is a representation of the ARM TrustZone CryptoCell 310
 
+compatible: "arm,cryptocell-310"
+
 include: base.yaml
 
 properties:
-    compatible:
-      constraint: "arm,cryptocell-310"
-
     reg:
       required: true
 

dts/bindings/crypto/nordic,nrf-cc310.yaml

@@ -9,12 +9,11 @@ title: Nordic Control Interface for ARM TrustZone CryptoCell 310
 description: >
     This is a representation of the Nordic Control Interface for ARM TrustZone CryptoCell 310
 
+compatible: "nordic,nrf-cc310"
+
 include: base.yaml
 
 properties:
-    compatible:
-      constraint: "nordic,nrf-cc310"
-
     reg:
       required: true
 

dts/bindings/display/fsl,imx6sx-lcdif.yaml

@@ -9,12 +9,11 @@ title: NXP Enhanced LCD Interface (eLCDIF) controller
 description: >
     This binding gives a base representation of the NXP i.MX eLCDIF controller
 
+compatible: "fsl,imx6sx-lcdif"
+
 include: base.yaml
 
 properties:
-    compatible:
-      constraint: "fsl,imx6sx-lcdif"
-
     reg:
       required: true
 

dts/bindings/display/ilitek,ili9340.yaml

@@ -9,12 +9,11 @@ title: ILI9340 320x240 Display Controller
 description: >
     This is a representation of the ILI9340 320x240 Display Controller
 
+compatible: "ilitek,ili9340"
+
 include: spi-device.yaml
 
 properties:
-    compatible:
-      constraint: "ilitek,ili9340"
-
     reset-gpios:
       type: phandle-array
       required: false

dts/bindings/display/rocktech,rk043fn02h-ct.yaml

@@ -10,8 +10,6 @@ description: >
     This binding gives a base representation of the Rocktech LCD module with
     LED backlight and capacitive touch panel.
 
-include: base.yaml
+compatible: "rocktech,rk043fn02h-ct"
 
-properties:
-    compatible:
-      constraint: "rocktech,rk043fn02h-ct"
+include: base.yaml

dts/bindings/display/sitronix,st7789v.yaml

@@ -9,12 +9,11 @@ title: ST7789V 320x240 Display Controller
 description: >
     This is a representation of the ST7789V 320x240 Display Controller
 
+compatible: "sitronix,st7789v"
+
 include: spi-device.yaml
 
 properties:
-    compatible:
-      constraint: "sitronix,st7789v"
-
     reset-gpios:
       type: phandle-array
       required: true

dts/bindings/display/solomon,ssd1306fb.yaml

@@ -9,12 +9,11 @@ title: SSD1306 128x64 Dot Matrix Display Controller
 description: >
     This is a representation of the SSD1306 128x64 Dot Matrix Display Controller
 
+compatible: "solomon,ssd1306fb"
+
 include: i2c-device.yaml
 
 properties:
-    compatible:
-      constraint: "solomon,ssd1306fb"
-
     height:
       type: int
       required: true

dts/bindings/display/solomon,ssd1673fb.yaml

@@ -9,12 +9,11 @@ title: SSD16XX 250x150 EPD Display Controller
 description: >
     This is a representation of the SSD16XX 250x150 EPD Display Controller
 
+compatible: "solomon,ssd16xxfb"
+
 include: spi-device.yaml
 
 properties:
-    compatible:
-      constraint: "solomon,ssd16xxfb"
-
     height:
       type: int
       required: true

dts/bindings/espi/microchip,xec-espi.yaml

@@ -7,12 +7,11 @@ title: MICROCHIP ESPI
 description: >
     This binding gives a base representation of ESPI controller for Microchip
 
+compatible: "microchip,xec-espi"
+
 include: espi-controller.yaml
 
 properties:
-    compatible:
-      constraint: "microchip,xec-espi"
-
     reg:
       description: mmio register space
       required: true

dts/bindings/ethernet/intel,e1000.yaml

@@ -8,12 +8,11 @@ title: Intel E1000 Ethernet controller
 description: >
      This is a representation of the Intel E1000 Ethernet controller
 
+compatible: "intel,e1000"
+
 include: base.yaml
 
 properties:
-    compatible:
-      constraint: "intel,e1000"
-
     reg:
       required: true
 

dts/bindings/ethernet/litex,eth0.yaml

@@ -9,12 +9,11 @@ title: LiteX Ethernet
 description: >
     This binding gives a base representation of LiteX Ethernet
 
+compatible: "litex,eth0"
+
 include: ethernet.yaml
 
 properties:
-    compatible:
-        constraint: "litex,eth0"
-
     reg:
         required: true
 

dts/bindings/ethernet/microchip,enc28j60.yaml

@@ -8,11 +8,12 @@ title: 10Base-T Ethernet Controller with SPI Interface
 
 description: >
     This binding gives a base representation of the standalone ENC28J60 chip
+
+compatible: "microchip,enc28j60"
+
 include: [spi-device.yaml, ethernet.yaml]
 
 properties:
-    compatible:
-      constraint: "microchip,enc28j60"
     int-gpios:
       type: phandle-array
       required: true

dts/bindings/ethernet/nxp,kinetis-ethernet.yaml

@@ -8,11 +8,12 @@ title: NXP Kinetis Ethernet
 
 description: >
     This binding gives a base representation of the NXP Kinetis Ethernet
+
+compatible: "nxp,kinetis-ethernet"
+
 include: ethernet.yaml
 
 properties:
-    compatible:
-      constraint: "nxp,kinetis-ethernet"
     reg:
       required: true
     interrupts:

dts/bindings/ethernet/nxp.kinetis-ptp.yaml

@@ -9,10 +9,10 @@ title: NXP Kinetis Ethernet PTP
 description: >
     This binding gives a base representation of the NXP Kinetis Ethernet PTP
 
+compatible: "nxp,kinetis-ptp"
+
 include: base.yaml
 
 properties:
-    compatible:
-      constraint: "nxp,kinetis-ptp"
     interrupts:
       required: true

dts/bindings/ethernet/smsc,lan9220.yaml

@@ -9,12 +9,11 @@ description: >
      This is a representation of the formerly SMSC, now Microchip, LAN9220
      Ethernet controller.
 
+compatible: "smsc,lan9220"
+
 include: base.yaml
 
 properties:
-    compatible:
-      constraint: "smsc,lan9220"
-
     reg:
       required: true
 

dts/bindings/ethernet/ti,stellaris-ethernet.yaml

@@ -8,11 +8,11 @@ title: TI Stellaris Ethernet
 description: >
     This binding gives a base representation of the TI Stellaris Ethernet
 
+compatible: "ti,stellaris-ethernet"
+
 include: ethernet.yaml
 
 properties:
-    compatible:
-      constraint: "ti,stellaris-ethernet"
     reg:
       required: true
     interrupts:

dts/bindings/flash_controller/atmel,sam-flash-controller.yaml

@@ -9,12 +9,11 @@ title: Atmel SAM Flash Controller
 description: >
     This binding gives a base representation of the Atmel SAM Enhanced Embedded Flash Controller
 
+compatible: "atmel,sam-flash-controller"
+
 include: flash-controller.yaml
 
 properties:
-    compatible:
-      constraint: "atmel,sam-flash-controller"
-
     peripheral-id:
       type: int
       description: peripheral ID

dts/bindings/flash_controller/atmel,sam0-nvmctrl.yaml

@@ -3,8 +3,6 @@ title: Atmel SAM0 Non-Volatile Memory Controller
 description: >
     This binding gives a base representation of the Atmel SAM0 NVMC
 
-include: flash-controller.yaml
+compatible: "atmel,sam0-nvmctrl"
 
-properties:
-    compatible:
-      constraint: "atmel,sam0-nvmctrl"
+include: flash-controller.yaml

dts/bindings/flash_controller/cypress,psoc6-flash-controller.yaml

@@ -9,8 +9,6 @@ title: Cypress Flash Controller
 description: >
     This binding gives a base representation of the Cypress Flash Controller
 
-include: flash-controller.yaml
+compatible: "cypress,psoc6-flash-controller"
 
-properties:
-    compatible:
-      constraint: "cypress,psoc6-flash-controller"
+include: flash-controller.yaml

dts/bindings/flash_controller/nordic,nrf51-flash-controller.yaml

@@ -3,8 +3,6 @@ title: Nordic NVMC
 description: >
     This binding gives a base representation of the Nordic NVMC
 
-include: flash-controller.yaml
+compatible: "nordic,nrf51-flash-controller"
 
-properties:
-    compatible:
-      constraint: "nordic,nrf51-flash-controller"
+include: flash-controller.yaml

dts/bindings/flash_controller/nordic,nrf52-flash-controller.yaml

@@ -3,8 +3,6 @@ title: Nordic NVMC
 description: >
     This binding gives a base representation of the Nordic NVMC
 
-include: flash-controller.yaml
+compatible: "nordic,nrf52-flash-controller"
 
-properties:
-    compatible:
-      constraint: "nordic,nrf52-flash-controller"
+include: flash-controller.yaml

dts/bindings/flash_controller/nordic,nrf91-flash-controller.yaml

@@ -3,8 +3,6 @@ title: Nordic NVMC
 description: >
     This binding gives a base representation of the Nordic NVMC
 
-include: flash-controller.yaml
+compatible: "nordic,nrf91-flash-controller"
 
-properties:
-    compatible:
-      constraint: "nordic,nrf91-flash-controller"
+include: flash-controller.yaml

dts/bindings/flash_controller/nxp,kinetis-ftfa.yaml

@@ -3,8 +3,6 @@ title: NXP Kinetis Flash Memory Module (FTFA)
 description: >
     This binding gives for the NXP Kinetis Flash Memory Module A (FTFA)
 
-include: flash-controller.yaml
+compatible: "nxp,kinetis-ftfa"
 
-properties:
-    compatible:
-      constraint: "nxp,kinetis-ftfa"
+include: flash-controller.yaml

dts/bindings/flash_controller/nxp,kinetis-ftfe.yaml

@@ -3,8 +3,6 @@ title: NXP Kinetis Flash Memory Module (FTFE)
 description: >
     This binding gives for the NXP Kinetis Flash Memory Module E (FTFE)
 
-include: flash-controller.yaml
+compatible: "nxp,kinetis-ftfe"
 
-properties:
-    compatible:
-      constraint: "nxp,kinetis-ftfe"
+include: flash-controller.yaml

dts/bindings/flash_controller/nxp,kinetis-ftfl.yaml

@@ -3,8 +3,6 @@ title: NXP Kinetis Flash Memory Module (FTFL)
 description: >
     This binding gives for the NXP Kinetis Flash Memory Module L (FTFL)
 
-include: flash-controller.yaml
+compatible: "nxp,kinetis-ftfl"
 
-properties:
-    compatible:
-      constraint: "nxp,kinetis-ftfl"
+include: flash-controller.yaml

dts/bindings/flash_controller/openisa,rv32m1-ftfe.yaml

@@ -3,8 +3,6 @@ title: OpenISA Flash Memory Module (FTFE)
 description: >
     This binding gives for the OpenISA Flash Memory Module E (FTFE)
 
-include: flash-controller.yaml
+compatible: "openisa,rv32m1-ftfe"
 
-properties:
-    compatible:
-      constraint: "openisa,rv32m1-ftfe"
+include: flash-controller.yaml

dts/bindings/flash_controller/silabs,gecko-flash-controller.yaml

@@ -9,8 +9,6 @@ title: Silicon Labs Gecko Flash Controller
 description: >
     This binding gives a base representation of the Silicon Labs Gecko Flash Controller
 
-include: flash-controller.yaml
+compatible: "silabs,gecko-flash-controller"
 
-properties:
-    compatible:
-      constraint: "silabs,gecko-flash-controller"
+include: flash-controller.yaml

dts/bindings/flash_controller/st,stm32f0-flash-controller.yaml

@@ -3,8 +3,6 @@ title: STM32 F0 Flash Controller
 description: >
     This binding gives a base representation of the STM32 F0 Flash Controller
 
-include: flash-controller.yaml
+compatible: "st,stm32f0-flash-controller"
 
-properties:
-    compatible:
-      constraint: "st,stm32f0-flash-controller"
+include: flash-controller.yaml

dts/bindings/flash_controller/st,stm32f2-flash-controller.yaml

@@ -3,8 +3,6 @@ title: STM32 F2 Flash Controller
 description: >
     This binding gives a base representation of the STM32 F2 Flash Controller
 
-include: flash-controller.yaml
+compatible: "st,stm32f2-flash-controller"
 
-properties:
-    compatible:
-      constraint: "st,stm32f2-flash-controller"
+include: flash-controller.yaml

dts/bindings/flash_controller/st,stm32f3-flash-controller.yaml

@@ -3,8 +3,6 @@ title: STM32 F3 Flash Controller
 description: >
     This binding gives a base representation of the STM32 F3 Flash Controller
 
-include: flash-controller.yaml
+compatible: "st,stm32f3-flash-controller"
 
-properties:
-    compatible:
-      constraint: "st,stm32f3-flash-controller"
+include: flash-controller.yaml

dts/bindings/flash_controller/st,stm32f4-flash-controller.yaml

@@ -3,8 +3,6 @@ title: STM32 F4 Flash Controller
 description: >
     This binding gives a base representation of the STM32 F4 Flash Controller
 
-include: flash-controller.yaml
+compatible: "st,stm32f4-flash-controller"
 
-properties:
-    compatible:
-      constraint: "st,stm32f4-flash-controller"
+include: flash-controller.yaml

dts/bindings/flash_controller/st,stm32f7-flash-controller.yaml

@@ -3,8 +3,6 @@ title: STM32 F7 Flash Controller
 description: >
     This binding gives a base representation of the STM32 F7 Flash Controller
 
-include: flash-controller.yaml
+compatible: "st,stm32f7-flash-controller"
 
-properties:
-    compatible:
-      constraint: "st,stm32f7-flash-controller"
+include: flash-controller.yaml

dts/bindings/flash_controller/st,stm32g0-flash-controller.yaml

@@ -3,8 +3,6 @@ title: STM32 G0 Flash Controller
 description: >
     This binding gives a base representation of the STM32 G0 Flash Controller
 
-include: flash-controller.yaml
+compatible: "st,stm32g0-flash-controller"
 
-properties:
-    compatible:
-      constraint: "st,stm32g0-flash-controller"
+include: flash-controller.yaml

dts/bindings/flash_controller/st,stm32h7-flash-controller.yaml

@@ -3,8 +3,6 @@ title: STM32 H7 Flash Controller
 description: >
     This binding gives a base representation of the STM32 H7 Flash Controller
 
-include: flash-controller.yaml
+compatible: "st,stm32h7-flash-controller"
 
-properties:
-    compatible:
-      constraint: "st,stm32h7-flash-controller"
+include: flash-controller.yaml

dts/bindings/flash_controller/st,stm32l1-flash-controller.yaml

@@ -3,8 +3,6 @@ title: STM32 L1 Flash Controller
 description: >
     This binding gives a base representation of the STM32 L1 Flash Controller
 
-include: flash-controller.yaml
+compatible: "st,stm32l1-flash-controller"
 
-properties:
-    compatible:
-      constraint: "st,stm32l1-flash-controller"
+include: flash-controller.yaml

dts/bindings/flash_controller/st,stm32l4-flash-controller.yaml

@@ -3,8 +3,6 @@ title: STM32 L4 Flash Controller
 description: >
     This binding gives a base representation of the STM32 L4 Flash Controller
 
-include: flash-controller.yaml
+compatible: "st,stm32l4-flash-controller"
 
-properties:
-    compatible:
-      constraint: "st,stm32l4-flash-controller"
+include: flash-controller.yaml

dts/bindings/flash_controller/st,stm32wb-flash-controller.yaml

@@ -3,12 +3,11 @@ title: STM32 WB Flash Controller
 description: >
     This binding gives a base representation of the STM32 wb Flash Controller
 
+compatible: "st,stm32wb-flash-controller"
+
 include: flash-controller.yaml
 
 properties:
-    compatible:
-      constraint: "st,stm32wb-flash-controller"
-
     single-bank:
       type: boolean
       description: dual-bank mode not enabled (page erase 4096k)

dts/bindings/flash_controller/zephyr,native-posix-flash-controller.yaml

@@ -4,8 +4,6 @@ description: >
     This binding gives a base representation of the Native POSIX flash
     controller
 
-include: flash-controller.yaml
+compatible: "zephyr,native-posix-flash-controller"
 
-properties:
-    compatible:
-      constraint: "zephyr,native-posix-flash-controller"
+include: flash-controller.yaml

dts/bindings/flash_controller/zephyr,sim-flash.yaml

@@ -5,11 +5,10 @@ title: simulated flash
 description: >
     This binding gives a base representation of a simulated flash memory
 
+compatible: "zephyr,sim-flash"
+
 include: base.yaml
 
 properties:
-    compatible:
-      constraint: "zephyr,sim-flash"
-
     label:
       required: true

dts/bindings/gpio/arduino-header-r3.yaml

@@ -9,8 +9,6 @@ title: ARDUINO GPIO HEADER
 description: >
     This is a representation of GPIO pin nodes exposed as headers on Arduino R3
 
-include: [gpio-nexus.yaml, base.yaml]
+compatible: "arduino-header-r3"
 
-properties:
-    compatible:
-      constraint: "arduino-header-r3"
+include: [gpio-nexus.yaml, base.yaml]

dts/bindings/gpio/arm,cmsdk-gpio.yaml

@@ -3,12 +3,11 @@ title: ARM CMSDK GPIO
 description: >
     This binding gives a base representation of the ARM CMSDK GPIO
 
+compatible: "arm,cmsdk-gpio"
+
 include: [gpio-controller.yaml, base.yaml]
 
 properties:
-    compatible:
-      constraint: "arm,cmsdk-gpio"
-
     reg:
       required: true
 

dts/bindings/gpio/atmel,sam-gpio.yaml

@@ -3,12 +3,11 @@ title: Atmel SAM GPIO PORT driver
 description: >
     This is a representation of the SAM GPIO PORT nodes
 
+compatible: "atmel,sam-gpio"
+
 include: [gpio-controller.yaml, base.yaml]
 
 properties:
-    compatible:
-      constraint: "atmel,sam-gpio"
-
     reg:
       required: true
 

dts/bindings/gpio/atmel,sam0-gpio.yaml

@@ -3,12 +3,11 @@ title: Atmel SAM0 GPIO PORT driver
 description: >
     This is a representation of the SAM0 GPIO PORT nodes
 
+compatible: "atmel,sam0-gpio"
+
 include: [gpio-controller.yaml, base.yaml]
 
 properties:
-    compatible:
-      constraint: "atmel,sam0-gpio"
-
     reg:
       required: true
 

dts/bindings/gpio/gpio-keys.yaml

@@ -9,12 +9,7 @@ title: GPIO KEYS
 description: >
     This is a representation of the GPIO KEYS nodes
 
-properties:
-    compatible:
-      constraint: "gpio-keys"
-      type: string-array
-      required: true
-      description: compatible strings
+compatible: "gpio-keys"
 
 sub-node:
     properties:

dts/bindings/gpio/gpio-leds.yaml

@@ -9,12 +9,7 @@ title: GPIO LED
 description: >
     This is a representation of the LED GPIO nodes
 
-properties:
-    compatible:
-      constraint: "gpio-leds"
-      type: string-array
-      required: true
-      description: compatible strings
+compatible: "gpio-leds"
 
 sub-node:
     properties:

dts/bindings/gpio/holtek,ht16k33-keyscan.yaml

@@ -2,14 +2,14 @@ title: Holtek HT16K33 LED Driver With Keyscan
 
 description: Holtek HT16K33 Keyscan binding
 
+compatible: "holtek,ht16k33-keyscan"
+
 include: base.yaml
 
 parent:
     bus: ht16k33
 
 properties:
-    compatible:
-      constraint: "holtek,ht16k33-keyscan"
     reg:
       required: true
     label:

dts/bindings/gpio/intel,apl-gpio.yaml

@@ -9,12 +9,11 @@ title: Intel Apollo Lake GPIO controller
 description: >
     This is a representation of the Intel Apollo Lake GPIO node
 
+compatible: "intel,apl-gpio"
+
 include: [gpio-controller.yaml, base.yaml]
 
 properties:
-    compatible:
-      constraint: "intel,apl-gpio"
-
     reg:
       required: true
 

dts/bindings/gpio/intel,qmsi-gpio.yaml

@@ -9,12 +9,11 @@ title: Intel QMSI GPIO
 description: >
     This is a representation of the Intel QMSI GPIO nodes
 
+compatible: "intel,qmsi-gpio"
+
 include: [gpio-controller.yaml, base.yaml]
 
 properties:
-    compatible:
-      constraint: "intel,qmsi-gpio"
-
     reg:
       required: true
 

dts/bindings/gpio/intel,qmsi-ss-gpio.yaml

@@ -9,12 +9,11 @@ title: Intel QMSI SS GPIO
 description: >
     This is a representation of the Intel QMSI SS GPIO nodes
 
+compatible: "intel,qmsi-ss-gpio"
+
 include: [gpio-controller.yaml, base.yaml]
 
 properties:
-    compatible:
-      constraint: "intel,qmsi-ss-gpio"
-
     reg:
       required: true
 

dts/bindings/gpio/microchip,xec-gpio.yaml

@@ -4,18 +4,16 @@
 # SPDX-License-Identifier: Apache-2.0
 #
 
-
 title: MICROCHIP GPIO
 
 description: >
     This is a representation of the CEC/MEC GPIO nodes for Microchip
 
+compatible: "microchip,xec-gpio"
+
 include: [gpio-controller.yaml, base.yaml]
 
 properties:
-    compatible:
-      constraint: "microchip,xec-gpio"
-
     reg:
       required: true
 

dts/bindings/gpio/nordic,nrf-gpio.yaml

@@ -9,12 +9,11 @@ title: NRF5 GPIO
 description: >
     This is a representation of the NRF GPIO nodes
 
+compatible: "nordic,nrf-gpio"
+
 include: [gpio-controller.yaml, base.yaml]
 
 properties:
-    compatible:
-      constraint: "nordic,nrf-gpio"
-
     reg:
       required: true
 

dts/bindings/gpio/nordic,nrf-gpiote.yaml

@@ -9,12 +9,11 @@ title: NRF5 GPIOTE
 description: >
     This is a representation of the NRF GPIOTE node
 
+compatible: "nordic,nrf-gpiote"
+
 include: base.yaml
 
 properties:
-    compatible:
-      constraint: "nordic,nrf-gpiote"
-
     reg:
       required: true
 

dts/bindings/gpio/nxp,imx-gpio.yaml

@@ -9,12 +9,11 @@ title: i.MX GPIO
 description: >
     This is a representation of the i.MX GPIO nodes
 
+compatible: "nxp,imx-gpio"
+
 include: [gpio-controller.yaml, base.yaml]
 
 properties:
-    compatible:
-      constraint: "nxp,imx-gpio"
-
     reg:
       required: true