电子产品世界 » 论坛首页 » 企业专区 » Renesas » 瑞萨RA6W1基于zephyr移植LVGL

共1条 1/1 1 跳转至页

瑞萨RA6W1基于zephyr移植LVGL

高工
2026-11-15 16:05:09     打赏
LVGL 移植到 RA6W1 + ST7796S(LCD-PAR-S035)

状态:跑通。LVGL 简单界面(标题/圆弧动画/按钮计数)正常显示,颜色正确, SPI 20MHz。app:D:\luglZephyrproject\app\lvgl_demo。 前置依赖:SPI 驱动两个修复(笔记 41)、LCD 接线与显示栈(笔记 40)。

1. 硬件接线

信号引脚接点
SCKP1_10(SPI1 CLK)子板 J203-2
MOSIP1_11(SPI1 DO)子板 J203-4
CSP1_13(GPIO 27)子板 J203-8
D/CP0_11(GPIO 11)主板 J201-24(跳线 J201-24↔15)
RSTP0_12(GPIO 12)主板 J201-26(跳线 J201-26↔11)
VCC/GND3.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. 排障备忘(本次实际路径)

  1. 直接上官方 widgets demo → 确定性 HARD FAULT(垃圾函数指针跳进st7796s_get_capabilities)。以为是栈/堆不够,加栈无效。

  2. 换简单界面 → 崩在堆分配器(alloc_chunk freelist 里是 flash 指针)。

  3. 开 CONFIG_ASSERT_LEVEL=2 + CONFIG_SYS_HEAP_VALIDATE=y → 断言定位到 LVGL 私有 sys_heap 第一次分配就坏。

  4. 读 LVGL 胶水源码发现 lvgl_init 对 deferred-init 的 display 直接 -ENODEV 早退 → 根因(坑 1)。删 deferred-init 即亮。

  5. 颜色错 → 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) 后正常使用

  • 文案加新字 → 重新生成一次即可

效果展示:

9ed8b3fc0953f99ca22400c4a4e388a7.jpg

5e9d2e81c07a0104a2e287daa6859a77.jpg




关键词: RA6W1     zephyr     LCD     LVGL    

共1条 1/1 1 跳转至页

回复

匿名不能发帖!请先 [ 登陆 注册 ]