Thread (17 messages) 17 messages, 4 authors, 2019-04-07

Re: [PATCH v2 2/3] dt-bindings: backlight: add lm3630a bindings

From: Rob Herring <robh+dt@kernel.org>
Date: 2019-04-03 01:50:25
Also in: dri-devel, linux-devicetree, linux-leds, lkml

On Tue, Apr 2, 2019 at 8:24 AM Brian Masney [off-list ref] wrote:
On Tue, Apr 02, 2019 at 07:56:55AM -0500, Dan Murphy wrote:
quoted
This would connect control bank B to control bank A.  Or just use a flag to denote to connect them
and not use led-sources.  But led-sources is the property of choice.

led@0 {
      reg = <0>;
      led-sources = < 0 1 >;
      label = "main-lcd";
      default-brightness = <200>;
      max-brightness = <255>;
};
OK, I see. I wondered how we could do that in device tree.
quoted
quoted
+    properties:
+      label:
+        description: |
+          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.
+
+      led-sources:
+        description: |
+          List of device current outputs the LED is connected to.
+        allOf:
+          - $ref: /schemas/types.yaml#/definitions/uint32-array
+          - minItems: 1
+            maxItems: 2
+            items:
+              minimum: 0
+              maximum: 1
+
label and led-sources are already defined in the common.txt no need to redefine them here.
If I'm going to use the new-style bindings, then I'll need to convert
common.txt over to use the new format as well so that the automated
schema validations will work. I'm willing to do that work if there is
interest from the LED / backlight maintainers. The main issue is that
there are 62 references to the file common.txt in the directory
Documentation/devicetree/bindings/leds/. Would the maintainers prefer:
That would be awesome.
- Once common.txt is converted to common.yaml, make common.txt only
  have a line stating that the common bindings were moved into
  common.yaml. We can remove this file once all of the other bindings
  are converted to the new-style format.

- Update all references to common.txt to common.yaml. (1 patch or 62
  patches?)
I'd probably go with the former if I had to pick. The real
complication here is there's some other changes in flight.
- Or, just go with the older-style binding format for now.
I'm okay if you write it with the assumption that the common
properties have a schema even if they don't yet. All that means is you
don't need to define the type, but only the additional constraints.
There doesn't have to be a reference back to the common property
(those references tend to get broken as we can see here). With
everything as structured data, we could even generate references or
have some tool that can lookup the common definitions.

Rob
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help