76 lines
2.3 KiB
Markdown
76 lines
2.3 KiB
Markdown
# gwin-skill
|
||
|
||
高云（Gowin）ACG525 / GW5A-25A 开发板 **全流程工具链 Skill 仓库**：设计规范、工程组织、CLI 综合、下载，以及如何让 Cursor Agent 按同一套流程操作。
|
||
|
||
**远程仓库：** https://git.whcself.xyz/FPGA-IQBoost/gwin-skill.git
|
||
|
||
## 谁该用
|
||
|
||
| 角色 | 入口 |
|
||
|------|------|
|
||
| 人类开发者 | 本文 + `scripts/` |
|
||
| Cursor Agent | **先读 [`SKILL.md`](SKILL.md)** |
|
||
| 其他 Agent / 自动化 | [`AGENTS.md`](AGENTS.md) |
|
||
|
||
## 仓库结构
|
||
|
||
```
|
||
gwin-skill/
|
||
├── SKILL.md # Agent 主指令（必读）
|
||
├── AGENTS.md # 多 Agent 协作约定
|
||
├── README.md # 本文件
|
||
├── design-spec.md # 设计规范
|
||
├── reference-pins.md # ACG525 / TFT 引脚
|
||
├── examples.md # TFT 刷屏端到端示例
|
||
├── scripts/ # 可执行脚本
|
||
│ ├── build.ps1
|
||
│ ├── build_and_download.ps1
|
||
│ ├── download.ps1
|
||
│ └── new_project.ps1
|
||
└── templates/ # 空工程模板
|
||
├── template.gprj
|
||
├── build.tcl
|
||
└── src/
|
||
├── top.v
|
||
├── top.cst
|
||
└── top.sdc
|
||
```
|
||
|
||
## 本机前置
|
||
|
||
1. 工作区示例：`Documents/fpga/`
|
||
2. 工具链：`tool-chain/Gowin/Gowin_V1.9.11.03_Education_x64/`（Education 即可）
|
||
3. 开发板 ACG525 已供电（DC 或 Type-C + 电源开关），下载线已连接
|
||
4. 可选：将本仓库安装到个人 skills：
|
||
|
||
```powershell
|
||
# junction / 复制均可
|
||
cmd /c mklink /J "%USERPROFILE%\.cursor\skills\gwin-skill" "C:\Users\Administrator\Documents\fpga\gwin-skill"
|
||
```
|
||
|
||
## 30 秒上手
|
||
|
||
```powershell
|
||
cd C:\Users\Administrator\Documents\fpga\gwin-skill
|
||
.\scripts\new_project.ps1 -Name blink -TargetDir ..\proj_blink
|
||
.\scripts\build_and_download.ps1 -ProjectDir ..\proj_blink
|
||
```
|
||
|
||
已有工程（如 `proj1`）：
|
||
|
||
```powershell
|
||
.\scripts\build_and_download.ps1 -ProjectDir ..\proj1
|
||
```
|
||
|
||
## 文档索引
|
||
|
||
- [SKILL.md](SKILL.md) — Agent 执行手册
|
||
- [design-spec.md](design-spec.md) — RTL / 约束 / 命名规范
|
||
- [reference-pins.md](reference-pins.md) — 时钟、按键、LED、LCD RGB565
|
||
- [examples.md](examples.md) — 800×480 TFT 刷屏复盘
|
||
- [AGENTS.md](AGENTS.md) — 如何让其他 agent 学会用
|
||
|
||
## 许可
|
||
|
||
随本地教学工程使用；高云 IDE / 器件相关商标归原厂所有。
|