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>
93 lines
2.1 KiB
YAML
93 lines
2.1 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/net/mctp-i2c-controller.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: MCTP I2C transport
|
|
|
|
maintainers:
|
|
- Matt Johnston <matt@codeconstruct.com.au>
|
|
|
|
description: |
|
|
An mctp-i2c-controller defines a local MCTP endpoint on an I2C controller.
|
|
MCTP I2C is specified by DMTF DSP0237.
|
|
|
|
An mctp-i2c-controller must be attached to an I2C adapter which supports
|
|
slave functionality. I2C busses (either directly or as subordinate mux
|
|
busses) are attached to the mctp-i2c-controller with a 'mctp-controller'
|
|
property on each used bus. Each mctp-controller I2C bus will be presented
|
|
to the host system as a separate MCTP I2C instance.
|
|
|
|
properties:
|
|
compatible:
|
|
const: mctp-i2c-controller
|
|
|
|
reg:
|
|
minimum: 0x40000000
|
|
maximum: 0x4000007f
|
|
description: |
|
|
7 bit I2C address of the local endpoint.
|
|
I2C_OWN_SLAVE_ADDRESS (1<<30) flag must be set.
|
|
|
|
additionalProperties: false
|
|
|
|
required:
|
|
- compatible
|
|
- reg
|
|
|
|
examples:
|
|
- |
|
|
// Basic case of a single I2C bus
|
|
#include <dt-bindings/i2c/i2c.h>
|
|
|
|
i2c {
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
mctp-controller;
|
|
|
|
mctp@30 {
|
|
compatible = "mctp-i2c-controller";
|
|
reg = <(0x30 | I2C_OWN_SLAVE_ADDRESS)>;
|
|
};
|
|
};
|
|
|
|
- |
|
|
// Mux topology with multiple MCTP-handling busses under
|
|
// a single mctp-i2c-controller.
|
|
// i2c1 and i2c6 can have MCTP devices, i2c5 does not.
|
|
#include <dt-bindings/i2c/i2c.h>
|
|
|
|
i2c1: i2c {
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
mctp-controller;
|
|
|
|
mctp@50 {
|
|
compatible = "mctp-i2c-controller";
|
|
reg = <(0x50 | I2C_OWN_SLAVE_ADDRESS)>;
|
|
};
|
|
};
|
|
|
|
i2c-mux {
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
i2c-parent = <&i2c1>;
|
|
|
|
i2c5: i2c@0 {
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
reg = <0>;
|
|
eeprom@33 {
|
|
reg = <0x33>;
|
|
};
|
|
};
|
|
|
|
i2c6: i2c@1 {
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
reg = <1>;
|
|
mctp-controller;
|
|
};
|
|
};
|