RT1170 LCDIFv2 驱动并口屏实操：从配置到点亮全流程

• 参数说明：
  • 屏幕分辨率：480（宽）×272（高）；
  • 同步参数（来自屏手册）：HSW（行同步宽度）=10、HFP（行前肩）=4、HBP（行后肩）=2；VSW（场同步宽度）=41、VFP（场前肩）=4、VBP（场后肩）=18；
  • 刷新率：60Hz；
• 计算结果：(480+10+4+2)×(272+41+4+18)×60≈9.2MHz
• 实际配置：通过 ConfigTool 将像素时钟设为最接近的 9.3MHz。

（3）ConfigTool 时钟配置步骤

1. 打开 ConfigTool 的 “Clock Configuration”；
2. 启用 PLL5：设置 PLL5 主频率为 744MHz，分频系数配置为：
   • PLL5_POST_DIV=4 → 744MHz÷4=186MHz；
   • 再经 10 分频 → 186MHz÷20=9.3MHz（像素时钟）；
3. 配置 VIDEO_MUX：选择 LCDIFv2 作为并行显示输出；
4. 启用 LCDIFv2 时钟：确保 LCDIFv2_CLKROOT 时钟使能。

步骤 3：背光与复位初始化

（1）背光控制（GPIO 输出）

#include "fsl_gpio.h"

#define LCD_BL_GPIO GPIO2
#define LCD_BL_GPIO_PIN 31

void BOARD_InitBacklight(void) {
    gpio_pin_config_t bl_config = {
        kGPIO_DigitalOutput,  // 输出模式
        1,                    // 初始电平高（点亮背光）
        kGPIO_NoIntmode       // 无中断
    };
    GPIO_PinInit(LCD_BL_GPIO, LCD_BL_GPIO_PIN, &bl_config);
}

（2）屏幕复位（可选）

#define LCD_RST_GPIO GPIO1
#define LCD_RST_GPIO_PIN 2

void BOARD_ResetLcdPanel(void) {
    gpio_pin_config_t rst_config = {
        kGPIO_DigitalOutput,
        0,  // 复位电平低
        kGPIO_NoIntmode
    };
    GPIO_PinInit(LCD_RST_GPIO, LCD_RST_GPIO_PIN, &rst_config);
    
    GPIO_PinWrite(LCD_RST_GPIO, LCD_RST_GPIO_PIN, 0);  // 拉低复位
    SDK_DelayAtLeastUs(10000, CLOCK_GetCoreSysClkFreq());  // 延时10ms
    GPIO_PinWrite(LCD_RST_GPIO, LCD_RST_GPIO_PIN, 1);  // 释放复位
}

步骤 4：LCDIFv2 接口初始化

（1）定义时序与显示参数（宏定义）

// 屏幕参数（来自屏手册）
#define DEMO_PANEL_WIDTH  480    // 屏幕宽度
#define DEMO_PANEL_HEIGHT 272   // 屏幕高度
#define DEMO_HSW          10     // 行同步宽度
#define DEMO_HFP          4      // 行前肩
#define DEMO_HBP          2      // 行后肩
#define DEMO_VSW          41     // 场同步宽度
#define DEMO_VFP          4      // 场前肩
#define DEMO_VBP          18     // 场后肩
#define DEMO_LCDIF_POL_FLAGS (kELCDIF_HsyncActiveLow | kELCDIF_VsyncActiveLow)  // 同步信号极性
#define DEMO_LCDIF        LCDIF2  // 使用LCDIFv2模块

（2）LCDIFv2 配置结构体与初始化代码

#include "fsl_lcdifv2.h"

// 帧缓冲（需分配在可访问内存区域，示例使用24位RGB888格式）
static uint32_t s_frameBuffer[DEMO_PANEL_HEIGHT][DEMO_PANEL_WIDTH] __attribute__((aligned(64)));

