Better wording in benchmarks' description.
authorarighi <arighi@38d2e660-2303-0410-9eaa-f027e97ec537>
Thu, 27 May 2010 15:19:46 +0000 (15:19 +0000)
committerarighi <arighi@38d2e660-2303-0410-9eaa-f027e97ec537>
Thu, 27 May 2010 15:19:46 +0000 (15:19 +0000)
git-svn-id: https://src.develer.com/svnoss/bertos/trunk@3862 38d2e660-2303-0410-9eaa-f027e97ec537

14 files changed:
boards/arduino/benchmark/context_switch/main.c
boards/arduino/benchmark/kernel_footprint/main.c
boards/at91sam7s-ek/benchmark/context_switch/main.c
boards/at91sam7s-ek/benchmark/kernel_footprint/main.c
boards/at91sam7x-ek/benchmark/context_switch/main.c
boards/at91sam7x-ek/benchmark/kernel_footprint/main.c
boards/ek-lm3s1968/benchmark/context_switch/main.c
boards/ek-lm3s1968/benchmark/kernel_footprint/main.c
boards/lpc-p2378/benchmark/context_switch/main.c
boards/lpc-p2378/benchmark/kernel_footprint/main.c
boards/stm32-p103/benchmark/context_switch/main.c
boards/stm32-p103/benchmark/kernel_footprint/main.c
boards/triface/benchmark/context_switch/main.c
boards/triface/benchmark/kernel_footprint/main.c

index 30206a69d3eb47f9fd389258d8330d67e58452a5..ef29fb02cd9ff69125d0c93329b9f21f17ce7dcc 100644 (file)
  *
  * \author Daniele Basile <asterix@develer.com>
  *
- * \brief Kernel switch context benchmark.
+ * \brief Kernel context switch benchmark.
  *
- * This benchmark show you the switch context time. This measure is make
- * by hp timer that measure accurately the kernel switch context time, and print
- * it on serial debug. If you want not use the hp timer you can measure this
- * time using one oscilloscope, connected to one board led. To use this
- * mode you should disable hp timer and implement hw_led.h low level module.
+ * This benchmark measures the overhead (in µs) required to deliver a
+ * signal and switch from a low-priority process to a high-priority process.
+ *
+ * The measure is made by the high-precision timer if supported by the
+ * architecture. Alternatively, the time can also be measured using an external
+ * oscilloscope connected to the board's status LED.
  */
 
 #include <benchmark/context_switch.h>
index 9c11e0287102b66dc4ab50dddb4c681c2b9cdb0b..a3f11e50502a16a0f91b6012420917514a619e0f 100644 (file)
  *
  * \brief Kernel footprint benchmark.
  *
- * This benchmark show you how much flash space could use the BeRTOS kernel application.
- * Try to compile it and verify how few space the kernel needs to run.
- * By default this benchmark have all kernel switch enabled, and the context switch is preemptive
- * mode, try to modify the kernel setting throught the cfg file.
+ * This benchmark measures the memory footprint[1] of the BeRTOS kernel with a
+ * simple minimalist user application.
+ *
+ * The purpose of this test is to give a measure of the required space in a
+ * generic flash memory to store a full-featured BeRTOS kernel.
+ *
+ * [1] http://en.wikipedia.org/wiki/Memory_footprint
  */
 
 #include <benchmark/kernel_footprint.h>
index 30206a69d3eb47f9fd389258d8330d67e58452a5..ef29fb02cd9ff69125d0c93329b9f21f17ce7dcc 100644 (file)
  *
  * \author Daniele Basile <asterix@develer.com>
  *
- * \brief Kernel switch context benchmark.
+ * \brief Kernel context switch benchmark.
  *
- * This benchmark show you the switch context time. This measure is make
- * by hp timer that measure accurately the kernel switch context time, and print
- * it on serial debug. If you want not use the hp timer you can measure this
- * time using one oscilloscope, connected to one board led. To use this
- * mode you should disable hp timer and implement hw_led.h low level module.
+ * This benchmark measures the overhead (in µs) required to deliver a
+ * signal and switch from a low-priority process to a high-priority process.
+ *
+ * The measure is made by the high-precision timer if supported by the
+ * architecture. Alternatively, the time can also be measured using an external
+ * oscilloscope connected to the board's status LED.
  */
 
 #include <benchmark/context_switch.h>
