Nesiac is a terminal tool for visualising memory usage in embedded programs.
As an example when run on the STM32 "HID_Standalone" project for STM32H747I-DISCO board:
Nesiac may be installed with pip via:
python -m pip install nesiac
The nesiac executable will then be made available in your python executables directory, which should be on your path.
Nesiac requires two files to do its analysis:
- An ELF file for section and symbol info
- A map file (in GCC style) for memory region info
If Nesiac is given a single path as argument, that path should be a directory containing exactly one .elf and one .map file. In that case, Nesiac will use those files for analysis.
Alternatively those paths may be overriden with the -e,--elf-file and -m,--map-file arguments.
Exporting a map file from GCC may be enabled with the -Wl,-Map=<FILE> flag.
If you are using a linker that cannot generate GCC style map files, then you can provide a dummy map file with the region info in the correct format:
Memory Configuration
Name Origin Length Attributes
FLASH 0x0000000008000000 0x0000000000100000 xr
RAM 0x0000000024000000 0x0000000000020000 xrw
ITCMRAM 0x0000000000000000 0x0000000000010000 xrw
*default* 0x0000000000000000 0xffffffffffffffff
Nesiac will demangle C++ and Rust symbols when it finds them.
