# 基于esp-idf和TARE开发的esp32cam项目

**Repository Path**: ucanner/uesp

## Basic Information

- **Project Name**: 基于esp-idf和TARE开发的esp32cam项目
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-19
- **Last Updated**: 2026-03-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ESP32-CAM 项目

## 项目简介

这是一个基于 ESP-IDF 5.4.3 框架开发的 ESP32-CAM AI-Thinker 项目，实现了以下功能：

- WiFi 自动连接
- HTTP 服务器（端口 80）
- MJPEG 视频实时推流
- 系统信息查询
- 立即拍照上传
- 定时拍照上传

## 硬件要求

- ESP32-CAM AI-Thinker 开发板
- 4MB PSRAM
- 至少 2MB 闪存

## 软件要求

- ESP-IDF 5.4.3
- CMake 构建系统

## 配置说明

### WiFi 配置
- SSID: GZF_KT
- 密码: 01234567890
- 模式: STA 客户端模式

### 拍照上传配置
- 上传地址: 在 `main.c` 文件中的 `UPLOAD_URL` 宏定义中设置
- 拍照间隔: 默认 3600 秒（1小时），可通过 HTTP 接口修改
- 照片分辨率: SVGA (800x600)
- JPEG 质量: 12

### 分区表配置
- 使用大分区表: Single factory app (large)

### PSRAM 配置
- 启用 4MB PSRAM

## 项目结构

```
├── CMakeLists.txt          # 项目根目录 CMake 配置
├── main/
│   ├── CMakeLists.txt      # 主目录 CMake 配置
│   ├── main.c              # 主程序文件
│   └── camera_pins.h       # 摄像头引脚定义
├── sdkconfig               # 项目配置文件
└── README.md               # 本文档
```

## HTTP 接口

### 1. 视频流接口
- **URL**: `/stream`
- **方法**: GET
- **返回**: MJPEG 视频流

### 2. 系统信息接口
- **URL**: `/info`
- **方法**: GET
- **返回**: JSON 格式的系统信息
- **示例返回**:
  ```json
  {
    "ip": "192.168.1.100",
    "ssid": "GZF_KT",
    "rssi": -65,
    "free_heap": 100000,
    "min_free_heap": 80000,
    "idf_version": "5.4.3",
    "uptime": 3600,
    "flash_size": 2097152
  }
  ```

### 3. 立即拍照接口
- **URL**: `/capture`
- **方法**: GET
- **功能**: 立即拍摄一张照片并上传
- **返回**: JSON 格式的操作结果

### 4. 设置拍照间隔接口
- **URL**: `/set_interval?sec=秒数`
- **方法**: GET
- **参数**: `sec` - 拍照间隔（秒）
- **返回**: JSON 格式的操作结果

## 编译和烧录

### 编译
```bash
idf.py build
```

### 烧录
```bash
idf.py flash
```

### 查看串口输出
```bash
idf.py monitor
```

## 注意事项

1. 请确保在 `main.c` 文件中设置正确的上传地址 `UPLOAD_URL`
2. 首次启动时，ESP32-CAM 会自动连接到配置的 WiFi 网络
3. 串口会输出 WiFi 连接状态、IP 地址、信号强度和 MAC 地址
4. 项目已启用 PSRAM 和大分区表，适合长期运行
5. 视频流和拍照功能会占用较多内存，请确保设备有足够的 PSRAM

## 故障排查

- **WiFi 连接失败**: 检查 WiFi 名称和密码是否正确
- **摄像头初始化失败**: 检查摄像头硬件连接
- **上传失败**: 检查上传地址是否正确，网络连接是否正常
- **内存不足**: 确保已启用 PSRAM，可适当降低视频流分辨率

## 适用场景

- 家庭监控
- 延时摄影
- 远程监控
- 视频直播