This is an automated email from Gerrit.
"Antonio Borneo <borneo.anto...@gmail.com>" just uploaded a new patch set to
Gerrit, which you can find at https://review.openocd.org/c/openocd/+/7882
-- gerrit
commit 95a27a3c18f24ff574e449e22f736e2b9e6b0c4c
Author: Antonio Borneo <borneo.anto...@gmail.com>
Date: Sun Sep 3 10:26:07 2023 +0200
doc: improve description of CTI usage for ARMv8-A and ARMv8-R
OpenOCD mandatory uses the CTI to control ARMv8-A and ARMv8-R
cores.
Provide more details on how the CTI is used and how to avoid
conflicts between OpenOCD and user's setup.
Change-Id: I6fa7e56b34db8c3ebf787e644afe0f121cd9cb7a
Signed-off-by: Antonio Borneo <borneo.anto...@gmail.com>
diff --git a/doc/openocd.texi b/doc/openocd.texi
index d07188c4bc..ea4a7b4f3d 100644
--- a/doc/openocd.texi
+++ b/doc/openocd.texi
@@ -9717,10 +9717,19 @@ how the event caused trouble.
The ARM Cross-Trigger Interface (CTI) is a generic CoreSight component
that connects event sources like tracing components or CPU cores with each
-other through a common trigger matrix (CTM). For ARMv8 architecture, a
-CTI is mandatory for core run control and each core has an individual
-CTI instance attached to it. OpenOCD has limited support for CTI using
-the @emph{cti} group of commands.
+other through a common trigger matrix (CTM).
+
+@b{Note:} For ARMv8-A and ARMv8-R architectures, a CTI is mandatory for core
+run control and each core has an individual CTI instance attached to it.
+On ARMv8-A and ARMv8-R architectures only, OpenOCD reserves the channels 0
+and 1 of the CTM to propagate respectively the signals for halt and for
+resume across the SMP group of cores.
+User settings of CTI and CTM should not interfere with this setup.
+Since OpenOCD erases the CTI configuration during reset and core examine, a
+CTI user configuration could be applied in core's @emph{examine-end} event
+handler. @xref{targetevents,,Target Events}, on how to configure events.
+
+OpenOCD has limited support for CTI using the @emph{cti} group of commands.
@deffn {Command} {cti create} cti_name @option{-dap} dap_name @option{-ap-num}
apn @option{-baseaddr} base_address
Creates a CTI instance @var{cti_name} on the DAP instance @var{dap_name} on
MEM-AP
--
