# ESP32-C3

**Repository Path**: daweicheng2134/esp32-c3

## Basic Information

- **Project Name**: ESP32-C3
- **Description**: 通过 Web 页面或物理按键控制 ESP32-C3 板载蓝灯，支持常亮、关闭、呼吸灯三种模式和亮度调节。所有配置自动保存到 NVS，断电重启后自动恢复。


- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-15
- **Last Updated**: 2026-06-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ESP32-C3 LED Server

通过 Web 页面或物理按键控制 ESP32-C3 板载蓝灯，支持常亮、关闭、呼吸灯三种模式和亮度调节。所有配置自动保存到 NVS，断电重启后自动恢复。

## 功能

- WiFi AP 模式（SSID: `32C3`）
- Web 控制面板（暗色主题 Dashboard）
- BOOT 按键物理切换
- LED 呼吸灯效果（二次曲线，4s 周期）
- 亮度调节（0~100% 滑块）
- 模式/亮度持久化（Preferences NVS）

## 引脚

| 引脚 | 功能 |
|------|------|
| GPIO 8 | 板载蓝色 LED（低电平点亮，PWM） |
| GPIO 9 | BOOT 按键（INPUT_PULLUP，按下 LOW） |

## Web API

| 路由 | 说明 |
|------|------|
| `GET /` | 控制面板（暗色主题，含亮度滑块） |
| `GET /on` | 常亮（使用当前亮度） |
| `GET /off` | 关闭 |
| `GET /breath` | 呼吸灯（使用当前亮度） |
| `GET /status` | JSON `{"mode":"on","brightness":80}` |
| `GET /set?brightness=N` | 设置亮度 0~100，自动持久化 |

`/status` 返回 JSON，前端据此高亮当前模式按钮。

## 按键操作

短按 BOOT 键循环切换：`关闭 → 常亮 → 呼吸灯 → 关闭`

## 编译上传

```bash
arduino-cli compile --fqbn esp32:esp32:esp32c3 .
arduino-cli upload --fqbn esp32:esp32:esp32c3 --port /dev/cu.usbmodemXXXX .
arduino-cli monitor --fqbn esp32:esp32:esp32c3 --port /dev/cu.usbmodemXXXX --config baudrate=115200
```

接入 WiFi 后浏览器打开 `192.168.4.1` 即可控制。