Skip to contentSkip to conversation

dt-bindings: Add missing array size constraints

PATCH In review Rob Herring 11 participants 13 messages Jan 4, 2021 – Jan 7, 2021

Subsystems (46)
lore
Share & tools
lore

Rob Herring

author maintainer
#0 lore raw

PATCH 1/1 dt-bindings: Add missing array size constraints

DT properties which can have multiple entries need to specify what the entries are and define how many entries there can be. In the case of only a single entry, just 'maxItems: 1' is sufficient.

Add the missing entry constraints. These were found with a modified meta-schema. Unfortunately, there are a few cases where the size constraints are not defined such as common bindings, so the meta-schema can't be part of the normal checks.

Cc Jens Axboe <[email protected]>
Cc Stephen Boyd <[email protected]>
Cc Thierry Reding <[email protected]>
Cc MyungJoo Ham <[email protected]>
Cc Chanwoo Choi <[email protected]>
Cc Linus Walleij <[email protected]>
Cc Bartosz Golaszewski <[email protected]>
Cc Jonathan Cameron <[email protected]>
Cc Dmitry Torokhov <[email protected]>
Cc Thomas Gleixner <[email protected]>
Cc Marc Zyngier <[email protected]>
Cc Mauro Carvalho Chehab <[email protected]>
Cc Chen-Yu Tsai <[email protected]>
Cc Ulf Hansson <[email protected]>
Cc "David S. Miller" <[email protected]>
Cc Jakub Kicinski <[email protected]>
Cc Sebastian Reichel <[email protected]>
Cc Ohad Ben-Cohen <[email protected]>
Cc Bjorn Andersson <[email protected]>
Cc Greg Kroah-Hartman <[email protected]>

---
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]

---
 .../socionext,uniphier-system-cache.yaml      |  4 ++--
 .../bindings/ata/sata_highbank.yaml           |  1 +
 .../bindings/clock/canaan,k210-clk.yaml       |  1 +
 .../bindings/display/brcm,bcm2711-hdmi.yaml   |  1 +
 .../bindings/display/brcm,bcm2835-hdmi.yaml   |  1 +
 .../display/panel/jdi,lt070me05000.yaml       |  1 +
 .../display/panel/mantix,mlaf057we51-x.yaml   |  3 ++-
 .../display/panel/novatek,nt36672a.yaml       |  1 +
 .../devicetree/bindings/dsp/fsl,dsp.yaml      |  2 +-
 .../devicetree/bindings/eeprom/at25.yaml      |  3 +--
 .../bindings/extcon/extcon-ptn5150.yaml       |  2 ++
 .../bindings/gpio/gpio-pca95xx.yaml           |  1 +
 .../bindings/iio/adc/adi,ad7768-1.yaml        |  2 ++
 .../bindings/iio/adc/aspeed,ast2400-adc.yaml  |  1 +
 .../bindings/iio/adc/lltc,ltc2496.yaml        |  2 +-
 .../bindings/iio/adc/qcom,spmi-vadc.yaml      |  1 +
 .../bindings/iio/adc/st,stm32-adc.yaml        |  2 ++
 .../iio/magnetometer/asahi-kasei,ak8975.yaml  |  1 +
 .../iio/potentiometer/adi,ad5272.yaml         |  1 +
 .../input/touchscreen/elan,elants_i2c.yaml    |  1 +
 .../interrupt-controller/fsl,intmux.yaml      |  2 +-
 .../interrupt-controller/st,stm32-exti.yaml   |  2 ++
 .../allwinner,sun4i-a10-video-engine.yaml     |  1 +
 .../devicetree/bindings/media/i2c/imx219.yaml |  1 +
 .../memory-controllers/exynos-srom.yaml       |  2 ++
 .../bindings/misc/fsl,dpaa2-console.yaml      |  1 +
 .../bindings/mmc/mmc-controller.yaml          |  2 ++
 .../bindings/net/ti,k3-am654-cpsw-nuss.yaml   |  1 +
 .../bindings/net/ti,k3-am654-cpts.yaml        |  1 +
 .../phy/allwinner,sun4i-a10-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun50i-a64-usb-phy.yaml     |  2 ++
 .../phy/allwinner,sun50i-h6-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun5i-a13-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun6i-a31-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun8i-a23-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun8i-a83t-usb-phy.yaml     |  2 ++
 .../phy/allwinner,sun8i-h3-usb-phy.yaml       |  2 ++
 .../phy/allwinner,sun8i-r40-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun8i-v3s-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun9i-a80-usb-phy.yaml      | 19 ++++++++-----------
 .../phy/socionext,uniphier-ahci-phy.yaml      |  2 +-
 .../phy/socionext,uniphier-pcie-phy.yaml      |  2 +-
 .../phy/socionext,uniphier-usb3hs-phy.yaml    |  2 +-
 .../phy/socionext,uniphier-usb3ss-phy.yaml    |  2 +-
 .../bindings/phy/ti,phy-gmii-sel.yaml         |  2 +-
 .../pinctrl/aspeed,ast2400-pinctrl.yaml       |  3 +--
 .../pinctrl/aspeed,ast2500-pinctrl.yaml       |  4 ++--
 .../bindings/power/supply/bq25980.yaml        |  1 +
 .../bindings/remoteproc/ingenic,vpu.yaml      |  2 +-
 .../remoteproc/ti,omap-remoteproc.yaml        |  3 +++
 .../bindings/riscv/sifive-l2-cache.yaml       |  1 +
 .../bindings/serial/renesas,hscif.yaml        |  2 ++
 .../bindings/serial/renesas,scif.yaml         |  2 ++
 .../bindings/serial/renesas,scifa.yaml        |  2 ++
 .../bindings/serial/renesas,scifb.yaml        |  2 ++
 .../sound/allwinner,sun4i-a10-codec.yaml      |  1 +
 .../bindings/sound/google,sc7180-trogdor.yaml |  1 +
 .../bindings/sound/samsung,aries-wm8994.yaml  |  3 +++
 .../bindings/sound/samsung,midas-audio.yaml   |  2 ++
 .../devicetree/bindings/sound/tas2562.yaml    |  2 ++
 .../devicetree/bindings/sound/tas2770.yaml    |  2 ++
 .../bindings/sound/tlv320adcx140.yaml         |  1 +
 .../devicetree/bindings/spi/renesas,rspi.yaml |  2 ++
 .../devicetree/bindings/sram/sram.yaml        |  2 ++
 .../timer/allwinner,sun4i-a10-timer.yaml      |  2 ++
 .../bindings/timer/intel,ixp4xx-timer.yaml    |  2 +-
 .../usb/allwinner,sun4i-a10-musb.yaml         |  2 +-
 .../bindings/usb/brcm,usb-pinmap.yaml         |  3 +++
 .../devicetree/bindings/usb/generic-ehci.yaml |  1 +
 .../devicetree/bindings/usb/generic-ohci.yaml |  1 +
 .../devicetree/bindings/usb/ingenic,musb.yaml |  2 +-
 .../bindings/usb/renesas,usbhs.yaml           |  1 +
 .../devicetree/bindings/usb/ti,j721e-usb.yaml |  3 ++-
 .../bindings/usb/ti,keystone-dwc3.yaml        |  2 ++
 74 files changed, 118 insertions(+), 33 deletions(-)
Documentation/devicetree/bindings/arm/socionext/socionext,uniphier-system-cache.yaml +2 -2
index 2e765bb3e6f6..7ca5375f278f 100644
@@ -30,8 +30,8 @@ properties:
       Interrupts can be used to notify the completion of cache operations.
       The number of interrupts should match to the number of CPU cores.
       The specified interrupts correspond to CPU0, CPU1, ... in this order.
-      minItems: 1
-      maxItems: 4
+    minItems: 1
+    maxItems: 4
 
   cache-unified: true
 
Documentation/devicetree/bindings/ata/sata_highbank.yaml +1 -0
index 5e2a2394e600..ce75d77e9289 100644
@@ -61,6 +61,7 @@ properties:
     maxItems: 8
 
   calxeda,sgpio-gpio:
+    maxItems: 3
     description: |
       phandle-gpio bank, bit offset, and default on or off, which indicates
       that the driver supports SGPIO indicator lights using the indicated
Documentation/devicetree/bindings/clock/canaan,k210-clk.yaml +1 -0
index 565ca468cb44..7f5cf4001f76 100644
@@ -22,6 +22,7 @@ properties:
     const: canaan,k210-clk
 
   clocks:
+    maxItems: 1
     description:
       Phandle of the SoC 26MHz fixed-rate oscillator clock.
 
Documentation/devicetree/bindings/display/brcm,bcm2711-hdmi.yaml +1 -0
index 7ce06f9f9f8e..767edc0a7978 100644
@@ -60,6 +60,7 @@ properties:
       Phandle of the I2C controller used for DDC EDID probing
 
   hpd-gpios:
+    maxItems: 1
     description: >
       The GPIO pin for the HDMI hotplug detect (if it doesn't appear
       as an interrupt/status bit in the HDMI controller itself)
Documentation/devicetree/bindings/display/brcm,bcm2835-hdmi.yaml +1 -0
index f54b4e4808f0..031e35e76db2 100644
@@ -37,6 +37,7 @@ properties:
       Phandle of the I2C controller used for DDC EDID probing
 
   hpd-gpios:
+    maxItems: 1
     description: >
       The GPIO pin for the HDMI hotplug detect (if it doesn't appear
       as an interrupt/status bit in the HDMI controller itself)
Documentation/devicetree/bindings/display/panel/jdi,lt070me05000.yaml +1 -0
index b8b9435e464c..4f92365e888a 100644
@@ -30,6 +30,7 @@ properties:
       power supply for LCM (1.8V)
 
   dcdc-en-gpios:
+    maxItems: 1
     description: |
       phandle of the gpio for power ic line
       Power IC supply enable, High active
Documentation/devicetree/bindings/display/panel/mantix,mlaf057we51-x.yaml +2 -1
index 51f423297ec8..aa5a0dc391a4 100644
@@ -37,7 +37,8 @@ properties:
 
   reset-gpios: true
 
-  'mantix,tp-rstn-gpios':
+  mantix,tp-rstn-gpios:
+    maxItems: 1
     description: second reset line that triggers DSI config load
 
   backlight: true
Documentation/devicetree/bindings/display/panel/novatek,nt36672a.yaml +1 -0
index 2f5df1d235ae..ef4c0a24512d 100644
@@ -30,6 +30,7 @@ properties:
       panel. The novatek,nt36672a compatible shall always be provided as a fallback.
 
   reset-gpios:
+    maxItems: 1
     description: phandle of gpio for reset line - This should be 8mA, gpio
       can be configured using mux, pinctrl, pinctrl-names (active high)
 
Documentation/devicetree/bindings/dsp/fsl,dsp.yaml +1 -1
index 4cc011230153..7afc9f2be13a 100644
@@ -21,7 +21,7 @@ properties:
       - fsl,imx8mp-dsp
 
   reg:
-    description: Should contain register location and length
+    maxItems: 1
 
   clocks:
     items:
Documentation/devicetree/bindings/eeprom/at25.yaml +1 -2
index 121a601db22e..6a2dc8b3ed14 100644
@@ -39,8 +39,7 @@ properties:
           - const: atmel,at25
 
   reg:
-    description:
-      Chip select number.
+    maxItems: 1
 
   spi-max-frequency: true
 
Documentation/devicetree/bindings/extcon/extcon-ptn5150.yaml +2 -0
index 4b0f414486d2..d5cfa32ea52d 100644
@@ -19,6 +19,7 @@ properties:
     const: nxp,ptn5150
 
   int-gpios:
+    maxItems: 1
     deprecated: true
     description:
       GPIO pin (input) connected to the PTN5150's INTB pin.
@@ -31,6 +32,7 @@ properties:
     maxItems: 1
 
   vbus-gpios:
+    maxItems: 1
     description:
       GPIO pin (output) used to control VBUS. If skipped, no such control
       takes place.
Documentation/devicetree/bindings/gpio/gpio-pca95xx.yaml +1 -0
index f5ee23c2df60..57cdcfd4ff3c 100644
@@ -81,6 +81,7 @@ properties:
     const: 2
 
   reset-gpios:
+    maxItems: 1
     description:
       GPIO specification for the RESET input. This is an active low signal to
       the PCA953x.  Not valid for Maxim MAX732x devices.
Documentation/devicetree/bindings/iio/adc/adi,ad7768-1.yaml +2 -0
index 924477dfb833..a85a28145ef6 100644
@@ -40,6 +40,7 @@ properties:
       ADC reference voltage supply
 
   adi,sync-in-gpios:
+    maxItems: 1
     description:
       Enables synchronization of multiple devices that require simultaneous
       sampling. A pulse is always required if the configuration is changed
@@ -76,6 +77,7 @@ patternProperties:
 
     properties:
       reg:
+        maxItems: 1
         description: |
           The channel number.
 
Documentation/devicetree/bindings/iio/adc/aspeed,ast2400-adc.yaml +1 -0
index 7f534a933e92..a726b6c2ab65 100644
@@ -23,6 +23,7 @@ properties:
     maxItems: 1
 
   clocks:
+    maxItems: 1
     description:
       Input clock used to derive the sample clock. Expected to be the
       SoC's APB clock.
Documentation/devicetree/bindings/iio/adc/lltc,ltc2496.yaml +1 -1
index 2716d4e95329..0bd2fc0356c8 100644
@@ -20,7 +20,7 @@ properties:
     description: Power supply for the reference voltage
 
   reg:
-    description: spi chipselect number according to the usual spi bindings
+    maxItems: 1
 
   spi-max-frequency:
     description: maximal spi bus frequency supported
Documentation/devicetree/bindings/iio/adc/qcom,spmi-vadc.yaml +1 -0
index 95cc705b961b..74a4a9d95798 100644
@@ -68,6 +68,7 @@ patternProperties:
 
     properties:
       reg:
+        maxItems: 1
         description: |
           ADC channel number.
           See include/dt-bindings/iio/qcom,spmi-vadc.h
Documentation/devicetree/bindings/iio/adc/st,stm32-adc.yaml +2 -0
index 28417b31b558..6364ede9bb5f 100644
@@ -41,6 +41,8 @@ properties:
     maxItems: 2
 
   clocks:
+    minItems: 1
+    maxItems: 2
     description: |
       Core can use up to two clocks, depending on part used:
         - "adc" clock: for the analog circuitry, common to all ADCs.
Documentation/devicetree/bindings/iio/magnetometer/asahi-kasei,ak8975.yaml +1 -0
index a25590a16ba7..a0a1ffe017df 100644
@@ -47,6 +47,7 @@ properties:
     description: an optional 3x3 mounting rotation matrix.
 
   reset-gpios:
+    maxItems: 1
     description: |
       an optional pin needed for AK09911 to set the reset state. This should
       be usually active low
Documentation/devicetree/bindings/iio/potentiometer/adi,ad5272.yaml +1 -0
index 1aee9f9be951..0ebb6725a1af 100644
@@ -25,6 +25,7 @@ properties:
     maxItems: 1
 
   reset-gpios:
+    maxItems: 1
     description:
       Active low signal to the AD5272 RESET input.
 
Documentation/devicetree/bindings/input/touchscreen/elan,elants_i2c.yaml +1 -0
index a792d6377b1d..a9b53c2e6f0a 100644
@@ -29,6 +29,7 @@ properties:
     description: touchscreen can be used as a wakeup source.
 
   reset-gpios:
+    maxItems: 1
     description: reset gpio the chip is connected to.
 
   vcc33-supply:
Documentation/devicetree/bindings/interrupt-controller/fsl,intmux.yaml +1 -1
index 43c6effbb5bd..1d6e0f64a807 100644
@@ -31,7 +31,7 @@ properties:
       The 1st cell is hw interrupt number, the 2nd cell is channel index.
 
   clocks:
-    description: ipg clock.
+    maxItems: 1
 
   clock-names:
     const: ipg
Documentation/devicetree/bindings/interrupt-controller/st,stm32-exti.yaml +2 -0
index 2a5b29567926..6d3e68eb2e8b 100644
@@ -36,6 +36,8 @@ properties:
       Reference to a phandle of a hardware spinlock provider node.
 
   interrupts:
+    minItems: 1
+    maxItems: 96
     description:
       Interrupts references to primary interrupt controller
 
Documentation/devicetree/bindings/media/allwinner,sun4i-a10-video-engine.yaml +1 -0
index 2f7058f7760c..c34303b87a5b 100644
@@ -53,6 +53,7 @@ properties:
     maxItems: 1
 
   memory-region:
+    maxItems: 1
     description:
       CMA pool to use for buffers allocation instead of the default
       CMA pool.
Documentation/devicetree/bindings/media/i2c/imx219.yaml +1 -0
index dfc4d29a4f04..184d33bd3828 100644
@@ -40,6 +40,7 @@ properties:
       Digital core voltage supply, 1.2 volts
 
   reset-gpios:
+    maxItems: 1
     description: |-
       Reference to the GPIO connected to the xclr pin, if any.
       Must be released (set high) after all supplies are applied.
Documentation/devicetree/bindings/memory-controllers/exynos-srom.yaml +2 -0
index 637e24f0f73b..c6e44f47ce7c 100644
@@ -28,6 +28,8 @@ properties:
     const: 1
 
   ranges:
+    minItems: 1
+    maxItems: 4
     description: |
       Reflects the memory layout with four integer values per bank. Format:
       <bank-number> 0 <parent address of bank> <size>
Documentation/devicetree/bindings/misc/fsl,dpaa2-console.yaml +1 -0
index 271a3eafc054..8cc951feb7df 100644
@@ -15,6 +15,7 @@ properties:
     const: "fsl,dpaa2-console"
 
   reg:
