Received: by 2002:ad5:474a:0:0:0:0:0 with SMTP id i10csp3826110imu; Fri, 30 Nov 2018 06:39:33 -0800 (PST) X-Google-Smtp-Source: AFSGD/U1ab0E4DH+LptDD48pFv3GKVeCvZsBdIM7ybTU/40azSmqSMotLNmzuWp4w17Ddg0vCd1p X-Received: by 2002:a63:ec13:: with SMTP id j19mr5002674pgh.6.1543588772852; Fri, 30 Nov 2018 06:39:32 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1543588772; cv=none; d=google.com; s=arc-20160816; b=tKJg5url8jBmyMBuic7+XRYmXsCWNKkBSELOYCYQxpd8tk2sPczOKdictQ+0LJzGVh a8RIIWt6qKV1vG6d64fQNe+AmPF2bnqsHeO0Pn8saN4FnsebNNqlU06GHROVF2jvO/Ak G+V2AgvVKAm8UzdLg7bP8XVlUu9otKpM5idkHSNm7bAdXgFVaLZOf1IrDC5Gl2bokg03 7PmcjVVsrluxpYm4H1L2B+gVdSGllBXvAlsLbFPApQ5qHh0+/sDYXKnJuZ7q5Dwt0QDJ cV+9EEyO06yt255kVw87ZoG5PNHTu1i5wvApt6291oe8JIW9i2JEypAGK9C7E29OkZtB DyXg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:dkim-signature; bh=VbGcBnrulKG6GwggGE35Jj7CILiKVnPWrMOQs5nbZ9o=; b=i0p3x23inpm+MC2rTE5/hIn5gtbP4HtJWEzN7EuYfWQS860z6pPsIE4IC9ZRuM8kkI zBfEK0HimkZ8EypfGcFJ2zKvzYl4FXtPBoKvjZbn3ErOHtvOhSe8AFGcsyiQ8AG95Zel V3jZX227+fRB9xxRkt3e117E8K0pXLyuv/0Kf4Ym+4AFrSD0K+DKyQnDvWS9bpxbfNZw gW9Cjf3vbklZrQjgbaLaIqI5NTWifJOMzWsjeLaZYcITe/GpDunYneIU5zBUQqRBS0qV 9a6DeBrJCDh5usYN0qIZFuTlbUsAAhNSrxYGaPzp6gtUaDWHl7Q6AX7Mdwav7jon4uzD nXAw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=VzYUmPJi; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id j91si5809302pld.395.2018.11.30.06.39.16; Fri, 30 Nov 2018 06:39:32 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=VzYUmPJi; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1727007AbeLABsC (ORCPT + 99 others); Fri, 30 Nov 2018 20:48:02 -0500 Received: from mail.kernel.org ([198.145.29.99]:33958 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726340AbeLABsC (ORCPT ); Fri, 30 Nov 2018 20:48:02 -0500 Received: from mail-qt1-f176.google.com (mail-qt1-f176.google.com [209.85.160.176]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id DEFDB20868; Fri, 30 Nov 2018 14:38:29 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1543588710; bh=0X3KCYxp6TbV6XRmsLFwt8E4eJfVXQlt2+h/AHSJdfk=; h=References:In-Reply-To:From:Date:Subject:To:Cc:From; b=VzYUmPJik3XtuPdKo3gkKVEPR3DHl6fV7VNPOWeSGVaPGOA5wxM2qW0zakXG0u2Mg zaLZnGrY/6FnNZDXwbXcOXAn0Pe0rHAob4ggYtxBirPL07bN6krJ82WA9h7CMLmZz7 3WofH7HGrZCQnyeUAFKDNE46eGClD1Y0hWtqT/3k= Received: by mail-qt1-f176.google.com with SMTP id r14so6133959qtp.1; Fri, 30 Nov 2018 06:38:29 -0800 (PST) X-Gm-Message-State: AA+aEWYqxCpiAHrqHdFFVau9oFTF6lts8hV/RJfXN2zhEe1vf7ad/nfd nD3mjbyJRZRXVNm3Hdyqaw+/PUH35Z+T5M38Mg== X-Received: by 2002:ac8:1712:: with SMTP id w18mr4863665qtj.76.1543588709102; Fri, 30 Nov 2018 06:38:29 -0800 (PST) MIME-Version: 1.0 References: <1541542052-10081-1-git-send-email-jacek.anaszewski@gmail.com> <1541542052-10081-5-git-send-email-jacek.anaszewski@gmail.com> <5bea0eb8.1c69fb81.6b921.80e6@mx.google.com> <0a0b176c-4eb4-4b0e-6c3c-b3c6c8f5fff5@gmail.com> In-Reply-To: <0a0b176c-4eb4-4b0e-6c3c-b3c6c8f5fff5@gmail.com> From: Rob Herring Date: Fri, 30 Nov 2018 08:38:17 -0600 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: [PATCH 04/24] dt-bindings: leds: Add function and color properties To: Jacek Anaszewski Cc: Pavel Machek , Linux LED Subsystem , devicetree@vger.kernel.org, "linux-kernel@vger.kernel.org" , Baolin Wang , Daniel Mack , Dan Murphy , Linus Walleij , Oleh Kravchenko , Sakari Ailus , Simon Shields Content-Type: text/plain; charset="UTF-8" Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Tue, Nov 27, 2018 at 2:38 PM Jacek Anaszewski wrote: > > On 11/13/2018 09:57 PM, Jacek Anaszewski wrote: > > On 11/12/2018 07:27 PM, Rob Herring wrote: > >> On Tue, Nov 06, 2018 at 11:07:12PM +0100, Jacek Anaszewski wrote: > >>> Introduce dedicated properties for conveying information about > >>> LED function and color. Mark old "label" property as deprecated. > >>> > >>> Signed-off-by: Jacek Anaszewski > >>> Cc: Baolin Wang > >>> Cc: Daniel Mack > >>> Cc: Dan Murphy > >>> Cc: Linus Walleij > >>> Cc: Oleh Kravchenko > >>> Cc: Sakari Ailus > >>> Cc: Simon Shields > >>> Cc: Xiaotong Lu > >>> --- > >>> Documentation/devicetree/bindings/leds/common.txt | 52 +++++++++++++++++++---- > >>> 1 file changed, 44 insertions(+), 8 deletions(-) > >>> > >>> diff --git a/Documentation/devicetree/bindings/leds/common.txt b/Documentation/devicetree/bindings/leds/common.txt > >>> index aa13998..3efc826 100644 > >>> --- a/Documentation/devicetree/bindings/leds/common.txt > >>> +++ b/Documentation/devicetree/bindings/leds/common.txt > >>> @@ -10,14 +10,20 @@ can influence the way of the LED device initialization, the LED components > >>> have to be tightly coupled with the LED device binding. They are represented > >>> by child nodes of the parent LED device binding. > >>> > >>> + > >>> Optional properties for child nodes: > >>> - led-sources : List of device current outputs the LED is connected to. The > >>> outputs are identified by the numbers that must be defined > >>> in the LED device binding documentation. > >>> +- function: LED functon. Use one of the LED_FUNCTION_* prefixed definitions > >>> + from the header include/dt-bindings/leds/functions.h. > >>> + If there is no matching LED_FUNCTION available, add a new one. > >>> +- color : Color of the LED. > >>> - label : The label for this LED. If omitted, the label is taken from the node > >>> name (excluding the unit address). It has to uniquely identify > >>> a device, i.e. no other LED class device can be assigned the same > >>> - label. > >>> + label. This property is deprecated - use 'function' and 'color' > >>> + properties instead. > >> > >> I don't know if I'd go as far a deprecating. > >> > >> One thing to consider is how we handle multiple of the same function? Do > >> we allow an index on function names? What if an index isn't meaningful > >> and we need "front" vs. "rear" for example? Maybe label is still needed > >> there. > > > > I believe that 'label' property with its old semantics must be preserved > > for backwards compatibility - it so far has been used inconsistently for > > conveying variations of devicename:color:function sections. If provided, > > then it's been taken as-is for LED class device name, or concatenated > > with the devicename hard-coded in the driver. > > > > Regarding the differentiation between the LEDs with functions of > > same kind - OK, I agree, we will need another section. > > > > What seems to fits the best is the reference to the device it is > > logically associated with. > > > > The question is whether the devicename should be provided in DT > > literally, or by phandle, and then retrieved in runtime, basing on the > > sysfs entry, like in case of input-leds bridge which for USB keyboard > > creates LEDs named e.g.: > > > > input5::capslock > > input5::numlock > > input5::scrolllock > > > > Probably we will have to allow for some flexibility in this regard, > > to allow for providing devicename literally like "rear", "front", > > or like above input case. > > I must admit I have a dilemma with this devicename part. > Thinking more of it - the semantics of that section of LED > class device name needs to be precise. Currently there seem > to be two types of device names considered: > > 1) descriptive name like in case of flash - > front-camera::flash, rear-camera::flash, which would allow > for providing arbitrary devicenames, i.e. it would not improve > LED naming too much, which was the aim of this patch set > 2) name representing hardware relation or user-defined relation between > some device and the LED class device, like in above keyboard > LED case: > > - input5::numlock > > or for hard disk: > > - sda1::hdderr, > > In the hdderr case Pavel mentioned the arrangement where the LED > is not a part of the hard disk, so the relation would have to be > defined in DT. > For the flash case the devicename part would be matching /dev/videoN > device. > > I'm in favour of the option 2) since it seems to be more precise. > In this case we would need a mechanism for asynchronous LED class > device registration which would register a LED only after the > associated device has been probed and its name is known. > The mechanism would be a simpler form of > drivers/media/v4l2-core/v4l2-async.c. > > In the LED DT node we would need a property holding a phandle > to the associated device. Then, in the runtime the related device > would call led_register_associated_device(struct device_node*, > struct device*) which would in turn match the device_node with > the phandle assigned to the property in the LED DT node. Having > the struct device of the associated device we could retrieve > device node name from dev->kobj. > > We would also probably need different DT properties for different > types of devices, since e.g. for network case the network interface > name would fit better for the LED name, than the phy name, > and we would need to know what type of device name we're going > to look for. > > Pavel gave following examples: > > eth0:green:link > adsl0:green:link > adsl0:red:error > > So we would have e.g.: > > associated-vl42-device = <&camera1>; > associated-network-device = <&phy1>; > associated-block-device = <&phy1>; Variable property names are kind of a pain to parse. Perhaps when LEDs are associated with a device, we shouldn't care within the context of the LED subsystem what the name is. The association is more important and if you have that exposed, then you don't really need to care what the name is. You still have to deal with a device with more than 1 LED, but that becomes a problem local to that device. What I'm getting at is following a more standard binding pattern of providers and consumers like we have for gpios, clocks, etc. So we'd have something like this: ethernet { ... leds = <&green_led>, <&red_led>; led-names = "link", "err"; }; We can still support defining LED names as we've done, but we don't have to come up with some elaborate naming convention that covers every single case. Rob