Received: by 2002:a05:6a10:a0d1:0:0:0:0 with SMTP id j17csp4057263pxa; Sun, 9 Aug 2020 22:26:42 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwnWAZ2dmz7MWtURLczvzNJk/54nQACB4niEmgq7kEuvZcs7QeHGN+TN0jmmBe7GdNREhKK X-Received: by 2002:a17:906:c1d8:: with SMTP id bw24mr19764382ejb.91.1597037202030; Sun, 09 Aug 2020 22:26:42 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1597037202; cv=none; d=google.com; s=arc-20160816; b=qTCotb3P/FVK93xSRgY+9H8qVQVqalcpUUcWfhKLUN7skP9vrT55518UwhaMXqcH0V jSJMJjWUsl33x8G1lEergGHmiEPb2wdGwHCMyG9pcJ8HcGKky5EWZGsBsL8b6qAt8sR4 6et1v/6xXTx4Im9mBTRyKQmdsF4Us0O+NXvrWfvRoSKm7qm/6YGUXNt+6o8qOWov2H4C DkFaS31oqZDpsKLjlOuSt2gm59c/hdLu+Cp8BK92CGPXx0kVIYRHnBv+pIaNMEe+KrcC iyfAwyJupsTjaHGVPrcBIlLgiFrJNsfC3iaE1GSKuP+ZQPqAPCGOqCGh7hW2Z6+kDQ2O onZA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from; bh=GsZTaXkcA/OTlvpJndbj0n/Z62bDj6T4AX2iaIBCDfc=; b=pqlbg6hCrXtlEAPEvlffbfXPtseNaCrqrcPtOwFcTMrLWeykAK/JfnGMqq1YsMi0eF zqEiuWnlXhALV3y5glguFDll1L2ryAXx0yH/3nQ1AtvI6805bEQmmFXzhkxwepsV8mz+ e01NE4nf8/a2+8YJwcZ/vhuuLGsgQ78X+tNNmxQUz5ucz6abvozF71axy8R09DTZZ9gW dysJnJvdNBAzsGNZnggXG9yxtMS3Rxr+gLoyIrxJzQFqjNypH6vN3gKJJ18csRylJzeY jrqIoYqGbcjQSykYYkX5Flg6NZUyUlj9E4aBbqCOUTRmHQ8u52TBdiOeIiwKBBme6amC K97A== ARC-Authentication-Results: i=1; mx.google.com; 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 Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id u18si9786482ejr.700.2020.08.09.22.26.18; Sun, 09 Aug 2020 22:26:42 -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; 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 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1725858AbgHJFZr (ORCPT + 99 others); Mon, 10 Aug 2020 01:25:47 -0400 Received: from mailout02.rmx.de ([62.245.148.41]:40642 "EHLO mailout02.rmx.de" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725763AbgHJFZr (ORCPT ); Mon, 10 Aug 2020 01:25:47 -0400 Received: from kdin01.retarus.com (kdin01.dmz1.retloc [172.19.17.48]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mailout02.rmx.de (Postfix) with ESMTPS id 4BQ4Dj3T1szNr0V; Mon, 10 Aug 2020 07:25:41 +0200 (CEST) Received: from mta.arri.de (unknown [217.111.95.66]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA384 (256/256 bits)) (No client certificate requested) by kdin01.retarus.com (Postfix) with ESMTPS id 4BQ4D83Gmnz2xhm; Mon, 10 Aug 2020 07:25:12 +0200 (CEST) Received: from N95HX1G2.wgnetz.xx (192.168.54.33) by mta.arri.de (192.168.100.104) with Microsoft SMTP Server (TLS) id 14.3.408.0; Mon, 10 Aug 2020 07:25:11 +0200 From: Christian Eggers To: Jonathan Cameron , Jonathan Cameron CC: Andy Shevchenko , Hartmut Knaack , Lars-Peter Clausen , "Peter Meerwald-Stadler" , , , Christian Eggers Subject: [PATCH v2] iio: documentation: light: Add as73211 sysfs documentation Date: Mon, 10 Aug 2020 07:24:47 +0200 Message-ID: <20200810052447.12381-1-ceggers@arri.de> X-Mailer: git-send-email 2.26.2 In-Reply-To: <20200809123000.5131effd@archlinux> References: <20200809123000.5131effd@archlinux> MIME-Version: 1.0 Content-Transfer-Encoding: 7BIT Content-Type: text/plain; charset=US-ASCII X-Originating-IP: [192.168.54.33] X-RMX-ID: 20200810-072512-4BQ4D83Gmnz2xhm-0@kdin01 X-RMX-SOURCE: 217.111.95.66 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org The driver for the as73211 light sensor provides the following not yet documented sysfs entries: - in_intensity_(x|y|z)_raw - in_intensity_(x|y|z)_scale - in_intensity_sampling_frequency(_available) - in_intensity_hardwaregain(_available) - in_intensity_integration_time Signed-off-by: Christian Eggers --- Jonathan Cameron: > If it is shared across 'ALL' channels then it will be just integration_time > If it is shared across all channels of a given type, it will be _integration_time. changed. Best regards Christian Eggers Documentation/ABI/testing/sysfs-bus-iio | 26 ++++++++++++++++++++++++- 1 file changed, 25 insertions(+), 1 deletion(-) diff --git a/Documentation/ABI/testing/sysfs-bus-iio b/Documentation/ABI/testing/sysfs-bus-iio index d3e53a6d8331..388560149875 100644 --- a/Documentation/ABI/testing/sysfs-bus-iio +++ b/Documentation/ABI/testing/sysfs-bus-iio @@ -40,6 +40,7 @@ Description: buffered samples and events for device X. What: /sys/bus/iio/devices/iio:deviceX/sampling_frequency +What: /sys/bus/iio/devices/iio:deviceX/in_intensity_sampling_frequency What: /sys/bus/iio/devices/iio:deviceX/buffer/sampling_frequency What: /sys/bus/iio/devices/triggerX/sampling_frequency KernelVersion: 2.6.35 @@ -55,6 +56,7 @@ Description: then it is to be found in the base device directory. What: /sys/bus/iio/devices/iio:deviceX/sampling_frequency_available +What: /sys/bus/iio/devices/iio:deviceX/in_intensity_sampling_frequency_available What: /sys/bus/iio/devices/iio:deviceX/in_proximity_sampling_frequency_available What: /sys/.../iio:deviceX/buffer/sampling_frequency_available What: /sys/bus/iio/devices/triggerX/sampling_frequency_available @@ -374,6 +376,9 @@ What: /sys/bus/iio/devices/iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_scale What: /sys/bus/iio/devices/iio:deviceX/in_illuminance_scale What: /sys/bus/iio/devices/iio:deviceX/in_countY_scale What: /sys/bus/iio/devices/iio:deviceX/in_angl_scale +What: /sys/bus/iio/devices/iio:deviceX/in_intensity_x_scale +What: /sys/bus/iio/devices/iio:deviceX/in_intensity_y_scale +What: /sys/bus/iio/devices/iio:deviceX/in_intensity_z_scale KernelVersion: 2.6.35 Contact: linux-iio@vger.kernel.org Description: @@ -484,6 +489,7 @@ Description: are listed in this attribute. What /sys/bus/iio/devices/iio:deviceX/out_voltageY_hardwaregain +What: /sys/bus/iio/devices/iio:deviceX/in_intensity_hardwaregain What: /sys/bus/iio/devices/iio:deviceX/in_intensity_red_hardwaregain What: /sys/bus/iio/devices/iio:deviceX/in_intensity_green_hardwaregain What: /sys/bus/iio/devices/iio:deviceX/in_intensity_blue_hardwaregain @@ -494,6 +500,13 @@ Description: Hardware applied gain factor. If shared across all channels, _hardwaregain is used. +What: /sys/bus/iio/devices/iio:deviceX/in_intensity_hardwaregain_available +KernelVersion: 5.10 +Contact: linux-iio@vger.kernel.org +Description: + Lists all available hardware applied gain factors. Shared across all + channels. + What: /sys/.../in_accel_filter_low_pass_3db_frequency What: /sys/.../in_magn_filter_low_pass_3db_frequency What: /sys/.../in_anglvel_filter_low_pass_3db_frequency @@ -1333,6 +1346,7 @@ Description: standardised CIE Erythemal Action Spectrum. UV index values range from 0 (low) to >=11 (extreme). +What: /sys/.../iio:deviceX/in_intensity_integration_time What: /sys/.../iio:deviceX/in_intensity_red_integration_time What: /sys/.../iio:deviceX/in_intensity_green_integration_time What: /sys/.../iio:deviceX/in_intensity_blue_integration_time @@ -1342,7 +1356,8 @@ KernelVersion: 3.12 Contact: linux-iio@vger.kernel.org Description: This attribute is used to get/set the integration time in - seconds. + seconds. If shared across all channels of a given type, + _integration_time is used. What: /sys/.../iio:deviceX/in_velocity_sqrt(x^2+y^2+z^2)_integration_time KernelVersion: 4.0 @@ -1739,3 +1754,12 @@ KernelVersion: 5.5 Contact: linux-iio@vger.kernel.org Description: One of the following thermocouple types: B, E, J, K, N, R, S, T. + +What: /sys/bus/iio/devices/iio:deviceX/in_intensity_x_raw +What: /sys/bus/iio/devices/iio:deviceX/in_intensity_y_raw +What: /sys/bus/iio/devices/iio:deviceX/in_intensity_z_raw +KernelVersion: 5.10 +Contact: linux-iio@vger.kernel.org +Description: + Unscaled light intensity according to CIE 1931/DIN 5033 color space. + Units after application of scale are nano nanowatts per square meter. -- Christian Eggers Embedded software developer Arnold & Richter Cine Technik GmbH & Co. Betriebs KG Sitz: Muenchen - Registergericht: Amtsgericht Muenchen - Handelsregisternummer: HRA 57918 Persoenlich haftender Gesellschafter: Arnold & Richter Cine Technik GmbH Sitz: Muenchen - Registergericht: Amtsgericht Muenchen - Handelsregisternummer: HRB 54477 Geschaeftsfuehrer: Dr. Michael Neuhaeuser; Stephan Schenk; Walter Trauninger; Markus Zeiler