Debug Probe
lager debug
Lager debug commands
lager debug [OPTIONS] COMMAND [ARGS]...
connect
lager debug connect [OPTIONS]
Options
- --dut <dut>
ID of DUT
- --mcu <mcu>
MCU to connect
- --force, --no-force
Disconnect debugger before reconnecting. If not set, connect will fail if debugger is already connected. Cannot be used with --ignore-if-connected
- Default:
True
- --ignore-if-connected
If debugger is already connected, skip connection attempt and exit with success. Cannot be used with --force
- Default:
False
- --halt, --no-halt
Halt the device when connecting
- Default:
True
disconnect
lager debug disconnect [OPTIONS]
Options
- --dut <dut>
ID of DUT
- --mcu <mcu>
MCU to disconnect
erase
lager debug erase [OPTIONS] [START_ADDR] [LENGTH]
Options
- --dut <dut>
ID of DUT
- --mcu <mcu>
MCU to erase
Arguments
- START_ADDR
Optional argument
- LENGTH
Optional argument
flash
lager debug flash [OPTIONS]
Options
- --dut <dut>
ID of DUT
- --mcu <mcu>
MCU to disconnect
- --hexfile <hexfile>
Hexfile to flash.
- --binfile <binfile>
Binfile(s) to flash. Syntax: --binfile <filename>,<address> May be passed multiple times; files will be flashed in order.
gdb
Debug a DUT using an ELF file
lager debug gdb [OPTIONS] ELF_FILE
Options
- --dut <dut>
ID of DUT
- -i, --interpreter <interpreter>
Select a specific interpreter / user interface
- -v, --verbose
Print verbose debug info
- --tty <tty>
Use TTY for input/output by the program being debugged.
- -q, --quiet, --silent
Do not print the introductory and copyright messages. These messages are also suppressed in batch mode.
- --args <args>
Arguments passed to debugger
- --ignore-missing, --no-ignore-missing
Ignore missing files
- --cwd <cwd>
Set current working directory
- --cache, --no-cache
Use cached source if ELF file unchanged
- Default:
True
- --mcu <mcu>
MCU to query
- --elf-only
Only send ELF file; no source
- --debugfile <debugfile>
Debugger command file
Arguments
- ELF_FILE
Required argument
memrd
lager debug memrd [OPTIONS] START_ADDR LENGTH
Options
- --dut <dut>
ID of DUT
- --mcu <mcu>
MCU to erase
Arguments
- START_ADDR
Required argument
- LENGTH
Required argument
memwr
lager debug memwr [OPTIONS] START_ADDR DATA
Options
- --dut <dut>
ID of DUT
- --mcu <mcu>
MCU to erase
- --size <size>
Required Number of bytes to write
- Options:
1 | 2 | 4
Arguments
- START_ADDR
Required argument
- DATA
Required argument
reset
lager debug reset [OPTIONS]
Options
- --dut <dut>
ID of DUT
- --mcu <mcu>
MCU number
- --halt, --no-halt
Halt the DUT after reset. Default: do not halt
- Default:
False
rtt
lager debug rtt [OPTIONS]
Options
- --dut <dut>
ID of DUT
- --mcu <mcu>
MCU number
- --host <host>
interface for telnet to bind. Use --host '*' to bind to all interfaces.
- Default:
'localhost'
status
lager debug status [OPTIONS]
Options
- --dut <dut>
ID of DUT
- --mcu <mcu>
MCU to query