TFTDriver

English Notes | 文档索引

项目说明

TFTDriver 是一个把旧普中 TFT 演示驱动重新整理成可维护仓库的项目。

当前仓库的主线工作包括：

• 由 Codex 基于旧驱动包重写、拆分和整理代码结构
• 将原先偏 Keil4 的工程形态迁移到 SDCC + CMake + stcgal
• 保留旧工程常见 TFT 型号入口，并映射到新的 driver + panel profile 结构
• 在主仓内保留原始证据包 TFT.zip，其原始包名为 TFT_恢复文件名_解压_去重整理版.zip

重要声明

• 本仓库是公开源代码项目，但许可证为非商业使用许可，不属于 OSI 意义上的标准开源许可证
• 默认采用中文 README.md 作为主说明页
• 代码由旧资料重写、迁移和二次整理而来，不保证绝对可以使用
• 目前只有 HX8309 路线做过针对性的实机 bring-up 收敛
• 除 HX8309 外，其余控制器当前都不视为已完成实机验证

许可证

• 本项目采用 PolyForm Noncommercial 1.0.0
• 允许个人自由学习、使用、修改和分发非商业副本
• 禁止将本项目或其衍生版本用于商业用途
• 详见 LICENSE 与 NOTICE

当前包含的 TFT 型号

• ILI9225
• ILI9225B
• ILI9225C
• ILI9341
• ILI9340 compat
• ST7775R
• ST7775RV
• R61503B
• R61503U
• ST7781R
• R61509V
• ILI9325D
• HX8309
• ST7789S
• SSD1297
• HX8340B
• HX8357A
• S6D0144

详细入口映射见 doc/drivers_and_profiles.md。

当前主线特性

• HX8309 已补强为基于原始普中驱动证据的专用 bring-up 路径
• HX8309 明确走 parallel8080-16 / TFT_BUS_PORT_SPLIT_16
• shared 8080 backend 已支持连续 16-bit 数据流写入
• 读回诊断默认更保守，初始化主链路不依赖 RD 读 ID 成功
• 未显式固定命令宽度的公共路径按 uses_command8 + bus profile 做 8/16-bit 调取兼容

快速构建

cmake --preset stc89c52-text-portrait
cmake --build --preset stc89c52-text-portrait
cmake --preset assets-only
cmake --build --preset assets-only

常用工具

python .\fonttool.py --help
python .\pictool.py --help
python .\flash.py --help

仓库内容

• boards/: 板级引脚和总线映射
• drivers/: 控制器驱动与公共驱动层
• profiles/: 面板 profile 与旧宏兼容桥接
• src/ / include/: 公共总线、绘图、注册和兼容接口
• examples/: 基于新结构的示例工程
• doc/: 架构、驱动、构建与移植文档
• TFT.zip: 原始证据源压缩包，仓内文件名已简化

文档导航

• 架构说明
• 驱动与 Profile
• 构建与烧录
• 内存模型
• 字体工具
• 图片工具
• 示例说明
• 板级与移植