============== minidumpserver ============== Introduction ============ This tool can utilize a crash log on a PC to simulate a set of GDB server functionalities, enabling the use of GDB to debug the context of a NuttX crash. The script directory is located in ``tools/minidumpserver.py``. Usage ===== We can use ``-h`` to get help information: .. code-block:: bash $ usage: minidumpserver.py [-h] -e ELFFILE -l LOGFILE [-a {arm,arm-a,arm-t,riscv,esp32s3,xtensa}] [-p PORT] [--debug] options: -h, --help show this help message and exit -e ELFFILE, --elffile ELFFILE elffile -l LOGFILE, --logfile LOGFILE logfile -a {arm,arm-a,arm-t,riscv,esp32s3,xtensa}, --arch {arm,arm-a,arm-t,riscv,esp32s3,xtensa} select architecture, if not use this options, The architecture will be inferred from the logfile -p PORT, --port PORT gdbport --debug Example ======= 1. Use ./tools/configure.sh esp32s3-devkit:nsh and disable `CONFIG_NSH_DISABLE_MW`. 2. `make -j` 3. Flash image to esp32s3-devkit. 4. Run `minicom -D /dev/ttyUSB0 -b 115200` and reset esp32s3-devkit. 5. Use `mw -1` on nsh to trigger a crash. 6. Get the crash log from minicom and save it to `crash.log`. .. code-block:: bash up_dump_register: PC: 42009cd8 PS: 00060820 up_dump_register: A0: 82007d71 A1: 3fc8b6d0 A2: 3fc8b8e0 A3: 00000000 up_dump_register: A4: ffffffff A5: 00000000 A6: 00000001 A7: 00000000 up_dump_register: A8: ffffffff A9: 3fc8b690 A10: ffffffff A11: 00000000 up_dump_register: A12: 0000002d A13: 0000002d A14: 3fc8bb6d A15: 0fffffff up_dump_register: SAR: 00000000 CAUSE: 0000001c VADDR: ffffffff up_dump_register: LBEG: 40055499 LEND: 400554a9 LCNT: fffffffc dump_stack: User Stack: dump_stack: base: 0x3fc8b0e0 dump_stack: size: 00002000 dump_stack: sp: 0x3fc8b6d0 stack_dump: 0x3fc8b6c0: 82007770 3fc8b700 3fc8b8e0 00000002 ffffffff 3fc89f54 00060e20 00000000 stack_dump: 0x3fc8b6e0: 3fc8b8e0 3fc8b778 00000000 3fc8b750 82007850 3fc8b720 3fc8b8e0 00000002 stack_dump: 0x3fc8b700: 3fc8b720 42009c84 3fc8bb68 3fc8b8e0 82006b04 3fc8b7d0 3fc8b8e0 3fc8bb68 stack_dump: 0x3fc8b720: 3fc8bb68 3fc8bb6b 00000000 00000000 00000000 00000000 00000000 00000000 stack_dump: 0x3fc8b740: 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 stack_dump: 0x3fc8b760: 00000000 00000000 00000000 00000000 00000000 00000000 00000000 3fc8bb69 stack_dump: 0x3fc8b780: 82006ad5 00000000 00000000 00000040 00000040 3fc8bb6e 3fc8adf8 0000002c stack_dump: 0x3fc8b7a0: ffffffff 00000005 00000000 00000000 3fc8bae0 00000000 00000000 00000000 stack_dump: 0x3fc8b7c0: 820068a2 3fc8b800 3fc8b8e0 3c020837 00000001 3fc8b800 3fc8b8e0 3c020837 stack_dump: 0x3fc8b7e0: 0000000a 3fc8bae0 00000001 3fc8bb68 82006865 3fc8b820 00000001 3fc8b0c0 stack_dump: 0x3fc8b800: 00000001 3fc8bb68 00000000 3fc8ae1c 82003618 3fc8b840 00000001 3fc8b0c0 stack_dump: 0x3fc8b820: 3fc8b8e0 00000000 00000000 00000000 820019dc 3fc8b870 42006834 00000001 stack_dump: 0x3fc8b840: 00000064 00000000 00000000 00000000 3c0225d8 3fc89590 00000000 3fc880cc stack_dump: 0x3fc8b860: 00000000 3fc8b890 00000000 00000000 3fc8b0c0 00000002 00000000 3fc8ad98 stack_dump: 0x3fc8b880: 00000000 3fc8b8b0 00000000 00000000 00000000 00000000 00000000 00000000 7. Run `./tools/minidumpserver.py -e nuttx -l crash.log -p 1234 -a esp32s3` 8. Run `xtensa-esp32s3-elf-gdb nuttx -ex "target remote 127.0.0.1:1234"` .. code-block:: bash GNU gdb (esp-gdb) 12.1_20221002 Copyright (C) 2022 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. Type "show copying" and "show warranty" for details. This GDB was configured as "--host=x86_64-linux-gnu --target=xtensa-esp-elf". Type "show configuration" for configuration details. For bug reporting instructions, please see: . Find the GDB manual and other documentation resources online at: . For help, type "help". Type "apropos word" to search for commands related to "word"... Reading symbols from nuttx... Remote debugging using 127.0.0.1:1234 0x42009cd8 in cmd_mw (vtbl=0x3fc8b8e0, argc=, argv=) at nsh_dbgcmds.c:259 259 nsh_output(vtbl, " %p = 0x%08" PRIx32, ptr, *ptr); (gdb) bt #0 0x42009cd8 in cmd_mw (vtbl=0x3fc8b8e0, argc=, argv=) at nsh_dbgcmds.c:259 #1 0x42007d71 in nsh_command (vtbl=0x3fc8b8e0, argc=2, argv=0x3fc8b720) at nsh_command.c:1154 #2 0x42007770 in nsh_execute (oflags=, redirfile=0x0, argv=0x3fc8b720, argc=2, vtbl=0x3fc8b8e0) at nsh_parse.c:845 #3 nsh_parse_command (vtbl=0x3fc8b8e0, cmdline=) at nsh_parse.c:2744 #4 0x42007850 in nsh_parse (vtbl=0x3fc8b8e0, cmdline=0x3fc8bb68 ) at nsh_parse.c:2828 #5 0x42006b04 in nsh_session (pstate=0x3fc8b8e0, login=, argc=1, argv=) at nsh_session.c:245 #6 0x420068a2 in nsh_consolemain (argc=1, argv=0x3fc8b0c0) at nsh_consolemain.c:71 #7 0x42006865 in nsh_main (argc=1, argv=0x3fc8b0c0) at nsh_main.c:74 #8 0x42003618 in nxtask_startup (entrypt=0x42006834 , argc=1, argv=0x3fc8b0c0) at sched/task_startup.c:70 #9 0x420019dc in nxtask_start () at task/task_start.c:134 (gdb) How to add new architecture =========================== The main objective is to establish the sequence of registers in GDB, aligning the register names in the crash log with the order of registers in GDB. This alignment will facilitate the creation of a new architecture's GDB server.