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 Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 7078AC25B0F for ; Sat, 13 Aug 2022 22:47:25 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229517AbiHMWrY (ORCPT ); Sat, 13 Aug 2022 18:47:24 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:59054 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229609AbiHMWrV (ORCPT ); Sat, 13 Aug 2022 18:47:21 -0400 Received: from mail-qt1-x82a.google.com (mail-qt1-x82a.google.com [IPv6:2607:f8b0:4864:20::82a]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id BB83472866 for ; Sat, 13 Aug 2022 15:47:20 -0700 (PDT) Received: by mail-qt1-x82a.google.com with SMTP id c20so3227666qtw.8 for ; Sat, 13 Aug 2022 15:47:20 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:from:to:cc; bh=9LFLBJaya1h09m2Uy33ayjw6aK7QAV0Ax/8vkX3cn+s=; b=E2sMdmSZeqX6vDy6vAuqauLIjYQ7VjfdsxyB75VdTqRZ83V+6iyp7VuvJnSh3eMWBN kB+ahjW80Wl3+HTEEqi7vRgXu6orLrJJ/nLJgX35SGFaDeFJJISHlQFIonSNC8+Gf6RE iV0BCxq24IPh0pA/B33geDauQSjynNaUkjVZlpDNuHV7ckFM8nyhAS1Y1JCaWgWJoRST mro0JpilWNSNgIlilACajSgm8oOLwVLNPyYSwaSFY+luy01n+TJib4bTNpYfqb6O3qMm MZSUTGgbs6UsVUUAezGpJTIMgu9maBAkQVNge6A57cE2WLSqFPO5P3MpYgWdIFpOE/1C eWLg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:x-gm-message-state:from:to:cc; bh=9LFLBJaya1h09m2Uy33ayjw6aK7QAV0Ax/8vkX3cn+s=; b=FV8eiYEfbOrrMkD6t5hgbyei1EeyxelSnVG1bwhfgsppWESv7KodkDmORx2S9L0Fgw +c0DkNyGSv/EblRI8IcHpNr9LCEC/DA31g1UswlNB3keN8yTQ8jrCWqhpcjMpAGQCQbd 3O+hLSEQIUVOf1dPQKEt4K5rObnNtQCrceiNpK/uMWACwFZSutnoRo3v4INJT4Sx2oIv deSNqGsoZovnHF/qqru9NPtxMASSQWuG/kPT+kOTJ+Wv3ky6saXAYqzUGppoNrGKXwm1 28q1QyZ4Zg0lauJfKhk/zelMY0A8RDq3aDZKubiPnhK59j79G7+OF8whxAf8xrzN+xlR RHPA== X-Gm-Message-State: ACgBeo0MNQ0msAoDHuoc42YLfsRIPeADRI+B5shj4bnolJbdxhQbOX5O keGa2SCzG/rcjUbjX+JUoLx9nA== X-Google-Smtp-Source: AA6agR5Tfq6TPQUxc+yP0HMrhhSRR875Ule/igBA2OayHC6AArFEzuS79M7WPDhU/j/ysxONb6yCWQ== X-Received: by 2002:a05:622a:1c3:b0:344:56b5:f14b with SMTP id t3-20020a05622a01c300b0034456b5f14bmr442813qtw.152.1660430839835; Sat, 13 Aug 2022 15:47:19 -0700 (PDT) Received: from fedora (69-109-179-158.lightspeed.dybhfl.sbcglobal.net. [69.109.179.158]) by smtp.gmail.com with ESMTPSA id x20-20020a05620a0b5400b006aee5df383csm4777866qkg.134.2022.08.13.15.47.18 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 13 Aug 2022 15:47:19 -0700 (PDT) Date: Sat, 13 Aug 2022 18:47:17 -0400 From: William Breathitt Gray To: Julien Panis Cc: robh+dt@kernel.org, krzysztof.kozlowski+dt@linaro.org, linux-iio@vger.kernel.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, mranostay@ti.com Subject: Re: [PATCH v4 2/3] Documentation: ABI: add sysfs-bus-counter-ecap Message-ID: References: <20220810140724.182389-1-jpanis@baylibre.com> <20220810140724.182389-3-jpanis@baylibre.com> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="R+ComDZuVIk5knoa" Content-Disposition: inline In-Reply-To: <20220810140724.182389-3-jpanis@baylibre.com> Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org --R+ComDZuVIk5knoa Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed, Aug 10, 2022 at 04:07:23PM +0200, Julien Panis wrote: > This commit adds an ABI file for TI ECAP used in capture operating mode. >=20 > Signed-off-by: Julien Panis Hi Julien, Duplicate ABIs are no longer valid, so we consolidated the Counter sysfs attributes documentation to a single sysfs-bus-counter file in commit 769841c966fd. You can document the new sysfs attributes you introduce for the TI eCAP counter driver to that sysfs-bus-counter file as well. William Breathitt Gray > --- > .../ABI/testing/sysfs-bus-counter-ecap | 64 +++++++++++++++++++ > 1 file changed, 64 insertions(+) > create mode 100644 Documentation/ABI/testing/sysfs-bus-counter-ecap >=20 > diff --git a/Documentation/ABI/testing/sysfs-bus-counter-ecap b/Documenta= tion/ABI/testing/sysfs-bus-counter-ecap > new file mode 100644 > index 000000000000..ca530a6806de > --- /dev/null > +++ b/Documentation/ABI/testing/sysfs-bus-counter-ecap > @@ -0,0 +1,64 @@ > +What: /sys/bus/counter/devices/counter0/signal0/polarity1 > +What: /sys/bus/counter/devices/counter0/signal0/polarity2 > +What: /sys/bus/counter/devices/counter0/signal0/polarity3 > +What: /sys/bus/counter/devices/counter0/signal0/polarity4 > +KernelVersion: 5.19 > +Contact: jpanis@baylibre.com > +Description: > + ECAP module includes 4 timestamp capture registers. > + For all 4 sequenced timestamp capture events (1->2->3->4->1->...), > + edge polarity can be selected. Then, each capture register can be > + tuned to capture event by either: > + > + - "rising" > + - "falling" > + > + Reading returns current trigger polarity. > + > + Writing value before enabling capture sets trigger polarity. > + > +What: /sys/bus/counter/devices/counter0/signal0/polarity1_available > +What: /sys/bus/counter/devices/counter0/signal0/polarity2_available > +What: /sys/bus/counter/devices/counter0/signal0/polarity3_available > +What: /sys/bus/counter/devices/counter0/signal0/polarity4_available > +KernelVersion: 5.19 > +Contact: jpanis@baylibre.com > +Description: > + Discrete set of available values for the respective polarity X > + configuration are listed in this file. Values are delimited by > + newline characters. > + > +What: /sys/bus/counter/devices/counter0/count0/enable > +KernelVersion: 5.19 > +Contact: jpanis@baylibre.com > +Description: > + Whether ECAP is enabled. Valid attribute values are boolean. > + > + This attribute is intended to serve as a start/stop mechanism > + for ECAP. > + > +What: /sys/bus/counter/devices/counter0/count0/count > +KernelVersion: 5.19 > +Contact: jpanis@baylibre.com > +Description: > + Read-only attribute that indicates the current base counter value. > + > +What: /sys/bus/counter/devices/counter0/count0/capture1 > +What: /sys/bus/counter/devices/counter0/count0/capture2 > +What: /sys/bus/counter/devices/counter0/count0/capture3 > +What: /sys/bus/counter/devices/counter0/count0/capture4 > +KernelVersion: 5.19 > +Contact: jpanis@baylibre.com > +Description: > + Read-only attributes that indicate the last timestamp captured > + for the respective capture X register. > + > +What: /sys/bus/counter/devices/counter0/count0/capture1_component_id > +What: /sys/bus/counter/devices/counter0/count0/capture2_component_id > +What: /sys/bus/counter/devices/counter0/count0/capture3_component_id > +What: /sys/bus/counter/devices/counter0/count0/capture4_component_id > +KernelVersion: 5.19 > +Contact: jpanis@baylibre.com > +Description: > + Read-only attributes that indicate the component ID of the > + respective extension or synapse. > --=20 > 2.25.1 >=20 --R+ComDZuVIk5knoa Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iHUEARYKAB0WIQSNN83d4NIlKPjon7a1SFbKvhIjKwUCYvgp9QAKCRC1SFbKvhIj K+hOAP9FJPw/AbXZbCmP3t4cfCY2o6AER5KkmaxTEu0mFDAafwEApCOn+i40k5FZ CqEdQohSPhKXNuCBLsp8BBgdR1MLZQg= =jfdg -----END PGP SIGNATURE----- --R+ComDZuVIk5knoa--