zephyr

History

Anas Nashif b207035851 tests: add integration_platforms and misc optimizations Add integration_platforms to many tests that use platform_allow to manage scope of pull_request CI. Signed-off-by: Anas Nashif <anas.nashif@intel.com>		2024-11-26 00:12:07 +01:00
..
src	samples: add no-timers configuration which is runtime tested	2023-08-03 07:32:03 -04:00
arm.conf
CMakeLists.txt
common-runtime.conf	samples/basic/minimal: make it smaller	2023-08-11 19:47:47 +00:00
common.conf
Kconfig	samples: add no-timers configuration which is runtime tested	2023-08-03 07:32:03 -04:00
mt.conf
no-mt.conf
no-preempt.conf
no-timers.conf
prj.conf	samples: minimal: define an empty project configuration	2023-03-28 15:05:01 +02:00
README.rst	samples: fully migrate basic samples to the new Sphinx extension	2023-09-13 09:15:34 +02:00
riscv.conf	samples/basic/minimal: make it smaller	2023-08-11 19:47:47 +00:00
sample.yaml	tests: add integration_platforms and misc optimizations	2024-11-26 00:12:07 +01:00
x86.conf

README.rst

.. 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: