# ESP32SLAVE

**Repository Path**: UF4DigitalPower/ESP32SLAVE

## Basic Information

- **Project Name**: ESP32SLAVE
- **Description**: 基于esp-host-mcu实现的WIFI OR BLE 协处理器
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-03
- **Last Updated**: 2026-09-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ESP32C6SLAVE

这是给 `ESP32-C6-WROOM-1-N4` 用的 `ESP-Hosted-MCU` slave 工程。它以 SPI Full-Duplex 方式作为上位机 MCU 的 Wi-Fi 协处理器。

工程基于 ESP-IDF 5.3.5。入口在 `CMakeLists.txt`，主代码在 `main/`，依赖配置记录在 `dependencies.lock`。构建产物位于 `build/`，不应提交到版本库。

## 默认接线

原理图里的 `WIFI_MOSI`、`WIFI_MISO`、`WIFI_SCLK`、`WIFI_NSS` 是主处理器/Host 的 SPI 网络名。ESP-Hosted 的 SPI 配置项也按 Host 视角命名，所以这里填写的是这些 Host 网络实际连接到 ESP32-C6 的 GPIO。

| Host 网络 | ESP-Hosted 配置含义 | ESP32-C6 GPIO |
|---|---|
| `WIFI_NSS` | Host CS | GPIO20 |
| `WIFI_SCLK` | Host SCLK | GPIO22 |
| `WIFI_MOSI` | Host MOSI，ESP32-C6 slave input | GPIO23 |
| `WIFI_MISO` | Host MISO，ESP32-C6 slave output | GPIO21 |
| `WIFI_DR` | DataReady，ESP32-C6 输出给 Host | GPIO19 |
| `WIFI_HS` | Handshake，ESP32-C6 输出给 Host | GPIO18 |
| Reset | EN | EN |

补充两点：

- `GPIO9/BOOT` 需要上拉，手动下载时拉低进下载模式。
- `GPIO8` 也建议上拉。
- 对接 STM32 时，SPI 要用 `Mode 3`。

## 目录说明

- `CMakeLists.txt`：工程入口
- `main/`：slave 代码
- `main/common/`：公共代码，已经放到工程里，编译时不用再单独找
- `sdkconfig.defaults.esp32c6`：C6 默认配置
- `partitions.esp32c6.csv`：分区表

## 从零开始编译

### 1. 准备环境

先装好 ESP-IDF。建议用 `5.3.5` 这一支，别用太旧的版本。

打开 ESP-IDF 的 PowerShell，或者先执行 ESP-IDF 自带的环境脚本，让 `idf.py` 能用。

如果你用 CLion，直接打开这个工程也行。工程入口里已经放了几个可改常量，后面如果你的 ESP-IDF 安装目录、Python venv 或工具链目录变了，只改 `CMakeLists.txt` 顶部那几行就够了。

### 2. 进入工程

切到这个目录：

```powershell
cd ESP32C6SLAVE
```

### 3. 设置目标芯片

```powershell
idf.py set-target esp32c6
```

### 4. 检查配置

工程里已经放了 `sdkconfig.defaults.esp32c6`，默认就是这套 SPI 引脚和 SPI Full-Duplex 配置。

如果你想自己看一眼：

```powershell
idf.py menuconfig
```

重点看这几项：

- `ESP SPI host interface`
- `SPI mode 3`
- `CS=20`
- `CLK=22`
- `MOSI=23`
- `MISO=21`
- `DataReady=19`
- `Handshake=18`

### 5. 编译

```powershell
idf.py build
```

正常情况下，编译结果会放在 `build` 目录里。

如果你看到 `project.cmake` 找不到，先检查 `ESP_IDF_ROOT`，它应该指向 ESP-IDF 根目录。

### 6. 首次下载

如果你用的是 CH343P 这类 USB 转串口芯片，接法就按下面来：

- `TXD -> ESP RXD0`
- `RXD -> ESP TXD0`
- `VIO -> 3V3`
- `GND -> GND`
- `EN` 通过 10k 上拉到 3V3，再接一个按键到 GND
- `BOOT/GPIO9` 通过 10k 上拉到 3V3，再接一个按键到 GND

下载时可以直接用：

```powershell
idf.py -p COMx flash monitor
```

把 `COMx` 换成你的串口号。

### 7. 只重新编译

如果你改了配置，先清一次再编：

```powershell
idf.py fullclean
idf.py build
```

## 备注

- 这个工程不是 SDIO 版本，是 SPI Full-Duplex 版本。
- 如果上位机是 STM32，`WIFI_HS` 要做输入，不要配成输出。
- 这个目录里不带 ESP-IDF 基础环境，只放工程本身。