+    maxItems: 1
     description: A standard property. Specifies the region where the MCFBA
                 (MC firmware base address) register can be found.
 
Documentation/devicetree/bindings/mmc/mmc-controller.yaml +2 -0
index 186f04ba9357..df4ee4c778ae 100644
@@ -40,6 +40,7 @@ properties:
       There is no card detection available; polling must be used.
 
   cd-gpios:
+    maxItems: 1
     description:
       The card detection will be done using the GPIO provided.
 
@@ -104,6 +105,7 @@ properties:
       line. Not used in combination with eMMC or SDIO.
 
   wp-gpios:
+    maxItems: 1
     description:
       GPIO to use for the write-protect detection.
 
Documentation/devicetree/bindings/net/ti,k3-am654-cpsw-nuss.yaml +1 -0
index c47b58f3e3f6..097c5cc6c853 100644
@@ -66,6 +66,7 @@ properties:
   dma-coherent: true
 
   clocks:
+    maxItems: 1
     description: CPSW2G NUSS functional clock
 
   clock-names:
Documentation/devicetree/bindings/net/ti,k3-am654-cpts.yaml +1 -0
index 9b7117920d90..2a42a27fb911 100644
@@ -59,6 +59,7 @@ properties:
       - const: cpts
 
   clocks:
+    maxItems: 1
     description: CPTS reference clock
 
   clock-names:
Documentation/devicetree/bindings/phy/allwinner,sun4i-a10-usb-phy.yaml +2 -0
index 94ac23687b7e..77606c899fe2 100644
@@ -51,9 +51,11 @@ properties:
       - const: usb2_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun50i-a64-usb-phy.yaml +2 -0
index fd6e126fcf18..078af52b16ed 100644
@@ -50,9 +50,11 @@ properties:
       - const: usb1_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun50i-h6-usb-phy.yaml +2 -0
index 7670411002c9..e632140722a2 100644
@@ -50,9 +50,11 @@ properties:
       - const: usb3_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun5i-a13-usb-phy.yaml +2 -0
index 9b319381d1ad..5bad9b06e2e7 100644
@@ -45,9 +45,11 @@ properties:
       - const: usb1_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun6i-a31-usb-phy.yaml +2 -0
index b0ed01bbf3db..922b4665e00d 100644
@@ -54,9 +54,11 @@ properties:
       - const: usb2_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun8i-a23-usb-phy.yaml +2 -0
index b0674406f8aa..a94019efc2f3 100644
@@ -50,9 +50,11 @@ properties:
       - const: usb1_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun8i-a83t-usb-phy.yaml +2 -0
index 48dc9c834a9b..33f3ddc0492d 100644
@@ -56,9 +56,11 @@ properties:
       - const: usb2_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun8i-h3-usb-phy.yaml +2 -0
index 60c344585276..f80431060803 100644
@@ -62,9 +62,11 @@ properties:
       - const: usb3_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun8i-r40-usb-phy.yaml +2 -0
index a2bb36790fbd..d947e50a49d2 100644
@@ -56,9 +56,11 @@ properties:
       - const: usb2_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun8i-v3s-usb-phy.yaml +2 -0
index eadfd0c9493c..a2836c296cc4 100644
@@ -42,9 +42,11 @@ properties:
     const: usb0_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun9i-a80-usb-phy.yaml +8 -11
index ded7d6f0a119..2eb493fa64fd 100644
@@ -22,7 +22,8 @@ properties:
 
   clocks:
     anyOf:
-      - description: Main PHY Clock
+      - maxItems: 1
+        description: Main PHY Clock
 
       - items:
           - description: Main PHY clock
@@ -39,20 +40,16 @@ properties:
           - const: hsic_480M
 
   resets:
-    anyOf:
+    minItems: 1
+    items:
       - description: Normal USB PHY reset
-
-      - items:
-          - description: Normal USB PHY reset
-          - description: HSIC Reset
+      - description: HSIC Reset
 
   reset-names:
-    oneOf:
+    minItems: 1
+    items:
       - const: phy
-
-      - items:
-          - const: phy
-          - const: hsic
+      - const: hsic
 
   phy_type:
     const: hsic
Documentation/devicetree/bindings/phy/socionext,uniphier-ahci-phy.yaml +1 -1
index 34756347a14e..745c525ce6b9 100644
@@ -20,7 +20,7 @@ properties:
       - socionext,uniphier-pxs3-ahci-phy
 
   reg:
-    description: PHY register region (offset and length)
+    maxItems: 1
 
   "#phy-cells":
     const: 0
Documentation/devicetree/bindings/phy/socionext,uniphier-pcie-phy.yaml +1 -1
index a06831fd64b9..3e0566899041 100644
@@ -21,7 +21,7 @@ properties:
       - socionext,uniphier-pxs3-pcie-phy
 
   reg:
-    description: PHY register region (offset and length)
+    maxItems: 1
 
   "#phy-cells":
     const: 0
Documentation/devicetree/bindings/phy/socionext,uniphier-usb3hs-phy.yaml +1 -1
index 6fa5caab1487..a681cbc3b4ef 100644
@@ -24,7 +24,7 @@ properties:
       - socionext,uniphier-pxs3-usb3-hsphy
 
   reg:
-    description: PHY register region (offset and length)
+    maxItems: 1
 
   "#phy-cells":
     const: 0
Documentation/devicetree/bindings/phy/socionext,uniphier-usb3ss-phy.yaml +1 -1
index 9d46715ed036..41c0dd68ee25 100644
@@ -25,7 +25,7 @@ properties:
       - socionext,uniphier-pxs3-usb3-ssphy
 
   reg:
-    description: PHY register region (offset and length)
+    maxItems: 1
 
   "#phy-cells":
     const: 0
Documentation/devicetree/bindings/phy/ti,phy-gmii-sel.yaml +1 -1
index bcec422d7734..ff8a6d9eb153 100644
@@ -55,7 +55,7 @@ properties:
       - ti,am654-phy-gmii-sel
 
   reg:
-    description: Address and length of the register set for the device
+    maxItems: 1
 
   '#phy-cells': true
 
Documentation/devicetree/bindings/pinctrl/aspeed,ast2400-pinctrl.yaml +1 -2
index 54631dc1adb0..91be5720d094 100644
@@ -23,8 +23,7 @@ properties:
   compatible:
     const: aspeed,ast2400-pinctrl
   reg:
-    description: |
-      A hint for the memory regions associated with the pin-controller
+    maxItems: 2
 
 patternProperties:
   '^.*$':
Documentation/devicetree/bindings/pinctrl/aspeed,ast2500-pinctrl.yaml +2 -2
index a90c0fe0495f..40e9e8d4be5a 100644
@@ -24,8 +24,8 @@ properties:
   compatible:
     const: aspeed,ast2500-pinctrl
   reg:
-    description: |
-      A hint for the memory regions associated with the pin-controller
+    maxItems: 2
+
   aspeed,external-nodes:
     minItems: 2
     maxItems: 2
Documentation/devicetree/bindings/power/supply/bq25980.yaml +1 -0
index f6b3dd4093ca..06eca6667f67 100644
@@ -70,6 +70,7 @@ properties:
     description: Enables bypass mode at boot time
 
   interrupts:
+    maxItems: 1
     description: |
       Indicates that the device state has changed.
 
Documentation/devicetree/bindings/remoteproc/ingenic,vpu.yaml +1 -1
index c019f9fbe916..d0aa91bbf5e5 100644
@@ -44,7 +44,7 @@ properties:
       - const: vpu
 
   interrupts:
-    description: VPU hardware interrupt
+    maxItems: 1
 
 required:
   - compatible
Documentation/devicetree/bindings/remoteproc/ti,omap-remoteproc.yaml +3 -0
index 084960a8f17a..1a1159097a2a 100644
@@ -70,10 +70,13 @@ properties:
       the firmware image.
 
   clocks:
+    maxItems: 1
     description: |
       Main functional clock for the remote processor
 
   resets:
+    minItems: 1
+    maxItems: 2
     description: |
       Reset handles for the remote processor
 
Documentation/devicetree/bindings/riscv/sifive-l2-cache.yaml +1 -0
index efc0198eeb74..2ece8630dc68 100644
@@ -63,6 +63,7 @@ properties:
   next-level-cache: true
 
   memory-region:
+    maxItems: 1
     description: |
       The reference to the reserved-memory for the L2 Loosely Integrated Memory region.
       The reserved memory node should be defined as per the bindings in reserved-memory.txt.
Documentation/devicetree/bindings/serial/renesas,hscif.yaml +2 -0
index c139c5edb93e..69533347aa57 100644
@@ -81,6 +81,8 @@ properties:
     maxItems: 1
 
   dmas:
+    minItems: 2
+    maxItems: 4
     description:
       Must contain a list of pairs of references to DMA specifiers, one for
       transmission, and one for reception.
Documentation/devicetree/bindings/serial/renesas,scif.yaml +2 -0
index 672158906c33..22d76829f7ae 100644
@@ -120,6 +120,8 @@ properties:
     maxItems: 1
 
   dmas:
+    minItems: 2
+    maxItems: 4
     description:
       Must contain a list of pairs of references to DMA specifiers, one for
       transmission, and one for reception.
Documentation/devicetree/bindings/serial/renesas,scifa.yaml +2 -0
index dbffb9534835..3c67d3202e1b 100644
@@ -55,6 +55,8 @@ properties:
     maxItems: 1
 
   dmas:
+    minItems: 2
+    maxItems: 4
     description:
       Must contain a list of pairs of references to DMA specifiers, one for
       transmission, and one for reception.
Documentation/devicetree/bindings/serial/renesas,scifb.yaml +2 -0
index 147f8a37e02a..d5571c7a4424 100644
@@ -55,6 +55,8 @@ properties:
     maxItems: 1
 
   dmas:
+    minItems: 2
+    maxItems: 4
     description:
       Must contain a list of pairs of references to DMA specifiers, one for
       transmission, and one for reception.
Documentation/devicetree/bindings/sound/allwinner,sun4i-a10-codec.yaml +1 -0
index dd47fef9854d..559aff13ae23 100644
@@ -88,6 +88,7 @@ properties:
     description: Phandle to the codec analog controls in the PRCM
 
   allwinner,pa-gpios:
+    maxItems: 1
     description: GPIO to enable the external amplifier
 
 required:
Documentation/devicetree/bindings/sound/google,sc7180-trogdor.yaml +1 -0
index 5095b780e2c7..837e3faa63a9 100644
@@ -55,6 +55,7 @@ patternProperties:
         maxItems: 1
 
       reg:
+        maxItems: 1
         description: dai link address.
 
       cpu:
Documentation/devicetree/bindings/sound/samsung,aries-wm8994.yaml +3 -0
index 1c6947294825..5fff586dc802 100644
@@ -62,12 +62,15 @@ properties:
     description: Supply for the micbias on the headset mic
 
   earpath-sel-gpios:
+    maxItems: 1
     description: GPIO for switching between tv-out and mic paths
 
   headset-detect-gpios:
+    maxItems: 1
     description: GPIO for detection of headset insertion
 
   headset-key-gpios:
+    maxItems: 1
     description: GPIO for detection of headset key press
 
   io-channels:
Documentation/devicetree/bindings/sound/samsung,midas-audio.yaml +2 -0
index 578928e67e5c..095775c598fa 100644
@@ -53,9 +53,11 @@ properties:
     description: Supply for the micbias on the Sub microphone
 
   fm-sel-gpios:
+    maxItems: 1
     description: GPIO pin for FM selection
 
   lineout-sel-gpios:
+    maxItems: 1
     description: GPIO pin for line out selection
 
 required:
Documentation/devicetree/bindings/sound/tas2562.yaml +2 -0
index 27f7132ba2ef..acd4bbe69731 100644
@@ -36,10 +36,12 @@ properties:
        I2C address of the device can be one of these 0x4c, 0x4d, 0x4e or 0x4f
 
   shut-down-gpios:
+    maxItems: 1
     description: GPIO used to control the state of the device.
     deprecated: true
 
   shutdown-gpios:
+    maxItems: 1
     description: GPIO used to control the state of the device.
 
   interrupts:
Documentation/devicetree/bindings/sound/tas2770.yaml +2 -0
index 07e7f9951d2e..027bebf4e8cf 100644
@@ -27,9 +27,11 @@ properties:
        I2C address of the device can be between 0x41 to 0x48.
 
   reset-gpio:
+    maxItems: 1
     description: GPIO used to reset the device.
 
   shutdown-gpios:
+    maxItems: 1
     description: GPIO used to control the state of the device.
 
   interrupts:
Documentation/devicetree/bindings/sound/tlv320adcx140.yaml +1 -0
index df18be9d7b15..54d64785aad2 100644
@@ -35,6 +35,7 @@ properties:
       I2C addresss of the device can be one of these 0x4c, 0x4d, 0x4e or 0x4f
 
   reset-gpios:
+    maxItems: 1
     description: |
       GPIO used for hardware reset.
 
Documentation/devicetree/bindings/spi/renesas,rspi.yaml +2 -0
index 10e83cb17e8d..8397f60d80a2 100644
@@ -68,6 +68,8 @@ properties:
     maxItems: 1
 
   dmas:
+    minItems: 2
+    maxItems: 4
     description:
       Must contain a list of pairs of references to DMA specifiers, one for
       transmission, and one for reception.
Documentation/devicetree/bindings/sram/sram.yaml +2 -0
index 19d116ff9ddc..2a62bb204bbe 100644
@@ -35,6 +35,7 @@ properties:
     maxItems: 1
 
   clocks:
+    maxItems: 1
     description:
       A list of phandle and clock specifier pair that controls the single
       SRAM clock.
@@ -46,6 +47,7 @@ properties:
     const: 1
 
   ranges:
+    maxItems: 1
     description:
       Should translate from local addresses within the sram to bus addresses.
 
Documentation/devicetree/bindings/timer/allwinner,sun4i-a10-timer.yaml +2 -0
index d918cee100ac..1c7cf32e7ac2 100644
@@ -22,6 +22,8 @@ properties:
     maxItems: 1
 
   interrupts:
+    minItems: 2
+    maxItems: 6
     description:
       List of timers interrupts
 
Documentation/devicetree/bindings/timer/intel,ixp4xx-timer.yaml +1 -1
index 1a721d8af67a..a8de99b0c0f9 100644
@@ -18,7 +18,7 @@ properties:
       - const: intel,ixp4xx-timer
 
   reg:
-    description: Should contain registers location and length
+    maxItems: 1
 
   interrupts:
     minItems: 1
Documentation/devicetree/bindings/usb/allwinner,sun4i-a10-musb.yaml +1 -1
index d9207bf9d894..0f520f17735e 100644
@@ -39,7 +39,7 @@ properties:
     maxItems: 1
 
   phys:
-    description: PHY specifier for the OTG PHY
+    maxItems: 1
 
   phy-names:
     const: usb
Documentation/devicetree/bindings/usb/brcm,usb-pinmap.yaml +3 -0
index ffa148b9eaa8..d4618d15ecc1 100644
@@ -22,6 +22,8 @@ properties:
     description: Interrupt for signals mirrored to out-gpios.
 
   in-gpios:
+    minItems: 1
+    maxItems: 2
     description: Array of one or two GPIO pins used for input signals.
 
   brcm,in-functions:
@@ -33,6 +35,7 @@ properties:
     description: Array of enable and mask pairs, one per gpio in-gpios.
 
   out-gpios:
+    maxItems: 1
     description: Array of one GPIO pin used for output signals.
 
   brcm,out-functions:
Documentation/devicetree/bindings/usb/generic-ehci.yaml +1 -0
index 247ef00381ea..f76b25f7fc7a 100644
@@ -83,6 +83,7 @@ properties:
       Phandle of a companion.
 
   phys:
+    maxItems: 1
     description: PHY specifier for the USB PHY
 
   phy-names:
Documentation/devicetree/bindings/usb/generic-ohci.yaml +1 -0
index 2178bcc401bc..8e2bd61f2075 100644
@@ -71,6 +71,7 @@ properties:
       Overrides the detected port count
 
   phys:
+    maxItems: 1
     description: PHY specifier for the USB PHY
 
   phy-names:
Documentation/devicetree/bindings/usb/ingenic,musb.yaml +1 -1
index 678396eeeb78..f506225a4d57 100644
@@ -40,7 +40,7 @@ properties:
       - const: mc
 
   phys:
-    description: PHY specifier for the USB PHY
+    maxItems: 1
 
   usb-role-switch:
     type: boolean
Documentation/devicetree/bindings/usb/renesas,usbhs.yaml +1 -0
index 54c361d4a7af..e67223d90bb7 100644
@@ -68,6 +68,7 @@ properties:
       Integer to use BUSWAIT register.
 
   renesas,enable-gpio:
+    maxItems: 1
     description: |
       gpio specifier to check GPIO determining if USB function should be
       enabled.
Documentation/devicetree/bindings/usb/ti,j721e-usb.yaml +2 -1
index 388245b91a55..adce36e48bc9 100644
@@ -15,13 +15,14 @@ properties:
       - const: ti,j721e-usb
 
   reg:
-    description: module registers
+    maxItems: 1
 
   power-domains:
     description:
       PM domain provider node and an args specifier containing
       the USB device id value. See,
       Documentation/devicetree/bindings/soc/ti/sci-pm-domain.txt
+    maxItems: 1
 
   clocks:
     description: Clock phandles to usb2_refclk and lpm_clk
Documentation/devicetree/bindings/usb/ti,keystone-dwc3.yaml +2 -0
index c1b19fc5d0a2..91ef374faba8 100644
@@ -43,12 +43,14 @@ properties:
     maxItems: 2
 
   power-domains:
