Fixed old bugs preventing doc build
This commit is contained in:
Tomáš Pilný
Xiang Xiao
parent
9ce8d4eca2
commit
4cfd5048b6
@ -7,26 +7,27 @@ Introduction
|
|||||||
|
|
||||||
This tool can utilize a crash log on a PC to simulate a set of GDB server functionalities,
|
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.
|
enabling the use of GDB to debug the context of a NuttX crash.
|
||||||
The script directory is located in `tools/minidumpserver.py`.
|
The script directory is located in ``tools/minidumpserver.py``.
|
||||||
|
|
||||||
Usage
|
Usage
|
||||||
=====
|
=====
|
||||||
|
|
||||||
We can use `-h` to get help information:
|
We can use ``-h`` to get help information:
|
||||||
```bash
|
|
||||||
$usage: minidumpserver.py [-h] -e ELFFILE -l LOGFILE [-a {arm,arm-a,arm-t,riscv,esp32s3,xtensa}] [-p PORT] [--debug]
|
|
||||||
|
|
||||||
options:
|
.. code-block:: bash
|
||||||
-h, --help show this help message and exit
|
|
||||||
-e ELFFILE, --elffile ELFFILE
|
$ usage: minidumpserver.py [-h] -e ELFFILE -l LOGFILE [-a {arm,arm-a,arm-t,riscv,esp32s3,xtensa}] [-p PORT] [--debug]
|
||||||
elffile
|
|
||||||
-l LOGFILE, --logfile LOGFILE
|
options:
|
||||||
logfile
|
-h, --help show this help message and exit
|
||||||
-a {arm,arm-a,arm-t,riscv,esp32s3,xtensa}, --arch {arm,arm-a,arm-t,riscv,esp32s3,xtensa}
|
-e ELFFILE, --elffile ELFFILE
|
||||||
select architecture,if not use this options, The architecture will be inferred from the logfile
|
elffile
|
||||||
-p PORT, --port PORT gdbport
|
-l LOGFILE, --logfile LOGFILE
|
||||||
--debug
|
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
|
Example
|
||||||
=======
|
=======
|
||||||
@ -36,74 +37,76 @@ Example
|
|||||||
4. Run `minicom -D /dev/ttyUSB0 -b 115200` and reset esp32s3-devkit.
|
4. Run `minicom -D /dev/ttyUSB0 -b 115200` and reset esp32s3-devkit.
|
||||||
5. Use `mw -1` on nsh to trigger a crash.
|
5. Use `mw -1` on nsh to trigger a crash.
|
||||||
6. Get the crash log from minicom and save it to `crash.log`.
|
6. Get the crash log from minicom and save it to `crash.log`.
|
||||||
```
|
|
||||||
up_dump_register: PC: 42009cd8 PS: 00060820
|
.. code-block:: bash
|
||||||
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: PC: 42009cd8 PS: 00060820
|
||||||
up_dump_register: A8: ffffffff A9: 3fc8b690 A10: ffffffff A11: 00000000
|
up_dump_register: A0: 82007d71 A1: 3fc8b6d0 A2: 3fc8b8e0 A3: 00000000
|
||||||
up_dump_register: A12: 0000002d A13: 0000002d A14: 3fc8bb6d A15: 0fffffff
|
up_dump_register: A4: ffffffff A5: 00000000 A6: 00000001 A7: 00000000
|
||||||
up_dump_register: SAR: 00000000 CAUSE: 0000001c VADDR: ffffffff
|
up_dump_register: A8: ffffffff A9: 3fc8b690 A10: ffffffff A11: 00000000
|
||||||
up_dump_register: LBEG: 40055499 LEND: 400554a9 LCNT: fffffffc
|
up_dump_register: A12: 0000002d A13: 0000002d A14: 3fc8bb6d A15: 0fffffff
|
||||||
dump_stack: User Stack:
|
up_dump_register: SAR: 00000000 CAUSE: 0000001c VADDR: ffffffff
|
||||||
dump_stack: base: 0x3fc8b0e0
|
up_dump_register: LBEG: 40055499 LEND: 400554a9 LCNT: fffffffc
|
||||||
dump_stack: size: 00002000
|
dump_stack: User Stack:
|
||||||
dump_stack: sp: 0x3fc8b6d0
|
dump_stack: base: 0x3fc8b0e0
|
||||||
stack_dump: 0x3fc8b6c0: 82007770 3fc8b700 3fc8b8e0 00000002 ffffffff 3fc89f54 00060e20 00000000
|
dump_stack: size: 00002000
|
||||||
stack_dump: 0x3fc8b6e0: 3fc8b8e0 3fc8b778 00000000 3fc8b750 82007850 3fc8b720 3fc8b8e0 00000002
|
dump_stack: sp: 0x3fc8b6d0
|
||||||
stack_dump: 0x3fc8b700: 3fc8b720 42009c84 3fc8bb68 3fc8b8e0 82006b04 3fc8b7d0 3fc8b8e0 3fc8bb68
|
stack_dump: 0x3fc8b6c0: 82007770 3fc8b700 3fc8b8e0 00000002 ffffffff 3fc89f54 00060e20 00000000
|
||||||
stack_dump: 0x3fc8b720: 3fc8bb68 3fc8bb6b 00000000 00000000 00000000 00000000 00000000 00000000
|
stack_dump: 0x3fc8b6e0: 3fc8b8e0 3fc8b778 00000000 3fc8b750 82007850 3fc8b720 3fc8b8e0 00000002
|
||||||
stack_dump: 0x3fc8b740: 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000
|
stack_dump: 0x3fc8b700: 3fc8b720 42009c84 3fc8bb68 3fc8b8e0 82006b04 3fc8b7d0 3fc8b8e0 3fc8bb68
|
||||||
stack_dump: 0x3fc8b760: 00000000 00000000 00000000 00000000 00000000 00000000 00000000 3fc8bb69
|
stack_dump: 0x3fc8b720: 3fc8bb68 3fc8bb6b 00000000 00000000 00000000 00000000 00000000 00000000
|
||||||
stack_dump: 0x3fc8b780: 82006ad5 00000000 00000000 00000040 00000040 3fc8bb6e 3fc8adf8 0000002c
|
stack_dump: 0x3fc8b740: 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000
|
||||||
stack_dump: 0x3fc8b7a0: ffffffff 00000005 00000000 00000000 3fc8bae0 00000000 00000000 00000000
|
stack_dump: 0x3fc8b760: 00000000 00000000 00000000 00000000 00000000 00000000 00000000 3fc8bb69
|
||||||
stack_dump: 0x3fc8b7c0: 820068a2 3fc8b800 3fc8b8e0 3c020837 00000001 3fc8b800 3fc8b8e0 3c020837
|
stack_dump: 0x3fc8b780: 82006ad5 00000000 00000000 00000040 00000040 3fc8bb6e 3fc8adf8 0000002c
|
||||||
stack_dump: 0x3fc8b7e0: 0000000a 3fc8bae0 00000001 3fc8bb68 82006865 3fc8b820 00000001 3fc8b0c0
|
stack_dump: 0x3fc8b7a0: ffffffff 00000005 00000000 00000000 3fc8bae0 00000000 00000000 00000000
|
||||||
stack_dump: 0x3fc8b800: 00000001 3fc8bb68 00000000 3fc8ae1c 82003618 3fc8b840 00000001 3fc8b0c0
|
stack_dump: 0x3fc8b7c0: 820068a2 3fc8b800 3fc8b8e0 3c020837 00000001 3fc8b800 3fc8b8e0 3c020837
|
||||||
stack_dump: 0x3fc8b820: 3fc8b8e0 00000000 00000000 00000000 820019dc 3fc8b870 42006834 00000001
|
stack_dump: 0x3fc8b7e0: 0000000a 3fc8bae0 00000001 3fc8bb68 82006865 3fc8b820 00000001 3fc8b0c0
|
||||||
stack_dump: 0x3fc8b840: 00000064 00000000 00000000 00000000 3c0225d8 3fc89590 00000000 3fc880cc
|
stack_dump: 0x3fc8b800: 00000001 3fc8bb68 00000000 3fc8ae1c 82003618 3fc8b840 00000001 3fc8b0c0
|
||||||
stack_dump: 0x3fc8b860: 00000000 3fc8b890 00000000 00000000 3fc8b0c0 00000002 00000000 3fc8ad98
|
stack_dump: 0x3fc8b820: 3fc8b8e0 00000000 00000000 00000000 820019dc 3fc8b870 42006834 00000001
|
||||||
stack_dump: 0x3fc8b880: 00000000 3fc8b8b0 00000000 00000000 00000000 00000000 00000000 00000000
|
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`
|
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"`
|
8. Run `xtensa-esp32s3-elf-gdb nuttx -ex "target remote 127.0.0.1:1234"`
|
||||||
|
|
||||||
```bash
|
.. 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 <http://gnu.org/licenses/gpl.html>
|
|
||||||
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:
|
|
||||||
<https://www.gnu.org/software/gdb/bugs/>.
|
|
||||||
Find the GDB manual and other documentation resources online at:
|
|
||||||
<http://www.gnu.org/software/gdb/documentation/>.
|
|
||||||
|
|
||||||
For help, type "help".
|
GNU gdb (esp-gdb) 12.1_20221002
|
||||||
Type "apropos word" to search for commands related to "word"...
|
Copyright (C) 2022 Free Software Foundation, Inc.
|
||||||
Reading symbols from nuttx...
|
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
|
||||||
Remote debugging using 127.0.0.1:1234
|
This is free software: you are free to change and redistribute it.
|
||||||
0x42009cd8 in cmd_mw (vtbl=0x3fc8b8e0, argc=<optimized out>, argv=<optimized out>) at nsh_dbgcmds.c:259
|
There is NO WARRANTY, to the extent permitted by law.
|
||||||
259 nsh_output(vtbl, " %p = 0x%08" PRIx32, ptr, *ptr);
|
Type "show copying" and "show warranty" for details.
|
||||||
(gdb) bt
|
This GDB was configured as "--host=x86_64-linux-gnu --target=xtensa-esp-elf".
|
||||||
#0 0x42009cd8 in cmd_mw (vtbl=0x3fc8b8e0, argc=<optimized out>, argv=<optimized out>) at nsh_dbgcmds.c:259
|
Type "show configuration" for configuration details.
|
||||||
#1 0x42007d71 in nsh_command (vtbl=0x3fc8b8e0, argc=2, argv=0x3fc8b720) at nsh_command.c:1154
|
For bug reporting instructions, please see:
|
||||||
#2 0x42007770 in nsh_execute (oflags=<optimized out>, redirfile=0x0, argv=0x3fc8b720, argc=2, vtbl=0x3fc8b8e0)
|
<https://www.gnu.org/software/gdb/bugs/>.
|
||||||
at nsh_parse.c:845
|
Find the GDB manual and other documentation resources online at:
|
||||||
#3 nsh_parse_command (vtbl=0x3fc8b8e0, cmdline=<optimized out>) at nsh_parse.c:2744
|
<http://www.gnu.org/software/gdb/documentation/>.
|
||||||
#4 0x42007850 in nsh_parse (vtbl=0x3fc8b8e0,
|
|
||||||
cmdline=0x3fc8bb68 <error: Cannot access memory at address 0x3fc8bb68>) at nsh_parse.c:2828
|
For help, type "help".
|
||||||
#5 0x42006b04 in nsh_session (pstate=0x3fc8b8e0, login=<optimized out>, argc=1, argv=<optimized out>)
|
Type "apropos word" to search for commands related to "word"...
|
||||||
at nsh_session.c:245
|
Reading symbols from nuttx...
|
||||||
#6 0x420068a2 in nsh_consolemain (argc=1, argv=0x3fc8b0c0) at nsh_consolemain.c:71
|
Remote debugging using 127.0.0.1:1234
|
||||||
#7 0x42006865 in nsh_main (argc=1, argv=0x3fc8b0c0) at nsh_main.c:74
|
0x42009cd8 in cmd_mw (vtbl=0x3fc8b8e0, argc=<optimized out>, argv=<optimized out>) at nsh_dbgcmds.c:259
|
||||||
#8 0x42003618 in nxtask_startup (entrypt=0x42006834 <nsh_main>, argc=1, argv=0x3fc8b0c0)
|
259 nsh_output(vtbl, " %p = 0x%08" PRIx32, ptr, *ptr);
|
||||||
at sched/task_startup.c:70
|
(gdb) bt
|
||||||
#9 0x420019dc in nxtask_start () at task/task_start.c:134
|
#0 0x42009cd8 in cmd_mw (vtbl=0x3fc8b8e0, argc=<optimized out>, argv=<optimized out>) at nsh_dbgcmds.c:259
|
||||||
(gdb)
|
#1 0x42007d71 in nsh_command (vtbl=0x3fc8b8e0, argc=2, argv=0x3fc8b720) at nsh_command.c:1154
|
||||||
````
|
#2 0x42007770 in nsh_execute (oflags=<optimized out>, redirfile=0x0, argv=0x3fc8b720, argc=2, vtbl=0x3fc8b8e0)
|
||||||
|
at nsh_parse.c:845
|
||||||
|
#3 nsh_parse_command (vtbl=0x3fc8b8e0, cmdline=<optimized out>) at nsh_parse.c:2744
|
||||||
|
#4 0x42007850 in nsh_parse (vtbl=0x3fc8b8e0,
|
||||||
|
cmdline=0x3fc8bb68 <error: Cannot access memory at address 0x3fc8bb68>) at nsh_parse.c:2828
|
||||||
|
#5 0x42006b04 in nsh_session (pstate=0x3fc8b8e0, login=<optimized out>, argc=1, argv=<optimized out>)
|
||||||
|
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 <nsh_main>, 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
|
How to add new architecture
|
||||||
===========================
|
===========================
|
||||||
|
|||||||
@ -13,9 +13,10 @@ CONFIGURATION
|
|||||||
===============
|
===============
|
||||||
|
|
||||||
.. code-block:: c
|
.. code-block:: c
|
||||||
CONFIG_DISABLE_IDLE_LOOP=y
|
|
||||||
CONFIG_SYSTEM_OFLOADER=y
|
CONFIG_DISABLE_IDLE_LOOP=y
|
||||||
CONFIG_SYSTEM_OFLOADER_TABLE="/dev/flash,0x08000000,0x20000"，0
|
CONFIG_SYSTEM_OFLOADER=y
|
||||||
|
CONFIG_SYSTEM_OFLOADER_TABLE="/dev/flash,0x08000000,0x20000"，0
|
||||||
|
|
||||||
```CONFIG_DISABLE_IDLE_LOOP`` is used to disable the idle loop in NuttX.
|
```CONFIG_DISABLE_IDLE_LOOP`` is used to disable the idle loop in NuttX.
|
||||||
```CONFIG_SYSTEM_OFLOADER``` is used to enable the Open Flash Loader.
|
```CONFIG_SYSTEM_OFLOADER``` is used to enable the Open Flash Loader.
|
||||||
@ -32,13 +33,14 @@ Usage
|
|||||||
1. Build NuttX with Open Flash Loader.
|
1. Build NuttX with Open Flash Loader.
|
||||||
2. Configure the Jlink xml file. like
|
2. Configure the Jlink xml file. like
|
||||||
|
|
||||||
.. code-block::
|
.. code-block:: xml
|
||||||
<Database>
|
|
||||||
<Device>
|
<Database>
|
||||||
<ChipInfo Vendor="STM32NUTTX" Name="NuttX" Core="JLINK_CORE_CORTEX_M4" WorkRAMAddr="0x20000000" WorkRAMSize="0x10000000" />
|
<Device>
|
||||||
<FlashBankInfo Name="Storage" BaseAddr="0x00000000" MaxSize="0xffffffff" Loader="/home/ajh/work/vela_all/nuttx/nuttx" LoaderType="FLASH_ALGO_TYPE_OPEN" AlwaysPresent="1"/>
|
<ChipInfo Vendor="STM32NUTTX" Name="NuttX" Core="JLINK_CORE_CORTEX_M4" WorkRAMAddr="0x20000000" WorkRAMSize="0x10000000" />
|
||||||
</Device>
|
<FlashBankInfo Name="Storage" BaseAddr="0x00000000" MaxSize="0xffffffff" Loader="/home/ajh/work/vela_all/nuttx/nuttx" LoaderType="FLASH_ALGO_TYPE_OPEN" AlwaysPresent="1"/>
|
||||||
</Database>
|
</Device>
|
||||||
|
</Database>
|
||||||
|
|
||||||
3. Use ``JLinkExe -if SWD -speed 4000 -device STM32NUTTX``,
|
3. Use ``JLinkExe -if SWD -speed 4000 -device STM32NUTTX``,
|
||||||
then ``loadbin /home/ajh/work/nuttx.bin 0x08000000``,
|
then ``loadbin /home/ajh/work/nuttx.bin 0x08000000``,
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user