Initial gwin-skill: Gowin ACG525 full toolchain skill for agents.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Administrator
2026-09-14 20:18:41 +08:00
co-authored by Cursor
commit 1b1a68ae28
16 changed files with 765 additions and 0 deletions
+55
View File
@@ -0,0 +1,55 @@
# 示例: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` | 比特流 |
## 构建与下载
```powershell
cd C:\Users\Administrator\Documents\fpga\gwin-skill
.\scripts\build_and_download.ps1 -ProjectDir ..\proj1
```
等价:
```powershell
$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