Re: [PATCH v2 2/3] backlight: adp5520: document sysfs attributes

From: Daniel Thompson
Date: Tue Feb 06 2018 - 08:57:25 EST


On Tue, Feb 06, 2018 at 01:10:26PM +0530, Aishwarya Pant wrote:
> Add documentation for sysfs interface of adp5520/adp5501 analog devices
> backlight driver by reading code and looking through git commit logs.
>
> Signed-off-by: Aishwarya Pant <aishpant@xxxxxxxxx>
> Acked-by: Michael Hennerich <michael.hennerich@xxxxxxxxxx>

Acked-by: Daniel Thompson <daniel.thompson@xxxxxxxxxx>

> ---
> .../ABI/testing/sysfs-class-backlight-adp5520 | 31 ++++++++++++++++++++++
> 1 file changed, 31 insertions(+)
> create mode 100644 Documentation/ABI/testing/sysfs-class-backlight-adp5520
>
> diff --git a/Documentation/ABI/testing/sysfs-class-backlight-adp5520 b/Documentation/ABI/testing/sysfs-class-backlight-adp5520
> new file mode 100644
> index 000000000000..34b6ebafa210
> --- /dev/null
> +++ b/Documentation/ABI/testing/sysfs-class-backlight-adp5520
> @@ -0,0 +1,31 @@
> +sysfs interface for analog devices adp5520(01) backlight driver
> +---------------------------------------------------------------
> +
> +The backlight brightness control operates at three different levels for the
> +adp5520 and adp5501 devices: daylight (level 1), office (level 2) and dark
> +(level 3). By default the brightness operates at the daylight brightness level.
> +
> +What: /sys/class/backlight/<backlight>/daylight_max
> +What: /sys/class/backlight/<backlight>/office_max
> +What: /sys/class/backlight/<backlight>/dark_max
> +Date: Sep, 2009
> +KernelVersion: v2.6.32
> +Contact: Michael Hennerich <michael.hennerich@xxxxxxxxxx>
> +Description:
> + (RW) Maximum current setting for the backlight when brightness
> + is at one of the three levels (daylight, office or dark). This
> + is an input code between 0 and 127, which is transformed to a
> + value between 0 mA and 30 mA using linear or non-linear
> + algorithms.
> +
> +What: /sys/class/backlight/<backlight>/daylight_dim
> +What: /sys/class/backlight/<backlight>/office_dim
> +What: /sys/class/backlight/<backlight>/dark_dim
> +Date: Sep, 2009
> +KernelVersion: v2.6.32
> +Contact: Michael Hennerich <michael.hennerich@xxxxxxxxxx>
> +Description:
> + (RW) Dim current setting for the backlight when brightness is at
> + one of the three levels (daylight, office or dark). This is an
> + input code between 0 and 127, which is transformed to a value
> + between 0 mA and 30 mA using linear or non-linear algorithms.
> --
> 2.16.1
>