Skip to content

Conversation

@78
Copy link
Owner

@78 78 commented Oct 1, 2025

This pull request focuses on improving documentation, especially for custom board development and multi-language support, and clarifies configuration options for various hardware platforms. It also removes some redundant compile flags configuration. The most significant changes are detailed below:

Documentation Improvements and Restructuring:

  • Major updates and restructuring of the README.md, README_en.md, and README_ja.md files to provide clearer project introductions, versioning notes, and a new "About the Project" section. These updates also add information about client projects and tools, and clarify hardware compatibility and upgrade instructions. [1] [2] [3] [4] [5] [6]
  • Enhanced developer documentation: the "Custom Board Guide" has been renamed and moved from main/boards/README.md to docs/custom-board.md, and its content has been significantly expanded. The guide now includes step-by-step instructions for directory naming, config.json options, build system integration (Kconfig, CMake), and both manual and automated build processes. [1] [2] [3]

Hardware Platform and Build Configuration:

  • Added a new board documentation: main/boards/esp-box-3/README.md, detailing hardware features, configuration, UI style selection, and usage instructions for the ESP-BOX-3 platform.
  • Updated the configuration guides and documentation for several boards (e.g., EchoEar, Jiuchuan-S3) to clarify UI style selection, partition table usage, and board type configuration, improving ease of use for developers. [1] [2]

Configuration and Compatibility Updates:

  • Updated references to developer documentation across all language variants to point to the new docs/custom-board.md location and added missing protocol documentation links. [1] [2] [3]
  • Minor corrections and cleanup in various board config.json files, removing redundant or now-automated configuration keys (e.g., CONFIG_BOARD_TYPE_*). [1] [2] [3]

Feature Highlights:

  • Added explicit mention in all language variants of the ability to customize wake words, fonts, emojis, and chat backgrounds, with links to the web-based custom assets generator. [1] [2] [3]

Other:

  • Removed the CompileFlags section from .clangd, cleaning up unused compile flag removal configuration.

@78 78 merged commit 911fee2 into main Oct 1, 2025
1 check passed
Cmdmac pushed a commit to Cmdmac/xiaozhi-esp32 that referenced this pull request Oct 14, 2025
* Upgrade to the latest ml307 component

* update README
Wvirgil123 added a commit to Wvirgil123/xiaozhi-esp32 that referenced this pull request Oct 20, 2025
* main:
  Add 16 more languages to locales (78#1297)
  Fix LilyGo-T-CameraPlus-S3 Camera (78#1295)
  Fix lichuang-dev camera (78#1290)
  将太极派新款和旧款分离 (78#1287)
  Refactor: Use esp_video component (78#1245)
  add support for Wireless-Tag WTP4C5MP07S ESP32P4 board + 7 inch MIPI DSI LCD display combo (78#1281)
  Optimize AdcBatteryMonitor to work without charge detection pin. (78#1276)
  enable rrti for m5stack-tab5 (78#1268)
  Add LILYGO T-Display-P4 board adaptation (78#1269)
  Added Waveshare ESP32-P4-WIFI6-Touch-LCD-7B third party board (78#1243)
  Add esp32c5 configuration (78#1258)
  Change the button array to ADC buttons as in the board for esp32s3-korv2 (78#1256)
  Add SetInputGain(float gain) to AudioCodec (78#1252)
  Update README (78#1251)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants