On Tue, Nov 01, 2022 at 04:57:56PM -0500, Andrew Davis wrote: > The TI Nspire devices contain a set of registers with a seemingly > miscellaneous set of functionality. This area is known simply as the > "misc" region. > > Signed-off-by: Andrew Davis <afd@xxxxxx> > --- > .../bindings/mfd/ti,nspire-misc.yaml | 55 +++++++++++++++++++ > 1 file changed, 55 insertions(+) > create mode 100644 Documentation/devicetree/bindings/mfd/ti,nspire-misc.yaml > > diff --git a/Documentation/devicetree/bindings/mfd/ti,nspire-misc.yaml b/Documentation/devicetree/bindings/mfd/ti,nspire-misc.yaml > new file mode 100644 > index 0000000000000..d409eae7537bd > --- /dev/null > +++ b/Documentation/devicetree/bindings/mfd/ti,nspire-misc.yaml > @@ -0,0 +1,55 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +# Copyright (C) 2022 Texas Instruments Incorporated - https://www.ti.com/ > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/mfd/ti,nspire-misc.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: TI Nspire MISC hardware block > + > +maintainers: > + - Andrew Davis <afd@xxxxxx> > + > +description: | > + System controller node represents a register region containing a set > + of miscellaneous registers. The registers are not cohesive enough to > + represent as any specific type of device. The typical use-case is > + for some other node's driver, or platform-specific code, to acquire > + a reference to the syscon node (e.g. by phandle, node path, or > + search using a specific compatible value), interrogate the node (or > + associated OS driver) to determine the location of the registers, > + and access the registers directly. Looks like you copied the generic description? Describe what MISC contains. > + > +properties: > + compatible: > + items: > + - enum: > + - ti,nspire-misc > + - const: syscon > + - const: simple-mfd > + > + reg: > + maxItems: 1 > + > + reboot: > + $ref: "../power/reset/syscon-reboot.yaml" /schemas/power/... And no quotes needed. > + > +required: > + - compatible > + - reg > + - reboot > + > +additionalProperties: false > + > +examples: > + - | > + misc: misc@900a0000 { > + compatible = "ti,nspire-misc", "syscon", "simple-mfd"; > + reg = <0x900a0000 0x1000>; > + > + reboot { > + compatible = "syscon-reboot"; > + offset = <0x08>; > + value = <0x02>; > + }; > + }; > -- > 2.37.3 > >
