From 21e8827872a940bf5f3c81e437a1c12461b61ea6 Mon Sep 17 00:00:00 2001 From: arighi Date: Thu, 27 May 2010 15:19:46 +0000 Subject: [PATCH] Better wording in benchmarks' description. git-svn-id: https://src.develer.com/svnoss/bertos/trunk@3862 38d2e660-2303-0410-9eaa-f027e97ec537 --- .../arduino/benchmark/context_switch/main.c | 13 +++-- .../arduino/benchmark/kernel_footprint/main.c | 11 ++-- .../benchmark/context_switch/main.c | 13 +++-- .../benchmark/kernel_footprint/main.c | 11 ++-- .../benchmark/context_switch/main.c | 13 +++-- .../benchmark/kernel_footprint/main.c | 11 ++-- .../benchmark/context_switch/main.c | 13 +++-- .../benchmark/kernel_footprint/main.c | 11 ++-- .../lpc-p2378/benchmark/context_switch/main.c | 13 +++-- .../benchmark/kernel_footprint/main.c | 11 ++-- .../benchmark/context_switch/main.c | 45 ++++++++++++++- .../benchmark/kernel_footprint/main.c | 56 +++++++++++++++---- .../triface/benchmark/context_switch/main.c | 15 +++-- .../triface/benchmark/kernel_footprint/main.c | 11 ++-- 14 files changed, 174 insertions(+), 73 deletions(-) diff --git a/boards/arduino/benchmark/context_switch/main.c b/boards/arduino/benchmark/context_switch/main.c index 30206a69..ef29fb02 100644 --- a/boards/arduino/benchmark/context_switch/main.c +++ b/boards/arduino/benchmark/context_switch/main.c @@ -32,13 +32,14 @@ * * \author Daniele Basile * - * \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 diff --git a/boards/arduino/benchmark/kernel_footprint/main.c b/boards/arduino/benchmark/kernel_footprint/main.c index 9c11e028..a3f11e50 100644 --- a/boards/arduino/benchmark/kernel_footprint/main.c +++ b/boards/arduino/benchmark/kernel_footprint/main.c @@ -34,10 +34,13 @@ * * \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 diff --git a/boards/at91sam7s-ek/benchmark/context_switch/main.c b/boards/at91sam7s-ek/benchmark/context_switch/main.c index 30206a69..ef29fb02 100644 --- a/boards/at91sam7s-ek/benchmark/context_switch/main.c +++ b/boards/at91sam7s-ek/benchmark/context_switch/main.c @@ -32,13 +32,14 @@ * * \author Daniele Basile * - * \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 diff --git a/boards/at91sam7s-ek/benchmark/kernel_footprint/main.c b/boards/at91sam7s-ek/benchmark/kernel_footprint/main.c index 9c11e028..a3f11e50 100644 --- a/boards/at91sam7s-ek/benchmark/kernel_footprint/main.c +++ b/boards/at91sam7s-ek/benchmark/kernel_footprint/main.c @@ -34,10 +34,13 @@ * * \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 diff --git a/boards/at91sam7x-ek/benchmark/context_switch/main.c b/boards/at91sam7x-ek/benchmark/context_switch/main.c index 30206a69..ef29fb02 100644 --- a/boards/at91sam7x-ek/benchmark/context_switch/main.c +++ b/boards/at91sam7x-ek/benchmark/context_switch/main.c @@ -32,13 +32,14 @@ * * \author Daniele Basile * - * \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 diff --git a/boards/at91sam7x-ek/benchmark/kernel_footprint/main.c b/boards/at91sam7x-ek/benchmark/kernel_footprint/main.c index 9c11e028..a3f11e50 100644 --- a/boards/at91sam7x-ek/benchmark/kernel_footprint/main.c +++ b/boards/at91sam7x-ek/benchmark/kernel_footprint/main.c @@ -34,10 +34,13 @@ * * \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 diff --git a/boards/ek-lm3s1968/benchmark/context_switch/main.c b/boards/ek-lm3s1968/benchmark/context_switch/main.c index 30206a69..ef29fb02 100644 --- a/boards/ek-lm3s1968/benchmark/context_switch/main.c +++ b/boards/ek-lm3s1968/benchmark/context_switch/main.c @@ -32,13 +32,14 @@ * * \author Daniele Basile * - * \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 diff --git a/boards/ek-lm3s1968/benchmark/kernel_footprint/main.c b/boards/ek-lm3s1968/benchmark/kernel_footprint/main.c index 9c11e028..a3f11e50 100644 --- a/boards/ek-lm3s1968/benchmark/kernel_footprint/main.c +++ b/boards/ek-lm3s1968/benchmark/kernel_footprint/main.c @@ -34,10 +34,13 @@ * * \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 diff --git a/boards/lpc-p2378/benchmark/context_switch/main.c b/boards/lpc-p2378/benchmark/context_switch/main.c index 30206a69..ef29fb02 100644 --- a/boards/lpc-p2378/benchmark/context_switch/main.c +++ b/boards/lpc-p2378/benchmark/context_switch/main.c @@ -32,13 +32,14 @@ * * \author Daniele Basile * - * \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 diff --git a/boards/lpc-p2378/benchmark/kernel_footprint/main.c b/boards/lpc-p2378/benchmark/kernel_footprint/main.c index 9c11e028..a3f11e50 100644 --- a/boards/lpc-p2378/benchmark/kernel_footprint/main.c +++ b/boards/lpc-p2378/benchmark/kernel_footprint/main.c @@ -34,10 +34,13 @@ * * \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 diff --git a/boards/stm32-p103/benchmark/context_switch/main.c b/boards/stm32-p103/benchmark/context_switch/main.c index 54652f17..f190567f 100644 --- a/boards/stm32-p103/benchmark/context_switch/main.c +++ b/boards/stm32-p103/benchmark/context_switch/main.c @@ -1,4 +1,47 @@ -// Emtpy main.c file generated by the wizard +/** + * \file + * + * + * \author Daniele Basile + * + * \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 int main(void) diff --git a/boards/stm32-p103/benchmark/kernel_footprint/main.c b/boards/stm32-p103/benchmark/kernel_footprint/main.c index 7ecafb86..78920ff5 100644 --- a/boards/stm32-p103/benchmark/kernel_footprint/main.c +++ b/boards/stm32-p103/benchmark/kernel_footprint/main.c @@ -1,20 +1,56 @@ -// Emtpy main.c file generated by the wizard -#include +/** + * \file + * + * + * \author Daniele Basile + * + * \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 int main(void) { - init(); + kernel_footprint(); while (1) { - // your code goes here } return 0; } - diff --git a/boards/triface/benchmark/context_switch/main.c b/boards/triface/benchmark/context_switch/main.c index 0c2a5cf3..f190567f 100644 --- a/boards/triface/benchmark/context_switch/main.c +++ b/boards/triface/benchmark/context_switch/main.c @@ -1,4 +1,3 @@ - /** * \file *