On Sat, Sep 22, 2018 at 11:36:22PM -0700, Guenter Roeck wrote: > >>>>>+ Optional properties: > >>>>>+ - input-label: Name of the input source > > Just noticed the "input-" here. Please just use "label". Will fix in v5. > >>>>>+ input1 { > >>>>>+ input-id = <0x1>; > >>>> > >>>>We'll have to find a better name for this. Feel free to look up examples in the > >>>>existing devicetree descriptions. The one that seems to be used most of the time > >>>>to indicate a channel index or id is "reg". It should also start with 0 - there > >>>>is no real reason for it to start with 1; it only makes the code more complex. > >>> > >>>The reason is that the port start from 1 in the datasheet. > >>> > >> > >>Maybe, but for me I'll want to have something that we can reuse for other chips. > >>Having the index start with 0 for one chip and with 1 for another would be > >>confusing. It is bad enough that we have in[0..n] for voltages and temp[1..n] > >>for temperatures. I would not want to see the same in devicetree files, > >>and much less so on a per-device basis. It is also pretty common to start > >>channel numbers with 0 in devicetree files. > > > >Understood. I search a bit and saw most of "*-id" start from 0, > >although I cannot be sure whether their Datasheet/RM/schematics > >are counting from 0 or 1. > > > >And I also found a transposing example: > > Documentation/devicetree/bindings/serial/mrvl,pxa-ssp.txt > > > > You'll always find an example for anything in the kernel. In this case, > it is for one specific chip. I'll want this to be reusable as template for > _all_ hardware monitoring chips. I see. Thanks Nicolin