LittlevGL bindings for Rust. A powerful and easy-to-use embedded GUI with many widgets, advanced visual effects (opacity, antialiasing, animations) and low memory requirements (16K RAM, 64K Flash).
LVGL provides everything you need to create a Graphical User Interface (GUI) on embedded systems with easy-to-use graphical elements, beautiful visual effects and low memory footprint.
LVGL is compatible with #![no_std] environments by default.
In order to build the
lvglproject you will need the following system dependencies to be installed:
$ sudo apt install build-essential llvm clang
If you want to build the examples, then you will need to install SDL2 as well.
$ sudo apt install libsdl2-dev
Cargo.tomlfile dependencies with:
$ cargo add lvgl
The build requires the environment variable bellow to be set:
DEP_LV_CONFIG_PATH: Path to the directory containing the
lv_conf.hheader file used for configuration of LVGL library.
We recommend the
lv_conf.hfile to be in your project's root directory. If so, the command to build your project would be:
shell script $ DEP_LV_CONFIG_PATH=`pwd` cargo build
We make use of
bindgenfor generating the bindings to LittlevGL at build time. There is a problem in cargo when building for
no_std, so we need to use a workaround to build "lvgl-rs". The mainstrem issue in cargo is being tracked at rust-lang/cargo#7915.
$ DEP_LV_CONFIG_PATH=`pwd` cargo build -Zfeatures=build_dep
lvgl_alloc. This will make all dynamic memory to be allocated by LVGL internal memory manager.
Hint for macOS users: Before you run the demos you need to make sure you have libsdl installed on your machine. To install it, use HomeBrew:
$ brew install sdl2
First, make sure to pull
shell $ git submodule init $ git submodule update
Then run the
$ DEP_LV_CONFIG_PATH=`pwd`/examples/include cargo run --example demo
The bindings are still in development. There are many features of LVGL that needs to be exposed by
lvgl-rs. In this section you can check what is implemented at the moment.
lvgl-rswith any of the
embedded_graphicssupported displays. - [x] Events: You can listen and trigger events in widget objects. - [x] Styles: You can set styles in any exposed object. We are still missing the possibility of defining global base styles. - [ ] Input Devices - [ ] Fonts - [ ] Images - [ ] File system - [ ] Animations - [ ] Tasks
Widgets currently implemented might have some missing features. If the widget you want to use is not exposed or is missing a feature you want to make use, please send a Pull Request or open an issue.