From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jacek Anaszewski Subject: Re: [PATCH 3/3] devicetree: Add led-backlight binding Date: Fri, 04 Sep 2015 17:03:36 +0200 Message-ID: <55E9B2C8.1020407@samsung.com> References: <1440502442-19531-1-git-send-email-tomi.valkeinen@ti.com> <1440502442-19531-4-git-send-email-tomi.valkeinen@ti.com> <55DC700C.4030802@samsung.com> <55DC8C9D.4050007@ti.com> <55DD65BE.4050308@samsung.com> <55DD82C4.50405@ti.com> <55DD8D4A.8010507@samsung.com> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Return-path: Received: from mailout1.w1.samsung.com ([210.118.77.11]:63052 "EHLO mailout1.w1.samsung.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1758450AbbIDPDk (ORCPT ); Fri, 4 Sep 2015 11:03:40 -0400 In-reply-to: Sender: linux-leds-owner@vger.kernel.org List-Id: linux-leds@vger.kernel.org To: Rob Herring Cc: Tomi Valkeinen , Jingoo Han , Lee Jones , Linux LED Subsystem , "linux-fbdev@vger.kernel.org" , Andrew Lunn , "devicetree@vger.kernel.org" On 09/01/2015 01:12 AM, Rob Herring wrote: > On Wed, Aug 26, 2015 at 4:56 AM, Jacek Anaszewski > wrote: >> On 08/26/2015 11:11 AM, Tomi Valkeinen wrote: >>> >>> >>> >>> On 26/08/15 10:07, Jacek Anaszewski wrote: >>>> >>>> On 08/25/2015 05:41 PM, Tomi Valkeinen wrote: >>>>> >>>>> >>>>> >>>>> On 25/08/15 16:39, Jacek Anaszewski wrote: >>>>> >>>>>>> +Example: >>>>>>> + >>>>>>> + backlight { >>>>>>> + compatible = "led-backlight"; >>>>>>> + leds = <&backlight_led>; >>>>>>> + >>>>>>> + brightness-levels = <0 4 8 16 32 64 128 255>; >>>>>> >>>>>> >>>>>> brightness level is not a suitable unit for describing LED brightness >>>>>> in a Device Tree, as it is not a physical unit. We have >>>>>> led-max-microamp >>>>>> property for this, expressed in microamperes, please refer to [0] from >>>>>> linux-next. >>>>> >>>>> >>>>> Hmm, ok, but what should the driver do with microamperes? As far as I >>>>> see, "enum led_brightness" (which is between 0-255) is used to set the >>>>> brightness to LEDs. I don't see any function accepting microamperes. >>>> >>>> >>>> This is implementation detail. You can convert microamperes to >>>> enum led_brightness in the driver. Please refer to the discussion [1]. >>> >>> >>> The led_set_brightness() takes "enum led_brightness", so I don't >>> understand what this driver would do with the microampere value. It >>> could, of course, do an arbitrary conversion, say, direct mapping of the >>> mA value to brightness, but that would just confuse things further. >> >> >> OK, I was looking at the problem from LED-centric perspective. Indeed, >> backlight subsystem has no other way to pass brightness to the LED >> subsystem than in the form of levels. However, the last word belongs >> to DT maintainer in this matter. >> >> Cc'ing devicetree@vger.kernel.org. > > I don't have a simple answer for you... > > There was a similar discussion for pm8941-wled and > "default-brightness-level" units[1]. The conclusion was it should be > units matching the h/w so that there is no conversion between > bootloader and OS units to h/w units. That principle probably applies > here. > > If the brightness levels are non-linear, then you need a translation > from percent to h/w level. What's needed here for h/w levels depends > on whether the brightness control is PWM, current control or both. For > PWM, units of the PWM control makes sense. For current control, units > of microamps probably makes sense. I don't know what you do with both, > but I have seen that h/w (FSL PMICs). > > This all certainly needs some more work on defining some common > binding. We already have some bindings for backlights with the LED and > PWM bindings (perhaps incomplete?). Do we need another way here? This > also introduces possibility of multiple ways to define GPIO controlled > backlights: gpio -> gpio-leds -> led-backlight or gpio -> > gpio-backlight. We don't want that... > > This problem is not really specific at all to backlights, but applies > to all LEDs. Some LEDs you may not have control beyond on/off or > really care about fine-grained control of level, but they are really > no different. The main unique thing about backlights is what display > are they associated with. Some time ago I was trying to add common LEDs DT properties that would have defined brightness in levels, but other people insisted on microamperes [1]. The discussion was focused on flash LEDs, where currents are significantly greater and there is risk of hardware damage in case underrated LED is connected [2]. Having the property in microamperes removes the need for consulting documentation to check current value for given brightness level. As it was mentioned earlier in this thread, this approach is not suitable for PWM driven leds, and they have their own bindings, which allow for describing brightness in levels. Probably we should add some note to the common LEDs DT bindings that would state explicitly that such exceptions are allowed. In case of backlights which are built upon LED class devices we could stick to brightness levels, as a LED class driver will assert brightness level to the leds-max-microamp value anyway. [1] http://www.spinics.net/lists/linux-leds/msg03416.html [2] http://patchwork.ozlabs.org/patch/456622/ -- Best Regards, Jacek Anaszewski