yahboom
HomeLearn
Solution
Blog
Online Store
About Us
EN/中文
ESP32 Core Board📖
1. ESP32 Introduction
  • 1. ESP32S3 Overview
  • 2. Environment Setup Introduction
  • 3. Dev Board Introduction
2. ESP-IDF Development Tutorial
1. Before Development
  • 1. Environment Setup (Windows)
  • 2. Environment Setup (Linux)
  • 3. Build and Flash
2. Basic Peripherals
  • 1. LED Control
  • 2. Button Detection
  • 3. Peripheral Interrupts
  • 4. ESP_TIMER
  • 5. GPTIMER
  • 6. Watchdog Timer
  • 7. DMA
  • 8. ADC
  • 9. PWM Breathing LED
  • 10. RGB LED Effects
3. Serial Communication and Storage System
  • 1. Serial UART Communication Experiment
  • 2. I2C_OLED Display Experiment
  • 3. SPI Bus Communication Experiment
  • 4. PSRAM External Memory Experiment
  • 5. Flash Read and Write Experiment
  • 6. USB Emulated Mass Storage Experiment
4. FreeRTOS operating system
  • 1.FreeRTOS Core Concepts Theory
  • 2.Task Creation and Management
  • 3.Queue
  • 4.Binary Semaphore
  • 5.Mutex
  • 6.Event Groups
  • 7.Software Timer
  • 8.Task Scheduler
  • 9.Low Power Mode
  • 10.Deadlock
  • 11.Priority Inversion
5. Network Protocols and Wireless Communication
  • 1. WIFI Network Basics
  • 2. WIFI STA Mode
  • 3. WIFI AP Mode
  • 4. UDP Client Experiment
  • 5. UDP Server Experiment
  • 6. TCP Client Experiment
  • 7. TCP Server Experiment
  • 8. Socket Programming Basics
  • 9. HTTP Client Experiment
  • 10. HTTP Server Experiment
  • 11. MQTT IoT Communication Protocol
  • 12. WIFI OTA Upgrade
  • 13. Bluetooth Fundamentals
  • 14. Bluetooth Slave Mode
  • 15. Bluetooth Master Mode
6. Audio Applications
  • 1.I2S Microphone Recording and U-Disk Playback
  • 2.I2S Audio Playback Experiment
  • 3.Repeater Experiment
7. Xiaozhi AI Voice
  • 1. Burn Xiaozhi Firmware
  • 2. Network and Configuration
  • 3. AI Agent Settings
  • 4. Program Analysis
  • 5. Free Chat
3. Arduino Development Course
1. Before Development
  • 1. Environment Setup
  • 2. Build and Flash
2. Basic Peripherals
  • 1. LED Control
  • 2. Button Detection
  • 3. Peripheral Interrupts
  • 4. ESP_TIMER
  • 5. GPTIMER
  • 6. Watchdog Timer
  • 7. ADC
  • 8. PWM Breathing LED
  • 9. RGB LED Effects
3. Serial Communication and Storage System
  • 1. Serial UART Communication
  • 2. I2C OLED Display
  • 3. SPI Bus Communication
  • 4. Flash Read and Write
  • 5. USB Emulated Mass Storage
4. Network Protocols and Wireless Communication
  • 1. WIFI Network Basics
  • 2. WIFI STA Mode
  • 3. WIFI AP Mode
  • 4. UDP Server Experiment
  • 5. UDP Client Experiment
  • 6. TCP Client Experiment
  • 7. TCP Server Experiment
  • 8. HTTP Client Experiment
  • 9. HTTP Server Experiment
  • 10. MQTT IoT Communication Protocol
  • 11. WIFI OTA Upgrade
  • 12. Bluetooth Fundamentals
  • 13. Bluetooth Slave Mode
  • 14. Bluetooth Master Mode
5. Audio Applications
  • 1.I2S Microphone Recording and U-Disk Playback
  • 2.I2S Audio Playback Experiment
  • 3.Repeater Experiment
4. MicroPython Development Course
1. Before Development
  • 1. Environment Setup
  • 2. Build and Flash
  • 3. Thonny IDE
2. Basic Peripherals
  • 1. LED Control
  • 2. Button Detection
  • 3. Peripheral Interrupts
  • 4. TIMER_IT
  • 5. Watchdog Timer
  • 6. ADC
  • 7. PWM Breathing LED
  • 8. RGB LED Effects
3. Serial Communication and Storage System
  • 1. Serial UART Communication Experiment
  • 2. I2C_OLED Display Experiment
  • 3. SPI Bus Communication Experiment
  • 4. Flash Read and Write Experiment
  • 5. Print Storage
4. Network Protocols and Wireless Communication
  • 1. WIFI Network Basics
  • 2. WIFI STA Mode
  • 3. WIFI AP Mode
  • 4. UDP Client Experiment
  • 5. UDP Server Experiment
  • 6. TCP Client Experiment
  • 7. TCP Server Experiment
  • 8. HTTP Client Experiment
  • 9. HTTP Server Experiment
  • 10. MQTT
  • 11. Bluetooth Fundamentals
  • 12. Bluetooth Slave Mode
  • 13. Bluetooth Master Mode
5. Audio Applications
  • 1. I2S Audio Playback Experiment
  • 2. Repeater Experiment
Download
  • Code
  • Hardware_Info
  • 3D_Model_File
  • Software_Tools
  • VMware
  • VM_File
Download ZIP

Welcome to ESP32 Core Board repository

2. Network and Configuration

2. Network and Configuration

