8.9 KiB
LVGL - Biblioteca gráfica leve e versátil
O LVGL fornece tudo o que você precisa para criar uma GUI incorporada com elementos gráficos fáceis de usar, belos efeitos visuais e um baixo consumo de memória.
Site · Documentação · Fórum · Serviços · Exemplos interativos
English | 中文 | Português do Brasil
Tabela de conteúdo
Visão Geral
Recursos
- Poderosos widgets: botões, gráficos, listas, controles deslizantes (sliders), imagens, etc.
- Mecanismo gráfico avançado: animações, anti-aliasing, opacidade, rolagem suave, modos de mesclagem (blending modes), etc.
- Suporte à vários dispositivos de entrada: tela sensível ao toque, mouse, teclado, codificador, botões, etc.
- Suporte à vários monitores
- Pode ser usado com qualquer microcontrolador e display, independente do hardware
- Escalável para operar com pouca memória (64 kB Flash, 16 kB RAM)
- Suporte multilíngue com manipulação UTF-8, suporte ao alfabeto bidirecional, árabe e CJK (Chinês, Japonês e Coreano)
- Elementos gráficos totalmente personalizáveis por meio de CSS
- Layouts poderosos inspirados em CSS: Flexbox e Grid
- SO, memória externa e GPU são suportados, mas não obrigatórios. (suporte integrado para STM32 DMA2D, SWM341 DMA2D e NXP PXP e VGLite)
- Renderização suave mesmo com um buffer de quadro único (single frame buffer)
- Escrito em C e compatível com C++
- Uso do LittlevGL com Micropython simplificado com LVGL API in Micropython
- Simulador para desenvolver no PC sem hardware embutido
- Mais de 100 exemplos simples
- Documentação e referências de API online e em PDF
Requerimentos
Basicamente, todo controlador moderno (que é capaz de acionar um display) é adequado para executar LVGL. Os requisitos mínimos são:
| Nome | Minímo | Recomendado |
| Arquitetura | Microcontrolador ou processador de 16, 32 ou 64 bits | |
| Clock | > 16 MHz | > 48 MHz |
| Flash/ROM | > 64 kB | > 180 kB |
| RAM estática | > 16 kB | > 48 kB |
| Draw buffer | > 1 × hor. res. pixels | > tamanho da tela de 1/10 |
| Compilador | Padrão C99 ou mais recente | |
Observe que o uso de memória pode variar dependendo da arquitetura, do compilador e das opções de compilação.
Plataformas suportadas
O LVGL é completamente independente de plataforma e pode ser usado com qualquer MCU que atenda aos requisitos. Apenas para citar algumas plataformas:
- NXP: Kinetis, LPC, iMX, iMX RT
- STM32F1, STM32F3, STM32F4, STM32F7, STM32L4, STM32L5, STM32H7
- Microchip dsPIC33, PIC24, PIC32MX, PIC32MZ
- Linux frame buffer (/dev/fb)
- Raspberry Pi
- Espressif ESP32
- Infineon Aurix
- Nordic NRF52 Bluetooth modules
- Quectel modems
- SYNWIT SWM341
LVGL também está disponível para:
- Arduino library
- PlatformIO package
- Zephyr library
- ESP32 component
- NXP MCUXpresso component
- NuttX library
- RT-Thread RTOS
Iniciando
Esta lista mostra a maneira recomendada de aprender sobre a biblioteca:
- Confira as demos on-line para ver o LVGL em ação (3 minutos)
- Leia a introdução da documentação (5 minutos)
- Familiarize-se com o básico da Visão geral rápida (15 minutos)
- Configure um simulador (10 minutos)
- Experimente alguns Exemplos
- Placa para porta LVGL. Veja o guia porting ou verifique o pronto para usar Projects
- Leia a visão geral para entender melhor a biblioteca (2-3 horas)
- Verifique a documentação dos widgets para ver seus recursos e como utilizá-los
- Se você tiver dúvidas, acesse o fórum
- Leia o guia de contribuição para ver como você pode ajudar a melhorar o LVGL (15 minutos)
Exemplos
Para mais exemplos, veja a pasta examples.
C
lv_obj_t * button = lv_btn_create(lv_scr_act()); /* Adiciona um botão à tela atual */
lv_obj_set_pos(button, 10, 10); /* Define uma posição ao botão na tela */
lv_obj_set_size(button, 100, 50); /* Define o tamanho */
lv_obj_add_event_cb(button, button_event_callback, LV_EVENT_CLICKED, NULL); /* Atribui um retorno de chamada (callback) */
lv_obj_t * label = lv_label_create(button); /* Adiciona um rótulo (label) */
lv_label_set_text(label, "Clique aqui"); /* Define o texto do rótulo (label) */
lv_obj_center(label); /* Alinha o texto ao centro */
...
void button_event_callback(lv_event_t * e)
{
printf("Clicado\n");
}
Micropython
Saiba mais em Micropython
def button_event_callback(event):
print("Clicado")
# Cria um botão e um rótulo (label)
button = lv.btn(lv.scr_act())
button.set_pos(10, 10)
button.set_size(100, 50)
button.add_event_cb(button_event_callback, lv.EVENT.CLICKED, None)
label = lv.label(button)
label.set_text("Cliquq aqui")
label.center()
Serviços
O LVGL Kft foi estabelecido para fornecer uma base sólida para a biblioteca LVGL. Oferecemos vários tipos de serviços para ajudá-lo no desenvolvimento da interface do usuário:
- Design gráfico
- Implementação de IU
- Consultoria/Suporte
Para mais informações, consulte LVGL Serviços. Sinta-se à vontade para entrar em contato conosco se tiver alguma dúvida.
Contribuindo
O LVGL é um projeto aberto e sua contribuição é muito bem-vinda. Há muitas maneiras de contribuir, desde simplesmente falando sobre seu projeto, escrevendo exemplos, melhorando a documentação, corrigindo bugs até hospedar seu próprio projeto sob a organização LVGL.
Para obter uma descrição detalhada das oportunidades de contribuição, visite a seção de contribuição da documentação.