From nobody Tue Dec 2 02:42:37 2025 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: quoted-printable 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/tr= ace/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_sour= ce/devices/cs_etm/format/ - Session local version of the system wide setting: :ref:`ETM_MODE_RE= TURNSTACK ` * - timestamp - - Session local version of the system wide setting: :ref:`ETMv4_MODE_= TIMESTAMP - ` + - Controls generation and interval of timestamps. + + 0 =3D off, 1 =3D minimum interval .. 15 =3D 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 ^ (in= terval + - 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 pro= vided value is 0, then the default value i.e 0x100 will be used. If provided value is less tha= n minimum cycles threshold --=20 2.34.1