andy/tinyUSB
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

Add linkermap for size analysis (#1136)

Browse Source 
* add NO_LTO option to make
* add linkermap submodule and linkermap target
* add linkermap to ci build
* linkermap doesn't work with esp32sx map file yet
* add note for linkermap target
This commit is contained in:
Ha Thach
2021-10-13 00:57:45 +07:00
committed by GitHub
parent 2ba690d31d
commit b26cc2cc46
8 changed files with 104 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files

15
docs/reference/getting_started.rst
View File

@@ -89,6 +89,15 @@ A MCU can support multiple operational speed. By default, the example build syst
$ make BOARD=stm32f746disco SPEED=full all
Size Analysis
~~~~~~~~~~~~~
First install `linkermap tool <https://github.com/hathach/linkermap>`_ then ``linkermap`` target can be used to analyze code size. You may want to compile with ``NO_LTO=1`` since -flto merges code across .o files and make it difficult to analyze.
.. code-block::
$ make BOARD=feather_nrf52840_express NO_LTO=1 all linkermap
Debug
^^^^^
@@ -153,7 +162,7 @@ Some board use uf2 bootloader for drag & drop in to mass storage device, uf2 can
$ make BOARD=feather_nrf52840_express all uf2
IAR Support
-----------
^^^^^^^^^^^
IAR Project Connection files are provided to import TinyUSB stack into your project.
@@ -171,12 +180,12 @@ IAR Project Connection files are provided to import TinyUSB stack into your proj
for example `C:\\tinyusb`
Import stack only
^^^^^^^^^^^^^^^^^
~~~~~~~~~~~~~~~~~
1. Open `Project -> Add project Connection ...`, click `OK`, choose `tinyusb\\tools\\iar_template.ipcf`.
Run examples
^^^^^^^^^^^^
~~~~~~~~~~~~
1. (Python3 is needed) Run `iar_gen.py` to generate .ipcf files of examples: