feat: 完善 MCU 芯片自动化测试架构

- 重构为三角色协作:人+Arch AI+执行AI
- 新增 Excel 寄存器表格解析工具,自动生成测试代码
- 新增串口日志分析工具,自动生成测试报告
- 完善项目文档:AGENTS.md、README.md
- 创建自动化测试架构设计文档
- 添加示例测试任务 P01-001
This commit is contained in:
tupingr
2026-05-27 10:44:55 +08:00
parent f041139ca8
commit 8157f10768
24 changed files with 1421 additions and 404 deletions
+32
View File
@@ -0,0 +1,32 @@
# 芯片资料
## 目录结构
```
docs/00_芯片资料/
├── registers/ # Excel 寄存器表格
│ ├── GPIO.xlsx # GPIO 寄存器定义
│ ├── UART.xlsx # UART 寄存器定义
│ └── ...
└── datasheet/ # 芯片手册
├── MCU_datasheet.pdf
└── ...
```
## 寄存器表格格式
Excel 表格包含以下字段:
| 字段 | 说明 |
|------|------|
| 寄存器名 | 寄存器名称 |
| 地址 | 寄存器地址 |
| 位 | 位位置 |
| 名称 | 位域名称 |
| 描述 | 位域描述 |
| 复位值 | 复位默认值 |
## 使用说明
1. 把芯片寄存器 Excel 表格放入 `registers/` 目录
2. 芯片手册放入 `datasheet/` 目录
3. Arch AI 会基于这些资料设计测试方案
@@ -0,0 +1,29 @@
# Excel 寄存器表格格式说明
## 表格列
Excel 表格需要包含以下列:
| 列名 | 说明 | 必填 | 示例 |
|------|------|------|------|
| 寄存器名 | 寄存器的宏定义名称 | 是 | GPIOA_MODER |
| 地址 | 寄存器物理地址 | 是 | 0x40020000 |
| 描述 | 寄存器功能描述 | 否 | GPIOA 模式寄存器 |
| 复位值 | 芯片复位后寄存器的值 | 否 | 0x00000000 |
## 示例数据
| 寄存器名 | 地址 | 描述 | 复位值 |
|----------|------|------|--------|
| GPIOA_MODER | 0x40020000 | GPIOA 模式寄存器 | 0xA8000000 |
| GPIOA_OTYPER | 0x40020004 | GPIOA 输出类型寄存器 | 0x00000000 |
| GPIOA_OSPEEDR | 0x40020008 | GPIOA 输出速度寄存器 | 0x00000000 |
| GPIOA_PUPDR | 0x4002000C | GPIOA 上拉/下拉寄存器 | 0x00000100 |
| GPIOA_IDR | 0x40020010 | GPIOA 输入数据寄存器 | N/A |
## 使用说明
1. 准备你的寄存器 Excel 表格
2. 命名为 `xxx_registers.xlsx`
3. 放入本目录 `docs/00_芯片资料/registers/`
4. 运行 `python3 shared/scripts/parse_registers.py` 解析