Merge pull request #218 from screamerbg/use-memap

Add memory analysis to mbed-os build system

Author: 0xc0170

docs/memap.md

@@ -0,0 +1,93 @@
+
+# memap - Static Memory Map Analysis
+
+## Introduction
+
+*memap* is a simple utility useful to display static memory information required by [mbed-OS](https://github.com/ARMmbed/mbed-os) applications. This information is produced by analysing the memory map file previously generated by your toolchain.
+
+Note: this tool is only showing static RAM usage and the total size of allocated heap and stack space, not the actual heap and stack usage.
+
+## Table of Contents
+
+1. [Using memap](#using-memap)
+1. [Running pytest](#running-pytest)
+1. [Current support](#current-support)
+1. [Known problems](#known-problems)
+
+## Using memap
+
+*memap* is a simple utility which is automatically invoked after an mbed-os build finishes succesfully.
+It's also possible to manually run the program with differnt command line options:
+
+```
+$> python memap.py
+usage: memap-script.py [-h] -t TOOLCHAIN [-o OUTPUT] [-j] [-v] file
+
+Memory Map File Analyser for ARM mbed OS version 0.3.7
+
+positional arguments:
+  file                  memory map file
+
+optional arguments:
+  -h, --help            show this help message and exit
+  -t TOOLCHAIN, --toolchain TOOLCHAIN
+                        select a toolchain that corresponds to the memory map
+                        file (ARM, GCC_ARM, IAR)
+  -o OUTPUT, --output OUTPUT
+                        output file name
+  -j, --json            output in JSON formatted list
+  -v, --version         show program's version number and exit
+```
+
+Example:
+
+```
+$> python memap.py GCC_ARM\myprog3.map -t GCC_ARM
+
++-----------------------------------+-------+-------+------+
+| Module                            | .text | .data | .bss |
++-----------------------------------+-------+-------+------+
+| Misc                              |  248  |   12  |  28  |
+| core/mbed-rtos                    |  5638 |   24  | 2494 |
+| core/util                         |  323  |   0   |  8   |
+| core/uvisor-mbed-lib              |   4   |   0   |  0   |
+| frameworks/greentea-client        |  416  |   28  |  0   |
+| frameworks/utest                  |  3055 |   32  | 688  |
+| hal/common                        |  2453 |   4   | 272  |
+| hal/targets                       |  9796 |   0   | 672  |
+| net/LWIPInterface                 |  172  |   4   | 272  |
+| net/atmel-rf-driver               |  332  |   8   | 212  |
+| net/mbed-client                   |   64  |   4   |  12  |
+| net/nanostack-hal-mbed-cmsis-rtos |  100  |   4   |  56  |
+| net/nanostack-interface           |   40  |   4   |  16  |
+| Subtotals                         | 22641 |  124  | 4730 |
++-----------------------------------+-------+-------+------+
+Static RAM memory (data + bss): 4854
+Heap: 131072
+Stack: 3072
+Total RAM memory (data + bss + heap + stack): 138998
+Total Flash memory (text + data): 22765
+Elapsed time: 55mS
+```
+
+Information on memory sections:
+
+- text: is where the code application and constants are located in Flash
+- data: initialized variables, allocated in both RAM and Flash memory
+- bss: uninitialized data allocated in RAM
+- heap: dynamic allocated memory, usually used by malloc, etc, in RAM
+- stack: used to store local data, temporary data when branching to a subroutine and context switch info; considered dynamic allocated memory region in RAM.
+
+
+## Current support
+
+*memap* has been tested on Windows 7, Linux and Mac.
+
+Supported map files generated by the following toolchains: gcc, ARM Compiler 5 and IAR.
+
+## Known problems & New features
+
+This utility is considered 'Alpha' quality at the moment.
+The report generated may not be accurate and may vary from one toolchain to another.
+
+If you are seeing problems or would like new features to be added then please raise a ticket on [GitHub](https://github.com/ARMmbed/mbed-os/issues) and use ```[memap] ``` in the title.

setup.py

@@ -40,7 +40,7 @@
       url='https://github.com/mbedmicro/mbed',
       packages=find_packages(),
       license=LICENSE,
-      install_requires=["PrettyTable>=0.7.2", "PySerial>=2.7", "IntelHex>=1.3", "colorama>=0.3.3", "Jinja2>=2.7.3", "project-generator>=0.8.11,<0.9.0", "junit-xml", "requests", "pyelftools"])
+      install_requires=["PrettyTable>=0.7.2", "PySerial>=2.7", "IntelHex>=1.3", "colorama>=0.3.3", "Jinja2>=2.7.3", "project-generator>=0.8.11,<0.9.0", "junit-xml", "requests"])
 
 # Restore previous private_settings if needed
 if backup: