Collect Debug Information
Brief Description
The script collect_debug_info.py provides a relatively easy way to dump memory contents and the trace stream of the executed instructions as well. The script can be used either in an "online" or "offline" mode depending on whether the memory contents come from a live capture or not. The script runs both on Windows and Linux provided that a 32bit version of 2.7 Python is installed. The script can be used either standalone or via the corresponding launcher in SmartSnippets Studio.
Prerequisites
An arm-none-eabi-gdb version with Python support is required.
A. Default way
Dialog's Development Environment provides it. It is called arm-none-eabi-gdb-py (or arm-none-eabi-gdb-py.exe in Windows). In order to use it, the following are needed:
- 32bit version of 2.7 Python sources.
In Windows the following additional steps should be made:
- In the installer choose the option "Add python.exe to Path"
- Add a new environmental variable
PYTHONPATHin Start Menu --> Computer icon --> Properties --> Advanced system settings --> Advanced tab --> Environment Variables
- Just for convenience of running the script in Windows it is advised to install git-bash (part of git for Windows).
B. Alternative way
Recompile the provided arm-none-eabi-gdb as it's not compiled with python support. To do so the following are needed:
- GDB sources
- Python headers
- The GNU Documentation System
E.g. For Ubuntu python-dev and texinfo need to be installed:
apt-get install python-dev
apt-get install texinfo
- Place
collect_debug_info.pyandgdb_custom_cmds.pyon the same path.
Compiling GDB
- Create a folder e.g /opt/gdb_build. This will be the location of the compiled gdb.
mkdir /opt/gdb_build - Extract gdb.
tar xvfz gdb-7.11.tar.gz - Change directory to gdb-7.11
cd gdb-7.11 - Execute:
./configure --target=arm-none-eabi --prefix=/opt/gdb_build -disable-interwork --enable-multilib --disable-werror --with-pythonmakemake install
Running the script
usage: ./collect_debug_info.py -f <elf_file> -b <mem_snapshot_file> - <toolchain_path> -x <registers_xml_file>, --sram_start <> --sram_stop <>
e.g 1 ./collect_debug_info.py -t /opt/gcc-arm-none-eabi-7-2017-q4-major/bin -f application.elf -x SVD.xml
Dumps RAM contents, symbols are provided by the elf file, peripheral registers by the -x argument.
Toolchain path is provided by the -t argument.
e.g 2 ./collect_debug_info.py -t /opt/gcc-arm-none-eabi-7-2017-q4-major/bin -f application.elf -b dump_memory.ihex --sram_start 0xXXXXXXXX --sram_stop 0xYYYYYYYY
Dumps RAM contents, symbols are provided by the elf file, memory contents will be read using the provided ihex file and the sram memory area.
Toolchain path is provided by the -t argument.
e.g 3 ./collect_debug_info.py -t /opt/gcc-arm-none-eabi-7-2017-q4-major/bin -f application.elf -b dump_memory.bin --sram_start 0xXXXXXXXX --sram_stop 0xYYYYYYYY
Dumps RAM contents, symbols are provided by the elf file, memory contents will be read using the provided raw bin file restored at address given with --sram_start
Toolchain path is provided by the -t argument.
The script creates an artifact-folder with a timestamp e.g dump_20160328-1459165500 for each execution-run. The folder contains the following:
1. symbols_20160328-1459165500.list [ The list of symbols ]
2. gdb_cmds_20160328-1459165500.log [ Our dump ]
3. gdb_cmds_20160328-1459165500.gdb [ The executed gdb commands ]
4. online_memory_snapshot_20160328-1459165500.ihex [ The memory snapshot during the online run ]
5. pxp_reporter.elf [ The elf file provided to the script ]
6. pxp_reporter.map [ The generated map file ]
All dumps are stored in a folder called debug_dumps which is created on the same path collect_debug_info.py is executed.
Using the launcher from SmartSnippets Studio
- Start the debugging procedure from SmartSnippets Studio. Then pause it at the moment of interest.
- Launch collect_debug_info.
Note: The launcher opens a file selection window-prompt for entering the corresponding xml register file found in
config/embsys/Dialog_Semiconductor/path. - Artifacts are stored in
utilities/python_scripts/collect_debug_info/debug_dumps
Note: Windows launcher expects Python interpreter in
C:\Python27\python.exe
Using the script in online mode
- Start the debugging procedure from SmartSnippets Studio. Then pause it at the moment of interest.
- Run e.g.
./collect_debug_info.py -t /opt/gcc-arm-none-eabi-7-2017-q4-major/bin -f my_application.elf -x SVD.xml[on Linux or git-bash on Windows]python collect_debug_info.py -t /c/DiaSemi/SmartSnippetsStudio/GCC/gcc-arm-none-eabi-7-2017-q4-major/bin -f my_application.elf -x SVD.xml[cmd on Windows]
- The results are found in the
debug_dumps/dump_XXXXXXXX-XXXXXXXXXX/gdb_cmds_XXXXXXXX-XXXXXXXXXX.logfile.
Using the script in offline mode
Given a memory snapshot in ihex format and the corresponding elf file e.g dump_memory.ihex and my_application.elf, respectively:
- Close SmartSnippets Studio if open.
- Start JLink GDB Server manually:
- On Windows launch the J-Link GDB Server application. [ All Programs->SEGGER->J-Link VX.XXx->J-Link GDB Server]
- On Linux type:
/opt/SEGGER/JLink/JLinkGDBServer -noir -vd -device Cortex-M?? -endian little -if SWD -speed 0 -localhostonly
- Run e.g.
./collect_debug_info.py -t /opt/gcc-arm-none-eabi-7-2017-q4-major/bin -f my_application.elf -b dump_memory.ihex --sram_start 0xXXXXXXXX --sram_stop 0xYYYYYYYY[on Linux or git-bash on Windows]python collect_debug_info.py -t /c/DiaSemi/SmartSnippetsStudio/GCC/gcc-arm-none-eabi-7-2017-q4-major/bin -f my_application.elf -b dump_memory.ihex --sram_start 0xXXXXXXXX --sram_stop 0xYYYYYYYY[cmd on Windows]
- The results are found in the
debug_dumps/dump_XXXXXXXX-XXXXXXXXXX/gdb_cmds_XXXXXXXX-XXXXXXXXXX.logfile.
Generating a memory snapshot in ihex format
A. Linux
- Start the debugging procedure from SmartSnippets Studio. Then pause it at the moment of interest.
Note: An alternative way is to exit SmartSnippets Studio and manually start JLink GDB Server as shown above.
- Run
arm-none-eabi-gdb. - On the gdb prompt type the following commands:
(gdb) target remote :2331
(gdb) dump ihex memory dump_memory.ihex 0xXXXXXXXX 0xYYYYYYYY
(gdb) quit
- dump_memory.ihex is created on the same path arm-none-eabi-gdb was executed.
B. Windows
- Start the debugging procedure from SmartSnippets Studio. Then pause it at the moment of interest.
Note: An alternative way is to exit SmartSnippets Studio and manually start JLink GDB Server as shown above.
- Run
arm-none-eabi-gdb.exe. This is located inC:\Program Files (x86)\Dialog Semiconductor\SmartSnippetsXXX\...\arm-none-eabi\bin - On the gdb prompt type the following commands:
(gdb) target remote :2331
(gdb) dump ihex memory dump_memory.ihex 0xXXXXXXXX 0xYYYYYYYY
(gdb) quit
- dump_memory.ihex is created on the same path arm-none-eabi-gdb.exe was executed.
Sections of the dump
ARM REGISTERS
This section starts from ARM_REGISTERS_START marker until ARM_REGISTERS_STOP.
E.g
__ARM_REGISTERS_START__
r0 0xffffffff 4294967295
r1 0xffffffff 4294967295
r2 0xffffffff 4294967295
r3 0xffffffff 4294967295
r4 0xffffffff 4294967295
r5 0xffffffff 4294967295
r6 0xffffffff 4294967295
r7 0xffffffff 4294967295
r8 0xffffffff 4294967295
r9 0xffffffff 4294967295
r10 0xffffffff 4294967295
r11 0xffffffff 4294967295
r12 0xffffffff 4294967295
sp 0x7fc8000 0x7fc8000
lr 0xffffffff 4294967295
pc 0x80002a4 0x80002a4 <Reset_Handler>
xpsr 0xc1000000 3238002688
MSP 0x7fc8000 133988352
PSP 0xfffffffc 4294967292
PRIMASK 0x0 0
BASEPRI 0x0 0
FAULTMASK 0x0 0
CONTROL 0x0 0
__ARM_REGISTERS_END__
CURRENT TASK BACKTRACE
This section starts from CURRENT_TASK_BACKTRACE_START marker until CURRENT_TASK_BACKTRACE_STOP.
It shows the backtrace of the current task. For example:
__CURRENT_TASK_BACKTRACE_START__
#0 0x0800e532 in __WFI () at /home/user/work/SDK/sdk/bsp/include/core_cmInstr.h:342
#1 prvSystemSleep (xExpectedIdleTime=12) at /home/user/work/SDK/sdk/free_rtos/portable/GCC/ARM_CM0/port.c:406
#2 0x0800fa2a in prvIdleTask (pvParameters=<optimized out>) at /home/user/work/SDK/sdk/free_rtos/tasks.c:2792
#3 0x0800e374 in vPortStartFirstTask () at /home/user/work/SDK/sdk/free_rtos/portable/GCC/ARM_CM0/port.c:187
__CURRENT_TASK_BACKTRACE_STOP__
ALL TASKS BACKTRACE
This section starts from ALL_TASKS_BACKTRACE_START marker until ALL_TASKS_BACKTRACE_STOP.
It shows the backtrace of all tasks. For example:
__ALL_TASKS_BACKTRACE_START__
[New Thread 536900576]
[New Thread 536885000]
[New Thread 536905488]
[New Thread 536912872]
[New Thread 536911992]
...
Thread 4 (Thread 536905488):
#0 0x000117a4 in vPortExitCritical () at /home/user/work/SDK/sdk/free_rtos/portable/GCC/DA1459x/../../../../free_rtos/include/../../free_rtos/portable/GCC/DA1459x/portmacro.h:276
#1 0x000135f2 in xTaskNotifyWait (ulBitsToClearOnEntry=ulBitsToClearOnEntry@entry=0, ulBitsToClearOnExit=ulBitsToClearOnExit@entry=4294967295, pulNotificationValue=pulNotificationValue@entry=0x200086dc <ucHeap+6600>, xTicksToWait=xTicksToWait@entry=4294967295) at /home/user/work/SDK/sdk/free_rtos/tasks.c:4561
#2 0x0000ea58 in ad_ble_task (pvParameters=<optimized out>) at /home/user/work/SDK/sdk/interfaces/ble/adapter/src/ad_ble.c:591
#3 0x0001163c in vPortFree (pv=0x200036d8 <xSuspendedTaskList>) at /home/user/work/SDK/sdk/free_rtos/portable/MemMang/heap_4.c:296
#4 0x80000070 in ?? ()
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
Thread 3 (Thread 536885000):
#0 execute_active_wfi () at /home/user/work/SDK/sdk/bsp/system/sys_man/sys_power_mgr_da1459x.c:744
#1 0x2000144c in pm_sleep_enter (low_power_periods=<optimized out>) at /home/user/work/SDK/sdk/bsp/system/sys_man/sys_power_mgr_da1459x.c:1519
#2 0x00011954 in prvSystemSleep (xExpectedIdleTime=<optimized out>) at /home/user/work/SDK/sdk/free_rtos/portable/GCC/DA1459x/port.c:614
#3 0x00012f58 in prvIdleTask (pvParameters=<optimized out>) at /home/user/work/SDK/sdk/free_rtos/tasks.c:3341
#4 0x0001163c in vPortFree (pv=0x0 <snc_set_field_ucode_get_context>) at /home/user/work/SDK/sdk/free_rtos/portable/MemMang/heap_4.c:296
#5 0x80000070 in ?? ()
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
Thread 2 (Thread 535900576):
#0 execute_active_wfi () at /home/user/work/SDK/sdk/bsp/system/sys_man/sys_power_mgr_da1459x.c:744
#1 0x2000144c in pm_sleep_enter (low_power_periods=<optimized out>) at /home/user/work/SDK/sdk/bsp/system/sys_man/sys_power_mgr_da1459x.c:1519
#2 0x00011954 in prvSystemSleep (xExpectedIdleTime=<optimized out>) at /home/user/work/SDK/sdk/free_rtos/portable/GCC/DA1459x/port.c:614
#3 0x00012f58 in prvIdleTask (pvParameters=<optimized out>) at /home/user/work/SDK/sdk/free_rtos/tasks.c:3341
#4 0x0001163c in vPortFree (pv=0x0 <snc_set_field_ucode_get_context>) at /home/user/work/SDK/sdk/free_rtos/portable/MemMang/heap_4.c:296
#5 0x80000070 in ?? ()
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
__ALL_TASKS_BACKTRACE_STOP__
Note: The above trace is applicable as long as the logs are collected using the SmartSnippets Studio
equipped with the FreeRTOS task trace capability.
SYMBOLS
This section starts from SYMBOLS_START marker until SYMBOL_STOP.
These are memory contents available in the current execution context, in a readable format. For example the symbol called ad_msg_wqueue is located at 0x07fd1668 and has a size of 64 bytes.
__SYMBOL__ 0x07fd1668 64 ad_msg_wqueue
$103 = {
queue = {{
rsp_op = AD_BLE_OP_CMP_EVT,
cmd_op = AD_BLE_OP_CMP_EVT,
cb = 0x80065fd <ble_adapter_cmp_evt_init>,
param = 0x7fd36a8 <ucHeap+7420>
}, {
rsp_op = AD_BLE_OP_CMP_EVT,
cmd_op = AD_BLE_OP_CMP_EVT,
cb = 0x0,
param = 0x0
}, {
rsp_op = AD_BLE_OP_CMP_EVT,
cmd_op = AD_BLE_OP_CMP_EVT,
cb = 0x0,
param = 0x0
}, {
rsp_op = AD_BLE_OP_CMP_EVT,
cmd_op = AD_BLE_OP_CMP_EVT,
cb = 0x0,
param = 0x0
}, {
rsp_op = AD_BLE_OP_CMP_EVT,
cmd_op = AD_BLE_OP_CMP_EVT,
cb = 0x0,
param = 0x0
}},
len = 0 '\000'
}
NVIC REGISTERS
This section starts from NVIC_REGISTERS_START marker until NVIC_REGISTERS_STOP.
It contains the content of certain registers of (or related to) the Nested Vectored Interrupt Controller of SYSCPU (Cortex M33 processor). These are the following:
- AIRCR (Application Interrupt and Reset Control Register)
- ISER (Interrupt Set Enable Registers)
- ISPR (Interrupt Set Pending Registers)
- IABR (Interrupt Active Bit Registers)
- IPR (Interrupt Priority Registers)
This provides an overview of which interrupts are enabled, what priorities have been set for them, and whether some of them are active or pending.
E.g.
__NVIC_REGISTERS_START__
AIRCR (PRIGROUP is in bits [10:8]): (address: 0xe000ed0c) hex: 0xfa052000 bin: 11111010000001010010000000000000
IPR[0]: (address: 0xe000e400) hex: 0x30102000 bin: 00110000000100000010000000000000
IPR[1]: (address: 0xe000e404) hex: 0x20202030 bin: 00100000001000000010000000110000
ISER[0]: (address: 0xe000e100) hex: 0x00808000 bin: 00000000100000001000000000000000
ISER[1]: (address: 0xe000e104) hex: 0x00000000 bin: 00000000000000000000000000000000
IABR[0]: (address: 0xe000e300) hex: 0x00000000 bin: 00000000000000000000000000000000
IABR[1]: (address: 0xe000e304) hex: 0x00000000 bin: 00000000000000000000000000000000
ISPR[0]: (address: 0xe000e180) hex: 0x00808000 bin: 00000000100000001000000000000000
ISPR[1]: (address: 0xe000e184) hex: 0x00000000 bin: 00000000000000000000000000000000
__NVIC_REGISTERS_END__
PERIPHERAL REGISTERS
This section starts from PERIPHERAL_REGISTERS_START marker until PERIPHERAL_REGISTERS_STOP.
It contains all the peripheral register values in groups. The register names are read from the corresponding xml file, for example DA1459x-00.xml.
E.g
__PERIPHERAL_REGISTERS_START__
__PERIPHERAL__: AES_HASH
__REG__: CRYPTO_CLRIRQ_REG Reading from address 0x30040018 (Data = 0x00000000)
__REG__: CRYPTO_CTRL_REG Reading from address 0x30040000 (Data = 0x00000000)
__REG__: CRYPTO_DEST_ADDR_REG Reading from address 0x30040010 (Data = 0x00000000)
__REG__: CRYPTO_FETCH_ADDR_REG Reading from address 0x30040008 (Data = 0x00000000)
__REG__: CRYPTO_KEYS_START Reading from address 0x30040100 (Data = 0x00000000)
__REG__: CRYPTO_LEN_REG Reading from address 0x3004000C (Data = 0x00000000)
__REG__: CRYPTO_MREG0_REG Reading from address 0x3004001C (Data = 0x00000000)
__REG__: CRYPTO_MREG1_REG Reading from address 0x30040020 (Data = 0x00000000)
__REG__: CRYPTO_MREG2_REG Reading from address 0x30040024 (Data = 0x00000000)
__REG__: CRYPTO_MREG3_REG Reading from address 0x30040028 (Data = 0x00000000)
__REG__: CRYPTO_START_REG Reading from address 0x30040004 (Data = 0x00000000)
__REG__: CRYPTO_STATUS_REG Reading from address 0x30040014 (Data = 0x00000000)
__PERIPHERAL__: ANAMISC_BIF
__REG__: CLK_CAL_IRQ_REG Reading from address 0x50040B1C (Data = 0x00000000)
__REG__: CLK_REF_CNT_REG Reading from address 0x50040B14 (Data = 0x00000000)
__REG__: CLK_REF_SEL_REG Reading from address 0x50040B10 (Data = 0x00000000)
__REG__: CLK_REF_VAL_REG Reading from address 0x50040B18 (Data = 0x00000000)
__PERIPHERAL__: CACHE
__REG__: CACHE_CTRL2_REG Reading from address 0x1A0C0020 (Data = 0x10040000)
__REG__: CACHE_EFLASH_REG Reading from address 0x1A0C0044 (Data = 0x00A09006)
__REG__: CACHE_FLASH_REG Reading from address 0x1A0C0040 (Data = 0x16000006)
__REG__: CACHE_MRM_CTRL_REG Reading from address 0x1A0C0030 (Data = 0x00000000)
__REG__: CACHE_MRM_HITS1WS_REG Reading from address 0x1A0C0048 (Data = 0x00000000)
__REG__: CACHE_MRM_HITS_REG Reading from address 0x1A0C0028 (Data = 0x00000000)
__REG__: CACHE_MRM_HITS_THRES_REG Reading from address 0x1A0C003C (Data = 0x00000000)
__REG__: CACHE_MRM_MISSES_REG Reading from address 0x1A0C002C (Data = 0x00000000)
__REG__: CACHE_MRM_MISSES_THRES_REG Reading from address 0x1A0C0038 (Data = 0x00000000)
__REG__: CACHE_MRM_TINT_REG Reading from address 0x1A0C0034 (Data = 0x00000000)
__REG__: SWD_RESET_REG Reading from address 0x1A0C0050 (Data = 0x00000000)
...
__PERIPHERAL_REGISTERS_STOP__
CURRENT FREE_RTOS TASK
This section starts from CURRENT_FREE_RTOS_TASK_START marker until CURRENT_FREE_RTOS_TASK_STOP.
It contains the name of the current FreeRTOS task. For example:
__CURRENT_FREE_RTOS_TASK_START__
$222 = "IDLE"
__CURRENT_FREE_RTOS_TASK_STOP__
FREE_RTOS LISTS
This section starts from EXPAND_FREE_RTOS_LIST_STARTS marker until EXPAND_FREE_RTOS_LIST_STOP.
The following FreeRTOS lists are expanded:
pxReadyTasksLists
xDelayedTaskList1
xDelayedTaskList2
pxDelayedTaskList
pxOverflowDelayedTaskList
xPendingReadyList
xSuspendedTaskList
In addition, a sanity check takes place so that the number of elements matches uxNumberOfItems. If it doesn't, a corruption is detected and logged. So it's a good practice to search for the "List corruption" keyword in the dump.
Non corrupted example: Expanding xSuspendedTaskList list which contains 5 elements (tasks).
__LIST_SYMBOL__ xSuspendedTaskList
node@0x7fd25cc <ucHeap+3104>: {
xItemValue = 0,
pxNext = 0x7fd27c4 <ucHeap+3608>,
pxPrevious = 0x7fd1800 <xSuspendedTaskList+8>,
pvOwner = 0x7fd25c8 <ucHeap+3100>,
pvContainer = 0x7fd17f8 <xSuspendedTaskList>
} #1 -----------------------------------------------------------------------> First element of the list
pvOwner@0x7fd25c8 <ucHeap+3100>: { -----------------------------------------> Corresponding owner casted as (TCB_t *)
pxTopOfStack = 0x7fd2548 <ucHeap+2972>,
xGenericListItem = {
xItemValue = 0,
pxNext = 0x7fd27c4 <ucHeap+3608>,
pxPrevious = 0x7fd1800 <xSuspendedTaskList+8>,
pvOwner = 0x7fd25c8 <ucHeap+3100>,
pvContainer = 0x7fd17f8 <xSuspendedTaskList>
},
xEventListItem = {
xItemValue = 3,
pxNext = 0x0,
pxPrevious = 0x0,
pvOwner = 0x7fd25c8 <ucHeap+3100>,
pvContainer = 0x0
},
uxPriority = 4,
pxStack = 0x7fd2430 <ucHeap+2692>,
pcTaskName = "USBC", ------------------------------------------------------> Corresponding task name
uxTCBNumber = 4,
uxTaskNumber = 0,
uxBasePriority = 4,
uxMutexesHeld = 0,
ulNotifiedValue = 0,
eNotifyState = eWaitingNotification
}
PC @ 0800cc1a ---> symbol and line for /home/user/work/SDK/sdk/free_rtos/portable/GCC/ARM_CM0/port.c, line 273
LR @ 0800e3c3 ---> symbol and line for /home/user/work/SDK/sdk/free_rtos/tasks.c, line 4074
--------------------------------------------------------------------
node@0x7fd27c4 <ucHeap+3608>: {
xItemValue = 0,
pxNext = 0x7fd36dc <ucHeap+7472>,
pxPrevious = 0x7fd25cc <ucHeap+3104>,
pvOwner = 0x7fd27c0 <ucHeap+3604>,
pvContainer = 0x7fd17f8 <xSuspendedTaskList>
} #2
pvOwner@0x7fd27c0 <ucHeap+3604>: {
pxTopOfStack = 0x7fd2730 <ucHeap+3460>,
xGenericListItem = {
xItemValue = 0,
pxNext = 0x7fd36dc <ucHeap+7472>,
pxPrevious = 0x7fd25cc <ucHeap+3104>,
pvOwner = 0x7fd27c0 <ucHeap+3604>,
pvContainer = 0x7fd17f8 <xSuspendedTaskList>
},
xEventListItem = {
xItemValue = 3,
pxNext = 0x0,
pxPrevious = 0x0,
pvOwner = 0x7fd27c0 <ucHeap+3604>,
pvContainer = 0x0
},
uxPriority = 4,
pxStack = 0x7fd2628 <ucHeap+3196>,
pcTaskName = "USBF",
uxTCBNumber = 5,
uxTaskNumber = 0,
uxBasePriority = 4,
uxMutexesHeld = 0,
ulNotifiedValue = 0,
eNotifyState = eWaitingNotification
}
PC @ 0800cc1a ---> symbol and line for /home/user/work/SDK/sdk/free_rtos/portable/GCC/ARM_CM0/port.c, line 273
LR @ 0800e3c3 ---> symbol and line for /home/user/work/SDK/sdk/free_rtos/tasks.c, line 4074
--------------------------------------------------------------------
node@0x7fd36dc <ucHeap+7472>: {
xItemValue = 0,
pxNext = 0x7fd3944 <ucHeap+8088>,
pxPrevious = 0x7fd27c4 <ucHeap+3608>,
pvOwner = 0x7fd36d8 <ucHeap+7468>,
pvContainer = 0x7fd17f8 <xSuspendedTaskList>
} #3
pvOwner@0x7fd36d8 <ucHeap+7468>: {
pxTopOfStack = 0x7fd3648 <ucHeap+7324>,
xGenericListItem = {
xItemValue = 0,
pxNext = 0x7fd3944 <ucHeap+8088>,
pxPrevious = 0x7fd27c4 <ucHeap+3608>,
pvOwner = 0x7fd36d8 <ucHeap+7468>,
pvContainer = 0x7fd17f8 <xSuspendedTaskList>
},
xEventListItem = {
xItemValue = 5,
pxNext = 0x0,
pxPrevious = 0x0,
pvOwner = 0x7fd36d8 <ucHeap+7468>,
pvContainer = 0x0
},
uxPriority = 2,
pxStack = 0x7fd34d0 <ucHeap+6948>,
pcTaskName = "bleM",
uxTCBNumber = 7,
uxTaskNumber = 0,
uxBasePriority = 2,
uxMutexesHeld = 0,
ulNotifiedValue = 0,
eNotifyState = eWaitingNotification
}
PC @ 0800cc1a ---> symbol and line for /home/user/work/SDK/sdk/free_rtos/portable/GCC/ARM_CM0/port.c, line 273
LR @ 0800e3c3 ---> symbol and line for /home/user/work/SDK/sdk/free_rtos/tasks.c, line 4074
--------------------------------------------------------------------
node@0x7fd3944 <ucHeap+8088>: {
xItemValue = 0,
pxNext = 0x7fd328c <ucHeap+6368>,
pxPrevious = 0x7fd36dc <ucHeap+7472>,
pvOwner = 0x7fd3940 <ucHeap+8084>,
pvContainer = 0x7fd17f8 <xSuspendedTaskList>
} #4
pvOwner@0x7fd3940 <ucHeap+8084>: {
pxTopOfStack = 0x7fd3860 <ucHeap+7860>,
xGenericListItem = {
xItemValue = 0,
pxNext = 0x7fd328c <ucHeap+6368>,
pxPrevious = 0x7fd36dc <ucHeap+7472>,
pvOwner = 0x7fd3940 <ucHeap+8084>,
pvContainer = 0x7fd17f8 <xSuspendedTaskList>
},
xEventListItem = {
xItemValue = 6,
pxNext = 0x0,
pxPrevious = 0x0,
pvOwner = 0x7fd3940 <ucHeap+8084>,
pvContainer = 0x0
},
uxPriority = 1,
pxStack = 0x7fd3738 <ucHeap+7564>,
pcTaskName = "PXP ",
uxTCBNumber = 8,
uxTaskNumber = 0,
uxBasePriority = 1,
uxMutexesHeld = 0,
ulNotifiedValue = 0,
eNotifyState = eWaitingNotification
}
PC @ 0800cc1a ---> symbol and line for /home/user/work/SDK/sdk/free_rtos/portable/GCC/ARM_CM0/port.c, line 273
LR @ 0800e3c3 ---> symbol and line for /home/user/work/SDK/sdk/free_rtos/tasks.c, line 4074
--------------------------------------------------------------------
node@0x7fd328c <ucHeap+6368>: {
xItemValue = 0,
pxNext = 0x7fd1800 <xSuspendedTaskList+8>,
pxPrevious = 0x7fd3944 <ucHeap+8088>,
pvOwner = 0x7fd3288 <ucHeap+6364>,
pvContainer = 0x7fd17f8 <xSuspendedTaskList>
} #5
pvOwner@0x7fd3288 <ucHeap+6364>: {
pxTopOfStack = 0x7fd3200 <ucHeap+6228>,
xGenericListItem = {
xItemValue = 0,
pxNext = 0x7fd1800 <xSuspendedTaskList+8>,
pxPrevious = 0x7fd3944 <ucHeap+8088>,
pvOwner = 0x7fd3288 <ucHeap+6364>,
pvContainer = 0x7fd17f8 <xSuspendedTaskList>
},
xEventListItem = {
xItemValue = 4,
pxNext = 0x7fd18b8 <xPendingReadyList+8>,
pxPrevious = 0x7fd18b8 <xPendingReadyList+8>,
pvOwner = 0x7fd3288 <ucHeap+6364>,
pvContainer = 0x0
},
uxPriority = 3,
pxStack = 0x7fd2e80 <ucHeap+5332>,
pcTaskName = "bleA",
uxTCBNumber = 6,
uxTaskNumber = 0,
uxBasePriority = 3,
uxMutexesHeld = 0,
ulNotifiedValue = 0,
eNotifyState = eWaitingNotification
}
PC @ 0800cc1a ---> symbol and line for /home/user/work/SDK/sdk/free_rtos/portable/GCC/ARM_CM0/port.c, line 273
LR @ 0800e3c3 ---> symbol and line for /home/user/work/SDK/sdk/free_rtos/tasks.c, line 4074
--------------------------------------------------------------------
FREE_RTOS HEAP
This section starts from EXPAND_FREE_RTOS_HEAP_START marker until EXPAND_FREE_RTOS_HEAP_STOP.
It contains all the allocated memory blocks given by the FreeRTOS memory management system. In addition, it provides statistics regarding the usage of the heap and its fragmentation level.
E.g
__EXPAND_FREE_RTOS_HEAP_START__
...
memblock@0x7fd1e18 <ucHeap+1132> size 408 { -----------> memblock starting @ 0x7fd1e18, the actual pointer given by pvPortMalloc() is memblock + 8 bytes, block size 408 bytes.
pxNextFreeBlock = 0x0, -----------> All the allocated memblocks have their pxNextFreeBlock == 0x0.
xBlockSize = 0x80000198 -----------> (memblock size || xBlockAllocatedBit), xBlockAllocatedBit == 0x80000000. The size includes the memblock header which is 8 bytes.
}
memblock@0x7fd1fb0 <ucHeap+1540> size 96 {
pxNextFreeBlock = 0x0,
xBlockSize = 0x80000060
}
memblock@0x7fd2010 <ucHeap+1636> size 200 {
pxNextFreeBlock = 0x0,
xBlockSize = 0x800000c8
}
...
Heap size 21584: bytes ------------> Heap size based on configTOTAL_HEAP_SIZE
Sum of allocated heap blocks: 15744 bytes ------------> Consumed heap blocks
Max size of a free block: 5048 bytes ------------> Maximum size out of all free blocks
Sum of free blocks 5824: bytes ------------> Freed heap blocks
Heap fragmentation percentage: 13.32% ------------> Fragmentation level (the less the better)
__EXPAND_FREE_RTOS_HEAP_STOP__
FREE_RTOS TASK STATUS
This section starts from FREE_RTOS_TASK_STATUS_START marker until FREE_RTOS_TASK_STATUS_STOP
This is a pretty-print of the pxTaskStatusArray variable. The project must have its vApplicationIdleHook() modified accordingly in order to collect task information. Then dg_configTRACK_OS_HEAP must be set to 1 in the custom header file.
E.g
__FREE_RTOS_TASK_STATUS_START__
Name xTaskNumber xHandle eCurrentState uxCurrentPriority uxBasePriority ulRunTimeCounter usStackHighWaterMark(words) usStackHighWaterMark(bytes)
"IDLE" 2 0x7fd2468 eReady 0 0 0 60 240
"temp" 10 0x7fd4260 eBlocked 1 1 0 122 488
"gpad" 9 0x7fd3d88 eBlocked 1 1 0 120 480
"Tmr " 3 0x7fd2728 eBlocked 6 6 0 69 276
"uart" 7 0x7fd3940 eBlocked 1 1 0 38 152
"uart" 8 0x7fd3ad8 eBlocked 1 1 0 38 152
"uart" 6 0x7fd37a8 eBlocked 1 1 0 26 104
"cons" 11 0x7fd46b8 eSuspended 1 1 0 55 220
"main" 4 0x7fd3280 eBlocked 1 1 0 52 208
+ +
--------------------------- ---------------------------
580 2320
__FREE_RTOS_TASK_STATUS_STOP__
MEMORY HEX DUMP
This section starts from HEX_DUMP_START marker until HEX_DUMP_STOP
E.g
__HEX_DUMP_START__
0x7fc0000: 0x07fc8000 0x080002a5 0x07fd0001 0x07fd0019
0x7fc0010: 0x00000000 0x00000000 0x00000000 0x00000000
0x7fc0020: 0x00000000 0x00000000 0x00000000 0x08000335
...
__HEX_DUMP_STOP__
MICRO TRACE BUFFER DUMP
This section starts from MTB_START marker until MTB_END
This is a pretty-print of complete trace stream of the instructions that have been executed and will fit into the RAM area. The project must have enabled the Micro Trace Buffer. To do so dg_configENABLE_MTB must be set to 1 in the custom header file.
Note: MTB is available only for 69x, 59x and 70x targets.
E.g
__MTB_START__
MTB_BASE hex: 0x2007e000 bin: 00100000000001111110000000000000
MTB_SECURE hex: 0x00000000 bin: 00000000000000000000000000000000
MTB_MASTER hex: 0x80000009 bin: 10000000000000000000000000001001
MTB_FLOW hex: 0x00000000 bin: 00000000000000000000000000000000
MTB_POSITION hex: 0x00001e2c bin: 00000000000000000001111000101100
MTB_TSTART hex: 0x00000000 bin: 00000000000000000000000000000000
MTB_TSTOP hex: 0x00000000 bin: 00000000000000000000000000000000
***********************************0x2007fe20***********************************
SOURCE ADDRESS = 0x00009c7e A_BIT = 0x0
/home/user/work/SDK/sdk/free_rtos/task.c:1294
0x9c7e <vTaskDelayUntil+142>: pop {r3, r4, r5, pc}
DEST ADDRESS = 0x0000a81a S_BIT = 0x0
../main.c:150
0xa81a <prvTemplateTask+18>: ldr r3, [pc, #40] ; (0xa844 <prvTemplateTask+60>)
***********************************0x2007fe18***********************************
SOURCE ADDRESS = 0x00009c7a A_BIT = 0x0
/home/user/work/SDK/sdk/free_rtos/task.c:1288
0x9c7a <vTaskDelayUntil+138>: isb sy
DEST ADDRESS = 0x00009c7e S_BIT = 0x0
/home/user/work/SDK/sdk/free_rtos/task.c:1294
0x9c7e <vTaskDelayUntil+142>: pop {r3, r4, r5, pc}
***********************************0x2007fe10***********************************
SOURCE ADDRESS = 0xffffffbc A_BIT = 0x1
Failed to find pc_line
DEST ADDRESS = 0x00009c7a S_BIT = 0x0
/home/user/work/SDK/sdk/free_rtos/task.c:1288
0x9c7a <vTaskDelayUntil+138>: isb sy
...
__MTB_END__
CMAC CACHE MEMORY HEX DUMP
This section starts from CMAC_CACHE_HEX_DUMP_START marker until CMAC_CACHE_HEX_DUMP_END
Note this is available only for 59x targets.
E.g
__CMAC_CACHE_HEX_DUMP_START__
...
0x40108000: 0x1e60a55a 0x40109ef4 0x00000000 0x00000000
0x40108010: 0x00000000 0x00000000 0x00000000 0x00000000
0x40108020: 0x00000000 0x00000000 0x00000000 0x00000000
...
__CMAC_CACHE_HEX_DUMP_END__
___ ___ ________ ___. .__ ._._._.
/ | \_____ ______ ______ ___.__. \______ \ ____\_ |__ __ __ ____ ____ |__| ____ ____| | | |
/ ~ \__ \ \____ \\____ < | | | | \_/ __ \| __ \| | \/ ___\ / ___\| |/ \ / ___\ | | |
\ Y // __ \| |_> > |_> >___ | | ` \ ___/| \_\ \ | / /_/ > /_/ > | | \/ /_/ >|\|\|
\___|_ /(____ / __/| __// ____| /_______ /\___ >___ /____/\___ /\___ /|__|___| /\___ /______
\/ \/|__| |__| \/ \/ \/ \/ /_____//_____/ \//_____/ \/\/\/
