# CSI-C5-Receiver

**Repository Path**: LitzJ/csi-c5-receiver

## Basic Information

- **Project Name**: CSI-C5-Receiver
- **Description**: ESP-CSI-Array CSI数据接收端。基于ESP32C5。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-02
- **Last Updated**: 2026-07-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# C5-Receiver

`C5-Receiver` 是当前多板 CSI 汇聚方案中的 ESP32-C5 采集端工程。

该工程负责初始化 Wi-Fi 与 CSI 接收能力，过滤指定来源的无线帧，将采集到的 CSI 样本整理成 SPI 协议帧，并保存在本地保留窗口中，等待 S3 主控通过 SPI Slave 接口轮询读取。Receiver 是无线 CSI 数据进入系统的主要入口，向上承接 `C5-Send` 的触发包，向下对接 `S3-BaseBoard` 的统一汇聚流程。

## 职责范围

本工程只负责采集端能力：

- 接收目标无线帧并采集 CSI。
- 维护本地 CSI 帧保留窗口。
- 通过 SPI Slave 接口向 S3 暴露状态、配置和 CSI 帧数据。
- 接收 S3 下发的采集控制和 Receiver 配置。
- 不产生无线触发包，不负责多节点汇聚、CSV 落盘或上位机 GUI。

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

## 构建入口

环境要求：

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

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

```powershell
idf.py build
```

主要代码入口：

- `main/app_main.c`
- `main/c5_capture_control.c`
- `main/c5_frame_store.c`
- `main/c5_spi_slave_link.c`

## 文档导航

- [系统项目总览](../docs/technical/项目总览.md)
- [SPI 链路与多 C5 汇聚协议设计](../docs/technical/SPI链路与多C5汇聚协议设计.md)
- [CSI 数据格式与信道配置说明](../docs/technical/CSI数据格式与信道配置说明.md)
- [C5 侧 SPI 问题排查说明](../docs/troubleshooting/C5侧SPI问题排查说明.md)
- [CSI SPI 协议组件](../components/csi_protocol/README.md)