Chapter 4. API Guides
Note: The performance figures can vary greatly between installations based on network configuration and operating
environment.
4.8.9 Further Notes
• Data transmission uses Wi-Fi WPA2-PSK encryption
• Mesh networking IE uses AES encryption
Router and internet icon made by Smashicons from www.flaticon.com
4.9 Core Dump
4.9.1 Overview
ESP-IDF provides support to generate core dumps on unrecoverable software errors. This useful technique allows
post-mortem analysis of software state at the moment of failure. Upon the crash system enters panic state, prints some
information and halts or reboots depending configuration. User can choose to generate core dump in order to analyse
the reason of failure on PC later on. Core dump contains snapshots of all tasks in the system at the moment of failure.
Snapshots include tasks control blocks (TCB) and stacks. So it is possible to find out what task, at what instruction
(line of code) and what callstack of that task lead to the crash. It is also possible dumping variables content on demand
if previously attributed accordingly. ESP-IDF provides special script espcoredump.py to help users to retrieve and
analyse core dumps. This tool provides two commands for core dumps analysis:
• info_corefile - prints crashed task’s registers, callstack, list of available tasks in the system, memory
regions and contents of memory stored in core dump (TCBs and stacks)
• dbg_corefile - creates core dump ELF file and runs GDB debug session with this file. User can examine
memory, variables and tasks states manually. Note that since not all memory is saved in core dump only values
of variables allocated on stack will be meaningful
For more information about core dump internals see the - Core dump internals
4.9.2 Configurations
There are a number of core dump related configuration options which user can choose in project configuration menu
(idf.py menuconfig).
Core dump data destination (Components -> Core dump -> Data destination)
• Save core dump to Flash (Flash)
• Print core dump to UART (UART)
• Disable core dump generation (None)
Core dump data format (Components -> Core dump -> Core dump data format)
• ELF format (Executable and Linkable Format file for core dump)
• Binary format (Basic binary format for core dump)
The ELF format contains extended features and allow to save more information about broken tasks
and crashed software but it requires more space in the flash memory. This format of core dump is
recommended for new software designs and is flexible enough to extend saved information for future
revisions.
The Binary format is kept for compatibility standpoint, it uses less space in the memory to keep data and
provides better performance.
Core dump data integrity check (Components -> Core dump -> Core dump data integrity check)
• Use CRC32 for core dump integrity verification
Espressif Systems 1327
Submit Document Feedback
Release v4.4
To Next Page
Loading...
Need help?
General