Application
Overview
In HummingBird SDK, we just provided applications which can run in different boards without any changes in code to demostrate the baremetal service, freertos service and ucosii service features.
The provided applications can be divided into three categories:
Bare-metal applications: Located in
application/baremetalFreeRTOS applications: Located in
application/freertosUCOSII applications: Located in
application/ucosii
If you want to develop your own application in HummingBird SDK, please click Application Development to learn more about it.
The following applications are running using HummingBird board.
Bare-metal applications
helloworld
This helloworld application is used to print hello world, and also will check this RISC-V CSR MISA register value.
How to run this application:
# Assume that you can set up the Tools and HummingBird SDK environment
# cd to the helloworld directory
cd application/baremetal/helloworld
# Clean the application first
make SOC=hbird BOARD=hbird_eval CORE=e203 clean
# Build and upload the application
make SOC=hbird BOARD=hbird_eval CORE=e203 upload
Expected output as below:
HummingBird SDK Build Time: Jul 16 2020, 11:18:08
Download Mode: ILM
CPU Frequency 15999631 Hz
MISA: 0x40001105
MISA: RV32IMAC
0: Hello World From RISC-V Processor!
1: Hello World From RISC-V Processor!
2: Hello World From RISC-V Processor!
3: Hello World From RISC-V Processor!
4: Hello World From RISC-V Processor!
5: Hello World From RISC-V Processor!
6: Hello World From RISC-V Processor!
7: Hello World From RISC-V Processor!
8: Hello World From RISC-V Processor!
9: Hello World From RISC-V Processor!
10: Hello World From RISC-V Processor!
11: Hello World From RISC-V Processor!
12: Hello World From RISC-V Processor!
13: Hello World From RISC-V Processor!
14: Hello World From RISC-V Processor!
15: Hello World From RISC-V Processor!
16: Hello World From RISC-V Processor!
17: Hello World From RISC-V Processor!
18: Hello World From RISC-V Processor!
19: Hello World From RISC-V Processor!
demo_timer
This demo_timer application is used to demostrate how to use the CORE TIMER API including the Timer Interrupt and Timer Software Interrupt.
Both interrupts are registered as interrupt.
First the timer interrupt will run for 10 times
Then the software timer interrupt will start to run for 10 times
How to run this application:
# Assume that you can set up the Tools and HummingBird SDK environment
# cd to the demo_timer directory
cd application/baremetal/demo_timer
# Clean the application first
make SOC=hbird BOARD=hbird_eval CORE=e203 clean
# Build and upload the application
make SOC=hbird BOARD=hbird_eval CORE=e203 upload
Expected output as below:
HummingBird SDK Build Time: Jul 16 2020, 11:43:13
Download Mode: ILM
CPU Frequency 16006512 Hz
MTimer IRQ handler 1
init timer and start
MTimer IRQ handler 2
MTimer IRQ handler 3
MTimer IRQ handler 4
MTimer IRQ handler 5
MTimer IRQ handler 6
MTimer IRQ handler 7
MTimer IRQ handler 8
MTimer IRQ handler 9
MTimer IRQ handler 10
MTimer SW IRQ handler 1
MTimer SW IRQ handler 2
MTimer SW IRQ handler 3
MTimer SW IRQ handler 4
MTimer SW IRQ handler 5
MTimer SW IRQ handler 6
MTimer SW IRQ handler 7
MTimer SW IRQ handler 8
MTimer SW IRQ handler 9
MTimer SW IRQ handler 10
MTimer msip and mtip interrupt test finish and pass
demo_plic
This demo_plic application is used to demostrate how to use the PLIC API and Interrupt.
Note
In this application’s Makefile, we provided comments in Makefile about optimize for code size.
If you want to optimize this application for code size, you can set the COMMON_FLAGS
variable to the following values, we recommend to use -Os -flto.
COMMON_FLAGS |
text(bytes) |
data(bytes) |
bss(bytes) |
total(bytes) |
|---|---|---|---|---|
9608 |
112 |
2500 |
12220 |
|
-flto |
9552 |
112 |
2500 |
12164 |
-Os |
7316 |
112 |
2500 |
9928 |
-Os -flto |
6942 |
112 |
2500 |
9554 |
-Os -msave-restore -fno-unroll-loops |
7360 |
112 |
2500 |
9972 |
-Os -msave-restore -fno-unroll-loops -flto |
7008 |
112 |
2500 |
9620 |
This is an example of triggering an external interrupt
Two GPIO rising edge interrupts are used
When the button 1 and button 2 are pressed respectively the program triggers the external rising edge interrupt and the interrupt processing function will show which button triggered the interrupt on the serial port
How to run this application:
# Assume that you can set up the Tools and HummingBird SDK environment
# cd to the demo_plic directory
cd application/baremetal/demo_plic
# Clean the application first
make SOC=hbird BOARD=hbird_eval CORE=e203 clean
# Build and upload the application
make SOC=hbird BOARD=hbird_eval CORE=e203 upload
# Press button1 and button2, see uart output
Expected output as below:
HummingBird SDK Build Time: Jul 16 2020, 16:37:14
Download Mode: ILM
CPU Frequency 15999303 Hz
Enter Button 1 interrupt
Enter Button 1 interrupt
Enter Button 2 interrupt
Enter Button 2 interrupt
demo_dsp
This demo_dsp application is used to demostrate how to NMSIS-DSP API.
Mainly show how we can use DSP library without dsp instructions and header files.
It mainly demo the
riscv_conv_xxfunctions and its reference functions
Note
For other HummingBird Processor Core based SoC, please check whether it has DSP feature enabled to decide which kind of NMSIS-DSP library to use.
Even our NMSIS-DSP library with DSP disabled are also optimized, so it can also provide good performance in some functions.
How to run this application:
# Assume that you can set up the Tools and HummingBird SDK environment
# cd to the demo_dsp directory
cd application/baremetal/demo_dsp
# Clean the application first
make SOC=hbird BOARD=hbird_eval CORE=e203 DSP_ENABLE=OFF clean
# Build and upload the application
make SOC=hbird BOARD=hbird_eval CORE=e203 DSP_ENABLE=OFF upload
Expected output as below:
HummingBird SDK Build Time: Jul 16 2020, 15:55:06
Download Mode: ILM
CPU Frequency 16006512 Hz
CSV, riscv_conv_q31, 4103925
CSV, ref_conv_q31, 12979250
SUCCESS, riscv_conv_q31
CSV, riscv_conv_q15, 437418
CSV, ref_conv_q15, 882230
SUCCESS, riscv_conv_q15
CSV, riscv_conv_q7, 839
CSV, ref_conv_q7, 2382
SUCCESS, riscv_conv_q7
CSV, riscv_conv_fast_q15, 357503
CSV, ref_conv_fast_q15, 774856
SUCCESS, riscv_conv_fast_q15
CSV, riscv_conv_fast_q31, 1918358
CSV, ref_conv_fast_q31, 13692367
SUCCESS, riscv_conv_fast_q31
CSV, riscv_conv_opt_q15, 524310
CSV, ref_conv_opt_q15, 882232
SUCCESS, riscv_conv_opt_q15
CSV, riscv_conv_opt_q7, 1535
CSV, ref_conv_opt_q7, 2382
SUCCESS, riscv_conv_opt_q7
CSV, riscv_conv_fast_opt_q15, 454263
CSV, ref_conv_fast_opt_q15, 789929
SUCCESS, riscv_conv_fast_opt_q15
all test are passed. Well done!
coremark
This coremark benchmark application is used to run EEMBC CoreMark Software.
EEMBC CoreMark Software is a product of EEMBC and is provided under the terms of the CoreMark License that is distributed with the official EEMBC COREMARK Software release. If you received this EEMBC CoreMark Software without the accompanying CoreMark License, you must discontinue use and download the official release from www.coremark.org.
In HummingBird SDK, we provided code and Makefile for this coremark application.
You can also optimize the COMMON_FLAGS defined in coremark application Makefile
to get different score number.
By default, this application runs for 500 iterations, you can also change this in Makefile. e.g. Change this
-DITERATIONS=500to value such as-DITERATIONS=5000macro PERFORMANCE_RUN=1 is defined
PFLOAT = 1 is added in its Makefile to enable float value print
Note
Since for each SoC platforms, the CPU frequency is different, so user need to change the
ITERATIONSdefined in Makefile to proper value to let the coremark run at least 10 secondsFor example, for the
HummingBirdbased boards supported in HummingBird SDK, we suggest to change-DITERATIONS=500to-DITERATIONS=5000
How to run this application:
# Assume that you can set up the Tools and HummingBird SDK environment
# cd to the coremark directory
cd application/baremetal/benchmark/coremark
# Clean the application first
make SOC=hbird BOARD=hbird_eval CORE=e203 clean
# Build and upload the application
make SOC=hbird BOARD=hbird_eval CORE=e203 upload
Expected output as below:
HummingBird SDK Build Time: Jul 16 2020, 16:01:58
Download Mode: ILM
CPU Frequency 15999631 Hz
Start to run coremark for 500 iterations
2K performance run parameters for coremark.
CoreMark Size : 666
Total ticks : 233879271
Total time (secs): 14.617908
Iterations/Sec : 34.204621
Iterations : 500
Compiler version : GCC9.2.0
Compiler flags : -O2 -flto -funroll-all-loops -finline-limit=600 -ftree-dominator-opts -fno-if-conversion2 -fselective-scheduling -fno-code-hoisting -fno-common -funroll-loops -finline-functions -falign-functions=4 -falign-jumps=4 -falign-loops=4
Memory location : STACK
seedcrc : 0xe9f5
[0]crclist : 0xe714
[0]crcmatrix : 0x1fd7
[0]crcstate : 0x8e3a
[0]crcfinal : 0xa14c
Correct operation validated. See readme.txt for run and reporting rules.
CoreMark 1.0 : 34.204621 / GCC9.2.0 -O2 -flto -funroll-all-loops -finline-limit=600 -ftree-dominator-opts -fno-if-conversion2 -fselective-scheduling -fno-code-hoisting -fno-common -funroll-loops -finline-functions -falign-functions=4 -falign-jumps=4 -falign-loops=4 / STACK
Print Personal Added Addtional Info to Easy Visual Analysis
(Iterations is: 500
(total_ticks is: 233879271
(*) Assume the core running at 1 MHz
So the CoreMark/MHz can be caculated by:
(Iterations*1000000/total_ticks) = 2.137855 CoreMark/MHz
dhrystone
This dhrystone benchmark application is used to run DHRYSTONE Benchmark Software.
The Dhrystone benchmark program has become a popular benchmark for CPU/compiler performance measurement, in particular in the area of minicomputers, workstations, PC’s and microprocesors.
It apparently satisfies a need for an easy-to-use integer benchmark;
it gives a first performance indication which is more meaningful than MIPS numbers which, in their literal meaning (million instructions per second), cannot be used across different instruction sets (e.g. RISC vs. CISC).
With the increasing use of the benchmark, it seems necessary to reconsider the benchmark and to check whether it can still fulfill this function.
In HummingBird SDK, we provided code and Makefile for this dhrystone application.
You can also optimize the COMMON_FLAGS defined in dhrystone application Makefile
to get different score number.
PFLOAT = 1 is added in its Makefile to enable float value print
You can change
Number_Of_Runsindhry_1.cline 134 to increate or decrease number of iterations
How to run this application:
# Assume that you can set up the Tools and HummingBird SDK environment
# cd to the dhrystone directory
cd application/baremetal/benchmark/dhrystone
# Clean the application first
make SOC=hbird BOARD=hbird_eval CORE=e203 clean
# Build and upload the application
make SOC=hbird BOARD=hbird_eval CORE=e203 upload
Expected output as below:
HummingBird SDK Build Time: Jul 16 2020, 16:15:27
Download Mode: ILM
CPU Frequency 15999959 Hz
Dhrystone Benchmark, Version 2.1 (Language: C)
Program compiled without 'register' attribute
Please give the number of runs through the benchmark:
Execution starts, 500000 runs through Dhrystone
Execution ends
Final values of the variables used in the benchmark:
Int_Glob: 5
should be: 5
Bool_Glob: 1
should be: 1
Ch_1_Glob: A
should be: A
Ch_2_Glob: B
should be: B
Arr_1_Glob[8]: 7
should be: 7
Arr_2_Glob[8][7]: 500010
should be: Number_Of_Runs + 10
Ptr_Glob->
Ptr_Comp: -1879035440
should be: (implementation-dependent)
Discr: 0
should be: 0
Enum_Comp: 2
should be: 2
Int_Comp: 17
should be: 17
Str_Comp: DHRYSTONE PROGRAM, SOME STRING
should be: DHRYSTONE PROGRAM, SOME STRING
Next_Ptr_Glob->
Ptr_Comp: -1879035440
should be: (implementation-dependent), same as above
Discr: 0
should be: 0
Enum_Comp: 1
should be: 1
Int_Comp: 18
should be: 18
Str_Comp: DHRYSTONE PROGRAM, SOME STRING
should be: DHRYSTONE PROGRAM, SOME STRING
Int_1_Loc: 5
should be: 5
Int_2_Loc: 13
should be: 13
Int_3_Loc: 7
should be: 7
Enum_Loc: 1
should be: 1
Str_1_Loc: DHRYSTONE PROGRAM, 1'ST STRING
should be: DHRYSTONE PROGRAM, 1'ST STRING
Str_2_Loc: DHRYSTONE PROGRAM, 2'ND STRING
should be: DHRYSTONE PROGRAM, 2'ND STRING
(*) User_Cycle for total run through Dhrystone with loops 500000:
220000037
So the DMIPS/MHz can be caculated by:
1000000/(User_Cycle/Number_Of_Runs)/1757 = 1.293527 DMIPS/MHz
whetstone
This whetstone benchmark application is used to run C/C++ Whetstone Benchmark Software (Single or Double Precision).
The Fortran Whetstone programs were the first general purpose benchmarks that set industry standards of computer system performance. Whetstone programs also addressed the question of the efficiency of different programming languages, an important issue not covered by more contemporary standard benchmarks.
In HummingBird SDK, we provided code and Makefile for this whetstone application.
You can also optimize the COMMON_FLAGS defined in whetstone application Makefile
to get different score number.
PFLOAT = 1 is added in its Makefile to enable float value print
Extra LDFLAGS := -lm is added in its Makefile to include the math library
How to run this application:
# Assume that you can set up the Tools and HummingBird SDK environment
# cd to the whetstone directory
cd application/baremetal/benchmark/whetstone
# Clean the application first
make SOC=hbird BOARD=hbird_eval CORE=e203 clean
# Build and upload the application
make SOC=hbird BOARD=hbird_eval CORE=e203 upload
Expected output as below:
HummingBird SDK Build Time: Jul 16 2020, 16:18:26
Download Mode: ILM
CPU Frequency 15997337 Hz
##########################################
Single Precision C Whetstone Benchmark Opt 3 32 Bit
Calibrate
15.43 Seconds 1 Passes (x 100)
Use 1 passes (x 100)
Single Precision C/C++ Whetstone Benchmark
Loop content Result MFLOPS MOPS Seconds
N1 floating point -1.12475013732910156 0.144 0.133
N2 floating point -1.12274742126464844 0.144 0.930
N3 if then else 1.00000000000000000 0.000 0.000
N4 fixed point 12.00000000000000000 0.806 0.391
N5 sin,cos etc. 0.49909299612045288 0.014 6.086
N6 floating point 0.99999982118606567 0.128 4.225
N7 assignments 3.00000000000000000 72.090 0.003
N8 exp,sqrt etc. 0.75110614299774170 0.010 3.664
MWIPS 0.648 15.431
MWIPS/MHz 0.041 15.431
FreeRTOS applications
demo
This freertos demo application is show basic freertos task functions.
Two freertos tasks are created
A software timer is created
In HummingBird SDK, we provided code and Makefile for this freertos demo application.
RTOS = FreeRTOS is added in its Makefile to include FreeRTOS service
The configTICK_RATE_HZ in
FreeRTOSConfig.his set to 200, you can change it to other number according to your requirement.
How to run this application:
# Assume that you can set up the Tools and HummingBird SDK environment
# cd to the freertos demo directory
cd application/freertos/demo
# Clean the application first
make SOC=hbird BOARD=hbird_eval CORE=e203 clean
# Build and upload the application
make SOC=hbird BOARD=hbird_eval CORE=e203 upload
Expected output as below:
HummingBird SDK Build Time: Jul 16 2020, 17:15:24
Download Mode: ILM
CPU Frequency 15998320 Hz
Before StartScheduler
Enter to task_1
task1 is running 0.....
Enter to task_2
task2 is running 0.....
timers Callback 0
timers Callback 1
task1 is running 1.....
task2 is running 1.....
timers Callback 2
timers Callback 3
task1 is running 2.....
task2 is running 2.....
timers Callback 4
timers Callback 5
task1 is running 3.....
task2 is running 3.....
timers Callback 6
timers Callback 7
task1 is running 4.....
task2 is running 4.....
timers Callback 8
timers Callback 9
task1 is running 5.....
task2 is running 5.....
timers Callback 10
timers Callback 11
UCOSII applications
demo
This ucosii demo application is show basic ucosii task functions.
4 tasks are created
1 task is created first, and then create 3 other tasks and then suspend itself
In HummingBird SDK, we provided code and Makefile for this ucosii demo application.
RTOS = UCOSII is added in its Makefile to include UCOSII service
The OS_TICKS_PER_SEC in
os_cfg.his by default set to 200, you can change it to other number according to your requirement.
How to run this application:
# Assume that you can set up the Tools and HummingBird SDK environment
# cd to the ucosii demo directory
cd application/ucosii/demo
# Clean the application first
make SOC=hbird BOARD=hbird_eval CORE=e203 clean
# Build and upload the application
make SOC=hbird BOARD=hbird_eval CORE=e203 upload
Expected output as below:
HummingBird SDK Build Time: Jul 16 2020, 17:20:13
Download Mode: ILM
CPU Frequency 15998320 Hz
Start ucosii...
create start task success
start all task...
task3 is running... 1
task2 is running... 1
task1 is running... 1
task3 is running... 2
task2 is running... 2
task3 is running... 3
task2 is running... 3
task1 is running... 2
task3 is running... 4
task2 is running... 4
task3 is running... 5
task2 is running... 5
task1 is running... 3
task3 is running... 6
task2 is running... 6
task3 is running... 7
task2 is running... 7
task1 is running... 4
task3 is running... 8
task2 is running... 8
task3 is running... 9
task2 is running... 9
task1 is running... 5
task3 is running... 10
task2 is running... 10
task3 is running... 11
task2 is running... 11
task1 is running... 6
task3 is running... 12
RT-Thread applications
demo
This rt-thread demo application is show basic rt-thread thread functions.
main function is a pre-created thread by RT-Thread
main thread will create 5 test threads using the same function
thread_entry
In HummingBird SDK, we provided code and Makefile for this rtthread demo application.
RTOS = RTThread is added in its Makefile to include RT-Thread service
The RT_TICK_PER_SECOND in
rtconfig.his by default set to 200, you can change it to other number according to your requirement.
How to run this application:
# Assume that you can set up the Tools and HummingBird SDK environment
# cd to the rtthread demo directory
cd application/rtthread/demo
# Clean the application first
make SOC=hbird BOARD=hbird_eval CORE=e203 clean
# Build and upload the application
make SOC=hbird BOARD=hbird_eval CORE=e203 upload
Expected output as below:
HummingBird SDK Build Time: Jul 16 2020, 17:22:44
Download Mode: ILM
CPU Frequency 16000286 Hz
\ | /
- RT - Thread Operating System
/ | \ 3.1.3 build Jul 16 2020
2006 - 2019 Copyright by rt-thread team
Main thread count: 0
thread 0 count: 0
thread 1 count: 0
thread 2 count: 0
thread 3 count: 0
thread 4 count: 0
thread 0 count: 1
thread 1 count: 1
thread 2 count: 1
thread 3 count: 1
thread 4 count: 1
Main thread count: 1
thread 0 count: 2
thread 1 count: 2
thread 2 count: 2
thread 3 count: 2
thread 4 count: 2
thread 0 count: 3
thread 1 count: 3
thread 2 count: 3
thread 3 count: 3
thread 4 count: 3
Main thread count: 2
thread 0 count: 4
thread 1 count: 4
thread 2 count: 4
thread 3 count: 4
thread 4 count: 4
thread 0 count: 5
thread 1 count: 5
thread 2 count: 5
thread 3 count: 5
thread 4 count: 5
Main thread count: 3
thread 0 count: 6
thread 1 count: 6
thread 2 count: 6
thread 3 count: 6
thread 4 count: 6
thread 0 count: 7
thread 1 count: 7
thread 2 count: 7
thread 3 count: 7
thread 4 count: 7
Main thread count: 4
thread 0 count: 8
thread 1 count: 8
thread 2 count: 8
thread 3 count: 8
thread 4 count: 8
thread 0 count: 9
thread 1 count: 9
thread 2 count: 9
thread 3 count: 9
thread 4 count: 9
msh
This rt-thread msh application demonstrates a shell in serial console which is a component of rt-thread.
MSH_CMD_EXPORT(hbird, msh hbird demo)exports a commandhbirdto shell
In HummingBird SDK, we provided code and Makefile for this rtthread msh application.
RTOS = RTThread is added in its Makefile to include RT-Thread service
RTTHREAD_MSH := 1 is added in its Makefile to include RT-Thread msh component
The RT_TICK_PER_SECOND in
rtconfig.his by default set to 200, you can change it to other number according to your requirement.
How to run this application:
# Assume that you can set up the Tools and HummingBird SDK environment
# cd to the rtthread msh directory
cd application/rtthread/msh
# Clean the application first
make SOC=hbird BOARD=hbird_eval CORE=e203 clean
# Build and upload the application
make SOC=hbird BOARD=hbird_eval CORE=e203 upload
Expected output as below:
HummingBird SDK Build Time: Nov 25 2020, 09:18:36
Download Mode: FLASH
CPU Frequency 15978659 Hz
\ | /
- RT - Thread Operating System
/ | \ 3.1.3 build Nov 25 2020
2006 - 2019 Copyright by rt-thread team
Hello RT-Thread!
msh >
RT-Thread shell commands:
list_timer list_mailbox list_sem list_thread version ps help hbird
msh >hbird
Hello HBird SDK!
msh >