On Tue 2018-05-08 09:17:03, Dan Murphy wrote:
> Introduce the device tree bindings for the lm3601x
> family of LED torch, flash and IR drivers.
> 
> Signed-off-by: Dan Murphy <[email protected]>
> ---
> 
> v2 - No changes - https://patchwork.kernel.org/patch/10384587/
> 
>  .../devicetree/bindings/leds/leds-lm3601x.txt | 51 +++++++++++++++++++
>  1 file changed, 51 insertions(+)
>  create mode 100644 Documentation/devicetree/bindings/leds/leds-lm3601x.txt
> 
> diff --git a/Documentation/devicetree/bindings/leds/leds-lm3601x.txt 
> b/Documentation/devicetree/bindings/leds/leds-lm3601x.txt
> new file mode 100644
> index 000000000000..38cdabf6ca7e
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/leds/leds-lm3601x.txt
> @@ -0,0 +1,51 @@
> +* Texas Instruments - lm3601x Single-LED Flash Driver
> +
> +The LM3601X are ultra-small LED flash drivers that
> +provides a high level of adjustability.

"provide".

> +Required properties:
> +     - compatible : Can be one of the following
> +             "ti,lm3601x"
> +             "ti,lm36010"
> +             "ti,lm36011"
> +     - reg : I2C slave address
> +     - #address-cells : 1
> +     - #size-cells : 0
> +
> +Required child properties:
> +     - reg : 0 - Indicates to support and register a torch interface
> +             1 - Indicates to support and register a strobe interface
> +             2 - Indicates to support and register an ir interface

I'd delete "to support and register" -- we are describing hardware here.

> +Optional child properties:
> +     - label : see Documentation/devicetree/bindings/leds/common.txt
> +
> +Example:
> +led-controller@64 {
> +     compatible = "ti,lm3601x";
> +     #address-cells = <1>;
> +     #size-cells = <0>;
> +     reg = <0x64>;
> +
> +     led@0 {
> +             reg = <0>;
> +             label = "white:torch";
> +             led-max-microamp=<10000>;
> +     };
> +
> +     led@1 {
> +             reg = <1>;
> +             label = "white:strobe";
> +             flash-max-microamp=<10000>;
> +             flash-max-timeout-us=<800>;
> +     };
> +
> +     led@2 {
> +             reg = <2>;
> +             label = "invisible:ir";
> +     };
> +}

Title says this is single-LED driver chip, but it controls three chips
in this example?

I'd put " " around "=" for consistency.

We use "flash" elsewhere, I'd replace "strobe" with that. Userspace
would like consistency, too.

What is the IR led good for? Taking videos in the dark?

I guess for consistency, it is "ir:torch" :-).

                                                                        Pavel
-- 
(english) http://www.livejournal.com/~pavelmachek
(cesky, pictures) 
http://atrey.karlin.mff.cuni.cz/~pavel/picture/horses/blog.html

Attachment: signature.asc
Description: Digital signature

Reply via email to