Received: by 2002:a05:6a10:22f:0:0:0:0 with SMTP id 15csp1059653pxk; Fri, 25 Sep 2020 05:19:03 -0700 (PDT) X-Google-Smtp-Source: ABdhPJy6fPqHDyFeGMdiQhQGanBfwlA62Ro/Wwcpjgqkfv5ApQL4KCi5Uh52onYbStn4WfOQ2a/z X-Received: by 2002:a05:6402:1773:: with SMTP id da19mr940151edb.171.1601036343600; Fri, 25 Sep 2020 05:19:03 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1601036343; cv=none; d=google.com; s=arc-20160816; b=VIZXjahVwtUzgA/Mmq6Tcw67KmxeGQvkDvhAmWrckER/Gar9gpx64dr4/FsM9/SrW4 G0Oq9iXLcNTJy834haS38uGD5uO6j+nKqJlpdG1QsH5yjlNEc4+b/lm2ZdmFIhTzmF3F SgBayuYMn9UPtvAgZRB4QymUKHBsjrw+gG1LtMdwL6U3rqkKS8BMvHNq8xAu4IqF7kie 5Q59DZHl/FeUIt8LBM0XxDNdS51zsR6BMWjoQrFOvqVPo/eZJODYGgn6DslkO0YeMRj9 y3yS36Byu9O9M8n5p69QK5suY0yG9+rth6o8SRDU7RFidWmhNIPBaHeBEIYSdOh+rwhu wX+g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:subject:cc:to:from:date :dkim-signature; bh=UXZ4fQpz5eVa02D0S8Tsn2VB0qfFvXDnaiLILEHggBk=; b=rCVChbJkTeP4dbW5uHJLhfOCHF5Hl6JhOZyQ1zhnWV361lHob0sorlrVj5NdvPs2bK uCfVGeFcqUhL+RfqDe/fHwNuBtLmSGejdEq0j72xD5MH5itBHRrL2DI8tzenq9eMURD8 gboM7Vzc1KRnPqDgGBPzAIFCwkdHF6nzwzs3TnrxvI1UDkuzoWWhPUmdSF02sdd9Pssg DKFQl1sDre/DllN1wLflmwOnY8mwFKhcKj3n/FT5DXQ5+5vXP3fcvthO0U1g1/vSAT6G vg5pQiY4MuG8ZMcbYB1mNvpvAksT7GyKWGJoFVtFNncIk0Qz5VykAfrxlcooLHOyi2xK 0r1g== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=no4C+nJy; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id v2si1745635ejy.65.2020.09.25.05.18.40; Fri, 25 Sep 2020 05:19:03 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=no4C+nJy; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728408AbgIYMP5 (ORCPT + 99 others); Fri, 25 Sep 2020 08:15:57 -0400 Received: from mail.kernel.org ([198.145.29.99]:35348 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727132AbgIYMP5 (ORCPT ); Fri, 25 Sep 2020 08:15:57 -0400 Received: from archlinux (cpc149474-cmbg20-2-0-cust94.5-4.cable.virginm.net [82.4.196.95]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 989BA21D7A; Fri, 25 Sep 2020 12:15:53 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1601036156; bh=kwR9lgq75oem2SESbbdu8Dipj1Q8zTQ+UnnWezcapFI=; h=Date:From:To:Cc:Subject:In-Reply-To:References:From; b=no4C+nJyV2mcqN2CwSdvw/0kwskREmHydE8VA5s7AbOR06GF2CsyHrzSHOMM0Z3/t emMPgDLX9SOBleJLLUfsVNObhQW1CVUljmp3BccgSxyS2FIa8fje8dvxvlCpzo4SP5 a6kO5w+gcFyndNxj5dH1yqRhVVV3CbXU4mcHjskI= Date: Fri, 25 Sep 2020 13:15:50 +0100 From: Jonathan Cameron To: Gene Chen Cc: robh+dt@kernel.org, matthias.bgg@gmail.com, knaack.h@gmx.de, lars@metafoo.de, pmeerw@pmeerw.net, devicetree@vger.kernel.org, linux-iio@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-mediatek@lists.infradead.org, linux-kernel@vger.kernel.org, gene_chen@richtek.com, Wilma.Wu@mediatek.com, shufan_lee@richtek.com, cy_huang@richtek.com, benjamin.chao@mediatek.com Subject: Re: [PATCH v5 2/3] Documentation: ABI: testing: mt6360: Add ADC sysfs guideline Message-ID: <20200925131550.10717161@archlinux> In-Reply-To: <1600687442-23658-3-git-send-email-gene.chen.richtek@gmail.com> References: <1600687442-23658-1-git-send-email-gene.chen.richtek@gmail.com> <1600687442-23658-3-git-send-email-gene.chen.richtek@gmail.com> X-Mailer: Claws Mail 3.17.6 (GTK+ 2.24.32; x86_64-pc-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Mon, 21 Sep 2020 19:24:01 +0800 Gene Chen wrote: > From: Gene Chen > > Add ABI documentation for mt6360 ADC sysfs interfaces. > > Signed-off-by: Gene Chen Hi Gene, My first thought was we don't need this now we are dealing with standard ABI only, but there is some useful additional documentation in here which is good to have. Looks good to me! Thanks, Jonathan > --- > Documentation/ABI/testing/sysfs-bus-iio-adc-mt6360 | 78 ++++++++++++++++++++++ > 1 file changed, 78 insertions(+) > create mode 100644 Documentation/ABI/testing/sysfs-bus-iio-adc-mt6360 > > diff --git a/Documentation/ABI/testing/sysfs-bus-iio-adc-mt6360 b/Documentation/ABI/testing/sysfs-bus-iio-adc-mt6360 > new file mode 100644 > index 0000000..e5a7b1c > --- /dev/null > +++ b/Documentation/ABI/testing/sysfs-bus-iio-adc-mt6360 > @@ -0,0 +1,78 @@ > +What: /sys/bus/iio/devices/iio:deviceX/in_voltage0_raw > +KernelVersion: 5.8.0 > +Contact: gene_chen@richtek.com > +Description: > + Indicated MT6360 USBID ADC which connected to connector ID pin. > + Calculating with scale and offset returns voltage in uV > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltage1_raw > +KernelVersion: 5.8.0 > +Contact: gene_chen@richtek.com > +Description: > + Indicated MT6360 VBUS ADC with lower accuracy(+-75mA) > + higher measure range(1~22mV) > + Calculating with scale and offset returns voltage in uV > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltage2_raw > +KernelVersion: 5.8.0 > +Contact: gene_chen@richtek.com > +Description: > + Indicated MT6360 VBUS ADC with higher accuracy(+-30mA) > + lower measure range(1~9.76V) > + Calculating with scale and offset returns voltage in uV > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltage3_raw > +KernelVersion: 5.8.0 > +Contact: gene_chen@richtek.com > +Description: > + Indicated MT6360 VSYS ADC > + Calculating with scale and offset returns voltage in uV > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltage4_raw > +KernelVersion: 5.8.0 > +Contact: gene_chen@richtek.com > +Description: > + Indicated MT6360 VBAT ADC > + Calculating with scale and offset returns voltage in uV > + > +What: /sys/bus/iio/devices/iio:deviceX/in_current5_raw > +KernelVersion: 5.8.0 > +Contact: gene_chen@richtek.com > +Description: > + Indicated MT6360 IBUS ADC > + Calculating with scale and offset returns voltage in uA > + > +What: /sys/bus/iio/devices/iio:deviceX/in_current6_raw > +KernelVersion: 5.8.0 > +Contact: gene_chen@richtek.com > +Description: > + Indicated MT6360 IBAT ADC > + Calculating with scale and offset returns voltage in uA > + > +What: /sys/bus/iio/devices/iio:deviceX/in_current7_raw > +KernelVersion: 5.8.0 > +Contact: gene_chen@richtek.com > +Description: > + Indicated MT6360 CHG_VDDP ADC > + Calculating with scale and offset returns voltage in uV > + > +What: /sys/bus/iio/devices/iio:deviceX/in_temp8_raw > +KernelVersion: 5.8.0 > +Contact: gene_chen@richtek.com > +Description: > + Indicated MT6360 IC junction temperature > + Calculating with scale and offset returns temperature in degree > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltage9_raw > +KernelVersion: 5.8.0 > +Contact: gene_chen@richtek.com > +Description: > + Indicated MT6360 VREF_TS ADC > + Calculating with scale and offset returns voltage in uV > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltage10_raw > +KernelVersion: 5.8.0 > +Contact: gene_chen@richtek.com > +Description: > + Indicated MT6360 TS ADC > + Calculating with scale and offset returns voltage in uV