# ai_soc_sw

hwd32h757 MCU 芯片成片测试及 SDK 开发项目。

## 项目信息

| 项目 | 值 |
|------|-----|
| 芯片代号 | hwd32h757 |
| 内核 | Cortex-M7 |
| 项目阶段 | Chip bring-up（回片测试） |
| 仓库 | https://gitcode.com/tupingr/ai_soc_sw.git |

## 核心产出

1. **寄存器功能测试** — 33 个功能单元的全面扫描
2. **SDK 框架** — HAL/LL 双层驱动（参考 STM32CubeH7）
3. **勘误记录** — 结构化硅缺陷追踪

## 协作模式

1 人 + Arch AI + Worker AI，详见 [AGENTS.md](AGENTS.md)。

## 目录结构

```
ai_soc_sw/
├── AGENTS.md                  # AI 角色定义与权限约定
├── dashboard.md               # 项目控制面板
├── DECISIONS.md               # 待决策事项
├── ENVIRONMENT.md             # 开发环境配置
├── .ai/                       # AI 协作核心
│   ├── principles.md          # 设计原则
│   ├── roles/                 # AI 角色身份卡
│   ├── tasks/                 # 任务文件
│   ├── phases/                # 阶段上下文
│   └── knowledge/             # 知识沉淀（ADR/教训/模式）
├── Drivers/                   # SDK 驱动层
│   ├── CMSIS/                 # ARM CMSIS + 设备文件
│   ├── HWD32H757_HAL_Driver/ # HAL + LL 驱动
│   └── BSP/                   # 板级支持包
├── Test/                      # 寄存器测试
│   ├── framework/             # 测试框架
│   ├── cases/                 # 33 个功能单元
│   └── errata/                # 勘误记录
├── Tools/                     # 自动化工具
├── docs/                      # 项目文档
└── Projects/                  # 示例工程
```

## 快速开始

见 [ENVIRONMENT.md](ENVIRONMENT.md)。