+    maxItems: 1
     description: Should contain a phandle to a PM domain provider node
       and an args specifier containing the USB device id
       value. This property is as per the binding,
       Documentation/devicetree/bindings/soc/ti/sci-pm-domain.txt
 
   phys:
+    maxItems: 1
     description:
       PHY specifier for the USB3.0 PHY. Some SoCs need the USB3.0 PHY
       to be turned on before the controller.
Signature · 6 lines
2.27.0

_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel
maintainer Acked-by on v1 1/1
#1 lore raw

Hi Rob,

Quoted 4 lines · Rob Herring

DT properties which can have multiple entries need to specify what the entries are and define how many entries there can be. In the case of only a single entry, just 'maxItems: 1' is sufficient.

Quoted 8 lines

Add the missing entry constraints. These were found with a modified meta-schema. Unfortunately, there are a few cases where the size constraints are not defined such as common bindings, so the meta-schema can't be part of the normal checks.

[...]

 .../bindings/power/supply/bq25980.yaml        |  1 +

[...]

-- Sebastian

_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel

#2 lore raw
In reply to Rob Herring
Quoted 30 lines · Rob Herring

DT properties which can have multiple entries need to specify what the entries are and define how many entries there can be. In the case of only a single entry, just 'maxItems: 1' is sufficient.

Add the missing entry constraints. These were found with a modified meta-schema. Unfortunately, there are a few cases where the size constraints are not defined such as common bindings, so the meta-schema can't be part of the normal checks.

Cc Jens Axboe <[email protected]>
Cc Stephen Boyd <[email protected]>
Cc Thierry Reding <[email protected]>
Cc MyungJoo Ham <[email protected]>
Cc Chanwoo Choi <[email protected]>
Cc Linus Walleij <[email protected]>
Cc Bartosz Golaszewski <[email protected]>
Cc Jonathan Cameron <[email protected]>
Cc Dmitry Torokhov <[email protected]>
Cc Thomas Gleixner <[email protected]>
Cc Marc Zyngier <[email protected]>
Cc Mauro Carvalho Chehab <[email protected]>
Cc Chen-Yu Tsai <[email protected]>
Cc Ulf Hansson <[email protected]>
Cc "David S. Miller" <[email protected]>
Cc Jakub Kicinski <[email protected]>
Cc Sebastian Reichel <[email protected]>
Cc Ohad Ben-Cohen <[email protected]>
Cc Bjorn Andersson <[email protected]>
Cc Greg Kroah-Hartman <[email protected]>

<snip>

Quoted 29 lines
Documentation/devicetree/bindings/usb/generic-ehci.yaml +1 -0
index 247ef00381ea..f76b25f7fc7a 100644
@@ -83,6 +83,7 @@ properties:
       Phandle of a companion.
 
   phys:
+    maxItems: 1
     description: PHY specifier for the USB PHY
 
   phy-names:
Documentation/devicetree/bindings/usb/generic-ohci.yaml +1 -0
index 2178bcc401bc..8e2bd61f2075 100644
@@ -71,6 +71,7 @@ properties:
       Overrides the detected port count
 
   phys:
+    maxItems: 1
     description: PHY specifier for the USB PHY
 
   phy-names:
Documentation/devicetree/bindings/usb/ingenic,musb.yaml +0 -0
index 678396eeeb78..f506225a4d57 100644

Documentation/devicetree/bindings/usb/ingenic,musb.yaml properties: · line 46

Quoted 8 lines
Documentation/devicetree/bindings/usb/ingenic,musb.yaml +1 -1
@@ -40,7 +40,7 @@ properties:
       - const: mc
 
   phys:
-    description: PHY specifier for the USB PHY
+    maxItems: 1
 
   usb-role-switch:
     type: boolean

Any reason you dropped the description for this entry, but not the other ones above?

Quoted 10 lines
Documentation/devicetree/bindings/usb/ti,j721e-usb.yaml +1 -1
index 388245b91a55..adce36e48bc9 100644
@@ -15,13 +15,14 @@ properties:
       - const: ti,j721e-usb
 
   reg:
-    description: module registers
+    maxItems: 1

Documentation/devicetree/bindings/usb/ti,j721e-usb.yaml properties: · line 28

Quoted 10 lines
Documentation/devicetree/bindings/usb/ti,j721e-usb.yaml +1 -0
 
   power-domains:
     description:
       PM domain provider node and an args specifier containing
       the USB device id value. See,
       Documentation/devicetree/bindings/soc/ti/sci-pm-domain.txt
+    maxItems: 1
 
   clocks:
     description: Clock phandles to usb2_refclk and lpm_clk

Same here, why remove the description?

thanks,

greg k-h
_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel

author maintainer
#3 lore raw
Quoted 69 lines · Greg Kroah-Hartman
Quoted 30 lines · Rob Herring

DT properties which can have multiple entries need to specify what the entries are and define how many entries there can be. In the case of only a single entry, just 'maxItems: 1' is sufficient.

Add the missing entry constraints. These were found with a modified meta-schema. Unfortunately, there are a few cases where the size constraints are not defined such as common bindings, so the meta-schema can't be part of the normal checks.

Cc Jens Axboe <[email protected]>
Cc Stephen Boyd <[email protected]>
Cc Thierry Reding <[email protected]>
Cc MyungJoo Ham <[email protected]>
Cc Chanwoo Choi <[email protected]>
Cc Linus Walleij <[email protected]>
Cc Bartosz Golaszewski <[email protected]>
Cc Jonathan Cameron <[email protected]>
Cc Dmitry Torokhov <[email protected]>
Cc Thomas Gleixner <[email protected]>
Cc Marc Zyngier <[email protected]>
Cc Mauro Carvalho Chehab <[email protected]>
Cc Chen-Yu Tsai <[email protected]>
Cc Ulf Hansson <[email protected]>
Cc "David S. Miller" <[email protected]>
Cc Jakub Kicinski <[email protected]>
Cc Sebastian Reichel <[email protected]>
Cc Ohad Ben-Cohen <[email protected]>
Cc Bjorn Andersson <[email protected]>
Cc Greg Kroah-Hartman <[email protected]>

<snip>

Quoted 35 lines
Documentation/devicetree/bindings/usb/generic-ehci.yaml +1 -0
index 247ef00381ea..f76b25f7fc7a 100644
@@ -83,6 +83,7 @@ properties:
       Phandle of a companion.
 
   phys:
+    maxItems: 1
     description: PHY specifier for the USB PHY
 
   phy-names:
Documentation/devicetree/bindings/usb/generic-ohci.yaml +1 -0
index 2178bcc401bc..8e2bd61f2075 100644
@@ -71,6 +71,7 @@ properties:
       Overrides the detected port count
 
   phys:
+    maxItems: 1
     description: PHY specifier for the USB PHY
 
   phy-names:
Documentation/devicetree/bindings/usb/ingenic,musb.yaml +1 -1
index 678396eeeb78..f506225a4d57 100644
@@ -40,7 +40,7 @@ properties:
       - const: mc
 
   phys:
-    description: PHY specifier for the USB PHY
+    maxItems: 1
 
Quoted 5 lines

Documentation/devicetree/bindings/usb/ingenic,musb.yaml properties: · line 46

Quoted 2 lines
Documentation/devicetree/bindings/usb/ingenic,musb.yaml +0 -0
   usb-role-switch:
     type: boolean

Any reason you dropped the description for this entry, but not the other ones above?

No, I should have dropped those too. I dropped cases of genericish descriptions on common properties. There's nothing specific to this binding here really.

Quoted 19 lines
Quoted 19 lines
Documentation/devicetree/bindings/usb/ti,j721e-usb.yaml +2 -1
index 388245b91a55..adce36e48bc9 100644
@@ -15,13 +15,14 @@ properties:
       - const: ti,j721e-usb
 
   reg:
-    description: module registers
+    maxItems: 1
 
   power-domains:
     description:
       PM domain provider node and an args specifier containing
       the USB device id value. See,
       Documentation/devicetree/bindings/soc/ti/sci-pm-domain.txt
+    maxItems: 1
 
Quoted 4 lines

Documentation/devicetree/bindings/usb/ti,j721e-usb.yaml properties: · line 28

Quoted 2 lines
Documentation/devicetree/bindings/usb/ti,j721e-usb.yaml +0 -0
   clocks:
     description: Clock phandles to usb2_refclk and lpm_clk

Same here, why remove the description?

Really, the question is why keep 'description' on power-domains. Perhaps there's a little value in the reference to sci-pm-domain.txt, so I left it.

Rob
_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel

#4 lore raw
Quoted 99 lines · Rob Herring
Quoted 69 lines · Greg Kroah-Hartman
Quoted 30 lines · Rob Herring

DT properties which can have multiple entries need to specify what the entries are and define how many entries there can be. In the case of only a single entry, just 'maxItems: 1' is sufficient.

Add the missing entry constraints. These were found with a modified meta-schema. Unfortunately, there are a few cases where the size constraints are not defined such as common bindings, so the meta-schema can't be part of the normal checks.

Cc Jens Axboe <[email protected]>
Cc Stephen Boyd <[email protected]>
Cc Thierry Reding <[email protected]>
Cc MyungJoo Ham <[email protected]>
Cc Chanwoo Choi <[email protected]>
Cc Linus Walleij <[email protected]>
Cc Bartosz Golaszewski <[email protected]>
Cc Jonathan Cameron <[email protected]>
Cc Dmitry Torokhov <[email protected]>
Cc Thomas Gleixner <[email protected]>
Cc Marc Zyngier <[email protected]>
Cc Mauro Carvalho Chehab <[email protected]>
Cc Chen-Yu Tsai <[email protected]>
Cc Ulf Hansson <[email protected]>
Cc "David S. Miller" <[email protected]>
Cc Jakub Kicinski <[email protected]>
Cc Sebastian Reichel <[email protected]>
Cc Ohad Ben-Cohen <[email protected]>
Cc Bjorn Andersson <[email protected]>
Cc Greg Kroah-Hartman <[email protected]>

<snip>

Quoted 35 lines
Documentation/devicetree/bindings/usb/generic-ehci.yaml +1 -0
index 247ef00381ea..f76b25f7fc7a 100644
@@ -83,6 +83,7 @@ properties:
       Phandle of a companion.
 
   phys:
+    maxItems: 1
     description: PHY specifier for the USB PHY
 
   phy-names:
Documentation/devicetree/bindings/usb/generic-ohci.yaml +1 -0
index 2178bcc401bc..8e2bd61f2075 100644
@@ -71,6 +71,7 @@ properties:
       Overrides the detected port count
 
   phys:
+    maxItems: 1
     description: PHY specifier for the USB PHY
 
   phy-names:
Documentation/devicetree/bindings/usb/ingenic,musb.yaml +1 -1
index 678396eeeb78..f506225a4d57 100644
@@ -40,7 +40,7 @@ properties:
       - const: mc
 
   phys:
-    description: PHY specifier for the USB PHY
+    maxItems: 1
 
Quoted 5 lines

Documentation/devicetree/bindings/usb/ingenic,musb.yaml properties: · line 46

Quoted 2 lines
Documentation/devicetree/bindings/usb/ingenic,musb.yaml +0 -0
   usb-role-switch:
     type: boolean

Any reason you dropped the description for this entry, but not the other ones above?

No, I should have dropped those too. I dropped cases of genericish descriptions on common properties. There's nothing specific to this binding here really.

Quoted 19 lines
Quoted 19 lines
Documentation/devicetree/bindings/usb/ti,j721e-usb.yaml +2 -1
index 388245b91a55..adce36e48bc9 100644
@@ -15,13 +15,14 @@ properties:
       - const: ti,j721e-usb
 
   reg:
-    description: module registers
+    maxItems: 1
 
   power-domains:
     description:
       PM domain provider node and an args specifier containing
       the USB device id value. See,
       Documentation/devicetree/bindings/soc/ti/sci-pm-domain.txt
+    maxItems: 1
 
Quoted 8 lines
Quoted 4 lines

Documentation/devicetree/bindings/usb/ti,j721e-usb.yaml properties: · line 28

Quoted 2 lines
Documentation/devicetree/bindings/usb/ti,j721e-usb.yaml +0 -0
   clocks:
     description: Clock phandles to usb2_refclk and lpm_clk

Same here, why remove the description?

Really, the question is why keep 'description' on power-domains. Perhaps there's a little value in the reference to sci-pm-domain.txt, so I left it.

Ok, if you are fine with this, that's ok with me, just didn't look very consistent :)
_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel

Acked-by on v1 1/1
#5 lore raw
In reply to Rob Herring
Quoted 22 lines · On Mon, 4 Jan 2021 16:02:53 -0700 Rob Herring <[email protected]> wrote:

DT properties which can have multiple entries need to specify what the entries are and define how many entries there can be. In the case of only a single entry, just 'maxItems: 1' is sufficient.

Add the missing entry constraints. These were found with a modified meta-schema. Unfortunately, there are a few cases where the size constraints are not defined such as common bindings, so the meta-schema can't be part of the normal checks.

Cc Jens Axboe <[email protected]>
Cc Stephen Boyd <[email protected]>
Cc Thierry Reding <[email protected]>
Cc MyungJoo Ham <[email protected]>
Cc Chanwoo Choi <[email protected]>
Cc Linus Walleij <[email protected]>
Cc Bartosz Golaszewski <[email protected]>
Cc Jonathan Cameron <[email protected]>
Cc Dmitry Torokhov <[email protected]>
Cc Thomas Gleixner <[email protected]>
Cc Marc Zyngier <[email protected]>
Cc Mauro Carvalho Chehab <[email protected]>
Cc Chen-Yu Tsai <[email protected]>
Quoted 8 lines
Cc Ulf Hansson <[email protected]>
Cc "David S. Miller" <[email protected]>
Cc Jakub Kicinski <[email protected]>
Cc Sebastian Reichel <[email protected]>
Cc Ohad Ben-Cohen <[email protected]>
Cc Bjorn Andersson <[email protected]>
Cc Greg Kroah-Hartman <[email protected]>
Quoted 1,168 lines

---
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]

---
 .../socionext,uniphier-system-cache.yaml      |  4 ++--
 .../bindings/ata/sata_highbank.yaml           |  1 +
 .../bindings/clock/canaan,k210-clk.yaml       |  1 +
 .../bindings/display/brcm,bcm2711-hdmi.yaml   |  1 +
 .../bindings/display/brcm,bcm2835-hdmi.yaml   |  1 +
 .../display/panel/jdi,lt070me05000.yaml       |  1 +
 .../display/panel/mantix,mlaf057we51-x.yaml   |  3 ++-
 .../display/panel/novatek,nt36672a.yaml       |  1 +
 .../devicetree/bindings/dsp/fsl,dsp.yaml      |  2 +-
 .../devicetree/bindings/eeprom/at25.yaml      |  3 +--
 .../bindings/extcon/extcon-ptn5150.yaml       |  2 ++
 .../bindings/gpio/gpio-pca95xx.yaml           |  1 +
 .../bindings/iio/adc/adi,ad7768-1.yaml        |  2 ++
 .../bindings/iio/adc/aspeed,ast2400-adc.yaml  |  1 +
 .../bindings/iio/adc/lltc,ltc2496.yaml        |  2 +-
 .../bindings/iio/adc/qcom,spmi-vadc.yaml      |  1 +
 .../bindings/iio/adc/st,stm32-adc.yaml        |  2 ++
 .../iio/magnetometer/asahi-kasei,ak8975.yaml  |  1 +
 .../iio/potentiometer/adi,ad5272.yaml         |  1 +
 .../input/touchscreen/elan,elants_i2c.yaml    |  1 +
 .../interrupt-controller/fsl,intmux.yaml      |  2 +-
 .../interrupt-controller/st,stm32-exti.yaml   |  2 ++
 .../allwinner,sun4i-a10-video-engine.yaml     |  1 +
 .../devicetree/bindings/media/i2c/imx219.yaml |  1 +
 .../memory-controllers/exynos-srom.yaml       |  2 ++
 .../bindings/misc/fsl,dpaa2-console.yaml      |  1 +
 .../bindings/mmc/mmc-controller.yaml          |  2 ++
 .../bindings/net/ti,k3-am654-cpsw-nuss.yaml   |  1 +
 .../bindings/net/ti,k3-am654-cpts.yaml        |  1 +
 .../phy/allwinner,sun4i-a10-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun50i-a64-usb-phy.yaml     |  2 ++
 .../phy/allwinner,sun50i-h6-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun5i-a13-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun6i-a31-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun8i-a23-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun8i-a83t-usb-phy.yaml     |  2 ++
 .../phy/allwinner,sun8i-h3-usb-phy.yaml       |  2 ++
 .../phy/allwinner,sun8i-r40-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun8i-v3s-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun9i-a80-usb-phy.yaml      | 19 ++++++++-----------
 .../phy/socionext,uniphier-ahci-phy.yaml      |  2 +-
 .../phy/socionext,uniphier-pcie-phy.yaml      |  2 +-
 .../phy/socionext,uniphier-usb3hs-phy.yaml    |  2 +-
 .../phy/socionext,uniphier-usb3ss-phy.yaml    |  2 +-
 .../bindings/phy/ti,phy-gmii-sel.yaml         |  2 +-
 .../pinctrl/aspeed,ast2400-pinctrl.yaml       |  3 +--
 .../pinctrl/aspeed,ast2500-pinctrl.yaml       |  4 ++--
 .../bindings/power/supply/bq25980.yaml        |  1 +
 .../bindings/remoteproc/ingenic,vpu.yaml      |  2 +-
 .../remoteproc/ti,omap-remoteproc.yaml        |  3 +++
 .../bindings/riscv/sifive-l2-cache.yaml       |  1 +
 .../bindings/serial/renesas,hscif.yaml        |  2 ++
 .../bindings/serial/renesas,scif.yaml         |  2 ++
 .../bindings/serial/renesas,scifa.yaml        |  2 ++
 .../bindings/serial/renesas,scifb.yaml        |  2 ++
 .../sound/allwinner,sun4i-a10-codec.yaml      |  1 +
 .../bindings/sound/google,sc7180-trogdor.yaml |  1 +
 .../bindings/sound/samsung,aries-wm8994.yaml  |  3 +++
 .../bindings/sound/samsung,midas-audio.yaml   |  2 ++
 .../devicetree/bindings/sound/tas2562.yaml    |  2 ++
 .../devicetree/bindings/sound/tas2770.yaml    |  2 ++
 .../bindings/sound/tlv320adcx140.yaml         |  1 +
 .../devicetree/bindings/spi/renesas,rspi.yaml |  2 ++
 .../devicetree/bindings/sram/sram.yaml        |  2 ++
 .../timer/allwinner,sun4i-a10-timer.yaml      |  2 ++
 .../bindings/timer/intel,ixp4xx-timer.yaml    |  2 +-
 .../usb/allwinner,sun4i-a10-musb.yaml         |  2 +-
 .../bindings/usb/brcm,usb-pinmap.yaml         |  3 +++
 .../devicetree/bindings/usb/generic-ehci.yaml |  1 +
 .../devicetree/bindings/usb/generic-ohci.yaml |  1 +
 .../devicetree/bindings/usb/ingenic,musb.yaml |  2 +-
 .../bindings/usb/renesas,usbhs.yaml           |  1 +
 .../devicetree/bindings/usb/ti,j721e-usb.yaml |  3 ++-
 .../bindings/usb/ti,keystone-dwc3.yaml        |  2 ++
 74 files changed, 118 insertions(+), 33 deletions(-)
