On Wed, 4 Nov 2020, Rob Herring wrote: > On Mon, Nov 02, 2020 at 05:22:19PM -0500, Nicolas Pitre wrote: > > From: Nicolas Pitre <npitre@xxxxxxxxxxxx> > > > > The MIPI I3C HCI (Host Controller Interface) specification defines > > a common software driver interface to support compliant MIPI I3C > > host controller hardware implementations from multiple vendors. > > > > All that is needed is an I/O area and an interrupt signal;. The hardware > > is self-advertising wrt its implementor and implemented capabilities so > > there is currently no details that the driver can't figure out on its own. > > > > Signed-off-by: Nicolas Pitre <npitre@xxxxxxxxxxxx> > > --- > > .../devicetree/bindings/i3c/mipi-i3c-hci.yaml | 45 +++++++++++++++++++ > > 1 file changed, 45 insertions(+) > > create mode 100644 Documentation/devicetree/bindings/i3c/mipi-i3c-hci.yaml > > With additionalProperties added, > > Reviewed-by: Rob Herring <robh@xxxxxxxxxx> Thanks. Fixed patch below. ----- >8 From: Nicolas Pitre <npitre@xxxxxxxxxxxx> Subject: [PATCH] dt-bindings: i3c: MIPI I3C Host Controller Interface The MIPI I3C HCI (Host Controller Interface) specification defines a common software driver interface to support compliant MIPI I3C host controller hardware implementations from multiple vendors. All that is needed is an I/O area and an interrupt signal;. The hardware is self-advertising wrt its implementor and implemented capabilities so there is currently no details that the driver can't figure out on its own. Signed-off-by: Nicolas Pitre <npitre@xxxxxxxxxxxx> Reviewed-by: Rob Herring <robh@xxxxxxxxxx> diff --git a/Documentation/devicetree/bindings/i3c/mipi-i3c-hci.yaml b/Documentation/devicetree/bindings/i3c/mipi-i3c-hci.yaml new file mode 100644 index 0000000000..07a7b10163 --- /dev/null +++ b/Documentation/devicetree/bindings/i3c/mipi-i3c-hci.yaml @@ -0,0 +1,47 @@ +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) +%YAML 1.2 +--- +$id: "http://devicetree.org/schemas/i3c/mipi-i3c-hci.yaml#"; +$schema: "http://devicetree.org/meta-schemas/core.yaml#"; + +title: MIPI I3C HCI Device Tree Bindings + +maintainers: + - Nicolas Pitre <npitre@xxxxxxxxxxxx> + +description: | + MIPI I3C Host Controller Interface + + The MIPI I3C HCI (Host Controller Interface) specification defines + a common software driver interface to support compliant MIPI I3C + host controller hardware implementations from multiple vendors. + + The hardware is self-advertising for differences in implementation + capabilities, including the spec version it is based on, so there + isn't much to describe here (yet). + + For details, please see: + https://www.mipi.org/specifications/i3c-hci + +properties: + compatible: + const: mipi-i3c-hci + reg: + maxItems: 1 + interrupts: + maxItems: 1 + +required: + - compatible + - reg + - interrupts + +additionalProperties: false + +examples: + - | + i3c@a0000000 { + compatible = "mipi-i3c-hci"; + reg = <0xa0000000 0x2000>; + interrupts = <89>; + };
