[linux-sunxi] Re: [PATCH v4 1/6] dt-bindings: update the Allwinner GPADC device tree binding for H3
From: icenowy@aosc.io (Icenowy Zheng)
Date: 2017-09-20 08:04:30
Also in:
linux-devicetree, linux-iio, lkml
? 2017?9?20? GMT+08:00 ??3:52:23, Maxime Ripard [off-list ref] ??:
On Mon, Sep 18, 2017 at 03:47:25PM +0000, icenowy at aosc.io wrote:quoted
? 2017-09-18 16:30?Maxime Ripard ???quoted
On Mon, Sep 18, 2017 at 03:36:43PM +0800, Icenowy Zheng wrote:quoted
? 2017?9?18? GMT+08:00 ??3:33:36, Maxime Ripard [off-list ref] ??:quoted
On Thu, Sep 14, 2017 at 10:52:46PM +0800, Icenowy Zheng wrote:quoted
Allwinner H3 features a thermal sensor like the one in A33,but hasquoted
quoted
quoted
quoted
itsquoted
register re-arranged, the clock divider moved to CCU(originally thequoted
quoted
quoted
quoted
quoted
clock divider is in ADC) and added a pair of bus clock andreset.quoted
quoted
quoted
quoted
quoted
Update the binding document to cover H3. Signed-off-by: Icenowy Zheng <icenowy@aosc.io> Reviewed-by: Chen-Yu Tsai <redacted> --- Changes in v4: - Add nvmem calibration data (not yet used by the driver) Changes in v3: - Clock name changes. - Example node name changes. - Add interupts (not yet used by the driver). .../devicetree/bindings/mfd/sun4i-gpadc.txt | 30++++++++++++++++++++--quoted
1 file changed, 28 insertions(+), 2 deletions(-) diff --gita/Documentation/devicetree/bindings/mfd/sun4i-gpadc.txtquoted
quoted
quoted
quoted
b/Documentation/devicetree/bindings/mfd/sun4i-gpadc.txtquoted
index badff3611a98..6c470d584bf9 100644--- a/Documentation/devicetree/bindings/mfd/sun4i-gpadc.txt +++ b/Documentation/devicetree/bindings/mfd/sun4i-gpadc.txt@@ -4,12 +4,26 @@ The Allwinner SoCs all have an ADC that canalsoquoted
quoted
quoted
quoted
act as a thermal sensorquoted
and sometimes as a touchscreen controller. Required properties: - - compatible: "allwinner,sun8i-a33-ths", + - compatible: must contain one of the followingcompatibles:quoted
quoted
quoted
quoted
quoted
+ - "allwinner,sun8i-a33-ths" + - "allwinner,sun8i-h3-ths" - reg: mmio address range of the chip, - #thermal-sensor-cells: shall be 0, - #io-channel-cells: shall be 0, -Example: +Optional properties: + - nvmem-cells: A phandle to the calibration data providedby aquoted
quoted
quoted
quoted
nvmem device.quoted
+ If unspecified default values shall be used. + - nvmem-cell-names: Should be "calibration-data"I'd prefer to have which sensor it applies to here. It wouldn'tchangequoted
quoted
quoted
quoted
anything for the H3, but it definitely does for example for theA83tquoted
quoted
quoted
quoted
that has two sensors, one for each cluster, and one for the GPU,eachquoted
quoted
quoted
quoted
with calibration data. What about cluster0-calibration?I prefer sensor0-calibration to sensor3-calibration now. (Theortically the new generation THS can support up to 4 sensors)The mapping that explains what sensor0 means can change in the future. It's better to be explicit here, and just say upfront what it's about.
I think for some SoC (e.g. A64) there's no clear explain on the functions of the sensors. In addition, in the THS controller the sensors has a explicit sequence, and when referencing it in the DT the number is still needed (in thermal zones).
Maxime