Documentation/devicetree/bindings/arm/socionext/socionext,uniphier-system-cache.yaml +2 -2
index 2e765bb3e6f6..7ca5375f278f 100644
@@ -30,8 +30,8 @@ properties:
       Interrupts can be used to notify the completion of cache operations.
       The number of interrupts should match to the number of CPU cores.
       The specified interrupts correspond to CPU0, CPU1, ... in this order.
-      minItems: 1
-      maxItems: 4
+    minItems: 1
+    maxItems: 4
 
   cache-unified: true
 
Documentation/devicetree/bindings/ata/sata_highbank.yaml +1 -0
index 5e2a2394e600..ce75d77e9289 100644
@@ -61,6 +61,7 @@ properties:
     maxItems: 8
 
   calxeda,sgpio-gpio:
+    maxItems: 3
     description: |
       phandle-gpio bank, bit offset, and default on or off, which indicates
       that the driver supports SGPIO indicator lights using the indicated
Documentation/devicetree/bindings/clock/canaan,k210-clk.yaml +1 -0
index 565ca468cb44..7f5cf4001f76 100644
@@ -22,6 +22,7 @@ properties:
     const: canaan,k210-clk
 
   clocks:
+    maxItems: 1
     description:
       Phandle of the SoC 26MHz fixed-rate oscillator clock.
 
Documentation/devicetree/bindings/display/brcm,bcm2711-hdmi.yaml +1 -0
index 7ce06f9f9f8e..767edc0a7978 100644
@@ -60,6 +60,7 @@ properties:
       Phandle of the I2C controller used for DDC EDID probing
 
   hpd-gpios:
+    maxItems: 1
     description: >
       The GPIO pin for the HDMI hotplug detect (if it doesn't appear
       as an interrupt/status bit in the HDMI controller itself)
Documentation/devicetree/bindings/display/brcm,bcm2835-hdmi.yaml +1 -0
index f54b4e4808f0..031e35e76db2 100644
@@ -37,6 +37,7 @@ properties:
       Phandle of the I2C controller used for DDC EDID probing
 
   hpd-gpios:
+    maxItems: 1
     description: >
       The GPIO pin for the HDMI hotplug detect (if it doesn't appear
       as an interrupt/status bit in the HDMI controller itself)
Documentation/devicetree/bindings/display/panel/jdi,lt070me05000.yaml +1 -0
index b8b9435e464c..4f92365e888a 100644
@@ -30,6 +30,7 @@ properties:
       power supply for LCM (1.8V)
 
   dcdc-en-gpios:
+    maxItems: 1
     description: |
       phandle of the gpio for power ic line
       Power IC supply enable, High active
Documentation/devicetree/bindings/display/panel/mantix,mlaf057we51-x.yaml +2 -1
index 51f423297ec8..aa5a0dc391a4 100644
@@ -37,7 +37,8 @@ properties:
 
   reset-gpios: true
 
-  'mantix,tp-rstn-gpios':
+  mantix,tp-rstn-gpios:
+    maxItems: 1
     description: second reset line that triggers DSI config load
 
   backlight: true
Documentation/devicetree/bindings/display/panel/novatek,nt36672a.yaml +1 -0
index 2f5df1d235ae..ef4c0a24512d 100644
@@ -30,6 +30,7 @@ properties:
       panel. The novatek,nt36672a compatible shall always be provided as a fallback.
 
   reset-gpios:
+    maxItems: 1
     description: phandle of gpio for reset line - This should be 8mA, gpio
       can be configured using mux, pinctrl, pinctrl-names (active high)
 
Documentation/devicetree/bindings/dsp/fsl,dsp.yaml +1 -1
index 4cc011230153..7afc9f2be13a 100644
@@ -21,7 +21,7 @@ properties:
       - fsl,imx8mp-dsp
 
   reg:
-    description: Should contain register location and length
+    maxItems: 1
 
   clocks:
     items:
Documentation/devicetree/bindings/eeprom/at25.yaml +1 -2
index 121a601db22e..6a2dc8b3ed14 100644
@@ -39,8 +39,7 @@ properties:
           - const: atmel,at25
 
   reg:
-    description:
-      Chip select number.
+    maxItems: 1
 
   spi-max-frequency: true
 
Documentation/devicetree/bindings/extcon/extcon-ptn5150.yaml +2 -0
index 4b0f414486d2..d5cfa32ea52d 100644
@@ -19,6 +19,7 @@ properties:
     const: nxp,ptn5150
 
   int-gpios:
+    maxItems: 1
     deprecated: true
     description:
       GPIO pin (input) connected to the PTN5150's INTB pin.
@@ -31,6 +32,7 @@ properties:
     maxItems: 1
 
   vbus-gpios:
+    maxItems: 1
     description:
       GPIO pin (output) used to control VBUS. If skipped, no such control
       takes place.
Documentation/devicetree/bindings/gpio/gpio-pca95xx.yaml +1 -0
index f5ee23c2df60..57cdcfd4ff3c 100644
@@ -81,6 +81,7 @@ properties:
     const: 2
 
   reset-gpios:
+    maxItems: 1
     description:
       GPIO specification for the RESET input. This is an active low signal to
       the PCA953x.  Not valid for Maxim MAX732x devices.
Documentation/devicetree/bindings/iio/adc/adi,ad7768-1.yaml +2 -0
index 924477dfb833..a85a28145ef6 100644
@@ -40,6 +40,7 @@ properties:
       ADC reference voltage supply
 
   adi,sync-in-gpios:
+    maxItems: 1
     description:
       Enables synchronization of multiple devices that require simultaneous
       sampling. A pulse is always required if the configuration is changed
@@ -76,6 +77,7 @@ patternProperties:
 
     properties:
       reg:
+        maxItems: 1
         description: |
           The channel number.
 
Documentation/devicetree/bindings/iio/adc/aspeed,ast2400-adc.yaml +1 -0
index 7f534a933e92..a726b6c2ab65 100644
@@ -23,6 +23,7 @@ properties:
     maxItems: 1
 
   clocks:
+    maxItems: 1
     description:
       Input clock used to derive the sample clock. Expected to be the
       SoC's APB clock.
Documentation/devicetree/bindings/iio/adc/lltc,ltc2496.yaml +1 -1
index 2716d4e95329..0bd2fc0356c8 100644
@@ -20,7 +20,7 @@ properties:
     description: Power supply for the reference voltage
 
   reg:
-    description: spi chipselect number according to the usual spi bindings
+    maxItems: 1
 
   spi-max-frequency:
     description: maximal spi bus frequency supported
Documentation/devicetree/bindings/iio/adc/qcom,spmi-vadc.yaml +1 -0
index 95cc705b961b..74a4a9d95798 100644
@@ -68,6 +68,7 @@ patternProperties:
 
     properties:
       reg:
+        maxItems: 1
         description: |
           ADC channel number.
           See include/dt-bindings/iio/qcom,spmi-vadc.h
Documentation/devicetree/bindings/iio/adc/st,stm32-adc.yaml +2 -0
index 28417b31b558..6364ede9bb5f 100644
@@ -41,6 +41,8 @@ properties:
     maxItems: 2
 
   clocks:
+    minItems: 1
+    maxItems: 2
     description: |
       Core can use up to two clocks, depending on part used:
         - "adc" clock: for the analog circuitry, common to all ADCs.
Documentation/devicetree/bindings/iio/magnetometer/asahi-kasei,ak8975.yaml +1 -0
index a25590a16ba7..a0a1ffe017df 100644
@@ -47,6 +47,7 @@ properties:
     description: an optional 3x3 mounting rotation matrix.
 
   reset-gpios:
+    maxItems: 1
     description: |
       an optional pin needed for AK09911 to set the reset state. This should
       be usually active low
Documentation/devicetree/bindings/iio/potentiometer/adi,ad5272.yaml +1 -0
index 1aee9f9be951..0ebb6725a1af 100644
@@ -25,6 +25,7 @@ properties:
     maxItems: 1
 
   reset-gpios:
+    maxItems: 1
     description:
       Active low signal to the AD5272 RESET input.
 
Documentation/devicetree/bindings/input/touchscreen/elan,elants_i2c.yaml +1 -0
index a792d6377b1d..a9b53c2e6f0a 100644
@@ -29,6 +29,7 @@ properties:
     description: touchscreen can be used as a wakeup source.
 
   reset-gpios:
+    maxItems: 1
     description: reset gpio the chip is connected to.
 
   vcc33-supply:
Documentation/devicetree/bindings/interrupt-controller/fsl,intmux.yaml +1 -1
index 43c6effbb5bd..1d6e0f64a807 100644
@@ -31,7 +31,7 @@ properties:
       The 1st cell is hw interrupt number, the 2nd cell is channel index.
 
   clocks:
-    description: ipg clock.
+    maxItems: 1
 
   clock-names:
     const: ipg
Documentation/devicetree/bindings/interrupt-controller/st,stm32-exti.yaml +2 -0
index 2a5b29567926..6d3e68eb2e8b 100644
@@ -36,6 +36,8 @@ properties:
       Reference to a phandle of a hardware spinlock provider node.
 
   interrupts:
+    minItems: 1
+    maxItems: 96
     description:
       Interrupts references to primary interrupt controller
 
Documentation/devicetree/bindings/media/allwinner,sun4i-a10-video-engine.yaml +1 -0
index 2f7058f7760c..c34303b87a5b 100644
@@ -53,6 +53,7 @@ properties:
     maxItems: 1
 
   memory-region:
+    maxItems: 1
     description:
       CMA pool to use for buffers allocation instead of the default
       CMA pool.
Documentation/devicetree/bindings/media/i2c/imx219.yaml +1 -0
index dfc4d29a4f04..184d33bd3828 100644
@@ -40,6 +40,7 @@ properties:
       Digital core voltage supply, 1.2 volts
 
   reset-gpios:
+    maxItems: 1
     description: |-
       Reference to the GPIO connected to the xclr pin, if any.
       Must be released (set high) after all supplies are applied.
Documentation/devicetree/bindings/memory-controllers/exynos-srom.yaml +2 -0
index 637e24f0f73b..c6e44f47ce7c 100644
@@ -28,6 +28,8 @@ properties:
     const: 1
 
   ranges:
+    minItems: 1
+    maxItems: 4
     description: |
       Reflects the memory layout with four integer values per bank. Format:
       <bank-number> 0 <parent address of bank> <size>
Documentation/devicetree/bindings/misc/fsl,dpaa2-console.yaml +1 -0
index 271a3eafc054..8cc951feb7df 100644
@@ -15,6 +15,7 @@ properties:
     const: "fsl,dpaa2-console"
 
   reg:
+    maxItems: 1
     description: A standard property. Specifies the region where the MCFBA
                 (MC firmware base address) register can be found.
 
Documentation/devicetree/bindings/mmc/mmc-controller.yaml +2 -0
index 186f04ba9357..df4ee4c778ae 100644
@@ -40,6 +40,7 @@ properties:
       There is no card detection available; polling must be used.
 
   cd-gpios:
+    maxItems: 1
     description:
       The card detection will be done using the GPIO provided.
 
@@ -104,6 +105,7 @@ properties:
       line. Not used in combination with eMMC or SDIO.
 
   wp-gpios:
+    maxItems: 1
     description:
       GPIO to use for the write-protect detection.
 
Documentation/devicetree/bindings/net/ti,k3-am654-cpsw-nuss.yaml +1 -0
index c47b58f3e3f6..097c5cc6c853 100644
@@ -66,6 +66,7 @@ properties:
   dma-coherent: true
 
   clocks:
+    maxItems: 1
     description: CPSW2G NUSS functional clock
 
   clock-names:
Documentation/devicetree/bindings/net/ti,k3-am654-cpts.yaml +1 -0
index 9b7117920d90..2a42a27fb911 100644
@@ -59,6 +59,7 @@ properties:
       - const: cpts
 
   clocks:
+    maxItems: 1
     description: CPTS reference clock
 
   clock-names:
Documentation/devicetree/bindings/phy/allwinner,sun4i-a10-usb-phy.yaml +2 -0
index 94ac23687b7e..77606c899fe2 100644
@@ -51,9 +51,11 @@ properties:
       - const: usb2_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun50i-a64-usb-phy.yaml +2 -0
index fd6e126fcf18..078af52b16ed 100644
@@ -50,9 +50,11 @@ properties:
       - const: usb1_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun50i-h6-usb-phy.yaml +2 -0
index 7670411002c9..e632140722a2 100644
@@ -50,9 +50,11 @@ properties:
       - const: usb3_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun5i-a13-usb-phy.yaml +2 -0
index 9b319381d1ad..5bad9b06e2e7 100644
@@ -45,9 +45,11 @@ properties:
       - const: usb1_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun6i-a31-usb-phy.yaml +2 -0
index b0ed01bbf3db..922b4665e00d 100644
@@ -54,9 +54,11 @@ properties:
       - const: usb2_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun8i-a23-usb-phy.yaml +2 -0
index b0674406f8aa..a94019efc2f3 100644
@@ -50,9 +50,11 @@ properties:
       - const: usb1_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun8i-a83t-usb-phy.yaml +2 -0
index 48dc9c834a9b..33f3ddc0492d 100644
@@ -56,9 +56,11 @@ properties:
       - const: usb2_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun8i-h3-usb-phy.yaml +2 -0
index 60c344585276..f80431060803 100644
@@ -62,9 +62,11 @@ properties:
       - const: usb3_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun8i-r40-usb-phy.yaml +2 -0
index a2bb36790fbd..d947e50a49d2 100644
@@ -56,9 +56,11 @@ properties:
       - const: usb2_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun8i-v3s-usb-phy.yaml +2 -0
index eadfd0c9493c..a2836c296cc4 100644
@@ -42,9 +42,11 @@ properties:
     const: usb0_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun9i-a80-usb-phy.yaml +8 -11
index ded7d6f0a119..2eb493fa64fd 100644
@@ -22,7 +22,8 @@ properties:
 
   clocks:
     anyOf:
-      - description: Main PHY Clock
+      - maxItems: 1
+        description: Main PHY Clock
 
       - items:
           - description: Main PHY clock
@@ -39,20 +40,16 @@ properties:
           - const: hsic_480M
 
   resets:
-    anyOf:
+    minItems: 1
+    items:
       - description: Normal USB PHY reset
-
-      - items:
-          - description: Normal USB PHY reset
-          - description: HSIC Reset
+      - description: HSIC Reset
 
   reset-names:
-    oneOf:
+    minItems: 1
+    items:
       - const: phy
-
-      - items:
-          - const: phy
-          - const: hsic
+      - const: hsic
 
   phy_type:
     const: hsic
Documentation/devicetree/bindings/phy/socionext,uniphier-ahci-phy.yaml +1 -1
index 34756347a14e..745c525ce6b9 100644
@@ -20,7 +20,7 @@ properties:
       - socionext,uniphier-pxs3-ahci-phy
 
   reg:
-    description: PHY register region (offset and length)
+    maxItems: 1
 
   "#phy-cells":
     const: 0
Documentation/devicetree/bindings/phy/socionext,uniphier-pcie-phy.yaml +1 -1
index a06831fd64b9..3e0566899041 100644
@@ -21,7 +21,7 @@ properties:
       - socionext,uniphier-pxs3-pcie-phy
 
   reg:
-    description: PHY register region (offset and length)
+    maxItems: 1
 
   "#phy-cells":
     const: 0
Documentation/devicetree/bindings/phy/socionext,uniphier-usb3hs-phy.yaml +1 -1
index 6fa5caab1487..a681cbc3b4ef 100644
@@ -24,7 +24,7 @@ properties:
       - socionext,uniphier-pxs3-usb3-hsphy
 
   reg:
-    description: PHY register region (offset and length)
+    maxItems: 1
 
   "#phy-cells":
     const: 0
