gwin-skill/examples.md

示例：proj1 TFT 800×480 刷屏

目标

ACG525 + 芯路恒 TFT_V3.0（2×18）显示彩条；按键切红/绿/蓝满屏。

工程文件

工作区：fpga/proj1/

文件	作用
src/tft_top.v	顶层：分频、复位、模式、LED
src/lcd_driver.v	1056×525 时序
src/lcd_display.v	彩条/纯色
src/tft_top.cst	LCD/KEY/LED 约束
src/tft_top.sdc	50 MHz
build.tcl	run all
impl/pnr/proj1.fs	比特流

构建与下载

cd C:\Users\Administrator\Documents\fpga\gwin-skill
.\scripts\build_and_download.ps1 -ProjectDir ..\proj1

等价：

$gowin = "C:\Users\Administrator\Documents\fpga\tool-chain\Gowin\Gowin_V1.9.11.03_Education_x64"
$env:PATH = "$gowin\IDE\bin;$gowin\Programmer\bin;" + $env:PATH
cd C:\Users\Administrator\Documents\fpga\proj1
cmd /c "type build.tcl | gw_sh.exe"
programmer_cli.exe -d GW5A-25A --fsFile "$PWD\impl\pnr\proj1.fs" -r 2

预期现象

• 上电/下载后背光亮，出现彩条
• KEY0/1/2：红/绿/蓝满屏
• KEY5：复位
• LED 有心跳与模式指示

彩条方向说明

• 逻辑 lcd_x 递增对应扫描行方向；若屏上表现为「上下变色」，可用 lcd_y 分区做「左右竖条」，以目视为准微调 lcd_display.v
• 2×18 仅 RGB565，不要接不存在的 R[2:0] 等低位脚

Agent 复盘要点

1. 引脚来自 xlsx，不是官方 DK_START 手册
2. gw_sh 必须 pipe + 无 BOM
3. 下载成功日志含 Finished 与 Status Code
4. 供电与下载线分离要求见 SKILL.md