index 9c11e0287102b66dc4ab50dddb4c681c2b9cdb0b..a3f11e50502a16a0f91b6012420917514a619e0f 100644 (file)
  *
  * \brief Kernel footprint benchmark.
  *
- * This benchmark show you how much flash space could use the BeRTOS kernel application.
- * Try to compile it and verify how few space the kernel needs to run.
- * By default this benchmark have all kernel switch enabled, and the context switch is preemptive
- * mode, try to modify the kernel setting throught the cfg file.
+ * This benchmark measures the memory footprint[1] of the BeRTOS kernel with a
+ * simple minimalist user application.
+ *
+ * The purpose of this test is to give a measure of the required space in a
+ * generic flash memory to store a full-featured BeRTOS kernel.
+ *
+ * [1] http://en.wikipedia.org/wiki/Memory_footprint
  */
 
 #include <benchmark/kernel_footprint.h>
index 30206a69d3eb47f9fd389258d8330d67e58452a5..ef29fb02cd9ff69125d0c93329b9f21f17ce7dcc 100644 (file)
  *
  * \author Daniele Basile <asterix@develer.com>
  *
- * \brief Kernel switch context benchmark.
+ * \brief Kernel context switch benchmark.
  *
- * This benchmark show you the switch context time. This measure is make
- * by hp timer that measure accurately the kernel switch context time, and print
- * it on serial debug. If you want not use the hp timer you can measure this
- * time using one oscilloscope, connected to one board led. To use this
- * mode you should disable hp timer and implement hw_led.h low level module.
+ * This benchmark measures the overhead (in µs) required to deliver a
+ * signal and switch from a low-priority process to a high-priority process.
+ *
+ * The measure is made by the high-precision timer if supported by the
+ * architecture. Alternatively, the time can also be measured using an external
+ * oscilloscope connected to the board's status LED.
  */
 
 #include <benchmark/context_switch.h>
index 9c11e0287102b66dc4ab50dddb4c681c2b9cdb0b..a3f11e50502a16a0f91b6012420917514a619e0f 100644 (file)
  *
  * \brief Kernel footprint benchmark.
  *
- * This benchmark show you how much flash space could use the BeRTOS kernel application.
- * Try to compile it and verify how few space the kernel needs to run.
- * By default this benchmark have all kernel switch enabled, and the context switch is preemptive
- * mode, try to modify the kernel setting throught the cfg file.
+ * This benchmark measures the memory footprint[1] of the BeRTOS kernel with a
+ * simple minimalist user application.
+ *
+ * The purpose of this test is to give a measure of the required space in a
+ * generic flash memory to store a full-featured BeRTOS kernel.
+ *
+ * [1] http://en.wikipedia.org/wiki/Memory_footprint
  */
 
 #include <benchmark/kernel_footprint.h>
index 30206a69d3eb47f9fd389258d8330d67e58452a5..ef29fb02cd9ff69125d0c93329b9f21f17ce7dcc 100644 (file)
  *
  * \author Daniele Basile <asterix@develer.com>
  *
- * \brief Kernel switch context benchmark.
+ * \brief Kernel context switch benchmark.
  *
- * This benchmark show you the switch context time. This measure is make
- * by hp timer that measure accurately the kernel switch context time, and print
- * it on serial debug. If you want not use the hp timer you can measure this
- * time using one oscilloscope, connected to one board led. To use this
- * mode you should disable hp timer and implement hw_led.h low level module.
+ * This benchmark measures the overhead (in µs) required to deliver a
+ * signal and switch from a low-priority process to a high-priority process.
+ *
+ * The measure is made by the high-precision timer if supported by the
+ * architecture. Alternatively, the time can also be measured using an external
+ * oscilloscope connected to the board's status LED.
  */
 
 #include <benchmark/context_switch.h>
