mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2025-01-06 05:06:29 +00:00
84e85359f4
The Devicetree bindings document does not have to say in the title that
it is a "binding", but instead just describe the hardware.
Drop trailing "bindings" in various forms (also with trailing full
stop):
find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
-not -name 'trivial-devices.yaml' \
-exec sed -i -e 's/^title: \(.*\) [bB]indings\?\.\?$/title: \1/' {} \;
Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Acked-by: Alexandre Belloni <alexandre.belloni@bootlin.com>
Acked-by: Matti Vaittinen <mazziesaccount@gmail.com> # ROHM
Acked-by: Ulf Hansson <ulf.hansson@linaro.org> # MMC
Acked-by: Stephen Boyd <sboyd@kernel.org> # clk
Acked-by: Dmitry Torokhov <dmitry.torokhov@gmail.com> # input
Acked-by: Mark Brown <broonie@kernel.org>
Acked-by: Hans Verkuil <hverkuil-cisco@xs4all.nl> # media
Acked-by: Sebastian Reichel <sre@kernel.org> # power
Acked-by: Viresh Kumar <viresh.kumar@linaro.org> # cpufreq
Link: https://lore.kernel.org/r/20221216163815.522628-7-krzysztof.kozlowski@linaro.org
Signed-off-by: Rob Herring <robh@kernel.org>
147 lines
3.3 KiB
YAML
147 lines
3.3 KiB
YAML
# SPDX-License-Identifier: GPL-2.0
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/mux/reg-mux.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Generic register bitfield-based multiplexer controller
|
|
|
|
maintainers:
|
|
- Peter Rosin <peda@axentia.se>
|
|
|
|
description: |+
|
|
Define register bitfields to be used to control multiplexers. The parent
|
|
device tree node must be a device node to provide register r/w access.
|
|
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- reg-mux # parent device of mux controller is not syscon device
|
|
- mmio-mux # parent device of mux controller is syscon device
|
|
|
|
reg: true
|
|
|
|
'#mux-control-cells':
|
|
const: 1
|
|
|
|
mux-reg-masks:
|
|
$ref: /schemas/types.yaml#/definitions/uint32-matrix
|
|
items:
|
|
items:
|
|
- description: register offset
|
|
- description: pre-shifted bitfield mask
|
|
description: Each entry pair describes a single mux control.
|
|
|
|
idle-states: true
|
|
|
|
required:
|
|
- compatible
|
|
- mux-reg-masks
|
|
- '#mux-control-cells'
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
/* The parent device of mux controller is not a syscon device. */
|
|
|
|
#include <dt-bindings/mux/mux.h>
|
|
|
|
mux-controller {
|
|
compatible = "reg-mux";
|
|
#mux-control-cells = <1>;
|
|
mux-reg-masks =
|
|
<0x54 0xf8>, /* 0: reg 0x54, bits 7:3 */
|
|
<0x54 0x07>; /* 1: reg 0x54, bits 2:0 */
|
|
};
|
|
|
|
mdio-mux-1 {
|
|
compatible = "mdio-mux-multiplexer";
|
|
mux-controls = <&mux1 0>;
|
|
mdio-parent-bus = <&emdio1>;
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
|
|
mdio@0 {
|
|
reg = <0x0>;
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
};
|
|
|
|
mdio@8 {
|
|
reg = <0x8>;
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
};
|
|
};
|
|
|
|
mdio-mux-2 {
|
|
compatible = "mdio-mux-multiplexer";
|
|
mux-controls = <&mux1 1>;
|
|
mdio-parent-bus = <&emdio2>;
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
|
|
mdio@0 {
|
|
reg = <0x0>;
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
};
|
|
|
|
mdio@1 {
|
|
reg = <0x1>;
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
};
|
|
};
|
|
|
|
- |
|
|
/* The parent device of mux controller is syscon device. */
|
|
|
|
#include <dt-bindings/mux/mux.h>
|
|
syscon@1000 {
|
|
reg = <0x1000 0x100>;
|
|
|
|
mux2: mux-controller {
|
|
compatible = "mmio-mux";
|
|
#mux-control-cells = <1>;
|
|
|
|
mux-reg-masks =
|
|
<0x3 0x30>, /* 0: reg 0x3, bits 5:4 */
|
|
<0x3 0x40>; /* 1: reg 0x3, bit 6 */
|
|
idle-states = <MUX_IDLE_AS_IS>, <0>;
|
|
};
|
|
};
|
|
|
|
video-mux {
|
|
compatible = "video-mux";
|
|
mux-controls = <&mux2 0>;
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
|
|
ports {
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
|
|
/* inputs 0..3 */
|
|
port@0 {
|
|
reg = <0>;
|
|
};
|
|
port@1 {
|
|
reg = <1>;
|
|
};
|
|
port@2 {
|
|
reg = <2>;
|
|
};
|
|
port@3 {
|
|
reg = <3>;
|
|
};
|
|
|
|
/* output */
|
|
port@4 {
|
|
reg = <4>;
|
|
};
|
|
};
|
|
};
|
|
...
|