APM32F411在RT
作者:新闻 来源:新闻 浏览: 【大 中 小】 发布时间:2025-05-26 03:14:14 评论数:
1.。 LVGL。简略介绍。
关于LVGL的介绍，咱们能够去它的官方文档检查。下面关于LVGL的介绍均是引证自对官方文档的翻译。
LVGL，全称是 Light and Versatile Graphics Library ，是一款免费开源的轻量多功用图形库。LVGL 供给创立。嵌入式。GUI 所需的悉数，该 GUI 具有易于运用的图形元素、漂亮的视觉作用和低内存占用。
首要特性：
· 强壮的构建块，如按钮、图表、列表、滑块、图画等。
· 具有动画、抗锯齿、不透明度、滑润翻滚的高档图形。
· 各种输入设备，如接触板、鼠标、键盘、。编码器。等。
· U。TF。-8 编码的多语言支撑。
· 多显现器支撑，即一同运用多个TFT、单色显现器。
· 具有相似 CSS 款式的彻底可定制的图形元素。
· 独立于。硬件。：与任何。微控制器。或显现器一同运用。
· 可扩展：能够运用很少的内存（64 kB 闪存、16 kB。 RAM。）进行操作。
· 支撑。操作体系。、外部存储器和。 GPU。，但不是必需的。
· 即便具有高档图形作用，也可进行单帧缓冲区操作。
· 用 C 编写以完结最大兼容性（。C++。兼容）。
· 无需嵌入式硬件即可在 PC 上发动嵌入式 GUI 规划的。模仿。器。
· 绑定到 Micro。Python。
· 快速 GUI 规划的。教程。、示例、主题。
· 文档可在线获取并以 PDF 方法供给。
· 依据 MIT 答应免费且开源。
运转的设备要求：
根本上，每个能够驱动显现器的现代。控制器。都合适运转 LVGL。最低要求是：
· 16、32 或 64 位微控制器或。处理器。
· 主张运用 >16 MHz。 时钟。速度。
· 闪存/。ROM。：>64 kB 用于非常重要的组件（主张>180 kB）。
· 内存：
静态 RAM 运用量：~2 kB，详细取决于所运用的功用和目标类型库房：>2kB（主张>8 kB）动态数据（堆）：>2 KB（假如运用多个目标，主张>48 kB）。LV_MEM_SIZE经过在 中设置lv_conf.h。显现缓冲区：>“水平分辩率”像素（主张>10 “水平分辩率” ）。MCU。或外部显现控制器中的一个帧缓冲区。
· C99 或更新版别的编译器。
2. LVGL学习资源。
下面搜集了一些LVGL的学习资源。
1、LVGL官网：
https://lvgl.io/。
2、LVGL官网文档教程：
https://docs.lvgl.io/master/。
3、百问网对LVGL官方文档的翻译：
https://lvgl.100ask.net/master/。
4、LVGL Github库房：
https://github.com/lvgl/lvgl。
5、lvgl依据Visual sudio 的PC模仿器。
https://github.com/lvgl/lv_。sim。_visual_studio。
6、百问网依据LVGL的一个项目：
https://f。or。ums.100ask.net/t/to。pi。c/602。
3. 移植前预备。
移植的硬件渠道：
MCU：APM32F411。
LCD。驱动芯片。：ST7789V。
接触。IC。：CST816T。
本次移植是依据。 RT-Thread。体系上运转 LVGL 的，所以在移植前，咱们需求预备好能够正常运转 RT-Thread 的Demo工程（能够到极海官网。下载。APM32F411的。SD。K）。
别的，还需预备好能够正常运转LCD的驱动和接触IC的驱动的代码。
1、预备一份能够运转RT-Thread的Demo工程。
2、下载LVGL_8.3源码。
到官方 Github 库房，然后挑选 LVGL_8.3 版别。
下载到的LVGL源码，然后存放到工程目录下的 middlewares 文件夹。
4. LVGL移植。
4.1 移动和修正移植的。接口。文件。
（1）移植接口文件修正。
下载了LVGL的源码之后，咱们把移植要运用到的接口文件，修正文件名后，放到工程目录的另一个文件夹。
（2）移植装备文件修正。
在LVGL源码的根目录下有一个 lv_conf_。te。mplate.h 头文件，这个文件是 LVGL 库的装备文件，能够修正该文件来设置库的根本行为，禁用未运用的模块和功用，调整编译时缓冲区的巨细等。
上面把LVGL移植接口和装备文件都仿制到了工程的下面这个目录：
4.2。 Keil。工程装备。
（1）Keil工程增加文件。
把LVGL的源码导入到Keil工程下，其间 LVGL 源码目录下的 src 目录的C文件能够悉数导入Keil工程，然后再导入LVGL的移植接口文件。如下图：
导入完结之后如下：
（2）修正工程头文件途径包括。
（3）勾选C99形式。
LVGL源码的编译需求C99形式的支撑，否则会呈现许多的报错。
4.3 LVGL修正源码。
（1）修正 startup_apm32f411.s 文件的栈巨细。
官方供给的发动文件的栈设置的比较小，咱们需求改大一些。
（2）修正LVGL的装备文件 lvgl_conf.c。
然后，下面是LVGL各个模块的装备，能够依据自己的需求是否翻开仍是封闭。
该文件还有颜色深度的装备，显现屏宽高的装备等，需求依据自己的硬件进行装备，纷歧一列举了。
（3）修正LVGL显现接口文件lv_port_disp.c。
该文件便是LVGL的显现接口文件，需求咱们先预备好LCD显现的描点函数。该文件首要要修正的点有：
1、翻开显现接口文件宏界说。
2、修正lv_port_disp_init函数。
关于lv_port_disp_init函数，官方供给了3种写缓存的方法及设置显现分辩。咱们能够挑选其间一种方法即可，修正后的函数如：
void lv_port_disp_init(void)。
{。
/*-------------------------。
* Ini。ti。alize your display。
* -----------------------*/。
disp_init();
/*-----------------------------。
* Create a buffer for drawing。
*----------------------------*/。
/**。
* LVGL requires a buffer where it internally draws the widgets.。
* Later this buffer will passed to your display driver's `flush_cb` to copy its content to your display.。
* The buffer has to be greater than 1 display row。
*。
* There are 3 buffering configurations:。
* 1. Create ONE buffer:。
* LVGL will draw the display's content here and writes it to your display。
*。
* 2. Create TWO buffer:。
* LVGL will draw the display's content to a buffer and writes it your display.。
* You should use。 DMA。to write the buffer's content to the display.。
* It will enable LVGL to draw the next part of the screen to the other buffer while。
* the data is being sent form the fi。rs。t buffer. It makes rendering and flushing parallel.。
*。
* 3. Double buffering。
* Set 2 screens sized buffers and set disp_drv.full_refresh = 1.。
* This way LVGL will always provide the whole rendered screen in `flush_cb`。
* and you only need to change the frame buffer's。 ad。dress.。
*/。
/* Example for 1) */。
static lv_disp_draw_buf_t draw_buf_dsc_1;
static lv_color_t buf_1[MY_DISP_HOR_RES * DISP_BUFFER_LINES]; /*A buffer for 10 rows*/。
lv_disp_draw_buf_init(&draw_buf_dsc_1, buf_1, NULL, MY_DISP_HOR_RES * DISP_BUFFER_LINES); /*Initialize the display buffer*/。
// /* Example for 2) */。
// static lv_disp_draw_buf_t draw_buf_dsc_2;
// static lv_color_t buf_2_1[MY_DISP_HOR_RES * DISP_BUFFER_LINES]; /*A buffer for 10 rows*/。
// static lv_color_t buf_2_2[MY_DISP_HOR_RES * DISP_BUFFER_LINES]; /*An other buffer for 10 rows*/。
// lv_disp_draw_buf_init(&draw_buf_dsc_2, buf_2_1, buf_2_2, MY_DISP_HOR_RES * DISP_BUFFER_LINES); /*Initialize the display buffer*/。
// /* Example for 3) also set disp_drv.full_refresh = 1 below*/。
// static lv_disp_draw_buf_t draw_buf_dsc_3;
// static lv_color_t buf_3_1[MY_DISP_HOR_RES * MY_DISP_VER_RES]; /*A screen sized buffer*/。
// static lv_color_t buf_3_2[MY_DISP_HOR_RES * MY_DISP_VER_RES]; /*Another screen sized buffer*/。
// lv_disp_draw_buf_init(&draw_buf_dsc_3, buf_3_1, buf_3_2,
// MY_DISP_VER_RES * MY_DISP_VER_RES); /*Initialize the display buffer*/。
/*-----------------------------------。
* Register the display in LVGL。
*----------------------------------*/。
static lv_disp_drv_t disp_drv; /*Descriptor of a display driver*/。
lv_disp_drv_init(&disp_drv); /*B。asic。initialization*/。
/*Set up the functions to。 ac。cess to your display*/。
/*Set the resolution of the display*/。
disp_drv.hor_res = MY_DISP_HOR_RES;
disp_drv.ver_res = MY_DISP_VER_RES;
/*Used to copy the buffer's content to the display*/。
disp_drv.flush_cb = disp_flush;
/*Set a display buffer*/。
disp_drv.draw_buf = &draw_buf_dsc_1;
/*Required for Example 3)*/。
//disp_drv.full_refresh = 1;
/* Fill a memory array with a color if you have GPU.。
* Note that, in lv_conf.h you。 can。enable GPUs that has built-in support in LVGL.。
* But if you have a different GPU you can use with this callback.*/。
//disp_drv.gpu_fill_cb = gpu_fill;
/*Finally register the driver*/。
lv_disp_drv_register(&disp_drv);
}。
3、修正disp_flush函数。
该函数便是调用底层LCD描点函数进行制作UI界面的。
// LCD描点函数。
void LCD_Color_Fill(u16 sx, u16 sy, u16 ex, u16 ey, u16 *color)。
{。
u16 i, j;
u16 height, width;
width = ex - sx + 1;
height = ey - sy + 1;
LCD_Address_Set(sx,sy+OFFSET_Y,ex,ey+OFFSET_Y);
for (i = 0; i。 < height; i++)
{。
for (j = 0; j。 < width; j++)
{。
LCD_WR_DATA(color[i * width + j]);
}。
}。
}。
static void disp_flush(lv_disp_drv_t * disp_drv, const lv_area_t * area, lv_color_t * color_p)。
{。
// 调用底层LCD描点函数。
LCD_Color_Fill(area->x1, area->y1, area->x2, area->y2, (uint16_t *)color_p);
/*IMPORTANT!!!。
*Inform the graphics library that you are ready with the flushing*/。
lv_disp_flush_ready(disp_drv);
}。
4.4 增加和修正RT-Thread环境的LVGL文件支撑。
咱们需求把LVGL运转在RT-Thread体系，所以咱们需求增加LVGL的RT-Thread接口文件。官方其实现已做好了对应的文件，咱们仿制到工程目录下修正即可。
（1）增加LVGL的RT-Thread接口文件到Keil工程。
然后把这两个文件加入到Keil工程目录下：
（2）修正lv_rt_thread_conf.h头文件。
由于官方现已做好了RT-Thread接口文件了，咱们只需求简略修正即可。修正如下：
4.5 增加LVGL Demo例程。
前面的移植和修正代码现已完结了LVGL的移植工程，下面咱们增加一个简略的 LVGLDemo 例程进行测验。
咱们能够在官方的源码目录 .demos 目录下选一个示例程序，或许也能够自己找一个其他的简略的LVGL示例代码。我下面选一个日历demo例程进行演示。
最终编译工程源码和下载到APM32F411中。
编译会有一些正告，这是LVGL源码引进的，有些语**有正告，能够暂时疏忽。
在APM32F411运转成果如下：
5. 给LVGL增加接触接口。
前面的移植现已把显现接口给完结了，并且上面也能够正常显现了。可是LVGL的输入接口还没移植进来，不过有了前面的移植进程，增加接触输入接口就很简略了。首要便是修正 lv_port_indev.c 文件。
（1）把 lv_port_indev.c 文件的宏界说改为1。
（2）修正 touchpad_is_pressed 和 touchpad_get_xy 函数。
/*Return true is the touchpad is pressed*/。
static bool touchpad_is_pressed(void)。
{。
/*Your code comes here*/。
uint8_t num = cst816t_get_touch_points_num(); // 是否有接触点。
if ((num != 0) && (num != 0xFF))。
{。
return true;
}。
else。
{。
return false;
}。
}。
/*Get the x and y coordinates if the touchpad is pressed*/。
static void touchpad_get_xy(lv_coord_t * x, lv_coord_t * y)。
{。
/*Your code comes here*/。
// uint16_t tp_x = 0, tp_y = 0;
cst816t_read_pos((uint16_t *)x, (uint16_t *)y); // 底层获取接触坐标函数。
// (*x) = tp_x;
// (*y) = tp_y;
}。
cst816t_read_pos 函数是要咱们先写好的获取接触坐标的函数。别的还有一些没用到的代码我给注释掉了。
增加完上述代码就能够发现在屏幕能够点击进行修正日期了，阐明接触接口移植完结。
最终，APM32F411在RT-Thread体系下移植LVGL工程就悉数完结了。整个进程仍是比较简略的，并且网上也有许多相关的教程。不过移植进程中仍是碰到不是小问题的，有些细节并没有在文章中一一写出来，在移植进程中遇到一些问题就需求咱们依据报错提示对应处理就好。别的，在移植前最重要的便是要确保LCD驱动和接触驱动代码正确，然后再进行移植，这样呈现问题咱们比较好剖析和定位问题。