Files

Gabor Kiss-Vamosi 637b706ddc perf(draw) reimplement circle drawing algorithms (#2374 )

* perf(draw) reimplement circle drawing algorithms

Imporve the speed of circle drawing
Add circle draw caching
Various other speed improvements

* docs describe how to use masks

* fix(draw) add missing GC root usage

2021-07-27 19:16:00 +02:00

ref_imgs

perf(draw) reimplement circle drawing algorithms (#2374 )

2021-07-27 19:16:00 +02:00

src

fix(test) do not including anything in test files when not running tests

2021-07-01 21:14:00 +02:00

unity

tests add README

2021-06-23 15:51:12 +02:00

.gitignore

test cleant up report folder

2021-06-18 14:15:53 +02:00

build.py

test fix CI build error

2021-06-23 23:04:12 +02:00

config.yml

feat(test) first experiement with Unity test engine

2021-06-18 14:13:41 +02:00

defines.py

ci add config for 8bpp

2021-07-15 17:12:25 -04:00

main.py

ci add config for 8bpp

2021-07-15 17:12:25 -04:00

Makefile

test fix CI build error

2021-06-23 23:04:12 +02:00

README.md

tests add README

2021-06-23 15:51:12 +02:00

test.py

test fix CI build error

2021-06-23 23:04:12 +02:00

README.md

Tests for LVGL

The tests in the folder can be run locally and automatically by GitHub CI.

Running locally

Requirements (Linux)

Be sure GCC and Python3 is installed.
Install gcovr with pip install gcovr
Install Ruby with sudo apt-get install ruby-full

Run test

Enter lvgl/tests/
Run the tests with ./main.py [OPTIONS]. The options are

report Create a html page in the report folder with the coverage report.
test Build and run only test. Without this option LVGL will be built with various configurations.
noclean Do not clean the project before building. Useful while writing test to save some times.

For example:

./main.py Run all the test as they run in the CI.
./main.py report test noclean Run only the test, should be sued when writing tests.

Running automatically

TODO

GitHub's CI automatically runs these tests on pushes and pull requests to master and releasev8.* branches.

Directory structure

src Source files of the tests
- test_cases The written tests,
- test_runners Generated automatically from the files in test_cases.
- other miscellaneous files and folders
ref_imgs - Reference images for screenshot compare
report - Coverage report. Generated if the report flag was passed to ./main.py
unity Source files of the test engine

Add new tests

Create new test file

New test needs to be added into the src/test_cases folder. The name of the files should look like test_<name>.c. The the basic skeleton of a test file copy _test_template.c.

Asserts

See the list of asserts here.

There are some custom, LVGL specific asserts:

TEST_ASSERT_EQUAL_SCREENSHOT("image1.png") Render the active screen and compare its content with an image in the ref_imgs folder. If the compare fails lvgl/test_screenshot_error.h is created with the content of the frame buffer as an image. To see the that image #include "test_screenshot_error.h" and call test_screenshot_error_show();.
TEST_ASSERT_EQUAL_COLOR(color1, color2) Compare two colors.

Adding new reference images

The reference images can be taken by copy-pasting the test code in to LVGL simulator and saving the screen. LVGL needs to

800x480 resolution
32 bit color depth
LV_USE_PERF_MONITOR and LV_USE_MEM_MONITOR disabled
use the default theme, with the default color (don't set a theme manually)