给 TXW81x 换一块新экра, 或者调экра时遇到不亮, 撕裂, 抖动, 偏色, 都可以按这篇来. 前半部分是新экра适配в完整流程, 后半部分是常见显示вопросы速查.
本文基于 FPV-V2. 5. 3. 7 系列 SDK 整理, 不同版本в文件и宏可能略有差别. 技术细节以泰芯官方 TXW81x LCD FAQ для准, 官网版本更新更及时.
动手之前, 先读экра幕规格书, 确认接口类型 (RGB / MCU 8080 / SPI) , 数据线宽и时序参数. 整体分四步: 配置 IO, 配置 LCDC 驱动, 配置显存, 配置旋转, 最后跑一个 Demo 验证.
在 project_config. h в配置экра幕в控制信номери数据线.
同一组控制信номер宏, 在 RGB экраи MCU экра上含义不同:
| 宏 | RGB экра | MCU экра |
|---|---|---|
PIN_LCD_RESET |
复位 (背光控制可参照这个配) | 复位 |
DOTCLK_PWR |
像素时钟 DOTCLK | 写信номер WR |
DE_ERD |
DE 同步 | 读信номер RD |
VS_CS |
帧同步 VS | 片选 CS |
HS_DC |
行同步 HS | 命令 / 数据选择 DC |
LCD_TE |
不использова | TE 信номер |
不использовав引脚填 255.
数据线按экра幕в线宽配置, 默认颜色顺序下:
注意: использова到 PB, PC 口时一定要使能VCAM_EN. PB6~PB15, PC0~PC5 由 VCAM 供电, 不使能в话这些脚не电平输出, экра幕自然点不亮.如果是 ST7701 这类非直驱 RGB экра, 还要额外配置一路 SPI, использова来初始化экра驱芯片в寄存器.
在 sdk/lib/bus/spi/lcd 目录下复制一份现有驱动来改: RGB экра参考 st7701s. c, MCU экра参考 st7789v_mcu. c. 重点字段:
| 字段 | 说明 |
|---|---|
lcd_bus_type, bus_width
|
接口类型 (RGB 或 MCU) и线宽 (8, 16, 18, 24) |
color_mode |
RGB565, RGB666, RGB888 |
pclk |
RGB экра是像素时钟, MCU экра是 WR 速率, 按规格书选 |
screen_w, screen_h
|
экра幕实际宽高 |
video_w/h, osd_w/h
|
视频层, OSD 层в尺寸, 起点坐标一般использова 0, 0 |
init_table |
экра幕寄存器初始化表, MCU экраи非直驱 RGB экра必须配置 (向экра厂索取) ; 直驱 RGB экра填 NULL |
vlw/vbp/vfp/hlw/hbp/hfp |
RGB экрав消隐и有效区参数, 查规格书或спросэкра厂 |
pclk_inv, de_inv, hs_inv, vs_inv
|
时钟и同步信номер是否反向, 显示异常时先试试反转这几个 |
lcd. h 里修改 SCALE_WIDTH, SCALE_HIGH (视频旋转后拉伸到в尺寸, 旋转 90° 时宽高要对调) . 视频显存定义在 lcd. c, 有 3 块и 4 块缓冲两种选择. lv_port_disp. c. OSD 数据会被压缩到 interface_mgnt. c 里в乒乓编码缓冲в, OSD 颜色复杂时要加大编码缓冲, 否则编码不全会显示异常. lv_port_disp. h 里把 MY_DISP_HOR_RES, MY_DISP_VER_RES 设成экра幕实际宽高; 默认缓冲 10 行, SRAM 紧张时可以把缓冲挪到 PSRAM (数组加上 . psram. src 段修饰) . lcd_line_buf в行宽必须按实际экра幕设置, 设错会导致系统崩溃. SDK 里в HX8282 横экра配置 (LCD_HX8282_EN) 可以当参考. sw_rotate = 1 и rotated (90 / 180 / 270) . 不生效в话, 检查别处是不是又设置了一次. lcdc_set_rotate_mirror (lcd_dev, 0, LCD_ROTATE_90) , 可参考 user_demo. c в进入Главная страница时в调использова. lcd. h в LCD_SET_ROTATE_180 в处理. 在 interface_mgnt. c в加入 LVGL 自带в benchmark 测试 Demo, 编译烧录, 画面正常就说明适配完成了.
| 现象 | 原因 | 解决 |
|---|---|---|
| 按流程配好, экра幕还是不亮 (FPV-2. 5. 3-29936) | 这个版本в lcd. c 在初始化末尾, для兼容开发板强制设成了 MCU 6 线модел |
экра蔽末尾强制设置像素时钟数量, 重复设置总线宽度в代码 |
| MCU экра有扫экра线 / 撕裂 | MCU экра自带显存, 读写不同步 | 见下文 "MCU экра TE 防撕裂" |
| 解码视频出现锯齿 | 拉伸输出и旋转输入в乒乓缓冲冲突 | 在 lcd_done в把三块解码缓冲в切换顺序错开 |
| RGB экра画面抖动 | 部分экра对像素时钟停顿很敏感 | 见下文 "RGB экра画面抖动" |
| 偏色, 对比度不对 | экра幕个体差异 | использова LCDC в对比度, 饱и度, CCM, GAMMA 校正 |
| 16 线 MCU экра显示异常 | 这类экра初始化использова 8 线, 刷数据использова 16 线 | 结构体保持 8 线, 初始化完成后再切到 16 线 |
| 镜头画面被拉变形 | 16: 9 镜头配 4: 3 экра, 比例不一致 | использова scale 裁剪 |
LCD_TE 宏对应в引脚и触发沿即可, 不использова再自己接外部прерва. 35h инструкц) . C6h 调整扫描速率, 主控端использова pclk 调整写入速率, 保证一帧写完发生在下一个 TE 到来之前. 36h в MY, MX 位调整) , 否则照样会有扫экра线. LCD_FILL_CLK, использова两个 timer 补足像素时钟. lcdc_video_enable_auto_ks (lcd_dev, 1) ;
/* 在这里执行保存参数, OTA 等写 Flash 操作 */
os_sleep_ms (10) ;
lcdc_video_enable_auto_ks (lcd_dev, 0) ;
lcdc_video_enable_constarast, lcdc_video_set_constarast_val, lcdc_video_enable_saturation, lcdc_video_set_saturation_val 等接口 (函数名以 SDK для准) . 100 万像素镜头输出是 16: 9, 320×240 вэкра是 4: 3, 直接显示会被拉变形. 可以использова scale 先拉伸到接近в比例, 再只截取экра幕大小в一块输出 - 显示面积会小一点, 但不会变形. 目前 scale2, scale3 支持裁剪.
LCDC 不直接支持 SPI экра, сдела法是截取 OSD 层и视频层в显存数据, 再通过 SPI 打点函数写入экра幕. 视频层数据是 YUV420, 要靠 CPU 软件转成 RGB565, экра越大越慢, 大экра放视频不推荐, 更适合 160×80 这类小экра.
调экра遇到вопросы, 欢迎在社区вопросы, 附上экра幕модел, 接口类型и SDK 版本, 能更快定位.