Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > linux.kernel > #1545215

Re: [PATCH 1/7] Documentation: DT: bindings: iio: adc: add documentation for Allwinner SoCs' GPADC driver

Show all headers | View raw

Hi,

On 20/12/2016 15:25, Maxime Ripard wrote:
> Hi,
> 
> On Tue, Dec 20, 2016 at 11:27:03AM +0100, Quentin Schulz wrote:
[...]
>> +Currently, the touchscreen controller does not have a driver using this ADC
>> +driver. The touchscreen controller is currently driven only by
>> +input/touchscreen/sun4i-ts.c which is absolutely incompatible with this driver.
>> +
>> +The Allwinner A10, A13 and A31 SoCs already have a DT binding for the
>> +aforementioned input driver, thus an MFD driver matches the existing DT binding
>> +(mfd/sun4i-gpadc.c) and replaces the input driver. No DT binding is required for
>> +these SoCs' ADC, everything is handled by the MFD which is matching the existing
>> +DT binding for input/touchscreen/sun4i-ts.c.
>> +
>> +The Allwinner A33 GPADC only have a thermal sensor and have a proper DT binding
>> +for this driver unlike the previously mentioned SoCs.
> 
> The DT bindings should be agnostic from the OS. You can remove all
> mention of the implementations details in Linux.
> 
> (and you should wrap at 72 characters).
> 
> But we already have a binding document for that controller, so you
> shouldn't create a new one, reuse the old one that is already there.
> 

ACK.

>> +Required properties:
>> + - compatible: "allwinner,sun8i-a33-gpadc-iio"
> 
> IIO is an implementation detail. The IP is called GPADC.
> You're also missing reg.
> 

ACK.

>> +
>> +Optional properties:
>> +(for use with thermal framework for CPU thermal throttling for example, and/or
>> + IIO consumers)
>> + - #thermal-sensor-cells = <0>; (see
>> +Documentation/devicetree/bindings/thermal/thermal.txt)
>> + - #io-channel-cells = <0>; (see
>> +Documentation/devicetree/bindings/iio/iio-bindings.txt)
> 
> I wouldn't list that as optional.
> 

In what sense? Do you mean you wouldn't put them here at all or you
would require them?

Thanks,
Quentin

-- 
Quentin Schulz, Free Electrons
Embedded Linux and Kernel engineering
http://free-electrons.com

Back to linux.kernel | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread

Thread

[PATCH 0/7] add CPU thermal throttling to Allwinner A33 SoC Quentin Schulz <quentin.schulz@free-electrons.com> - 2016-12-20 11:30 +0100
  [PATCH 7/7] ARM: dtsi: sun8i-a33: add CPU thermal throttling Quentin Schulz <quentin.schulz@free-electrons.com> - 2016-12-20 11:30 +0100
  [PATCH 1/7] Documentation: DT: bindings: iio: adc: add documentation for Allwinner SoCs' GPADC driver Quentin Schulz <quentin.schulz@free-electrons.com> - 2016-12-20 11:30 +0100
    Re: [PATCH 1/7] Documentation: DT: bindings: iio: adc: add  documentation for Allwinner SoCs' GPADC driver Maxime Ripard <maxime.ripard@free-electrons.com> - 2016-12-20 15:30 +0100
      Re: [PATCH 1/7] Documentation: DT: bindings: iio: adc: add  documentation for Allwinner SoCs' GPADC driver Quentin Schulz <quentin.schulz@free-electrons.com> - 2016-12-20 16:50 +0100
        Re: [PATCH 1/7] Documentation: DT: bindings: iio: adc: add  documentation for Allwinner SoCs' GPADC driver Maxime Ripard <maxime.ripard@free-electrons.com> - 2016-12-21 13:30 +0100
  [PATCH 6/7] ARM: dtsi: sun8i-a33: add A33 thermal sensor Quentin Schulz <quentin.schulz@free-electrons.com> - 2016-12-20 11:30 +0100
  [PATCH 2/7] Documentation: DT: bindings: mfd: add documentation for Allwinner SoCs' GPADC MFD driver Quentin Schulz <quentin.schulz@free-electrons.com> - 2016-12-20 11:30 +0100
    Re: [PATCH 2/7] Documentation: DT: bindings: mfd: add documentation  for Allwinner SoCs' GPADC MFD driver Maxime Ripard <maxime.ripard@free-electrons.com> - 2016-12-20 15:30 +0100
  [PATCH 5/7] ARM: dts: sun8i-a33-olinuxino: add cpu-supply Quentin Schulz <quentin.schulz@free-electrons.com> - 2016-12-20 11:30 +0100
  [PATCH 4/7] ARM: dts: sun8i-a33-sinlinx-sina33: add cpu-supply Quentin Schulz <quentin.schulz@free-electrons.com> - 2016-12-20 11:40 +0100

csiph-web