index 9c11e0287102b66dc4ab50dddb4c681c2b9cdb0b..a3f11e50502a16a0f91b6012420917514a619e0f 100644 (file)
  *
  * \brief Kernel footprint benchmark.
  *
- * This benchmark show you how much flash space could use the BeRTOS kernel application.
- * Try to compile it and verify how few space the kernel needs to run.
- * By default this benchmark have all kernel switch enabled, and the context switch is preemptive
- * mode, try to modify the kernel setting throught the cfg file.
+ * This benchmark measures the memory footprint[1] of the BeRTOS kernel with a
+ * simple minimalist user application.
+ *
+ * The purpose of this test is to give a measure of the required space in a
+ * generic flash memory to store a full-featured BeRTOS kernel.
+ *
+ * [1] http://en.wikipedia.org/wiki/Memory_footprint
  */
 
 #include <benchmark/kernel_footprint.h>
index 30206a69d3eb47f9fd389258d8330d67e58452a5..ef29fb02cd9ff69125d0c93329b9f21f17ce7dcc 100644 (file)
  *
  * \author Daniele Basile <asterix@develer.com>
  *
- * \brief Kernel switch context benchmark.
+ * \brief Kernel context switch benchmark.
  *
- * This benchmark show you the switch context time. This measure is make
- * by hp timer that measure accurately the kernel switch context time, and print
- * it on serial debug. If you want not use the hp timer you can measure this
- * time using one oscilloscope, connected to one board led. To use this
- * mode you should disable hp timer and implement hw_led.h low level module.
+ * This benchmark measures the overhead (in µs) required to deliver a
+ * signal and switch from a low-priority process to a high-priority process.
+ *
+ * The measure is made by the high-precision timer if supported by the
+ * architecture. Alternatively, the time can also be measured using an external
+ * oscilloscope connected to the board's status LED.
  */
 
 #include <benchmark/context_switch.h>
index 9c11e0287102b66dc4ab50dddb4c681c2b9cdb0b..a3f11e50502a16a0f91b6012420917514a619e0f 100644 (file)
  *
  * \brief Kernel footprint benchmark.
  *
- * This benchmark show you how much flash space could use the BeRTOS kernel application.
- * Try to compile it and verify how few space the kernel needs to run.
- * By default this benchmark have all kernel switch enabled, and the context switch is preemptive
- * mode, try to modify the kernel setting throught the cfg file.
+ * This benchmark measures the memory footprint[1] of the BeRTOS kernel with a
+ * simple minimalist user application.
+ *
+ * The purpose of this test is to give a measure of the required space in a
+ * generic flash memory to store a full-featured BeRTOS kernel.
+ *
+ * [1] http://en.wikipedia.org/wiki/Memory_footprint
  */
 
 #include <benchmark/kernel_footprint.h>
index 54652f1788f732dbf6d0b2ff73053466e56e4934..f190567f9cbad326434c2da3beab0876dc73460b 100644 (file)
@@ -1,4 +1,47 @@
-// Emtpy main.c file generated by the wizard
+/**
+ * \file
+ * <!--
+ * This file is part of BeRTOS.
+ *
+ * Bertos is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+ *
+ * As a special exception, you may use this file as part of a free software
+ * library without restriction.  Specifically, if other files instantiate
+ * templates or use macros or inline functions from this file, or you compile
+ * this file and link it with other files to produce an executable, this
+ * file does not by itself cause the resulting executable to be covered by
+ * the GNU General Public License.  This exception does not however
+ * invalidate any other reasons why the executable file might be covered by
+ * the GNU General Public License.
+ *
+ * Copyright 2010 Develer S.r.l. (http://www.develer.com/)
+ *
+ * -->
+ *
+ * \author Daniele Basile <asterix@develer.com>
+ *
+ * \brief Kernel context switch benchmark.
+ *
+ * This benchmark measures the overhead (in µs) required to deliver a
+ * signal and switch from a low-priority process to a high-priority process.
+ *
+ * The measure is made by the high-precision timer if supported by the
+ * architecture. Alternatively, the time can also be measured using an external
+ * oscilloscope connected to the board's status LED.
+ */
+
 #include <benchmark/context_switch.h>
 
 int main(void)
