# ESP32_Pro

**Repository Path**: bad-lemon/esp32_-pro

## Basic Information

- **Project Name**: ESP32_Pro
- **Description**: ESP32的学习基础项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-20
- **Last Updated**: 2026-01-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# ESP32-S3 Project

A professional ESP32-S3 firmware project built with ESP-IDF framework, featuring comprehensive connectivity options and peripheral support for embedded applications.

## Overview

This project demonstrates a complete ESP32-S3 application with support for WiFi, Bluetooth, Ethernet, and various communication protocols. It serves as a foundation for developing IoT applications, embedded systems, and wireless devices.

## Features

- **Wireless Connectivity**
  - WiFi (STA/AP modes) with WPA3 support
  - Bluetooth Classic and BLE
  - ESP-NOW mesh networking

- **Communication Protocols**
  - MQTT client/server
  - HTTP/HTTPS servers
  - WebSocket support
  - TCP/IP networking via lwIP

- **Peripheral Support**
  - GPIO with interrupt handling
  - Multiple SPI, I2C, I2S interfaces
  - UART communication
  - PWM and LED control
  - ADC/DAC conversions
  - Touch sensor support
  - RMT for infrared and remote control

- **Security Features**
  - mbedTLS encryption
  - Secure boot support
  - Flash encryption
  - TLS/SSL connections

## Hardware Requirements

- ESP32-S3 development board
- USB-to-UART bridge for flashing
- External devices per peripheral usage

## Software Requirements

- ESP-IDF v5.4 or newer
- CMake 3.30.2 or newer
- Ninja build system
- Python 3.8 or newer
- GNU toolchain for Xtensa

## Building

1. Set up ESP-IDF environment:
   ```bash
   export IDF_PATH=/path/to/esp-idf
   source $IDF_PATH/export.sh
   ```

2. Configure the project:
   ```bash
   cd 01_my_first_project
   idf.py menuconfig
   ```

3. Build the project:
   ```bash
   idf.py build
   ```

## Flashing

Flash to device:
```bash
idf.py -p /dev/ttyUSB0 flash
```

Monitor output:
```bash
idf.py -p /dev/ttyUSB0 monitor
```

## Project Structure

```
01_my_first_project/
├── CMakeLists.txt         # Project CMake configuration
├── main/                  # Application source code
│   ├── CMakeLists.txt
│   └── main.c            # Main application entry
├── components/           # Custom components (if any)
├── build/                # Build output directory
└── sdkconfig            # ESP-IDF configuration
```

## Configuration

Customize the project through `idf.py menuconfig`:

- **Component Settings**
  - WiFi configuration
  - Bluetooth stack selection
  - Peripheral driver options

- **FreeRTOS Settings**
  - Task priorities and stack sizes
  - Timer configurations

- **System Settings**
  - CPU frequency
  - Flash and PSRAM settings
  - Logging levels

## Key Components

| Component | Purpose |
|-----------|---------|
| FreeRTOS | Real-time operating system |
| lwIP | TCP/IP networking stack |
| mbedTLS | SSL/TLS encryption |
| MQTT | Message queue telemetry transport |
| WiFi | Wireless networking |
| Bluetooth | Wireless personal area network |
| NVS Flash | Non-volatile storage |

## Example Applications

The project includes basic demonstrations for:
- LED blinking
- Button interrupt handling
- UART communication
- WiFi connection
- MQTT publishing/subscribing

## Troubleshooting

- **Build failures**: Ensure ESP-IDF is properly installed and environment variables are set
- **Flashing errors**: Check COM port selection and driver installation
- **Runtime issues**: Verify power supply and connection stability
- **Memory problems**: Adjust FreeRTOS heap and stack configurations

## License

See the repository for licensing information.

## Resources

- [ESP-IDF Programming Guide](https://docs.espressif.com/projects/esp-idf/)
- [ESP32-S3 Datasheet](https://www.espressif.com/)
- [ESP-IDF GitHub](https://github.com/espressif/esp-idf)
- [Gitee Repository](https://gitee.com/bad-lemon/esp32_-pro)