21.13.1.65 set_live_probe

Description

This Tcl command assigns channels A and/or B to the specified probe point(s). At least one probe point must be specified. Only exact probe name is allowed (that is, no search pattern that may return multiple points).

Note:

For RTG4, only one probe channel (Probe Read Data Pin) is available: A

set_live_probe [-deviceName "device_name" ] \
               [–probeA "probe point A" ] \
               [–probeB "probe point B" ]

Arguments


Parameter	Type	Description
deviceName	string	Parameter is optional if only one device is available in the current configuration or set for debug. This parameter is optional.
probeA	string	Specifies target probe point for the probe channel A. This parameter is optional.
probeB	string	Specifies target probe point for the probe channel B. This parameter is optional.


Return Type	Description
None	None

Error Codes


Error Code	Description
None	Parameter 'param_name' is not defined. Valid command formatting is 'set_live_probe [-deviceName "device name"] [-probeA "probe point A"] [-probeB "probe point B"] '.
None	Parameter 'probeA' has illegal value.
None	Cannot set live probes: Probe A is not found.
None	Cannot set live probes: IDCode verify failed.

Supported Families


PolarFire
PolarFire SoC
RT PolarFire
SmartFusion 2
IGLOO 2
RTG4

Exception

The array must be programmed and active.
Active probe read or write operation will affect current settings of Live probe since they use the same probe circuitry inside the device.
Setting only one Live probe channel affects the other one, so if both channels need to be set, they must be set from the same call to set_live_probe.
Security locks may disable this function.
To be available for Live probe, ProbeA and ProbeB I/Os must be reserved for Live probe respectively.

Example

The following example sets Live probe channel A to the probe point A12 on device sf2.

set_live_probe [-deviceName sf2] [–probeA A12]

v2024.2