Debug

lager debug [OPTIONS] [NET_NAME] COMMAND [ARGS]...

lager debug [NET_NAME] gdbserver [OPTIONS]

# Start GDB server on default debug net
lager debug gdbserver --box my-lager-box

# Start GDB server on specific net with halt
lager debug debug1 gdbserver --box my-lager-box --halt

# Start GDB server and stream RTT logs
lager debug gdbserver --box my-lager-box --rtt

# Capture boot sequence via RTT
lager debug gdbserver --box my-lager-box --rtt-reset

# Send commands to the target while reading its RTT output
lager debug gdbserver --box my-lager-box --rtt --interactive

# Use custom speed and port
lager debug gdbserver --box my-lager-box --speed 4000 --gdb-port 3333

# After starting gdbserver, connect with:
arm-none-eabi-gdb firmware.elf -ex 'target remote <BOX_IP>:2331'

JLinkGDBServer started!
GDB server running on my-lager-box. Connect to localhost:2331
Connect with: arm-none-eabi-gdb -ex 'target remote localhost:2331'
Tunnelling through the box's gateway. Press Ctrl-C to close the tunnel.

# In a second terminal
arm-none-eabi-gdb firmware.elf -ex 'target remote localhost:2331'

lager debug [NET_NAME] disconnect [OPTIONS]

# Stop GDB server completely
lager debug disconnect --box my-lager-box

# Disconnect but keep server running
lager debug disconnect --box my-lager-box --keep-server

lager debug [NET_NAME] flash [OPTIONS]

# Flash Intel HEX file
lager debug flash --hex build/firmware.hex --box my-lager-box

# Flash ELF file
lager debug flash --elf build/firmware.elf --box my-lager-box

# Flash binary with base address
lager debug flash --bin build/firmware.bin,0x08000000 --box my-lager-box

# Flash while preserving existing flash contents (skip the default erase)
lager debug flash --hex build/firmware.hex --no-erase --box my-lager-box

# Erase 2 MiB from the start of QSPI on a DA1469x, then flash
lager debug flash --bin build/app.bin,0x16000000 --erase-start 0x16000000 --erase-size 2M --box my-lager-box

# Flash and halt for debugging
lager debug flash --elf build/firmware.elf --halt --box my-lager-box

# Verbose output for troubleshooting
lager debug flash --hex build/firmware.hex --verbose --box my-lager-box

lager debug [NET_NAME] reset [OPTIONS]

# Reset and run
lager debug reset --box my-lager-box

# Reset and halt (for debugging)
lager debug reset --halt --box my-lager-box

# Force clean state before reset
lager debug reset --force-reconnect --box my-lager-box

lager debug [NET_NAME] erase [OPTIONS]

# Erase with confirmation prompt
lager debug erase --box my-lager-box

# Erase without confirmation
lager debug erase --box my-lager-box --yes

# Erase 2 MiB from the start of QSPI on a DA1469x
lager debug erase --box my-lager-box --yes --erase-start 0x16000000 --erase-size 2M

# Erase and halt afterward
lager debug erase --box my-lager-box --yes --halt

lager debug [NET_NAME] memrd START_ADDR LENGTH [OPTIONS]

# Read 16 bytes of SRAM
lager debug memrd 0x20000000 16 --box my-lager-box

# Read with device halted (more reliable)
lager debug memrd 0x20000000 64 --halt --box my-lager-box

# Output as JSON
lager debug memrd 0x08000000 32 --json --box my-lager-box

# DA1469x: read a blank/awake part without rebooting it
lager debug memrd 0x20000000 16 --no-reset --box my-lager-box

0x20000000:	0x00	0x01	0x02	0x03	0x04	0x05	0x06	0x07
0x20000008:	0x08	0x09	0x0a	0x0b	0x0c	0x0d	0x0e	0x0f

lager debug [NET_NAME] status [OPTIONS]

lager debug status --box my-lager-box
lager debug debug1 status --box my-lager-box

Debug Net Information:
  Name: debug1
  Device Type: STM32F407VG
  Architecture: ARM Cortex-M4
  Probe: J-Link
  GDB server running: True
  Target attached: Yes

lager debug [NET_NAME] health [OPTIONS]

# Basic health check
lager debug health --box my-lager-box

# Detailed health information
lager debug health --box my-lager-box --verbose

Debug Service Health:
  Status: healthy
  Version: 1.2.0
  Uptime: 2.5 days (216000s)
  J-Link Running: True
  J-Link PID: 12345
  GDB Controllers Cached: 1
  Active Connections: 1

lager debug --box my-lager-box

Name    Net Type  Instrument  Channel      Address
debug1  debug     J-Link      STM32F407VG  USB::001::002
debug2  debug     CMSIS-DAP   nRF52840     USB::001::003

# Stream RTT after connecting
lager debug gdbserver --box my-lager-box --rtt

# Reset device and capture boot messages
lager debug gdbserver --box my-lager-box --rtt-reset

# Pipe to defmt-print for formatted output
lager debug gdbserver --box my-lager-box --rtt 2>/dev/null | defmt-print -e firmware.elf

# Flash the build under test, then stream + decode a bounded window
lager debug SWD flash --elf build/app.elf --box my-lager-box
timeout 15 lager debug SWD gdbserver --box my-lager-box --rtt-reset 2>/dev/null \
  | defmt-print -e build/app.elf

lager debug SWD gdbserver --box my-lager-box --rtt --interactive

lager debug SWD gdbserver --box my-lager-box --rtt --interactive 2>/dev/null \
  | defmt-print -e build/app.elf

# Flash and debug
lager debug flash --elf build/app.elf --box my-lager-box
lager debug gdbserver --box my-lager-box --halt

# In another terminal, connect GDB
arm-none-eabi-gdb build/app.elf -ex 'target remote <BOX_IP>:2331'

# Flash for a clean RTT state (erase happens by default)
lager debug flash --elf build/app.elf --box my-lager-box

# Start GDB server and stream RTT with boot capture
lager debug gdbserver --box my-lager-box --rtt-reset

# Halt device and read memory
lager debug gdbserver --box my-lager-box --halt
lager debug memrd 0x20000000 256 --box my-lager-box

# Stop debug session
lager debug disconnect --box my-lager-box

# Full chip erase before new project
lager debug erase --box my-lager-box --yes

lager nets add debug1 debug STM32F407VG USB::001::002 \
  --jlink-script ./my_device.JLinkScript --box my-lager-box

lager nets set-script debug1 ./my_device.JLinkScript --box my-lager-box

{
  "DEBUG": {
    "debug1": "./scripts/my_device.JLinkScript"
  }
}

# View attached script
lager nets show-script debug1 --box my-lager-box

# Save script to local file
lager nets show-script debug1 --box my-lager-box > script.JLinkScript

# Remove script from net
lager nets remove-script debug1 --box my-lager-box

DA1469x flash_loader flash failed after '<last progress line>': <cause>. The QSPI erase already ran, so the board may be left blank until a flash succeeds.

# Flash a DA1469x image at the start of QSPI
lager debug SWD flash --bin build/app.bin,0x16000000 --box my-lager-box