Skip to main content

ESP32 integration guide

This section shows how to start an AirNgin firmware project on ESP32 using PlatformIO and Visual Studio Code.

The examples are intended as integration references. Preserve your existing product control logic and hardware configuration, then add the AirNgin connection layer around it.

Main project structure​

A typical PlatformIO project contains:

  • platformio.ini — board, framework, dependencies, and build settings;
  • src/ — application source code;
  • optional custom partition table and configuration files;
  • the network/connection manager used by your product.

AirNgin integration should reuse the product's existing network manager where possible instead of creating a second competing Wi-Fi/Ethernet state machine.

Open the project in Visual Studio Code​

  1. Install Visual Studio Code.
  2. Install the PlatformIO extension.
  3. Open the project root folder.
  4. Select the correct ESP32 board/target.
  5. Build before changing the AirNgin integration so you have a known-good baseline.
  6. Continue with Create a new ESP32 project or Review the AirNgin sample project.