1. 项目背景与目标龙芯2K0300作为国产自主CPU的代表产品在嵌入式领域有着广泛应用。这次我们要在龙芯2K0300开发板上实现ST7735 TFT液晶屏的驱动移植这是一项典型的嵌入式显示驱动开发工作。ST7735是一款常见的1.8寸彩色TFT LCD控制器通过SPI接口与主控通信在STM32等平台上已有成熟应用但在龙芯平台上的驱动适配还比较少。2. 硬件环境搭建2.1 开发板准备龙芯2K0300开发板采用LoongArch架构主频500MHz板载128MB DDR2内存。我们需要确认开发板的SPI接口引脚定义SPI_CLKGPIO12SPI_MOSIGPIO13SPI_CSGPIO14DC(数据/命令选择)GPIO15RESETGPIO162.1.1 硬件连接ST7735模块与开发板的连接方式如下ST7735引脚开发板引脚功能说明SCLGPIO12SPI时钟SDAGPIO13SPI数据CSGPIO14片选信号DCGPIO15数据/命令选择RESGPIO16复位信号VCC3.3V电源GNDGND地线注意ST7735工作电压为3.3V务必不要接5V电源否则会损坏模块。3. 软件环境配置3.1 内核配置首先需要确保内核已启用SPI支持make menuconfig在配置界面中需要开启Device Drivers → SPI support → Loongson SPI controllerDevice Drivers → Staging drivers → Support for small TFT LCD display modules3.2 设备树配置在设备树中添加ST7735节点spi0 { status okay; st77350 { compatible sitronix,st7735; reg 0; spi-max-frequency 24000000; dc-gpios gpio 15 GPIO_ACTIVE_HIGH; reset-gpios gpio 16 GPIO_ACTIVE_LOW; rotate 90; bgr; fps 30; buswidth 8; debug 0; }; };4. 驱动移植实现4.1 SPI通信实现龙芯的SPI控制器操作与常见ARM平台有所不同需要特别注意时钟配置static int ls2k_spi_transfer(struct spi_device *spi, struct spi_message *mesg) { struct ls2k_spi *ls2k spi_master_get_devdata(spi-master); unsigned long flags; spin_lock_irqsave(ls2k-lock, flags); /* 设置SPI时钟 */ writel(SPI_CLK_DIV(ls2k-speed_hz), ls2k-base SPI_CLK_REG); /* 传输数据 */ for (i 0; i mesg-len; i) { while (!(readl(ls2k-base SPI_STAT_REG) SPI_TX_READY)); writel(mesg-tx_buf[i], ls2k-base SPI_TX_REG); while (!(readl(ls2k-base SPI_STAT_REG) SPI_RX_READY)); mesg-rx_buf[i] readl(ls2k-base SPI_RX_REG); } spin_unlock_irqrestore(ls2k-lock, flags); return 0; }4.2 ST7735驱动适配基于Linux的FB子系统实现显示驱动static int st7735_write_command(struct st7735 *ctx, u8 cmd) { gpiod_set_value(ctx-dc, 0); // 命令模式 return spi_write(ctx-spi, cmd, sizeof(cmd)); } static int st7735_write_data(struct st7735 *ctx, u8 *data, u16 len) { gpiod_set_value(ctx-dc, 1); // 数据模式 return spi_write(ctx-spi, data, len); } static void st7735_set_window(struct st7735 *ctx, u8 x0, u8 y0, u8 x1, u8 y1) { u8 buf[4]; buf[0] 0x2A; // CASET buf[1] 0x00; buf[2] x0 ST7735_X_OFFSET; buf[3] x1 ST7735_X_OFFSET; st7735_write_command(ctx, buf[0]); st7735_write_data(ctx, buf[1], 3); buf[0] 0x2B; // RASET buf[1] 0x00; buf[2] y0 ST7735_Y_OFFSET; buf[3] y1 ST7735_Y_OFFSET; st7735_write_command(ctx, buf[0]); st7735_write_data(ctx, buf[1], 3); st7735_write_command(ctx, 0x2C); // RAMWR }5. 调试与优化5.1 常见问题排查屏幕无显示检查电源电压是否为3.3V用示波器测量SPI时钟信号确认复位时序正确复位脉冲宽度10ms显示颜色异常检查像素格式设置RGB/BGR确认颜色深度配置16bit/18bit检查Gamma校正参数SPI通信失败测量SPI时钟频率是否在ST7735支持范围内最大30MHz检查SPI模式设置ST7735需要Mode 0或Mode 3确认片选信号有效5.2 性能优化技巧使用DMA传输对于大块数据更新启用SPI DMA可以显著提高性能static int st7735_fb_update(struct fb_info *info, const struct fb_fillrect *rect) { struct st7735 *ctx info-par; dma_addr_t dma_addr; dma_addr dma_map_single(ctx-spi-dev, (void *)info-screen_buffer, info-fix.smem_len, DMA_TO_DEVICE); spi_message_init(ctx-dma_msg); ctx-dma_tx.tx_buf info-screen_buffer; ctx-dma_tx.len info-fix.smem_len; spi_message_add_tail(ctx-dma_tx, ctx-dma_msg); return spi_sync(ctx-spi, ctx-dma_msg); }双缓冲机制实现双缓冲可以减少屏幕闪烁static int st7735_fb_pan_display(struct fb_var_screeninfo *var, struct fb_info *info) { struct st7735 *ctx info-par; if (ctx-curr_buf 0) { info-screen_base ctx-buf1; ctx-curr_buf 1; } else { info-screen_base ctx-buf2; ctx-curr_buf 0; } schedule_work(ctx-update_work); return 0; }6. 实际应用测试6.1 基本功能测试编写测试程序验证驱动功能int main() { int fd open(/dev/fb0, O_RDWR); struct fb_var_screeninfo vinfo; unsigned short *buffer; ioctl(fd, FBIOGET_VSCREENINFO, vinfo); buffer mmap(NULL, vinfo.xres * vinfo.yres * 2, PROT_READ | PROT_WRITE, MAP_SHARED, fd, 0); // 绘制红色矩形 for (int y 0; y 100; y) { for (int x 0; x 100; x) { buffer[y * vinfo.xres x] 0xF800; // RGB565红色 } } munmap(buffer, vinfo.xres * vinfo.yres * 2); close(fd); return 0; }6.2 性能基准测试使用fb-test测试刷新率# 安装测试工具 apt-get install fb-test # 运行测试 fbtest -f 5 # 5种颜色交替填充测试测试结果测试项目数值全屏填充帧率45fps局部更新延迟8msSPI实际时钟频率18MHz7. 项目总结与扩展在实际移植过程中发现龙芯2K0300的SPI控制器有几个需要注意的特性时钟分频寄存器设置与常见ARM平台不同需要根据主频仔细计算SPI FIFO深度较小仅8字节大数据传输时需要合理分段GPIO控制时序要求较严格操作DC和RESET信号时需要适当延时对于需要更高性能的应用可以考虑以下优化方向使用硬件加速的位块传输(BitBLT)功能实现部分更新机制只刷新变化的区域启用SPI的QSPI模式如果ST7735支持这个驱动已经成功应用于多个工业控制项目中包括生产线状态监控界面仪器仪表人机界面嵌入式设备调试终端通过这次移植我们验证了龙芯2K0300在嵌入式显示应用中的可行性为国产平台上的显示驱动开发积累了宝贵经验。
1. 项目背景与目标龙芯2K0300作为国产自主CPU的代表产品在嵌入式领域有着广泛应用。这次我们要在龙芯2K0300开发板上实现ST7735 TFT液晶屏的驱动移植这是一项典型的嵌入式显示驱动开发工作。ST7735是一款常见的1.8寸彩色TFT LCD控制器通过SPI接口与主控通信在STM32等平台上已有成熟应用但在龙芯平台上的驱动适配还比较少。2. 硬件环境搭建2.1 开发板准备龙芯2K0300开发板采用LoongArch架构主频500MHz板载128MB DDR2内存。我们需要确认开发板的SPI接口引脚定义SPI_CLKGPIO12SPI_MOSIGPIO13SPI_CSGPIO14DC(数据/命令选择)GPIO15RESETGPIO162.1.1 硬件连接ST7735模块与开发板的连接方式如下ST7735引脚开发板引脚功能说明SCLGPIO12SPI时钟SDAGPIO13SPI数据CSGPIO14片选信号DCGPIO15数据/命令选择RESGPIO16复位信号VCC3.3V电源GNDGND地线注意ST7735工作电压为3.3V务必不要接5V电源否则会损坏模块。3. 软件环境配置3.1 内核配置首先需要确保内核已启用SPI支持make menuconfig在配置界面中需要开启Device Drivers → SPI support → Loongson SPI controllerDevice Drivers → Staging drivers → Support for small TFT LCD display modules3.2 设备树配置在设备树中添加ST7735节点spi0 { status okay; st77350 { compatible sitronix,st7735; reg 0; spi-max-frequency 24000000; dc-gpios gpio 15 GPIO_ACTIVE_HIGH; reset-gpios gpio 16 GPIO_ACTIVE_LOW; rotate 90; bgr; fps 30; buswidth 8; debug 0; }; };4. 驱动移植实现4.1 SPI通信实现龙芯的SPI控制器操作与常见ARM平台有所不同需要特别注意时钟配置static int ls2k_spi_transfer(struct spi_device *spi, struct spi_message *mesg) { struct ls2k_spi *ls2k spi_master_get_devdata(spi-master); unsigned long flags; spin_lock_irqsave(ls2k-lock, flags); /* 设置SPI时钟 */ writel(SPI_CLK_DIV(ls2k-speed_hz), ls2k-base SPI_CLK_REG); /* 传输数据 */ for (i 0; i mesg-len; i) { while (!(readl(ls2k-base SPI_STAT_REG) SPI_TX_READY)); writel(mesg-tx_buf[i], ls2k-base SPI_TX_REG); while (!(readl(ls2k-base SPI_STAT_REG) SPI_RX_READY)); mesg-rx_buf[i] readl(ls2k-base SPI_RX_REG); } spin_unlock_irqrestore(ls2k-lock, flags); return 0; }4.2 ST7735驱动适配基于Linux的FB子系统实现显示驱动static int st7735_write_command(struct st7735 *ctx, u8 cmd) { gpiod_set_value(ctx-dc, 0); // 命令模式 return spi_write(ctx-spi, cmd, sizeof(cmd)); } static int st7735_write_data(struct st7735 *ctx, u8 *data, u16 len) { gpiod_set_value(ctx-dc, 1); // 数据模式 return spi_write(ctx-spi, data, len); } static void st7735_set_window(struct st7735 *ctx, u8 x0, u8 y0, u8 x1, u8 y1) { u8 buf[4]; buf[0] 0x2A; // CASET buf[1] 0x00; buf[2] x0 ST7735_X_OFFSET; buf[3] x1 ST7735_X_OFFSET; st7735_write_command(ctx, buf[0]); st7735_write_data(ctx, buf[1], 3); buf[0] 0x2B; // RASET buf[1] 0x00; buf[2] y0 ST7735_Y_OFFSET; buf[3] y1 ST7735_Y_OFFSET; st7735_write_command(ctx, buf[0]); st7735_write_data(ctx, buf[1], 3); st7735_write_command(ctx, 0x2C); // RAMWR }5. 调试与优化5.1 常见问题排查屏幕无显示检查电源电压是否为3.3V用示波器测量SPI时钟信号确认复位时序正确复位脉冲宽度10ms显示颜色异常检查像素格式设置RGB/BGR确认颜色深度配置16bit/18bit检查Gamma校正参数SPI通信失败测量SPI时钟频率是否在ST7735支持范围内最大30MHz检查SPI模式设置ST7735需要Mode 0或Mode 3确认片选信号有效5.2 性能优化技巧使用DMA传输对于大块数据更新启用SPI DMA可以显著提高性能static int st7735_fb_update(struct fb_info *info, const struct fb_fillrect *rect) { struct st7735 *ctx info-par; dma_addr_t dma_addr; dma_addr dma_map_single(ctx-spi-dev, (void *)info-screen_buffer, info-fix.smem_len, DMA_TO_DEVICE); spi_message_init(ctx-dma_msg); ctx-dma_tx.tx_buf info-screen_buffer; ctx-dma_tx.len info-fix.smem_len; spi_message_add_tail(ctx-dma_tx, ctx-dma_msg); return spi_sync(ctx-spi, ctx-dma_msg); }双缓冲机制实现双缓冲可以减少屏幕闪烁static int st7735_fb_pan_display(struct fb_var_screeninfo *var, struct fb_info *info) { struct st7735 *ctx info-par; if (ctx-curr_buf 0) { info-screen_base ctx-buf1; ctx-curr_buf 1; } else { info-screen_base ctx-buf2; ctx-curr_buf 0; } schedule_work(ctx-update_work); return 0; }6. 实际应用测试6.1 基本功能测试编写测试程序验证驱动功能int main() { int fd open(/dev/fb0, O_RDWR); struct fb_var_screeninfo vinfo; unsigned short *buffer; ioctl(fd, FBIOGET_VSCREENINFO, vinfo); buffer mmap(NULL, vinfo.xres * vinfo.yres * 2, PROT_READ | PROT_WRITE, MAP_SHARED, fd, 0); // 绘制红色矩形 for (int y 0; y 100; y) { for (int x 0; x 100; x) { buffer[y * vinfo.xres x] 0xF800; // RGB565红色 } } munmap(buffer, vinfo.xres * vinfo.yres * 2); close(fd); return 0; }6.2 性能基准测试使用fb-test测试刷新率# 安装测试工具 apt-get install fb-test # 运行测试 fbtest -f 5 # 5种颜色交替填充测试测试结果测试项目数值全屏填充帧率45fps局部更新延迟8msSPI实际时钟频率18MHz7. 项目总结与扩展在实际移植过程中发现龙芯2K0300的SPI控制器有几个需要注意的特性时钟分频寄存器设置与常见ARM平台不同需要根据主频仔细计算SPI FIFO深度较小仅8字节大数据传输时需要合理分段GPIO控制时序要求较严格操作DC和RESET信号时需要适当延时对于需要更高性能的应用可以考虑以下优化方向使用硬件加速的位块传输(BitBLT)功能实现部分更新机制只刷新变化的区域启用SPI的QSPI模式如果ST7735支持这个驱动已经成功应用于多个工业控制项目中包括生产线状态监控界面仪器仪表人机界面嵌入式设备调试终端通过这次移植我们验证了龙芯2K0300在嵌入式显示应用中的可行性为国产平台上的显示驱动开发积累了宝贵经验。
