linux-kernel - Re: [PATCH 1/2] dt-bindings: hwmon: add binding documentation for adt7475

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <1ed7434bfded41bfba3b739f58f69102@svr-chch-ex1.atlnz.lc>
Date:   Wed, 7 Nov 2018 04:27:27 +0000
From:   Chris Packham <Chris.Packham@...iedtelesis.co.nz>
To:     Guenter Roeck <linux@...ck-us.net>,
        "robh+dt@...nel.org" <robh+dt@...nel.org>,
        "jdelvare@...e.com" <jdelvare@...e.com>
CC:     "linux-hwmon@...r.kernel.org" <linux-hwmon@...r.kernel.org>,
        "devicetree@...r.kernel.org" <devicetree@...r.kernel.org>,
        "linux-kernel@...r.kernel.org" <linux-kernel@...r.kernel.org>,
        Mark Rutland <mark.rutland@....com>
Subject: Re: [PATCH 1/2] dt-bindings: hwmon: add binding documentation for
 adt7475

On 7/11/18 5:24 PM, Guenter Roeck wrote:
> On 11/6/18 8:00 PM, Chris Packham wrote:
>> With the addition of the invert-pwm property the adt7475 needs its own
>> binding documentation rather being captured under trivial-devices.txt.
>>
>> Signed-off-by: Chris Packham <chris.packham@...iedtelesis.co.nz>
>> ---
>>    .../devicetree/bindings/hwmon/adt7475.txt     | 22 +++++++++++++++++++
>>    .../devicetree/bindings/trivial-devices.txt   |  4 ----
>>    2 files changed, 22 insertions(+), 4 deletions(-)
>>    create mode 100644 Documentation/devicetree/bindings/hwmon/adt7475.txt
>>
>> diff --git a/Documentation/devicetree/bindings/hwmon/adt7475.txt b/Documentation/devicetree/bindings/hwmon/adt7475.txt
>> new file mode 100644
>> index 000000000000..79255439e157
>> --- /dev/null
>> +++ b/Documentation/devicetree/bindings/hwmon/adt7475.txt
>> @@ -0,0 +1,22 @@
>> +*ADT7475 hwmon sensor.
>> +
>> +Required properties:
>> +- compatible: One of
>> +	"adi,adt7473"
>> +	"adi,adt7475"
>> +	"adi,adt7476"
>> +	"adi,adt7490"
>> +
>> +- reg: I2C address
>> +
>> +optional properties:
>> +
>> +- invert-pwm: This configures the PWM to use logic low for 100% duty cycle.
>> +
>> +Example:
>> +
>> +hwmon@2e {
>> +	compatible = ;
>> +	reg = <0x2e>;
>> +	invert-pwm;
> 
> If I understand correctly, the flag is set per pwm channel. A single global
> property seems inappropriate.

Yes it is per-channel. But I was having a hard time imagining a hardware 
design that would use both inverted and non-inverted at the same time.

Do you have a preference for how the properties should look?

   invert-pwm[123]?

   invert-pwm = <0x7>;?

> 
> Guenter
> 
>> +};
>> diff --git a/Documentation/devicetree/bindings/trivial-devices.txt b/Documentation/devicetree/bindings/trivial-devices.txt
>> index 69c934aec13b..4f29100d6bbf 100644
>> --- a/Documentation/devicetree/bindings/trivial-devices.txt
>> +++ b/Documentation/devicetree/bindings/trivial-devices.txt
>> @@ -14,10 +14,6 @@ ad,ad7414		SMBus/I2C Digital Temperature Sensor in 6-Pin SOT with SMBus Alert an
>>    ad,adm9240		ADM9240:  Complete System Hardware Monitor for uProcessor-Based Systems
>>    adi,adt7461		+/-1C TDM Extended Temp Range I.C
>>    adt7461			+/-1C TDM Extended Temp Range I.C
>> -adi,adt7473		+/-1C TDM Extended Temp Range I.C
>> -adi,adt7475		+/-1C TDM Extended Temp Range I.C
>> -adi,adt7476		+/-1C TDM Extended Temp Range I.C
>> -adi,adt7490		+/-1C TDM Extended Temp Range I.C
>>    adi,adxl345		Three-Axis Digital Accelerometer
>>    adi,adxl346		Three-Axis Digital Accelerometer (backward-compatibility value "adi,adxl345" must be listed too)
>>    ams,iaq-core		AMS iAQ-Core VOC Sensor
>>
> 
>