# testing

**Repository Path**: NetADs/testing

## Basic Information

- **Project Name**: testing
- **Description**: 测试仓库
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-11
- **Last Updated**: 2026-06-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ESP-IDF Test Project

基于 ESP-IDF v5.5.3 的 ESP32-S3 测试项目，集成 WiFi 配网与 STA 直连双模式功能。

## 硬件配置

- **芯片**: ESP32-S3
- **Flash**: 16MB
- **分区表**: 自定义分区（含 OTA 双分区）

## 项目结构

```
test/
├── main/
│   ├── CMakeLists.txt          # 主程序构建配置
│   └── main.c                  # 应用入口，调用 core_init()
├── components/
│   └── core/                   # 核心应用组件
│       ├── CMakeLists.txt      # 组件构建配置
│       ├── core.c              # 核心初始化（NVS、WiFi 等）
│       ├── include/
│       │   ├── core.h          # 核心模块头文件
│       │   └── wifi.h          # WiFi 模块头文件
│       └── wifi.c              # WiFi 双模式逻辑实现
├── partitions.csv              # 自定义分区表
├── sdkconfig.defaults          # 默认 Kconfig 配置
├── CMakeLists.txt              # 顶层项目构建文件
└── README.md                   # 本文件
```

## 依赖管理组件

项目使用 ESP-IDF 组件管理器，依赖以下托管组件：

- `esp_net_tools` — WiFi AP/STA/WebServer 统一封装
- `display` — 显示驱动
- `lvgl_ui` — LVGL UI 框架

## 功能说明

### WiFi 双模式

项目实现了智能 WiFi 配网流程：

1. **首次启动** — 无配网记录，自动进入 **AP 配网模式**
   - 创建 AP 热点
   - 启动 WebServer 配网页面
2. **配网成功** — 保存 SSID/密码到 NVS，自动重启
3. **后续启动** — 检测到已保存的配网信息，直接以 **STA 模式** 连接路由器

### 配网流程

```
首次上电 → 无 NVS 记录 → AP 模式（配网）
                ↓ 配网成功
           保存到 NVS → 重启
                ↓
后续上电 → 读取 NVS → STA 模式直连
```

## 构建与烧录

```bash
# 设置目标芯片
idf.py set-target esp32s3

# 编译
idf.py build

# 烧录并打开串口监视
idf.py -p COMx flash monitor
```

> **提示**: 如遇 GCC 编译错误，可尝试 `idf.py -j2 build` 降低并行度重试。