# Proposal: CH32V307 固件系统软件设计文档

## Why

项目已完成核心功能开发，但缺乏系统级软件设计文档：内部无法快速理解任务拓扑和状态机逻辑，外部对接方缺乏集成参考。当前文档仅覆盖配置和协议层面，未形成完整的设计视图。

## What Changes

- 新增 **系统总览文档**：FreeRTOS 任务拓扑（任务职责、优先级、通信方式）、2D/1D 双状态机完整流程图、网络栈初始化与运行流程
- 新增 **DVP 采集模块设计文档**：DVP 硬件配置原理、DMA ping-pong 机制、IRQ 帧组装逻辑、FrameBuffer 数据格式
- 新增 **QDX 协议模块设计文档**：TLV 帧结构、所有 Type 定义与用途、零拷贝 TX 缓冲区架构、分片机制
- 新增 **TCP 通信模块设计文档**：双流（5511 控制 / 5512 数据）连接管理、心跳机制、配置下发与缓存、数据发送队列
- 新增 **对接集成文档**：供上位机/ConfigServer 开发方参考的接入指南（握手流程、配置下发、数据帧解析、错误码）

## Capabilities

### New Capabilities
- `system-overview`: FreeRTOS 任务拓扑、2D 状态机、1D 状态机、系统启动序列
- `dvp-module-design`: DVP 硬件初始化、DMA ping-pong 行采集、帧组装、FrameBuffer 格式
- `qdx-protocol-design`: TLV 帧格式、Class/Type 定义、零拷贝 TX 架构、CRC、分片
- `tcp-module-design`: 双流连接管理、心跳、配置缓存、发送队列
- `integration-guide`: 外部对接方集成手册（握手、配置、数据解析、错误处理）

### Modified Capabilities

（无，本变更仅新增文档，不修改现有规范）

## Impact

- **新增文档目录**：`Doc/设计文档/` 或各模块独立文件
- **不涉及**任何代码修改
- 影响范围：内部开发参考、外部对接方（ConfigServer 开发团队）