VapiCon 2025 Hardware Workshop
Demo Video
Prerequisites
ESP-IDF: Install ESP-IDF v5.5.1 or later Quick Installation Steps macOS/Linux # Install prerequisites (macOS) brew install cmake ninja dfu-util # Install prerequisites (Ubuntu/Debian) # sudo apt-get install git wget flex bison gperf python3 python3-venv cmake ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-0 # Clone ESP-IDF repository mkdir -p ~ /esp cd ~ /esp git clone -b v5.5.1 --recursive https://github.com/espressif/esp-idf.git # Install ESP-IDF tools cd ~ /esp/esp-idf ./install.sh esp32s3 # Set up environment (run this each time you open a new terminal) source ~ /esp/esp-idf/export.sh Windows # Download and run the ESP-IDF installer from: # https://dl.espressif.com/dl/esp-idf/ # Or use the ESP-IDF command prompt installed by the installer # Then run: export.bat Verify Installation idf.py --version # Should output something like: ESP-IDF v5.5.1 Setting up Environment (Required for each terminal session) # Add this to your ~/.zshrc to avoid running it manually: alias get_idf= ' . ~/esp/esp-idf/export.sh ' # Open a new terminal to apply the changes # Then you can simply run: get_idf Full Documentation: Official ESP-IDF Installation Guide Hardware: AtomS3R or
Atomic Echo Base
Atomic Battery Base
Project Setup
1. Clone the Repository
git clone --recurse-submodules https://github.com/VapiAI/vapicon-2025-hardware-workshop.git cd vapicon-2025-hardware-workshop
2. Configuration
Run the configuration menu to set up your WiFi credentials and Bearer Token:
idf.py menuconfig
Navigate to:
VapiCon 2025 Hardware Workshop Configuration
Set your WiFi Name and WiFi Password
and Set your Bearer Token
Press S to save and Q to quit.
Config values
BEARER_TOKEN - b3db41dc-f62e-4ca8-89dc-550eab564212
Building the Project
Build the firmware
idf.py build
Flashing to Device
Flash and monitor
idf.py flash monitor
This command will:
Flash the firmware to your connected ESP32-S3 device Open the serial monitor to view debug output
To exit the monitor, press Ctrl+] .
Troubleshooting
Build Errors
If you encounter compiler warnings treated as errors:
String truncation errors: These may appear with GCC 13+ due to stricter checks Missing enum cases: This typically happens when using a different ESP-IDF version Solution : Ensure you're using ESP-IDF v5.5.1 as specified in the prerequisites
: Ensure you're using ESP-IDF v5.5.1 as specified in the prerequisites Check your current version: idf.py --version
If incorrect, reinstall ESP-IDF v5.5.1 following the installation steps above
Missing Dependencies
If the build fails with missing libpeer files:
Ensure submodules are properly initialized: git submodule update --init --recursive
Check that deps/libpeer/src/ directory contains source files
Device Connection
If flashing fails:
Check the USB connection
Try different USB ports or cables
Ensure the correct port is detected (it should auto-detect, or specify with -p PORT )
Project Structure
vapicon-2025-hardware-workshop/ ├── main/ # Main application source │ ├── http.h # HTTP client for Vapi API │ ├── webrtc.h # WebRTC implementation │ ├── wifi.h # WiFi connection management │ └── m5-atom-s3.h # Hardware abstraction ├── deps/ │ └── libpeer/ # WebRTC library (git submodule) ├── components/ │ └── peer/ # Peer connection component ├── sdkconfig.defaults # Default configuration values └── partitions.csv # Flash partition table