Warning! Undefined pio_reset_halt_target command

tgioiosa · February 11, 2021, 9:47pm

What does this mean and why does it appear when debugging?

maxgerhardt · February 11, 2021, 9:59pm

Probably that you have modified the debug_init_cmds or use some custom debugging directives. pio_reset_halt_target is a GDB function definition that PlatformIO inserts in the GDB-client and it contains the debug-tool specific commands to halt the target.

See docs and code for the standard definition

github.com

platformio/platformio-core/blob/7c8508b65176d30212dbd4199b044c1c2a67d37c/platformio/commands/debug/initcfgs.py#L15-L29


      
          GDB_DEFAULT_INIT_CONFIG = """
          define pio_reset_halt_target
              monitor reset halt
          end
          
          
define pio_reset_run_target
              monitor reset
          end
          
          
target extended-remote $DEBUG_PORT
          monitor init
          $LOAD_CMDS
          pio_reset_halt_target
          $INIT_BREAK
          """

Notice how the definitions can differ.

github.com

platformio/platformio-core/blob/7c8508b65176d30212dbd4199b044c1c2a67d37c/platformio/commands/debug/initcfgs.py#L47-L51


      
          GDB_JLINK_INIT_CONFIG = """
          define pio_reset_halt_target
              monitor reset
              monitor halt
          end

github.com

platformio/platformio-core/blob/7c8508b65176d30212dbd4199b044c1c2a67d37c/platformio/commands/debug/initcfgs.py#L67-L76


      
          GDB_BLACKMAGIC_INIT_CONFIG = """
          define pio_reset_halt_target
              set language c
              set *0xE000ED0C = 0x05FA0004
              set $busy = (*0xE000ED0C & 0x4)
              while ($busy)
                  set $busy = (*0xE000ED0C & 0x4)
              end
              set language auto
          end

tgioiosa · February 12, 2021, 1:28am

Thanks maxgerhardt for that information. Yes I have modified the debug_init_cmds and use some custom debugging directives to get my STLink to work with LPC chips. So I should define those in my platformio.ini file under debug_init_cmds I assume.
As you point out, these function definitions can differ a lot. How does one figure out what needs to be put in these functions? For instance, I’m currently using STLink for my debug tool, is there some pre-existing standard for that interface or is it a try and see what’s needed approach?

maxgerhardt · February 12, 2021, 5:40pm

The function definitions in GDB_DEFAULT_INIT_CONFIG should apply to that if it gets used with OpenOCD, I think.