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 0A703C433EF for ; Fri, 29 Apr 2022 12:31:31 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1359192AbiD2Meq (ORCPT ); Fri, 29 Apr 2022 08:34:46 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:51530 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1359295AbiD2Mej (ORCPT ); Fri, 29 Apr 2022 08:34:39 -0400 Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by lindbergh.monkeyblade.net (Postfix) with ESMTP id AB0EDC90E7 for ; Fri, 29 Apr 2022 05:31:19 -0700 (PDT) Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 5DEC91063; Fri, 29 Apr 2022 05:31:19 -0700 (PDT) Received: from e127744.arm.com (unknown [10.57.46.19]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPA id 04ECA3F73B; Fri, 29 Apr 2022 05:31:16 -0700 (PDT) From: German Gomez To: coresight@lists.linaro.org, mathieu.poirier@linaro.org, suzuki.poulose@arm.com Cc: james.clark@arm.com, leo.yan@linaro.org, mike.leach@linaro.org, linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, German Gomez Subject: [PATCH 2/2] coresight: etm4x: docs: Add documentation for 'ts_source' sysfs interface Date: Fri, 29 Apr 2022 13:31:00 +0100 Message-Id: <20220429123100.268059-3-german.gomez@arm.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220429123100.268059-1-german.gomez@arm.com> References: <20220429123100.268059-1-german.gomez@arm.com> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Sync sysfs documentation pages to include the new ts_source (timestamp source) interface. Signed-off-by: German Gomez --- .../ABI/testing/sysfs-bus-coresight-devices-etm4x | 8 ++++++++ .../trace/coresight/coresight-etm4x-reference.rst | 14 ++++++++++++++ 2 files changed, 22 insertions(+) diff --git a/Documentation/ABI/testing/sysfs-bus-coresight-devices-etm4x b/Documentation/ABI/testing/sysfs-bus-coresight-devices-etm4x index 8e53a32f81505..19ac9d6d2f504 100644 --- a/Documentation/ABI/testing/sysfs-bus-coresight-devices-etm4x +++ b/Documentation/ABI/testing/sysfs-bus-coresight-devices-etm4x @@ -516,3 +516,11 @@ Contact: Mathieu Poirier Description: (Read) Returns the number of special conditional P1 right-hand keys that the trace unit can use (0x194). The value is taken directly from the HW. + +What: /sys/bus/coresight/devices/etm/ts_source +Date: April 2022 +KernelVersion: 5.18 +Contact: Mathieu Poirier +Description: (Read) When FEAT_TRF is implemented, value of TRFCR_ELx.TS used for + trace session. Otherwise -1 indicates an unknown time source. Check + trcidr0.tssize to see if a global timestamp is available. diff --git a/Documentation/trace/coresight/coresight-etm4x-reference.rst b/Documentation/trace/coresight/coresight-etm4x-reference.rst index d25dfe86af9bf..f016c7c29429b 100644 --- a/Documentation/trace/coresight/coresight-etm4x-reference.rst +++ b/Documentation/trace/coresight/coresight-etm4x-reference.rst @@ -71,6 +71,20 @@ the ‘TRC’ prefix. ---- +:File: ``ts_source`` (ro) +:Trace Registers: None. +:Notes: + When FEAT_TRF is implemented, value of TRFCR_ELx.TS used for trace session. Otherwise -1 + indicates an unknown time source. Check trcidr0.tssize to see if a global timestamp is + available. + +:Example: + ``$> cat ts_source`` + + ``$> 1`` + +---- + :File: ``addr_idx`` (rw) :Trace Registers: None. :Notes: -- 2.25.1 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 bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 3248EC433EF for ; Fri, 29 Apr 2022 12:33:25 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To: Message-Id:Date:Subject:Cc:To:From:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=KAcvdu9Ljs5NQNfVN92/TfpUia//0yo2MzHaz/S3HCs=; b=Z+tsAXr/wyA5yi mB9eTkihv6mS0hLDsFyrv7KAfsuTFIjy9jZGY4cZj2ztKyctW2gvZDUUfLiWFOIQ1wQMdfllHr2YZ +2FSPB3sh4Xx6dADhvmo8pthpqhm1xBjNEwEKofsfN86Y8Tz3RgfFlu8oR0+elibgHRyHs/9R9+T0 y/TaIY7fvN5qw58pwA0Ln+UKll+FynKph3brY2UmbzwMt8JWbmkmWzibkAo7dEYglZUXinNkVQ3iH HT8imu4ra0gqhOvKxAr24E4318MIF3rZgdqCmUCDNbmxSxn2Gid/uAKrZ3klxp83eY1fz/y7faFqc gHYkbKCvqTb52DJL0B6w==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1nkPnJ-00B8rC-5O; Fri, 29 Apr 2022 12:32:21 +0000 Received: from foss.arm.com ([217.140.110.172]) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1nkPmK-00B8Sa-DB for linux-arm-kernel@lists.infradead.org; Fri, 29 Apr 2022 12:31:21 +0000 Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 5DEC91063; Fri, 29 Apr 2022 05:31:19 -0700 (PDT) Received: from e127744.arm.com (unknown [10.57.46.19]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPA id 04ECA3F73B; Fri, 29 Apr 2022 05:31:16 -0700 (PDT) From: German Gomez To: coresight@lists.linaro.org, mathieu.poirier@linaro.org, suzuki.poulose@arm.com Cc: james.clark@arm.com, leo.yan@linaro.org, mike.leach@linaro.org, linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, German Gomez Subject: [PATCH 2/2] coresight: etm4x: docs: Add documentation for 'ts_source' sysfs interface Date: Fri, 29 Apr 2022 13:31:00 +0100 Message-Id: <20220429123100.268059-3-german.gomez@arm.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220429123100.268059-1-german.gomez@arm.com> References: <20220429123100.268059-1-german.gomez@arm.com> MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20220429_053120_535944_7828F70F X-CRM114-Status: UNSURE ( 8.21 ) X-CRM114-Notice: Please train this message. X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org U3luYyBzeXNmcyBkb2N1bWVudGF0aW9uIHBhZ2VzIHRvIGluY2x1ZGUgdGhlIG5ldyB0c19zb3Vy Y2UgKHRpbWVzdGFtcApzb3VyY2UpIGludGVyZmFjZS4KClNpZ25lZC1vZmYtYnk6IEdlcm1hbiBH b21leiA8Z2VybWFuLmdvbWV6QGFybS5jb20+Ci0tLQogLi4uL0FCSS90ZXN0aW5nL3N5c2ZzLWJ1 cy1jb3Jlc2lnaHQtZGV2aWNlcy1ldG00eCAgfCAgOCArKysrKysrKwogLi4uL3RyYWNlL2NvcmVz aWdodC9jb3Jlc2lnaHQtZXRtNHgtcmVmZXJlbmNlLnJzdCAgfCAxNCArKysrKysrKysrKysrKwog MiBmaWxlcyBjaGFuZ2VkLCAyMiBpbnNlcnRpb25zKCspCgpkaWZmIC0tZ2l0IGEvRG9jdW1lbnRh dGlvbi9BQkkvdGVzdGluZy9zeXNmcy1idXMtY29yZXNpZ2h0LWRldmljZXMtZXRtNHggYi9Eb2N1 bWVudGF0aW9uL0FCSS90ZXN0aW5nL3N5c2ZzLWJ1cy1jb3Jlc2lnaHQtZGV2aWNlcy1ldG00eApp bmRleCA4ZTUzYTMyZjgxNTA1Li4xOWFjOWQ2ZDJmNTA0IDEwMDY0NAotLS0gYS9Eb2N1bWVudGF0 aW9uL0FCSS90ZXN0aW5nL3N5c2ZzLWJ1cy1jb3Jlc2lnaHQtZGV2aWNlcy1ldG00eAorKysgYi9E b2N1bWVudGF0aW9uL0FCSS90ZXN0aW5nL3N5c2ZzLWJ1cy1jb3Jlc2lnaHQtZGV2aWNlcy1ldG00 eApAQCAtNTE2LDMgKzUxNiwxMSBAQCBDb250YWN0OglNYXRoaWV1IFBvaXJpZXIgPG1hdGhpZXUu cG9pcmllckBsaW5hcm8ub3JnPgogRGVzY3JpcHRpb246CShSZWFkKSBSZXR1cm5zIHRoZSBudW1i ZXIgb2Ygc3BlY2lhbCBjb25kaXRpb25hbCBQMSByaWdodC1oYW5kIGtleXMKIAkJdGhhdCB0aGUg dHJhY2UgdW5pdCBjYW4gdXNlICgweDE5NCkuICBUaGUgdmFsdWUgaXMgdGFrZW4KIAkJZGlyZWN0 bHkgZnJvbSB0aGUgSFcuCisKK1doYXQ6CQkvc3lzL2J1cy9jb3Jlc2lnaHQvZGV2aWNlcy9ldG08 Tj4vdHNfc291cmNlCitEYXRlOgkJQXByaWwgMjAyMgorS2VybmVsVmVyc2lvbjoJNS4xOAorQ29u dGFjdDoJTWF0aGlldSBQb2lyaWVyIDxtYXRoaWV1LnBvaXJpZXJAbGluYXJvLm9yZz4KK0Rlc2Ny aXB0aW9uOgkoUmVhZCkgV2hlbiBGRUFUX1RSRiBpcyBpbXBsZW1lbnRlZCwgdmFsdWUgb2YgVFJG Q1JfRUx4LlRTIHVzZWQgZm9yCisJCXRyYWNlIHNlc3Npb24uIE90aGVyd2lzZSAtMSBpbmRpY2F0 ZXMgYW4gdW5rbm93biB0aW1lIHNvdXJjZS4gQ2hlY2sKKwkJdHJjaWRyMC50c3NpemUgdG8gc2Vl IGlmIGEgZ2xvYmFsIHRpbWVzdGFtcCBpcyBhdmFpbGFibGUuCmRpZmYgLS1naXQgYS9Eb2N1bWVu dGF0aW9uL3RyYWNlL2NvcmVzaWdodC9jb3Jlc2lnaHQtZXRtNHgtcmVmZXJlbmNlLnJzdCBiL0Rv Y3VtZW50YXRpb24vdHJhY2UvY29yZXNpZ2h0L2NvcmVzaWdodC1ldG00eC1yZWZlcmVuY2UucnN0 CmluZGV4IGQyNWRmZTg2YWY5YmYuLmYwMTZjN2MyOTQyOWIgMTAwNjQ0Ci0tLSBhL0RvY3VtZW50 YXRpb24vdHJhY2UvY29yZXNpZ2h0L2NvcmVzaWdodC1ldG00eC1yZWZlcmVuY2UucnN0CisrKyBi L0RvY3VtZW50YXRpb24vdHJhY2UvY29yZXNpZ2h0L2NvcmVzaWdodC1ldG00eC1yZWZlcmVuY2Uu cnN0CkBAIC03MSw2ICs3MSwyMCBAQCB0aGUg4oCYVFJD4oCZIHByZWZpeC4KIAogLS0tLQogCis6 RmlsZTogICAgICAgICAgICBgYHRzX3NvdXJjZWBgIChybykKKzpUcmFjZSBSZWdpc3RlcnM6IE5v bmUuCis6Tm90ZXM6CisgICAgV2hlbiBGRUFUX1RSRiBpcyBpbXBsZW1lbnRlZCwgdmFsdWUgb2Yg VFJGQ1JfRUx4LlRTIHVzZWQgZm9yIHRyYWNlIHNlc3Npb24uIE90aGVyd2lzZSAtMQorICAgIGlu ZGljYXRlcyBhbiB1bmtub3duIHRpbWUgc291cmNlLiBDaGVjayB0cmNpZHIwLnRzc2l6ZSB0byBz ZWUgaWYgYSBnbG9iYWwgdGltZXN0YW1wIGlzCisgICAgYXZhaWxhYmxlLgorCis6RXhhbXBsZToK KyAgICBgYCQ+IGNhdCB0c19zb3VyY2VgYAorCisgICAgYGAkPiAxYGAKKworLS0tLQorCiA6Rmls ZTogICAgICAgICAgICBgYGFkZHJfaWR4YGAgKHJ3KQogOlRyYWNlIFJlZ2lzdGVyczogTm9uZS4K IDpOb3RlczoKLS0gCjIuMjUuMQoKCl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fCmxpbnV4LWFybS1rZXJuZWwgbWFpbGluZyBsaXN0CmxpbnV4LWFybS1rZXJu ZWxAbGlzdHMuaW5mcmFkZWFkLm9yZwpodHRwOi8vbGlzdHMuaW5mcmFkZWFkLm9yZy9tYWlsbWFu L2xpc3RpbmZvL2xpbnV4LWFybS1rZXJuZWwK