Documentation/devicetree/bindings/phy/socionext,uniphier-usb3ss-phy.yaml +1 -1
index 9d46715ed036..41c0dd68ee25 100644
@@ -25,7 +25,7 @@ properties:
       - socionext,uniphier-pxs3-usb3-ssphy
 
   reg:
-    description: PHY register region (offset and length)
+    maxItems: 1
 
   "#phy-cells":
     const: 0
Documentation/devicetree/bindings/phy/ti,phy-gmii-sel.yaml +1 -1
index bcec422d7734..ff8a6d9eb153 100644
@@ -55,7 +55,7 @@ properties:
       - ti,am654-phy-gmii-sel
 
   reg:
-    description: Address and length of the register set for the device
+    maxItems: 1
 
   '#phy-cells': true
 
Documentation/devicetree/bindings/pinctrl/aspeed,ast2400-pinctrl.yaml +1 -2
index 54631dc1adb0..91be5720d094 100644
@@ -23,8 +23,7 @@ properties:
   compatible:
     const: aspeed,ast2400-pinctrl
   reg:
-    description: |
-      A hint for the memory regions associated with the pin-controller
+    maxItems: 2
 
 patternProperties:
   '^.*$':
Documentation/devicetree/bindings/pinctrl/aspeed,ast2500-pinctrl.yaml +2 -2
index a90c0fe0495f..40e9e8d4be5a 100644
@@ -24,8 +24,8 @@ properties:
   compatible:
     const: aspeed,ast2500-pinctrl
   reg:
-    description: |
-      A hint for the memory regions associated with the pin-controller
+    maxItems: 2
+
   aspeed,external-nodes:
     minItems: 2
     maxItems: 2
Documentation/devicetree/bindings/power/supply/bq25980.yaml +1 -0
index f6b3dd4093ca..06eca6667f67 100644
@@ -70,6 +70,7 @@ properties:
     description: Enables bypass mode at boot time
 
   interrupts:
+    maxItems: 1
     description: |
       Indicates that the device state has changed.
 
Documentation/devicetree/bindings/remoteproc/ingenic,vpu.yaml +1 -1
index c019f9fbe916..d0aa91bbf5e5 100644
@@ -44,7 +44,7 @@ properties:
       - const: vpu
 
   interrupts:
-    description: VPU hardware interrupt
+    maxItems: 1
 
 required:
   - compatible
Documentation/devicetree/bindings/remoteproc/ti,omap-remoteproc.yaml +3 -0
index 084960a8f17a..1a1159097a2a 100644
@@ -70,10 +70,13 @@ properties:
       the firmware image.
 
   clocks:
+    maxItems: 1
     description: |
       Main functional clock for the remote processor
 
   resets:
+    minItems: 1
+    maxItems: 2
     description: |
       Reset handles for the remote processor
 
Documentation/devicetree/bindings/riscv/sifive-l2-cache.yaml +1 -0
index efc0198eeb74..2ece8630dc68 100644
@@ -63,6 +63,7 @@ properties:
   next-level-cache: true
 
   memory-region:
+    maxItems: 1
     description: |
       The reference to the reserved-memory for the L2 Loosely Integrated Memory region.
       The reserved memory node should be defined as per the bindings in reserved-memory.txt.
Documentation/devicetree/bindings/serial/renesas,hscif.yaml +2 -0
index c139c5edb93e..69533347aa57 100644
@@ -81,6 +81,8 @@ properties:
     maxItems: 1
 
   dmas:
+    minItems: 2
+    maxItems: 4
     description:
       Must contain a list of pairs of references to DMA specifiers, one for
       transmission, and one for reception.
Documentation/devicetree/bindings/serial/renesas,scif.yaml +2 -0
index 672158906c33..22d76829f7ae 100644
@@ -120,6 +120,8 @@ properties:
     maxItems: 1
 
   dmas:
+    minItems: 2
+    maxItems: 4
     description:
       Must contain a list of pairs of references to DMA specifiers, one for
       transmission, and one for reception.
Documentation/devicetree/bindings/serial/renesas,scifa.yaml +2 -0
index dbffb9534835..3c67d3202e1b 100644
@@ -55,6 +55,8 @@ properties:
     maxItems: 1
 
   dmas:
+    minItems: 2
+    maxItems: 4
     description:
       Must contain a list of pairs of references to DMA specifiers, one for
       transmission, and one for reception.
Documentation/devicetree/bindings/serial/renesas,scifb.yaml +2 -0
index 147f8a37e02a..d5571c7a4424 100644
@@ -55,6 +55,8 @@ properties:
     maxItems: 1
 
   dmas:
+    minItems: 2
+    maxItems: 4
     description:
       Must contain a list of pairs of references to DMA specifiers, one for
       transmission, and one for reception.
Documentation/devicetree/bindings/sound/allwinner,sun4i-a10-codec.yaml +1 -0
index dd47fef9854d..559aff13ae23 100644
@@ -88,6 +88,7 @@ properties:
     description: Phandle to the codec analog controls in the PRCM
 
   allwinner,pa-gpios:
+    maxItems: 1
     description: GPIO to enable the external amplifier
 
 required:
Documentation/devicetree/bindings/sound/google,sc7180-trogdor.yaml +1 -0
index 5095b780e2c7..837e3faa63a9 100644
@@ -55,6 +55,7 @@ patternProperties:
         maxItems: 1
 
       reg:
+        maxItems: 1
         description: dai link address.
 
       cpu:
Documentation/devicetree/bindings/sound/samsung,aries-wm8994.yaml +3 -0
index 1c6947294825..5fff586dc802 100644
@@ -62,12 +62,15 @@ properties:
     description: Supply for the micbias on the headset mic
 
   earpath-sel-gpios:
+    maxItems: 1
     description: GPIO for switching between tv-out and mic paths
 
   headset-detect-gpios:
+    maxItems: 1
     description: GPIO for detection of headset insertion
 
   headset-key-gpios:
+    maxItems: 1
     description: GPIO for detection of headset key press
 
   io-channels:
Documentation/devicetree/bindings/sound/samsung,midas-audio.yaml +2 -0
index 578928e67e5c..095775c598fa 100644
@@ -53,9 +53,11 @@ properties:
     description: Supply for the micbias on the Sub microphone
 
   fm-sel-gpios:
+    maxItems: 1
     description: GPIO pin for FM selection
 
   lineout-sel-gpios:
+    maxItems: 1
     description: GPIO pin for line out selection
 
 required:
Documentation/devicetree/bindings/sound/tas2562.yaml +2 -0
index 27f7132ba2ef..acd4bbe69731 100644
@@ -36,10 +36,12 @@ properties:
        I2C address of the device can be one of these 0x4c, 0x4d, 0x4e or 0x4f
 
   shut-down-gpios:
+    maxItems: 1
     description: GPIO used to control the state of the device.
     deprecated: true
 
   shutdown-gpios:
+    maxItems: 1
     description: GPIO used to control the state of the device.
 
   interrupts:
Documentation/devicetree/bindings/sound/tas2770.yaml +2 -0
index 07e7f9951d2e..027bebf4e8cf 100644
@@ -27,9 +27,11 @@ properties:
        I2C address of the device can be between 0x41 to 0x48.
 
   reset-gpio:
+    maxItems: 1
     description: GPIO used to reset the device.
 
   shutdown-gpios:
+    maxItems: 1
     description: GPIO used to control the state of the device.
 
   interrupts:
Documentation/devicetree/bindings/sound/tlv320adcx140.yaml +1 -0
index df18be9d7b15..54d64785aad2 100644
@@ -35,6 +35,7 @@ properties:
       I2C addresss of the device can be one of these 0x4c, 0x4d, 0x4e or 0x4f
 
   reset-gpios:
+    maxItems: 1
     description: |
       GPIO used for hardware reset.
 
Documentation/devicetree/bindings/spi/renesas,rspi.yaml +2 -0
index 10e83cb17e8d..8397f60d80a2 100644
@@ -68,6 +68,8 @@ properties:
     maxItems: 1
 
   dmas:
+    minItems: 2
+    maxItems: 4
     description:
       Must contain a list of pairs of references to DMA specifiers, one for
       transmission, and one for reception.
Documentation/devicetree/bindings/sram/sram.yaml +2 -0
index 19d116ff9ddc..2a62bb204bbe 100644
@@ -35,6 +35,7 @@ properties:
     maxItems: 1
 
   clocks:
+    maxItems: 1
     description:
       A list of phandle and clock specifier pair that controls the single
       SRAM clock.
@@ -46,6 +47,7 @@ properties:
     const: 1
 
   ranges:
+    maxItems: 1
     description:
       Should translate from local addresses within the sram to bus addresses.
 
Documentation/devicetree/bindings/timer/allwinner,sun4i-a10-timer.yaml +2 -0
index d918cee100ac..1c7cf32e7ac2 100644
@@ -22,6 +22,8 @@ properties:
     maxItems: 1
 
   interrupts:
+    minItems: 2
+    maxItems: 6
     description:
       List of timers interrupts
 
Documentation/devicetree/bindings/timer/intel,ixp4xx-timer.yaml +1 -1
index 1a721d8af67a..a8de99b0c0f9 100644
@@ -18,7 +18,7 @@ properties:
       - const: intel,ixp4xx-timer
 
   reg:
-    description: Should contain registers location and length
+    maxItems: 1
 
   interrupts:
     minItems: 1
Documentation/devicetree/bindings/usb/allwinner,sun4i-a10-musb.yaml +1 -1
index d9207bf9d894..0f520f17735e 100644
@@ -39,7 +39,7 @@ properties:
     maxItems: 1
 
   phys:
-    description: PHY specifier for the OTG PHY
+    maxItems: 1
 
   phy-names:
     const: usb
Documentation/devicetree/bindings/usb/brcm,usb-pinmap.yaml +3 -0
index ffa148b9eaa8..d4618d15ecc1 100644
@@ -22,6 +22,8 @@ properties:
     description: Interrupt for signals mirrored to out-gpios.
 
   in-gpios:
+    minItems: 1
+    maxItems: 2
     description: Array of one or two GPIO pins used for input signals.
 
   brcm,in-functions:
@@ -33,6 +35,7 @@ properties:
     description: Array of enable and mask pairs, one per gpio in-gpios.
 
   out-gpios:
+    maxItems: 1
     description: Array of one GPIO pin used for output signals.
 
   brcm,out-functions:
Documentation/devicetree/bindings/usb/generic-ehci.yaml +1 -0
index 247ef00381ea..f76b25f7fc7a 100644
@@ -83,6 +83,7 @@ properties:
       Phandle of a companion.
 
   phys:
+    maxItems: 1
     description: PHY specifier for the USB PHY
 
   phy-names:
Documentation/devicetree/bindings/usb/generic-ohci.yaml +1 -0
index 2178bcc401bc..8e2bd61f2075 100644
@@ -71,6 +71,7 @@ properties:
       Overrides the detected port count
 
   phys:
+    maxItems: 1
     description: PHY specifier for the USB PHY
 
   phy-names:
Documentation/devicetree/bindings/usb/ingenic,musb.yaml +1 -1
index 678396eeeb78..f506225a4d57 100644
@@ -40,7 +40,7 @@ properties:
       - const: mc
 
   phys:
-    description: PHY specifier for the USB PHY
+    maxItems: 1
 
   usb-role-switch:
     type: boolean
Documentation/devicetree/bindings/usb/renesas,usbhs.yaml +1 -0
index 54c361d4a7af..e67223d90bb7 100644
@@ -68,6 +68,7 @@ properties:
       Integer to use BUSWAIT register.
 
   renesas,enable-gpio:
+    maxItems: 1
     description: |
       gpio specifier to check GPIO determining if USB function should be
       enabled.
Documentation/devicetree/bindings/usb/ti,j721e-usb.yaml +2 -1
index 388245b91a55..adce36e48bc9 100644
@@ -15,13 +15,14 @@ properties:
       - const: ti,j721e-usb
 
   reg:
-    description: module registers
+    maxItems: 1
 
   power-domains:
     description:
       PM domain provider node and an args specifier containing
       the USB device id value. See,
       Documentation/devicetree/bindings/soc/ti/sci-pm-domain.txt
+    maxItems: 1
 
   clocks:
     description: Clock phandles to usb2_refclk and lpm_clk
Documentation/devicetree/bindings/usb/ti,keystone-dwc3.yaml +2 -0
index c1b19fc5d0a2..91ef374faba8 100644
@@ -43,12 +43,14 @@ properties:
     maxItems: 2
 
   power-domains:
+    maxItems: 1
     description: Should contain a phandle to a PM domain provider node
       and an args specifier containing the USB device id
       value. This property is as per the binding,
       Documentation/devicetree/bindings/soc/ti/sci-pm-domain.txt
 
   phys:
+    maxItems: 1
     description:
       PHY specifier for the USB3.0 PHY. Some SoCs need the USB3.0 PHY
       to be turned on before the controller.
Acked-by on v1 1/1
#6 lore raw
In reply to Rob Herring

Hi Rob,

Quoted 49 lines · Rob Herring

DT properties which can have multiple entries need to specify what the entries are and define how many entries there can be. In the case of only a single entry, just 'maxItems: 1' is sufficient.

Add the missing entry constraints. These were found with a modified meta-schema. Unfortunately, there are a few cases where the size constraints are not defined such as common bindings, so the meta-schema can't be part of the normal checks.

Cc Jens Axboe <[email protected]>
Cc Stephen Boyd <[email protected]>
Cc Thierry Reding <[email protected]>
Cc MyungJoo Ham <[email protected]>
Cc Chanwoo Choi <[email protected]>
Cc Linus Walleij <[email protected]>
Cc Bartosz Golaszewski <[email protected]>
Cc Jonathan Cameron <[email protected]>
Cc Dmitry Torokhov <[email protected]>
Cc Thomas Gleixner <[email protected]>
Cc Marc Zyngier <[email protected]>
Cc Mauro Carvalho Chehab <[email protected]>
Cc Chen-Yu Tsai <[email protected]>
Cc Ulf Hansson <[email protected]>
Cc "David S. Miller" <[email protected]>
Cc Jakub Kicinski <[email protected]>
Cc Sebastian Reichel <[email protected]>
Cc Ohad Ben-Cohen <[email protected]>
Cc Bjorn Andersson <[email protected]>
Cc Greg Kroah-Hartman <[email protected]>

---
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]

Quoted 12 lines
---
 .../socionext,uniphier-system-cache.yaml      |  4 ++--
 .../bindings/ata/sata_highbank.yaml           |  1 +
 .../bindings/clock/canaan,k210-clk.yaml       |  1 +
 .../bindings/display/brcm,bcm2711-hdmi.yaml   |  1 +
 .../bindings/display/brcm,bcm2835-hdmi.yaml   |  1 +
 .../display/panel/jdi,lt070me05000.yaml       |  1 +
 .../display/panel/mantix,mlaf057we51-x.yaml   |  3 ++-
 .../display/panel/novatek,nt36672a.yaml       |  1 +
 .../devicetree/bindings/dsp/fsl,dsp.yaml      |  2 +-
 .../devicetree/bindings/eeprom/at25.yaml      |  3 +--
 .../bindings/extcon/extcon-ptn5150.yaml       |  2 ++

For extcon part,

(snip)

Best Regards,
Chanwoo Choi
_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel

maintainer
#7 lore raw
In reply to Rob Herring

Adding Suman and Paul - guys please have a look.

Quoted 1,206 lines · Rob Herring

DT properties which can have multiple entries need to specify what the entries are and define how many entries there can be. In the case of only a single entry, just 'maxItems: 1' is sufficient.

Add the missing entry constraints. These were found with a modified meta-schema. Unfortunately, there are a few cases where the size constraints are not defined such as common bindings, so the meta-schema can't be part of the normal checks.

Cc Jens Axboe <[email protected]>
Cc Stephen Boyd <[email protected]>
Cc Thierry Reding <[email protected]>
Cc MyungJoo Ham <[email protected]>
Cc Chanwoo Choi <[email protected]>
Cc Linus Walleij <[email protected]>
Cc Bartosz Golaszewski <[email protected]>
Cc Jonathan Cameron <[email protected]>
Cc Dmitry Torokhov <[email protected]>
Cc Thomas Gleixner <[email protected]>
Cc Marc Zyngier <[email protected]>
Cc Mauro Carvalho Chehab <[email protected]>
Cc Chen-Yu Tsai <[email protected]>
Cc Ulf Hansson <[email protected]>
Cc "David S. Miller" <[email protected]>
Cc Jakub Kicinski <[email protected]>
Cc Sebastian Reichel <[email protected]>
Cc Ohad Ben-Cohen <[email protected]>
Cc Bjorn Andersson <[email protected]>
Cc Greg Kroah-Hartman <[email protected]>

---
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]