index 7ecafb863d7eac8259d22ea2e9ded962151e61c0..78920ff58dd88e3b0d966460a4ff5e529256e57b 100644 (file)
@@ -1,20 +1,56 @@
-// Emtpy main.c file generated by the wizard
-#include <cpu/irq.h>
+/**
+ * \file
+ * <!--
+ * This file is part of BeRTOS.
+ *
+ * Bertos is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+ *
+ * As a special exception, you may use this file as part of a free software
+ * library without restriction.  Specifically, if other files instantiate
+ * templates or use macros or inline functions from this file, or you compile
+ * this file and link it with other files to produce an executable, this
+ * file does not by itself cause the resulting executable to be covered by
+ * the GNU General Public License.  This exception does not however
+ * invalidate any other reasons why the executable file might be covered by
+ * the GNU General Public License.
+ *
+ * Copyright 2010 Develer S.r.l. (http://www.develer.com/)
+ *
+ * -->
+ *
+ * \author Daniele Basile <asterix@develer.com>
+ *
+ * \brief Kernel footprint benchmark.
+ *
+ * This benchmark measures the memory footprint[1] of the BeRTOS kernel with a
+ * simple minimalist user application.
+ *
+ * The purpose of this test is to give a measure of the required space in a
+ * generic flash memory to store a full-featured BeRTOS kernel.
+ *
+ * [1] http://en.wikipedia.org/wiki/Memory_footprint
+ */
 
-static void init(void)
-{
-       IRQ_ENABLE;
-       // insert initialization calls here
-}
+#include <benchmark/kernel_footprint.h>
 
 int main(void)
 {
-       init();
+       kernel_footprint();
        while (1)
        {
-               // your code goes here
        }
 
        return 0;
 }
-
index 0c2a5cf36dc94dbfe6161b93c7b6e78f2aba8ce6..f190567f9cbad326434c2da3beab0876dc73460b 100644 (file)
@@ -1,4 +1,3 @@
-
 /**
  * \file
  * <!--
  *
  * \author Daniele Basile <asterix@develer.com>
  *
- * \brief Kernel switch context benchmark.
+ * \brief Kernel context switch benchmark.
+ *
+ * This benchmark measures the overhead (in µs) required to deliver a
+ * signal and switch from a low-priority process to a high-priority process.
  *
- * This benchmark show you the switch context time. This measure is make
- * by hp timer that measure accurately the kernel switch context time, and print
- * it on serial debug. If you want not use the hp timer you can measure this
- * time using one oscilloscope, connected to one board led. To use this
- * mode you should disable hp timer and implement hw_led.h low level module.
+ * The measure is made by the high-precision timer if supported by the
+ * architecture. Alternatively, the time can also be measured using an external
+ * oscilloscope connected to the board's status LED.
  */
 
 #include <benchmark/context_switch.h>
@@ -53,4 +53,3 @@ int main(void)
 
        return 0;
 }
-
index 9c11e0287102b66dc4ab50dddb4c681c2b9cdb0b..a3f11e50502a16a0f91b6012420917514a619e0f 100644 (file)
  *
  * \brief Kernel footprint benchmark.
  *
- * This benchmark show you how much flash space could use the BeRTOS kernel application.
- * Try to compile it and verify how few space the kernel needs to run.
- * By default this benchmark have all kernel switch enabled, and the context switch is preemptive
- * mode, try to modify the kernel setting throught the cfg file.
+ * This benchmark measures the memory footprint[1] of the BeRTOS kernel with a
+ * simple minimalist user application.
+ *
+ * The purpose of this test is to give a measure of the required space in a
+ * generic flash memory to store a full-featured BeRTOS kernel.
+ *
+ * [1] http://en.wikipedia.org/wiki/Memory_footprint
  */
 
 #include <benchmark/kernel_footprint.h>