告别点不亮！手把手教你为100ASK T113-S3核心板配置SPI接口并驱动ILI9341屏幕

告别点不亮手把手教你为100ASK T113-S3核心板配置SPI接口并驱动ILI9341屏幕在嵌入式开发中驱动一块SPI屏幕往往是最令人兴奋也最令人沮丧的体验之一。兴奋的是终于能让硬件开口说话沮丧的是当屏幕固执地保持一片空白时那种无从下手的迷茫。本文将带你深入全志T113-S3芯片的SPI接口世界从硬件引脚定义到内核驱动适配完整呈现一个自制载板上点亮ILI9341屏幕的全过程。1. 硬件设计从芯片手册到实际电路1.1 解读T113-S3的SPI引脚配置全志T113-S3芯片提供了多个SPI控制器接口但并非所有引脚都能随意使用。查阅芯片手册第4章Pin Multiplexing部分我们可以找到SPI1对应的引脚功能映射引脚名称功能4 (SPI1)功能说明PD10SPI1_CS0片选信号PD11SPI1_CLK时钟信号PD12SPI1_MOSI主设备输出从设备输入PD13SPI1_MISO主设备输入从设备输出PD14SPI1_HOLD保持信号PD15SPI1_WP写保护信号关键点必须确保这些引脚没有被其他功能占用驱动电流建议设置为10mAdrive-strength 10CS引脚需要上拉电阻bias-pull-up1.2 自制载板的电路设计要点在自制载板上布局这些引脚时需要考虑以下实际因素信号完整性SPI时钟线CLK应尽量短且远离其他高频信号在长距离布线时10cm建议串联33Ω电阻进行阻抗匹配ILI9341的额外控制线-------------------------------- | ILI9341引脚 | T113-S3连接建议 | -------------------------------- | DC (数据/命令) | 任意GPIO如PD16| | RESET | 任意GPIO如PD17 | | VCC | 3.3V电源 | | GND | 共同地线 | --------------------------------电源设计为降低噪声建议在3.3V电源和地之间放置100nF去耦电容如果屏幕背光需要单独供电需确认电流需求典型值约20mA提示使用万用表连续模式检查所有连接的通断性可以避免后续调试时的硬件连接问题。2. 设备树配置硬件与软件的桥梁2.1 SPI控制器节点配置在Linux设备树中正确配置SPI控制器是驱动工作的基础。以下是针对T113-S3的SPI1节点配置示例pio { spi1_pins_a: spi10 { pins PD11, PD12, PD13, PD14, PD15; function spi1; drive-strength 10; }; spi1_pins_b: spi11 { pins PD10; function spi1; drive-strength 10; bias-pull-up; // 只有CS需要上拉 }; lcd_dc: lcd_dc { allwinner,pins PD16; }; lcd_rst: lcd_rst { allwinner,pins PD17; }; }; spi1 { pinctrl-names default, sleep; pinctrl-0 spi1_pins_a spi1_pins_b; pinctrl-1 spi1_pins_c; status okay; ili93410 { compatible ilitek,ili9341; reg 0; spi-max-frequency 32000000; dc-gpios pio 3 16 GPIO_ACTIVE_HIGH; // PD16 reset-gpios pio 3 17 GPIO_ACTIVE_HIGH; // PD17 rotate 90; spi-cpol; spi-cpha; bgr; fps 30; buswidth 8; status okay; }; };2.2 关键参数解析spi-max-frequencyILI9341的最大SPI时钟为32MHz但实际稳定工作频率可能需要根据布线质量调整rotate设置屏幕旋转角度90/180/270度spi-cpol/spi-cpha必须与屏幕规格书要求的SPI模式一致通常为模式3bgr颜色顺序RGB或BGR设置错误会导致颜色显示异常3. 内核驱动适配与调试3.1 使能ILI9341驱动在Linux 5.4内核中ILI9341驱动位于 staging 目录下需要按以下步骤启用make menuconfig导航至Device Drivers → Staging drivers → Support for small TFT LCD display modules → * FB driver for the ILI9341 LCD controller或者直接搜索/ ili9341快速定位。3.2 高版本内核兼容性修改由于内核API的变化原始驱动可能需要以下关键修改才能正常工作fbtft-core.c 头文件添加#include linux/gpio.h #include linux/of_gpio.hGPIO请求函数重写static int fbtft_request_one_gpio(struct fbtft_par *par, const char *name, int index, struct gpio_desc **gpiop) { struct device *dev par-info-device; struct device_node *node dev-of_node; int gpio, flags, ret 0; enum of_gpio_flags of_flags; if (of_find_property(node, name, NULL)) { gpio of_get_named_gpio_flags(node, name, index, of_flags); if (gpio -ENOENT) return 0; if (gpio -EPROBE_DEFER) return gpio; if (gpio 0) { dev_err(dev, failed to get %s from DT\n, name); return gpio; } flags (of_flags OF_GPIO_ACTIVE_LOW) ? GPIOF_OUT_INIT_LOW : GPIOF_OUT_INIT_HIGH; ret devm_gpio_request_one(dev, gpio, flags, dev-driver-name); if (ret) { dev_err(dev, gpio_request_one(%s%d) failed with %d\n, name, gpio, ret); return ret; } *gpiop gpio_to_desc(gpio); } return ret; }重置时序调整static void fbtft_reset(struct fbtft_par *par) { if (!par-gpio.reset) return; gpiod_set_value_cansleep(par-gpio.reset, 1); msleep(10); gpiod_set_value_cansleep(par-gpio.reset, 0); msleep(200); // 确保足够的复位时间 gpiod_set_value_cansleep(par-gpio.reset, 1); msleep(10); }4. 系统集成与功能验证4.1 启动日志分析成功加载驱动后通过dmesg应该能看到类似输出[ 4.950907] graphics fb0: fb_ili9341 frame buffer, 320x240, 150 KiB video memory [ 4.958312] fbtft_of_value: buswidth 8 [ 4.962445] fbtft_of_value: rotate 90 [ 4.966588] fbtft_of_value: fps 30如果缺少这些信息可能的问题包括设备树节点未被正确解析SPI通信失败检查接线和引脚配置屏幕电源不稳定4.2 基本功能测试随机颜色填充测试cat /dev/urandom /dev/fb0使用fb-test工具fb-test # 显示颜色渐变 fb-test-rect # 显示移动矩形框性能测试time dd if/dev/zero of/dev/fb0 bs1M count1正常情况下的传输速率应达到2MB/s以上。4.3 常见问题排查现象1屏幕背光亮但无显示检查SPI时钟极性cpol/cpha设置验证reset和dc信号时序尝试降低SPI频率如改为10MHz现象2显示内容错乱确认颜色格式bgr参数检查屏幕旋转方向设置验证总线宽度buswidth是否与硬件匹配现象3间歇性显示异常检查电源稳定性示波器观察3.3V纹波缩短SPI线缆长度或增加终端电阻确保地线连接良好