---
 .../socionext,uniphier-system-cache.yaml      |  4 ++--
 .../bindings/ata/sata_highbank.yaml           |  1 +
 .../bindings/clock/canaan,k210-clk.yaml       |  1 +
 .../bindings/display/brcm,bcm2711-hdmi.yaml   |  1 +
 .../bindings/display/brcm,bcm2835-hdmi.yaml   |  1 +
 .../display/panel/jdi,lt070me05000.yaml       |  1 +
 .../display/panel/mantix,mlaf057we51-x.yaml   |  3 ++-
 .../display/panel/novatek,nt36672a.yaml       |  1 +
 .../devicetree/bindings/dsp/fsl,dsp.yaml      |  2 +-
 .../devicetree/bindings/eeprom/at25.yaml      |  3 +--
 .../bindings/extcon/extcon-ptn5150.yaml       |  2 ++
 .../bindings/gpio/gpio-pca95xx.yaml           |  1 +
 .../bindings/iio/adc/adi,ad7768-1.yaml        |  2 ++
 .../bindings/iio/adc/aspeed,ast2400-adc.yaml  |  1 +
 .../bindings/iio/adc/lltc,ltc2496.yaml        |  2 +-
 .../bindings/iio/adc/qcom,spmi-vadc.yaml      |  1 +
 .../bindings/iio/adc/st,stm32-adc.yaml        |  2 ++
 .../iio/magnetometer/asahi-kasei,ak8975.yaml  |  1 +
 .../iio/potentiometer/adi,ad5272.yaml         |  1 +
 .../input/touchscreen/elan,elants_i2c.yaml    |  1 +
 .../interrupt-controller/fsl,intmux.yaml      |  2 +-
 .../interrupt-controller/st,stm32-exti.yaml   |  2 ++
 .../allwinner,sun4i-a10-video-engine.yaml     |  1 +
 .../devicetree/bindings/media/i2c/imx219.yaml |  1 +
 .../memory-controllers/exynos-srom.yaml       |  2 ++
 .../bindings/misc/fsl,dpaa2-console.yaml      |  1 +
 .../bindings/mmc/mmc-controller.yaml          |  2 ++
 .../bindings/net/ti,k3-am654-cpsw-nuss.yaml   |  1 +
 .../bindings/net/ti,k3-am654-cpts.yaml        |  1 +
 .../phy/allwinner,sun4i-a10-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun50i-a64-usb-phy.yaml     |  2 ++
 .../phy/allwinner,sun50i-h6-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun5i-a13-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun6i-a31-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun8i-a23-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun8i-a83t-usb-phy.yaml     |  2 ++
 .../phy/allwinner,sun8i-h3-usb-phy.yaml       |  2 ++
 .../phy/allwinner,sun8i-r40-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun8i-v3s-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun9i-a80-usb-phy.yaml      | 19 ++++++++-----------
 .../phy/socionext,uniphier-ahci-phy.yaml      |  2 +-
 .../phy/socionext,uniphier-pcie-phy.yaml      |  2 +-
 .../phy/socionext,uniphier-usb3hs-phy.yaml    |  2 +-
 .../phy/socionext,uniphier-usb3ss-phy.yaml    |  2 +-
 .../bindings/phy/ti,phy-gmii-sel.yaml         |  2 +-
 .../pinctrl/aspeed,ast2400-pinctrl.yaml       |  3 +--
 .../pinctrl/aspeed,ast2500-pinctrl.yaml       |  4 ++--
 .../bindings/power/supply/bq25980.yaml        |  1 +
 .../bindings/remoteproc/ingenic,vpu.yaml      |  2 +-
 .../remoteproc/ti,omap-remoteproc.yaml        |  3 +++
 .../bindings/riscv/sifive-l2-cache.yaml       |  1 +
 .../bindings/serial/renesas,hscif.yaml        |  2 ++
 .../bindings/serial/renesas,scif.yaml         |  2 ++
 .../bindings/serial/renesas,scifa.yaml        |  2 ++
 .../bindings/serial/renesas,scifb.yaml        |  2 ++
 .../sound/allwinner,sun4i-a10-codec.yaml      |  1 +
 .../bindings/sound/google,sc7180-trogdor.yaml |  1 +
 .../bindings/sound/samsung,aries-wm8994.yaml  |  3 +++
 .../bindings/sound/samsung,midas-audio.yaml   |  2 ++
 .../devicetree/bindings/sound/tas2562.yaml    |  2 ++
 .../devicetree/bindings/sound/tas2770.yaml    |  2 ++
 .../bindings/sound/tlv320adcx140.yaml         |  1 +
 .../devicetree/bindings/spi/renesas,rspi.yaml |  2 ++
 .../devicetree/bindings/sram/sram.yaml        |  2 ++
 .../timer/allwinner,sun4i-a10-timer.yaml      |  2 ++
 .../bindings/timer/intel,ixp4xx-timer.yaml    |  2 +-
 .../usb/allwinner,sun4i-a10-musb.yaml         |  2 +-
 .../bindings/usb/brcm,usb-pinmap.yaml         |  3 +++
 .../devicetree/bindings/usb/generic-ehci.yaml |  1 +
 .../devicetree/bindings/usb/generic-ohci.yaml |  1 +
 .../devicetree/bindings/usb/ingenic,musb.yaml |  2 +-
 .../bindings/usb/renesas,usbhs.yaml           |  1 +
 .../devicetree/bindings/usb/ti,j721e-usb.yaml |  3 ++-
 .../bindings/usb/ti,keystone-dwc3.yaml        |  2 ++
 74 files changed, 118 insertions(+), 33 deletions(-)
Documentation/devicetree/bindings/arm/socionext/socionext,uniphier-system-cache.yaml +2 -2
index 2e765bb3e6f6..7ca5375f278f 100644
@@ -30,8 +30,8 @@ properties:
       Interrupts can be used to notify the completion of cache operations.
       The number of interrupts should match to the number of CPU cores.
       The specified interrupts correspond to CPU0, CPU1, ... in this order.
-      minItems: 1
-      maxItems: 4
+    minItems: 1
+    maxItems: 4
 
   cache-unified: true
 
Documentation/devicetree/bindings/ata/sata_highbank.yaml +1 -0
index 5e2a2394e600..ce75d77e9289 100644
@@ -61,6 +61,7 @@ properties:
     maxItems: 8
 
   calxeda,sgpio-gpio:
+    maxItems: 3
     description: |
       phandle-gpio bank, bit offset, and default on or off, which indicates
       that the driver supports SGPIO indicator lights using the indicated
Documentation/devicetree/bindings/clock/canaan,k210-clk.yaml +1 -0
index 565ca468cb44..7f5cf4001f76 100644
@@ -22,6 +22,7 @@ properties:
     const: canaan,k210-clk
 
   clocks:
+    maxItems: 1
     description:
       Phandle of the SoC 26MHz fixed-rate oscillator clock.
 
Documentation/devicetree/bindings/display/brcm,bcm2711-hdmi.yaml +1 -0
index 7ce06f9f9f8e..767edc0a7978 100644
@@ -60,6 +60,7 @@ properties:
       Phandle of the I2C controller used for DDC EDID probing
 
   hpd-gpios:
+    maxItems: 1
     description: >
       The GPIO pin for the HDMI hotplug detect (if it doesn't appear
       as an interrupt/status bit in the HDMI controller itself)
Documentation/devicetree/bindings/display/brcm,bcm2835-hdmi.yaml +1 -0
index f54b4e4808f0..031e35e76db2 100644
@@ -37,6 +37,7 @@ properties:
       Phandle of the I2C controller used for DDC EDID probing
 
   hpd-gpios:
+    maxItems: 1
     description: >
       The GPIO pin for the HDMI hotplug detect (if it doesn't appear
       as an interrupt/status bit in the HDMI controller itself)
Documentation/devicetree/bindings/display/panel/jdi,lt070me05000.yaml +1 -0
index b8b9435e464c..4f92365e888a 100644
@@ -30,6 +30,7 @@ properties:
       power supply for LCM (1.8V)
 
   dcdc-en-gpios:
+    maxItems: 1
     description: |
       phandle of the gpio for power ic line
       Power IC supply enable, High active
Documentation/devicetree/bindings/display/panel/mantix,mlaf057we51-x.yaml +2 -1
index 51f423297ec8..aa5a0dc391a4 100644
@@ -37,7 +37,8 @@ properties:
 
   reset-gpios: true
 
-  'mantix,tp-rstn-gpios':
+  mantix,tp-rstn-gpios:
+    maxItems: 1
     description: second reset line that triggers DSI config load
 
   backlight: true
Documentation/devicetree/bindings/display/panel/novatek,nt36672a.yaml +1 -0
index 2f5df1d235ae..ef4c0a24512d 100644
@@ -30,6 +30,7 @@ properties:
       panel. The novatek,nt36672a compatible shall always be provided as a fallback.
 
   reset-gpios:
+    maxItems: 1
     description: phandle of gpio for reset line - This should be 8mA, gpio
       can be configured using mux, pinctrl, pinctrl-names (active high)
 
Documentation/devicetree/bindings/dsp/fsl,dsp.yaml +1 -1
index 4cc011230153..7afc9f2be13a 100644
@@ -21,7 +21,7 @@ properties:
       - fsl,imx8mp-dsp
 
   reg:
-    description: Should contain register location and length
+    maxItems: 1
 
   clocks:
     items:
Documentation/devicetree/bindings/eeprom/at25.yaml +1 -2
index 121a601db22e..6a2dc8b3ed14 100644
@@ -39,8 +39,7 @@ properties:
           - const: atmel,at25
 
   reg:
-    description:
-      Chip select number.
+    maxItems: 1
 
   spi-max-frequency: true
 
Documentation/devicetree/bindings/extcon/extcon-ptn5150.yaml +2 -0
index 4b0f414486d2..d5cfa32ea52d 100644
@@ -19,6 +19,7 @@ properties:
     const: nxp,ptn5150
 
   int-gpios:
+    maxItems: 1
     deprecated: true
     description:
       GPIO pin (input) connected to the PTN5150's INTB pin.
@@ -31,6 +32,7 @@ properties:
     maxItems: 1
 
   vbus-gpios:
+    maxItems: 1
     description:
       GPIO pin (output) used to control VBUS. If skipped, no such control
       takes place.
Documentation/devicetree/bindings/gpio/gpio-pca95xx.yaml +1 -0
index f5ee23c2df60..57cdcfd4ff3c 100644
@@ -81,6 +81,7 @@ properties:
     const: 2
 
   reset-gpios:
+    maxItems: 1
     description:
       GPIO specification for the RESET input. This is an active low signal to
       the PCA953x.  Not valid for Maxim MAX732x devices.
Documentation/devicetree/bindings/iio/adc/adi,ad7768-1.yaml +2 -0
index 924477dfb833..a85a28145ef6 100644
@@ -40,6 +40,7 @@ properties:
       ADC reference voltage supply
 
   adi,sync-in-gpios:
+    maxItems: 1
     description:
       Enables synchronization of multiple devices that require simultaneous
       sampling. A pulse is always required if the configuration is changed
@@ -76,6 +77,7 @@ patternProperties:
 
     properties:
       reg:
+        maxItems: 1
         description: |
           The channel number.
 
Documentation/devicetree/bindings/iio/adc/aspeed,ast2400-adc.yaml +1 -0
index 7f534a933e92..a726b6c2ab65 100644
@@ -23,6 +23,7 @@ properties:
     maxItems: 1
 
   clocks:
+    maxItems: 1
     description:
       Input clock used to derive the sample clock. Expected to be the
       SoC's APB clock.
Documentation/devicetree/bindings/iio/adc/lltc,ltc2496.yaml +1 -1
index 2716d4e95329..0bd2fc0356c8 100644
@@ -20,7 +20,7 @@ properties:
     description: Power supply for the reference voltage
 
   reg:
-    description: spi chipselect number according to the usual spi bindings
+    maxItems: 1
 
   spi-max-frequency:
     description: maximal spi bus frequency supported
Documentation/devicetree/bindings/iio/adc/qcom,spmi-vadc.yaml +1 -0
index 95cc705b961b..74a4a9d95798 100644
@@ -68,6 +68,7 @@ patternProperties:
 
     properties:
       reg:
+        maxItems: 1
         description: |
           ADC channel number.
           See include/dt-bindings/iio/qcom,spmi-vadc.h
Documentation/devicetree/bindings/iio/adc/st,stm32-adc.yaml +2 -0
index 28417b31b558..6364ede9bb5f 100644
@@ -41,6 +41,8 @@ properties:
     maxItems: 2
 
   clocks:
+    minItems: 1
+    maxItems: 2
     description: |
       Core can use up to two clocks, depending on part used:
         - "adc" clock: for the analog circuitry, common to all ADCs.
Documentation/devicetree/bindings/iio/magnetometer/asahi-kasei,ak8975.yaml +1 -0
index a25590a16ba7..a0a1ffe017df 100644
@@ -47,6 +47,7 @@ properties:
     description: an optional 3x3 mounting rotation matrix.
 
   reset-gpios:
+    maxItems: 1
     description: |
       an optional pin needed for AK09911 to set the reset state. This should
       be usually active low
Documentation/devicetree/bindings/iio/potentiometer/adi,ad5272.yaml +1 -0
index 1aee9f9be951..0ebb6725a1af 100644
@@ -25,6 +25,7 @@ properties:
     maxItems: 1
 
   reset-gpios:
+    maxItems: 1
     description:
       Active low signal to the AD5272 RESET input.
 
Documentation/devicetree/bindings/input/touchscreen/elan,elants_i2c.yaml +1 -0
index a792d6377b1d..a9b53c2e6f0a 100644
@@ -29,6 +29,7 @@ properties:
     description: touchscreen can be used as a wakeup source.
 
   reset-gpios:
+    maxItems: 1
     description: reset gpio the chip is connected to.
 
   vcc33-supply:
Documentation/devicetree/bindings/interrupt-controller/fsl,intmux.yaml +1 -1
index 43c6effbb5bd..1d6e0f64a807 100644
@@ -31,7 +31,7 @@ properties:
       The 1st cell is hw interrupt number, the 2nd cell is channel index.
 
   clocks:
-    description: ipg clock.
+    maxItems: 1
 
   clock-names:
     const: ipg
Documentation/devicetree/bindings/interrupt-controller/st,stm32-exti.yaml +2 -0
index 2a5b29567926..6d3e68eb2e8b 100644
@@ -36,6 +36,8 @@ properties:
       Reference to a phandle of a hardware spinlock provider node.
 
   interrupts:
+    minItems: 1
+    maxItems: 96
     description:
       Interrupts references to primary interrupt controller
 
Documentation/devicetree/bindings/media/allwinner,sun4i-a10-video-engine.yaml +1 -0
index 2f7058f7760c..c34303b87a5b 100644
@@ -53,6 +53,7 @@ properties:
     maxItems: 1
 
   memory-region:
+    maxItems: 1
     description:
       CMA pool to use for buffers allocation instead of the default
       CMA pool.
Documentation/devicetree/bindings/media/i2c/imx219.yaml +1 -0
index dfc4d29a4f04..184d33bd3828 100644
@@ -40,6 +40,7 @@ properties:
       Digital core voltage supply, 1.2 volts
 
   reset-gpios:
+    maxItems: 1
     description: |-
       Reference to the GPIO connected to the xclr pin, if any.
       Must be released (set high) after all supplies are applied.
Documentation/devicetree/bindings/memory-controllers/exynos-srom.yaml +2 -0
index 637e24f0f73b..c6e44f47ce7c 100644
@@ -28,6 +28,8 @@ properties:
     const: 1
 
   ranges:
+    minItems: 1
+    maxItems: 4
     description: |
       Reflects the memory layout with four integer values per bank. Format:
       <bank-number> 0 <parent address of bank> <size>
Documentation/devicetree/bindings/misc/fsl,dpaa2-console.yaml +1 -0
index 271a3eafc054..8cc951feb7df 100644
@@ -15,6 +15,7 @@ properties:
     const: "fsl,dpaa2-console"
 
   reg:
+    maxItems: 1
     description: A standard property. Specifies the region where the MCFBA
                 (MC firmware base address) register can be found.
 
Documentation/devicetree/bindings/mmc/mmc-controller.yaml +2 -0
index 186f04ba9357..df4ee4c778ae 100644
@@ -40,6 +40,7 @@ properties:
       There is no card detection available; polling must be used.
 
   cd-gpios:
+    maxItems: 1
     description:
       The card detection will be done using the GPIO provided.
 
@@ -104,6 +105,7 @@ properties:
       line. Not used in combination with eMMC or SDIO.
 
   wp-gpios:
+    maxItems: 1
     description:
       GPIO to use for the write-protect detection.
 
Documentation/devicetree/bindings/net/ti,k3-am654-cpsw-nuss.yaml +1 -0
index c47b58f3e3f6..097c5cc6c853 100644
@@ -66,6 +66,7 @@ properties:
   dma-coherent: true
 
   clocks:
+    maxItems: 1
     description: CPSW2G NUSS functional clock
 
   clock-names:
Documentation/devicetree/bindings/net/ti,k3-am654-cpts.yaml +1 -0
index 9b7117920d90..2a42a27fb911 100644
@@ -59,6 +59,7 @@ properties:
       - const: cpts
 
   clocks:
+    maxItems: 1
     description: CPTS reference clock
 
   clock-names:
Documentation/devicetree/bindings/phy/allwinner,sun4i-a10-usb-phy.yaml +2 -0
index 94ac23687b7e..77606c899fe2 100644
@@ -51,9 +51,11 @@ properties:
       - const: usb2_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun50i-a64-usb-phy.yaml +2 -0
index fd6e126fcf18..078af52b16ed 100644
@@ -50,9 +50,11 @@ properties:
       - const: usb1_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun50i-h6-usb-phy.yaml +2 -0
index 7670411002c9..e632140722a2 100644
@@ -50,9 +50,11 @@ properties:
       - const: usb3_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun5i-a13-usb-phy.yaml +2 -0
index 9b319381d1ad..5bad9b06e2e7 100644
@@ -45,9 +45,11 @@ properties:
       - const: usb1_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun6i-a31-usb-phy.yaml +2 -0
index b0ed01bbf3db..922b4665e00d 100644
@@ -54,9 +54,11 @@ properties:
       - const: usb2_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun8i-a23-usb-phy.yaml +2 -0
index b0674406f8aa..a94019efc2f3 100644
@@ -50,9 +50,11 @@ properties:
       - const: usb1_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun8i-a83t-usb-phy.yaml +2 -0
