From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-wm1-f54.google.com (mail-wm1-f54.google.com [209.85.128.54]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 0AEC03A79B2 for ; Tue, 18 Nov 2025 16:28:28 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.54 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763483311; cv=none; b=BlHjgFrHPV4MO7xxWD9SrbudXXWf81IqvbhVgLvRTQInnbv0ymlSq9qv+l8M2nR8Xda3Q7seUDbtej3wKBEeYRCFztDqOaIWm9EpwlfID3NB3lfrP2cVoTKw8i+qIFa3CvlFQgU9cOxkFscXtg40LMxusZ+HsF1FudJ/Cxz5W5I= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763483311; c=relaxed/simple; bh=2gYGham6RcUhZnNfLTEyX5K2IIqX9Oa8+TtMYKSDzf0=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=YJ8XNvTaKczFwVnLBe8WpXeTnxw/FMWWmy9ytB8jxgg7hdfv4hSxt78oB0H/SwYAS4myoSzn60dxPj6FcV9y6B7avBExd8VV1CvPuw3gur3MHAPrvcYBDKPdz2L4LAQKCgALUUKNm8x+F/Zcjlhg0DK4/6fZYH+4lZdy55vLwtk= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linaro.org; spf=pass smtp.mailfrom=linaro.org; dkim=pass (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b=i2ein0+h; arc=none smtp.client-ip=209.85.128.54 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linaro.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=linaro.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b="i2ein0+h" Received: by mail-wm1-f54.google.com with SMTP id 5b1f17b1804b1-4775e891b5eso30200895e9.2 for ; Tue, 18 Nov 2025 08:28:28 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1763483307; x=1764088107; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=9NYmdp5K7GoriQTdww1h5siZo6lfJrXIe/VnMyhW40E=; b=i2ein0+hZTZXaud6ghJKswJyyXXLG8tDT7pYqcb8Ypu5pVElLd2dQlyYPSbRMfTedY oD075VEoOixQTExva13woMElboCRkZdPmhEjFAKe792L9gbFlG+1TkROJLQmwOlkXWSP RIzmGdNe11Ygp6pZOWAiuQHB7pZTitARt5I34iNwiBDEsVc1RbxS8MVHKuM9xelIrw9O 8Iz3a20CqSaPDN8ziSC6FfElfPOTETVpLiC625W7sRoJnw3GA0uN98Hxb9HsfWQN1JGD 5ZGM+J5N0zL1b1eu1VA5cXYpHrVWMeRjEiJo6ZEGkCMvgbODx55wyAMTOnRGJgizuKVU Ob0w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1763483307; x=1764088107; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-gg:x-gm-message-state:from:to :cc:subject:date:message-id:reply-to; bh=9NYmdp5K7GoriQTdww1h5siZo6lfJrXIe/VnMyhW40E=; b=qgXxg8G6CYXqdGgHBA+husNfF29Mz1JBdSnmTP+nCzeD4tglmxf6oZ7Wjhn77Gv4E/ NcSRQsv+mMEJ4DqH3yIXtHScoKoGoxHB0Mf3E+CfysdrCShFAlv/4CKrMfUWxlMYq7WU PqPpKHI64pAv9uKQGqEbRz5bq9RLI9nHoY5ynoY+IW9rHKZZ6NI80DPjrwIz924wbMk6 z97Vo9fvj4sZwfROvcKKAx7vWtnUSwO1C+ezlI2IDrlp56CKnXuuTDGQLueOUAkKr5Ch aK/8n98eKGHqNdF1fTPLs2Ljr/3YVqgmDY52QkKXLBsMBQ5U1DMJJ9/7hbPL/bNhuWZR yDiA== X-Forwarded-Encrypted: i=1; AJvYcCXkUXhf8LZbMCjhcAK15frBwTIxXsmiL5lTlMoeI3tunIYIWqjgFCm4jqXVqhiLrVhuPoPerPmwyEspCb0=@vger.kernel.org X-Gm-Message-State: AOJu0Yyr0+RnwWiL/NDJ0DJCGbBoucn5W1Rq0XUK7dHzpDTuzykOTCXw S22sR1fhgYCsKcYRXKBg3cJnjIeuMY/w4D16Wv5e0IO30jm/YfFTUBMuK1PbaZVW0S4= X-Gm-Gg: ASbGncsssEN9sqckxd3SJ3x4oeLF4HyxsKYCKlZnQLliCd4bxrWQHeIms0O60tw8mak HY3DM0Kw3/TeNDOEEOeM7nOy3GjsqK4+mzEQ2iEFa3Wa+0qgjvQFRrT5w9OIjA365IGdHpdGk/u DO7QNyOEjoPRAjiYuaxe9QsMP5RDIY4PMNJ1wQznn0zD6+XrARwQGQuwzan1On4Xv/W1oZApo8C 3DD2ddu7OC19dpR2EkJypdZ3+sGARZ8SczVP6xj08K0zCuVvd32ZWg3hvNskVq6EPtrrx9T6Mfq 5z+3/8nIMcFsAoV8VVRDqn/I0SXsPlUgF2VVHGm5iQHn+nzFP8F0xuTFHR+Hcon3PNfUHKoExPP VzgdR1/bNcjc9HwRrrjOJlqs4m6ucwCkYjn5xyn3xU4UCTTt2z9wYUBZ15oGMusmuC6yRJ0t6TL Q/ljdOTa9iuK+cOO5IqI/I3SBnQ+WKknM= X-Google-Smtp-Source: AGHT+IHN5ZZ7TsSfy3KB6ZJXobAnrt1PfBhAPwW1cYqyewtyOySvk+eWd5Ld3sR20w2QmFj0p3m0Xw== X-Received: by 2002:a05:600c:1c9b:b0:477:9fa0:74ed with SMTP id 5b1f17b1804b1-4779fa07915mr98104425e9.26.1763483307312; Tue, 18 Nov 2025 08:28:27 -0800 (PST) Received: from ho-tower-lan.lan ([185.48.77.170]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-477a9dea7fcsm20369125e9.8.2025.11.18.08.28.26 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 18 Nov 2025 08:28:26 -0800 (PST) From: James Clark Date: Tue, 18 Nov 2025 16:28:03 +0000 Subject: [PATCH v5 13/13] coresight: docs: Document etm4x timestamp interval option 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="utf-8" Content-Transfer-Encoding: 7bit Message-Id: <20251118-james-cs-syncfreq-v5-13-82efd7b1a751@linaro.org> References: <20251118-james-cs-syncfreq-v5-0-82efd7b1a751@linaro.org> In-Reply-To: <20251118-james-cs-syncfreq-v5-0-82efd7b1a751@linaro.org> To: Suzuki K Poulose , Mike Leach , Alexander Shishkin , Jonathan Corbet , Leo Yan , Randy Dunlap Cc: coresight@lists.linaro.org, linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, James Clark X-Mailer: b4 0.14.0 Document how the new field is used, maximum value and the interaction with SYNC timestamps. Signed-off-by: James Clark --- Documentation/trace/coresight/coresight.rst | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) diff --git a/Documentation/trace/coresight/coresight.rst b/Documentation/trace/coresight/coresight.rst index 806699871b80..d461de4e067e 100644 --- a/Documentation/trace/coresight/coresight.rst +++ b/Documentation/trace/coresight/coresight.rst @@ -613,8 +613,20 @@ They are also listed in the folder /sys/bus/event_source/devices/cs_etm/format/ - Session local version of the system wide setting: :ref:`ETM_MODE_RETURNSTACK ` * - timestamp - - Session local version of the system wide setting: :ref:`ETMv4_MODE_TIMESTAMP - ` + - Controls generation and interval of timestamps. + + 0 = off, 1 = minimum interval .. 15 = maximum interval. + + Values 1 - 14 use a counter that decrements every cycle to generate a + timestamp on underflow. The reload value for the counter is 2 ^ (interval + - 1). If the value is 1 then the reload value is 1, if the value is 11 + then the reload value is 1024 etc. + + Setting the maximum interval (15) will disable the counter generated + timestamps, freeing the counter resource, leaving only ones emitted when + a SYNC packet is generated. The sync interval is controlled with + TRCSYNCPR.PERIOD which is every 4096 bytes of trace by default. + * - cc_threshold - Cycle count threshold value. If nothing is provided here or the provided value is 0, then the default value i.e 0x100 will be used. If provided value is less than minimum cycles threshold -- 2.34.1