Skip to content

Releases: OpenNextion/OpenNextion-Example-xiaozhi-esp32

Release list

OpenNextion XiaoZhi AI Chatbot v2.2.6

OpenNextion XiaoZhi AI Chatbot v2.2.6 Latest
Latest

Choose a tag to compare

View all tags
@l2063610646 l2063610646 released this 03 Aug 09:45
v2.2.6
907d967

Overview

This release provides ready-to-flash XiaoZhi AI Chatbot firmware for the two supported OpenNextion ESP32-S3 touchscreen panels:

  • ONX2432G028, 2.8-inch portrait display
  • ONX3248G035, 3.5-inch portrait display

Each release asset is a complete initial-flashing package for one exact panel model. It includes display, capacitive touch, dual-microphone, speaker, and Wi-Fi support for the XiaoZhi AI Chatbot firmware.

Release Assets

Download only the complete firmware image that matches the model printed on your panel.

Panel model Release asset
ONX2432G028 xiaozhi_V2.2.6_merged_ONX2432G028_en_Jarvis.bin
ONX3248G035 xiaozhi_V2.2.6_merged_ONX3248G035_en_Jarvis.bin

These are complete initial-flashing images. Flash the matching file directly at address 0x0; no extraction is required.

Release asset Size SHA256
xiaozhi_V2.2.6_merged_ONX2432G028_en_Jarvis.bin 11137079 bytes c402f3d5475af7caf3fa271d5527582ce3e875bd374d6c4e08175f2ab4804add
xiaozhi_V2.2.6_merged_ONX3248G035_en_Jarvis.bin 14626295 bytes 3ca793f40c51ab836ba52bac447651b02024a988b6201bcd48aaf9f3372e6745

Do not flash firmware built for one model onto the other model. The 2.8-inch and 3.5-inch panels use different display configurations.

Supported Hardware

Board Display Resolution Orientation
ONX2432G028 2.8-inch capacitive touch 240 × 320 Portrait
ONX3248G035 3.5-inch capacitive touch 320 × 480 Portrait

Other OpenNextion or Nextion displays are not release targets for v2.2.6.

Flashing

  1. Download the BIN file for your exact panel model.
  2. Connect the panel with a data-capable USB cable.
  3. Flash the downloaded BIN file to address 0x0.

Example:

python -m esptool --chip esp32s3 \
  -p <SERIAL_PORT> \
  -b 921600 \
  write_flash 0x0 ./<FIRMWARE_FILE>.bin

Replace <SERIAL_PORT> with your serial device and <FIRMWARE_FILE> with the release asset for your panel. If flashing cannot connect, enter download mode with the panel's BOOT and Reset controls, then retry.

First-Time Setup

After flashing, the device starts Wi-Fi provisioning when it has no usable saved credentials:

  1. Connect a phone or computer to the Xiaozhi-xxxx hotspot.
  2. Open http://192.168.4.1 if the captive portal does not open automatically.
  3. Select a 2.4 GHz Wi-Fi network, enter its password, and save.
  4. Follow the on-screen activation prompt. The default firmware uses xiaozhi.me.

Start or stop a conversation by tapping the touchscreen or briefly pressing the BOOT button.

What Is Included

  • XiaoZhi AI Chatbot firmware for ESP32-S3
  • Portrait display profiles for ONX2432G028 and ONX3248G035
  • Capacitive touch input
  • Dual-microphone input and speaker output
  • Wi-Fi hotspot provisioning
  • Default XiaoZhi service connection and device activation flow

Notes and Limitations

  • Use a 2.4 GHz Wi-Fi network; ESP32-S3 does not connect to 5 GHz-only Wi-Fi.
  • This release contains only the two board-specific assets listed above.
  • Use a complete USB flash for recovery if the wrong firmware was installed.
  • AI-service and model settings are managed in the xiaozhi.me console after device activation.

Build from Source

For a custom build, select the ESP32-S3 target and the exact board in menuconfig:

idf.py set-target esp32s3
idf.py menuconfig

Open Board Type, then select one of:

  • OpenNextion ONX2432G028
  • OpenNextion ONX3248G035

Save the configuration, then build and flash:

idf.py build
idf.py flash monitor

License

This project is based on xiaozhi-esp32 and is released under the MIT License. Third-party components may have their own license notices.

Flashing third-party firmware carries a risk of device damage or data loss. Confirm that the firmware matches your panel model before installation.

Assets 4
Loading