config

Configures the command window.

Syntax
config <option> [<sub-option>] <value> [-np]
config
Options
<none>

With no options, config displays the current configuration settings.

-np

Do not print anything to the display, only return the data.

The table below lists and defines Display options of the config command.

Table 1. config Command-line debugger command - Display options
Command Description
echoCmd on|off When set on, commands executed from scripts are printed. If this option is prefixed with @ the command itself will not be printed.
h/exPrefix <prefix> Sets the string to be used as the prefix for hex values.
binPrefix <prefix> 3 Sets the string to be used as the prefix for binary values.
showCommas off | on When set on, decimal data is displayed with commas inserted every three digits. Hex and binary data is displayed with a colon inserted every four digits.
hexPadding on | off When set on, hex values are padded with leading zeros.
decPadding on | off When set on, decimal values are padded with leading zeros.
mem/Identifier <mem-space-id> Sets the string to be used for the main memory space prefix.
memCache off | on With memCache off, the Command Window will always read target memory. This setting is useful if your target memory may change while the target is paused. With memCache on, the Command Window will cache target memory reads while your target is paused. This setting will improve the performance of the Command Window.
memReadMax <max-bytes> Limits the amount of memory to be read in a single command. This prevents the Command Window from locking up on abnormally large memory read requests.
memSwap off | on When set, memory values are swapped on cell boundaries by default.
memWidth <bits> | factory Specifies the default width for display of memory data. Initially, the default width may vary depending on the active debugger; once the user has changed the value, the new value is used for all active debuggers. The initial behavior can be restored with the keyword "factory".
memAccess <bits> Specifies the default hardware access size for target memory. A setting of 0 allows the hardware access size to match the display width of the command.
memFixedIntBits <bits> For fixed point formatting, sets the range to the specified number of bits. For example, a value of 8 will set the range to [-2^8,2^8), or [-256,256).
variable <sub-option> [on | off] Enables or disables certain fields in the output of the "evaluate" command. If neither on nor off are specified, then the field is enabled. Possible values for <sub-option> are:
  • echo - the variable name
  • location - the address of the variable
  • size - the size of the variable is bytes
  • type - the variable type
variable format <format> Controls the output format of the "evaluate" command. Possible values for <format> are:
  • - | Default
  • d | Signed
  • u | Unsigned
  • x | h | Hex
  • c | Char
  • s | CString
  • p | PascalString
  • f | Float
  • e | Enum
  • i | Fixed Fract
  • b | Binary Boolean SignedFixed
  • o | w | Unicode

The following table lists and defines Run Control options of the config command.

Table 2. config Command-line debugger command - Run control options
Command Description
autoThreadSwitch off | interactive-only | on Allows the user to control whether the Command Window will perform automatic thread-switching. Possible settings are always on, always off, and on when running interactively, that is not from a script. If enabled, automatic thread switching is done in the following cases:
  • If no thread is currently selected or if the current thread exits, then the first one detected will become the current.
  • If the current thread is running and another thread stops, then the current thread will switch to the stopped thread.
debugTimeout <seconds> The maximum amount of time to wait for a debug command to finish. You can also hit ESC to stop waiting.
runControlSync off | script-only | on Sets how to synchronize run control commands. If set to "on", then all run control commands will wait until a thread stopped event. If set to "off", then all run control commands will return immediately. If set to "script-only", then all run control commands will wait while running a script but will return immediately while running interactively.
setPCNextValidLine on | off Controls the behavior of the setpc command in the case that the specified file line number has no source code. If set to "on", the PC is set to the next line number containing source. If set to "off", an error is shown.
Examples
config

Display the current config status.

The following table lists and defines Display examples of the config command.

Table 3. Conf Command-Line Debugger Command - Display Examples
Command Description
config echoCmd on If "reg D1" is a command executed from a script, the output will have on top the command itself:

cmdwin::reg D1

+ General Purpose Registers

D1=$ffffffffff
config hexPrefix 0x Show hexadecimal numbers with "0x" prefix.
config ShowCommas o n Show hexadecimal and binary numbers with a colon, as in $0000:0000, and show decimal numbers with a comma, as in 1,000,000.00.
config HexPadding off Show hex and binary numbers with leading zeros, as in 0x0000. config MemIdentifier 0. Use "0" as the default memory space for memory commands.
config MemCache off Turn off caching of target memory. AFFECTS COMMAND WINDOW ONLY.
config MemReadMax 2048 Limit memory commands to 2048 (decimal) bytes.
config MemSwap on Swap memory on cell boundaries before accessing the target.
config MemWidth 16 Displays and writes 16bit values.
config MemWidth factory Reset the MemWidth to factory settings.
config MemAccess 8 Uses an 8-bit access size for reading and writing target memory.
config MemFixedIntBits 8 Sets the fixed point range to [-2^8,2^8), or [-256,256).
config var echo on Include the variable name in the output of the "evaluate" command.
config var format d Set the default display format of the "evaluate" command to decimal. The format may be one of the following strings or the corresponding character abbreviation: Default('-'), Signed('d'), Unsigned('u'), Hex('h'|'x'), Char('c'), CString('s'), PascalString('p'), Float('f'), Enum('e'), Fixed('i'), Fract(no abbrev), Binary('b'), Boolean(no abbrev), SignedFixed(no abbrev), Unicode('o'|'w').
config var type off Exclude the variable type name in the output of the "evaluate" command.
config var location on Include the memory address in the output of the "evaluate" command.
config var size on Include the variable size in the output of the "evaluate" command.

The following table lists and defines Run Control examples of the config command.

Table 4. config Command-line debugger command - Run control examples
Command Description
config AutoThreadSwitch interactive-only If commands are being entered interactively, that is not from a script, automatic thread switching will be performed. If no thread is currently selected or if the current thread exits, then the first one detected will become the current. If the current thread is running and another thread stops, then the current thread will switch to the stopped thread.
config DebugTimeout 10 Wait up to 10 seconds for debug command to finish.
config RunControlSync on Run control commands will wait for thread-stopped event.
config SetPCNextValidLine on If setpc is called for a file line number with no source code, the line number is automatically increased to the next line with source code.


© 2014 Freescale Semiconductor, Inc. All rights reserved.