index 48dc9c834a9b..33f3ddc0492d 100644
@@ -56,9 +56,11 @@ properties:
       - const: usb2_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun8i-h3-usb-phy.yaml +2 -0
index 60c344585276..f80431060803 100644
@@ -62,9 +62,11 @@ properties:
       - const: usb3_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun8i-r40-usb-phy.yaml +2 -0
index a2bb36790fbd..d947e50a49d2 100644
@@ -56,9 +56,11 @@ properties:
       - const: usb2_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun8i-v3s-usb-phy.yaml +2 -0
index eadfd0c9493c..a2836c296cc4 100644
@@ -42,9 +42,11 @@ properties:
     const: usb0_reset
 
   usb0_id_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG ID pin
 
   usb0_vbus_det-gpios:
+    maxItems: 1
     description: GPIO to the USB OTG VBUS detect pin
 
   usb0_vbus_power-supply:
Documentation/devicetree/bindings/phy/allwinner,sun9i-a80-usb-phy.yaml +8 -11
index ded7d6f0a119..2eb493fa64fd 100644
@@ -22,7 +22,8 @@ properties:
 
   clocks:
     anyOf:
-      - description: Main PHY Clock
+      - maxItems: 1
+        description: Main PHY Clock
 
       - items:
           - description: Main PHY clock
@@ -39,20 +40,16 @@ properties:
           - const: hsic_480M
 
   resets:
-    anyOf:
+    minItems: 1
+    items:
       - description: Normal USB PHY reset
-
-      - items:
-          - description: Normal USB PHY reset
-          - description: HSIC Reset
+      - description: HSIC Reset
 
   reset-names:
-    oneOf:
+    minItems: 1
+    items:
       - const: phy
-
-      - items:
-          - const: phy
-          - const: hsic
+      - const: hsic
 
   phy_type:
     const: hsic
Documentation/devicetree/bindings/phy/socionext,uniphier-ahci-phy.yaml +1 -1
index 34756347a14e..745c525ce6b9 100644
@@ -20,7 +20,7 @@ properties:
       - socionext,uniphier-pxs3-ahci-phy
 
   reg:
-    description: PHY register region (offset and length)
+    maxItems: 1
 
   "#phy-cells":
     const: 0
Documentation/devicetree/bindings/phy/socionext,uniphier-pcie-phy.yaml +1 -1
index a06831fd64b9..3e0566899041 100644
@@ -21,7 +21,7 @@ properties:
       - socionext,uniphier-pxs3-pcie-phy
 
   reg:
-    description: PHY register region (offset and length)
+    maxItems: 1
 
   "#phy-cells":
     const: 0
Documentation/devicetree/bindings/phy/socionext,uniphier-usb3hs-phy.yaml +1 -1
index 6fa5caab1487..a681cbc3b4ef 100644
@@ -24,7 +24,7 @@ properties:
       - socionext,uniphier-pxs3-usb3-hsphy
 
   reg:
-    description: PHY register region (offset and length)
+    maxItems: 1
 
   "#phy-cells":
     const: 0
Documentation/devicetree/bindings/phy/socionext,uniphier-usb3ss-phy.yaml +1 -1
index 9d46715ed036..41c0dd68ee25 100644
@@ -25,7 +25,7 @@ properties:
       - socionext,uniphier-pxs3-usb3-ssphy
 
   reg:
-    description: PHY register region (offset and length)
+    maxItems: 1
 
   "#phy-cells":
     const: 0
Documentation/devicetree/bindings/phy/ti,phy-gmii-sel.yaml +1 -1
index bcec422d7734..ff8a6d9eb153 100644
@@ -55,7 +55,7 @@ properties:
       - ti,am654-phy-gmii-sel
 
   reg:
-    description: Address and length of the register set for the device
+    maxItems: 1
 
   '#phy-cells': true
 
Documentation/devicetree/bindings/pinctrl/aspeed,ast2400-pinctrl.yaml +1 -2
index 54631dc1adb0..91be5720d094 100644
@@ -23,8 +23,7 @@ properties:
   compatible:
     const: aspeed,ast2400-pinctrl
   reg:
-    description: |
-      A hint for the memory regions associated with the pin-controller
+    maxItems: 2
 
 patternProperties:
   '^.*$':
Documentation/devicetree/bindings/pinctrl/aspeed,ast2500-pinctrl.yaml +2 -2
index a90c0fe0495f..40e9e8d4be5a 100644
@@ -24,8 +24,8 @@ properties:
   compatible:
     const: aspeed,ast2500-pinctrl
   reg:
-    description: |
-      A hint for the memory regions associated with the pin-controller
+    maxItems: 2
+
   aspeed,external-nodes:
     minItems: 2
     maxItems: 2
Documentation/devicetree/bindings/power/supply/bq25980.yaml +1 -0
index f6b3dd4093ca..06eca6667f67 100644
@@ -70,6 +70,7 @@ properties:
     description: Enables bypass mode at boot time
 
   interrupts:
+    maxItems: 1
     description: |
       Indicates that the device state has changed.
 
Documentation/devicetree/bindings/remoteproc/ingenic,vpu.yaml +1 -1
index c019f9fbe916..d0aa91bbf5e5 100644
@@ -44,7 +44,7 @@ properties:
       - const: vpu
 
   interrupts:
-    description: VPU hardware interrupt
+    maxItems: 1
 
 required:
   - compatible
Documentation/devicetree/bindings/remoteproc/ti,omap-remoteproc.yaml +3 -0
index 084960a8f17a..1a1159097a2a 100644
@@ -70,10 +70,13 @@ properties:
       the firmware image.
 
   clocks:
+    maxItems: 1
     description: |
       Main functional clock for the remote processor
 
   resets:
+    minItems: 1
+    maxItems: 2
     description: |
       Reset handles for the remote processor
 
Documentation/devicetree/bindings/riscv/sifive-l2-cache.yaml +1 -0
index efc0198eeb74..2ece8630dc68 100644
@@ -63,6 +63,7 @@ properties:
   next-level-cache: true
 
   memory-region:
+    maxItems: 1
     description: |
       The reference to the reserved-memory for the L2 Loosely Integrated Memory region.
       The reserved memory node should be defined as per the bindings in reserved-memory.txt.
Documentation/devicetree/bindings/serial/renesas,hscif.yaml +2 -0
index c139c5edb93e..69533347aa57 100644
@@ -81,6 +81,8 @@ properties:
     maxItems: 1
 
   dmas:
+    minItems: 2
+    maxItems: 4
     description:
       Must contain a list of pairs of references to DMA specifiers, one for
       transmission, and one for reception.
Documentation/devicetree/bindings/serial/renesas,scif.yaml +2 -0
index 672158906c33..22d76829f7ae 100644
@@ -120,6 +120,8 @@ properties:
     maxItems: 1
 
   dmas:
+    minItems: 2
+    maxItems: 4
     description:
       Must contain a list of pairs of references to DMA specifiers, one for
       transmission, and one for reception.
Documentation/devicetree/bindings/serial/renesas,scifa.yaml +2 -0
index dbffb9534835..3c67d3202e1b 100644
@@ -55,6 +55,8 @@ properties:
     maxItems: 1
 
   dmas:
+    minItems: 2
+    maxItems: 4
     description:
       Must contain a list of pairs of references to DMA specifiers, one for
       transmission, and one for reception.
Documentation/devicetree/bindings/serial/renesas,scifb.yaml +2 -0
index 147f8a37e02a..d5571c7a4424 100644
@@ -55,6 +55,8 @@ properties:
     maxItems: 1
 
   dmas:
+    minItems: 2
+    maxItems: 4
     description:
       Must contain a list of pairs of references to DMA specifiers, one for
       transmission, and one for reception.
Documentation/devicetree/bindings/sound/allwinner,sun4i-a10-codec.yaml +1 -0
index dd47fef9854d..559aff13ae23 100644
@@ -88,6 +88,7 @@ properties:
     description: Phandle to the codec analog controls in the PRCM
 
   allwinner,pa-gpios:
+    maxItems: 1
     description: GPIO to enable the external amplifier
 
 required:
Documentation/devicetree/bindings/sound/google,sc7180-trogdor.yaml +1 -0
index 5095b780e2c7..837e3faa63a9 100644
@@ -55,6 +55,7 @@ patternProperties:
         maxItems: 1
 
       reg:
+        maxItems: 1
         description: dai link address.
 
       cpu:
Documentation/devicetree/bindings/sound/samsung,aries-wm8994.yaml +3 -0
index 1c6947294825..5fff586dc802 100644
@@ -62,12 +62,15 @@ properties:
     description: Supply for the micbias on the headset mic
 
   earpath-sel-gpios:
+    maxItems: 1
     description: GPIO for switching between tv-out and mic paths
 
   headset-detect-gpios:
+    maxItems: 1
     description: GPIO for detection of headset insertion
 
   headset-key-gpios:
+    maxItems: 1
     description: GPIO for detection of headset key press
 
   io-channels:
Documentation/devicetree/bindings/sound/samsung,midas-audio.yaml +2 -0
index 578928e67e5c..095775c598fa 100644
@@ -53,9 +53,11 @@ properties:
     description: Supply for the micbias on the Sub microphone
 
   fm-sel-gpios:
+    maxItems: 1
     description: GPIO pin for FM selection
 
   lineout-sel-gpios:
+    maxItems: 1
     description: GPIO pin for line out selection
 
 required:
Documentation/devicetree/bindings/sound/tas2562.yaml +2 -0
index 27f7132ba2ef..acd4bbe69731 100644
@@ -36,10 +36,12 @@ properties:
        I2C address of the device can be one of these 0x4c, 0x4d, 0x4e or 0x4f
 
   shut-down-gpios:
+    maxItems: 1
     description: GPIO used to control the state of the device.
     deprecated: true
 
   shutdown-gpios:
+    maxItems: 1
     description: GPIO used to control the state of the device.
 
   interrupts:
Documentation/devicetree/bindings/sound/tas2770.yaml +2 -0
index 07e7f9951d2e..027bebf4e8cf 100644
@@ -27,9 +27,11 @@ properties:
        I2C address of the device can be between 0x41 to 0x48.
 
   reset-gpio:
+    maxItems: 1
     description: GPIO used to reset the device.
 
   shutdown-gpios:
+    maxItems: 1
     description: GPIO used to control the state of the device.
 
   interrupts:
Documentation/devicetree/bindings/sound/tlv320adcx140.yaml +1 -0
index df18be9d7b15..54d64785aad2 100644
@@ -35,6 +35,7 @@ properties:
       I2C addresss of the device can be one of these 0x4c, 0x4d, 0x4e or 0x4f
 
   reset-gpios:
+    maxItems: 1
     description: |
       GPIO used for hardware reset.
 
Documentation/devicetree/bindings/spi/renesas,rspi.yaml +2 -0
index 10e83cb17e8d..8397f60d80a2 100644
@@ -68,6 +68,8 @@ properties:
     maxItems: 1
 
   dmas:
+    minItems: 2
+    maxItems: 4
     description:
       Must contain a list of pairs of references to DMA specifiers, one for
       transmission, and one for reception.
Documentation/devicetree/bindings/sram/sram.yaml +2 -0
index 19d116ff9ddc..2a62bb204bbe 100644
@@ -35,6 +35,7 @@ properties:
     maxItems: 1
 
   clocks:
+    maxItems: 1
     description:
       A list of phandle and clock specifier pair that controls the single
       SRAM clock.
@@ -46,6 +47,7 @@ properties:
     const: 1
 
   ranges:
+    maxItems: 1
     description:
       Should translate from local addresses within the sram to bus addresses.
 
Documentation/devicetree/bindings/timer/allwinner,sun4i-a10-timer.yaml +2 -0
index d918cee100ac..1c7cf32e7ac2 100644
@@ -22,6 +22,8 @@ properties:
     maxItems: 1
 
   interrupts:
+    minItems: 2
+    maxItems: 6
     description:
       List of timers interrupts
 
Documentation/devicetree/bindings/timer/intel,ixp4xx-timer.yaml +1 -1
index 1a721d8af67a..a8de99b0c0f9 100644
@@ -18,7 +18,7 @@ properties:
       - const: intel,ixp4xx-timer
 
   reg:
-    description: Should contain registers location and length
+    maxItems: 1
 
   interrupts:
     minItems: 1
Documentation/devicetree/bindings/usb/allwinner,sun4i-a10-musb.yaml +1 -1
index d9207bf9d894..0f520f17735e 100644
@@ -39,7 +39,7 @@ properties:
     maxItems: 1
 
   phys:
-    description: PHY specifier for the OTG PHY
+    maxItems: 1
 
   phy-names:
     const: usb
Documentation/devicetree/bindings/usb/brcm,usb-pinmap.yaml +3 -0
index ffa148b9eaa8..d4618d15ecc1 100644
@@ -22,6 +22,8 @@ properties:
     description: Interrupt for signals mirrored to out-gpios.
 
   in-gpios:
+    minItems: 1
+    maxItems: 2
     description: Array of one or two GPIO pins used for input signals.
 
   brcm,in-functions:
@@ -33,6 +35,7 @@ properties:
     description: Array of enable and mask pairs, one per gpio in-gpios.
 
   out-gpios:
+    maxItems: 1
     description: Array of one GPIO pin used for output signals.
 
   brcm,out-functions:
Documentation/devicetree/bindings/usb/generic-ehci.yaml +1 -0
index 247ef00381ea..f76b25f7fc7a 100644
@@ -83,6 +83,7 @@ properties:
       Phandle of a companion.
 
   phys:
+    maxItems: 1
     description: PHY specifier for the USB PHY
 
   phy-names:
Documentation/devicetree/bindings/usb/generic-ohci.yaml +1 -0
index 2178bcc401bc..8e2bd61f2075 100644
@@ -71,6 +71,7 @@ properties:
       Overrides the detected port count
 
   phys:
+    maxItems: 1
     description: PHY specifier for the USB PHY
 
   phy-names:
Documentation/devicetree/bindings/usb/ingenic,musb.yaml +1 -1
index 678396eeeb78..f506225a4d57 100644
@@ -40,7 +40,7 @@ properties:
       - const: mc
 
   phys:
-    description: PHY specifier for the USB PHY
+    maxItems: 1
 
   usb-role-switch:
     type: boolean
Documentation/devicetree/bindings/usb/renesas,usbhs.yaml +1 -0
index 54c361d4a7af..e67223d90bb7 100644
@@ -68,6 +68,7 @@ properties:
       Integer to use BUSWAIT register.
 
   renesas,enable-gpio:
+    maxItems: 1
     description: |
       gpio specifier to check GPIO determining if USB function should be
       enabled.
Documentation/devicetree/bindings/usb/ti,j721e-usb.yaml +2 -1
index 388245b91a55..adce36e48bc9 100644
@@ -15,13 +15,14 @@ properties:
       - const: ti,j721e-usb
 
   reg:
-    description: module registers
+    maxItems: 1
 
   power-domains:
     description:
       PM domain provider node and an args specifier containing
       the USB device id value. See,
       Documentation/devicetree/bindings/soc/ti/sci-pm-domain.txt
+    maxItems: 1
 
   clocks:
     description: Clock phandles to usb2_refclk and lpm_clk
Documentation/devicetree/bindings/usb/ti,keystone-dwc3.yaml +2 -0
index c1b19fc5d0a2..91ef374faba8 100644
@@ -43,12 +43,14 @@ properties:
     maxItems: 2
 
   power-domains:
+    maxItems: 1
     description: Should contain a phandle to a PM domain provider node
       and an args specifier containing the USB device id
       value. This property is as per the binding,
       Documentation/devicetree/bindings/soc/ti/sci-pm-domain.txt
 
   phys:
+    maxItems: 1
     description:
       PHY specifier for the USB3.0 PHY. Some SoCs need the USB3.0 PHY
       to be turned on before the controller.
Signature · 7 lines
2.27.0


_______________________________________________
linux-arm-kernel mailing list
[email protected]
http://lists.infradead.org/mailman/listinfo/linux-arm-kernel
Reviewed-by
#8 lore raw
Quoted 128 lines · Mathieu Poirier

Adding Suman and Paul - guys please have a look.

Quoted 125 lines · Rob Herring

DT properties which can have multiple entries need to specify what the entries are and define how many entries there can be. In the case of only a single entry, just 'maxItems: 1' is sufficient.

Add the missing entry constraints. These were found with a modified meta-schema. Unfortunately, there are a few cases where the size constraints are not defined such as common bindings, so the meta-schema can't be part of the normal checks.

Cc Jens Axboe <[email protected]>
Cc Stephen Boyd <[email protected]>
Cc Thierry Reding <[email protected]>
Cc MyungJoo Ham <[email protected]>
Cc Chanwoo Choi <[email protected]>
Cc Linus Walleij <[email protected]>
Cc Bartosz Golaszewski <[email protected]>
Cc Jonathan Cameron <[email protected]>
Cc Dmitry Torokhov <[email protected]>
Cc Thomas Gleixner <[email protected]>
Cc Marc Zyngier <[email protected]>
Cc Mauro Carvalho Chehab <[email protected]>
Cc Chen-Yu Tsai <[email protected]>
Cc Ulf Hansson <[email protected]>
Cc "David S. Miller" <[email protected]>
Cc Jakub Kicinski <[email protected]>
Cc Sebastian Reichel <[email protected]>
Cc Ohad Ben-Cohen <[email protected]>
Cc Bjorn Andersson <[email protected]>
Cc Greg Kroah-Hartman <[email protected]>

---
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]

