CoreSight Access Tool for SoC600 (CSAT600) User Guide
Overview How to use CSAT600 CSAT600 command list Command comparison between CSAT600 and CSAT Worked examples for CSAT600
Worked examples for CSAT600
Here are some examples of using CSAT600 to perform particular tasks. Because CSAT600 is a flexible tool with many applications, these example are here to show you the kind of command call order and possible output that you might see from the commands.
-
Example 1 Manually specify the scan chain
This example shows how to manually specify the scan chain using the
chain (chn)command. In the CSAT600 tool, only the devices on the scan chain are specified. The CSAT600 tool does not specify all the CoreSight devices. For thechain (chn)command, JTAG scan chain devices are listed in the order in which they appear on the scan chain.Optionally, for the
connect (con)command, you can use the Platform Configuration Editor (PCE) tool to generate a System Description File (SDF). If an SDF is not specified, thechain (chain)andautodetect (auto)commands produce a temporary SDF for the debug probe connection. Use the SDF generated by PCE or theconnect (con)command for subsequent connections to the target.C:\Program Files\Arm\Development Studio 2019.0\bin>csat -cs600
**********************************
** Welcome to CSAT for SoC600 **
**********************************
%> con TCP:255.255.255.255
Connecting to TCP:255.255.255.255 ...
Connected to: DSTREAM-ST
Base H/W: V1 Rev A-05
FPGA build 0x0014, Debug 1V8, Trace 1V8
Firmware: 5.0.0, Build 7
Configuration file: C:\Users\<user>\AppData\Local\Temp\csat_scanchain_devices3560597998775515521.sdf
%> chain dev=ARMCS-DP
------------+--------------------------------+---------
Device No. | DTSL Device Name (& Address) | AP No.
------------+--------------------------------+---------
0 | ARMCS-DP |
%> disconnect
Disconnected from TCP:255.255.255.255
%> exit -
Example 2 Target autodetection
This example shows how to autodetect the target and read its ROM table. With a CoreSight SoC-600 target, the CSAT600 tool presents all components in a linear sequence, no matter how the Access Ports (APs) are structured. Each device detected is accessible using a device number (Device No.). CSAT600 logging is also enabled to capture a log of the autodetection process.
C:\Program Files\Arm\Development Studio 2019.0\bin>csat -cs600
**********************************
** Welcome to CSAT for SoC600 **
**********************************
%> con TCP:255.255.255.255
Connecting to TCP:255.255.255.255 ...
Connected to: DSTREAM-ST
Base H/W: V1 Rev A-05
FPGA build 0x0014, Debug 1V8, Trace 1V8
Firmware: 5.0.0, Build 7
Configuration file: C:\Users\<user>\AppData\Local\Temp\csat_scanchain_devices1844853173103486319.sdf
%> log on C:\Users\<user>\AppData\Local\Temp\log.txt
Logging is enabled with logfile: C:\Users\<user>\AppData\Local\Temp\log.txt
%> autodetect read-rom
Detecting platform...
------------+--------------------------------+---------
Device No. | DTSL Device Name (& Address) | AP No.
------------+--------------------------------+---------
0 | ARMCS-DP |
1 | CSMEMAP_0 (0x00000000) | 0
2 | Cortex-A53_0 (0x80410000) | 0
3 | CSCTI_0 (0x80420000) | 0
4 | CSPMU_0 (0x80430000) | 0
5 | CSETM_0 (0x80440000) | 0
6 | Cortex-A53_1 (0x80510000) | 0
7 | CSCTI_1 (0x80520000) | 0
8 | CSPMU_1 (0x80530000) | 0
9 | CSETM_1 (0x80540000) | 0
10 | CSTMC_0 (0x80800000) | 0
11 | CSTPIU (0x80820000) | 0
12 | CSTMC_1 (0x80830000) | 0
13 | CSTMC_2 (0x80840000) | 0
14 | CSTMC_3 (0x80850000) | 0
15 | CSSTM (0x80860000) | 0
16 | CSCTI_2 (0x80870000) | 0
17 | CSCTI_3 (0x80880000) | 0
18 | CSATBReplicator_0 (0x80890000) | 0
19 | CSATBReplicator_1 (0x808A0000) | 0
20 | CSTFunnel_0 (0x808B0000) | 0
21 | CSTFunnel_1 (0x808C0000) | 0
22 | CSMEMAP_1 (0x00000000) | 1
%> log off
Logging is disabled.
%> disconnect
Disconnected from TCP:255.255.255.255
%> exit -
Example 3 Reading CoreSight component registers
This example shows how to read and set CoreSight component registers using the Memory AP (MEMAP) APB. The debug probe connection is using a previously generated SDF.
C:\Program Files\Arm\Development Studio 2019.0\bin>csat -cs600
**********************************
** Welcome to CSAT for SoC600 **
**********************************
%> con TCP:255.255.255.255 C:\Users\<user>\AppData\Local\Temp\AMIS FPGA.sdf
Connecting to TCP:255.255.255.255 ...
Connected to: DSTREAM-ST
Base H/W: V1 Rev A-05
FPGA build 0x0014, Debug 1V8, Trace 1V8
Firmware: 5.0.0, Build 7
Configuration file: C:\Users\<user>\AppData\Local\Temp\AMIS FPGA.sdf
%> list
------------+--------------------------------+---------
Device No. | DTSL Device Name (& Address) | AP No.
------------+--------------------------------+---------
0 | ARMCS-DP |
1 | CSMEMAP_0 (0x00000000) | 0
2 | Cortex-A53_0 (0x80410000) | 0
3 | CSCTI_0 (0x80420000) | 0
4 | CSPMU_0 (0x80430000) | 0
5 | CSETM_0 (0x80440000) | 0
6 | Cortex-A53_1 (0x80510000) | 0
7 | CSCTI_1 (0x80520000) | 0
8 | CSPMU_1 (0x80530000) | 0
9 | CSETM_1 (0x80540000) | 0
10 | CSTMC_0 (0x80800000) | 0
11 | CSTPIU (0x80820000) | 0
12 | CSTMC_1 (0x80830000) | 0
13 | CSTMC_2 (0x80840000) | 0
14 | CSTMC_3 (0x80850000) | 0
15 | CSSTM (0x80860000) | 0
16 | CSCTI_2 (0x80870000) | 0
17 | CSCTI_3 (0x80880000) | 0
18 | CSATBReplicator_0 (0x80890000) | 0
19 | CSATBReplicator_1 (0x808A0000) | 0
20 | CSTFunnel_0 (0x808B0000) | 0
21 | CSTFunnel_1 (0x808C0000) | 0
22 | CSMEMAP_1 (0x00000000) | 1
%> dvo 1
Connected to device no. 1: CSMEMAP_0
%> mr 0x80540000 8
Reading from device no. 1: CSMEMAP_0
0x80540000 : 0x00000000
0x80540004 : 0x00000000
0x80540008 : 0x00000000
0x8054000c : 0x00000003
0x80540010 : 0x00000001
0x80540014 : 0x00000000
0x80540018 : 0x00000000
0x8054001c : 0x00000000
%> mw 0x80540004 0
Writing to device no. 1: CSMEMAP_0
Wrote 4 bytes.
%> mr 0x80540004 1
Reading from device no. 1: CSMEMAP_0
0x80540004 : 0x00000000
%> dvc
Disconnected from device no. 1
%> dcn
Disconnected from TCP:255.255.255.255
%> x -
Example 4 Changing a DSTREAM configuration item
This example shows how to autodetect a target and change the
SRSTOnConnectDSTREAM configuration item.C:\Program Files\Arm\Development Studio 2019.0\bin>csat -cs600
**********************************
** Welcome to CSAT for SoC600 **
**********************************
%> con TCP:255.255.255.255
Connecting to TCP:255.255.255.255 ...
Connected to: DSTREAM-ST
Base H/W: V2 Rev A-06
FPGA build 0x0014, Debug 1V8, Trace 1V8
Firmware: 5.3.0, Build 4
Configuration file: C:\Users\<user>\AppData\Local\Temp\csat_scanchain_devices3925139137141746493.sdf
%> chain dev=auto
Detecting scanchain...
------------+--------------------------------+---------
Device No. | DTSL Device Name (& Address) | AP No.
------------+--------------------------------+---------
0 | ARMCS-DP |
%> auto read-rom
Detecting platform...
------------+--------------------------------+---------
Device No. | DTSL Device Name (& Address) | AP No.
------------+--------------------------------+---------
0 | ARMCS-DP |
1 | CSMEMAP_0 (0x00000000) | 0
2 | Cortex-A53_0 (0x80410000) | 0
3 | CSCTI_0 (0x80420000) | 0
4 | CSPMU_0 (0x80430000) | 0
5 | CSETM_0 (0x80440000) | 0
6 | Cortex-A53_1 (0x80510000) | 0
7 | CSCTI_1 (0x80520000) | 0
8 | CSPMU_1 (0x80530000) | 0
9 | CSETM_1 (0x80540000) | 0
10 | CSTMC_0 (0x80800000) | 0
11 | CSTPIU (0x80820000) | 0
12 | CSTMC_1 (0x80830000) | 0
13 | CSTMC_2 (0x80840000) | 0
14 | CSTMC_3 (0x80850000) | 0
15 | CSSTM (0x80860000) | 0
16 | CSCTI_2 (0x80870000) | 0
17 | CSCTI_3 (0x80880000) | 0
18 | CSATBReplicator_0 (0x80890000) | 0
19 | CSATBReplicator_1 (0x808A0000) | 0
20 | CSTFunnel_0 (0x808B0000) | 0
21 | CSTFunnel_1 (0x808C0000) | 0
22 | CSMEMAP_1 (0x00000000) | 1
%> device 2
Connected to device no. 2: Cortex-A53_0, JTAG ID: 0x1ba06477, version 0x00000006
Msg returned from device: Cortex-A53 Template
%> help cfgbox
Command: cfgbox
Configure the DSTREAM probe.
Aliases:
cfb
Usage:
cfgbox [<item_name> [<item_value>]]
cfb [<item_name> [<item_value>]]
%> cfgbox
Linked_SRST_TRST : 0
SRSTOnConnect : 0
UserOutputPin s : 000000
UseDeprecatedSWJ : 0
DSTREAMCS20 : 0
TResetOnInitConnect : 1
AllowTRST : 1
ResetHoldTime : 100
TRSTOnConnect : 1
PROBE : 90112
RvcHash : 1362632482
MinimalConnect : 0
nTRSTHoldTime : 10
PowerUpGPR : 1
GdbConnCmdSeq :
SessionPause : 0
nTRSTPostResetTime : 10
UserOut_P5 : 0
TRSTPostResetTime : 10
UserOut_P4 : 0
SWJEnable : 0
JtagClockFreq : 7500000
SWOMode : 0
VCC : 805306368
JTAGAutoMaxFreq : 200000000
ProbeMode : 1
PostResetDelay : 1000
nSRSTHighMode : 1
ClusterDescription :
UserOut_DBGRQ : 0
CONNECTOR : ARM JTAG 20 (JTAG)
nSRSTLowMode : 0
TRSTHoldTime : 10
AllowConInReset : 0
SWOBaudRate : 0
UserOut_P3 : 0
UserOut_P2 : 0
DoSoftTAPReset : 1
UserOut_P1 : 0
DoSoftTRST : 1
AP_V3_ADDR_IDX_MAP :
AllowICELatchSysRst : 1
AllowICETAPReset : 1
nTRSTHighMode : 0
LVDSProbeMode : 1
SResetOnInitConnect : 0
ResetOperation : 0
nTRSTLowMode : 0
FPGARegOffset : 0
PythonScript :
FPGARegValue : 24576
UserOut_P6_COAX : 0
JtagClockType : 2
ScriptTimeout : 1000
TCKOnIdle : 0
PowerFilterTime : 100
ScanChainJtagFreqs : 7500000T
%> cfb SRSTOnConnect 1
SRSTOnConnect: 1
%> cfb SRSTOnConnect
SRSTOnConnect: 1
%> dvc 2
Disconnected from device no. 2
%> dcn
Disconnected from TCP:255.255.255.255
%> x
Disconnected from TCP:255.255.255.255