mirror of
https://github.com/torvalds/linux.git
synced 2025-12-07 20:06:24 +00:00
0b2333183a
Generally at most 1 blank line is the standard style for DT schema files. Remove the few cases with more than 1 so that the yamllint check for this can be enabled. Acked-by: Lee Jones <lee@kernel.org> Reviewed-by: Mathieu Poirier <mathieu.poirier@linaro.org> # remoteproc Acked-by: Georgi Djakov <djakov@kernel.org> Acked-by: Vinod Koul <vkoul@kernel.org> Acked-by: Andi Shyti <andi.shyti@kernel.org> Acked-by: Bartosz Golaszewski <bartosz.golaszewski@linaro.org> Acked-by: Jonathan Cameron <jonathan.cameron@huawei.com> Acked-by: Philipp Zabel <p.zabel@pengutronix.de> Acked-by: Uwe Kleine-König <ukleinek@kernel.org> # for allwinner,sun4i-a10-pwm.yaml Reviewed-by: Miquel Raynal <miquel.raynal@bootlin.com> # mtd Acked-by: Guenter Roeck <linux@roeck-us.net> Acked-by: Mark Brown <broonie@kernel.org> Acked-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org> Acked-by: Sebastian Reichel <sebastian.reichel@collabora.com> Acked-by: Manivannan Sadhasivam <mani@kernel.org> # For PCI controller bindings Link: https://patch.msgid.link/20251023143957.2899600-1-robh@kernel.org Signed-off-by: Rob Herring (Arm) <robh@kernel.org>
123 lines
3.6 KiB
YAML
123 lines
3.6 KiB
YAML
# SPDX-License-Identifier: GPL-2.0
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/i2c/i2c-mux-gpmux.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: General Purpose I2C Bus Mux
|
|
|
|
maintainers:
|
|
- Peter Rosin <peda@axentia.se>
|
|
|
|
description: |+
|
|
This binding describes an I2C bus multiplexer that uses a mux controller
|
|
from the mux subsystem to route the I2C signals.
|
|
|
|
.-----. .-----.
|
|
| dev | | dev |
|
|
.------------. '-----' '-----'
|
|
| SoC | | |
|
|
| | .--------+--------'
|
|
| .------. | .------+ child bus A, on MUX value set to 0
|
|
| | I2C |-|--| Mux |
|
|
| '------' | '--+---+ child bus B, on MUX value set to 1
|
|
| .------. | | '----------+--------+--------.
|
|
| | MUX- | | | | | |
|
|
| | Ctrl |-|-----+ .-----. .-----. .-----.
|
|
| '------' | | dev | | dev | | dev |
|
|
'------------' '-----' '-----' '-----'
|
|
|
|
allOf:
|
|
- $ref: /schemas/i2c/i2c-mux.yaml#
|
|
|
|
properties:
|
|
compatible:
|
|
const: i2c-mux
|
|
|
|
i2c-parent:
|
|
$ref: /schemas/types.yaml#/definitions/phandle
|
|
description:
|
|
The phandle of the I2C bus that this multiplexer's master-side port is
|
|
connected to.
|
|
|
|
mux-controls:
|
|
maxItems: 1
|
|
description:
|
|
The mux-controller states are the I2C sub-bus numbers.
|
|
|
|
mux-locked:
|
|
type: boolean
|
|
description: |
|
|
Explicitly allow unrelated I2C transactions on the parent I2C adapter at
|
|
these times:
|
|
- during setup of the multiplexer
|
|
- between setup of the multiplexer and the child bus I2C transaction
|
|
- between the child bus I2C transaction and releasing of the multiplexer
|
|
- during releasing of the multiplexer
|
|
|
|
However, I2C transactions to devices behind all I2C multiplexers connected
|
|
to the same parent adapter that this multiplexer is connected to are blocked
|
|
for the full duration of the complete multiplexed I2C transaction (i.e.
|
|
including the times covered by the above list).
|
|
If mux-locked is not present, the multiplexer is assumed to be parent-locked.
|
|
This means that no unrelated I2C transactions are allowed on the parent I2C
|
|
adapter for the complete multiplexed I2C transaction.
|
|
The properties of mux-locked and parent-locked multiplexers are discussed
|
|
in more detail in Documentation/i2c/i2c-topology.rst.
|
|
|
|
required:
|
|
- compatible
|
|
- i2c-parent
|
|
- mux-controls
|
|
|
|
unevaluatedProperties: false
|
|
|
|
examples:
|
|
- |
|
|
#include <dt-bindings/gpio/gpio.h>
|
|
mux: mux-controller {
|
|
compatible = "gpio-mux";
|
|
#mux-control-cells = <0>;
|
|
|
|
mux-gpios = <&pioA 0 GPIO_ACTIVE_HIGH>,
|
|
<&pioA 1 GPIO_ACTIVE_HIGH>;
|
|
};
|
|
|
|
i2c-mux {
|
|
compatible = "i2c-mux";
|
|
mux-locked;
|
|
i2c-parent = <&i2c1>;
|
|
|
|
mux-controls = <&mux>;
|
|
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
|
|
i2c@1 {
|
|
reg = <1>;
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
|
|
gpio@20 {
|
|
compatible = "nxp,pca9555";
|
|
gpio-controller;
|
|
#gpio-cells = <2>;
|
|
reg = <0x20>;
|
|
};
|
|
};
|
|
|
|
i2c@3 {
|
|
reg = <3>;
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
|
|
gpio@20 {
|
|
compatible = "nxp,pca9555";
|
|
gpio-controller;
|
|
#gpio-cells = <2>;
|
|
reg = <0x20>;
|
|
};
|
|
};
|
|
};
|
|
...
|