From nobody Mon Dec 1 22:35:06 2025 Received: from mail-wm1-f48.google.com (mail-wm1-f48.google.com [209.85.128.48]) (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 679A232C31D for ; Fri, 28 Nov 2025 11:56:04 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.48 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1764330968; cv=none; b=HGg+yH1UoVGCPYrQNOvBTKea2yE6VdkSLRMyfbUgkY7OOvJ8YjGvneTee+9Np0kVZKHCzMHroKhHJEiMQzDXyAZy8LS/V6Ej+HshSz3yXH7c8F70GT4z9CYWqabWeqtslwaizec7Nn1dFPOkJvbhYF1m6xLVrDwMMVTmBrzARxU= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1764330968; c=relaxed/simple; bh=DZ4HZWH5qf3Io6Mvd7Ro7kQIN5EHdhrLFo71SpJ5Le0=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=mLkszDvLe7R+3gy2hahKtPY9Pzx4H0gRZJRBIpDs8jAxKrY81Swi/6EMeQmCT5y6SIFFQMQSrQkZ2q+vSFeGL506uuj8Pn+fu1zNtOqFkoW/tsxrSioN2WV4NrNvafOMHCKKV5GLKOUhVs9EQzaOLL4yy+h7odAZThBYHXaqxe0= 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=S+aHJGOz; arc=none smtp.client-ip=209.85.128.48 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="S+aHJGOz" Received: by mail-wm1-f48.google.com with SMTP id 5b1f17b1804b1-4779aa4f928so13923365e9.1 for ; Fri, 28 Nov 2025 03:56:04 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1764330962; x=1764935762; 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=Cth2HfadlNIwjuNkYXpg5yJwdRtCIZo2ukA+LLh7V4I=; b=S+aHJGOzU5eecmseTrls3toFzEZF2M/bJJD93gHh3/DrNFkGsATgVg2IrlbJOYk8UH xAVvgdC9ut1LDPzMTp8nPewDPioPGaYzNUzWc4msnsLZjLkgr7CyLWIHqEbuG4mbY0v4 pnO8mQbW7LfeEBqd4Ooi5ZbHl6wWCq4+FB1W0ovs7t+zE8dbbTIptnDF4f+QIw1j05Lu dkdPCF37nmyzTX+QROLsAhfQiqJ8pd8FQAjKu/9gK3XX5qXwyIFGrAryidGac6b6Dcry eEO+UIhChhxTZz++M51kGWcLfxyoYNC3OSYcksvoWP77uajvrAb7RTHXUuDO+fBPyea8 PffA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1764330962; x=1764935762; 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=Cth2HfadlNIwjuNkYXpg5yJwdRtCIZo2ukA+LLh7V4I=; b=TfID6UbJKgQA132hF5j5wzXGhtoSnOmgiARAjtslpWhGABjDH6uyIdDkDtcC6aDhXD xqA4LSTbC9XEVNkjrfvuzIz4md6PeIbuE+lbKWqBIFl8Yo+gdLUo9D9uQYNMyEnwBWY1 rK/zFZtP6OCJhkzsIQekUEHDBMhYrqSXNxG79EicTsWoTEvQNYSIhV+fng3D3fewlySX U5YLmGuFO3J3mjV69kbUa3tANz0rD1LgIHnTgCUKjKZ03nSDEKa/pw2fFifIG5niEDRR GyhZsgWrREY8+TE9lAtG+v+WVlH98mu7GOa+7ZckldOpr8CejnpQoDVxvV33M5brftbY pz5w== X-Forwarded-Encrypted: i=1; AJvYcCWz2HgAED5lp/pqCWXwcnwWRlTSC8yH3sNxh6yUa/eVVSQ7AV5U7a2p2hr3XunfXExiagaON0gJwiFJ+sY=@vger.kernel.org X-Gm-Message-State: AOJu0YyzbGsK8/xUFA30s/8L4DQAELrLe7CjujyFo9NDfu0GiR1gawgU nae+tX3Hu8RHQTkEFhy/ThEqcmKF9L1VJa0AQWfZ55vrnEOyPZeK5Et0J1Ir/XUYIGw= X-Gm-Gg: ASbGncsnjFqvbCuGjtGMhb/JCxc05hB8zClD1WTiM5Z4DOzOmpjQbAyqFl79j/aKVZt qMwj5v2pXlS3H6DNZUBqpmJx4S4wxDEhBSuTwQu4liKf/faAb3Xfx/OJVw28oPMqb0mCyRp696q 1P1M+3i39l/wZRrzlrsKcq2e8bEs8QT+RyAVneJDo/jm3WFqmiLXnBzZj7Oa3sbrQDrIHMNLeKw 8WTuNltbrGZ+auPX6E/XIUcjMjkr/T8Xwukc7xsfgEo5cwkVZEV+T5m46Zlwd2XjSw3ArCFFwcf PHgy8lsuTCvoFCAAsHfgTT3vd84oKe28EhLxmYjQafd1EcLcfYc5DSKDOB0dqLh0xXuITSOSaU+ +AT4UAhFjtmPQX5fpn/m7MJthmANjmvhProZq8hx9nUmpzQJDMNSYyQKrWL9RyHCbxOKz2H0edH ws9RjTO/WL55sBvFOC8YDZ X-Google-Smtp-Source: AGHT+IHPyD1xyffyVNm3+d/4wd26K/XgcD7YW3gltFP0yISG5I/GpHGJjvh7e5mHCRlPRu4u6YXiag== X-Received: by 2002:a05:600c:1c92:b0:477:7f4a:44b0 with SMTP id 5b1f17b1804b1-47904b2c2c5mr166562705e9.33.1764330962372; Fri, 28 Nov 2025 03:56:02 -0800 (PST) Received: from ho-tower-lan.lan ([185.48.77.170]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-4790adc8bc7sm158974465e9.1.2025.11.28.03.56.01 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 28 Nov 2025 03:56:02 -0800 (PST) From: James Clark Date: Fri, 28 Nov 2025 11:55:25 +0000 Subject: [PATCH v8 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: <20251128-james-cs-syncfreq-v8-13-4d319764cc58@linaro.org> References: <20251128-james-cs-syncfreq-v8-0-4d319764cc58@linaro.org> In-Reply-To: <20251128-james-cs-syncfreq-v8-0-4d319764cc58@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. Tested-by: Leo Yan 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