---
 .../socionext,uniphier-system-cache.yaml      |  4 ++--
 .../bindings/ata/sata_highbank.yaml           |  1 +
 .../bindings/clock/canaan,k210-clk.yaml       |  1 +
 .../bindings/display/brcm,bcm2711-hdmi.yaml   |  1 +
 .../bindings/display/brcm,bcm2835-hdmi.yaml   |  1 +
 .../display/panel/jdi,lt070me05000.yaml       |  1 +
 .../display/panel/mantix,mlaf057we51-x.yaml   |  3 ++-
 .../display/panel/novatek,nt36672a.yaml       |  1 +
 .../devicetree/bindings/dsp/fsl,dsp.yaml      |  2 +-
 .../devicetree/bindings/eeprom/at25.yaml      |  3 +--
 .../bindings/extcon/extcon-ptn5150.yaml       |  2 ++
 .../bindings/gpio/gpio-pca95xx.yaml           |  1 +
 .../bindings/iio/adc/adi,ad7768-1.yaml        |  2 ++
 .../bindings/iio/adc/aspeed,ast2400-adc.yaml  |  1 +
 .../bindings/iio/adc/lltc,ltc2496.yaml        |  2 +-
 .../bindings/iio/adc/qcom,spmi-vadc.yaml      |  1 +
 .../bindings/iio/adc/st,stm32-adc.yaml        |  2 ++
 .../iio/magnetometer/asahi-kasei,ak8975.yaml  |  1 +
 .../iio/potentiometer/adi,ad5272.yaml         |  1 +
 .../input/touchscreen/elan,elants_i2c.yaml    |  1 +
 .../interrupt-controller/fsl,intmux.yaml      |  2 +-
 .../interrupt-controller/st,stm32-exti.yaml   |  2 ++
 .../allwinner,sun4i-a10-video-engine.yaml     |  1 +
 .../devicetree/bindings/media/i2c/imx219.yaml |  1 +
 .../memory-controllers/exynos-srom.yaml       |  2 ++
 .../bindings/misc/fsl,dpaa2-console.yaml      |  1 +
 .../bindings/mmc/mmc-controller.yaml          |  2 ++
 .../bindings/net/ti,k3-am654-cpsw-nuss.yaml   |  1 +
 .../bindings/net/ti,k3-am654-cpts.yaml        |  1 +
 .../phy/allwinner,sun4i-a10-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun50i-a64-usb-phy.yaml     |  2 ++
 .../phy/allwinner,sun50i-h6-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun5i-a13-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun6i-a31-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun8i-a23-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun8i-a83t-usb-phy.yaml     |  2 ++
 .../phy/allwinner,sun8i-h3-usb-phy.yaml       |  2 ++
 .../phy/allwinner,sun8i-r40-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun8i-v3s-usb-phy.yaml      |  2 ++
 .../phy/allwinner,sun9i-a80-usb-phy.yaml      | 19 ++++++++-----------
 .../phy/socionext,uniphier-ahci-phy.yaml      |  2 +-
 .../phy/socionext,uniphier-pcie-phy.yaml      |  2 +-
 .../phy/socionext,uniphier-usb3hs-phy.yaml    |  2 +-
 .../phy/socionext,uniphier-usb3ss-phy.yaml    |  2 +-
 .../bindings/phy/ti,phy-gmii-sel.yaml         |  2 +-
 .../pinctrl/aspeed,ast2400-pinctrl.yaml       |  3 +--
 .../pinctrl/aspeed,ast2500-pinctrl.yaml       |  4 ++--
 .../bindings/power/supply/bq25980.yaml        |  1 +
 .../bindings/remoteproc/ingenic,vpu.yaml      |  2 +-
 .../remoteproc/ti,omap-remoteproc.yaml        |  3 +++
 .../bindings/riscv/sifive-l2-cache.yaml       |  1 +
 .../bindings/serial/renesas,hscif.yaml        |  2 ++
 .../bindings/serial/renesas,scif.yaml         |  2 ++
 .../bindings/serial/renesas,scifa.yaml        |  2 ++
 .../bindings/serial/renesas,scifb.yaml        |  2 ++
 .../sound/allwinner,sun4i-a10-codec.yaml      |  1 +
 .../bindings/sound/google,sc7180-trogdor.yaml |  1 +
 .../bindings/sound/samsung,aries-wm8994.yaml  |  3 +++
 .../bindings/sound/samsung,midas-audio.yaml   |  2 ++
 .../devicetree/bindings/sound/tas2562.yaml    |  2 ++
 .../devicetree/bindings/sound/tas2770.yaml    |  2 ++
 .../bindings/sound/tlv320adcx140.yaml         |  1 +
 .../devicetree/bindings/spi/renesas,rspi.yaml |  2 ++
 .../devicetree/bindings/sram/sram.yaml        |  2 ++
 .../timer/allwinner,sun4i-a10-timer.yaml      |  2 ++
 .../bindings/timer/intel,ixp4xx-timer.yaml    |  2 +-
 .../usb/allwinner,sun4i-a10-musb.yaml         |  2 +-
 .../bindings/usb/brcm,usb-pinmap.yaml         |  3 +++
 .../devicetree/bindings/usb/generic-ehci.yaml |  1 +
 .../devicetree/bindings/usb/generic-ohci.yaml |  1 +
 .../devicetree/bindings/usb/ingenic,musb.yaml |  2 +-
 .../bindings/usb/renesas,usbhs.yaml           |  1 +
 .../devicetree/bindings/usb/ti,j721e-usb.yaml |  3 ++-
 .../bindings/usb/ti,keystone-dwc3.yaml        |  2 ++
 74 files changed, 118 insertions(+), 33 deletions(-)

[snip]

Quoted 21 lines
Quoted 21 lines
Documentation/devicetree/bindings/remoteproc/ingenic,vpu.yaml +1 -1
index c019f9fbe916..d0aa91bbf5e5 100644
@@ -44,7 +44,7 @@ properties:
       - const: vpu
 
   interrupts:
-    description: VPU hardware interrupt
+    maxItems: 1
 
 required:
   - compatible
Documentation/devicetree/bindings/remoteproc/ti,omap-remoteproc.yaml +0 -0
index 084960a8f17a..1a1159097a2a 100644
@@ -70,10 +70,13 @@ properties:
       the firmware image.
 
Quoted 8 lines

Documentation/devicetree/bindings/remoteproc/ti,omap-remoteproc.yaml properties: · line 79

Quoted 8 lines
Documentation/devicetree/bindings/remoteproc/ti,omap-remoteproc.yaml +3 -0
   clocks:
+    maxItems: 1
     description: |
       Main functional clock for the remote processor
 
   resets:
+    minItems: 1
+    maxItems: 2

While this works for passing the schema, if we want to be specifically accurate between the different remoteprocs, the DSPs will have 1 items while the IPUs should have 2 items.

I can submit an incremental update if that's ok. Otherwise, for this file,

Quoted 3 lines

Documentation/devicetree/bindings/remoteproc/ti,omap-remoteproc.yaml properties: · line 82

Quoted 3 lines
Documentation/devicetree/bindings/remoteproc/ti,omap-remoteproc.yaml +0 -0
     description: |
       Reset handles for the remote processor
 

[snip]

regards
Suman

_______________________________________________
linux-riscv mailing list
[email protected]
http://lists.infradead.org/mailman/listinfo/linux-riscv

Acked-by
#9 lore raw
In reply to Mathieu Poirier

Hi,

Quoted 132 lines · Mathieu Poirier

Adding Suman and Paul - guys please have a look.

Quoted 129 lines · Rob Herring

DT properties which can have multiple entries need to specify what
the
entries are and define how many entries there can be. In the case of only a single entry, just 'maxItems: 1' is sufficient.

Add the missing entry constraints. These were found with a modified meta-schema. Unfortunately, there are a few cases where the size constraints are not defined such as common bindings, so the
meta-schema
can't be part of the normal checks.

Cc Jens Axboe <[email protected]>
Cc Stephen Boyd <[email protected]>
Cc Thierry Reding <[email protected]>
Cc MyungJoo Ham <[email protected]>
Cc Chanwoo Choi <[email protected]>
Cc Linus Walleij <[email protected]>
Cc Bartosz Golaszewski <[email protected]>
Cc Jonathan Cameron <[email protected]>
Cc Dmitry Torokhov <[email protected]>
Cc Thomas Gleixner <[email protected]>
Cc Marc Zyngier <[email protected]>
Cc Mauro Carvalho Chehab <[email protected]>
Cc Chen-Yu Tsai <[email protected]>
Cc Ulf Hansson <[email protected]>
Cc "David S. Miller" <[email protected]>
Cc Jakub Kicinski <[email protected]>
Cc Sebastian Reichel <[email protected]>
Cc Ohad Ben-Cohen <[email protected]>
Cc Bjorn Andersson <[email protected]>
Cc Greg Kroah-Hartman <[email protected]>

---
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]

---

  .../socionext,uniphier-system-cache.yaml      |  4 ++--
  .../bindings/ata/sata_highbank.yaml           |  1 +
  .../bindings/clock/canaan,k210-clk.yaml       |  1 +
  .../bindings/display/brcm,bcm2711-hdmi.yaml   |  1 +
  .../bindings/display/brcm,bcm2835-hdmi.yaml   |  1 +
  .../display/panel/jdi,lt070me05000.yaml       |  1 +
  .../display/panel/mantix,mlaf057we51-x.yaml   |  3 ++-
  .../display/panel/novatek,nt36672a.yaml       |  1 +
  .../devicetree/bindings/dsp/fsl,dsp.yaml      |  2 +-
  .../devicetree/bindings/eeprom/at25.yaml      |  3 +--
  .../bindings/extcon/extcon-ptn5150.yaml       |  2 ++
  .../bindings/gpio/gpio-pca95xx.yaml           |  1 +
  .../bindings/iio/adc/adi,ad7768-1.yaml        |  2 ++
  .../bindings/iio/adc/aspeed,ast2400-adc.yaml  |  1 +
  .../bindings/iio/adc/lltc,ltc2496.yaml        |  2 +-
  .../bindings/iio/adc/qcom,spmi-vadc.yaml      |  1 +
  .../bindings/iio/adc/st,stm32-adc.yaml        |  2 ++
  .../iio/magnetometer/asahi-kasei,ak8975.yaml  |  1 +
  .../iio/potentiometer/adi,ad5272.yaml         |  1 +
  .../input/touchscreen/elan,elants_i2c.yaml    |  1 +
  .../interrupt-controller/fsl,intmux.yaml      |  2 +-
  .../interrupt-controller/st,stm32-exti.yaml   |  2 ++
  .../allwinner,sun4i-a10-video-engine.yaml     |  1 +
  .../devicetree/bindings/media/i2c/imx219.yaml |  1 +
  .../memory-controllers/exynos-srom.yaml       |  2 ++
  .../bindings/misc/fsl,dpaa2-console.yaml      |  1 +
  .../bindings/mmc/mmc-controller.yaml          |  2 ++
  .../bindings/net/ti,k3-am654-cpsw-nuss.yaml   |  1 +
  .../bindings/net/ti,k3-am654-cpts.yaml        |  1 +
  .../phy/allwinner,sun4i-a10-usb-phy.yaml      |  2 ++
  .../phy/allwinner,sun50i-a64-usb-phy.yaml     |  2 ++
  .../phy/allwinner,sun50i-h6-usb-phy.yaml      |  2 ++
  .../phy/allwinner,sun5i-a13-usb-phy.yaml      |  2 ++
  .../phy/allwinner,sun6i-a31-usb-phy.yaml      |  2 ++
  .../phy/allwinner,sun8i-a23-usb-phy.yaml      |  2 ++
  .../phy/allwinner,sun8i-a83t-usb-phy.yaml     |  2 ++
  .../phy/allwinner,sun8i-h3-usb-phy.yaml       |  2 ++
  .../phy/allwinner,sun8i-r40-usb-phy.yaml      |  2 ++
  .../phy/allwinner,sun8i-v3s-usb-phy.yaml      |  2 ++
  .../phy/allwinner,sun9i-a80-usb-phy.yaml      | 19 
++++++++-----------
  .../phy/socionext,uniphier-ahci-phy.yaml      |  2 +-
  .../phy/socionext,uniphier-pcie-phy.yaml      |  2 +-
  .../phy/socionext,uniphier-usb3hs-phy.yaml    |  2 +-
  .../phy/socionext,uniphier-usb3ss-phy.yaml    |  2 +-
  .../bindings/phy/ti,phy-gmii-sel.yaml         |  2 +-
  .../pinctrl/aspeed,ast2400-pinctrl.yaml       |  3 +--
  .../pinctrl/aspeed,ast2500-pinctrl.yaml       |  4 ++--
  .../bindings/power/supply/bq25980.yaml        |  1 +
  .../bindings/remoteproc/ingenic,vpu.yaml      |  2 +-
  .../remoteproc/ti,omap-remoteproc.yaml        |  3 +++
  .../bindings/riscv/sifive-l2-cache.yaml       |  1 +
  .../bindings/serial/renesas,hscif.yaml        |  2 ++
  .../bindings/serial/renesas,scif.yaml         |  2 ++
  .../bindings/serial/renesas,scifa.yaml        |  2 ++
  .../bindings/serial/renesas,scifb.yaml        |  2 ++
  .../sound/allwinner,sun4i-a10-codec.yaml      |  1 +
  .../bindings/sound/google,sc7180-trogdor.yaml |  1 +
  .../bindings/sound/samsung,aries-wm8994.yaml  |  3 +++
  .../bindings/sound/samsung,midas-audio.yaml   |  2 ++
  .../devicetree/bindings/sound/tas2562.yaml    |  2 ++
  .../devicetree/bindings/sound/tas2770.yaml    |  2 ++
  .../bindings/sound/tlv320adcx140.yaml         |  1 +
  .../devicetree/bindings/spi/renesas,rspi.yaml |  2 ++
  .../devicetree/bindings/sram/sram.yaml        |  2 ++
  .../timer/allwinner,sun4i-a10-timer.yaml      |  2 ++
  .../bindings/timer/intel,ixp4xx-timer.yaml    |  2 +-
  .../usb/allwinner,sun4i-a10-musb.yaml         |  2 +-
  .../bindings/usb/brcm,usb-pinmap.yaml         |  3 +++
  .../devicetree/bindings/usb/generic-ehci.yaml |  1 +
  .../devicetree/bindings/usb/generic-ohci.yaml |  1 +
  .../devicetree/bindings/usb/ingenic,musb.yaml |  2 +-
  .../bindings/usb/renesas,usbhs.yaml           |  1 +
  .../devicetree/bindings/usb/ti,j721e-usb.yaml |  3 ++-
  .../bindings/usb/ti,keystone-dwc3.yaml        |  2 ++
  74 files changed, 118 insertions(+), 33 deletions(-)

For bindings/remoteproc/ingenic,vpu.yaml and devicetree/bindings/usb/ingenic,musb.yaml:

Cheers,
-Paul

_______________________________________________
linux-riscv mailing list
[email protected]
http://lists.infradead.org/mailman/listinfo/linux-riscv

Acked-by on v1 1/1
#11 lore raw
In reply to Rob Herring
Quoted 10 lines · Rob Herring

DT properties which can have multiple entries need to specify what the entries are and define how many entries there can be. In the case of only a single entry, just 'maxItems: 1' is sufficient.

Add the missing entry constraints. These were found with a modified meta-schema. Unfortunately, there are a few cases where the size constraints are not defined such as common bindings, so the meta-schema can't be part of the normal checks.

[snip!]

Quoted 1 line
 .../bindings/gpio/gpio-pca95xx.yaml           |  1 +

[snip!]

Documentation/devicetree/bindings/gpio/gpio-pca95xx.yaml properties: · line 87

Quoted 12 lines
Documentation/devicetree/bindings/gpio/gpio-pca95xx.yaml +1 -0
index f5ee23c2df60..57cdcfd4ff3c 100644
@@ -81,6 +81,7 @@ properties:
     const: 2
 
   reset-gpios:
+    maxItems: 1
     description:
       GPIO specification for the RESET input. This is an active low signal to
       the PCA953x.  Not valid for Maxim MAX732x devices.

_______________________________________________
linux-riscv mailing list
[email protected]
http://lists.infradead.org/mailman/listinfo/linux-riscv

Reviewed-by on v1 1/1
#12 lore raw
In reply to Rob Herring
Quoted 22 lines · Rob Herring

DT properties which can have multiple entries need to specify what the entries are and define how many entries there can be. In the case of only a single entry, just 'maxItems: 1' is sufficient.

Add the missing entry constraints. These were found with a modified meta-schema. Unfortunately, there are a few cases where the size constraints are not defined such as common bindings, so the meta-schema can't be part of the normal checks.

Cc Jens Axboe <[email protected]>
Cc Stephen Boyd <[email protected]>
Cc Thierry Reding <[email protected]>
Cc MyungJoo Ham <[email protected]>
Cc Chanwoo Choi <[email protected]>
Cc Linus Walleij <[email protected]>
Cc Bartosz Golaszewski <[email protected]>
Cc Jonathan Cameron <[email protected]>
Cc Dmitry Torokhov <[email protected]>
Cc Thomas Gleixner <[email protected]>
Cc Marc Zyngier <[email protected]>
Cc Mauro Carvalho Chehab <[email protected]>
Cc Chen-Yu Tsai <[email protected]>
Quoted 8 lines
Cc Ulf Hansson <[email protected]>
Cc "David S. Miller" <[email protected]>
Cc Jakub Kicinski <[email protected]>
Cc Sebastian Reichel <[email protected]>
Cc Ohad Ben-Cohen <[email protected]>
Cc Bjorn Andersson <[email protected]>
Cc Greg Kroah-Hartman <[email protected]>

This is good. The stricter the better.

Yours,
Linus Walleij
_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel