From patchwork Tue Jan 7 15:12:02 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Marcelo Schmitt X-Patchwork-Id: 13929141 Received: from mx0a-00128a01.pphosted.com (mx0a-00128a01.pphosted.com [148.163.135.77]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 256211F239C; Tue, 7 Jan 2025 15:12:36 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=148.163.135.77 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1736262760; cv=none; b=J+Boa2zp9iUTuFSLvXK7RBn3cH4AXuWn0FE/1ko52+CxVYPVchTmcSe1bXn9rBUlydAMQxzNh9UIrji50dGy2Sd9CFtjIRdXYJ7i0pjX7pDwqV1wt3HpiVpOkLz5aFckbzG4+ugzrBA+82klu6HegzXV7nlwtxPTGDDT9M57RzY= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1736262760; c=relaxed/simple; bh=gKNuXGhTh95DXAr4G4BnEi38AxqgBGf2PSTsSrQbXiM=; h=From:To:CC:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=Z5txF5H+KsN983ZAh5snXVEVJT1Uv4iIIguWdY4LhmVDF1fk9zs7/SU0Y6Z2lFF5CgYQUJC6KYsL6GBqkg/n1qIXXGOKxUGQJBDM9n9mJLaSHHUKqsOPL9ZpG2n5s4tbsnH+WQr3FuEoSmuVwekhXHItPeg/HQZsnCVzPsdc5FQ= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=analog.com; spf=pass smtp.mailfrom=analog.com; dkim=pass (2048-bit key) header.d=analog.com header.i=@analog.com header.b=TUQf/ZT0; arc=none smtp.client-ip=148.163.135.77 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=analog.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=analog.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=analog.com header.i=@analog.com header.b="TUQf/ZT0" Received: from pps.filterd (m0167088.ppops.net [127.0.0.1]) by mx0a-00128a01.pphosted.com (8.18.1.2/8.18.1.2) with ESMTP id 507EvlCw014417; Tue, 7 Jan 2025 10:12:21 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=analog.com; h=cc :content-transfer-encoding:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to; s=DKIM; bh=9WAYh DkRvqVnvAjude8p/d1i1sL4tPJ5n3R/3cX2LHk=; b=TUQf/ZT0ViEBBICpkB+SJ lrKBaD/uGNZmW4AjAfv0j6hntoZzzdvFUUCXfwIdz1OlTA7FNHZVQ62MuVKYZELT bBxLzizcJj8SNCsfdBSOqmTnM366gGRWbkTSCTOO9ZoYHx5RLer+Jr7r2S3sTiY7 bRznBml1ttV9xBRLOZ5HHkBoqtnfCK78EcQ2hVyXE19wIxWJ2VNi0+L/sK14pFMW SCxkAeo5f8lV+CY8uzN/3T85IpYoAuXqBGdr2RotZgEIyUlhznek2HxUoEm/1pdT 0xDB45wK7hA9HtWK5Wpe/2UytnmzRcUiBqWTtkIBW2oOKG06OOwTiNbr5NR4jjcr w== Received: from nwd2mta4.analog.com ([137.71.173.58]) by mx0a-00128a01.pphosted.com (PPS) with ESMTPS id 4415f6gbrp-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Tue, 07 Jan 2025 10:12:21 -0500 (EST) Received: from ASHBMBX9.ad.analog.com (ASHBMBX9.ad.analog.com [10.64.17.10]) by nwd2mta4.analog.com (8.14.7/8.14.7) with ESMTP id 507FCJRt033332 (version=TLSv1/SSLv3 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Tue, 7 Jan 2025 10:12:20 -0500 Received: from ASHBCASHYB4.ad.analog.com (10.64.17.132) by ASHBMBX9.ad.analog.com (10.64.17.10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.14; Tue, 7 Jan 2025 10:12:19 -0500 Received: from ASHBMBX9.ad.analog.com (10.64.17.10) by ASHBCASHYB4.ad.analog.com (10.64.17.132) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.14; Tue, 7 Jan 2025 10:12:19 -0500 Received: from zeus.spd.analog.com (10.66.68.11) by ashbmbx9.ad.analog.com (10.64.17.10) with Microsoft SMTP Server id 15.2.986.14 via Frontend Transport; Tue, 7 Jan 2025 10:12:19 -0500 Received: from work.ad.analog.com (HYB-hERzalRezfV.ad.analog.com [10.65.205.9]) by zeus.spd.analog.com (8.15.1/8.15.1) with ESMTP id 507FC4qg029724; Tue, 7 Jan 2025 10:12:07 -0500 From: Marcelo Schmitt To: , CC: , , , , , , , Subject: [PATCH v2 1/3] Documentation: ABI: IIO: Re-add sysfs-bus-iio-adc-ad4130 Date: Tue, 7 Jan 2025 12:12:02 -0300 Message-ID: X-Mailer: git-send-email 2.39.2 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-iio@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-ADIRuleOP-NewSCL: Rule Triggered X-Proofpoint-ORIG-GUID: -3Iiv9rXUB52T8ngHMLt9Vtw04Rs1ts1 X-Proofpoint-GUID: -3Iiv9rXUB52T8ngHMLt9Vtw04Rs1ts1 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1039,Hydra:6.0.680,FMLib:17.12.60.29 definitions=2024-09-06_09,2024-09-06_01,2024-09-02_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 lowpriorityscore=0 phishscore=0 mlxlogscore=999 clxscore=1011 mlxscore=0 adultscore=0 impostorscore=0 malwarescore=0 spamscore=0 suspectscore=0 priorityscore=1501 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.19.0-2411120000 definitions=main-2501070127 The ad4130 driver exports in_voltageY-voltageZ_filter_mode and in_voltage-voltage_filter_mode_available attributes to user space. A previous patch merged the documentation for those attributes with the documentation for filter_type/filter_type_available into sysfs-bus-iio. Filter mode and filter type refer to the same feature which is the digital filter applied over ADC samples. However, since datasheets use the term `filter type` and ad4130 driver is the only one using filter_mode, deprecate the filter_mode ABI in favor of filter_type and keep the docs separate to avoid confusion and intricate attribute descriptions. The digital filter helps shape the noise rejection bandwidth and is supposed to be adjusted according to the signal of interest. Depending on the particular ADC design, the digital filter configuration may have an impact on the output data rate (ODR) (which is equivalent to the sampling frequency for SAR ADCs - `sampling_frequency` ABI), 3dB cutoff frequency of the filter (`_low_pass_3db_frequency` attributes), or settling time. Digital filters are a common feature among sigma-delta ADCs and IIO drivers set digital filters according to different attributes. ad4130 and ad7779 filter options are supported through dedicated filter_mode/filter_type attributes in sysfs. ad7768-1 and ad7173 set the sinc filters according to the sampling_frequency attribute. No filter_type attribute. ad7124 sets the digital filter according to a filter_low_pass_3db_frequency attribute so it doesn't export filter type attributes to user space. Fixes: 01bb12922b60 ("Documentation: ABI: added filter mode doc in sysfs-bus-iio") Signed-off-by: Marcelo Schmitt --- Second and third paragraphs of the body could maybe go into device specific docs as suggested in some previous thread but those drivers don't have docs in Documentation/iio/ and I've been more interested in how filter_type is supported accross IIO to be able to support it appropriatly in new drivers. Documentation/ABI/testing/sysfs-bus-iio | 1 - .../ABI/testing/sysfs-bus-iio-adc-ad4130 | 55 +++++++++++++++++++ MAINTAINERS | 1 + 3 files changed, 56 insertions(+), 1 deletion(-) create mode 100644 Documentation/ABI/testing/sysfs-bus-iio-adc-ad4130 diff --git a/Documentation/ABI/testing/sysfs-bus-iio b/Documentation/ABI/testing/sysfs-bus-iio index d97c35057a03..1faac5b2ad84 100644 --- a/Documentation/ABI/testing/sysfs-bus-iio +++ b/Documentation/ABI/testing/sysfs-bus-iio @@ -2277,7 +2277,6 @@ Description: representing the sensor unique ID number. What: /sys/bus/iio/devices/iio:deviceX/filter_type_available -What: /sys/bus/iio/devices/iio:deviceX/in_voltage-voltage_filter_mode_available KernelVersion: 6.1 Contact: linux-iio@vger.kernel.org Description: diff --git a/Documentation/ABI/testing/sysfs-bus-iio-adc-ad4130 b/Documentation/ABI/testing/sysfs-bus-iio-adc-ad4130 new file mode 100644 index 000000000000..bd827186ad1f --- /dev/null +++ b/Documentation/ABI/testing/sysfs-bus-iio-adc-ad4130 @@ -0,0 +1,55 @@ +What: /sys/bus/iio/devices/iio:deviceX/in_voltage-voltage_filter_mode_available +KernelVersion: 6.2 +Contact: linux-iio@vger.kernel.org +Description: + Reading returns a list with the possible filter modes. + + * "sinc4" - Sinc 4. Excellent noise performance. Long + 1st conversion time. No natural 50/60Hz rejection. + + * "sinc4+sinc1" - Sinc4 + averaging by 8. Low 1st conversion + time. + + * "sinc3" - Sinc3. Moderate 1st conversion time. + Good noise performance. + + * "sinc3+rej60" - Sinc3 + 60Hz rejection. At a sampling + frequency of 50Hz, achieves simultaneous 50Hz and 60Hz + rejection. + + * "sinc3+sinc1" - Sinc3 + averaging by 8. Low 1st conversion + time. Best used with a sampling frequency of at least + 216.19Hz. + + * "sinc3+pf1" - Sinc3 + Post Filter 1. 53dB rejection @ + 50Hz, 58dB rejection @ 60Hz. + + * "sinc3+pf2" - Sinc3 + Post Filter 2. 70dB rejection @ + 50Hz, 70dB rejection @ 60Hz. + + * "sinc3+pf3" - Sinc3 + Post Filter 3. 99dB rejection @ + 50Hz, 103dB rejection @ 60Hz. + + * "sinc3+pf4" - Sinc3 + Post Filter 4. 103dB rejection @ + 50Hz, 109dB rejection @ 60Hz. + + This interface is deprecated; please use filter_type_available + documented in Documentation/ABI/testing/sysfs-bus-iio to provide + filter options for new drivers. + +What: /sys/bus/iio/devices/iio:deviceX/in_voltageY-voltageZ_filter_mode +KernelVersion: 6.2 +Contact: linux-iio@vger.kernel.org +Description: + Set the filter mode of the differential channel. When the filter + mode changes, the in_voltageY-voltageZ_sampling_frequency and + in_voltageY-voltageZ_sampling_frequency_available attributes + might also change to accommodate the new filter mode. + If the current sampling frequency is out of range for the new + filter mode, the sampling frequency will be changed to the + closest valid one. + + This interface is deprecated; please use + in_voltageY-voltageZ_filter_type documented in + Documentation/ABI/testing/sysfs-bus-iio to provide + filter options for new drivers. diff --git a/MAINTAINERS b/MAINTAINERS index 98a3c1e46311..28dbbf6d6efa 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -1279,6 +1279,7 @@ M: Cosmin Tanislav L: linux-iio@vger.kernel.org S: Supported W: https://ez.analog.com/linux-software-drivers +F: Documentation/ABI/testing/sysfs-bus-iio-adc-ad4130 F: Documentation/devicetree/bindings/iio/adc/adi,ad4130.yaml F: drivers/iio/adc/ad4130.c From patchwork Tue Jan 7 15:13:39 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Marcelo Schmitt X-Patchwork-Id: 13929146 Received: from mx0a-00128a01.pphosted.com (mx0a-00128a01.pphosted.com [148.163.135.77]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 698B21F2C20; Tue, 7 Jan 2025 15:14:14 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=148.163.135.77 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1736262857; cv=none; b=mOyZH4oeWThFeXFfhBeUNzaEX/a1xwbcKNhFoD9LRRar2N0jIMFIr8pNsOxN2T0TEwDfqwAVMw62OYB6Xbc8vxMsNKvx318o4yDkbwWCSo0VC4kpbiXJlX2dIngDtV2BDvtPaR6KgFiLGrvbtOtM0h95OPApOC9kDNOK7hUtiFU= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1736262857; c=relaxed/simple; bh=OWS3VmOHbA6Sm+CoV65kGZAxylw3vN1jEUei5YLsWd0=; h=From:To:CC:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=G27xxSvtCX8tj5le8FVyoW6sckYMXN4HtDbdbEWfNQUXxvHHfbmDjCgz8fowSOIyknTq/uAcJvCKueSbrtyhpyBFArUqAF0Yz4DgF7N/vgrMB51H5j418+l+S3NiLab66XDhBUgpDzcDIDbkN9qxkrJbCj1PEiYZHYgkDOXvFd8= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=analog.com; spf=pass smtp.mailfrom=analog.com; dkim=pass (2048-bit key) header.d=analog.com header.i=@analog.com header.b=zMvGFybY; arc=none smtp.client-ip=148.163.135.77 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=analog.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=analog.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=analog.com header.i=@analog.com header.b="zMvGFybY" Received: from pps.filterd (m0167088.ppops.net [127.0.0.1]) by mx0a-00128a01.pphosted.com (8.18.1.2/8.18.1.2) with ESMTP id 507EvDbY013537; Tue, 7 Jan 2025 10:13:57 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=analog.com; h=cc :content-transfer-encoding:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to; s=DKIM; bh=8cmf/ l0/aCsILDzn7CXeVkfj25iXERXekxVq/yfDRrs=; b=zMvGFybYMJMTi1sMrtxZo qc9r14JlZtEGpy+31K+O4JUksY/+Ly0pd2E1pyg83ePpDCF+LaA+mMZ6CSniZD2s D0k5uip7OAcyFZC5eMNNtFfeon38T6S3nXkFlZRcJ/A8JlO5AhMWdvroL6FJWuWe kETQf0lJCVDkShsRquahrA63+o2NQokmCqGz+5UmCXrNORSOrj95M4IGk3b8Gz+J B1DTipA4UTgYAjuzs3477mh4DsMHf0I7op9ewKjh2Zg6GAN5EKooSnJPBItwtxXR v1YPNEwVprk/KA756zpPO2mj55HTfpLu6xQCwy0vKthKiwjJe6EQASOmJUmCl+Tz A== Received: from nwd2mta4.analog.com ([137.71.173.58]) by mx0a-00128a01.pphosted.com (PPS) with ESMTPS id 4415f6gc0d-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Tue, 07 Jan 2025 10:13:57 -0500 (EST) Received: from ASHBMBX8.ad.analog.com (ASHBMBX8.ad.analog.com [10.64.17.5]) by nwd2mta4.analog.com (8.14.7/8.14.7) with ESMTP id 507FDuqv033538 (version=TLSv1/SSLv3 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Tue, 7 Jan 2025 10:13:56 -0500 Received: from ASHBCASHYB4.ad.analog.com (10.64.17.132) by ASHBMBX8.ad.analog.com (10.64.17.5) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.14; Tue, 7 Jan 2025 10:13:56 -0500 Received: from ASHBMBX9.ad.analog.com (10.64.17.10) by ASHBCASHYB4.ad.analog.com (10.64.17.132) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.14; Tue, 7 Jan 2025 10:13:56 -0500 Received: from zeus.spd.analog.com (10.66.68.11) by ashbmbx9.ad.analog.com (10.64.17.10) with Microsoft SMTP Server id 15.2.986.14 via Frontend Transport; Tue, 7 Jan 2025 10:13:56 -0500 Received: from work.ad.analog.com (HYB-hERzalRezfV.ad.analog.com [10.65.205.9]) by zeus.spd.analog.com (8.15.1/8.15.1) with ESMTP id 507FDeXm029895; Tue, 7 Jan 2025 10:13:43 -0500 From: Marcelo Schmitt To: , CC: , , , , , , , Subject: [PATCH v2 2/3] Documentation: ABI: IIO: Add filter_type documentation Date: Tue, 7 Jan 2025 12:13:39 -0300 Message-ID: <30cf1924e6745e1e67a6543bef5bde578e7b1452.1736261048.git.marcelo.schmitt@analog.com> X-Mailer: git-send-email 2.39.2 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-iio@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-ADIRuleOP-NewSCL: Rule Triggered X-Proofpoint-ORIG-GUID: _nlZar0UstC0FIl1ho0pctKmhq3azkju X-Proofpoint-GUID: _nlZar0UstC0FIl1ho0pctKmhq3azkju X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1039,Hydra:6.0.680,FMLib:17.12.60.29 definitions=2024-09-06_09,2024-09-06_01,2024-09-02_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 lowpriorityscore=0 phishscore=0 mlxlogscore=999 clxscore=1015 mlxscore=0 adultscore=0 impostorscore=0 malwarescore=0 spamscore=0 suspectscore=0 priorityscore=1501 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.19.0-2411120000 definitions=main-2501070127 A previous patch added documentation for filter_type_available attributes. However, the description for the value attribute (filter_type) was missing. Add documentation for filter_type sysfs ABI. Fixes: 01bb12922b60 ("Documentation: ABI: added filter mode doc in sysfs-bus-iio") Signed-off-by: Marcelo Schmitt --- Documentation/ABI/testing/sysfs-bus-iio | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/Documentation/ABI/testing/sysfs-bus-iio b/Documentation/ABI/testing/sysfs-bus-iio index 1faac5b2ad84..1ddf3d7dd2b3 100644 --- a/Documentation/ABI/testing/sysfs-bus-iio +++ b/Documentation/ABI/testing/sysfs-bus-iio @@ -2299,6 +2299,13 @@ Description: * "sinc3+pf3" - Sinc3 + device specific Post Filter 3. * "sinc3+pf4" - Sinc3 + device specific Post Filter 4. +What: /sys/bus/iio/devices/iio:deviceX/filter_type +KernelVersion: 6.1 +Contact: linux-iio@vger.kernel.org +Description: + Specifies which filter type apply to the channel. The possible + values are given by the filter_type_available attribute. + What: /sys/.../events/in_proximity_thresh_either_runningperiod KernelVersion: 6.6 Contact: linux-iio@vger.kernel.org From patchwork Tue Jan 7 15:13:58 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Marcelo Schmitt X-Patchwork-Id: 13929147 Received: from mx0a-00128a01.pphosted.com (mx0a-00128a01.pphosted.com [148.163.135.77]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 93E0C1E377F; Tue, 7 Jan 2025 15:14:32 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=148.163.135.77 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1736262874; cv=none; b=JUB5JBn9/i05JDgyBtPlfRzL2mccBaghwfseKMALZ7BawNWpOjfLA6FEq5W8sL9x3XzKVfylGVRg/soYpumJXoIt7HOwaP4Ra626fn2QMvWjF95sME1qTRCrRnCFNxRt0BwFDheQv8FGGbtLoa+ZtovJDRw1iRAl91a9cVuY0e8= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1736262874; c=relaxed/simple; bh=NMYUwlFnQ00zAJN/gcwg4jMYr2nTTDrMP6U2gBts5Zo=; h=From:To:CC:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=PkvhSNEn/Gzi9ypQqh43eoAopEYLKl8TN0vAcSc5gmOsSh46kCrdxd08b2d++4w1UDmT1AtdY+CqGRHZ/bF1Q7DqKkv/qR1o3Bd63TqoXZ08CFcMDAA/fNs9xBcstB8o1Gsem4SsETltpMRNdOA/MdH0vS+E46KFISjd/dyv/dA= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=analog.com; spf=pass smtp.mailfrom=analog.com; dkim=pass (2048-bit key) header.d=analog.com header.i=@analog.com header.b=m+g/Imfj; arc=none smtp.client-ip=148.163.135.77 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=analog.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=analog.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=analog.com header.i=@analog.com header.b="m+g/Imfj" Received: from pps.filterd (m0167089.ppops.net [127.0.0.1]) by mx0a-00128a01.pphosted.com (8.18.1.2/8.18.1.2) with ESMTP id 507EvDpi008016; Tue, 7 Jan 2025 10:14:17 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=analog.com; h=cc :content-transfer-encoding:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to; s=DKIM; bh=d5mL9 MyfdZRgNBJPVHrhytM+BCqFw35SuFYUL/7tsSo=; b=m+g/Imfj7QlMr2FyeCp/P UmWdJcrIQxVLyHImfUhp9CP5M/CdwuI6fwcBWeDg/5TC99UKHGn4P+IbMhG7o2s8 kQ1u/4XKAOdYGsGA+BulBgtBV274s0Coei5vYS4AEm/j4o3RacEyjj9ZHJnnAVV0 aFLPX+95wgvTJE6NBV4ELKQM5ui+gHB1UUN0ODktvTRxIj06ScIDUos+4i3I+ARD aT67Yd7npuk445NkE5b1jlbE4hc0s9DuuOSP7CmNuXQIEqQpbNGJgEl5S4Kkssvu SrSSCmKl2pJ9kIyJjqarz2J6pVsVVMXA6AvgXxCTa4IoaHsqxyga5/7pzi3LhuGy g== Received: from nwd2mta4.analog.com ([137.71.173.58]) by mx0a-00128a01.pphosted.com (PPS) with ESMTPS id 4410d0spr0-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Tue, 07 Jan 2025 10:14:16 -0500 (EST) Received: from ASHBMBX9.ad.analog.com (ASHBMBX9.ad.analog.com [10.64.17.10]) by nwd2mta4.analog.com (8.14.7/8.14.7) with ESMTP id 507FEFaH033754 (version=TLSv1/SSLv3 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Tue, 7 Jan 2025 10:14:15 -0500 Received: from ASHBCASHYB4.ad.analog.com (10.64.17.132) by ASHBMBX9.ad.analog.com (10.64.17.10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.14; Tue, 7 Jan 2025 10:14:15 -0500 Received: from ASHBMBX9.ad.analog.com (10.64.17.10) by ASHBCASHYB4.ad.analog.com (10.64.17.132) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.14; Tue, 7 Jan 2025 10:14:15 -0500 Received: from zeus.spd.analog.com (10.66.68.11) by ashbmbx9.ad.analog.com (10.64.17.10) with Microsoft SMTP Server id 15.2.986.14 via Frontend Transport; Tue, 7 Jan 2025 10:14:15 -0500 Received: from work.ad.analog.com (HYB-hERzalRezfV.ad.analog.com [10.65.205.9]) by zeus.spd.analog.com (8.15.1/8.15.1) with ESMTP id 507FE0Rl029900; Tue, 7 Jan 2025 10:14:03 -0500 From: Marcelo Schmitt To: , CC: , , , , , , , Subject: [PATCH v2 3/3] Documentation: ABI: IIO: Drop AD4130 specific filter_type_available options Date: Tue, 7 Jan 2025 12:13:58 -0300 Message-ID: <5b86acb56fd2aa337223a6467c1caf2a06682fcd.1736261048.git.marcelo.schmitt@analog.com> X-Mailer: git-send-email 2.39.2 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-iio@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-ADIRuleOP-NewSCL: Rule Triggered X-Proofpoint-ORIG-GUID: X8qqxE_DsBT09vwd1KrMT_naTkk4kBOo X-Proofpoint-GUID: X8qqxE_DsBT09vwd1KrMT_naTkk4kBOo X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1039,Hydra:6.0.680,FMLib:17.12.60.29 definitions=2024-09-06_09,2024-09-06_01,2024-09-02_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 clxscore=1015 lowpriorityscore=0 priorityscore=1501 suspectscore=0 impostorscore=0 malwarescore=0 mlxlogscore=999 mlxscore=0 spamscore=0 phishscore=0 bulkscore=0 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.19.0-2411120000 definitions=main-2501070127 The only driver exporting filter_type_available attribute is ad7779 and it only supports sinc3 and sinc5 filters. Remove options that are not presented through filter_type_available attribute. Signed-off-by: Marcelo Schmitt --- Maybe this is not worth it (or desirable?) since the options may come back in the future if new drivers happen to need them. Documentation/ABI/testing/sysfs-bus-iio | 21 +++++---------------- 1 file changed, 5 insertions(+), 16 deletions(-) diff --git a/Documentation/ABI/testing/sysfs-bus-iio b/Documentation/ABI/testing/sysfs-bus-iio index 1ddf3d7dd2b3..946c519f8687 100644 --- a/Documentation/ABI/testing/sysfs-bus-iio +++ b/Documentation/ABI/testing/sysfs-bus-iio @@ -2280,24 +2280,13 @@ What: /sys/bus/iio/devices/iio:deviceX/filter_type_available KernelVersion: 6.1 Contact: linux-iio@vger.kernel.org Description: - Reading returns a list with the possible filter modes. Options - for the attribute: + Lists all available filter types. Possible options for the + attribute: - * "sinc3" - The digital sinc3 filter. Moderate 1st - conversion time. Good noise performance. - * "sinc4" - Sinc 4. Excellent noise performance. Long - 1st conversion time. + * "sinc3" - The digital sinc3 filter. Moderate 1st conversion + time. Good noise performance. * "sinc5" - The digital sinc5 filter. Excellent noise - performance - * "sinc4+sinc1" - Sinc4 + averaging by 8. Low 1st conversion - time. - * "sinc3+rej60" - Sinc3 + 60Hz rejection. - * "sinc3+sinc1" - Sinc3 + averaging by 8. Low 1st conversion - time. - * "sinc3+pf1" - Sinc3 + device specific Post Filter 1. - * "sinc3+pf2" - Sinc3 + device specific Post Filter 2. - * "sinc3+pf3" - Sinc3 + device specific Post Filter 3. - * "sinc3+pf4" - Sinc3 + device specific Post Filter 4. + performance. What: /sys/bus/iio/devices/iio:deviceX/filter_type KernelVersion: 6.1