x78ne-bsp — x78NE DSP 板卡开发与自动测试工程

芯片: x78NE (C66x DSP) | 编译器: TI C6000 v8.2.2

本仓库是 x78NE 板卡的工程交付物：30 个外设测试模块源码、公共驱动库、电源控制与自动化测试脚本。 与 nudt-x78ne 技能、pnna 推理框架配套使用。

---

一、目录结构

x78ne-bsp/
├── common/src/            ← 公共驱动库（30+ 外设驱动 .c/.h）
├── power_ctrl/            ← 统一电源控制（E3634A，自包含）
├── 1_BOOT/ ~ 30_PCIE/     ← 29 个测试模块（源码 + CCS 工程 + 使用说明 .docx）
├── basic_test_runner.py   ← 基础功能测试执行器（UART + DSS 双监听）
├── power_test_runner.py   ← 功耗测试执行器（上电/监控/断电闭环）
├── run_all.py             ← 批量测试入口
├── build_all.py           ← 批量编译入口
├── check_env.py           ← 环境自检
├── jtag_cleanup.py        ← JTAG/电源清理工具
├── governance_guard.py    ← 执行前门禁（preflight/lint/state-check）
├── config.json.template   ← 环境配置模板（复制为 config.json 后填写）
└── manifest.json          ← 模块清单（模块事实权威源）

---

二、快速开始

# 1. 复制并填写环境配置（CCS 路径、ccxml、仿真器名、COM 口、电源 VISA 地址）
copy config.json.template config.json
notepad config.json

# 2. 环境自检
python check_env.py

# 3. 批量编译所有已自动化模块
python build_all.py

# 4. 跑单个模块测试（基础 / 功耗）
python basic_test_runner.py --module GPIO
python power_test_runner.py --module DDR

# 5. 批量跑测
python run_all.py

测试判定遵循 TESTAPP 协议：DSP 通过 printf 输出 TESTAPP:DSP0,STAGE:<name>,PASS/FAIL，Python 脚本解析判定。详见 references 技能或各模块使用说明 .docx。

---

三、环境要求

组件	版本/型号	说明
Windows	7/10/11 64bit	CCS v7 要求
CCS	v7	含 C6000 编译器 + DSS + gmake
C6000 编译器	8.2.2	-mv6600 --abi=eabi -g
Python	≥3.8	自动化脚本
pyvisa + pyvisa-py + pyserial	latest	电源控制 / 串口
DSP 仿真器	XDS560v2-USB	JTAG 调试
程控电源	KEYSIGHT E3634A	功耗监控

---

四、与技能 / 框架的配套关系

仓库	地址	作用	何时需要
nudt-x78ne skill	nudt_dsp/nudt_skill（npx skills add 安装）	板级开发 / 跑测 / 写新模块的「知识与流程」	让 AI 按规范干活
pnna	https://gitlink.org.cn/nudt_dsp/pnna.git	PNNA 神经网络推理框架源码	只有做 PNNA 推理任务才 clone
x78ne-bsp（本仓库）	https://gitlink.org.cn/nudt_dsp/x78ne-bsp.git	板卡工程 + 驱动库 + 自动化脚本	跑测 / 开发 x78NE 模块

pnna 与 x78ne-bsp 都要 clone 到工作区根目录（与 skill 平级），路径约定以 nudt-x78ne 技能的 SKILL.md 为准。

---

五、第三方依赖说明（按模块按需）

以下内容未随本仓库打包，跑对应模块时需单独获取：

模块	缺失依赖	说明
10_GMAC	TI NDK / SYSBIOS RTSC 包	协议栈构建依赖，需单独安装 TI 的 ndk / bios
29_1553B	CSL 库	芯片支持库
1_BOOT	bootgen6678V4.exe 等引导工具	BOOT 模块烧写工具
30_PCIE	测试位图 .bmp	PCIe 图像传输测试数据
依赖 DDR 初始化的模块	x78NE_autotest_project/x78NE_DDR_init	DDR 初始化程序（needs_ddr_init 模块用）

---

六、写新模块

按板卡规范（地址映射 / PSC / PLL / 中断）写新 DSP 模块时：

1. 读 nudt-x78ne 技能的 references/board/（驱动 API 索引 + 外设知识卡）。
2. 拷贝技能的 templates/dsp_module/ 工程骨架。
3. 调用本仓库 common/src 的驱动库实现测试逻辑。
4. 在 manifest.json 追加模块条目，build_all.py 编译、basic_test_runner.py 跑测验证。

完整流程见 nudt-x78ne 技能的 SKILL.md。