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 X-Spam-Level: X-Spam-Status: No, score=-8.3 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH,MAILING_LIST_MULTI, SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED,USER_AGENT_SANE_1 autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 00D28C432C0 for ; Wed, 27 Nov 2019 19:08:52 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id B6F16204FD for ; Wed, 27 Nov 2019 19:08:51 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b="cBhYSQtq" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726729AbfK0TIv (ORCPT ); Wed, 27 Nov 2019 14:08:51 -0500 Received: from mail-pj1-f68.google.com ([209.85.216.68]:36745 "EHLO mail-pj1-f68.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726603AbfK0TIv (ORCPT ); Wed, 27 Nov 2019 14:08:51 -0500 Received: by mail-pj1-f68.google.com with SMTP id cq11so10469082pjb.3 for ; Wed, 27 Nov 2019 11:08:50 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to:user-agent; bh=96H218eeF6JZfYrMNDF+h5hMtKA/hT5z66cJp43pWyI=; b=cBhYSQtqqblpGZTuLvw9Zy2AtHGTNb11Cv0PS7hYetaBbkMe7ErGWIdFm0vlEnXdel TcvGeq/1mQIv1xmfFebhSgBtqWrl6++3mEZlE6JislZn0hs31oLgE6qGTGaso9bLxwV+ IZ7ATIt32IYOmsObFvuCMRZ/ssF80gtkdicmECoVcnU+rtYwLHOFJKwrdAlZB7Hog9QF +yetSrMXtQG0ew2J2aQdW3zNRSh6ZV/JgzaCRL91dAlJ/O03WzBLJ3aAW4WFBthNEet8 cnfoFp/f6wwGgqLQZENpR+M/DJ1fpfi//9tMCyuhZT2MjS8oiGOvxkb0b+ND7GVmGWmi zJpg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to:user-agent; bh=96H218eeF6JZfYrMNDF+h5hMtKA/hT5z66cJp43pWyI=; b=YjVJGASFmvigfuJsihwvEYS1X1xx6xy3R6RPdKUvpESnN+dgo4ScLtkNTpDNNU+f8O YjH1Om3ROvY8yWoQMmvCeLQQvpQlx/u6zYvkwFVXQVBKQ4VfKFbcWF8dNFHiglDtWMLx 6Dckult8/pdIwFZvE9kuG8wTzI+SNbESoD/EJbUwgIuJg4GdFyOSylIb44wr4/+IJ0Sh mQK2OQGafJgjVCB+1/lAA2iZn0ND2Ona1dEeedUXeIpu0ncBB3eTAbp4xx0lN0ptiNrJ 4kVNKPcFhoI33X4f0qRQJd98zuHhZEwMUcySrqi4WHbl3jVqLC17lnoUk89mV2iGJebx kT6g== X-Gm-Message-State: APjAAAV471MgWm/gFC4fPNl+NdWbzv8ABI3ADhBJqi8beD2vTV2PewZu 65F2Y4HE6cC6Z0Hg0NeCOssrxg== X-Google-Smtp-Source: APXvYqx+Un/0YdMBxWG9C8VV0SxFi2jCnPHkzXbhC8ezEmt5lN/1Liha59YFuItEO5sEs4Vpn4hO9g== X-Received: by 2002:a17:902:b68c:: with SMTP id c12mr5680161pls.126.1574881730173; Wed, 27 Nov 2019 11:08:50 -0800 (PST) Received: from xps15 (S0106002369de4dac.cg.shawcable.net. [68.147.8.254]) by smtp.gmail.com with ESMTPSA id j18sm957568pfn.112.2019.11.27.11.08.49 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Wed, 27 Nov 2019 11:08:49 -0800 (PST) Date: Wed, 27 Nov 2019 12:08:47 -0700 From: Mathieu Poirier To: Mike Leach Cc: coresight@lists.linaro.org, linux-arm-kernel@lists.infradead.org, devicetree@vger.kernel.org, linux-doc@vger.kernel.org, suzuki.poulose@arm.com Subject: Re: [PATCH v5 14/14] docs: sysfs: coresight: Add sysfs ABI documentation for CTI Message-ID: <20191127190847.GE26544@xps15> References: <20191119231912.12768-1-mike.leach@linaro.org> <20191119231912.12768-15-mike.leach@linaro.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20191119231912.12768-15-mike.leach@linaro.org> User-Agent: Mutt/1.9.4 (2018-02-28) Sender: linux-doc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org On Tue, Nov 19, 2019 at 11:19:12PM +0000, Mike Leach wrote: > Add API usage document for sysfs API in CTI driver. > > Signed-off-by: Mike Leach > --- > .../testing/sysfs-bus-coresight-devices-cti | 221 ++++++++++++++++++ > 1 file changed, 221 insertions(+) > create mode 100644 Documentation/ABI/testing/sysfs-bus-coresight-devices-cti > > diff --git a/Documentation/ABI/testing/sysfs-bus-coresight-devices-cti b/Documentation/ABI/testing/sysfs-bus-coresight-devices-cti > new file mode 100644 > index 000000000000..d867800f567f > --- /dev/null > +++ b/Documentation/ABI/testing/sysfs-bus-coresight-devices-cti > @@ -0,0 +1,221 @@ > +What: /sys/bus/coresight/devices//enable > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (RW) Enable/Disable the CTI hardware. This will (likely) go in kernel 5.6 that should be released in January 2020. In your next revision please add yourself as an official reviewer to the coresight subsystem. This should be done at the end of the set, in a patch on its own. Thanks, Mathieu > + > +What: /sys/bus/coresight/devices//ctmid > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (R) Display the associated CTM ID > + > +What: /sys/bus/coresight/devices//nr_trigger_cons > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (R) Number of devices connected to triggers on this CTI > + > +What: /sys/bus/coresight/devices//triggers/name > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (R) Name of connected device > + > +What: /sys/bus/coresight/devices//triggers/in_signals > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (R) Input trigger signals from connected device > + > +What: /sys/bus/coresight/devices//triggers/in_types > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (R) Functional types for the input trigger signals > + from connected device > + > +What: /sys/bus/coresight/devices//triggers/out_signals > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (R) Output trigger signals to connected device > + > +What: /sys/bus/coresight/devices//triggers/out_types > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (R) Functional types for the output trigger signals > + to connected device > + > +What: /sys/bus/coresight/devices//regs/inout_sel > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (RW) Select the index for inen and outen registers. > + > +What: /sys/bus/coresight/devices//regs/inen > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (RW) Read or write the CTIINEN register selected by inout_sel. > + > +What: /sys/bus/coresight/devices//regs/outen > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (RW) Read or write the CTIOUTEN register selected by inout_sel. > + > +What: /sys/bus/coresight/devices//regs/gate > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (RW) Read or write CTIGATE register. > + > +What: /sys/bus/coresight/devices//regs/asicctl > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (RW) Read or write ASICCTL register. > + > +What: /sys/bus/coresight/devices//regs/intack > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (W) Write the INTACK register. > + > +What: /sys/bus/coresight/devices//regs/appset > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (RW) Set CTIAPPSET register to activate channel. Read back to > + determine current value of register. > + > +What: /sys/bus/coresight/devices//regs/appclear > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (W) Write APPCLEAR register to deactivate channel. > + > +What: /sys/bus/coresight/devices//regs/apppulse > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (W) Write APPPULSE to pulse a channel active for one clock > + cycle. > + > +What: /sys/bus/coresight/devices//regs/chinstatus > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (R) Read current status of channel inputs. > + > +What: /sys/bus/coresight/devices//regs/choutstatus > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (R) read current status of channel outputs. > + > +What: /sys/bus/coresight/devices//regs/triginstatus > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (R) read current status of input trigger signals > + > +What: /sys/bus/coresight/devices//regs/trigoutstatus > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (R) read current status of output trigger signals. > + > +What: /sys/bus/coresight/devices//channels/trigin_attach > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (W) Attach a CTI input trigger to a CTM channel. > + > +What: /sys/bus/coresight/devices//channels/trigin_detach > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (W) Detach a CTI input trigger from a CTM channel. > + > +What: /sys/bus/coresight/devices//channels/trigout_attach > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (W) Attach a CTI output trigger to a CTM channel. > + > +What: /sys/bus/coresight/devices//channels/trigout_detach > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (W) Detach a CTI output trigger from a CTM channel. > + > +What: /sys/bus/coresight/devices//channels/chan_gate_enable > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (RW) Enable CTIGATE for single channel (W) or list enabled > + channels through the gate (R). > + > +What: /sys/bus/coresight/devices//channels/chan_gate_disable > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (W) Disable CTIGATE for single channel. > + > +What: /sys/bus/coresight/devices//channels/chan_set > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (W) Activate a single channel. > + > +What: /sys/bus/coresight/devices//channels/chan_clear > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (W) Deactivate a single channel. > + > +What: /sys/bus/coresight/devices//channels/chan_pulse > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (W) Pulse a single channel - activate for a single clock cycle. > + > +What: /sys/bus/coresight/devices//channels/trigout_filtered > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (R) List of output triggers filtered across all connections. > + > +What: /sys/bus/coresight/devices//channels/trig_filter_enable > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (RW) Enable or disable trigger output signal filtering. > + > +What: /sys/bus/coresight/devices//channels/chan_inuse > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (R) show channels with at least one attached trigger signal. > + > +What: /sys/bus/coresight/devices//channels/chan_free > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (R) show channels with no attached trigger signals. > + > +What: /sys/bus/coresight/devices//channels/chan_xtrigs_view > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (RW) Write channel number to select a channel to view, read to > + see triggers attached to selected channel on this CTI. > + > +What: /sys/bus/coresight/devices//channels/chan_xtrigs_reset > +Date: Jul 2019 > +KernelVersion 5.4 > +Contact: Mike Leach or Mathieu Poirier > +Description: (W) Clear all channel / trigger programming. > -- > 2.17.1 >