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

ParameterTypeDescription

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 TypeDescription
NoneNone

Error Codes

Error CodeDescription

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]

See Also

  • ​un​set_live_probe