# CSI-P4-Baseboard

**Repository Path**: LitzJ/csi-p4-baseboard

## Basic Information

- **Project Name**: CSI-P4-Baseboard
- **Description**: ESP-CSI-Array S3芯片底板，用于承载多个C5板
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-06-10
- **Last Updated**: 2026-06-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# S3-BaseBoard

`S3-BaseBoard` 是当前多板 CSI 采集系统中的 ESP32-S3 汇聚端工程。

该工程运行在 S3 底板上，负责作为多个 ESP32-C5 采集节点的主控端，通过 SPI 总线完成设备发现、采集控制、CSI 数据读取、确认回收和本地落盘。S3 在系统中承担集中调度角色，用槽位管理多个 C5 节点，并将各节点上报的 CSI 帧整理为后续分析可用的数据文件。

## 职责范围

本工程只负责 S3 汇聚端能力：

- 作为 SPI Master 轮询多个 C5 Receiver。
- 完成设备发现、采集控制、CSI 数据读取和确认回收。
- 管理槽位状态、板卡身份和采集链路统计。
- 将 CSI 数据落盘为 CSV，并通过串口控制面配合 `tools/csi_tool` 使用。
- 不产生 ESP-NOW 触发包，不直接执行无线 CSI 采集。

完整系统分工见 [系统项目总览](../docs/technical/项目总览.md)。

## 构建入口

环境要求：

- ESP-IDF `v6.0.1`
- 目标芯片：ESP32-S3

在已激活 ESP-IDF 环境的终端中进入本目录后构建：

```powershell
idf.py build
```

主要代码入口：

- `main/app_main.c`
- `main/host_protocol_service.c`
- `main/sd_card_storage.c`
- `main/usb_cdc_host_link.c`
- [components/ad9508/](components/ad9508/README.md)

## 文档导航

- [S3-BaseBoard 开发规范](CONTRIBUTING.md)
- [系统项目总览](../docs/technical/项目总览.md)
- [SPI 链路与多 C5 汇聚协议设计](../docs/technical/SPI链路与多C5汇聚协议设计.md)
- [SD 卡 CSV 解析说明](../docs/technical/SD卡CSV解析说明.md)
- [C5 侧 SPI 问题排查说明](../docs/troubleshooting/C5侧SPI问题排查说明.md)
- [S3 串口交互协议](../tools/csi_tool/docs/串口交互协议.md)