Bjorn Helgaas
47aab53331
dt-bindings: Fix typos
...
Fix typos in Documentation/devicetree/bindings. The changes are in
descriptions or comments where they shouldn't affect functionality.
Signed-off-by: Bjorn Helgaas <bhelgaas@google.com >
Link: https://lore.kernel.org/r/20230814212822.193684-3-helgaas@kernel.org
Signed-off-by: Rob Herring <robh@kernel.org >
2023-08-18 11:32:25 -05:00
Marek Vasut
b3eec3e667
ASoC: st,stm32-sai: Document audio OF graph port
...
It is expected that the SAI subnodes would contain audio OF graph port
with endpoint to link it with the other side of audio link. Document
the port: property.
Signed-off-by: Marek Vasut <marex@denx.de >
Reviewed-by: Olivier Moysan <olivier.moysan@foss.st.com >
Link: https://lore.kernel.org/r/20220927002004.685108-1-marex@denx.de
Signed-off-by: Mark Brown <broonie@kernel.org >
2022-09-27 12:08:01 +01:00
Rob Herring
9e10a1ded6
ASoC: dt-bindings: Add missing (unevaluated|additional)Properties on child nodes
...
In order to ensure only documented properties are present, node schemas
must have unevaluatedProperties or additionalProperties set to false
(typically).
Signed-off-by: Rob Herring <robh@kernel.org >
Link: https://lore.kernel.org/r/20220823145649.3118479-8-robh@kernel.org
Signed-off-by: Mark Brown <broonie@kernel.org >
2022-08-23 19:52:40 +01:00
Rob Herring
27e4a85cf7
dt-bindings: Fix incomplete if/then/else schemas
...
A recent review highlighted that the json-schema meta-schema allows any
combination of if/then/else schema keywords even though if, then or else
by themselves makes little sense. With an added meta-schema to only
allow valid combinations, there's a handful of schemas found which need
fixing in a variety of ways. Incorrect indentation is the most common
issue.
Cc: Lars-Peter Clausen <lars@metafoo.de >
Cc: Michael Hennerich <Michael.Hennerich@analog.com >
Cc: Jonathan Cameron <jic23@kernel.org >
Cc: Krzysztof Kozlowski <krzk+dt@kernel.org >
Cc: Olivier Moysan <olivier.moysan@foss.st.com >
Cc: Arnaud Pouliquen <arnaud.pouliquen@foss.st.com >
Cc: Bjorn Andersson <bjorn.andersson@linaro.org >
Cc: Georgi Djakov <djakov@kernel.org >
Cc: Ulf Hansson <ulf.hansson@linaro.org >
Cc: Thierry Reding <thierry.reding@gmail.com >
Cc: Jonathan Hunter <jonathanh@nvidia.com >
Cc: "David S. Miller" <davem@davemloft.net >
Cc: Jakub Kicinski <kuba@kernel.org >
Cc: Paolo Abeni <pabeni@redhat.com >
Cc: Kishon Vijay Abraham I <kishon@ti.com >
Cc: Vinod Koul <vkoul@kernel.org >
Cc: Mark Brown <broonie@kernel.org >
Cc: Fabrice Gasnier <fabrice.gasnier@foss.st.com >
Cc: Grygorii Strashko <grygorii.strashko@ti.com >
Cc: Dmitry Osipenko <digetx@gmail.com >
Cc: linux-iio@vger.kernel.org
Cc: alsa-devel@alsa-project.org
Cc: linux-mmc@vger.kernel.org
Cc: linux-tegra@vger.kernel.org
Cc: netdev@vger.kernel.org
Cc: linux-phy@lists.infradead.org
Signed-off-by: Rob Herring <robh@kernel.org >
Acked-by: Jakub Kicinski <kuba@kernel.org >
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org >
Acked-by: Mark Brown <broonie@kernel.org >
Link: https://lore.kernel.org/r/20220330145741.3044896-1-robh@kernel.org
2022-04-04 14:20:09 -05:00
Rob Herring
dca669354e
dt-bindings: Another pass removing cases of 'allOf' containing a '$ref'
...
Another pass at removing unnecessary use of 'allOf' with a '$ref'.
json-schema versions draft7 and earlier have a weird behavior in that
any keywords combined with a '$ref' are ignored (silently). The correct
form was to put a '$ref' under an 'allOf'. This behavior is now changed
in the 2019-09 json-schema spec and '$ref' can be mixed with other
keywords.
Cc: Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com >
Cc: Thierry Reding <thierry.reding@gmail.com >
Cc: Sam Ravnborg <sam@ravnborg.org >
Cc: Dmitry Torokhov <dmitry.torokhov@gmail.com >
Cc: Pavel Machek <pavel@ucw.cz >
Cc: Guenter Roeck <groeck@chromium.org >
Cc: Richard Weinberger <richard@nod.at >
Cc: Vignesh Raghavendra <vigneshr@ti.com >
Cc: "David S. Miller" <davem@davemloft.net >
Cc: Kishon Vijay Abraham I <kishon@ti.com >
Cc: Sebastian Reichel <sre@kernel.org >
Cc: Mathieu Poirier <mathieu.poirier@linaro.org >
Signed-off-by: Rob Herring <robh@kernel.org >
Acked-by: Mark Brown <broonie@kernel.org >
Reviewed-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org >
Acked-By: Vinod Koul <vkoul@kernel.org >
Acked-by: Lee Jones <lee.jones@linaro.org >
Acked-by: Marek Behún <kabel@kernel.org >
Acked-by: Miquel Raynal <miquel.raynal@bootlin.com >
Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com >
Acked-by: Jakub Kicinski <kuba@kernel.org >
Acked-by: Bjorn Andersson <bjorn.andersson@linaro.org >
Link: https://lore.kernel.org/r/20220228213802.1639658-1-robh@kernel.org
2022-03-02 14:02:57 -06:00
Rob Herring
39bd2b6a37
dt-bindings: Improve phandle-array schemas
...
The 'phandle-array' type is a bit ambiguous. It can be either just an
array of phandles or an array of phandles plus args. Many schemas for
phandle-array properties aren't clear in the schema which case applies
though the description usually describes it.
The array of phandles case boils down to needing:
items:
maxItems: 1
The phandle plus args cases should typically take this form:
items:
- items:
- description: A phandle
- description: 1st arg cell
- description: 2nd arg cell
With this change, some examples need updating so that the bracketing of
property values matches the schema.
Signed-off-by: Rob Herring <robh@kernel.org >
Acked-by: Viresh Kumar <viresh.kumar@linaro.org >
Acked-by: Vinod Koul <vkoul@kernel.org >
Acked-by: Ulf Hansson <ulf.hansson@linaro.org >
Acked-by: Georgi Djakov <djakov@kernel.org >
Reviewed-by: Geert Uytterhoeven <geert+renesas@glider.be >
Acked-by: Mark Brown <broonie@kernel.org >
Acked-by: Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com >
Acked-by: Stephen Boyd <sboyd@kernel.org >
Acked-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org >
Acked-by: Marc Kleine-Budde <mkl@pengutronix.de >
Link: https://lore.kernel.org/r/20220119015038.2433585-1-robh@kernel.org
2022-02-04 09:43:42 -06:00
Patrice Chotard
f4eedebdbf
dt-bindings: treewide: Update @st.com email address to @foss.st.com
...
Not all @st.com email address are concerned, only people who have
a specific @foss.st.com email will see their entry updated.
For some people, who left the company, remove their email.
Cc: Alexandre Torgue <alexandre.torgue@foss.st.com >
Cc: Arnaud Pouliquen <arnaud.pouliquen@foss.st.com >
Cc: Fabien Dessenne <fabien.dessenne@foss.st.com >
Cc: Christophe Roullier <christophe.roullier@foss.st.com >
Cc: Gabriel Fernandez <gabriel.fernandez@foss.st.com >
Cc: Lionel Debieve <lionel.debieve@foss.st.com >
Cc: Amelie Delaunay <amelie.delaunay@foss.st.com >
Cc: Pierre-Yves MORDRET <pierre-yves.mordret@foss.st.com >
Cc: Ludovic Barre <ludovic.barre@foss.st.com >
Cc: Christophe Kerello <christophe.kerello@foss.st.com >
Cc: pascal Paillet <p.paillet@foss.st.com >
Cc: Erwan Le Ray <erwan.leray@foss.st.com >
Cc: Philippe CORNU <philippe.cornu@foss.st.com >
Cc: Yannick Fertre <yannick.fertre@foss.st.com >
Cc: Fabrice Gasnier <fabrice.gasnier@foss.st.com >
Cc: Olivier Moysan <olivier.moysan@foss.st.com >
Cc: Hugues Fruchet <hugues.fruchet@foss.st.com >
Signed-off-by: Patrice Chotard <patrice.chotard@foss.st.com >
Reviewed-by: Mathieu Poirier <mathieu.poirier@linaro.org >
Acked-by: Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com >
Acked-by: Mark Brown <broonie@kernel.org >
Acked-by: Lee Jones <lee.jones@linaro.org >
Acked-By: Vinod Koul <vkoul@kernel.org >
Acked-by: Miquel Raynal <miquel.raynal@bootlin.com >
Link: https://lore.kernel.org/r/20211110150144.18272-6-patrice.chotard@foss.st.com
Signed-off-by: Rob Herring <robh@kernel.org >
2021-11-11 22:27:16 -06:00
Rob Herring
61aaaa8110
dt-bindings: Remove "status" from schema examples
...
There's no reason to have "status" properties in examples. "okay" is the
default, and "disabled" turns off some schema checks ('required'
specifically).
Enabling qca,ar71xx causes a warning, so let's fix the node names:
Documentation/devicetree/bindings/net/qca,ar71xx.example.dt.yaml: phy@3: '#phy-cells' is a required property
From schema: schemas/phy/phy-provider.yaml
Cc: Maxime Ripard <mripard@kernel.org >
Cc: Chen-Yu Tsai <wens@csie.org >
Cc: Thierry Reding <thierry.reding@gmail.com >
Cc: Sam Ravnborg <sam@ravnborg.org >
Cc: "David S. Miller" <davem@davemloft.net >
Cc: Jakub Kicinski <kuba@kernel.org >
Cc: Robert Marko <robert.marko@sartura.hr >
Cc: Alessandro Zummo <a.zummo@towertech.it >
Cc: Ramesh Shanmugasundaram <rashanmu@gmail.com >
Cc: "G. Jaya Kumaran" <vineetha.g.jaya.kumaran@intel.com >
Cc: ChiYuan Huang <cy_huang@richtek.com >
Cc: Wei Xu <xuwei5@hisilicon.com >
Cc: Dilip Kota <eswara.kota@linux.intel.com >
Cc: Karol Gugala <kgugala@antmicro.com >
Cc: Mateusz Holenko <mholenko@antmicro.com >
Cc: Olivier Moysan <olivier.moysan@st.com >
Cc: Peter Ujfalusi <peter.ujfalusi@ti.com >
Cc: dri-devel@lists.freedesktop.org
Cc: linux-media@vger.kernel.org
Cc: netdev@vger.kernel.org
Cc: linux-rtc@vger.kernel.org
Cc: alsa-devel@alsa-project.org
Signed-off-by: Rob Herring <robh@kernel.org >
Reviewed-by: Rui Miguel Silva <rmfrfs@gmail.com >
Reviewed-by: Linus Walleij <linus.walleij@linaro.org >
Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com >
Reviewed-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org > # For media
Acked-by: Mark Brown <broonie@kernel.org >
Acked-by: Alexandre Belloni <alexandre.belloni@bootlin.com >
Reviewed-by: Oleksij Rempel <o.rempel@pengutronix.de >
Reviewed-by: Philipp Zabel <p.zabel@pengutronix.de >
Link: https://lore.kernel.org/r/20210720172025.363238-1-robh@kernel.org
2021-07-27 08:03:12 -06:00
Rob Herring
972d6a7dce
dt-bindings: Drop redundant minItems/maxItems
...
If a property has an 'items' list, then a 'minItems' or 'maxItems' with the
same size as the list is redundant and can be dropped. Note that is DT
schema specific behavior and not standard json-schema behavior. The tooling
will fixup the final schema adding any unspecified minItems/maxItems.
This condition is partially checked with the meta-schema already, but
only if both 'minItems' and 'maxItems' are equal to the 'items' length.
An improved meta-schema is pending.
Cc: Jens Axboe <axboe@kernel.dk >
Cc: Stephen Boyd <sboyd@kernel.org >
Cc: Herbert Xu <herbert@gondor.apana.org.au >
Cc: "David S. Miller" <davem@davemloft.net >
Cc: David Airlie <airlied@linux.ie >
Cc: Daniel Vetter <daniel@ffwll.ch >
Cc: Bartosz Golaszewski <bgolaszewski@baylibre.com >
Cc: Kamal Dasu <kdasu.kdev@gmail.com >
Cc: Lars-Peter Clausen <lars@metafoo.de >
Cc: Thomas Gleixner <tglx@linutronix.de >
Cc: Marc Zyngier <maz@kernel.org >
Cc: Joerg Roedel <joro@8bytes.org >
Cc: Mauro Carvalho Chehab <mchehab@kernel.org >
Cc: Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com >
Cc: Jakub Kicinski <kuba@kernel.org >
Cc: Wolfgang Grandegger <wg@grandegger.com >
Cc: Andrew Lunn <andrew@lunn.ch >
Cc: Vivien Didelot <vivien.didelot@gmail.com >
Cc: Vladimir Oltean <olteanv@gmail.com >
Cc: Bjorn Helgaas <bhelgaas@google.com >
Cc: Kishon Vijay Abraham I <kishon@ti.com >
Cc: Linus Walleij <linus.walleij@linaro.org >
Cc: "Uwe Kleine-König" <u.kleine-koenig@pengutronix.de >
Cc: Lee Jones <lee.jones@linaro.org >
Cc: Ohad Ben-Cohen <ohad@wizery.com >
Cc: Mathieu Poirier <mathieu.poirier@linaro.org >
Cc: Paul Walmsley <paul.walmsley@sifive.com >
Cc: Palmer Dabbelt <palmer@dabbelt.com >
Cc: Albert Ou <aou@eecs.berkeley.edu >
Cc: Alessandro Zummo <a.zummo@towertech.it >
Cc: Alexandre Belloni <alexandre.belloni@bootlin.com >
Cc: Zhang Rui <rui.zhang@intel.com >
Cc: Daniel Lezcano <daniel.lezcano@linaro.org >
Cc: Wim Van Sebroeck <wim@linux-watchdog.org >
Cc: Guenter Roeck <linux@roeck-us.net >
Signed-off-by: Rob Herring <robh@kernel.org >
Acked-by: Marc Kleine-Budde <mkl@pengutronix.de >
Acked-by: Ulf Hansson <ulf.hansson@linaro.org > # for MMC
Acked-by: Jassi Brar <jassisinghbrar@gmail.com >
Acked-By: Vinod Koul <vkoul@kernel.org >
Reviewed-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org >
Reviewed-by: Arnaud Pouliquen <arnaud.pouliquen@st.com >
Acked-by: Mark Brown <broonie@kernel.org >
Acked-by: Philipp Zabel <p.zabel@pengutronix.de >
Acked-by: Wolfram Sang <wsa@kernel.org > # for I2C
Acked-by: Jonathan Cameron <Jonathan.Cameron@huawei.com >
Link: https://lore.kernel.org/r/20210615191543.1043414-1-robh@kernel.org
2021-06-21 13:56:46 -06:00
Rob Herring
d69c6ddd01
dt-bindings: Fix JSON pointers
...
The correct syntax for JSON pointers begins with a '/' after the '#'.
Without a '/', the string should be interpreted as a subschema
identifier. The jsonschema module currently doesn't handle subschema
identifiers and incorrectly allows JSON pointers to begin without a '/'.
Let's fix this before it becomes a problem when jsonschema module is
fixed.
Converted with:
perl -p -i -e 's/yaml#definitions/yaml#\/definitions/g' `find Documentation/devicetree/bindings/ -name "*.yaml"`
Cc: Maxime Ripard <mripard@kernel.org >
Cc: Jonathan Cameron <jic23@kernel.org >
Cc: Lars-Peter Clausen <lars@metafoo.de >
Cc: Daniel Thompson <daniel.thompson@linaro.org >
Cc: Jingoo Han <jingoohan1@gmail.com >
Cc: Pavel Machek <pavel@ucw.cz >
Cc: "David S. Miller" <davem@davemloft.net >
Cc: Jakub Kicinski <kuba@kernel.org >
Cc: Andrew Lunn <andrew@lunn.ch >
Cc: Florian Fainelli <f.fainelli@gmail.com >
Cc: Greg Kroah-Hartman <gregkh@linuxfoundation.org >
Cc: Mark Brown <broonie@kernel.org >
Cc: netdev@vger.kernel.org
Acked-By: Vinod Koul <vkoul@kernel.org >
Acked-by: Lee Jones <lee.jones@linaro.org >
Acked-by: Guenter Roeck <linux@roeck-us.net >
Acked-by: Sebastian Reichel <sre@kernel.org >
Acked-by: Florian Fainelli <f.fainelli@gmail.com >
Acked-by: Mark Brown <broonie@kernel.org >
Acked-by: Jakub Kicinski <kuba@kernel.org >
Link: https://lore.kernel.org/r/20201217223429.354283-1-robh@kernel.org
Signed-off-by: Rob Herring <robh@kernel.org >
2020-12-18 15:14:44 -06:00
Olivier Moysan
49491418c1
ASoC: dt-bindings: stm32: convert sai to json-schema
...
Convert the STM32 SAI bindings to DT schema format using json-schema.
Signed-off-by: Olivier Moysan <olivier.moysan@st.com >
Reviewed-by: Rob Herring <robh@kernel.org >
Link: https://lore.kernel.org/r/20201009141051.27365-1-olivier.moysan@st.com
Signed-off-by: Mark Brown <broonie@kernel.org >
2020-10-26 18:37:04 +00:00