Xiaozhi Pro ESP32 Firmware
Next-Generation AI Voice Assistant
Xiaozhi Pro is a major firmware upgrade for the ESP32-based AI voice assistant, introducing advanced display controls, environmental sensing, camera vision, and deep MCP tool integration. This release transforms your device from a basic chatbot into a fully-featured smart assistant with persistent settings, real-time status feedback, and granular hardware control -- all accessible through natural voice commands.
What is Xiaozhi Pro?
An enhanced firmware build for the ESP32 AI platformXiaozhi Pro builds on the open-source XiaoZhi AI firmware, adding a suite of advanced capabilities that give both users and the AI deeper control over the device hardware. The Pro release introduces an expanded MCP (Model Context Protocol) tool system with 10 tools accessible to the AI, enabling it to switch display themes, configure the display type, control volume and brightness, and report system status -- all through natural language conversation.
Every feature is designed for real-world reliability: settings persist across reboots via NVS flash storage, time synchronises automatically through NTP, and the firmware image ships as a single combined binary for hassle-free flashing. Whether you are upgrading an existing build or starting fresh, Xiaozhi Pro delivers a polished, professional-grade AI assistant experience.
New Features in Xiaozhi Pro
Every feature is controlled through voice commands via the MCP tool system, with settings saved automatically to non-volatile storage.
AI Screen Theme Control
Switch between light and dark display themes by voice. The AI can set the theme on demand, and your preference persists across reboots.
Display Type Configuration
Select between 0.96-inch SSD1306 and 1.3-inch SH1106 OLED controllers by voice. Reboot applies the change.
Face-Only Mode
Tell the AI to show an animated face on screen, hiding all status bars and text for a clean expressive look.
WiFi Info Tool
Ask the AI about the current WiFi network. It can read the SSID, signal strength, signal quality, and IP address.
Voice Volume Control
Adjust speaker volume by voice. The AI can set any level from 0 to 100, with safe range guidance.
Date and Time Tools
The AI can tell you the current local time with timezone, device uptime, and full date -- all synced via NTP.
Lamp Control
Turn the connected LED on or off by voice. The AI can check the current lamp state and toggle it.
Remote Reboot
Ask the AI to restart the device. The AI confirms before rebooting to prevent accidental restarts.
Brightness Control
Set screen brightness by voice from 0 to 100. The AI reads current brightness before making changes.
Full Device Status
Ask for a complete device status report including volume, brightness, battery, theme, WiFi info, and temperature.
Xiaozhi Pro Flash Tool
Flash directly from your browser using Chrome or Edge.
Connect your ESP32 and click the button below.
Complete MCP Tool Reference
All tools available to the AI during conversationThe MCP tool system is what makes Xiaozhi Pro intelligent. During any conversation, the AI can invoke these tools to read hardware state and change device settings. This is the complete list of tools exposed by the firmware.
| Tool | Purpose |
|---|---|
| self.get_device_status | Full status: volume, brightness, battery, theme, WiFi |
| self.get_current_time | Current local time with timezone |
| self.system.get_uptime | How long the device has been running |
| self.system.get_wifi_info | SSID, signal strength, IP address |
| self.system.reboot | Restart the device |
| self.audio_speaker.set_volume | Set speaker volume (0-100) |
| self.screen.set_brightness | Set display brightness (0-100) |
| self.screen.set_theme | Switch between light and dark theme |
| self.screen.set_face_only_mode | Toggle animated face display on/off |
| self.screen.set_display_type | Switch SSD1306 / SH1106 OLED type |
| self.lamp.turn_on / off | Control the connected LED lamp |
