rafaelcaricio/lvgl-rs
1
0
Fork 0
Code Issues 12 Pull requests 2 Projects Releases 4 Wiki Activity
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).
150 commits 6 branches 8 tags 3.6 MiB
Rust 99.2%
C 0.8%
Find a file
Tim Newsome cbbdc7e750 Add --features="alloc" to run demo 
Without that, I got the following error from cargo:
```
error: target `demo` in package `lvgl` requires the features: `alloc`
Consider enabling them by passing, e.g., `--features="alloc"`
```
2022-01-10 14:35:54 +01:00
.github/workflows Run apt-get update in CI 2020-06-19 15:48:44 +02:00
examples Add LVGL Rust Global Allocator feature 2021-05-26 20:55:38 +02:00
lvgl Remove lazy_static dependency 2021-05-26 20:55:38 +02:00
lvgl-codegen Upgrade to lvgl v7.10.1 2021-05-24 23:17:33 +02:00
lvgl-sys Add LVGL Rust Global Allocator feature 2021-05-26 20:55:38 +02:00
.gitignore Use bindgen output to generate code 2020-06-14 11:10:29 +02:00
.gitmodules LVGL 7.0.1 basic setup 2020-06-04 20:47:40 +02:00
Cargo.toml Add LVGL Rust Global Allocator feature 2021-05-26 20:55:38 +02:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2020-05-31 00:13:57 +02:00
demo.png Sync code with image 2020-05-30 09:42:42 +02:00
LICENSE Initial commit 2020-04-10 15:00:21 +02:00
lv_demo.png Update images and links in README 2020-05-30 09:37:40 +02:00
README.md Add --features="alloc" to run demo 2022-01-10 14:35:54 +01:00

README.md

LVGL - Open-source Embedded GUI Library in Rust

Original LVGL demo image

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.

Rust to WASM demo · Official LVGL Website · C library repository · Official live demos

Rust bindings usage demo code.

System Build Dependencies

In order to build the lvgl project 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

Usage

Edit your Cargo.toml file 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.h header file used for configuration of LVGL library.

We recommend the lv_conf.h file to be in your project's root directory. If so, the command to build your project would be:

$ DEP_LV_CONFIG_PATH=`pwd` cargo build

Building for embedded environments

We make use of bindgen for 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 Global Allocator

A global allocator for Rust leveraging the LVGL memory allocator is provided, but not enabled by default. Can be enabled by the feature lvgl_alloc. This will make all dynamic memory to be allocated by LVGL internal memory manager.

Running the demo

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

This project contains examples that can run in a desktop simulator.

First, make sure to pull lvgl-rs submodules:

$ git submodule init
$ git submodule update

Then run the demo example:

$ DEP_LV_CONFIG_PATH=`pwd`/examples/include cargo run --example demo --features="alloc"

Feature Support

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.

Features

List of LVGL features that impacts the library usage in general.

  • Displays: We use embedded_graphics library to draw to the display. You can use lvgl-rs with any of the embedded_graphics supported displays.
  • Events: You can listen and trigger events in widget objects.
  • 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

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.