状态:跑通。LVGL 简单界面(标题/圆弧动画/按钮计数)正常显示,颜色正确, SPI 20MHz。app:D:\luglZephyrproject\app\lvgl_demo。 前置依赖:SPI 驱动两个修复(笔记 41)、LCD 接线与显示栈(笔记 40)。
1. 硬件接线
| SCK | P1_10(SPI1 CLK) | 子板 J203-2 |
| MOSI | P1_11(SPI1 DO) | 子板 J203-4 |
| CS | P1_13(GPIO 27) | 子板 J203-8 |
| D/C | P0_11(GPIO 11) | 主板 J201-24(跳线 J201-24↔15) |
| RST | P0_12(GPIO 12) | 主板 J201-26(跳线 J201-26↔11) |
| VCC/GND | 3.3V / GND | 背光 LEDA 单独供电 |
子板 J203 的 4 根 BLE 跳线(1-2/3-4/5-6/7-8)拔掉。
2. 两个关键的坑
坑 1:显示设备不能标 zephyr,deferred-init
Zephyr 的 LVGL 胶水层 lvgl_init() 在 SYS_INIT(APPLICATION) 阶段自动运行, 开头就检查 device_is_ready(display),没就绪直接 return -ENODEV——lv_init() 不执行、LVGL 私有堆不初始化、不创建 display 对象。
我们 lcd_s035 沿用了官方 shield 的 zephyr,deferred-init + main() 里手动device_init() 的模式。但 main() 跑得再早也在 SYSINIT 之后—— LVGL 初始化已经失败返回了。之后任何 `lv*调用都在操作未初始化的全局状态, 症状是**确定性崩溃**:第一次lv_malloc就踩进未初始化的 sys_heap, freelist 里是垃圾指针(崩在alloc_chunk/free_chunk_check`, 或经垃圾函数指针跳进莫名其妙的函数)。
修法:overlay 里删掉 zephyr,deferred-init,让显示链在内核设备初始化 阶段完成(st7796s 依赖 mipi-dbi 节点,Zephyr 自动排好 init 顺序), main() 里不再需要手动 device_init()。
坑 2:RGB565 字节序——CONFIG_LV_COLOR_16_SWAP=y
屏期望总线上高字节在前(0xF800 红色发 F8 00);LVGL 按小端存像素 (内存里 00 F8),不加交换直接 flush 出去颜色全错。 开 CONFIG_LV_COLOR_16_SWAP=y 让 LVGL 直接按交换序存像素,零拷贝解决。
3. 完整工程文件
app/lvgl_demo/prj.conf
CONFIG_SERIAL=y CONFIG_CONSOLE=y CONFIG_UART_CONSOLE=y CONFIG_PRINTK=y CONFIG_GPIO=y CONFIG_SPI=y CONFIG_DISPLAY=y CONFIG_INPUT=y CONFIG_LOG=n CONFIG_MAIN_STACK_SIZE=8192 CONFIG_LVGL=y CONFIG_LV_Z_MEM_POOL_SIZE=65536 CONFIG_LV_USE_LABEL=y CONFIG_LV_USE_ARC=y CONFIG_LV_USE_BUTTON=y CONFIG_LV_USE_SLIDER=y CONFIG_LV_FONT_MONTSERRAT_14=y CONFIG_LV_FONT_MONTSERRAT_16=y CONFIG_LV_FONT_MONTSERRAT_24=y # SPI1 on P1_10 (SCK) / P1_11 (MOSI) / P1_12 (MISO), daughterboard J203 2/4/6 CONFIG_RA6W1_SPI1_PINS_BLE_HDR=y # Panel expects RGB565 MSB-first on the wire; LVGL stores pixels # little-endian, so swap bytes in memory. CONFIG_LV_COLOR_16_SWAP=y
app/lvgl_demo/CMakeLists.txt
cmake_minimum_required(VERSION 3.20.0)
find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE})
project(lvgl_demo)
target_sources(app PRIVATE src/main.c)app/lvgl_demo/boards/ek_ra6w1.overlay
#include <zephyr/dt-bindings/mipi_dbi/mipi_dbi.h>
/ {
chosen {
zephyr,display = &st7796s;
};
aliases {
mipi-dbi = &mipi_dbi_spi;
};
};
&spi1 {
status = "okay";
/* P1_13 (linear pin 27) -> daughterboard J203 pin 8 -> LCD CS */
cs-gpios = <&gpio0 27 GPIO_ACTIVE_LOW>;
};
/ {
mipi_dbi_spi: mipi-dbi-spi {
compatible = "zephyr,mipi-dbi-spi";
spi-dev = <&spi1>;
/* P0_11 (linear pin 11) = D/C */
dc-gpios = <&gpio0 11 GPIO_ACTIVE_HIGH>;
/* P0_12 (linear pin 12) = RST */
reset-gpios = <&gpio0 12 GPIO_ACTIVE_LOW>;
write-only;
#address-cells = <1>;
#size-cells = <0>;
st7796s: st7796s@0 {
compatible = "sitronix,st7796s";
reg = <0>;
mipi-max-frequency = <20000000>;
mipi-mode = "MIPI_DBI_MODE_SPI_4WIRE";
height = <320>;
width = <480>;
invert-mode = "1-dot";
frmctl1 = [80 10];
bpc = [1f 50 00 20];
dfc = [8a 07 3b];
pwr1 = [80 64];
pwr2 = <0x13>;
pwr3 = <0xa7>;
vcmpctl = <0x09>;
doca = [40 8a 00 00 29 19 a5 33];
pgc = [f0 06 0b 07 06 05 2e 33 47 3a 17 16 2e 31];
ngc = [f0 09 0d 09 08 23 2e 33 46 38 13 13 2c 32];
madctl = <0x28>;
color-invert;
};
};
};注意:st7796s 的初始化参数(frmctl/bpc/dfc/pwr/gamma 等)照抄自 Zephyr 官方boards/shields/lcd_par_s035/lcd_par_s035_spi.overlay,不要zephyr,deferred-init(见坑 1)。
app/lvgl_demo/src/main.c
/*
* Copyright (c) 2026 Renesas Electronics Corporation
*
* SPDX-License-Identifier: Apache-2.0
*
* Simple LVGL UI on the LCD-PAR-S035 (ST7796S): title label,
* animated arc, and a click counter button.
*/
#include <zephyr/device.h>
#include <zephyr/drivers/display.h>
#include <zephyr/kernel.h>
#include <lvgl.h>
#include <lvgl_zephyr.h>
#include <stdio.h>
static uint32_t clicks;
static void btn_click_cb(lv_event_t *e)
{
ARG_UNUSED(e);
clicks++;
}
int main(void)
{
const struct device *display_dev = DEVICE_DT_GET(DT_CHOSEN(zephyr_display));
int ret;
/* The display chain initializes during kernel device init (no
* zephyr,deferred-init): lvgl_init runs at SYS_INIT afterwards
* and requires the display to be ready.
*/
if (!device_is_ready(display_dev)) {
printk("display device not ready\n");
return 0;
}
lvgl_lock();
lv_obj_t *title = lv_label_create(lv_screen_active());
lv_label_set_text(title, "RA6W1 + ST7796S");
lv_obj_set_style_text_font(title, &lv_font_montserrat_24, 0);
lv_obj_align(title, LV_ALIGN_TOP_MID, 0, 16);
lv_obj_t *arc = lv_arc_create(lv_screen_active());
lv_obj_set_size(arc, 150, 150);
lv_arc_set_rotation(arc, 270);
lv_arc_set_bg_angles(arc, 0, 360);
lv_obj_align(arc, LV_ALIGN_CENTER, 0, -8);
lv_obj_t *btn = lv_button_create(lv_screen_active());
lv_obj_t *btn_label = lv_label_create(btn);
lv_obj_set_size(btn, 140, 50);
lv_obj_align(btn, LV_ALIGN_BOTTOM_MID, 0, -24);
lv_label_set_text(btn_label, "Press me");
lv_obj_center(btn_label);
lv_obj_add_event_cb(btn, btn_click_cb, LV_EVENT_CLICKED, NULL);
lv_obj_t *count_label = lv_label_create(lv_screen_active());
lv_label_set_text(count_label, "clicks: 0");
lv_obj_align(count_label, LV_ALIGN_BOTTOM_MID, 0, -84);
lvgl_unlock();
lv_timer_handler();
ret = display_blanking_off(display_dev);
if (ret < 0 && ret != -ENOSYS) {
printk("blanking off -> %d\n", ret);
return 0;
}
printk("lvgl simple ui running\n");
uint32_t tick = 0;
uint32_t last_clicks = UINT32_MAX;
char buf[24];
while (1) {
lvgl_lock();
lv_timer_handler();
tick++;
if ((tick % 10) == 0U) {
lv_arc_set_value(arc, (tick / 10) % 101);
}
if (clicks != last_clicks) {
last_clicks = clicks;
snprintf(buf, sizeof(buf), "clicks: %u", clicks);
lv_label_set_text(count_label, buf);
}
lvgl_unlock();
k_msleep(10);
}
}4. 构建/烧录
cd /d/luglZephyrproject west build -b ek_ra6w1 -d build_lvgl_demo app/lvgl_demo bash /d/RA/RRQ61051/tools/flash_ra6w1.sh build_lvgl_demo/zephyr/zephyr.bin
资源占用(含双页面 + 中文字体子集):FLASH ~331KB(8MB 的 3.9%)、 RAM ~113KB(256KB 的 43%)。
5. 排障备忘(本次实际路径)
直接上官方 widgets demo → 确定性 HARD FAULT(垃圾函数指针跳进st7796s_get_capabilities)。以为是栈/堆不够,加栈无效。
换简单界面 → 崩在堆分配器(alloc_chunk freelist 里是 flash 指针)。
开 CONFIG_ASSERT_LEVEL=2 + CONFIG_SYS_HEAP_VALIDATE=y → 断言定位到 LVGL 私有 sys_heap 第一次分配就坏。
读 LVGL 胶水源码发现 lvgl_init 对 deferred-init 的 display 直接 -ENODEV 早退 → 根因(坑 1)。删 deferred-init 即亮。
颜色错 → CONFIG_LV_COLOR_16_SWAP=y(坑 2)。
widgets demo 的崩溃与简单界面同根因(LVGL 未初始化),修复后理论上也能跑, 未复验(demo 需要自行把 demos/ 源文件加进 CMakeLists,并打开CONFIG_LV_USE_DEMO_WIDGETS=y)。
6. 演示界面改版
界面改为三栏式(横屏 480×320,madctl=0x28):
顶部居中:标题 RA6W1 + Zephyr RTOS(montserrat 24)
左栏(x=10):接线表,用 lv_table(3 列 Signal/Pin/Conn × 9 行), 灰色全边框;表格下方一行注释 GT911 touch via U6 level shifter, 用 lv_obj_align_to(note, table, LV_ALIGN_OUT_BOTTOM_LEFT, ...) 相对 表格底边对齐,表格行高变化也不会重叠
右栏(x≥272):clicks 计数标签、Press me 按钮(160×50)、活动圆弧
需要 CONFIG_LV_USE_TABLE=y。
踩坑:表格单元格文字莫名换行。 列宽看着够("SPI MOSI" 64px < 84px 列) 还是折行——原因是 LVGL 默认主题给单元格的左右内边距很大(约 12px×2), 真正可用的文字宽度 = 列宽 − 24px。解决:
lv_obj_set_style_pad_hor(table, 4, LV_PART_ITEMS); /* 默认太大 */ lv_obj_set_style_pad_ver(table, 2, LV_PART_ITEMS);
最终列宽 88/60/84(总 232px),左栏 x=10..242,与右栏(x≥272)不重叠。
7. 双页面 + 中文字体
界面扩展为两个 screen,右上角/右下角按钮切换(lv_screen_load_anim, 左进右出):
主页:标题 RA6W1 + Zephyr RTOS + 接线表 + clicks/按钮/圆弧
介绍页(全中文):硬件平台(左栏)+ Zephyr 移植进度(右栏,lv_label_set_recolor 内联 #00aa00 完成# / #ff8800 进行# /#cc0000 待定# 着色)
导航按钮放右下角(LV_ALIGN_BOTTOM_RIGHT):顶部居中的标题实际 比估算宽,放右上角会被压到。
中文字体:别用内置 CJK,自己用 lv_font_conv 裁子集
坑 1:内置 lv_font_source_han_sans_sc_16_cjk 只是演示子集。CMAP 是 1195 字的稀疏表(range_start=12527 + 偏移),开/发/板/线/储/摸 等常用字和全角标点 :() 都不在里面,显示出来一堆缺字。
坑 2:lv_font_conv 生成的字体一个字符都不显示。生成的字形是 RLE 压缩格式,LVGL 解码它需要CONFIG_LV_USE_FONT_COMPRESSED=y——没开就静默返回空位图。
正确做法(Windows 自带黑体,免下载):
cd /d/RA/RRQ61051/tools/fontconv # npm install lv_font_conv npx lv_font_conv --font /c/Windows/Fonts/simhei.ttf --size 16 --bpp 4 \ --format lvgl --lv-include lvgl.h --lv-font-name lv_font_simhei16 \ --range 0x20-0x7F --symbols "介绍返回开发板与移植进度..." \ -o app/lvgl_demo/src/lv_font_simhei16.c
--symbols 收集文案里出现的全部汉字和全角标点(重复无所谓)
子集只有几 KB(vs 内置字体 ~200KB),FLASH 从 519KB 降回 331KB
prj.conf 加 CONFIG_LV_USE_FONT_COMPRESSED=y,CMakeLists 把src/lv_font_simhei16.c 加进 target_sources,代码里LV_FONT_DECLARE(lv_font_simhei16) 后正常使用
文案加新字 → 重新生成一次即可
效果展示:


我要赚赏金
