mirror of
https://github.com/raspberrypi/linux.git
synced 2025-12-27 04:22:58 +00:00
6fdc6e23a7
This doesn't yet do anything in the tools, but make it explicit so we can check either 'unevaluatedProperties' or 'additionalProperties' is present in schemas. 'unevaluatedProperties' is appropriate when including another schema (via '$ref') and all possible properties and/or child nodes are not explicitly listed in the schema with the '$ref'. This is in preparation to add a meta-schema to check for missing 'unevaluatedProperties' or 'additionalProperties'. This has been a constant source of review issues. Acked-by: Mark Brown <broonie@kernel.org> Acked-by: Wolfram Sang <wsa@kernel.org> Acked-by: Krzysztof Kozlowski <krzk@kernel.org> Acked-By: Vinod Koul <vkoul@kernel.org> Acked-by: Geert Uytterhoeven <geert+renesas@glider.be> Acked-by: Ulf Hansson <ulf.hansson@linaro.org> Acked-by: Guenter Roeck <linux@roeck-us.net> Acked-by: Mathieu Poirier <mathieu.poirier@linaro.org> Acked-by: Dmitry Torokhov <dmitry.torokhov@gmail.com> Link: https://lore.kernel.org/r/20201005183830.486085-2-robh@kernel.org Signed-off-by: Rob Herring <robh@kernel.org>
76 lines
2.0 KiB
YAML
76 lines
2.0 KiB
YAML
# SPDX-License-Identifier: GPL-2.0
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/i2c/i2c-gpio.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Bindings for GPIO bitbanged I2C
|
|
|
|
maintainers:
|
|
- Wolfram Sang <wolfram@the-dreams.de>
|
|
|
|
allOf:
|
|
- $ref: /schemas/i2c/i2c-controller.yaml#
|
|
|
|
properties:
|
|
compatible:
|
|
items:
|
|
- const: i2c-gpio
|
|
|
|
sda-gpios:
|
|
description:
|
|
gpio used for the sda signal, this should be flagged as
|
|
active high using open drain with (GPIO_ACTIVE_HIGH|GPIO_OPEN_DRAIN)
|
|
from <dt-bindings/gpio/gpio.h> since the signal is by definition
|
|
open drain.
|
|
maxItems: 1
|
|
|
|
scl-gpios:
|
|
description:
|
|
gpio used for the scl signal, this should be flagged as
|
|
active high using open drain with (GPIO_ACTIVE_HIGH|GPIO_OPEN_DRAIN)
|
|
from <dt-bindings/gpio/gpio.h> since the signal is by definition
|
|
open drain.
|
|
maxItems: 1
|
|
|
|
i2c-gpio,scl-output-only:
|
|
description: scl as output only
|
|
type: boolean
|
|
|
|
i2c-gpio,delay-us:
|
|
description: delay between GPIO operations (may depend on each platform)
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
|
|
i2c-gpio,timeout-ms:
|
|
description: timeout to get data
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
|
|
# Deprecated properties, do not use in new device tree sources:
|
|
gpios:
|
|
minItems: 2
|
|
maxItems: 2
|
|
description: sda and scl gpio, alternative for {sda,scl}-gpios
|
|
|
|
i2c-gpio,sda-open-drain:
|
|
type: boolean
|
|
deprecated: true
|
|
description: this means that something outside of our control has put
|
|
the GPIO line used for SDA into open drain mode, and that something is
|
|
not the GPIO chip. It is essentially an inconsistency flag.
|
|
|
|
i2c-gpio,scl-open-drain:
|
|
type: boolean
|
|
deprecated: true
|
|
description: this means that something outside of our control has put the
|
|
GPIO line used for SCL into open drain mode, and that something is not
|
|
the GPIO chip. It is essentially an inconsistency flag.
|
|
|
|
required:
|
|
- compatible
|
|
- sda-gpios
|
|
- scl-gpios
|
|
|
|
unevaluatedProperties: false
|
|
|
|
...
|