||FreeBSD General Commands Manual
MSPDebug - debugging tool for MSP430 MCUs
MSPDebug is a command-line tool designed for debugging and programming the
MSP430 family of MCUs. It supports the eZ430-F2013, eZ430-RF2500, Launchpad,
Chronos, FET430UIF, GoodFET, Olimex MSP430-JTAG-TINY and MSP430-JTAG-ISO
programming tools, as well as a simulation mode.
When started with appropriate options, MSPDebug will attempt to connect to the
debugging tool specified and identify the device under test. Once connected,
the user is presented with a command prompt which can be used to reflash the
device memory, inspect memory and registers, set registers, and control the
CPU (single step, run and run to breakpoint).
It supports a variety of file formats, described in the section BINARY
below. It can also be used as a remote stub for gdb
On startup, MSPDebug will look for a file called .mspdebug first in the current
directory, and then in the user's home directory. If either file exists,
commands will be read and executed from this file before executing any other
commands or starting the interactive reader.
Alternatively, a configuration file can be explicitly specified with the
Command-line options accepted by MSPDebug are described below. If commands are
specified on the end of the command-line, then they are executed after
connecting to the device, and the interactive prompt is not started. Please be
aware that commands consisting of multiple words need to be enclosed in
quotation marks, otherwise they are treated as single commands. Thus the
common prog command would be used as "prog main.elf". See the
section labelled COMMANDS
for more information.
- Start in quiet mode. See the "quiet" option described
- -v voltage
- Set the programming voltage. The voltage should be specified as an integer
in millivolts. It defaults to 3000 (3.0 V).
- Use JTAG instead of Spy-Bi-Wire to communicate with the MSP430. This
option doesn't work with eZ430 or eZ430-RF2500 devices, which support
- -d device
- Specify that the driver should connect via a tty device rather than USB.
The supported connection methods vary depending on the driver. See the
section DRIVERS below for details.
- -U bus:device
- Specify a particular USB device to connect to. Without this option, the
first device of the appropriate type is opened.
- -s serial
- Specify a particular USB device serial number to connect to. Use this
option to distinguish between multiple devices of the same type.
- Do not process the startup file (~/.mspdebug).
- -C file
- Specify an alternative configuration file (default is ~/.mspdebug). If -n
is specified as well, no file will be read.
- When using the flash-bsl driver, send a 32-byte BSL password instead of
the standard 16-byte password.
- Display a brief help message and exit.
- Display a list of chips supported by the FET driver (the driver used for
UIF, RF2500 and Olimex devices).
- --fet-force-id string
- When using a FET device, force the connected chip to be recognised by
MSPDebug as one of the given type during initialization. This overrides
the device ID returned by the FET. The given string should be a chip name
in long form, for example "MSP430F2274".
- When using a FET device, skip the JTAG close procedure when disconnecting.
With some boards, this removes the need to replug the debugger after
- List available USB devices and exit.
- When using a FET device, always send a reset during initialization. By
default, an initialization without reset will be tried first.
- When using a V3 FET device via the TI library, allow the library to
perform a firmware update if the FET firmware is incompatible with the
- --require-fw-update image.txt
- When using a V3 FET device, or certain Olimex devices, force a firmware
update using the given firmware image. The firmware format depends on the
- Show program version and copyright information.
- Start mspdebug as an embedded subprocess. See the documentation
accompanying the source release for more information on embedded
- --bsl-entry-sequence seq
- Specify a BSL entry sequence. Each character specifies a modem control
line transition (R: RTS on, r: RTS off, D: DTR on, d: DTR off). A comma
indicates a delay. The entry and exit sequences are separated by a colon.
The default value is dR,r,R,r,R,D:dR,DR, for the flash-bsl
For drivers supporting both USB and tty access, USB is the default, unless
specified otherwise (see -d
On Linux, if USB access is used, the kernel driver (if any) is detached from the
tty device. If further access to the tty device is needed, unloading and
re-loading of the driver (e.g. cdc-acm.ko) is required.
A driver name must be specified on the command line for MSPDebug to connect to.
Valid driver names are listed here.
- Connect to an eZ430-RF2500, Launchpad or Chronos device. Only USB
connection is supported.
- Connect to an Olimex MSP430-JTAG-TINY device. Both USB and tty access are
- Connect to an Olimex MSP430-JTAG-TINY (V1) device. Both USB and tty access
are supported. This driver must be used instead of olimex if
connecting to a V1 device via a tty interface.
- Connect to an Olimex MSP430-JTAG-ISO device. Both USB and tty access are
- Connect to an Olimex MSP430-JTAG-ISO-MK2 device. Both USB and tty access
- Do not connect to any hardware device, but instead start in simulation
mode. A 64k buffer is allocated to simulate the device memory.
During simulation, addresses below 0x0200 are assumed to be IO memory.
Programmed IO writes to and from IO memory are handled by the IO
simulator, which can be configured and controlled with the simio
command, described below.
This mode is intended for testing of changes to MSPDebug, and for aiding the
disassembly of MSP430 binaries (as all binary and symbol table formats are
still usable in this mode).
- Connect to an eZ430-F2013 or a FET430UIF device. The device argument
should be the filename of the appropriate tty device. The TI serial
converter chips on these devices are supported by newer versions of the
Linux kernel, and should appear as /dev/tty XX when attached.
USB connection is supported for this driver. The USB interface chip in these
devices is a TI3410, which requires a firmware download on startup.
MSPDebug will search for a file called ti_3410.fw.ihex in the configured
library directory and the current directory. You can specify an alternate
location for the file via the MSPDEBUG_TI3410_FW environment
- Connect to the bootloader on a FET430UIF device. These devices contain
MSP430F1612 chips. By sending a special command sequence, you can obtain
access to the bootloader and inspect memory on the MSP430F1612 in the
programming device itself.
Currently, only memory read/write and erase are supported. CPU control via
the bootloader is not possible.
- Connect to the built-in bootloader in MSP430 devices with flash bootloader
memory. Devices with ROM bootloaders require another driver. Currently,
this driver must mass-erase the device in order to gain access. Read,
write, and erase operations are supported.
USB connection is not supported for this driver. Connection is via serial
port, and bootloader entry is accomplished via the RTS and DTR lines.
Connect RTS to the device's TEST pin and DTR to the device's RST pin. Use
an appropriate serial level-shifter to make the connection, if necessary.
If connecting to a device with non-multiplexed JTAG pins, connect RTS to
the device's TCK pin via an inverter.
- GDB client mode. Connect to a server which implements the GDB remote
protocol and provide an interface to it. To use this driver, specify the
remote address in hostname:port format using the -d
- Use the Texas Instruments MSP430.DLL to access the device. The library
file (MSP430.DLL for Windows, libmsp430.so for Unix-like systems) must be
present in the dynamic loader search path.
USB connection is not supported for this driver. This driver supports
watchpoints. Note that the -d option for this driver passes its
argument straight through to the library's MSP430_Initialize
function. Any special argument supported by that function is therefore
accessible via the -d option.
Automatic device discovery works only on Linux and Windows. On other
systems, the appropriate ACM serial node must be explicitly
- Connect to a GoodFET device. JTAG mode must be used, and only tty access
is supported. This device can be used for memory access (read, erase and
program), but CPU control is limited. The CPU may be halted, run and
reset, but register access and breakpoints aren't supported.
- Connect to a parallel-port JTAG controller. JTAG mode must be used, and
only tty access is supported. Currently, this driver is only supported on
Linux, FreeBSD and DragonFly BSD. A parallel port device (ppdev on Linux,
ppi on FreeBSD and DragonFly BSD) must be specified via the -d
- Connect to system gpios. JTAG mode must be used, and only tty access is
supported. Currently, this driver is only supported on Linux, FreeBSD and
DragonFly BSD. The gpios to used must defined using a string like
"tdi=7 tdo=8 tms=9 tck=4 rst=10 tst=11" via the -d
option. (don't forget the quotes)
- Connect to a USB bootloader. The stub bootloader will be used to load a
fuller-featured bootloader into RAM for execution.
- This driver is for Texas Instruments' eZ-FET devices. It supports USB and
tty access. It does not support breakpoint control.
- This driver is for the old-style (ROM) bootstrap loader. It supports tty
access only. Entry is attempted via the RTS/DTR signals. The default
sequence is DR,r,R,r,d,R:DR,r, but you can override this with the
WARNING: this driver unlocks the BSL by performing a mass erase.
There are reports of this operation causing an erase of info A in some
devices. Use at your own risk.
- Raw JTAG using Bus Pirate devices.
MSPDebug can accept commands either through an interactive prompt, or
non-interactively when specified on the command line. The supported commands
are listed below.
Commands take arguments separated by spaces. Any text string enclosed in
double-quotation marks is considered to be a single argument, even if it
contains space characters. Within a quoted string, the usual C-style backslash
substitutions can be used.
Commands can be specified by giving the first few characters of the command
name, provided that the prefix is unambiguous. Some commands support automatic
repeat. For these commands, pressing enter at the reader prompt without typing
anything will cause repeat execution.
- ! [command [args ...]]
- Invoke an interactive operating system shell. If any arguments are
specified, the first one is taken as a command to execute, with the rest
of the arguments as the arguments to the command.
This command is not yet available on non-POSIX systems.
- = expression
- Evaluate an address expression and show both its value, and the result
when the value is looked up in reverse in the current symbol table. This
result is of the form symbol+offset, where symbol is
the name of the nearest symbol not past the address in question.
See the section marked ADDRESS EXPRESSIONS for more information on
the syntax of expressions.
- Show a list of defined command aliases.
- alias name
- Remove a previously defined command alias.
- alias name command
- Define a command alias. The text command will be substituted for
name when looking up commands. The given command text may contain a
command plus arguments, if the entire text is wrapped in quotes when
defining the alias. To avoid alias substitution when interpreting
commands, prefix the command with \ (a backslash character).
- Blow the device's JTAG fuse.
WARNING: this is an irreversible operation!
- Show a list of active breakpoints. Breakpoints can be added and removed
with the setbreak and delbreak commands. Each breakpoint is
numbered with an integer index starting at 0.
- cgraph address length [address]
- Construct the call graph of all functions contained or referenced in the
given range of memory. If a particular function is specified, then details
for that node of the graph are displayed. Otherwise, a summary of all
nodes is displayed.
Information from the symbol table is used for hinting at the possible
locations of function starts. Any symbol which does not contain a
"." is considered a possible function start.
Callers and callee names are shown prefixed by a "*" where the
transition is a tail-call type transition.
- delbreak [index]
- Delete one or all breakpoints. If an index is given, the selected
breakpoint is deleted. Otherwise, all breakpoints are cleared.
- dis address [length]
- Dissassemble a section of memory. Both arguments may be address
expressions. If no length is specified, a section of the default length
(64 bytes) is disassembled and shown.
If symbols are available, then all addresses used as operands are translated
into symbol+offset form.
This command supports repeat execution. If repeated, it continues to
disassemble another block of memory following that last printed.
- erase [all|segment|segrange] [address]
[ size] [segrange]
- Erase the device under test. With no arguments, all code memory is erased
(but not information or boot memory). With the argument "all", a
mass erase is performed (the results may depend on the state of the LOCKA
bit in the flash memory controller).
Specify "segment" and a memory address to erase an individual
flash segment. Specify "segrange", an address, size and segment
size to erase an arbitrary set of contiguous segments.
- Exit from MSPDebug.
- fill address length b0 [b1 b2
- Fill the memory region of size length starting at address
with the pattern of bytes given (specified in hexadecimal). The pattern
will be repeated without padding as many times as necessary without
exceeding the bounds of the specified region.
- gdb [port]
- Start a GDB remote stub, optionally specifying a TCP port to listen on. If
no port is given, the default port is controlled by the option
MSPDebug will wait for a connection on this port, and then act as a GDB
remote stub until GDB disconnects.
GDB's "monitor" command can be used to issue MSPDebug commands via
the GDB interface. Supplied commands are executed non-interactively, and
the output is sent back to be displayed in GDB.
- help [command]
- Show a brief listing of available commands. If an argument is specified,
show the syntax for the given command. The help text shown when no
argument is given is also shown when MSPDebug starts up.
- hexout address length filename
- Read the specified section of the device memory and save it to an Intel
HEX file. The address and length arguments may both be address
If the specified file already exists, then it will be overwritten. If you
need to dump memory from several disjoint memory regions, you can do this
by saving each section to a separate file. The resulting files can then be
concatenated together to form a single valid HEX file.
- isearch address length [options ...]
- Search over the given range for an instruction which matches the specified
search criteria. The search may be narrowed by specifying one or more of
the following terms:
- opcode opcode
- Match the specified opcode. Byte/word specifiers are not recognised, as
they are specified with other options.
- Match only byte operations.
- Match only word operations.
- Match only address-word (20-bit) operations.
- Match only jump instructions (conditional and unconditional jumps, but not
instructions such as BR which load the program counter explicitly).
- Match only single-operand instructions.
- Match only double-operand instructions.
- Match only instructions with no arguments.
- src address
- Match instructions with the specified value in the source operand. The
value may be given as an address expression. Specifying this option
implies matching of only double-operand instructions.
- dst address
- Match instructions with the specified value in the destination operand.
This option implies that no-argument instructions are not matched.
- srcreg register
- Match instructions using the specified register in the source operand.
This option implies matching of only double-operand instructions.
- dstreg register
- Match instructions using the specified register in the destination
operand. This option implies that no-argument instructions are not
- srcmode mode
- Match instructions using the specified mode in the source operand. See
below for a list of modes recognised. This option implies matching of only
- dstmode mode
- Match instructions using the specified mode in the destination operand.
See below for a list of modes. This option implies that no-argument
instructions are not matched.
- For single-operand instructions, the operand is considered to be the
The seven addressing modes used by the MSP430 are represented by single
characters, and are listed here:
- Register mode.
- Indexed mode.
- Symbolic mode.
- Absolute mode.
- Register-indirect mode.
- Register-indirect mode with auto-increment.
- Immediate mode.
- load filename
- Program the device under test using the binary file supplied. This command
is like prog, but it does not load symbols or erase the device
The CPU is reset and halted before and after programming.
- load_raw filename address
- Write the data contained in a raw binary file to the given memory address.
The CPU is reset and halted before and after programming.
- md address [length]
- Read the specified section of device memory and display it as a
canonical-style hexdump. Both arguments may be address expressions. If no
length is specified, a section of the default length (64 bytes) is shown.
The output is split into three columns. The first column shows the starting
address for the line. The second column lists the hexadecimal values of
the bytes. The final column shows the ASCII characters corresponding to
printable bytes, and . for non-printing characters.
This command supports repeat execution. If repeated, it continues to print
another block of memory following that last printed.
- mw address bytes ...
- Write a sequence of bytes at the given memory address. The address given
may be an address expression. Bytes values are two-digit hexadecimal
numbers separated by spaces.
- opt [name] [value]
- Query, set or list option variables. MSPDebug's behaviour can be
configured using option variables, described below in the section
Option variables may be of three types: boolean, numeric or text. Numeric
values may be specified as address expressions.
With no arguments, this command displays all available option variables.
With just an option name as its argument, it displays the current value of
- power info
- Show basic power statistics gathered over the last few sessions. This
includes total charge consumption, run time and average current.
- power clear
- Clear all recorded power statistics.
- power all [granularity]
- Show sample data gathered over all sessions. An optional granularity can
be specified, in microseconds. For each time slice, relative session time,
charge consumption, current consumption and approximate code location are
- power session N [granularity]
- Same as power all, except that data is shown only for the
- power export-csv N filename
- Export raw sample data for the Nth session to the given file in CSV
format. For each line, the columns are, in order: relative time in
microseconds, current consumption in microamps, memory address.
- power profile
- If a symbol table is loaded, compile and correlate all gathered power data
against the symbol table. A single table is then shown listing, per
function, charge consumption, run time and average current. The functions
are listed in order of charge consumption (biggest consumers first).
- prog filename
- Erase and reprogram the device under test using the binary file supplied.
The file format will be auto-detected and may be any of the supported file
In the case of a file containing symbols, symbols will be automatically
loaded from the file into the symbol table (discarding any existing
symbols), if they are present.
The CPU is reset and halted before and after programming.
- read filename
- Read commands from the given file, line by line and process each one. Any
lines whose first non-space character is # are ignored. If an error
occurs while processing a command, the rest of the file is not
- Show the current value of all CPU registers in the device under test.
- Reset (and halt) the CPU of the device under test.
- Start running the CPU. The interactive command prompt is blocked when the
CPU is started and the prompt will not appear again until the CPU halts.
The CPU will halt if it encounters a breakpoint, or if Ctrl-C is pressed
by the user.
After the CPU halts, the current register values are shown as well as a
disassembly of the first few instructions at the address selected by the
- save_raw address length filename
- Save a region of memory to a raw binary file. The address and length
arguments may both be address expressions.
If the specified file already exists, then it will be overwritten.
- set register value
- Alter the value of a register. Registers are specified as numbers from 0
through 15. Any leading non-numeric characters are ignored (so a register
may be specified as, for example, "R12"). The value argument is
an address expression.
- setbreak address [index]
- Add a new breakpoint. The breakpoint location is an address expression. An
optional index may be specified, indicating that this new breakpoint
should overwrite an existing slot. If no index is specified, then the
breakpoint will be stored in the next unused slot.
- setwatch address [index]
- Add a new watchpoint. The watchpoint location is an address expression,
and an optional index may be specified. Watchpoints are considered to be a
type of breakpoint and can be inspected or removed using the break
and delbreak commands. Note that not all drivers support
- setwatch_r address [index]
- Add a watchpoint which is triggered only on read access.
- setwatch_w address [index]
- Add a watchpoint which is triggered only on write access.
- simio add class name [args ...]
- Add a new peripheral to the IO simulator. The class parameter may
be any of the peripheral types named in the output of the simio
classes command. The name parameter is a unique name assigned
by the user to this peripheral instance, and is used with other commands
to refer to this instance of the peripheral.
Some peripheral classes take arguments upon creation. These are documented
in the output to the simio help command.
- simio classes
- List the names of the different types of peripherals which may be added to
the simulator. You can use the simio help command to obtain more
information about each peripheral type.
- simio config name param [args ...]
- Configure or perform some action on a peripheral instance. The
param argument is specific to the peripheral type. A list of valid
configuration commands can be obtained by using the simio help
- simio del name
- Remove a previously added peripheral instance. The name argument
should be the name of the peripheral that was assigned with the simio
- simio devices
- List all peripheral instances currently attached to the simulator, along
with their types and interrupt status. You can obtain more detailed
information for each instance with the simio info command.
- simio help class
- Obtain more information about a peripheral class. The documentation given
will list constructor arguments and configuration parameters for the
- simio info name
- Display detailed status information for a particular peripheral. The type
of information displayed is specific to each type of peripheral.
- step [count]
- Step the CPU through one or more instructions. After stepping, the new
register values are displayed, as well as a disassembly of the
instructions at the address selected by the program counter.
An optional count can be specified to step multiple times. If no argument is
given, the CPU steps once. This command supports repeat execution.
- sym clear
- Clear the symbol table, deleting all symbols.
- sym set name value
- Set or alter the value of a symbol. The value given may be an address
- sym del name
- Delete the given symbol from the symbol table.
- sym import filename
- Load symbols from the specified file and add them to the symbol table. The
file format will be auto-detected and may be either ELF32 or a BSD-style
symbol listing (like the output from nm(1)).
Symbols can be combined from many sources, as the syms command adds to the
existing symbol table without discarding existing symbols.
- sym import+ filename
- This command is similar to sym import, except that the symbol table
is not cleared first. By using this command, symbols from multiple sources
can be combined.
- sym export filename
- Save all symbols currently defined to the given file. The symbols are
saved as a BSD-style symbol table. Note that symbol types are not stored
by MSPDebug, and all symbols are saved as type t.
- sym find [regex]
- Search for symbols. If a regular expression is given, then all symbols
matching the expression are printed. If no expression is specified, then
the entire symbol table is listed.
- sym rename regex string
- Rename symbols by searching for those matching the given regular
expression and substituting the given string for the matched portion. The
symbols renamed are displayed, as well as a total count of all symbols
- verify filename
- Compare the contents of the given binary file to the chip memory. If any
differences are found, a message is printed for the first mismatched
- verify_raw filename address
- Compare the contents of a raw binary file to the device memory at the
given address. If any differences are found, a message is printed for the
first mismatched byte.
The following binary/symbol formats are supported by MSPDebug:
Intel HEX (program only)
BSD symbol table (symbols only)
TI Text (program only)
SREC (program only)
The IO simulator subsystem consists of a database of device classes, and a list
of instances of those classes. Each device class has a different set of
constructor arguments, configuration parameters and information which may be
displayed. This section describes the operation of the available device
classes in detail.
In the list below, each device class is listed, followed by its constructor
- Digital IO port simulator. This device simulates any of the digital ports
with or without interrupt capability. It has the following configuration
- base address
- Set the base address for this port. Note that for ports without interrupt
capability, the resistor enable port has a special address which is
computable from the base address.
- irq vector
- Enable interrupt functionality for this port by specifying an interrupt
- Disable interrupt functionality for this port.
- Print a state change message every time the port output changes.
- Don't print anything when the port state changes (the default).
- set pin value
- Set the input pin state for the given pin on this port. The pin
parameter should be an index between 0 and 7. The value should be
either zero (for a low state) or non-zero (for a high state).
- This peripheral simulates the hardware multiplier. It has no constructor
or configuration parameters, and does not provide any extended
- timer [size]
- This peripheral simulators Timer_A modules, and can be used to simulate
Timer_B modules, provided that the extended features aren't required.
The constructor takes a size argument specifying the number of
capture/compare registers in this peripheral instance. The number of such
registers may not be less than 2, or greater than 7.
The IO addresses and IRQs used are configurable. The default IO addresses
used are those specified for Timer_A in the MSP430 hardware
- base address
- Alter the base IO address. By default, this is 0x0160. By setting this to
0x0180, a Timer_B module may be simulated.
- irq0 number
- Set the TACCR0 interrupt vector number. By default, this is interrupt
vector 9. This interrupt is self-clearing, and higher priority than the
- irq1 number
- Set the TACCR1/TAIFG interrupt vector. By default, this is interrupt
- iv address
- Alter the address of the interrupt vector register. By default, this is
0x012E. By setting this to 0x011E, a Timer_B module may be simulated.
- set channel value
- When Timer_A is used in capture mode, the CCI bit in each capture register
reflects the state of the corresponding input pin, and can't be altered in
software. This configuration command can be used to simulate changes in
input pin state, and will trigger the corresponding interrupts if the
peripheral is so configured.
- tracer [history-size]
- The tracer peripheral is a debugging device. It can be used to investigate
and record the IO activity of a running program, to benchmark execution
time, and to simulate interrupts.
The information displayed by the tracer gives a running count of clock
cycles from each of the system clocks, and an instruction count. A list of
the N most recent IO events is also displayed (this is configurable
via the history-size argument of the constructor). Each IO event is
timestamped by the number of MCLK cycles that have elapsed since the last
reset of the device's counter.
The IO events that it records consist of programmed IO reads and writes,
interrupt acceptance, and system resets. As well as keeping the IO events
in a rotating buffer, the tracer can be configured to display the events
as they occur.
Note that since clock cycles don't advance while the CPU isn't running, this
peripheral can be used to calculate execution times for blocks of code.
This can be achieved by setting a breakpoint at the end of the code block,
setting the program counter to the start of the code block, clearing the
tracer and running the code. After the breakpoint is reached, the
information displayed by the tracer will contain a count of MCLK cycles
elapsed during the last run.
The configuration parameters for this device class are:
- Start displaying IO events as they occur, as well as recording them in the
- Stop displaying IO events as they occur, and just record them in the
- trigger irq
- Signal an interrupt request to the CPU. This request will remain raised
until accepted by the CPU or cleared by the user.
- Clear a signalled interrupt request.
- Reset the clock cycle and instruction counts to 0, and clear the IO event
- This peripheral simulates the Watchdog Timer+, which can be used in
software either as a watchdog or as an interval timer. It has no
The simulated state of the NMI/RST# pin can be controlled through a
configuration parameter. Note that if this pin state is held low with the
pin mode selected as a reset (the default), the CPU will not run.
The extended information for this peripheral shows all register states,
including the hidden counter register. Configuration parameters are:
- nmi state
- Set the NMI/RST# pin state. The argument should be zero to indicate a low
state or non-zero for a high state.
- irq irq
- Select the interrupt vector for interval timer mode. The default is to use
interrupt vector 10.
Any command which accepts a memory address, length or register value as an
argument may be given an address expression. An address expression consists of
an algebraic combination of values.
An address value can be one of the following:
A symbol name
A CPU register name preceded with "@"
A hex value preceded with the specifier "0x"
A decimal value preceded with the specifier "0d"
A number in the default input radix (without a specifier). See the option
for more information.
The operators recognised are the usual algebraic operators: +
. Operator precedence is
the same as in C-like languages, and the -
operator may be used as a
unary negation operator.
The following are all valid examples of address expressions:
table_start + (elem_size + elem_pad)*4
MSPDebug's behaviour can be configured via the following variables:
- color (boolean)
- If true, MSPDebug will colorize debugging output.
- fet_block_size (numeric)
- Change the size of the buffer used to transfer memory to and from the FET.
Increasing the value from the default of 64 will improve transfer speed,
but may cause problems with some chips.
- enable_bsl_access (boolean)
- If set, some drivers will allow erase/program access to flash BSL memory.
If in doubt, do not enable this.
- enable_locked_flash_access (boolean)
- If set, some drivers will allow erase/program access to the info A
segment. If in doubt, do not enable this. Currently, the tilib and uif
drivers are affected by this option.
- If set, some drivers will allow the JTAG security fuse to be blown.
WARNING: this is an irreversible operation!
If in doubt, do not enable this option.
- gdb_default_port (numeric)
- This option controls the default TCP port for the GDB server, if no
argument is given to the " gdb" command.
- gdb_loop (boolean)
- Automatically restart the GDB server after disconnection. If this option
is set, then the GDB server keeps running until an error occurs, or the
user interrupts with Ctrl+C.
- gdbc_xfer_size (numeric)
- Maximum size of memory transfers for the GDB client. Increasing this value
will result in faster transfers, but may cause problems with some
- iradix (numeric)
- Default input radix for address expressions. For address values with no
radix specifier, this value gives the input radix, which is 10 (decimal)
- quiet (boolean)
- If set, MSPDebug will suppress most of its debug-related output. This
option defaults to false, but can be set true on start-up using the
-q command-line option.
- Specifies the location of TI3410 firmware, for raw USB access to FET430UIF
or eZ430 devices. This variable should contain the path to an Intel HEX
file containing suitable firmware for the TI3410.
- File containing commands to be executed on startup.
- Firmware image for the TI3410 USB interface chip. This file is only
required for raw USB access to FET430UIF or eZ430 devices.
If you find any bugs, you should report them to the author at email@example.com.
It would help if you could include a transcript of an MSPDebug session
illustrating the program, as well as any relevant binaries or other files.
Copyright (C) 2009-2013 Daniel Beer <firstname.lastname@example.org>
MSPDebug is free software, distributed under the terms of the GNU General Public
license (version 2 or later). See the file COPYING included with the source
code for more details.
Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.