2019-01-31 05:17:04 +08:00
< img src = "https://littlevgl.com/github/logo_small5.png" align = "right" / >
## LittlevGL - Free Open-source Embedded GUI Library
2019-01-29 20:51:49 +08:00
2019-01-30 03:57:46 +08:00
2019-01-29 22:41:07 +08:00
2019-01-30 03:57:46 +08:00
2019-01-30 17:00:50 +08:00
2016-06-15 17:40:04 +08:00
2019-01-29 21:10:41 +08:00
**LittlevGL 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.**
2017-11-29 18:41:34 +08:00
2019-01-30 13:35:56 +08:00
:star: **Star the project if you like it!** :star: < br >
2019-01-30 17:04:03 +08:00
 **And share with your firends** [](https://twitter.com/intent/tweet?text=LittlevGL%20is%20a%20free%20and%20open%20source%20embedded%20GUI%20library%20with%20easy-to-use%20graphical%20elements,%20beautiful%20visual%20effects%20and%20low%20memory%20footprint.& url=https://littlevgl.com/& hashtags=littlevgl,embedded,gui,free,opensource)
2019-01-29 22:41:07 +08:00
2019-01-30 13:35:56 +08:00
### [Website](https://littlevgl.com) · [Live demo](https://littlevgl.com/live-demo) · [Simulator](https://docs.littlevgl.com/#PC-simulator) · [Docs](https://docs.littlevgl.com/) · [Blog](https://blog.littlevgl.com/)
2018-12-27 06:35:18 +08:00
2019-01-29 20:51:49 +08:00
### Features
2018-09-24 17:42:13 +08:00
* **Powerful building blocks** buttons, charts, lists, sliders, images, etc.
* **Advanced graphics** with animations, anti-aliasing, opacity, smooth scrolling
* **Various input devices** touch pad, mouse, keyboard, encoder, buttons, etc.
* **Multi-language support** with UTF-8 encoding
* **Fully customizable** graphical elements
* **Hardware independent** to use with any microcontroller or display
2019-01-30 14:16:43 +08:00
* **Scalable** to operate with little memory (64 kB Flash, 10 kB RAM)
2018-09-24 17:42:13 +08:00
* **OS, External memory and GPU** supported but not required
* **Single frame buffer** operation even with advances graphical effects
* **Written in C** for maximal compatibility
* **Simulator** to develop on PC without embedded hardware
* **Tutorials, examples, themes** for rapid development
* **Documentation** and API references online
2016-06-15 17:40:04 +08:00
2019-01-29 22:41:07 +08:00
### Supported devices
2019-01-30 04:33:18 +08:00
Basically, every modern controller - which is able to drive a display - is suitable to run LittlevGL. The minimal requirements:
2019-01-29 22:46:30 +08:00
- **16, 32 or 64-bit** microcontroller or processor
- **> 16 MHz** clock speed
2019-01-30 04:33:18 +08:00
- **> 8 kB RAM for static data** and ** > 2 KB RAM for dynamic data** (graphical objects)
2019-01-30 13:35:56 +08:00
- **> 64 kB flash** program memory
2019-01-30 04:33:18 +08:00
- **Optionally ~1/10 screen sized memory** for buffered drawing (on 240 ×
2019-01-29 22:41:07 +08:00
2019-01-30 03:57:46 +08:00
Just to mention some **platforms** :
2019-01-29 22:42:59 +08:00
- STM32F1, STM32F3, [STM32F4 ](https://blog.littlevgl.com/2017-07-15/stm32f429_disco_port ), [STM32F7 ](https://github.com/littlevgl/stm32f746_disco_no_os_sw4stm32 )
2019-01-29 22:41:07 +08:00
- Microchip dsPIC33, PIC24, PIC32MX, PIC32MZ
- NXP Kinetis, LPC, iMX
- [Linux frame buffer ](https://blog.littlevgl.com/2018-01-03/linux_fb ) (/dev/fb)
- [Raspberry PI ](http://www.vk3erw.com/index.php/16-software/63-raspberry-pi-official-7-touchscreen-and-littlevgl )
2019-01-30 03:57:46 +08:00
- [Espressif ESP32 ](https://github.com/littlevgl/esp32_ili9431 )
2019-01-29 22:41:07 +08:00
- Nordic nrf52
- Quectell M66
### Quick start in a simulator
Try LittlevGL in a simulator on you PC without any embedded hardware. Choose a project with your favourite IDE:
| Eclipse | CodeBlock | Visual Studio | PlatfomIO | Qt Creator |
|-------------|----------- |---------------|-----------|------------|
| [](https://github.com/littlevgl/pc_simulator_sdl_eclipse) | [](https://github.com/littlevgl/pc_simulator_win_codeblocks) | [](https://github.com/littlevgl/visual_studio_2017_sdl_x64) | [](https://github.com/littlevgl/pc_simulator_sdl_platformio) | [](https://blog.littlevgl.com/2019-01-03/qt-creator) |
| Cross-platform< br > with SDL | Native Windows | Cross-platform< br > with SDL | Cross-platform< br > with SDL | Cross-platform< br > with SDL |
### Porting to an embedded hardware
2019-01-31 05:17:04 +08:00
In the most simple case you need to do these steps:
1. Copy `lv_conf_templ.h` as `lv_conf.h` next to `lvgl` and set at least `LV_HOR_RES` , `LV_VER_RES` and `LV_COLOR_DEPTH` .
2. Call `lv_tick_inc(x)` every `x` milliseconds in a Timer or Task (`x` should be between 1 and 10)
3. Call `lv_init()`
4. Register a function which can **copy a pixel array** to an area of the screen:
```c
lv_disp_drv_t disp_drv; /*Descriptor of a display driver*/
lv_disp_drv_init(&disp_drv); /*Basic initialization*/
disp_drv.disp_flush = disp_flush; /*Set your driver function*/
lv_disp_drv_register(&disp_drv); /*Finally register the driver*/
void disp_flush(int32_t x1, int32_t y1, int32_t x2, int32_t y2, const lv_color_t * color_p)
{
int32_t x, y;
for(y = y1; y < = y2; y++) {
for(x = x1; x < = x2; x++) {
sep_pixel(x, y, *color_p); /* Put a pixel to the display.*/
color_p++;
}
}
lv_flush_ready(); /* Tell you are ready with the flushing*/
}
```
5. Register a function which can **read an input device** . E.g. for a touch pad:
```c
lv_indev_drv_init(&indev_drv); /*Descriptor of a input device driver*/
indev_drv.type = LV_INDEV_TYPE_POINTER; /*Touch pad is a pointer-like device*/
indev_drv.read = touchpad_read; /*Set your driver function*/
lv_indev_drv_register(&indev_drv); /*Finally register the driver*/
bool touchpad_read(lv_indev_data_t * data)
{
static lv_coord_t last_x = 0;
static lv_coord_t last_y = 0;
/*Save the state and save the pressed cooridnate*/
data->state = touchpad_is_pressed() ? LV_INDEV_STATE_PR : LV_INDEV_STATE_REL;
if(data->state == LV_INDEV_STATE_PR) touchpad_get_xy(& last_x, &last_y);
/*Set the coordinates (if released use the last pressed cooridantes)*/
data->point.x = last_x;
data->point.y = last_y;
return false; /*Return `false` because we are not buffering and no more data to read*/
}
```
6. Call `lv_task_handler()` periodically every few milliseconds.
2019-01-29 22:50:29 +08:00
2019-01-30 13:35:56 +08:00
For a detailed description check the [Online documatation ](https://docs.littlevgl.com/#Porting ) or the [Porting tutorial ](https://github.com/littlevgl/lv_examples/blob/master/lv_tutorial/0_porting/lv_tutorial_porting.c )
2017-11-29 18:32:38 +08:00
2019-01-29 22:41:07 +08:00
### Contributing
To ask questions and discuss topics we use [GitHub's Issue tracker ](https://github.com/littlevgl/lvgl/issues ).
You contribute in several ways:
- **Answer other's question** click the Watch button on the top to get notified about the issues
2019-01-30 13:35:56 +08:00
- **Report and/or fix bugs** using the issue tracker and in Pull-request
- **Suggest and/or implement new features** using the issue tracker and in Pull-request
2019-01-29 22:41:07 +08:00
- **Improve and/or translate the documentation** learn more [here ](https://github.com/littlevgl/docs )
- **Write a blog post about your experiences** learn more [here ](https://github.com/littlevgl/blog )
- **Upload your project or product as a reference** to [this site ](https://blog.littlevgl.com/2018-12-26/references )
2018-08-21 14:40:12 +08:00
2019-01-30 13:35:56 +08:00
Before contributing, please read [CONTRIBUTING.md ](https://github.com/littlevgl/lvgl/blob/master/docs/CONTRIBUTING.md ).
2019-01-29 22:41:07 +08:00
For more info read this [blog post ](https://blog.littlevgl.com/2018-12-06/contributing ).
2017-05-15 20:11:12 +08:00
2019-01-29 22:41:07 +08:00
### Donate
If you are pleased with the library, found it useful, or you are happy with the support you got, please help its further development:
2017-05-15 20:11:12 +08:00
2018-01-29 19:32:14 +08:00
[](https://littlevgl.com/donate)
