Configuration

Global Defaults

There is a object

lauterbach.trace32.pystart.defaults: alias of <lauterbach.trace32.pystart._powerview.PowerViewGlobalDefaults object>

class lauterbach.trace32.pystart._powerview.PowerViewGlobalDefaults

A class to handle PowerView default settings on a centralized place.

system_path: str | Path

Directory where the executable and system files of TRACE32 are located.

Initially the value is set to environment variable T32SYS. If the environment variable is not set, on Windows systems "C:\T32" is taken, on Linux system a value must be set before start.

temp_path: str | Path

Directory, where temporary files can be created. The source files are copied to the temporary directory while debugging.

Initially the value is set to environment variable T32TMP. If the environment variable is not set TRACE32 is responsible for the path being used.

help_path: str | Path: Directory where the pdf-files for the TRACE32 online help are located.

license_file: str | Path: Directory where a license file can be located. A license file provides the software maintenance keys.

force_32bit_executable: bool: If set, pystart will start the 32-bit executable located under bin/windows instead of the 64-bit executable located under bin/windows64. This could be e.g. needed if a 32-bit DLL has to be loaded in TRACE32 PowerView.

rlm_port: int: The Floating License Client (RLM Client) needs to know which (RLM) port number should be used to get the license. Defaults to 5055.

rlm_server: str: The Floating License Client (RLM Client) needs to know which (RLM) Server to contact to get the license.

rlm_file: str | Path: Sets a license file (.lic) which includes the floating license parameters.

rlm_timeout: int | None: RLM timeout in minutes

rlm_pool_port: int | None: TCP/IP port for license pool. Refer to the chapter “Floating License Pools” in Floating Licenses, page 19 (floatinglicenses.pdf) for more information.

screen: bool: If False the main window of TRACE32 and all other dialogs and windows of TRACE32 remain hidden - even if an error occurs.

font_size: FontSize: Selects the used font size used by the TRACE32 instance (Normal, Small or Large).

clear_type: bool | None

Select if Cleartype display of fonts is switched ON or OFF.

True: ON if it is supported by the OS. The monospaced truetype font “Lucida Console” is used as basic font and should be installed.

False: OFF, TRACE32 fonts are used (t32font.fon).

None: Use DEFAULT.

palette: Palette: Sets up display theme.

full_screen: bool: If set to true, the TRACE32 instance is started in full screen mode.

ionic: bool

Startup iconized (minimized)

Type:: If True

invisible: bool

The main window of TRACE32 remains hidden. However, dialogs and other windows of TRACE32 can still be opened.

Type:: If True

window_mode: WindowMode: Specify how child windows appear.

language: Language: Set up the language used by TRACE32.

Types

lauterbach.trace32.pystart._powerview.PathType: alias of str | Path

Enumerations

class lauterbach.trace32.pystart.ConnectMode(*values)

Specify reaction if debugger is already in use.

The connection modes are not applicable for multi-core debugging.

NORMAL = 1: If PowerDebug device is already in use, warn user and close application after confirmation.

AUTOABORT = 2: If PowerDebug device is already in use, the TRACE32 executable will be closed automatically without any user interaction.

QUERYCONNECT = 3: If PowerDebug device is already in use, ask user if connection shall be forced.

AUTOCONNECT = 4: The TRACE32 executable will automatically take over control over the PowerDebug device, even if the debugger is already in use.

AUTORETRY = 5: If PowerDebug device is already in use, the TRACE32 executable will wait until the current TRACE32 session ends.

class lauterbach.trace32.pystart.FontSize(*values)

SMALL = 'SMALL'

MEDIUM = 'MEDIUM'

LARGE = 'LARGE'

class lauterbach.trace32.pystart.Language(*values)

ENGLISH = 'EN'

JAPANESE = 'JP'

class lauterbach.trace32.pystart.Palette(*values)

Enumeration of basic color schemes.

DEFAULT = 'DEFAULT'

KEEP = 'KEEP': Keep last used palette

DARK_THEME = 'PALETTE 0 = 181 181 181\nPALETTE 1 = 41 49 52\nPALETTE 2 = 63 75 78\nPALETTE 5 = 255 111 111\nPALETTE 7 = 255 255 206\nPALETTE 8 = 192 192 192\nPALETTE 11 = 160 130 189\nPALETTE 13 = 102 116 123\nPALETTE 19 = 192 192 192\nPALETTE 20 = 192 192 192\nPALETTE 21 = 192 192 192\nPALETTE 22 = 192 192 192\nPALETTE 23 = 192 192 192\nPALETTE 25 = 192 192 192\nPALETTE 26 = 192 192 192\nPALETTE 27 = 47 57 60\nPALETTE 28 = 192 192 192\nPALETTE 29 = 47 57 60\nPALETTE 30 = 47 57 60\nPALETTE 31 = 192 192 192\nPALETTE 36 = 232 172 99\nPALETTE 37 = 147 199 99\nPALETTE 47 = 47 57 60\nPALETTE 54 = 255 255 255'

class lauterbach.trace32.pystart.WindowMode(*values)

MDI = 'MDI': Multiple Document Interface (default). All child windows appear inside the TRACE32 main window.

FDI = 'FDI': Floating Document Interface. All child windows can be placed on any position on the desktop independently form the main window. Minimizing the main window, minimizes also the child windows. Only the main window appears in the task bar.

MTI = 'MTI': Multiple Top-level window Interface All child windows can be placed on any position on the desktop independently form the main window. Minimizing the main window, minimizes none of the child windows. Both the main and all child windows appear in the task bar.

Exceptions

lauterbach.trace32.pystart._exceptions.TimeoutExpiredError: Alias to TimeoutError to keep compatibility

lauterbach.trace32.pystart._exceptions.AlreadyRunningError: Alias to RuntimeError to keep compatibility