Received: by 2002:ab2:69cc:0:b0:1f4:be93:e15a with SMTP id n12csp556804lqp; Sat, 13 Apr 2024 08:27:07 -0700 (PDT) X-Forwarded-Encrypted: i=3; AJvYcCXDanswVj/iCAmll0J973AeWhAxKncqqZ36hexWRbiP7RQ1Ks3tjJbqoMzpcgqr06DVNZfEBREP/PjtdGznhkaP5RIjAJUsosNUe+S5cw== X-Google-Smtp-Source: AGHT+IH2/9r5B/t6BKS9kpEdcBQomkVSzbdWH8v3biWIa+Aa+YIa2zjwgy17oEDYOLGNBGULhlXO X-Received: by 2002:a50:99d6:0:b0:56e:2e9b:1341 with SMTP id n22-20020a5099d6000000b0056e2e9b1341mr3930913edb.38.1713022026981; Sat, 13 Apr 2024 08:27:06 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1713022026; cv=pass; d=google.com; s=arc-20160816; b=o07Toe6S3mDJ9rzCBetSEWlx2Sv8EY3vZnp7BFQvz99yWEQDmrUZgwsJ4kpjYrBrpZ PZUiAzuV3ggSmJt8LeXu2O5T2U5SMypaOvNoSFoXBRCmlxkLQwPqw1kw0Orhv5YjxO55 eMdcq5vS0HqjdyQ1u54VoSbjaQj5jQzRLovy08SWNsfUEpczt2i51Eop9fcMN2jFvfcQ S56X08b9kvCO87iLYQHpJoc02CROyyXI98zenwgtAQ31SgURUeHlXU8hMt+oRBQeQRbo mojgXn/qvQ2C4L46ejuSxllWxfoEQfCFAO9+LPOfPwcJ8vJblVY3Mwno6iv2zQNHJwc5 nHdw== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:references:in-reply-to:message-id :subject:cc:to:from:date:dkim-signature; bh=5Z5ma4BP1z3k9Lv+vQhStPN6Sr1rEG8FPtCy9XUSnhk=; fh=ttpAnqOgnHOCQVaL6rDfeguW8+tY3Ud0LwoodktGSnc=; b=EbGfRkiKhjcjC55LXTTUoc0hQDevRPCHfPTEPzh26n3uqqubitsKgRHPMGxg2ujIWz Jx7zuk2jKhkKaEwjGFpx1cqXqXLMUerWPYUi6J/4RAhgpccmcqW9PzPa4xQ4inGclzbe aX0G1Gx69yugO48fuThqzj7PvDDsDlTMlg73MLdQoZAz58NPJVEx/HClDshZP3zcAXD6 mE/pGzyUpknUn1DdEKdD+0iuM+WxoGZX/PsBXUhnmC1UP9rC/kS1sM+QQYkoE/V53GvY qI1cGLKo7z+LjMT4EwWGPBiawsx6+wBXjW6hJL3Q9ZPgk+bLzggLrYbjUhsE30HJDNwo 1pQw==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=SF1OPY7g; arc=pass (i=1 dkim=pass dkdomain=kernel.org); spf=pass (google.com: domain of linux-kernel+bounces-143782-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-143782-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [2604:1380:4601:e00::3]) by mx.google.com with ESMTPS id z15-20020a5096cf000000b0056e2a459f81si2696118eda.627.2024.04.13.08.27.06 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 13 Apr 2024 08:27:06 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel+bounces-143782-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) client-ip=2604:1380:4601:e00::3; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=SF1OPY7g; arc=pass (i=1 dkim=pass dkdomain=kernel.org); spf=pass (google.com: domain of linux-kernel+bounces-143782-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-143782-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by am.mirrors.kernel.org (Postfix) with ESMTPS id B278D1F218C6 for ; Sat, 13 Apr 2024 15:27:06 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id C164147A7A; Sat, 13 Apr 2024 15:26:57 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="SF1OPY7g" Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (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 D89E245C0B; Sat, 13 Apr 2024 15:26:56 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1713022017; cv=none; b=aZCdZ4g5g50ovnSrhx6RUQKkk+pvRqRaXiCb3F6WJoX3Xc3m6g8GB+/gKisFoNJRLIb7srtx8q++EU26RlZjJy2ix1mIcrtqJlhcBiRhX/6tXQPT7IoiKfTOA7OZTluvq5LfzSCq+sa0GEhf7fv4pe6fGMizUfVv+jicjaOstrQ= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1713022017; c=relaxed/simple; bh=yjYE4O7v8bZRGxr3/fWFg7rBzUco5Yk1lqn4sxx6848=; h=Date:From:To:Cc:Subject:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=CxDuTZzl9vrtJrDj96Ybcl129vSHTs2tvx76wUIJIonYUn94Ezsg9fjVJP8iMwBSjNfEiqFWam9+EHuvkydPEOkzCXnIbYcxEOGqxb5rl3qrUeFAJEX/8GSB9iT+/qpwzQry3EyMMnFMvLSsRpu1RaxzhLlsMmB4EzVAx1xwmMU= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=SF1OPY7g; arc=none smtp.client-ip=10.30.226.201 Received: by smtp.kernel.org (Postfix) with ESMTPSA id 9040CC113CD; Sat, 13 Apr 2024 15:26:51 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1713022016; bh=yjYE4O7v8bZRGxr3/fWFg7rBzUco5Yk1lqn4sxx6848=; h=Date:From:To:Cc:Subject:In-Reply-To:References:From; b=SF1OPY7gtVfCVCF2OwCr+czoXz8yLNtPKWcUg5kkOV2l3krgyqVQEhlD5Q4B9WJG1 8EytEX09YOM47V76Q9p0u5QITIMmTF67MALEL8yX37kRym9qzJ4Z7PfuSP9ppCbIkC I6WKSbV1aIAUW68BoZYaHhdF4smqFdV93fMQ7Ux0bsahCJnoSPC32OqpfhYqplE9j5 AnZ3pmIgt7d2eKk1wDWqVW2SwCJSi0cIMbu+hRXJlOZby4WBx+vHndxj0RH8BEIfNc J+GXw9Rq7FhTleWkyZMx+Q2i8l14qfEiNxXvCRt1uXlQV8FhZZFIzxkE/LQzmnn3VI qnv6TQ+ndV/iQ== Date: Sat, 13 Apr 2024 16:26:40 +0100 From: Jonathan Cameron To: Kim Seer Paller Cc: , , , Lars-Peter Clausen , Rob Herring , Krzysztof Kozlowski , Conor Dooley , "Liam Girdwood" , Mark Brown , "David Lechner" , Michael Hennerich Subject: Re: [PATCH 3/4] iio: ABI: add ABI file for the LTC2672 DAC Message-ID: <20240413162640.77c6fc56@jic23-huawei> In-Reply-To: <20240412032102.136071-4-kimseer.paller@analog.com> References: <20240412032102.136071-1-kimseer.paller@analog.com> <20240412032102.136071-4-kimseer.paller@analog.com> X-Mailer: Claws Mail 4.2.0 (GTK 3.24.41; x86_64-pc-linux-gnu) Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit On Fri, 12 Apr 2024 11:21:01 +0800 Kim Seer Paller wrote: > 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 +++++++++++++++++++ You can only have per device ABI defined if that is the only user of the ABI. That may actually be true here but given I've asked you to generalize the voltage equivalent, I think we've shown this is general enough that the current version should also be raised to sysfs-bus-iio-dac > 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