README.txt
1Title: kernel Object Performance
2
3Description:
4
5The SysKernel test measures the performance of semaphore,
6lifo, fifo, stack and memslab objects.
7
8--------------------------------------------------------------------------------
9
10Building and Running Project:
11
12This project outputs to the console. It can be built and executed
13on QEMU as follows:
14
15 make run
16
17--------------------------------------------------------------------------------
18
19Troubleshooting:
20
21Problems caused by out-dated project information can be addressed by
22issuing one of the following commands then rebuilding the project:
23
24 make clean # discard results of previous builds
25 # but keep existing configuration info
26or
27 make pristine # discard results of previous builds
28 # and restore pre-defined configuration info
29
30--------------------------------------------------------------------------------
31
32Sample Output:
33
34MODULE: kernel API test
35KERNEL VERSION: 0x1066300
36
37Each test below is repeated 5000 times;
38average time for one iteration is displayed.
39
40TEST CASE: Semaphore #1
41TEST COVERAGE:
42 k_sem_init
43 k_sem_take(K_FOREVER)
44 k_sem_give
45Starting test. Please wait...
46TEST RESULT: SUCCESSFUL
47DETAILS: Average time for 1 iteration: NNNN nSec
48END TEST CASE
49
50TEST CASE: Semaphore #2
51TEST COVERAGE:
52 k_sem_init
53 k_sem_take(TICKS_NONE)
54 k_yield
55 k_sem_give
56Starting test. Please wait...
57TEST RESULT: SUCCESSFUL
58DETAILS: Average time for 1 iteration: NNNN nSec
59END TEST CASE
60
61TEST CASE: Semaphore #3
62TEST COVERAGE:
63 k_sem_init
64 k_sem_take(K_FOREVER)
65 k_sem_give
66 k_sem_give
67 k_sem_take(K_FOREVER)
68Starting test. Please wait...
69TEST RESULT: SUCCESSFUL
70DETAILS: Average time for 1 iteration: NNNN nSec
71END TEST CASE
72
73TEST CASE: LIFO #1
74TEST COVERAGE:
75 k_lifo_init
76 k_lifo_get(K_FOREVER)
77 k_lifo_put
78Starting test. Please wait...
79TEST RESULT: SUCCESSFUL
80DETAILS: Average time for 1 iteration: NNNN nSec
81END TEST CASE
82
83TEST CASE: LIFO #2
84TEST COVERAGE:
85 k_lifo_init
86 k_lifo_get(K_FOREVER)
87 k_lifo_get(TICKS_NONE)
88 k_lifo_put
89 k_yield
90Starting test. Please wait...
91TEST RESULT: SUCCESSFUL
92DETAILS: Average time for 1 iteration: NNNN nSec
93END TEST CASE
94
95TEST CASE: LIFO #3
96TEST COVERAGE:
97 k_lifo_init
98 k_lifo_get(K_FOREVER)
99 k_lifo_put
100 k_lifo_get(K_FOREVER)
101 k_lifo_put
102Starting test. Please wait...
103TEST RESULT: SUCCESSFUL
104DETAILS: Average time for 1 iteration: NNNN nSec
105END TEST CASE
106
107TEST CASE: FIFO #1
108TEST COVERAGE:
109 k_fifo_init
110 k_fifo_get(K_FOREVER)
111 k_fifo_put
112Starting test. Please wait...
113TEST RESULT: SUCCESSFUL
114DETAILS: Average time for 1 iteration: NNNN nSec
115END TEST CASE
116
117TEST CASE: FIFO #2
118TEST COVERAGE:
119 k_fifo_init
120 k_fifo_get(K_FOREVER)
121 k_fifo_get(TICKS_NONE)
122 k_fifo_put
123 k_yield
124Starting test. Please wait...
125TEST RESULT: SUCCESSFUL
126DETAILS: Average time for 1 iteration: NNNN nSec
127END TEST CASE
128
129TEST CASE: FIFO #3
130TEST COVERAGE:
131 k_fifo_init
132 k_fifo_get(K_FOREVER)
133 k_fifo_put
134 k_fifo_get(K_FOREVER)
135 k_fifo_put
136Starting test. Please wait...
137TEST RESULT: SUCCESSFUL
138DETAILS: Average time for 1 iteration: NNNN nSec
139END TEST CASE
140
141TEST CASE: Stack #1
142TEST COVERAGE:
143 k_stack_init
144 k_stack_pop(K_FOREVER)
145 k_stack_push
146Starting test. Please wait...
147TEST RESULT: SUCCESSFUL
148DETAILS: Average time for 1 iteration: NNNN nSec
149END TEST CASE
150
151TEST CASE: Stack #2
152TEST COVERAGE:
153 k_stack_init
154 k_stack_pop(K_FOREVER)
155 k_stack_pop
156 k_stack_push
157 k_yield
158Starting test. Please wait...
159TEST RESULT: SUCCESSFUL
160DETAILS: Average time for 1 iteration: NNNN nSec
161END TEST CASE
162
163TEST CASE: Stack #3
164TEST COVERAGE:
165 k_stack_init
166 k_stack_pop(K_FOREVER)
167 k_stack_push
168 k_stack_pop(K_FOREVER)
169 k_stack_push
170Starting test. Please wait...
171TEST RESULT: SUCCESSFUL
172DETAILS: Average time for 1 iteration: NNNN nSec
173END TEST CASE
174
175TEST CASE: Memslab #1
176TEST COVERAGE:
177 k_mem_slab_alloc
178Starting test. Please wait...
179TEST RESULT: SUCCESSFUL
180DETAILS: Average time for 1 iteration: NNNN nSec
181END TEST CASE
182
183TEST CASE: Memslab #2
184TEST COVERAGE:
185 k_mem_slab_free
186Starting test. Please wait...
187TEST RESULT: SUCCESSFUL
188DETAILS: Average time for 1 iteration: NNNN nSec
189END TEST CASE
190
191PROJECT EXECUTION SUCCESSFUL
192QEMU: Terminated
193
