93 lines
3.1 KiB
Markdown
93 lines
3.1 KiB
Markdown
|
# YNGJ-GT1-M (K1电吉他) 开发环境配置指南
|
|||
|
|
# MCU: AT32F403ARCT7 (雅特力 Cortex-M4F)
|
|||
|
|
# IDE: IAR Embedded Workbench for ARM 7.4+
|
|||
|
|
|
|||
|
|
## 工程入口
|
|||
|
|
|
|||
|
|
| 项目 | 路径 |
|
|||
|
|
|------|------|
|
|||
|
|
| 主程序 | `project/IAR_V7.4/YNGJ-GT1-M.eww` |
|
|||
|
|
| Bootloader | `AT32F403ARCT7_BOOT/project/IAR_V7.4/AT32F403ARCT7_BOOT.eww` |
|
|||
|
|
|
|||
|
|
## 需要安装的工具
|
|||
|
|
|
|||
|
|
### 1. IAR Embedded Workbench for ARM（必需，编译用）
|
|||
|
|
|
|||
|
|
本项目使用 **IAR EWARM 7.40+** 创建，建议使用 IAR 7.x 或 9.x。
|
|||
|
|
|
|||
|
|
1. 访问 [IAR 免费试用](https://www.iar.com/embedded-development-tools/free-trials)
|
|||
|
|
2. 选择 **IAR Embedded Workbench for Arm**，注册并下载安装包
|
|||
|
|
3. 安装时勾选 **ARM** 工具链
|
|||
|
|
4. 首次启动用邮件中的 License 激活（试用版 14 天 / 32KB 代码限制）
|
|||
|
|
|
|||
|
|
> 若原开发团队有正式 License，直接安装后导入 License 文件即可。
|
|||
|
|
|
|||
|
|
### 2. AT32 IAR Device Pack（必需，芯片支持）
|
|||
|
|
|
|||
|
|
1. 访问 [雅特力 AT32F403A 产品页](https://www.arterytek.com/cn/product/AT32F403A.jsp)
|
|||
|
|
2. 在 **工具与软件** 区域下载 **IAR_AT32MCU_AddOn**（或 IAR Pack）
|
|||
|
|
3. 运行安装程序，它会自动识别 IAR 安装路径
|
|||
|
|
4. 安装后 IAR 中应能看到 `ArteryTek AT32F403ARCT7`
|
|||
|
|
|
|||
|
|
参考文档：[AT32F403A/407 入门指南 (PDF)](https://www.arterytek.com/download/APNOTE/AN0023_AT32F403A_407_Get_started_guide_V2.0.5_ZH.pdf)
|
|||
|
|
|
|||
|
|
### 3. SEGGER J-Link 软件（必需，调试/下载）
|
|||
|
|
|
|||
|
|
工程调试器配置为 **J-Link + SWD**。
|
|||
|
|
|
|||
|
|
```powershell
|
|||
|
|
winget install NordicSemiconductor.JLink --accept-package-agreements --accept-source-agreements
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
安装后确认：
|
|||
|
|
```powershell
|
|||
|
|
JLink.exe -?
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 4. 调试硬件
|
|||
|
|
|
|||
|
|
- **J-Link** 调试器（或板载 J-Link OB）
|
|||
|
|
- 通过 **SWD** 接口连接 AT32F403ARCT7
|
|||
|
|
- 首次调试前在 IAR 中确认：Project → Options → Debugger → Driver = **J-Link/J-Trace**
|
|||
|
|
|
|||
|
|
## 打开与编译
|
|||
|
|
|
|||
|
|
1. 双击或用 IAR 打开 `project/IAR_V7.4/YNGJ-GT1-M.eww`
|
|||
|
|
2. 选择配置 **YNGJ-GT1-M**（Release/Debug）
|
|||
|
|
3. 菜单 **Project → Rebuild All**（或 F7 编译）
|
|||
|
|
|
|||
|
|
命令行编译（IAR 安装后）：
|
|||
|
|
```powershell
|
|||
|
|
& "C:\Program Files\IAR Systems\Embedded Workbench 9.5\common\bin\IarBuild.exe" `
|
|||
|
|
"project\IAR_V7.4\YNGJ-GT1-M.ewp" -build YNGJ-GT1-M -log all
|
|||
|
|
```
|
|||
|
|
> 路径按实际 IAR 版本调整。
|
|||
|
|
|
|||
|
|
## 调试步骤
|
|||
|
|
|
|||
|
|
1. J-Link 通过 USB 连接 PC，SWD 线连接目标板
|
|||
|
|
2. IAR 中按 **Ctrl+D** 进入调试（Download and Debug）
|
|||
|
|
3. 若提示找不到 Device Pack，回到步骤 2 安装 AT32 Pack
|
|||
|
|
4. 若提示 J-Link 未找到，检查 SEGGER 软件是否安装、驱动是否正常
|
|||
|
|
|
|||
|
|
## 环境检查脚本
|
|||
|
|
|
|||
|
|
在项目根目录运行：
|
|||
|
|
```powershell
|
|||
|
|
.\scripts\check-dev-env.ps1
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 常见问题
|
|||
|
|
|
|||
|
|
**Q: 打开工程提示找不到 AT32F403ARCT7？**
|
|||
|
|
→ 安装雅特力 IAR Pack（IAR_AT32MCU_AddOn）
|
|||
|
|
|
|||
|
|
**Q: 调试器连接失败？**
|
|||
|
|
→ 检查 SWD 接线、目标板供电、J-Link 驱动；IAR Debugger 选项选 J-Link
|
|||
|
|
|
|||
|
|
**Q: 工程里有 F:\IAR_WorkBench 旧路径？**
|
|||
|
|
→ 这是原开发机路径，安装 IAR 后 IAR 会自动更新；settings 目录已在 .gitignore 中忽略
|
|||
|
|
|
|||
|
|
**Q: 需要烧录 HEX 但不调试？**
|
|||
|
|
→ 使用雅特力 **AT-Link / ISP 工具**，或 J-Flash（J-Link 附带）
|