// LCDIFv2配置结构体
static const dc_fb_lcdifv2_config_t s_lcdifv2Config = {
    .lcdifv2 = DEMO_LCDIF,
    .width = DEMO_PANEL_WIDTH,
    .height = DEMO_PANEL_HEIGHT,
    .hsw = DEMO_HSW,
    .hfp = DEMO_HFP,
    .hbp = DEMO_HBP,
    .vsw = DEMO_VSW,
    .vfp = DEMO_VFP,
    .vbp = DEMO_VBP,
    .polarityFlags = DEMO_LCDIF_POL_FLAGS,
    .lineOrder = kLCDIFV2_LineOrderRGB,  // RGB顺序
    .domain = 0,  // Cortex-M7核心对应domain 0（M4为1）
};

// 初始化LCDIFv2接口
status_t BOARD_InitLCDIFv2(void) {
    status_t status;
    
    // 启用VIDEO_MUX时钟
    CLOCK_EnableClock(kCLOCK_Video_Mux);
    
    // 配置VIDEO_MUX选择LCDIFv2输出
    VIDEO_MUX->VID_MUX_CTRL.SET = VIDEO_MUX_VID_MUX_CTRL_PARA_LCD_SEL_MASK;
    
    // 初始化LCDIFv2
    status = LCDIFV2_RgbModeInit(DEMO_LCDIF, &s_lcdifv2Config);
    if (status != kStatus_Success) {
        return status;
    }
    
    // 设置帧缓冲地址
    LCDIFV2_SetFrameBufferAddr(DEMO_LCDIF, (uint32_t)s_frameBuffer);
    
    // 启用LCDIFv2输出
    LCDIFV2_Enable(DEMO_LCDIF, true);
    
    return kStatus_Success;
}

步骤 5：帧缓冲填充与显示验证

// 填充帧缓冲为红色（RGB888格式：0xFF0000）
void APP_FillFrameBufferRed(void) {
    for (uint32_t y = 0; y < DEMO_PANEL_HEIGHT; y++) {
        for (uint32_t x = 0; x < DEMO_PANEL_WIDTH; x++) {
            s_frameBuffer[y][x] = 0xFF0000;  // 红色
        }
    }
}

// 主函数调用流程
int main(void) {
    // 初始化系统时钟（含LCDIFv2时钟）
    BOARD_InitBootClocks();
    
    // 初始化引脚（LCDIFv2 + 背光 + 复位）
    BOARD_InitPins();
    BOARD_ResetLcdPanel();
    BOARD_InitBacklight();
    
    // 初始化LCDIFv2接口
    BOARD_InitLCDIFv2();
    
    // 填充帧缓冲并显示
    APP_FillFrameBufferRed();
    
    while (1) {
        // 循环刷新（若需动态显示，可在此更新帧缓冲）
    }
}

4. 关键避坑事项

1. 时序参数匹配：必须严格按照并口屏数据手册配置 HSW/HFP/HBP/VSW/VFP/VBP，参数错误会导致显示花屏或无显示；
2. 像素时钟精准度：像素时钟偏差过大会导致显示模糊，建议通过 ConfigTool 微调分频系数，接近计算值；
3. VIDEO_MUX 配置：需确保 VIDEO_MUX 选择 LCDIFv2 输出，而非 eLCDIF，否则接口无数据输出；
4. 帧缓冲地址对齐：帧缓冲需按 64 字节对齐，避免 DMA 传输错误；
5. 同步信号极性：多数并口屏的 HSYNC/VSYNC 为低电平有效，需在polarityFlags中正确配置，否则无法同步。

5. 进阶优化：多层显示与 DMA 刷新

5.1 多层混合显示

// 前景层帧缓冲
static uint32_t s_foregroundBuffer[DEMO_PANEL_HEIGHT][DEMO_PANEL_WIDTH] __attribute__((aligned(64)));

// 配置多层显示
LCDIFV2_SetLayerFrameBufferAddr(DEMO_LCDIF, 1, (uint32_t)s_foregroundBuffer);  // 层1（前景）
LCDIFV2_SetLayerEnable(DEMO_LCDIF, 1, true);  // 启用前景层

5.2 DMA 自动刷新

// 配置DMA传输
lcdifv2_dma_config_t dmaConfig = {
    .enable = true,
    .burstLength = kLCDIFV2_DmaBurstLength16Beats,  // 突发长度16拍
};
LCDIFV2_ConfigDma(DEMO_LCDIF, &dmaConfig);