Interface

A TRACE32 Interface enables the use of TRACE32 as backend being controlled from an other process.

class lauterbach.trace32.pystart._interface.RCLInterface(port=20000, packlen=1024, protocol='TCP', allow_remote_host=None)

TRACE32 Remote API for TCP/IP and UDP.

It defines the parameters for the TRACE32 Remote API for TCP/IP and UDP. Even if the configuration is performed for both protocols, it is recommended to use TCP/IP. Please refer to “API for Remote Control and JTAG Access in C” (api_remote_c.pdf) for more information and “Controlling TRACE32 via Python 3” (app_python.pdf). Multiple instances are allowed.

port: int = 20000

Lets the TRACE32 instance listen to the UDP/TCP port.

packlen: int = 1024

Specifies the maximum data package length for UDP. No operation for TCP.

protocol: str = 'TCP'

Starting from the TRACE32 release 09.2020, the API supports per default TCP socket streams. Previous TRACE32 versions only support a communication via UDP sockets.

allow_remote_host: bool | None = None

If set to false, only connections from localhost are allowed. If set to true also connections from remote hosts != localhost are allowed. If set to None, the default set in Trace32 is used.

Available since TRACE32 build 172541.

class lauterbach.trace32.pystart._interface.IntercomInterface(name='', port=10000, packlen=1024)

Over this interface the PowerView instance can be controlled via an other PowerView instance.

It defines the parameter for the communication between multiple TRACE32 PowerView instances. Only one instance is allowed.

name: str = ''

Assign a name to the TRACE32 PowerView interface. This name can then be used with the InterCom commands. The selected name can be displayed in TRACE32 PowerView using the SYnch.state command.

port: int = 10000

Lets the TRACE32 instance listen to specified port.

packlen: int = 1024

Specifies the maximum data package length for UDP.

class lauterbach.trace32.pystart._interface.GDBInterface(port=30000, protocol='TCP', packlen=1024)

Over this interface TRACE32 can be used as a GDB backend.

It defines the parameters for controlling TRACE32 PowerView as GDB Back-End. Please refer to “TRACE32 as GDB Back-End” (backend_gdb.pdf) for more information. Only one instance is allowed.

port: int = 30000

Lets the TRACE32 instance listen to the UDP/TCP port.

protocol: str = 'TCP'

"TCP" (default) or "UDP".

packlen: int = 1024

Specifies the maximum data package length for UDP. No operation for TCP.

class lauterbach.trace32.pystart._interface.TCFInterface(port=None, allow_remote_host=None)

Control TRACE32 via Target Communication Framework (TCF) from an Eclipse-based interface.

It defines the parameter for controlling TRACE32 PowerView via Target Communication Framework (TCF) from an Eclipse-based interface. Please refer to “TRACE32 as TCF Agent” (app_tcf_setup.pdf) for more information. Only one instance is allowed.

port: int | None = None

Lets the TRACE32 instance listen to the TCP port. None is used for TCF’s default port.

allow_remote_host: bool | None = None

If set to false, only connections from localhost are allowed. If set to true also connections from remote hosts != localhost are allowed. If set to None, the default set in Trace32 is used.

Available since TRACE32 build 172541.

class lauterbach.trace32.pystart._interface.SimulinkInterface(port, allow_remote_host=None)

Interface for TRACE32 Integration for Simulink.

port: int

Lets the TRACE32 instance listen to the UDP port.

allow_remote_host: bool | None = None

If set to false, only connections from localhost are allowed. If set to true also connections from remote hosts != localhost are allowed. If set to None, the default set in Trace32 is used.

Available since TRACE32 build 172541.