From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-7.8 required=3.0 tests=DKIMWL_WL_HIGH,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY, SPF_PASS,URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 115A7ECE561 for ; Sun, 16 Sep 2018 10:12:57 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 981872147A for ; Sun, 16 Sep 2018 10:12:56 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (1024-bit key) header.d=kernel.org header.i=@kernel.org header.b="QgUr54JH" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 981872147A Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=kernel.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728057AbeIPPfQ (ORCPT ); Sun, 16 Sep 2018 11:35:16 -0400 Received: from mail.kernel.org ([198.145.29.99]:54938 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727666AbeIPPfQ (ORCPT ); Sun, 16 Sep 2018 11:35:16 -0400 Received: from archlinux (cpc91196-cmbg18-2-0-cust659.5-4.cable.virginm.net [81.96.234.148]) (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 B3DB1208DD; Sun, 16 Sep 2018 10:12:45 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1537092770; bh=uK1G2ZDTM7nPRZYXUpKBIekOac31q+xnXz1TY6uz7CY=; h=Date:From:To:Cc:Subject:In-Reply-To:References:From; b=QgUr54JHNu6ksMcWbU9wLGExXfxGQr/2/z/JAbOPcxvmMEHIbQMmf7wYjbxMsG6Mz /Fc2kbwFzIe0ZMPxRDCu3cSEOC35VspQVYB9OoZSOQJLXNqfrwSDOJVYdyQ5Mk287t bNBnP8ckT0PTeTWs8C1DUNAId0ipZz4Ca7X0b2F0= Date: Sun, 16 Sep 2018 11:12:42 +0100 From: Jonathan Cameron To: Manish Narani Cc: , , , , , , , , , , , , , , , , , , , , , , , , , Subject: Re: [PATCH v2 2/4] iio: Documentation: Add Xilinx AMS sysfs documentation Message-ID: <20180916111242.73af71ed@archlinux> In-Reply-To: <1536909510-7166-3-git-send-email-manish.narani@xilinx.com> References: <1536909510-7166-1-git-send-email-manish.narani@xilinx.com> <1536909510-7166-3-git-send-email-manish.narani@xilinx.com> X-Mailer: Claws Mail 3.17.1 (GTK+ 2.24.32; x86_64-pc-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Fri, 14 Sep 2018 12:48:28 +0530 Manish Narani wrote: > Add documentation for xilinx-ams driver. This contains information about > various voltages and temperatures on PS (Processing System), PL > (Programmable Logic) and AMS Control Block. > > Signed-off-by: Manish Narani The more I look at this device the more I'm convinced it is very much a dedicated hardware monitoring function, not a generic ADC sensing unit at all. Hmm. It is still fine to have it in IIO but you need to think in detail about how you are going to interface this to hwmon via the iio-hwmon bridge. Some of the interface complexity should only really be apparent when we hit hwmon perhaps rather than having so many different custom interfaces in IIO. Please also loop in the maintainers and lists for hwmon in the next version so we can get their input. Thanks, Jonathan > --- > .../ABI/testing/sysfs-bus-iio-adc-xilinx-ams | 246 +++++++++++++++++++++ > 1 file changed, 246 insertions(+) > create mode 100644 Documentation/ABI/testing/sysfs-bus-iio-adc-xilinx-ams > > diff --git a/Documentation/ABI/testing/sysfs-bus-iio-adc-xilinx-ams b/Documentation/ABI/testing/sysfs-bus-iio-adc-xilinx-ams > new file mode 100644 > index 0000000..589c389 > --- /dev/null > +++ b/Documentation/ABI/testing/sysfs-bus-iio-adc-xilinx-ams > @@ -0,0 +1,246 @@ > +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_vccpsintlp > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Voltage input for PS (Processing System) LPD (Low Power Domain) > + power supply. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_vccpsintfp > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Voltage input for PS (Processing System) FPD (Full Power Domain) > + power supply. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_vccpsaux > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Voltage input for PS (Processing System) Auxiliary power > + supply. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_vccpsddr > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Voltage input for PS (Processing System) I/O bank 504 (DDR > + PHY) power supply. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_vccpsio3 > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Voltage input for PS (Processing System) I/O bank 503 > + (boot, config, JTAG, SRST, POR) power supply. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_vccpsio0 > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Voltage input for PS (Processing System) I/O bank 500 > + (MIO[0:25]) power supply. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_vccpsio1 > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Voltage input for PS (Processing System) I/O bank 501 > + (MIO[26:51]) power supply. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_vccpsio2 > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Voltage input for PS (Processing System) I/O bank 502 > + (MIO[52:77]) power supply. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_psmgtravcc > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Voltage input for PS (Processing System) GTR SerDes I/O > + power supply. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_psmgtravtt > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Voltage input for PS (Processing System) GTR SerDes > + terminators power supply. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_vccams > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Voltage input for PS (Processing System) SYSMON ADC circuitry > + power supply. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_vccint > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Voltage input for PL (Programmable Logic) internal power supply. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_vccvrefp > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Voltage input for PL (Programmable Logic) ADC positive V > + reference power supply. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_vccvrefn > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Voltage input for PL (Programmable Logic) ADC negative V > + reference power supply. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_vccplintlp > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Voltage input for PL (Programmable Logic) LPD (Low Power Domain) > + power supply. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_vccplintfp > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Voltage input for PL (Programmable Logic) FPD (Full Power > + Domain) power supply. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_vccplaux > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Voltage input for PL (Programmable Logic) Auxiliary power > + supply. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_vccvpvn > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Voltage input for PL (Programmable Logic) Analog Input Pins > + power supply. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_vuserZ > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Voltage input for PL (Programmable Logic) Fabric Analog Wires > + power supply. Z is the number in range of 0 to 3. This one superficially sounds like a general purpose input? The vuser part doesn't mean anything to the user. If you care about the pin mapping use the datasheet name fields. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_vcc_pspll0 > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Voltage input for AMS (Analog Monitoring System) Systems PLLs > + power supply. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_vcc_psbatt > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Voltage input for AMS (Analog Monitoring System) Battery power > + supply. Why does this one merit a ps in it's name and the extra underscore by the vccbram doesn't? These need to be consistent. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_vccbram > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Voltage input for AMS (Analog Monitoring System) Block RAM power > + supply. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_vccaux > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Voltage input for AMS (Analog Monitoring System) Auxiliary power > + supply. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_psddrpll > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Voltage input for AMS (Analog Monitoring System) DDR I/O > + PLLs [0:5] power supply. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY_psintfpddr That is not a human readable bit of naming... What is the intf part about for example? Perhaps use some underscores to break up the name. Stringing acronyms into one doesn't make it easy to parse in my head! > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Voltage input for AMS (Analog Monitoring System) DDR controller > + power supply. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_tempY_ps_temp > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Temperature input for PS (Processing System) RPU MPCore. > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_tempY_remote_temp > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Temperature input for PS (Processing System) APU MPCore. This presumably is a separate external sensor attached to some pins? If that's the case then perhaps it needs describing as something like... Remote temperature sensor attached to the PS (procesisng system) APU MPCore. For all these temperatures, do you intend to expose them as hwmon? (which would be more conventional) via the iio-hmwon bridge/ > + > + > +What: /sys/bus/iio/devices/iio:deviceX/in_tempY_pl_temp > +Date: September 2018 > +KernelVersion: 4.19.0 > +Contact: mnarani@xilinx.com > +Description: > + Temperature input for PL (Programmable Logic) SYSMON.