59e4c5aed0
- Updated basic samples READMEs to use the new zephyr:code-sample:: directive. Dropped "-sample" suffix that's not required anymore now that samples have their own namespace. - Updated all references to the samples to use the :zephyr:code-sample: role. Checked and updated the wording of said references to account for the fact that samples should not have "... sample" in their name anymore. Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
91 lines
2.4 KiB
ReStructuredText
91 lines
2.4 KiB
ReStructuredText
.. zephyr:code-sample:: minimal
|
|
:name: Minimal footprint
|
|
|
|
Measure Zephyr's minimal ROM footprint in different configurations.
|
|
|
|
Overview
|
|
********
|
|
|
|
This sample provides an empty ``main()`` and various configuration files that
|
|
can be used to measure Zephyr's minimal ROM footprint in different
|
|
configurations.
|
|
|
|
The following configuration files are available:
|
|
|
|
* :file:`mt.conf`: Enable multithreading
|
|
* :file:`no-mt.conf`: Disable multithreading
|
|
* :file:`no-preempt.conf`: Disable preemption
|
|
* :file:`no-timers.conf`: Disable timers
|
|
* :file:`arm.conf`: Arm-specific disabling of features
|
|
|
|
Building and measuring ROM size
|
|
*******************************
|
|
|
|
The following combinations are suggested for comparing ROM sizes in different
|
|
configurations. They all target the :ref:`reel_board` (Arm Aarch32 architecture).
|
|
|
|
* Multithreading enabled
|
|
|
|
* Reference ROM size: 7-8KB
|
|
|
|
.. zephyr-app-commands::
|
|
:zephyr-app: samples/basic/minimal
|
|
:host-os: unix
|
|
:board: reel_board
|
|
:build-dir: reel_board/mt/
|
|
:conf: "common.conf mt.conf arm.conf"
|
|
:goals: rom_report
|
|
:compact:
|
|
|
|
* Multithreading enabled, no preemption
|
|
|
|
* Reference ROM size: 7-8KB
|
|
|
|
.. zephyr-app-commands::
|
|
:zephyr-app: samples/basic/minimal
|
|
:host-os: unix
|
|
:board: reel_board
|
|
:build-dir: reel_board/mt-no-preempt/
|
|
:conf: "common.conf mt.conf no-preempt.conf arm.conf"
|
|
:goals: rom_report
|
|
:compact:
|
|
|
|
* Multithreading enabled, no preemption, timers disabled
|
|
|
|
* Reference ROM size: 3-4KB
|
|
|
|
.. zephyr-app-commands::
|
|
:zephyr-app: samples/basic/minimal
|
|
:host-os: unix
|
|
:board: reel_board
|
|
:build-dir: reel_board/mt-no-preempt-no-timers/
|
|
:conf: "common.conf mt.conf no-preempt.conf no-timers.conf arm.conf"
|
|
:goals: rom_report
|
|
:compact:
|
|
|
|
* Multithreading disabled, timers enabled
|
|
|
|
* Reference ROM size: 4-5KB
|
|
|
|
.. zephyr-app-commands::
|
|
:zephyr-app: samples/basic/minimal
|
|
:host-os: unix
|
|
:board: reel_board
|
|
:build-dir: reel_board/no-mt/
|
|
:conf: "common.conf no-mt.conf arm.conf"
|
|
:goals: rom_report
|
|
:compact:
|
|
|
|
* Multithreading disabled, timers disabled
|
|
|
|
* Reference ROM size: 2-3KB
|
|
|
|
.. zephyr-app-commands::
|
|
:zephyr-app: samples/basic/minimal
|
|
:host-os: unix
|
|
:board: reel_board
|
|
:build-dir: reel_board/no-mt-no-timers/
|
|
:conf: "common.conf no-mt.conf no-timers.conf arm.conf"
|
|
:goals: rom_report
|
|
:compact:
|