Messages in this thread | | | Subject | Re: [PATCH] dt-bindings: iio: Document "label" property | From | Lars-Peter Clausen <> | Date | Tue, 21 Dec 2021 12:29:04 +0100 |
| |
On 12/21/21 11:43 AM, Paul Cercueil wrote: > All iio devices can have a label, which will be carried on to userspace > as a sysfs attribute. This is useful when having several iio devices > that represent different instances of the same hardware, as the name > attribute would then not be enough to differentiate between them. > > Signed-off-by: Paul Cercueil <paul@crapouillou.net> > --- > Documentation/devicetree/bindings/iio/common.yaml | 8 ++++++++ > 1 file changed, 8 insertions(+) > > diff --git a/Documentation/devicetree/bindings/iio/common.yaml b/Documentation/devicetree/bindings/iio/common.yaml > index f845b41d74c4..a90ad7718ecf 100644 > --- a/Documentation/devicetree/bindings/iio/common.yaml > +++ b/Documentation/devicetree/bindings/iio/common.yaml > @@ -32,6 +32,14 @@ properties: > considered 'near' to the device (an object is near to the > sensor). > > + label: > + $ref: /schemas/types.yaml#/definitions/string > + description: | > + All iio devices can have a label, which will be carried on to userspace > + as a sysfs attribute. This is useful when having several iio devices that > + represent different instances of the same hardware, as the name attribute > + would then not be enough to differentiate between them. > +
The description has a lot of implementation details of the Linux kernel. The devicetree bindings should be formulated operating system agnostic.
Something like:
A descriptive label that allows to uniquely identify the device within the system.
| |