2. Network and Configuration1. Wi-Fi ProvisioningMethod 1: Hotspot Provisioning (Recommended, No Compilation Required)Method 2: menuconfig Static Configuration (For Development and Debugging)4. Device Activation and First Online4.1 Get Activation Code4.2 Compile and Flash, Observe Network Connection Logs4.3 Verify Device is Online5. Common Network Troubleshooting

1. Wi-Fi Provisioning

AI Xiaozhi supports two Wi-Fi provisioning methods:

Method 1: Hotspot Provisioning (Recommended, No Compilation Required)

When the device starts for the first time, it automatically enters provisioning mode because there are no Wi-Fi credentials—creating a Wi-Fi hotspot named Xiaozhi-XXXX:

  1. Phone connects to hotspot Xiaozhi-XXXX

    Connecting to Hotspot

  2. Browser visits http://192.168.4.1

    STA

  3. Select your Wi-Fi on the webpage and enter the password

    Connecting

  4. Device automatically connects to Wi-Fi and saves credentials to NVS; it will auto-connect on every power-on

    Scanning Wi-FiConnection Successful

This is the most convenient provisioning method; no code modification or menuconfig required, consistent with smart home device provisioning.

Method 2: menuconfig Static Configuration (For Development and Debugging)

Directly fill in Wi-Fi information in menuconfig:

Configuration PathSettingValue
Xiaozhi → WiFi Configuration → WiFi SSIDYour Wi-Fi namee.g., MyHomeWiFi
Xiaozhi → WiFi Configuration → WiFi PasswordYour Wi-Fi passworde.g., mypassword123

The advantage of this method is no additional provisioning step after compilation, but changing Wi-Fi environment requires recompilation and flashing.

4. Device Activation and First Online

4.1 Get Activation Code

Device activation requires an activation code. Login - Xiaozhi Console to apply for your own Xiaozhi console account, get the device activation code, then continue with this section.

Get Activation Code

Add device. Add Device

If you have already completed AI Agent settings, continue with the following steps.

4.2 Compile and Flash, Observe Network Connection Logs

ESP-IDF Flashing Process: See ESP-IDF Development Tutorial → 1. Before Development → 3. Build and Flash.

After successful flashing, reset the development board and observe serial output; logs for successful network connection should be:

I (2946) WifiStation: Found AP: Yahboom2, RSSI: -22, Channel: 6
I (2947) WifiBoard: WiFi connecting to Yahboom2
I (7145) wifi:connected with Yahboom2, aid = 5, channel 6
I (8193) WifiStation: Got IP: 192.168.11.181
I (8194) WifiBoard: Connected to WiFi: Yahboom2
I (8198) Application: Network connected
I (8202) StateMachine: State: starting -> activating
I (8256) MODEL_LOADER: Successfully load srmodels
I (8744) HttpClient: Established connection to api.tenclass.net:443
I (8979) Ota: Current is the latest version
I (8982) MQTT: Connecting to endpoint mqtt.xiaozhi.me
I (9473) MQTT: Connected to endpoint
I (9473) Application: Activation done
I (9474) StateMachine: State: activating -> idle
I (9501) AfeWakeWord: Model 0: wn9s_nihaoxiaozhi
I (9589) AFE: AFE Pipeline: [input] -> ... -> WakeNet(wn9s_nihaoxiaozhi) -> [output]
I (9604) AudioCodec: Set output enable to true
I (9667) AudioCodec: Set input enable to true

Key Nodes:

Log LineStageDescription
Found AP: Yahboom2, RSSI: -22Hotspot scannedProvisioned hotspot in range
wifi:connected + Got IP: 192.168.11.181Wi-Fi connectionDHCP successfully assigned LAN IP
Network connectedNetwork readyTCP/IP protocol stack ready
State: starting → activatingDevice activationConnecting to server, sending activation code for verification
MQTT: Connected to endpointServer connectionConnected to mqtt.xiaozhi.me
Activation done → State: idleActivation completeDevice activated successfully, entering idle standby
AfeWakeWord: wn9s_nihaoxiaozhiWake word loaded"Hi,Andy" wake word model loaded
AFE Pipeline: WakeNet → [output]Audio pipeline readyMIC → VAD → wake word detection full link ready
AudioCodec: output/input enableAudio channel openedSpeaker + microphone both enabled

4.3 Verify Device is Online

Login to xiaozhi.me console → Device Management, confirm your device status is Online.

5. Common Network Troubleshooting

PhenomenonCauseSolution
Wi-Fi keeps connectingSSID or password errorCheck Wi-Fi information in menuconfig
Server connection timeoutServer address or port incorrectConfirm server address and port format are correct
WebSocket handshake failedTLS/SSL configuration mismatchCheck WSS switch and certificate configuration
Device activation failedActivation code invalid or expiredRegenerate activation code at xiaozhi.me
Network frequently disconnectsWi-Fi signal weakMove closer to router or use 4G module
IP address is 0.0.0.0DHCP acquisition failedCheck router DHCP service
Burn Xiaozhi Firmware
AI Agent Settings

COMPANY

  • About us
  • Team Style
  • Blog

LEARNING & EXPLORATION

  • Tutorials
  • Edge AI hardware
  • Educational robots
  • Embedded intelligent hardware

WHERE TO BUY

  • Yahboom Online Store
  • Amazon
  • Alibaba
  • AliExpress
  • Mercado

TECHNOLOGY SUPPORT

  • Email: support@yahboom.com

BE A DISTRIBUTOR

  • Email: sales@yahboom.com
QR Code
QR Code

Copyright © 2017-2026 Yahboom. All Rights Reserved.

EN/中文