ESP32 Tutorial

Welcome to the ESP32 Tutorial repository! This collection of small, self-contained examples is designed to introduce and demonstrate fundamental principles of embedded systems using the ESP32 microcontroller.

Aimed at beginners, these tutorials use the familiar Arduino framework, making it easy to get started with microcontroller programming. Each example is straightforward and focuses on a specific concept or functionality.

You can build and upload the examples to an ESP32 development board using the PlatformIO extension for VS Code. For those without hardware, the projects can also be simulated using the Wokwi extension within VS Code.

🚀 Setup Instructions

Getting started is quick and easy! This project includes a preconfigured VS Code workspace to streamline the setup. Just follow the steps below:

1. Install VS Code

If you haven’t already, download and install Visual Studio Code.

2. Install Required Extensions

Make sure the following extensions are installed in VS Code:

• PlatformIO IDE – for building and uploading code to your ESP32.
• Wokwi for VS Code – for simulating projects without hardware.

Tip: After opening the workspace, VS Code may prompt you to install any missing extensions.

3. Open the Workspace

1. Clone or download this repository.
2. Open the included esp32-tutorial.code-workspace file in VS Code.

code esp32-tutorial.code-workspace

4. Run the Examples

• To build and upload to a physical ESP32 board, use the PlatformIO controls in the status bar or sidebar.
• To simulate with wokwi (requires account), build the project and start the Wokwi Simulator by opening the diagram.json and click the play button.

Learning Path

The examples are not strictly at a fixed order but if you want to go through them step by step, you can follow this learning path.

1. GPIOs and Serial Output

• Blink an LED
• Controll multiple LEDs at once
• Simple print debugging
• Press a button
• Toggle a button

2. Non Blocking GPIO usage

• Blink LED with millis()

• Toggle a button with millis()

• Toggle a button with a shift register

• Project Traffic Light

3. FSM

• FSM Pattern Traffic Light
• FSM Pattern Vending Machine

4. External Interrupts and Timers

• Detect button press with an external interrupt
• Read a rotary encoder state
• Blink LED without using the loop

5. ADC and PWM

• Read a Poti
• Fade an LED
• Controll a Servo with

6. Communication Protocols

• Reading bytes from UART
• Sending commands over UART
• Read BM280 Sensor over I2C

📄 License

This project is licensed under the MIT License.