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