From patchwork Fri Apr 12 03:21:01 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Kim Seer Paller X-Patchwork-Id: 13626738 Received: from mx0b-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 1380617BDD; Fri, 12 Apr 2024 03:21:52 +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=1712892114; cv=none; b=KdmLnbMPu/JNNpEjo63hDsMDVes0r26lgK09BVfdcn34cftbrSaBC20OC78sERnOHiknBQ6WdASCyh9A2vf+hnULe+YCuwDaYVU3+RMiP2kXM3KxMrbhL/ovEu8eNWFNL7ImAAzogZQKJ/I3or1CvgFE0+7+M3V6ikGtVDRgCko= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1712892114; c=relaxed/simple; bh=l5A4vxQ7tsKU2pvs1CtcYasieAlxi0kY2xAYz2jv4z8=; h=From:To:CC:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=fHT7npybOw2twjlTuTo/WjtqnTTg07RQRJKCw/K+sfoaBUyg8HxMNQIBQnMWOLssa+Hf7suKCHREGFWtUHxaoc/zmuhDM38sKJPUyUC9xIzPW+SS4rpBy0GfsT+JOHi15vS7Boc2Z3TfD48jsNFLzDZqTn7NYi8M/8pxW5SAg2g= 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=FJ44YAlC; 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="FJ44YAlC" Received: from pps.filterd (m0375855.ppops.net [127.0.0.1]) by mx0b-00128a01.pphosted.com (8.17.1.24/8.17.1.24) with ESMTP id 43C33Clc013858; Thu, 11 Apr 2024 23:21:37 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=analog.com; h= from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding:content-type; s=DKIM; bh=0FpVZp5rgKR3BFnV+2O0H0nhcKqHXyxleMBi+/JGkBo=; b=FJ44YAlCnQeU JCbheJCOgVlDlv+24VB3sfWXuOeQAv88T8Y9qsqcJNFaPX1zFGZMt+eMSeRBwXkW uHVbwysr05rzmrcEq4+tlsDR6eNb4oPRCZkQWCM3Fjzg9APV+tcqmKEMlsjV1LYA jnf7qrRZk/CePgHln4m/74YH/qddV2XODDSLo1iktVxFM+w/cVtRXQhKu+Zyt9a0 mnV+T4xa3m35TxEW5saMAPYNOZeOdRINlA0vzuw3TiMO1qCGgo0gsuORIG0yEbXP hl6T4HHiMQgMjQQgiB0o5huCM4ZnDpZfdloRMJfySJpj3TgT/C/ojg5VMY4Ml5x5 D/bhvVpHPg== Received: from nwd2mta3.analog.com ([137.71.173.56]) by mx0b-00128a01.pphosted.com (PPS) with ESMTPS id 3xek1f27nq-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Thu, 11 Apr 2024 23:21:37 -0400 (EDT) Received: from ASHBMBX8.ad.analog.com (ASHBMBX8.ad.analog.com [10.64.17.5]) by nwd2mta3.analog.com (8.14.7/8.14.7) with ESMTP id 43C3LZIk021581 (version=TLSv1/SSLv3 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Thu, 11 Apr 2024 23:21:35 -0400 Received: from ASHBCASHYB5.ad.analog.com (10.64.17.133) 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; Thu, 11 Apr 2024 23:21:35 -0400 Received: from ASHBMBX8.ad.analog.com (10.64.17.5) by ASHBCASHYB5.ad.analog.com (10.64.17.133) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.14; Thu, 11 Apr 2024 23:21:34 -0400 Received: from zeus.spd.analog.com (10.66.68.11) by ashbmbx8.ad.analog.com (10.64.17.5) with Microsoft SMTP Server id 15.2.986.14 via Frontend Transport; Thu, 11 Apr 2024 23:21:34 -0400 Received: from kim-VirtualBox.ad.analog.com (KPALLER2-L03.ad.analog.com [10.117.220.36]) by zeus.spd.analog.com (8.15.1/8.15.1) with ESMTP id 43C3L8ph021230; Thu, 11 Apr 2024 23:21:28 -0400 From: Kim Seer Paller To: , , CC: Jonathan Cameron , Lars-Peter Clausen , Rob Herring , Krzysztof Kozlowski , Conor Dooley , "Liam Girdwood" , Mark Brown , "David Lechner" , Michael Hennerich Subject: [PATCH 3/4] iio: ABI: add ABI file for the LTC2672 DAC Date: Fri, 12 Apr 2024 11:21:01 +0800 Message-ID: <20240412032102.136071-4-kimseer.paller@analog.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20240412032102.136071-1-kimseer.paller@analog.com> References: <20240412032102.136071-1-kimseer.paller@analog.com> 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-GUID: QB7jeWZ8gygj_1Mbw2bdSfiS5i9maYyn X-Proofpoint-ORIG-GUID: QB7jeWZ8gygj_1Mbw2bdSfiS5i9maYyn X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.272,Aquarius:18.0.1011,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2024-04-11_14,2024-04-09_01,2023-05-22_02 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 malwarescore=0 impostorscore=0 lowpriorityscore=0 mlxlogscore=999 suspectscore=0 phishscore=0 clxscore=1015 adultscore=0 priorityscore=1501 spamscore=0 bulkscore=0 mlxscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.19.0-2404010003 definitions=main-2404120023 Define the sysfs interface for toggle capable channels. Toggle enabled channels will have: * out_currentY_toggle_en * out_currentY_raw0 * out_currentY_raw1 * out_currentY_symbol The common interface present in all channels is: * out_currentY_raw (not present in toggle enabled channels) * out_currentY_raw_available * out_currentY_powerdown * out_currentY_scale * out_currentY_offset Co-developed-by: Michael Hennerich Signed-off-by: Michael Hennerich Signed-off-by: Kim Seer Paller --- .../ABI/testing/sysfs-bus-iio-dac-ltc2672 | 30 +++++++++++++++++++ MAINTAINERS | 1 + 2 files changed, 31 insertions(+) create mode 100644 Documentation/ABI/testing/sysfs-bus-iio-dac-ltc2672 diff --git a/Documentation/ABI/testing/sysfs-bus-iio-dac-ltc2672 b/Documentation/ABI/testing/sysfs-bus-iio-dac-ltc2672 new file mode 100644 index 000000000..b984d92f7 --- /dev/null +++ b/Documentation/ABI/testing/sysfs-bus-iio-dac-ltc2672 @@ -0,0 +1,30 @@ +What: /sys/bus/iio/devices/iio:deviceX/out_currentY_toggle_en +KernelVersion: 5.18 +Contact: linux-iio@vger.kernel.org +Description: + Toggle enable. Write 1 to enable toggle or 0 to disable it. This is + useful when one wants to change the DAC output codes. The way it should + be done is: + + - disable toggle operation; + - change out_currentY_raw0 and out_currentY_raw1; + - enable toggle operation. + +What: /sys/bus/iio/devices/iio:deviceX/out_currentY_raw0 +What: /sys/bus/iio/devices/iio:deviceX/out_currentY_raw1 +KernelVersion: 5.18 +Contact: linux-iio@vger.kernel.org +Description: + It has the same meaning as out_currentY_raw. This attribute is + specific to toggle enabled channels and refers to the DAC output + code in INPUT_A (_raw0) and INPUT_B (_raw1). The same scale and offset + as in out_currentY_raw applies. + +What: /sys/bus/iio/devices/iio:deviceX/out_currentY_symbol +KernelVersion: 5.18 +Contact: linux-iio@vger.kernel.org +Description: + Performs a SW toggle. This attribute is specific to toggle + enabled channels and allows to toggle between out_currentY_raw0 + and out_currentY_raw1 through software. Writing 0 will select + out_currentY_raw0 while 1 selects out_currentY_raw1. diff --git a/MAINTAINERS b/MAINTAINERS index 9ed00b364..fba8bacc0 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -12843,6 +12843,7 @@ L: linux-iio@vger.kernel.org S: Supported W: https://ez.analog.com/linux-software-drivers F: Documentation/ABI/testing/sysfs-bus-iio-dac-ltc2664 +F: Documentation/ABI/testing/sysfs-bus-iio-dac-ltc2672 F: Documentation/devicetree/bindings/iio/dac/adi,ltc2664.yaml LTC2688 IIO DAC DRIVER