From: Jonathan Cameron <jic23@kernel.org>
To: ChiaEn Wu <peterwu.pub@gmail.com>
Cc: lars@metafoo.de, matthias.bgg@gmail.com, lee.jones@linaro.org,
daniel.thompson@linaro.org, jingoohan1@gmail.com, pavel@ucw.cz,
robh+dt@kernel.org, krzysztof.kozlowski+dt@linaro.org,
linux-iio@vger.kernel.org, linux-arm-kernel@lists.infradead.org,
linux-mediatek@lists.infradead.org, linux-kernel@vger.kernel.org,
dri-devel@lists.freedesktop.org, linux-leds@vger.kernel.org,
devicetree@vger.kernel.org, linux-pm@vger.kernel.org,
linux-usb@vger.kernel.org, linux-fbdev@vger.kernel.org,
szunichen@gmail.com, ChiaEn Wu <chiaen_wu@richtek.com>
Subject: Re: [PATCH v2 07/15] Documentation: ABI: testing: mt6370: Add ADC sysfs guideline
Date: Sat, 18 Jun 2022 16:48:20 +0100 [thread overview]
Message-ID: <20220618164820.2eeb8ae8@jic23-huawei> (raw)
In-Reply-To: <20220613111146.25221-8-peterwu.pub@gmail.com>
On Mon, 13 Jun 2022 19:11:38 +0800
ChiaEn Wu <peterwu.pub@gmail.com> wrote:
> From: ChiaEn Wu <chiaen_wu@richtek.com>
>
> Add ABI documentation for mt6370 non-standard ADC sysfs interfaces.
>
> Signed-off-by: ChiaEn Wu <chiaen_wu@richtek.com>
> ---
> .../ABI/testing/sysfs-bus-iio-adc-mt6370 | 36 +++++++++++++++++++
> 1 file changed, 36 insertions(+)
> create mode 100644 Documentation/ABI/testing/sysfs-bus-iio-adc-mt6370
>
> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-adc-mt6370 b/Documentation/ABI/testing/sysfs-bus-iio-adc-mt6370
> new file mode 100644
> index 000000000000..039b3381176a
> --- /dev/null
> +++ b/Documentation/ABI/testing/sysfs-bus-iio-adc-mt6370
> @@ -0,0 +1,36 @@
> +What: /sys/bus/iio/devices/iio:deviceX/in_voltage0_raw
Unfortunately the kernel documentation build scripts do no support duplicating
standard ABI for particular devices so as to provide more information.
Hence you can't have anything in this file.
> +KernelVersion: 5.18
> +Contact: chiaen_wu@richtek.com
> +Description:
> + Indicated MT6370 VBUS ADC with lower accuracy(+-75mA)
Curious though, voltage with a mA accuracy range?
This scale should be presented directly to userspace anyway so no need
for this doc.
> + higher measure range(1~22V)
> + Calculating with scale returns voltage in uV
No. All channels return in mV. That's the ABI requirement as
in sysfs-bus-iio and we cannot vary if for particular drivers. If we did
no generic tooling would work.
> +
> +What: /sys/bus/iio/devices/iio:deviceX/in_voltage1_raw
> +KernelVersion: 5.18
> +Contact: chiaen_wu@richtek.com
> +Description:
> + Indicated MT6370 VBUS ADC with higher accuracy(+-30mA)
> + lower measure range(1~9.76V)
> + Calculating with scale offset returns voltage in uV
> +
> +What: /sys/bus/iio/devices/iio:deviceX/in_voltage4_raw
> +KernelVersion: 5.18
> +Contact: chiaen_wu@richtek.com
> +Description:
> + Indicated MT6370 TS_BAT ADC
> + Calculating with scale returns voltage in uV
> +
> +What: /sys/bus/iio/devices/iio:deviceX/in_voltage7_raw
> +KernelVersion: 5.18
> +Contact: chiaen_wu@richtek.com
> +Description:
> + Indicated MT6370 CHG_VDDP ADC
> + Calculating with scale returns voltage in mV
> +
> +What: /sys/bus/iio/devices/iio:deviceX/in_temp8_raw
> +KernelVersion: 5.18
> +Contact: chiaen_wu@richtek.com
> +Description:
> + Indicated MT6370 IC junction temperature
> + Calculating with scale and offset returns temperature in degree
next prev parent reply other threads:[~2022-06-18 15:39 UTC|newest]
Thread overview: 52+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-06-13 11:11 [PATCH v2 00/15] Add Mediatek MT6370 PMIC support ChiaEn Wu
2022-06-13 11:11 ` [PATCH v2 01/15] dt-bindings: usb: Add Mediatek MT6370 TCPC ChiaEn Wu
2022-06-16 21:06 ` Krzysztof Kozlowski
2022-06-13 11:11 ` [PATCH v2 02/15] dt-bindings: power: supply: Add Mediatek MT6370 Charger ChiaEn Wu
2022-06-16 21:05 ` Krzysztof Kozlowski
2022-06-17 10:19 ` ChiaEn Wu
2022-06-17 23:12 ` Krzysztof Kozlowski
2022-06-13 11:11 ` [PATCH v2 03/15] dt-bindings: leds: mt6370: Add Mediatek mt6370 current sink type LED indicator ChiaEn Wu
2022-06-16 21:09 ` Krzysztof Kozlowski
2022-06-20 3:07 ` szuni chen
2022-06-21 12:03 ` Krzysztof Kozlowski
2022-06-13 11:11 ` [PATCH v2 04/15] dt-bindings: leds: Add Mediatek MT6370 flashlight ChiaEn Wu
2022-06-16 21:10 ` Krzysztof Kozlowski
2022-06-13 11:11 ` [PATCH v2 05/15] dt-bindings: backlight: Add Mediatek MT6370 backlight ChiaEn Wu
2022-06-16 21:13 ` Krzysztof Kozlowski
2022-06-17 10:35 ` ChiaEn Wu
2022-06-17 23:13 ` Krzysztof Kozlowski
2022-06-13 11:11 ` [PATCH v2 06/15] dt-bindings: mfd: Add Mediatek MT6370 ChiaEn Wu
2022-06-13 13:33 ` Rob Herring
2022-06-17 11:15 ` ChiaEn Wu
2022-06-17 22:43 ` Rob Herring
2022-06-16 21:15 ` Krzysztof Kozlowski
2022-06-17 11:26 ` ChiaEn Wu
2022-06-13 11:11 ` [PATCH v2 07/15] Documentation: ABI: testing: mt6370: Add ADC sysfs guideline ChiaEn Wu
2022-06-18 15:48 ` Jonathan Cameron [this message]
2022-06-20 6:00 ` ChiaEn Wu
2022-06-20 18:35 ` Jonathan Cameron
2022-06-21 2:42 ` ChiaEn Wu
2022-06-13 11:11 ` [PATCH v2 08/15] mfd: mt6370: Add Mediatek MT6370 support ChiaEn Wu
2022-06-13 20:14 ` Randy Dunlap
2022-06-15 22:49 ` Lee Jones
2022-06-17 17:15 ` ChiaEn Wu
2022-06-27 14:14 ` Lee Jones
2022-06-27 15:35 ` ChiaEn Wu
2022-06-27 16:28 ` Lee Jones
2022-06-18 15:55 ` Jonathan Cameron
2022-06-13 11:11 ` [PATCH v2 09/15] usb: typec: tcpci_mt6370: Add Mediatek MT6370 tcpci driver ChiaEn Wu
2022-06-13 11:11 ` [PATCH v2 10/15] regulator: mt6370: Add mt6370 DisplayBias and VibLDO support ChiaEn Wu
2022-06-13 20:15 ` Randy Dunlap
2022-06-17 9:06 ` ChiaEn Wu
2022-06-13 11:11 ` [PATCH v2 11/15] iio: adc: mt6370: Add Mediatek MT6370 support ChiaEn Wu
2022-06-13 20:17 ` Randy Dunlap
2022-06-17 9:15 ` ChiaEn Wu
2022-06-18 16:09 ` Jonathan Cameron
2022-06-13 11:11 ` [PATCH v2 12/15] power: supply: mt6370: Add Mediatek MT6370 charger driver ChiaEn Wu
2022-06-13 11:11 ` [PATCH v2 13/15] leds: mt6370: Add Mediatek MT6370 current sink type LED Indicator support ChiaEn Wu
2022-06-13 20:20 ` Randy Dunlap
2022-06-13 11:11 ` [PATCH v2 14/15] leds: flashlight: mt6370: Add Mediatek MT6370 flashlight support ChiaEn Wu
2022-06-13 11:11 ` [PATCH v2 15/15] video: backlight: mt6370: Add Mediatek MT6370 support ChiaEn Wu
2022-06-13 17:08 ` Daniel Thompson
2022-06-17 9:34 ` ChiaEn Wu
2022-06-13 20:21 ` Randy Dunlap
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20220618164820.2eeb8ae8@jic23-huawei \
--to=jic23@kernel.org \
--cc=chiaen_wu@richtek.com \
--cc=daniel.thompson@linaro.org \
--cc=devicetree@vger.kernel.org \
--cc=dri-devel@lists.freedesktop.org \
--cc=jingoohan1@gmail.com \
--cc=krzysztof.kozlowski+dt@linaro.org \
--cc=lars@metafoo.de \
--cc=lee.jones@linaro.org \
--cc=linux-arm-kernel@lists.infradead.org \
--cc=linux-fbdev@vger.kernel.org \
--cc=linux-iio@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-leds@vger.kernel.org \
--cc=linux-mediatek@lists.infradead.org \
--cc=linux-pm@vger.kernel.org \
--cc=linux-usb@vger.kernel.org \
--cc=matthias.bgg@gmail.com \
--cc=pavel@ucw.cz \
--cc=peterwu.pub@gmail.com \
--cc=robh+dt@kernel.org \
--cc=szunichen@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).