diff --git a/.clangd b/.clangd
new file mode 100644
index 0000000..7901c38
--- /dev/null
+++ b/.clangd
@@ -0,0 +1,2 @@
+CompileFlags:
+ Remove: [-f*, -m*]
diff --git a/.github/ISSUE_TEMPLATE/01_build_install_bug.yml b/.github/ISSUE_TEMPLATE/01_build_install_bug.yml
index d3489e2..d809883 100644
--- a/.github/ISSUE_TEMPLATE/01_build_install_bug.yml
+++ b/.github/ISSUE_TEMPLATE/01_build_install_bug.yml
@@ -1,103 +1,103 @@
-name: Installation or build bug report
-description: Report installation or build bugs
-labels: ['bug']
-body:
- - type: checkboxes
- id: checklist
- attributes:
- label: Answers checklist.
- description: Before submitting a new issue, please follow the checklist and try to find the answer.
- options:
- - label: I have read the documentation [XiaoZhi AI Programming Guide](https://ccnphfhqs21z.feishu.cn/wiki/F5krwD16viZoF0kKkvDcrZNYnhb) and the issue is not addressed there.
- required: true
- - label: I have updated my branch (master or release) to the latest version and checked that the issue is present there.
- required: true
- - label: I have searched the issue tracker for a similar issue and not found a similar issue.
- required: true
- - type: input
- id: xiaozhi_ai_version
- attributes:
- label: XiaoZhi AI version.
- description: On which XiaoZhi AI version does this issue occur on? Run `git describe --tags` to find it.
- placeholder: ex. v1.1.0-44-g140aab8
- validations:
- required: true
- - type: dropdown
- id: operating_system
- attributes:
- label: Operating System used.
- multiple: false
- options:
- - Windows
- - Linux
- - macOS
- validations:
- required: true
- - type: dropdown
- id: build
- attributes:
- label: How did you build your project?
- multiple: false
- options:
- - Command line with CMake
- - Command line with idf.py
- - CLion IDE
- - VS Code IDE/Cursor
- - Other (please specify in More Information)
- validations:
- required: true
- - type: dropdown
- id: windows_comand_line
- attributes:
- label: If you are using Windows, please specify command line type.
- multiple: false
- options:
- - PowerShell
- - CMD
- validations:
- required: false
- - type: textarea
- id: expected
- attributes:
- label: What is the expected behavior?
- description: Please provide a clear and concise description of the expected behavior.
- placeholder: I expected it to...
- validations:
- required: true
- - type: textarea
- id: actual
- attributes:
- label: What is the actual behavior?
- description: Please describe actual behavior.
- placeholder: Instead it...
- validations:
- required: true
- - type: textarea
- id: steps
- attributes:
- label: Steps to reproduce.
- description: 'How do you trigger this bug? Please walk us through it step by step. If this is build bug, please attach sdkconfig file (from your project folder). Please attach your code here.'
- value: |
- 1. Step
- 2. Step
- 3. Step
- ...
- validations:
- required: true
- - type: textarea
- id: debug_logs
- attributes:
- label: Build or installation Logs.
- description: Build or installation log goes here, should contain the backtrace, as well as the reset source if it is a crash.
- placeholder: Your log goes here.
- render: plain
- validations:
- required: false
- - type: textarea
- id: more-info
- attributes:
- label: More Information.
- description: Do you have any other information from investigating this?
- placeholder: ex. Any more.
- validations:
+name: Installation or build bug report
+description: Report installation or build bugs
+labels: ['bug']
+body:
+ - type: checkboxes
+ id: checklist
+ attributes:
+ label: Answers checklist.
+ description: Before submitting a new issue, please follow the checklist and try to find the answer.
+ options:
+ - label: I have read the documentation [XiaoZhi AI Programming Guide](https://ccnphfhqs21z.feishu.cn/wiki/F5krwD16viZoF0kKkvDcrZNYnhb) and the issue is not addressed there.
+ required: true
+ - label: I have updated my branch (master or release) to the latest version and checked that the issue is present there.
+ required: true
+ - label: I have searched the issue tracker for a similar issue and not found a similar issue.
+ required: true
+ - type: input
+ id: xiaozhi_ai_version
+ attributes:
+ label: XiaoZhi AI version.
+ description: On which XiaoZhi AI version does this issue occur on? Run `git describe --tags` to find it.
+ placeholder: ex. v1.1.0-44-g140aab8
+ validations:
+ required: true
+ - type: dropdown
+ id: operating_system
+ attributes:
+ label: Operating System used.
+ multiple: false
+ options:
+ - Windows
+ - Linux
+ - macOS
+ validations:
+ required: true
+ - type: dropdown
+ id: build
+ attributes:
+ label: How did you build your project?
+ multiple: false
+ options:
+ - Command line with CMake
+ - Command line with idf.py
+ - CLion IDE
+ - VS Code IDE/Cursor
+ - Other (please specify in More Information)
+ validations:
+ required: true
+ - type: dropdown
+ id: windows_comand_line
+ attributes:
+ label: If you are using Windows, please specify command line type.
+ multiple: false
+ options:
+ - PowerShell
+ - CMD
+ validations:
+ required: false
+ - type: textarea
+ id: expected
+ attributes:
+ label: What is the expected behavior?
+ description: Please provide a clear and concise description of the expected behavior.
+ placeholder: I expected it to...
+ validations:
+ required: true
+ - type: textarea
+ id: actual
+ attributes:
+ label: What is the actual behavior?
+ description: Please describe actual behavior.
+ placeholder: Instead it...
+ validations:
+ required: true
+ - type: textarea
+ id: steps
+ attributes:
+ label: Steps to reproduce.
+ description: 'How do you trigger this bug? Please walk us through it step by step. If this is build bug, please attach sdkconfig file (from your project folder). Please attach your code here.'
+ value: |
+ 1. Step
+ 2. Step
+ 3. Step
+ ...
+ validations:
+ required: true
+ - type: textarea
+ id: debug_logs
+ attributes:
+ label: Build or installation Logs.
+ description: Build or installation log goes here, should contain the backtrace, as well as the reset source if it is a crash.
+ placeholder: Your log goes here.
+ render: plain
+ validations:
+ required: false
+ - type: textarea
+ id: more-info
+ attributes:
+ label: More Information.
+ description: Do you have any other information from investigating this?
+ placeholder: ex. Any more.
+ validations:
required: false
\ No newline at end of file
diff --git a/.github/ISSUE_TEMPLATE/02_runtime_bug.yml b/.github/ISSUE_TEMPLATE/02_runtime_bug.yml
index 60a62f8..8b3b7a3 100644
--- a/.github/ISSUE_TEMPLATE/02_runtime_bug.yml
+++ b/.github/ISSUE_TEMPLATE/02_runtime_bug.yml
@@ -1,115 +1,115 @@
-name: Runtime bug report
-description: Report runtime bugs
-labels: ['bug']
-body:
- - type: checkboxes
- id: checklist
- attributes:
- label: Answers checklist.
- description: Before submitting a new issue, please follow the checklist and try to find the answer.
- options:
- - label: I have read the documentation [XiaoZhi AI Programming Guide](https://ccnphfhqs21z.feishu.cn/wiki/F5krwD16viZoF0kKkvDcrZNYnhb) and the issue is not addressed there.
- required: true
- - label: I have updated my firmware to the latest version and checked that the issue is present there.
- required: true
- - label: I have searched the issue tracker for a similar issue and not found a similar issue.
- required: true
- - type: input
- id: xiaozhi_ai_firmware_version
- attributes:
- label: XiaoZhi AI firmware version.
- description: On which firmware version does this issue occur on?
- placeholder: ex. v1.2.1_bread-compact-wifi
- validations:
- required: true
- - type: dropdown
- id: operating_system
- attributes:
- label: Operating System used.
- multiple: false
- options:
- - Windows
- - Linux
- - macOS
- validations:
- required: true
- - type: dropdown
- id: build
- attributes:
- label: How did you build your project?
- multiple: false
- options:
- - Command line with CMake
- - Command line with idf.py
- - CLion IDE
- - VS Code IDE/Cursor
- - Other (please specify in More Information)
- validations:
- required: true
- - type: dropdown
- id: windows_comand_line
- attributes:
- label: If you are using Windows, please specify command line type.
- multiple: false
- options:
- - PowerShell
- - CMD
- validations:
- required: false
- - type: dropdown
- id: power_supply
- attributes:
- label: Power Supply used.
- multiple: false
- options:
- - USB
- - External 5V
- - External 3.3V
- - Battery
- validations:
- required: true
- - type: textarea
- id: expected
- attributes:
- label: What is the expected behavior?
- description: Please provide a clear and concise description of the expected behavior.
- placeholder: I expected it to...
- validations:
- required: true
- - type: textarea
- id: actual
- attributes:
- label: What is the actual behavior?
- description: Please describe actual behavior.
- placeholder: Instead it...
- validations:
- required: true
- - type: textarea
- id: steps
- attributes:
- label: Steps to reproduce.
- description: 'How do you trigger this bug? Please walk us through it step by step. Please attach your code here.'
- value: |
- 1. Step
- 2. Step
- 3. Step
- ...
- validations:
- required: true
- - type: textarea
- id: debug_logs
- attributes:
- label: Debug Logs.
- description: Debug log goes here, should contain the backtrace, as well as the reset source if it is a crash.
- placeholder: Your log goes here.
- render: plain
- validations:
- required: false
- - type: textarea
- id: more-info
- attributes:
- label: More Information.
- description: Do you have any other information from investigating this?
- placeholder: ex. Any more.
- validations:
+name: Runtime bug report
+description: Report runtime bugs
+labels: ['bug']
+body:
+ - type: checkboxes
+ id: checklist
+ attributes:
+ label: Answers checklist.
+ description: Before submitting a new issue, please follow the checklist and try to find the answer.
+ options:
+ - label: I have read the documentation [XiaoZhi AI Programming Guide](https://ccnphfhqs21z.feishu.cn/wiki/F5krwD16viZoF0kKkvDcrZNYnhb) and the issue is not addressed there.
+ required: true
+ - label: I have updated my firmware to the latest version and checked that the issue is present there.
+ required: true
+ - label: I have searched the issue tracker for a similar issue and not found a similar issue.
+ required: true
+ - type: input
+ id: xiaozhi_ai_firmware_version
+ attributes:
+ label: XiaoZhi AI firmware version.
+ description: On which firmware version does this issue occur on?
+ placeholder: ex. v1.2.1_bread-compact-wifi
+ validations:
+ required: true
+ - type: dropdown
+ id: operating_system
+ attributes:
+ label: Operating System used.
+ multiple: false
+ options:
+ - Windows
+ - Linux
+ - macOS
+ validations:
+ required: true
+ - type: dropdown
+ id: build
+ attributes:
+ label: How did you build your project?
+ multiple: false
+ options:
+ - Command line with CMake
+ - Command line with idf.py
+ - CLion IDE
+ - VS Code IDE/Cursor
+ - Other (please specify in More Information)
+ validations:
+ required: true
+ - type: dropdown
+ id: windows_comand_line
+ attributes:
+ label: If you are using Windows, please specify command line type.
+ multiple: false
+ options:
+ - PowerShell
+ - CMD
+ validations:
+ required: false
+ - type: dropdown
+ id: power_supply
+ attributes:
+ label: Power Supply used.
+ multiple: false
+ options:
+ - USB
+ - External 5V
+ - External 3.3V
+ - Battery
+ validations:
+ required: true
+ - type: textarea
+ id: expected
+ attributes:
+ label: What is the expected behavior?
+ description: Please provide a clear and concise description of the expected behavior.
+ placeholder: I expected it to...
+ validations:
+ required: true
+ - type: textarea
+ id: actual
+ attributes:
+ label: What is the actual behavior?
+ description: Please describe actual behavior.
+ placeholder: Instead it...
+ validations:
+ required: true
+ - type: textarea
+ id: steps
+ attributes:
+ label: Steps to reproduce.
+ description: 'How do you trigger this bug? Please walk us through it step by step. Please attach your code here.'
+ value: |
+ 1. Step
+ 2. Step
+ 3. Step
+ ...
+ validations:
+ required: true
+ - type: textarea
+ id: debug_logs
+ attributes:
+ label: Debug Logs.
+ description: Debug log goes here, should contain the backtrace, as well as the reset source if it is a crash.
+ placeholder: Your log goes here.
+ render: plain
+ validations:
+ required: false
+ - type: textarea
+ id: more-info
+ attributes:
+ label: More Information.
+ description: Do you have any other information from investigating this?
+ placeholder: ex. Any more.
+ validations:
required: false
\ No newline at end of file
diff --git a/.github/ISSUE_TEMPLATE/03_feature_request.yml b/.github/ISSUE_TEMPLATE/03_feature_request.yml
index 79cb921..0c258ca 100644
--- a/.github/ISSUE_TEMPLATE/03_feature_request.yml
+++ b/.github/ISSUE_TEMPLATE/03_feature_request.yml
@@ -1,34 +1,34 @@
-name: Feature request
-description: Suggest an idea for this project.
-labels: ['enhancement']
-body:
- - type: markdown
- attributes:
- value: |
- * We welcome any ideas or feature requests! It’s helpful if you can explain exactly why the feature would be useful.
- * There are usually some outstanding feature requests in the [existing issues list](https://github.com/78/xiaozhi-esp32/labels/enhancement), feel free to add comments to them.
- * If you would like to contribute, please read the [contributions guide](https://ccnphfhqs21z.feishu.cn/wiki/F5krwD16viZoF0kKkvDcrZNYnhb).
- - type: textarea
- id: problem-related
- attributes:
- label: Is your feature request related to a problem?
- description: Please provide a clear and concise description of what the problem is.
- placeholder: ex. I'm always frustrated when ...
- - type: textarea
- id: solution
- attributes:
- label: Describe the solution you'd like.
- description: Please provide a clear and concise description of what you want to happen.
- placeholder: ex. When using XiaoZhi ...
- - type: textarea
- id: alternatives
- attributes:
- label: Describe alternatives you've considered.
- description: Please provide a clear and concise description of any alternative solutions or features you've considered.
- placeholder: ex. Choosing other approach wouldn't work, because ...
- - type: textarea
- id: context
- attributes:
- label: Additional context.
- description: Please add any other context or screenshots about the feature request here.
+name: Feature request
+description: Suggest an idea for this project.
+labels: ['enhancement']
+body:
+ - type: markdown
+ attributes:
+ value: |
+ * We welcome any ideas or feature requests! It’s helpful if you can explain exactly why the feature would be useful.
+ * There are usually some outstanding feature requests in the [existing issues list](https://github.com/78/xiaozhi-esp32/labels/enhancement), feel free to add comments to them.
+ * If you would like to contribute, please read the [contributions guide](https://ccnphfhqs21z.feishu.cn/wiki/F5krwD16viZoF0kKkvDcrZNYnhb).
+ - type: textarea
+ id: problem-related
+ attributes:
+ label: Is your feature request related to a problem?
+ description: Please provide a clear and concise description of what the problem is.
+ placeholder: ex. I'm always frustrated when ...
+ - type: textarea
+ id: solution
+ attributes:
+ label: Describe the solution you'd like.
+ description: Please provide a clear and concise description of what you want to happen.
+ placeholder: ex. When using XiaoZhi ...
+ - type: textarea
+ id: alternatives
+ attributes:
+ label: Describe alternatives you've considered.
+ description: Please provide a clear and concise description of any alternative solutions or features you've considered.
+ placeholder: ex. Choosing other approach wouldn't work, because ...
+ - type: textarea
+ id: context
+ attributes:
+ label: Additional context.
+ description: Please add any other context or screenshots about the feature request here.
placeholder: ex. This would work only when ...
\ No newline at end of file
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
index d663ce7..5e83fcc 100644
--- a/.github/ISSUE_TEMPLATE/config.yml
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -1,8 +1,8 @@
-blank_issues_enabled: true
-contact_links:
- - name: 小智 AI 官方网站
- url: https://xiaozhi.me/
- about: 激活设备、配置 AI、声纹识别、声音克隆等应有尽有,DIY 属于你自己的小智
- - name: 小智 AI 聊天机器人百科全书
- url: https://ccnphfhqs21z.feishu.cn/wiki/F5krwD16viZoF0kKkvDcrZNYnhb
+blank_issues_enabled: true
+contact_links:
+ - name: 小智 AI 官方网站
+ url: https://xiaozhi.me/
+ about: 激活设备、配置 AI、声纹识别、声音克隆等应有尽有,DIY 属于你自己的小智
+ - name: 小智 AI 聊天机器人百科全书
+ url: https://ccnphfhqs21z.feishu.cn/wiki/F5krwD16viZoF0kKkvDcrZNYnhb
about: 开发文档、硬件制作、烧录教程、FAQ尽在小智百科
\ No newline at end of file
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
new file mode 100644
index 0000000..dcfd98f
--- /dev/null
+++ b/.github/workflows/build.yml
@@ -0,0 +1,111 @@
+name: Build Boards
+
+on:
+ push:
+ branches:
+ - main
+ - ci/* # for ci test
+ pull_request:
+ branches:
+ - main
+
+permissions:
+ contents: read
+
+jobs:
+ prepare:
+ name: Determine variants to build
+ runs-on: ubuntu-latest
+ outputs:
+ variants: ${{ steps.select.outputs.variants }}
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v4
+ with:
+ fetch-depth: 0
+
+ - name: Install jq
+ run: sudo apt-get update && sudo apt-get install -y jq
+
+ - id: list
+ name: Get all variant list
+ run: |
+ echo "all_variants=$(python scripts/release.py --list-boards --json)" >> $GITHUB_OUTPUT
+
+ - id: select
+ name: Select variants based on changes
+ env:
+ ALL_VARIANTS: ${{ steps.list.outputs.all_variants }}
+ run: |
+ EVENT_NAME="${{ github.event_name }}"
+
+ # push 到 main 分支,编译全部变体
+ if [[ "$EVENT_NAME" == "push" ]]; then
+ echo "variants=$ALL_VARIANTS" >> $GITHUB_OUTPUT
+ exit 0
+ fi
+
+ # pull_request 场景
+ BASE_SHA="${{ github.event.pull_request.base.sha }}"
+ HEAD_SHA="${{ github.event.pull_request.head.sha }}"
+ echo "Base: $BASE_SHA, Head: $HEAD_SHA"
+
+ CHANGED=$(git diff --name-only $BASE_SHA $HEAD_SHA || true)
+ echo -e "Changed files:\n$CHANGED"
+
+ NEED_ALL=0
+ declare -A AFFECTED
+ while IFS= read -r file; do
+ if [[ "$file" == main/* && "$file" != main/boards/* ]]; then
+ NEED_ALL=1
+ fi
+
+ if [[ "$file" == main/boards/common/* ]]; then
+ NEED_ALL=1
+ fi
+
+ if [[ "$file" == main/boards/* ]]; then
+ board=$(echo "$file" | cut -d '/' -f3)
+ AFFECTED[$board]=1
+ fi
+ done <<< "$CHANGED"
+
+ if [[ "$NEED_ALL" -eq 1 ]]; then
+ echo "variants=$ALL_VARIANTS" >> $GITHUB_OUTPUT
+ else
+ if [[ ${#AFFECTED[@]} -eq 0 ]]; then
+ echo "variants=[]" >> $GITHUB_OUTPUT
+ else
+ BOARDS_JSON=$(printf '%s\n' "${!AFFECTED[@]}" | sort -u | jq -R -s -c 'split("\n")[:-1]')
+ FILTERED=$(echo "$ALL_VARIANTS" | jq -c --argjson boards "$BOARDS_JSON" 'map(select(.board as $b | $boards | index($b)))')
+ echo "variants=$FILTERED" >> $GITHUB_OUTPUT
+ fi
+ fi
+
+ build:
+ name: Build ${{ matrix.name }}
+ needs: prepare
+ if: ${{ needs.prepare.outputs.variants != '[]' }}
+ strategy:
+ fail-fast: false # 单个变体失败不影响其它变体
+ matrix:
+ include: ${{ fromJson(needs.prepare.outputs.variants) }}
+ runs-on: ubuntu-latest
+ container:
+ image: espressif/idf:release-v5.4
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v4
+
+ - name: Build current variant
+ shell: bash
+ run: |
+ source $IDF_PATH/export.sh
+ python scripts/release.py ${{ matrix.board }} --name ${{ matrix.name }}
+
+ - name: Upload artifacts
+ uses: actions/upload-artifact@v4
+ with:
+ name: xiaozhi_${{ matrix.name }}_${{ github.sha }}.bin
+ path: build/merged-binary.bin
+ if-no-files-found: error
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..c5af22d
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,18 @@
+tmp/
+components/
+managed_components/
+build/
+.vscode/
+.devcontainer/
+sdkconfig.old
+sdkconfig
+dependencies.lock
+.env
+releases/
+main/assets/lang_config.h
+main/mmap_generate_emoji.h
+.DS_Store
+.cache
+*.pyc
+*.bin
+mmap_generate_*.h
diff --git a/CMakeLists.txt b/CMakeLists.txt
old mode 100755
new mode 100644
index 9054045..c39d567
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -1,13 +1,17 @@
-# For more information about build system see
-# https://docs.espressif.com/projects/esp-idf/en/latest/api-guides/build-system.html
-# The following five lines of boilerplate have to be in your project's
-# CMakeLists in this exact order for cmake to work correctly
-cmake_minimum_required(VERSION 3.16)
-
-set(PROJECT_VER "2.0.1")
-
-# Add this line to disable the specific warning
-add_compile_options(-Wno-missing-field-initializers)
-
-include($ENV{IDF_PATH}/tools/cmake/project.cmake)
-project(xiaozhi)
\ No newline at end of file
+# For more information about build system see
+# https://docs.espressif.com/projects/esp-idf/en/latest/api-guides/build-system.html
+# The following five lines of boilerplate have to be in your project's
+# CMakeLists in this exact order for cmake to work correctly
+cmake_minimum_required(VERSION 3.16)
+
+set(PROJECT_VER "2.0.3")
+
+# Add this line to disable the specific warning
+add_compile_options(-Wno-missing-field-initializers)
+
+# Fix Windows command line length limit
+set(CMAKE_NINJA_FORCE_RESPONSE_FILE 1)
+
+include($ENV{IDF_PATH}/tools/cmake/project.cmake)
+project(xiaozhi)
+
diff --git a/LICENSE b/LICENSE
index e90b554..099ed95 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,22 +1,22 @@
-MIT License
-
-Copyright (c) 2025 Shenzhen Xinzhi Future Technology Co., Ltd.
-Copyright (c) 2025 Project Contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Shenzhen Xinzhi Future Technology Co., Ltd.
+Copyright (c) 2025 Project Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/README.md b/README.md
index 5dbccaa..792901d 100644
--- a/README.md
+++ b/README.md
@@ -1,218 +1,171 @@
-# 超级小智-ESP32
-(中文 | English(编写中) | 日本語(编写中))
-
-基于 https://github.com/78/xiaozhi-esp32 改良的船新版本
-
-## 💡介绍
-这是一个由虾哥开源的 ESP32 项目,以 MIT 许可证发布,允许任何人免费使用,或用于商业用途。
-
-我们希望通过这个项目,能够帮助大家了解 AI 硬件开发,将当下飞速发展的大语言模型应用到实际的硬件设备中。
-
-如果你有任何想法或建议,请随时提出 Issues 或加入 QQ 群:暂无,Telegram群:暂无。
-
-项目主要贡献者:小霜霜Meow(抖音、B站UP)、空白泡泡糖果(B站UP),硅灵造物科技(B站UP)
-
-项目其它贡献者:[@zhubinsheng](https://github.com/zhubinsheng)
-
-贡献者说明:引入部分其它贡献者在其它项目上的代码,并进行了部分修改。
-
-音乐服务器、相关源码提供者(为爱发电):小霜霜Meow
-
-音乐服务器源码请见 https://github.com/IntelligentlyEverything/MeowMusicServer
-
-### ❕注意事项
-1. 如果小智说找不到歌曲怎么办?
-进入[小智后台](https://xiaozhi.me/),找到对应设备,修改角色配置
-- 选择 DeepSeekV3 大语言模型
-- 在人物介绍中填入
- - 收到音乐相关的需求时,只使用 MPC tool self.music.play_song 工具,同时禁止使用 search_music 功能。
-
-2. 内置API调用失败怎么办?
-请查看具体错误代码后,加入QQ群:865754861,或电报群 http://t.me/MeowMusicServer 给出错误代码和日志,等待我们修复。
-
-### ⚙️已支持硬件芯片系列
-
-- ESP32
-- ESP32-S3
-- ESP32-C3
-- ESP32-C6
-- ESP32-P4
-
-❕大部分硬件由于没有进行完整测试,可能会存在一些问题,属于正常现象,具体可提交issues进行反馈。
-
-### 项目改动范围
-新增:
-- main/schedule_manager.h
-- main/schedule_manager.cc
-- main/audio/timer_manager.h
-- main/audio/timer_manager.cc
-- main/boards/common/music.h
-- main/boards/common/esp32_music.h
-- main/boards/common/esp32_music.cc
-- main/display/esplog_display.h
-- main/display/esplog_display.cc
-- main/protocols/sleep_music_protocol.h
-- main/protocols/sleep_music_protocol.cc
-
-修改:
-- main/audio/codecs/no_audio_codec.h
-- main/audio/codecs/no_audio_codec.cc
-- main/audio/audio_codec.h
-- main/audio/audio_codec.cc
-- main/audio/audio_service.h
-- main/audio/audio_service.cc
-- main/boards/common/board.h
-- main/boards/common/board.cc
-- main/display/display.h
-- main/display/display.cc
-- main/display/lcd_display.h
-- main/display/lcd_display.cc
-- main/application.h
-- main/application.cc
-- main/idf_component.yml
-- main/mcp_server.cc
-
-### 基于 MCP 控制万物
-小智 AI 聊天机器人作为一个语音交互入口,利用 Qwen / DeepSeek 等大模型的 AI 能力,通过 MCP 协议实现多端控制。
-
-
-
-### 已实现功能
-
-- Wi-Fi / ML307 Cat.1 4G
-- 离线语音唤醒 [ESP-SR](https://github.com/espressif/esp-sr)
-- 支持两种通信协议([Websocket](docs/websocket.md) 或 MQTT+UDP)
-- 采用 OPUS 音频编解码
-- 基于流式 ASR + LLM + TTS 架构的语音交互
-- 声纹识别,识别当前说话人的身份 [3D Speaker](https://github.com/modelscope/3D-Speaker)
-- OLED / LCD 显示屏,支持表情显示
-- 电量显示与电源管理
-- 支持多语言(中文、英文、日文)
-- 支持 ESP32-C3、ESP32-S3、ESP32-P4 芯片平台
-- 通过设备端 MCP 实现设备控制(音量、灯光、电机、GPIO 等)
-- 通过云端 MCP 扩展大模型能力(智能家居控制、PC桌面操作、知识搜索、邮件收发等)
-本项目新增功能:
-- 新增音乐播放功能,支持播放本地音乐(开发中,敬请期待)、云端音乐(完善中)。
-
-## 硬件
-
-### 面包板手工制作实践
-
-详见飞书文档教程:
-
-👉 [《小智 AI 聊天机器人百科全书》](https://ccnphfhqs21z.feishu.cn/wiki/F5krwD16viZoF0kKkvDcrZNYnhb?from=from_copylink)
-
-面包板效果图如下:
-
-
-
-### 支持 70 多个开源硬件(仅展示部分)
-
-- 立创·实战派 ESP32-S3 开发板
-- 乐鑫 ESP32-S3-BOX3
-- M5Stack CoreS3
-- M5Stack AtomS3R + Echo Base
-- 神奇按钮 2.4
-- 微雪电子 ESP32-S3-Touch-AMOLED-1.8
-- LILYGO T-Circle-S3
-- 虾哥 Mini C3
-- 璀璨·AI 吊坠
-- 无名科技 Nologo-星智-1.54TFT
-- SenseCAP Watcher
-- ESP-HI 超低成本机器狗
-
-
-
-## 软件
-
-### 固件烧录
-
-新手第一次操作建议先不要搭建开发环境,直接使用免开发环境烧录的固件。
-
-固件默认接入 [xiaozhi.me](https://xiaozhi.me) 官方服务器,个人用户注册账号可以免费使用 Qwen 实时模型。
-
-👉 [新手烧录固件教程](https://ccnphfhqs21z.feishu.cn/wiki/Zpz4wXBtdimBrLk25WdcXzxcnNS)
-
-### 开发环境
-
-- Cursor 或 VSCode
-- 安装 ESP-IDF 插件,选择 SDK 版本 5.4 或以上
-- Linux 比 Windows 更好,编译速度快,也免去驱动问题的困扰
-- 本项目使用 Google C++ 代码风格,提交代码时请确保符合规范
-
-### 开发者文档
-
-- [自定义开发板指南](main/boards/README.md) - 学习如何为小智 AI 创建自定义开发板
-- [MCP 协议物联网控制用法说明](docs/mcp-usage.md) - 了解如何通过 MCP 协议控制物联网设备
-- [MCP 协议交互流程](docs/mcp-protocol.md) - 设备端 MCP 协议的实现方式
-- [MQTT + UDP 混合通信协议文档](docs/mqtt-udp.md)
-- [一份详细的 WebSocket 通信协议文档](docs/websocket.md)
-
-## 大模型配置
-
-如果你已经拥有一个小智 AI 聊天机器人设备,并且已接入官方服务器,可以登录 [xiaozhi.me](https://xiaozhi.me) 控制台进行配置。
-
-👉 [后台操作视频教程(旧版界面)](https://www.bilibili.com/video/BV1jUCUY2EKM/)
-
-## 相关开源项目
-
-在个人电脑上部署服务器,可以参考以下第三方开源的项目:
-
-- [xinnan-tech/xiaozhi-esp32-server](https://github.com/xinnan-tech/xiaozhi-esp32-server) Python 服务器
-- [joey-zhou/xiaozhi-esp32-server-java](https://github.com/joey-zhou/xiaozhi-esp32-server-java) Java 服务器
-- [AnimeAIChat/xiaozhi-server-go](https://github.com/AnimeAIChat/xiaozhi-server-go) Golang 服务器
-
-使用小智通信协议的第三方客户端项目:
-
-- [huangjunsen0406/py-xiaozhi](https://github.com/huangjunsen0406/py-xiaozhi) Python 客户端
-- [TOM88812/xiaozhi-android-client](https://github.com/TOM88812/xiaozhi-android-client) Android 客户端
-- [100askTeam/xiaozhi-linux](http://github.com/100askTeam/xiaozhi-linux) 百问科技提供的 Linux 客户端
-- [78/xiaozhi-sf32](https://github.com/78/xiaozhi-sf32) 思澈科技的蓝牙芯片固件
-- [QuecPython/solution-xiaozhiAI](https://github.com/QuecPython/solution-xiaozhiAI) 移远提供的 QuecPython 固件
-
-## Star History
-
-
-
-
-
-
-
-
+# An MCP-based Chatbot | 一个基于 MCP 的聊天机器人
+
+(中文 | [English](README_en.md) | [日本語](README_ja.md))
+
+## 视频
+
+👉 [人类:给 AI 装摄像头 vs AI:当场发现主人三天没洗头【bilibili】](https://www.bilibili.com/video/BV1bpjgzKEhd/)
+
+👉 [手工打造你的 AI 女友,新手入门教程【bilibili】](https://www.bilibili.com/video/BV1XnmFYLEJN/)
+
+## 介绍
+
+这是一个由虾哥开源的 ESP32 项目,以 MIT 许可证发布,允许任何人免费使用,或用于商业用途。
+
+我们希望通过这个项目,能够帮助大家了解 AI 硬件开发,将当下飞速发展的大语言模型应用到实际的硬件设备中。
+
+如果你有任何想法或建议,请随时提出 Issues 或加入 QQ 群:1011329060
+
+项目其它贡献者:@zhubinsheng
+
+贡献者说明:引入部分其它贡献者在其它项目上的代码,并进行了部分修改。
+
+音乐服务器相关源码提供者(为爱发电):小霜霜Meow
+
+感谢群友 cz 提供音乐服务器
+
+音乐服务器源码请见 https://github.com/IntelligentlyEverything/MeowMusicServer
+
+### 基于 MCP 控制万物
+
+小智 AI 聊天机器人作为一个语音交互入口,利用 Qwen / DeepSeek 等大模型的 AI 能力,通过 MCP 协议实现多端控制。
+
+
+
+### 已实现功能
+
+- Wi-Fi / ML307 Cat.1 4G
+- 离线语音唤醒 [ESP-SR](https://github.com/espressif/esp-sr)
+- 支持两种通信协议([Websocket](docs/websocket.md) 或 MQTT+UDP)
+- 采用 OPUS 音频编解码
+- 基于流式 ASR + LLM + TTS 架构的语音交互
+- 声纹识别,识别当前说话人的身份 [3D Speaker](https://github.com/modelscope/3D-Speaker)
+- OLED / LCD 显示屏,支持表情显示
+- 电量显示与电源管理
+- 支持多语言(中文、英文、日文)
+- 支持 ESP32-C3、ESP32-S3、ESP32-P4 芯片平台
+- 通过设备端 MCP 实现设备控制(音量、灯光、电机、GPIO 等)
+- 通过云端 MCP 扩展大模型能力(智能家居控制、PC桌面操作、知识搜索、邮件收发等)
+
+## 硬件
+
+### 面包板手工制作实践
+
+详见飞书文档教程:
+
+👉 [《小智 AI 聊天机器人百科全书》](https://ccnphfhqs21z.feishu.cn/wiki/F5krwD16viZoF0kKkvDcrZNYnhb?from=from_copylink)
+
+面包板效果图如下:
+
+
+
+### 支持 70 多个开源硬件(仅展示部分)
+
+- 立创·实战派 ESP32-S3 开发板
+- 乐鑫 ESP32-S3-BOX3
+- M5Stack CoreS3
+- M5Stack AtomS3R + Echo Base
+- 神奇按钮 2.4
+- 微雪电子 ESP32-S3-Touch-AMOLED-1.8
+- LILYGO T-Circle-S3
+- 虾哥 Mini C3
+- 璀璨·AI 吊坠
+- 无名科技 Nologo-星智-1.54TFT
+- SenseCAP Watcher
+- ESP-HI 超低成本机器狗
+
+
+
+## 软件
+
+### 固件烧录
+
+新手第一次操作建议先不要搭建开发环境,直接使用免开发环境烧录的固件。
+
+固件默认接入 [xiaozhi.me](https://xiaozhi.me) 官方服务器,个人用户注册账号可以免费使用 Qwen 实时模型。
+
+👉 [新手烧录固件教程](https://ccnphfhqs21z.feishu.cn/wiki/Zpz4wXBtdimBrLk25WdcXzxcnNS)
+
+### 开发环境
+
+- Cursor 或 VSCode
+- 安装 ESP-IDF 插件,选择 SDK 版本 5.4 或以上
+- Linux 比 Windows 更好,编译速度快,也免去驱动问题的困扰
+- 本项目使用 Google C++ 代码风格,提交代码时请确保符合规范
+
+### 开发者文档
+
+- [自定义开发板指南](main/boards/README.md) - 学习如何为小智 AI 创建自定义开发板
+- [MCP 协议物联网控制用法说明](docs/mcp-usage.md) - 了解如何通过 MCP 协议控制物联网设备
+- [MCP 协议交互流程](docs/mcp-protocol.md) - 设备端 MCP 协议的实现方式
+- [MQTT + UDP 混合通信协议文档](docs/mqtt-udp.md)
+- [一份详细的 WebSocket 通信协议文档](docs/websocket.md)
+
+## 大模型配置
+
+如果你已经拥有一个小智 AI 聊天机器人设备,并且已接入官方服务器,可以登录 [xiaozhi.me](https://xiaozhi.me) 控制台进行配置。
+
+👉 [后台操作视频教程(旧版界面)](https://www.bilibili.com/video/BV1jUCUY2EKM/)
+
+## 相关开源项目
+
+在个人电脑上部署服务器,可以参考以下第三方开源的项目:
+
+- [xinnan-tech/xiaozhi-esp32-server](https://github.com/xinnan-tech/xiaozhi-esp32-server) Python 服务器
+- [joey-zhou/xiaozhi-esp32-server-java](https://github.com/joey-zhou/xiaozhi-esp32-server-java) Java 服务器
+- [AnimeAIChat/xiaozhi-server-go](https://github.com/AnimeAIChat/xiaozhi-server-go) Golang 服务器
+
+使用小智通信协议的第三方客户端项目:
+
+- [huangjunsen0406/py-xiaozhi](https://github.com/huangjunsen0406/py-xiaozhi) Python 客户端
+- [TOM88812/xiaozhi-android-client](https://github.com/TOM88812/xiaozhi-android-client) Android 客户端
+- [100askTeam/xiaozhi-linux](http://github.com/100askTeam/xiaozhi-linux) 百问科技提供的 Linux 客户端
+- [78/xiaozhi-sf32](https://github.com/78/xiaozhi-sf32) 思澈科技的蓝牙芯片固件
+- [QuecPython/solution-xiaozhiAI](https://github.com/QuecPython/solution-xiaozhiAI) 移远提供的 QuecPython 固件
+
+## Star History
+
+
+
+
+
+
+
+
diff --git a/README_en.md b/README_en.md
new file mode 100644
index 0000000..432c768
--- /dev/null
+++ b/README_en.md
@@ -0,0 +1,157 @@
+# An MCP-based Chatbot
+
+(English | [中文](README.md) | [日本語](README_ja.md))
+
+## Video
+
+👉 [Human: Give AI a camera vs AI: Instantly finds out the owner hasn't washed hair for three days【bilibili】](https://www.bilibili.com/video/BV1bpjgzKEhd/)
+
+👉 [Handcraft your AI girlfriend, beginner's guide【bilibili】](https://www.bilibili.com/video/BV1XnmFYLEJN/)
+
+## Introduction
+
+This is an open-source ESP32 project, released under the MIT license, allowing anyone to use it for free, including for commercial purposes.
+
+We hope this project helps everyone understand AI hardware development and apply rapidly evolving large language models to real hardware devices.
+
+If you have any ideas or suggestions, please feel free to raise Issues or join the QQ group: 1011329060
+
+### Control Everything with MCP
+
+As a voice interaction entry, the XiaoZhi AI chatbot leverages the AI capabilities of large models like Qwen / DeepSeek, and achieves multi-terminal control via the MCP protocol.
+
+
+
+### Features Implemented
+
+- Wi-Fi / ML307 Cat.1 4G
+- Offline voice wake-up [ESP-SR](https://github.com/espressif/esp-sr)
+- Supports two communication protocols ([Websocket](docs/websocket.md) or MQTT+UDP)
+- Uses OPUS audio codec
+- Voice interaction based on streaming ASR + LLM + TTS architecture
+- Speaker recognition, identifies the current speaker [3D Speaker](https://github.com/modelscope/3D-Speaker)
+- OLED / LCD display, supports emoji display
+- Battery display and power management
+- Multi-language support (Chinese, English, Japanese)
+- Supports ESP32-C3, ESP32-S3, ESP32-P4 chip platforms
+- Device-side MCP for device control (Speaker, LED, Servo, GPIO, etc.)
+- Cloud-side MCP to extend large model capabilities (smart home control, PC desktop operation, knowledge search, email, etc.)
+
+## Hardware
+
+### Breadboard DIY Practice
+
+See the Feishu document tutorial:
+
+👉 ["XiaoZhi AI Chatbot Encyclopedia"](https://ccnphfhqs21z.feishu.cn/wiki/F5krwD16viZoF0kKkvDcrZNYnhb?from=from_copylink)
+
+Breadboard demo:
+
+
+
+### Supports 70+ Open Source Hardware (Partial List)
+
+- LiChuang ESP32-S3 Development Board
+- Espressif ESP32-S3-BOX3
+- M5Stack CoreS3
+- M5Stack AtomS3R + Echo Base
+- Magic Button 2.4
+- Waveshare ESP32-S3-Touch-AMOLED-1.8
+- LILYGO T-Circle-S3
+- XiaGe Mini C3
+- CuiCan AI Pendant
+- WMnologo-Xingzhi-1.54TFT
+- SenseCAP Watcher
+- ESP-HI Low Cost Robot Dog
+
+
+
+## Software
+
+### Firmware Flashing
+
+For beginners, it is recommended to use the firmware that can be flashed without setting up a development environment.
+
+The firmware connects to the official [xiaozhi.me](https://xiaozhi.me) server by default. Personal users can register an account to use the Qwen real-time model for free.
+
+👉 [Beginner's Firmware Flashing Guide](https://ccnphfhqs21z.feishu.cn/wiki/Zpz4wXBtdimBrLk25WdcXzxcnNS)
+
+### Development Environment
+
+- Cursor or VSCode
+- Install ESP-IDF plugin, select SDK version 5.4 or above
+- Linux is better than Windows for faster compilation and fewer driver issues
+- This project uses Google C++ code style, please ensure compliance when submitting code
+
+### Developer Documentation
+
+- [Custom Board Guide](main/boards/README.md) - Learn how to create custom boards for XiaoZhi AI
+- [MCP Protocol IoT Control Usage](docs/mcp-usage.md) - Learn how to control IoT devices via MCP protocol
+- [MCP Protocol Interaction Flow](docs/mcp-protocol.md) - Device-side MCP protocol implementation
+- [A detailed WebSocket communication protocol document](docs/websocket.md)
+
+## Large Model Configuration
+
+If you already have a XiaoZhi AI chatbot device and have connected to the official server, you can log in to the [xiaozhi.me](https://xiaozhi.me) console for configuration.
+
+👉 [Backend Operation Video Tutorial (Old Interface)](https://www.bilibili.com/video/BV1jUCUY2EKM/)
+
+## Related Open Source Projects
+
+For server deployment on personal computers, refer to the following open-source projects:
+
+- [xinnan-tech/xiaozhi-esp32-server](https://github.com/xinnan-tech/xiaozhi-esp32-server) Python server
+- [joey-zhou/xiaozhi-esp32-server-java](https://github.com/joey-zhou/xiaozhi-esp32-server-java) Java server
+- [AnimeAIChat/xiaozhi-server-go](https://github.com/AnimeAIChat/xiaozhi-server-go) Golang server
+
+Other client projects using the XiaoZhi communication protocol:
+
+- [huangjunsen0406/py-xiaozhi](https://github.com/huangjunsen0406/py-xiaozhi) Python client
+- [TOM88812/xiaozhi-android-client](https://github.com/TOM88812/xiaozhi-android-client) Android client
+
+## Star History
+
+
+
+
+
+
+
+
diff --git a/README_ja.md b/README_ja.md
new file mode 100644
index 0000000..c01acf8
--- /dev/null
+++ b/README_ja.md
@@ -0,0 +1,157 @@
+# MCP ベースのチャットボット
+
+(日本語 | [中文](README.md) | [English](README_en.md))
+
+## 動画
+
+👉 [人間:AIにカメラを装着 vs AI:その場で飼い主が3日間髪を洗っていないことを発見【bilibili】](https://www.bilibili.com/video/BV1bpjgzKEhd/)
+
+👉 [手作りでAIガールフレンドを作る、初心者入門チュートリアル【bilibili】](https://www.bilibili.com/video/BV1XnmFYLEJN/)
+
+## イントロダクション
+
+これはエビ兄さんがオープンソースで公開しているESP32プロジェクトで、MITライセンスのもと、誰でも無料で、商用利用も可能です。
+
+このプロジェクトを通じて、AIハードウェア開発を理解し、急速に進化する大規模言語モデルを実際のハードウェアデバイスに応用できるようになることを目指しています。
+
+ご意見やご提案があれば、いつでもIssueを提出するか、QQグループ:1011329060 にご参加ください。
+
+### MCPであらゆるものを制御
+
+シャオジーAIチャットボットは音声インタラクションの入口として、Qwen / DeepSeekなどの大規模モデルのAI能力を活用し、MCPプロトコルを通じてマルチエンド制御を実現します。
+
+
+
+### 実装済み機能
+
+- Wi-Fi / ML307 Cat.1 4G
+- オフライン音声ウェイクアップ [ESP-SR](https://github.com/espressif/esp-sr)
+- 2種類の通信プロトコルに対応([Websocket](docs/websocket.md) または MQTT+UDP)
+- OPUSオーディオコーデックを採用
+- ストリーミングASR + LLM + TTSアーキテクチャに基づく音声インタラクション
+- 話者認識、現在話している人を識別 [3D Speaker](https://github.com/modelscope/3D-Speaker)
+- OLED / LCDディスプレイ、表情表示対応
+- バッテリー表示と電源管理
+- 多言語対応(中国語、英語、日本語)
+- ESP32-C3、ESP32-S3、ESP32-P4チッププラットフォーム対応
+- デバイス側MCPによるデバイス制御(音量・明るさ調整、アクション制御など)
+- クラウド側MCPで大規模モデル能力を拡張(スマートホーム制御、PCデスクトップ操作、知識検索、メール送受信など)
+
+## ハードウェア
+
+### ブレッドボード手作り実践
+
+Feishuドキュメントチュートリアルをご覧ください:
+
+👉 [「シャオジーAIチャットボット百科事典」](https://ccnphfhqs21z.feishu.cn/wiki/F5krwD16viZoF0kKkvDcrZNYnhb?from=from_copylink)
+
+ブレッドボードのデモ:
+
+
+
+### 70種類以上のオープンソースハードウェアに対応(一部のみ表示)
+
+- 立創・実戦派 ESP32-S3 開発ボード
+- 楽鑫 ESP32-S3-BOX3
+- M5Stack CoreS3
+- M5Stack AtomS3R + Echo Base
+- マジックボタン2.4
+- 微雪電子 ESP32-S3-Touch-AMOLED-1.8
+- LILYGO T-Circle-S3
+- エビ兄さん Mini C3
+- CuiCan AIペンダント
+- 無名科技Nologo-星智-1.54TFT
+- SenseCAP Watcher
+- ESP-HI 超低コストロボット犬
+
+
+
+## ソフトウェア
+
+### ファームウェア書き込み
+
+初心者の方は、まず開発環境を構築せずに書き込み可能なファームウェアを使用することをおすすめします。
+
+ファームウェアはデフォルトで公式 [xiaozhi.me](https://xiaozhi.me) サーバーに接続します。個人ユーザーはアカウント登録でQwenリアルタイムモデルを無料で利用できます。
+
+👉 [初心者向けファームウェア書き込みガイド](https://ccnphfhqs21z.feishu.cn/wiki/Zpz4wXBtdimBrLk25WdcXzxcnNS)
+
+### 開発環境
+
+- Cursor または VSCode
+- ESP-IDFプラグインをインストールし、SDKバージョン5.4以上を選択
+- LinuxはWindowsよりも優れており、コンパイルが速く、ドライバの問題も少ない
+- 本プロジェクトはGoogle C++コードスタイルを採用、コード提出時は準拠を確認してください
+
+### 開発者ドキュメント
+
+- [カスタム開発ボードガイド](main/boards/README.md) - シャオジーAI用のカスタム開発ボード作成方法
+- [MCPプロトコルIoT制御使用法](docs/mcp-usage.md) - MCPプロトコルでIoTデバイスを制御する方法
+- [MCPプロトコルインタラクションフロー](docs/mcp-protocol.md) - デバイス側MCPプロトコルの実装方法
+- [詳細なWebSocket通信プロトコルドキュメント](docs/websocket.md)
+
+## 大規模モデル設定
+
+すでにシャオジーAIチャットボットデバイスをお持ちで、公式サーバーに接続済みの場合は、[xiaozhi.me](https://xiaozhi.me) コンソールで設定できます。
+
+👉 [バックエンド操作ビデオチュートリアル(旧インターフェース)](https://www.bilibili.com/video/BV1jUCUY2EKM/)
+
+## 関連オープンソースプロジェクト
+
+個人PCでサーバーをデプロイする場合は、以下のオープンソースプロジェクトを参照してください:
+
+- [xinnan-tech/xiaozhi-esp32-server](https://github.com/xinnan-tech/xiaozhi-esp32-server) Pythonサーバー
+- [joey-zhou/xiaozhi-esp32-server-java](https://github.com/joey-zhou/xiaozhi-esp32-server-java) Javaサーバー
+- [AnimeAIChat/xiaozhi-server-go](https://github.com/AnimeAIChat/xiaozhi-server-go) Golangサーバー
+
+シャオジー通信プロトコルを利用した他のクライアントプロジェクト:
+
+- [huangjunsen0406/py-xiaozhi](https://github.com/huangjunsen0406/py-xiaozhi) Pythonクライアント
+- [TOM88812/xiaozhi-android-client](https://github.com/TOM88812/xiaozhi-android-client) Androidクライアント
+
+## スター履歴
+
+
+
+
+
+
+
+
diff --git a/SERVER_CONFIG_GUIDE.md b/SERVER_CONFIG_GUIDE.md
new file mode 100644
index 0000000..91192e8
--- /dev/null
+++ b/SERVER_CONFIG_GUIDE.md
@@ -0,0 +1,228 @@
+# ESP32服务器地址配置指南
+
+## 📍 **配置文件位置**
+
+```
+xiaozhi-esp32_music/main/server_config.h
+```
+
+## 🔧 **如何修改服务器地址**
+
+### **步骤1:查看您的服务器IP地址**
+
+#### **Windows系统**
+打开命令提示符(CMD),输入:
+```cmd
+ipconfig
+```
+
+查找"IPv4 地址",例如:`192.168.1.100`
+
+#### **Linux/Mac系统**
+打开终端,输入:
+```bash
+ifconfig
+# 或
+ip addr
+```
+
+查找局域网IP地址。
+
+---
+
+### **步骤2:编辑配置文件**
+
+打开文件:
+```
+d:\esp32-music-server\Meow\MeowEmbeddedMusicServer\xiaozhi-esp32_music\xiaozhi-esp32_music\main\server_config.h
+```
+
+找到这一行:
+```cpp
+#define MUSIC_SERVER_URL "http://192.168.1.100:2233"
+```
+
+将 `192.168.1.100` 替换为您的服务器IP地址。
+
+---
+
+## 🌐 **配置示例**
+
+### **示例1:本地局域网(推荐)**
+
+服务器和ESP32在同一个WiFi网络中:
+
+```cpp
+#define MUSIC_SERVER_URL "http://192.168.1.100:2233"
+```
+
+**优点**:
+- ✅ 速度快
+- ✅ 延迟低
+- ✅ 不需要公网IP
+
+---
+
+### **示例2:公网IP**
+
+如果您有公网IP或使用花生壳等内网穿透:
+
+```cpp
+#define MUSIC_SERVER_URL "http://123.45.67.89:2233"
+```
+
+**注意**:
+- ⚠️ 确保路由器端口转发2233端口
+- ⚠️ 注意服务器安全
+
+---
+
+### **示例3:域名**
+
+如果您有域名:
+
+```cpp
+#define MUSIC_SERVER_URL "http://your-music-server.com:2233"
+```
+
+**注意**:
+- ⚠️ 确保域名解析正确
+- ⚠️ 如果使用HTTPS,改为`https://`
+
+---
+
+### **示例4:使用原作者在线服务器**
+
+```cpp
+#define MUSIC_SERVER_URL "http://http-embedded-music.miao-lab.top:2233"
+```
+
+**说明**:
+- ✅ 无需自己搭建服务器
+- ⚠️ 依赖外部服务可用性
+- ⚠️ 无法使用设备绑定等个性化功能
+
+---
+
+## 🔍 **如何测试服务器地址是否正确**
+
+### **方法1:浏览器测试**
+
+在浏览器中访问:
+```
+http://您的服务器IP:2233
+```
+
+应该看到Meow Music的Web界面。
+
+---
+
+### **方法2:curl测试**
+
+```bash
+curl http://您的服务器IP:2233/api/search?song=江南
+```
+
+应该返回JSON格式的搜索结果。
+
+---
+
+## 📝 **完整配置检查清单**
+
+- [ ] 确认服务器正在运行(`go run .`)
+- [ ] 确认服务器端口是2233
+- [ ] 确认ESP32和服务器在同一网络(或有公网连接)
+- [ ] 修改`server_config.h`中的IP地址
+- [ ] 保存文件
+- [ ] 重新编译ESP32固件(`idf.py build`)
+- [ ] 烧录到ESP32(`idf.py flash`)
+- [ ] 测试连接
+
+---
+
+## 🐛 **常见问题**
+
+### **问题1:ESP32无法连接服务器**
+
+**现象**:
+```
+[Esp32Music] Failed to connect to music API
+```
+
+**排查**:
+1. 检查服务器是否运行
+2. 检查IP地址是否正确
+3. 检查ESP32是否连接WiFi
+4. Ping服务器IP测试网络连通性
+
+---
+
+### **问题2:地址写错了**
+
+**现象**:
+```
+[Esp32Music] HTTP GET failed with status code: 404
+```
+
+**解决**:
+- 检查URL格式是否正确
+- 确保有`http://`前缀
+- 确保端口号是`:2233`
+
+---
+
+### **问题3:防火墙阻止**
+
+**现象**:
+- ESP32无法连接
+- 但浏览器可以访问
+
+**解决(Windows)**:
+```
+控制面板 → Windows防火墙 → 允许应用通过防火墙
+→ 找到Go程序 → 允许专用和公用网络
+```
+
+---
+
+## 🎯 **推荐配置**
+
+### **开发测试阶段**
+
+使用局域网IP:
+```cpp
+#define MUSIC_SERVER_URL "http://192.168.1.100:2233"
+```
+
+### **生产环境**
+
+使用域名:
+```cpp
+#define MUSIC_SERVER_URL "http://music.your-domain.com:2233"
+```
+
+---
+
+## 💡 **高级技巧**
+
+### **使用环境变量(未来功能)**
+
+可以考虑在ESP32端添加NVS配置,通过Web界面修改服务器地址,无需重新编译。
+
+### **mDNS服务发现(未来功能)**
+
+可以使用mDNS实现服务器自动发现:
+```
+http://meow-music.local:2233
+```
+
+---
+
+## 📞 **技术支持**
+
+如有问题,请加入:
+**喵波音律QQ交流群:865754861**
+
+---
+
+**配置完成后,记得重新编译并烧录固件!** 🚀
diff --git a/combine.exe b/combine.exe
new file mode 100755
index 0000000..b77470e
Binary files /dev/null and b/combine.exe differ
diff --git a/docs/mcp-protocol.md b/docs/mcp-protocol.md
index 0c8ec90..65860e0 100644
--- a/docs/mcp-protocol.md
+++ b/docs/mcp-protocol.md
@@ -1,269 +1,269 @@
-# MCP (Model Context Protocol) 交互流程
-
-NOTICE: AI 辅助生成, 在实现后台服务时, 请参照代码确认细节!!
-
-本项目中的 MCP 协议用于后台 API(MCP 客户端)与 ESP32 设备(MCP 服务器)之间的通信,以便后台能够发现和调用设备提供的功能(工具)。
-
-## 协议格式
-
-根据代码 (`main/protocols/protocol.cc`, `main/mcp_server.cc`),MCP 消息是封装在基础通信协议(如 WebSocket 或 MQTT)的消息体中的。其内部结构遵循 [JSON-RPC 2.0](https://www.jsonrpc.org/specification) 规范。
-
-整体消息结构示例:
-
-```json
-{
- "session_id": "...", // 会话 ID
- "type": "mcp", // 消息类型,固定为 "mcp"
- "payload": { // JSON-RPC 2.0 负载
- "jsonrpc": "2.0",
- "method": "...", // 方法名 (如 "initialize", "tools/list", "tools/call")
- "params": { ... }, // 方法参数 (对于 request)
- "id": ..., // 请求 ID (对于 request 和 response)
- "result": { ... }, // 方法执行结果 (对于 success response)
- "error": { ... } // 错误信息 (对于 error response)
- }
-}
-```
-
-其中,`payload` 部分是标准的 JSON-RPC 2.0 消息:
-
-- `jsonrpc`: 固定的字符串 "2.0"。
-- `method`: 要调用的方法名称 (对于 Request)。
-- `params`: 方法的参数,一个结构化值,通常为对象 (对于 Request)。
-- `id`: 请求的标识符,客户端发送请求时提供,服务器响应时原样返回。用于匹配请求和响应。
-- `result`: 方法成功执行时的结果 (对于 Success Response)。
-- `error`: 方法执行失败时的错误信息 (对于 Error Response)。
-
-## 交互流程及发送时机
-
-MCP 的交互主要围绕客户端(后台 API)发现和调用设备上的“工具”(Tool)进行。
-
-1. **连接建立与能力通告**
-
- - **时机:** 设备启动并成功连接到后台 API 后。
- - **发送方:** 设备。
- - **消息:** 设备发送基础协议的 "hello" 消息给后台 API,消息中包含设备支持的能力列表,例如通过支持 MCP 协议 (`"mcp": true`)。
- - **示例 (非 MCP 负载,而是基础协议消息):**
- ```json
- {
- "type": "hello",
- "version": ...,
- "features": {
- "mcp": true,
- ...
- },
- "transport": "websocket", // 或 "mqtt"
- "audio_params": { ... },
- "session_id": "..." // 设备收到服务器hello后可能设置
- }
- ```
-
-2. **初始化 MCP 会话**
-
- - **时机:** 后台 API 收到设备 "hello" 消息,确认设备支持 MCP 后,通常作为 MCP 会话的第一个请求发送。
- - **发送方:** 后台 API (客户端)。
- - **方法:** `initialize`
- - **消息 (MCP payload):**
-
- ```json
- {
- "jsonrpc": "2.0",
- "method": "initialize",
- "params": {
- "capabilities": {
- // 客户端能力,可选
-
- // 摄像头视觉相关
- "vision": {
- "url": "...", //摄像头: 图片处理地址(必须是http地址, 不是websocket地址)
- "token": "..." // url token
- }
-
- // ... 其他客户端能力
- }
- },
- "id": 1 // 请求 ID
- }
- ```
-
- - **设备响应时机:** 设备收到 `initialize` 请求并处理后。
- - **设备响应消息 (MCP payload):**
- ```json
- {
- "jsonrpc": "2.0",
- "id": 1, // 匹配请求 ID
- "result": {
- "protocolVersion": "2024-11-05",
- "capabilities": {
- "tools": {} // 这里的 tools 似乎不列出详细信息,需要 tools/list
- },
- "serverInfo": {
- "name": "...", // 设备名称 (BOARD_NAME)
- "version": "..." // 设备固件版本
- }
- }
- }
- ```
-
-3. **发现设备工具列表**
-
- - **时机:** 后台 API 需要获取设备当前支持的具体功能(工具)列表及其调用方式时。
- - **发送方:** 后台 API (客户端)。
- - **方法:** `tools/list`
- - **消息 (MCP payload):**
- ```json
- {
- "jsonrpc": "2.0",
- "method": "tools/list",
- "params": {
- "cursor": "" // 用于分页,首次请求为空字符串
- },
- "id": 2 // 请求 ID
- }
- ```
- - **设备响应时机:** 设备收到 `tools/list` 请求并生成工具列表后。
- - **设备响应消息 (MCP payload):**
- ```json
- {
- "jsonrpc": "2.0",
- "id": 2, // 匹配请求 ID
- "result": {
- "tools": [ // 工具对象列表
- {
- "name": "self.get_device_status",
- "description": "...",
- "inputSchema": { ... } // 参数 schema
- },
- {
- "name": "self.audio_speaker.set_volume",
- "description": "...",
- "inputSchema": { ... } // 参数 schema
- }
- // ... 更多工具
- ],
- "nextCursor": "..." // 如果列表很大需要分页,这里会包含下一个请求的 cursor 值
- }
- }
- ```
- - **分页处理:** 如果 `nextCursor` 字段非空,客户端需要再次发送 `tools/list` 请求,并在 `params` 中带上这个 `cursor` 值以获取下一页工具。
-
-4. **调用设备工具**
-
- - **时机:** 后台 API 需要执行设备上的某个具体功能时。
- - **发送方:** 后台 API (客户端)。
- - **方法:** `tools/call`
- - **消息 (MCP payload):**
- ```json
- {
- "jsonrpc": "2.0",
- "method": "tools/call",
- "params": {
- "name": "self.audio_speaker.set_volume", // 要调用的工具名称
- "arguments": {
- // 工具参数,对象格式
- "volume": 50 // 参数名及其值
- }
- },
- "id": 3 // 请求 ID
- }
- ```
- - **设备响应时机:** 设备收到 `tools/call` 请求,执行相应的工具函数后。
- - **设备成功响应消息 (MCP payload):**
- ```json
- {
- "jsonrpc": "2.0",
- "id": 3, // 匹配请求 ID
- "result": {
- "content": [
- // 工具执行结果内容
- { "type": "text", "text": "true" } // 示例:set_volume 返回 bool
- ],
- "isError": false // 表示成功
- }
- }
- ```
- - **设备失败响应消息 (MCP payload):**
- ```json
- {
- "jsonrpc": "2.0",
- "id": 3, // 匹配请求 ID
- "error": {
- "code": -32601, // JSON-RPC 错误码,例如 Method not found (-32601)
- "message": "Unknown tool: self.non_existent_tool" // 错误描述
- }
- }
- ```
-
-5. **设备主动发送消息 (Notifications)**
- - **时机:** 设备内部发生需要通知后台 API 的事件时(例如,状态变化,虽然代码示例中没有明确的工具发送此类消息,但 `Application::SendMcpMessage` 的存在暗示了设备可能主动发送 MCP 消息)。
- - **发送方:** 设备 (服务器)。
- - **方法:** 可能是以 `notifications/` 开头的方法名,或者其他自定义方法。
- - **消息 (MCP payload):** 遵循 JSON-RPC Notification 格式,没有 `id` 字段。
- ```json
- {
- "jsonrpc": "2.0",
- "method": "notifications/state_changed", // 示例方法名
- "params": {
- "newState": "idle",
- "oldState": "connecting"
- }
- // 没有 id 字段
- }
- ```
- - **后台 API 处理:** 接收到 Notification 后,后台 API 进行相应的处理,但不回复。
-
-## 交互图
-
-下面是一个简化的交互序列图,展示了主要的 MCP 消息流程:
-
-```mermaid
-sequenceDiagram
- participant Device as ESP32 Device
- participant BackendAPI as 后台 API (Client)
-
- Note over Device, BackendAPI: 建立 WebSocket / MQTT 连接
-
- Device->>BackendAPI: Hello Message (包含 "mcp": true)
-
- BackendAPI->>Device: MCP Initialize Request
- Note over BackendAPI: method: initialize
- Note over BackendAPI: params: { capabilities: ... }
-
- Device->>BackendAPI: MCP Initialize Response
- Note over Device: result: { protocolVersion: ..., serverInfo: ... }
-
- BackendAPI->>Device: MCP Get Tools List Request
- Note over BackendAPI: method: tools/list
- Note over BackendAPI: params: { cursor: "" }
-
- Device->>BackendAPI: MCP Get Tools List Response
- Note over Device: result: { tools: [...], nextCursor: ... }
-
- loop Optional Pagination
- BackendAPI->>Device: MCP Get Tools List Request
- Note over BackendAPI: method: tools/list
- Note over BackendAPI: params: { cursor: "..." }
- Device->>BackendAPI: MCP Get Tools List Response
- Note over Device: result: { tools: [...], nextCursor: "" }
- end
-
- BackendAPI->>Device: MCP Call Tool Request
- Note over BackendAPI: method: tools/call
- Note over BackendAPI: params: { name: "...", arguments: { ... } }
-
- alt Tool Call Successful
- Device->>BackendAPI: MCP Tool Call Success Response
- Note over Device: result: { content: [...], isError: false }
- else Tool Call Failed
- Device->>BackendAPI: MCP Tool Call Error Response
- Note over Device: error: { code: ..., message: ... }
- end
-
- opt Device Notification
- Device->>BackendAPI: MCP Notification
- Note over Device: method: notifications/...
- Note over Device: params: { ... }
- end
-```
-
-这份文档概述了该项目中 MCP 协议的主要交互流程。具体的参数细节和工具功能需要参考 `main/mcp_server.cc` 中 `McpServer::AddCommonTools` 以及各个工具的实现。
+# MCP (Model Context Protocol) 交互流程
+
+NOTICE: AI 辅助生成, 在实现后台服务时, 请参照代码确认细节!!
+
+本项目中的 MCP 协议用于后台 API(MCP 客户端)与 ESP32 设备(MCP 服务器)之间的通信,以便后台能够发现和调用设备提供的功能(工具)。
+
+## 协议格式
+
+根据代码 (`main/protocols/protocol.cc`, `main/mcp_server.cc`),MCP 消息是封装在基础通信协议(如 WebSocket 或 MQTT)的消息体中的。其内部结构遵循 [JSON-RPC 2.0](https://www.jsonrpc.org/specification) 规范。
+
+整体消息结构示例:
+
+```json
+{
+ "session_id": "...", // 会话 ID
+ "type": "mcp", // 消息类型,固定为 "mcp"
+ "payload": { // JSON-RPC 2.0 负载
+ "jsonrpc": "2.0",
+ "method": "...", // 方法名 (如 "initialize", "tools/list", "tools/call")
+ "params": { ... }, // 方法参数 (对于 request)
+ "id": ..., // 请求 ID (对于 request 和 response)
+ "result": { ... }, // 方法执行结果 (对于 success response)
+ "error": { ... } // 错误信息 (对于 error response)
+ }
+}
+```
+
+其中,`payload` 部分是标准的 JSON-RPC 2.0 消息:
+
+- `jsonrpc`: 固定的字符串 "2.0"。
+- `method`: 要调用的方法名称 (对于 Request)。
+- `params`: 方法的参数,一个结构化值,通常为对象 (对于 Request)。
+- `id`: 请求的标识符,客户端发送请求时提供,服务器响应时原样返回。用于匹配请求和响应。
+- `result`: 方法成功执行时的结果 (对于 Success Response)。
+- `error`: 方法执行失败时的错误信息 (对于 Error Response)。
+
+## 交互流程及发送时机
+
+MCP 的交互主要围绕客户端(后台 API)发现和调用设备上的“工具”(Tool)进行。
+
+1. **连接建立与能力通告**
+
+ - **时机:** 设备启动并成功连接到后台 API 后。
+ - **发送方:** 设备。
+ - **消息:** 设备发送基础协议的 "hello" 消息给后台 API,消息中包含设备支持的能力列表,例如通过支持 MCP 协议 (`"mcp": true`)。
+ - **示例 (非 MCP 负载,而是基础协议消息):**
+ ```json
+ {
+ "type": "hello",
+ "version": ...,
+ "features": {
+ "mcp": true,
+ ...
+ },
+ "transport": "websocket", // 或 "mqtt"
+ "audio_params": { ... },
+ "session_id": "..." // 设备收到服务器hello后可能设置
+ }
+ ```
+
+2. **初始化 MCP 会话**
+
+ - **时机:** 后台 API 收到设备 "hello" 消息,确认设备支持 MCP 后,通常作为 MCP 会话的第一个请求发送。
+ - **发送方:** 后台 API (客户端)。
+ - **方法:** `initialize`
+ - **消息 (MCP payload):**
+
+ ```json
+ {
+ "jsonrpc": "2.0",
+ "method": "initialize",
+ "params": {
+ "capabilities": {
+ // 客户端能力,可选
+
+ // 摄像头视觉相关
+ "vision": {
+ "url": "...", //摄像头: 图片处理地址(必须是http地址, 不是websocket地址)
+ "token": "..." // url token
+ }
+
+ // ... 其他客户端能力
+ }
+ },
+ "id": 1 // 请求 ID
+ }
+ ```
+
+ - **设备响应时机:** 设备收到 `initialize` 请求并处理后。
+ - **设备响应消息 (MCP payload):**
+ ```json
+ {
+ "jsonrpc": "2.0",
+ "id": 1, // 匹配请求 ID
+ "result": {
+ "protocolVersion": "2024-11-05",
+ "capabilities": {
+ "tools": {} // 这里的 tools 似乎不列出详细信息,需要 tools/list
+ },
+ "serverInfo": {
+ "name": "...", // 设备名称 (BOARD_NAME)
+ "version": "..." // 设备固件版本
+ }
+ }
+ }
+ ```
+
+3. **发现设备工具列表**
+
+ - **时机:** 后台 API 需要获取设备当前支持的具体功能(工具)列表及其调用方式时。
+ - **发送方:** 后台 API (客户端)。
+ - **方法:** `tools/list`
+ - **消息 (MCP payload):**
+ ```json
+ {
+ "jsonrpc": "2.0",
+ "method": "tools/list",
+ "params": {
+ "cursor": "" // 用于分页,首次请求为空字符串
+ },
+ "id": 2 // 请求 ID
+ }
+ ```
+ - **设备响应时机:** 设备收到 `tools/list` 请求并生成工具列表后。
+ - **设备响应消息 (MCP payload):**
+ ```json
+ {
+ "jsonrpc": "2.0",
+ "id": 2, // 匹配请求 ID
+ "result": {
+ "tools": [ // 工具对象列表
+ {
+ "name": "self.get_device_status",
+ "description": "...",
+ "inputSchema": { ... } // 参数 schema
+ },
+ {
+ "name": "self.audio_speaker.set_volume",
+ "description": "...",
+ "inputSchema": { ... } // 参数 schema
+ }
+ // ... 更多工具
+ ],
+ "nextCursor": "..." // 如果列表很大需要分页,这里会包含下一个请求的 cursor 值
+ }
+ }
+ ```
+ - **分页处理:** 如果 `nextCursor` 字段非空,客户端需要再次发送 `tools/list` 请求,并在 `params` 中带上这个 `cursor` 值以获取下一页工具。
+
+4. **调用设备工具**
+
+ - **时机:** 后台 API 需要执行设备上的某个具体功能时。
+ - **发送方:** 后台 API (客户端)。
+ - **方法:** `tools/call`
+ - **消息 (MCP payload):**
+ ```json
+ {
+ "jsonrpc": "2.0",
+ "method": "tools/call",
+ "params": {
+ "name": "self.audio_speaker.set_volume", // 要调用的工具名称
+ "arguments": {
+ // 工具参数,对象格式
+ "volume": 50 // 参数名及其值
+ }
+ },
+ "id": 3 // 请求 ID
+ }
+ ```
+ - **设备响应时机:** 设备收到 `tools/call` 请求,执行相应的工具函数后。
+ - **设备成功响应消息 (MCP payload):**
+ ```json
+ {
+ "jsonrpc": "2.0",
+ "id": 3, // 匹配请求 ID
+ "result": {
+ "content": [
+ // 工具执行结果内容
+ { "type": "text", "text": "true" } // 示例:set_volume 返回 bool
+ ],
+ "isError": false // 表示成功
+ }
+ }
+ ```
+ - **设备失败响应消息 (MCP payload):**
+ ```json
+ {
+ "jsonrpc": "2.0",
+ "id": 3, // 匹配请求 ID
+ "error": {
+ "code": -32601, // JSON-RPC 错误码,例如 Method not found (-32601)
+ "message": "Unknown tool: self.non_existent_tool" // 错误描述
+ }
+ }
+ ```
+
+5. **设备主动发送消息 (Notifications)**
+ - **时机:** 设备内部发生需要通知后台 API 的事件时(例如,状态变化,虽然代码示例中没有明确的工具发送此类消息,但 `Application::SendMcpMessage` 的存在暗示了设备可能主动发送 MCP 消息)。
+ - **发送方:** 设备 (服务器)。
+ - **方法:** 可能是以 `notifications/` 开头的方法名,或者其他自定义方法。
+ - **消息 (MCP payload):** 遵循 JSON-RPC Notification 格式,没有 `id` 字段。
+ ```json
+ {
+ "jsonrpc": "2.0",
+ "method": "notifications/state_changed", // 示例方法名
+ "params": {
+ "newState": "idle",
+ "oldState": "connecting"
+ }
+ // 没有 id 字段
+ }
+ ```
+ - **后台 API 处理:** 接收到 Notification 后,后台 API 进行相应的处理,但不回复。
+
+## 交互图
+
+下面是一个简化的交互序列图,展示了主要的 MCP 消息流程:
+
+```mermaid
+sequenceDiagram
+ participant Device as ESP32 Device
+ participant BackendAPI as 后台 API (Client)
+
+ Note over Device, BackendAPI: 建立 WebSocket / MQTT 连接
+
+ Device->>BackendAPI: Hello Message (包含 "mcp": true)
+
+ BackendAPI->>Device: MCP Initialize Request
+ Note over BackendAPI: method: initialize
+ Note over BackendAPI: params: { capabilities: ... }
+
+ Device->>BackendAPI: MCP Initialize Response
+ Note over Device: result: { protocolVersion: ..., serverInfo: ... }
+
+ BackendAPI->>Device: MCP Get Tools List Request
+ Note over BackendAPI: method: tools/list
+ Note over BackendAPI: params: { cursor: "" }
+
+ Device->>BackendAPI: MCP Get Tools List Response
+ Note over Device: result: { tools: [...], nextCursor: ... }
+
+ loop Optional Pagination
+ BackendAPI->>Device: MCP Get Tools List Request
+ Note over BackendAPI: method: tools/list
+ Note over BackendAPI: params: { cursor: "..." }
+ Device->>BackendAPI: MCP Get Tools List Response
+ Note over Device: result: { tools: [...], nextCursor: "" }
+ end
+
+ BackendAPI->>Device: MCP Call Tool Request
+ Note over BackendAPI: method: tools/call
+ Note over BackendAPI: params: { name: "...", arguments: { ... } }
+
+ alt Tool Call Successful
+ Device->>BackendAPI: MCP Tool Call Success Response
+ Note over Device: result: { content: [...], isError: false }
+ else Tool Call Failed
+ Device->>BackendAPI: MCP Tool Call Error Response
+ Note over Device: error: { code: ..., message: ... }
+ end
+
+ opt Device Notification
+ Device->>BackendAPI: MCP Notification
+ Note over Device: method: notifications/...
+ Note over Device: params: { ... }
+ end
+```
+
+这份文档概述了该项目中 MCP 协议的主要交互流程。具体的参数细节和工具功能需要参考 `main/mcp_server.cc` 中 `McpServer::AddCommonTools` 以及各个工具的实现。
diff --git a/docs/mcp-usage.md b/docs/mcp-usage.md
index fa50a39..e79026f 100644
--- a/docs/mcp-usage.md
+++ b/docs/mcp-usage.md
@@ -1,115 +1,115 @@
-# MCP 协议物联网控制用法说明
-
-> 本文档介绍如何基于 MCP 协议实现 ESP32 设备的物联网控制。详细协议流程请参考 [`mcp-protocol.md`](./mcp-protocol.md)。
-
-## 简介
-
-MCP(Model Context Protocol)是新一代推荐用于物联网控制的协议,通过标准 JSON-RPC 2.0 格式在后台与设备间发现和调用"工具"(Tool),实现灵活的设备控制。
-
-## 典型使用流程
-
-1. 设备启动后通过基础协议(如 WebSocket/MQTT)与后台建立连接。
-2. 后台通过 MCP 协议的 `initialize` 方法初始化会话。
-3. 后台通过 `tools/list` 获取设备支持的所有工具(功能)及参数说明。
-4. 后台通过 `tools/call` 调用具体工具,实现对设备的控制。
-
-详细协议格式与交互请见 [`mcp-protocol.md`](./mcp-protocol.md)。
-
-## 设备端工具注册方法说明
-
-设备通过 `McpServer::AddTool` 方法注册可被后台调用的"工具"。其常用函数签名如下:
-
-```cpp
-void AddTool(
- const std::string& name, // 工具名称,建议唯一且有层次感,如 self.dog.forward
- const std::string& description, // 工具描述,简明说明功能,便于大模型理解
- const PropertyList& properties, // 输入参数列表(可为空),支持类型:布尔、整数、字符串
- std::function callback // 工具被调用时的回调实现
-);
-```
-- name:工具唯一标识,建议用"模块.功能"命名风格。
-- description:自然语言描述,便于 AI/用户理解。
-- properties:参数列表,支持类型有布尔、整数、字符串,可指定范围和默认值。
-- callback:收到调用请求时的实际执行逻辑,返回值可为 bool/int/string。
-
-## 典型注册示例(以 ESP-Hi 为例)
-
-```cpp
-void InitializeTools() {
- auto& mcp_server = McpServer::GetInstance();
- // 例1:无参数,控制机器人前进
- mcp_server.AddTool("self.dog.forward", "机器人向前移动", PropertyList(), [this](const PropertyList&) -> ReturnValue {
- servo_dog_ctrl_send(DOG_STATE_FORWARD, NULL);
- return true;
- });
- // 例2:带参数,设置灯光 RGB 颜色
- mcp_server.AddTool("self.light.set_rgb", "设置RGB颜色", PropertyList({
- Property("r", kPropertyTypeInteger, 0, 255),
- Property("g", kPropertyTypeInteger, 0, 255),
- Property("b", kPropertyTypeInteger, 0, 255)
- }), [this](const PropertyList& properties) -> ReturnValue {
- int r = properties["r"].value();
- int g = properties["g"].value();
- int b = properties["b"].value();
- led_on_ = true;
- SetLedColor(r, g, b);
- return true;
- });
-}
-```
-
-## 常见工具调用 JSON-RPC 示例
-
-### 1. 获取工具列表
-```json
-{
- "jsonrpc": "2.0",
- "method": "tools/list",
- "params": { "cursor": "" },
- "id": 1
-}
-```
-
-### 2. 控制底盘前进
-```json
-{
- "jsonrpc": "2.0",
- "method": "tools/call",
- "params": {
- "name": "self.chassis.go_forward",
- "arguments": {}
- },
- "id": 2
-}
-```
-
-### 3. 切换灯光模式
-```json
-{
- "jsonrpc": "2.0",
- "method": "tools/call",
- "params": {
- "name": "self.chassis.switch_light_mode",
- "arguments": { "light_mode": 3 }
- },
- "id": 3
-}
-```
-
-### 4. 摄像头翻转
-```json
-{
- "jsonrpc": "2.0",
- "method": "tools/call",
- "params": {
- "name": "self.camera.set_camera_flipped",
- "arguments": {}
- },
- "id": 4
-}
-```
-
-## 备注
-- 工具名称、参数及返回值请以设备端 `AddTool` 注册为准。
-- 推荐所有新项目统一采用 MCP 协议进行物联网控制。
+# MCP 协议物联网控制用法说明
+
+> 本文档介绍如何基于 MCP 协议实现 ESP32 设备的物联网控制。详细协议流程请参考 [`mcp-protocol.md`](./mcp-protocol.md)。
+
+## 简介
+
+MCP(Model Context Protocol)是新一代推荐用于物联网控制的协议,通过标准 JSON-RPC 2.0 格式在后台与设备间发现和调用"工具"(Tool),实现灵活的设备控制。
+
+## 典型使用流程
+
+1. 设备启动后通过基础协议(如 WebSocket/MQTT)与后台建立连接。
+2. 后台通过 MCP 协议的 `initialize` 方法初始化会话。
+3. 后台通过 `tools/list` 获取设备支持的所有工具(功能)及参数说明。
+4. 后台通过 `tools/call` 调用具体工具,实现对设备的控制。
+
+详细协议格式与交互请见 [`mcp-protocol.md`](./mcp-protocol.md)。
+
+## 设备端工具注册方法说明
+
+设备通过 `McpServer::AddTool` 方法注册可被后台调用的"工具"。其常用函数签名如下:
+
+```cpp
+void AddTool(
+ const std::string& name, // 工具名称,建议唯一且有层次感,如 self.dog.forward
+ const std::string& description, // 工具描述,简明说明功能,便于大模型理解
+ const PropertyList& properties, // 输入参数列表(可为空),支持类型:布尔、整数、字符串
+ std::function callback // 工具被调用时的回调实现
+);
+```
+- name:工具唯一标识,建议用"模块.功能"命名风格。
+- description:自然语言描述,便于 AI/用户理解。
+- properties:参数列表,支持类型有布尔、整数、字符串,可指定范围和默认值。
+- callback:收到调用请求时的实际执行逻辑,返回值可为 bool/int/string。
+
+## 典型注册示例(以 ESP-Hi 为例)
+
+```cpp
+void InitializeTools() {
+ auto& mcp_server = McpServer::GetInstance();
+ // 例1:无参数,控制机器人前进
+ mcp_server.AddTool("self.dog.forward", "机器人向前移动", PropertyList(), [this](const PropertyList&) -> ReturnValue {
+ servo_dog_ctrl_send(DOG_STATE_FORWARD, NULL);
+ return true;
+ });
+ // 例2:带参数,设置灯光 RGB 颜色
+ mcp_server.AddTool("self.light.set_rgb", "设置RGB颜色", PropertyList({
+ Property("r", kPropertyTypeInteger, 0, 255),
+ Property("g", kPropertyTypeInteger, 0, 255),
+ Property("b", kPropertyTypeInteger, 0, 255)
+ }), [this](const PropertyList& properties) -> ReturnValue {
+ int r = properties["r"].value();
+ int g = properties["g"].value();
+ int b = properties["b"].value();
+ led_on_ = true;
+ SetLedColor(r, g, b);
+ return true;
+ });
+}
+```
+
+## 常见工具调用 JSON-RPC 示例
+
+### 1. 获取工具列表
+```json
+{
+ "jsonrpc": "2.0",
+ "method": "tools/list",
+ "params": { "cursor": "" },
+ "id": 1
+}
+```
+
+### 2. 控制底盘前进
+```json
+{
+ "jsonrpc": "2.0",
+ "method": "tools/call",
+ "params": {
+ "name": "self.chassis.go_forward",
+ "arguments": {}
+ },
+ "id": 2
+}
+```
+
+### 3. 切换灯光模式
+```json
+{
+ "jsonrpc": "2.0",
+ "method": "tools/call",
+ "params": {
+ "name": "self.chassis.switch_light_mode",
+ "arguments": { "light_mode": 3 }
+ },
+ "id": 3
+}
+```
+
+### 4. 摄像头翻转
+```json
+{
+ "jsonrpc": "2.0",
+ "method": "tools/call",
+ "params": {
+ "name": "self.camera.set_camera_flipped",
+ "arguments": {}
+ },
+ "id": 4
+}
+```
+
+## 备注
+- 工具名称、参数及返回值请以设备端 `AddTool` 注册为准。
+- 推荐所有新项目统一采用 MCP 协议进行物联网控制。
- 详细协议与进阶用法请查阅 [`mcp-protocol.md`](./mcp-protocol.md)。
\ No newline at end of file
diff --git a/docs/mqtt-udp.md b/docs/mqtt-udp.md
index 478e466..ed04fa6 100644
--- a/docs/mqtt-udp.md
+++ b/docs/mqtt-udp.md
@@ -1,393 +1,393 @@
-# MQTT + UDP 混合通信协议文档
-
-基于代码实现整理的 MQTT + UDP 混合通信协议文档,概述设备端与服务器之间如何通过 MQTT 进行控制消息传输,通过 UDP 进行音频数据传输的交互方式。
-
----
-
-## 1. 协议概览
-
-本协议采用混合传输方式:
-- **MQTT**:用于控制消息、状态同步、JSON 数据交换
-- **UDP**:用于实时音频数据传输,支持加密
-
-### 1.1 协议特点
-
-- **双通道设计**:控制与数据分离,确保实时性
-- **加密传输**:UDP 音频数据使用 AES-CTR 加密
-- **序列号保护**:防止数据包重放和乱序
-- **自动重连**:MQTT 连接断开时自动重连
-
----
-
-## 2. 总体流程概览
-
-```mermaid
-sequenceDiagram
- participant Device as ESP32 设备
- participant MQTT as MQTT 服务器
- participant UDP as UDP 服务器
-
- Note over Device, UDP: 1. 建立 MQTT 连接
- Device->>MQTT: MQTT Connect
- MQTT->>Device: Connected
-
- Note over Device, UDP: 2. 请求音频通道
- Device->>MQTT: Hello Message (type: "hello", transport: "udp")
- MQTT->>Device: Hello Response (UDP 连接信息 + 加密密钥)
-
- Note over Device, UDP: 3. 建立 UDP 连接
- Device->>UDP: UDP Connect
- UDP->>Device: Connected
-
- Note over Device, UDP: 4. 音频数据传输
- loop 音频流传输
- Device->>UDP: 加密音频数据 (Opus)
- UDP->>Device: 加密音频数据 (Opus)
- end
-
- Note over Device, UDP: 5. 控制消息交换
- par 控制消息
- Device->>MQTT: Listen/TTS/MCP 消息
- MQTT->>Device: STT/TTS/MCP 响应
- end
-
- Note over Device, UDP: 6. 关闭连接
- Device->>MQTT: Goodbye Message
- Device->>UDP: Disconnect
-```
-
----
-
-## 3. MQTT 控制通道
-
-### 3.1 连接建立
-
-设备通过 MQTT 连接到服务器,连接参数包括:
-- **Endpoint**:MQTT 服务器地址和端口
-- **Client ID**:设备唯一标识符
-- **Username/Password**:认证凭据
-- **Keep Alive**:心跳间隔(默认240秒)
-
-### 3.2 Hello 消息交换
-
-#### 3.2.1 设备端发送 Hello
-
-```json
-{
- "type": "hello",
- "version": 3,
- "transport": "udp",
- "features": {
- "mcp": true
- },
- "audio_params": {
- "format": "opus",
- "sample_rate": 16000,
- "channels": 1,
- "frame_duration": 60
- }
-}
-```
-
-#### 3.2.2 服务器响应 Hello
-
-```json
-{
- "type": "hello",
- "transport": "udp",
- "session_id": "xxx",
- "audio_params": {
- "format": "opus",
- "sample_rate": 24000,
- "channels": 1,
- "frame_duration": 60
- },
- "udp": {
- "server": "192.168.1.100",
- "port": 8888,
- "key": "0123456789ABCDEF0123456789ABCDEF",
- "nonce": "0123456789ABCDEF0123456789ABCDEF"
- }
-}
-```
-
-**字段说明:**
-- `udp.server`:UDP 服务器地址
-- `udp.port`:UDP 服务器端口
-- `udp.key`:AES 加密密钥(十六进制字符串)
-- `udp.nonce`:AES 加密随机数(十六进制字符串)
-
-### 3.3 JSON 消息类型
-
-#### 3.3.1 设备端→服务器
-
-1. **Listen 消息**
- ```json
- {
- "session_id": "xxx",
- "type": "listen",
- "state": "start",
- "mode": "manual"
- }
- ```
-
-2. **Abort 消息**
- ```json
- {
- "session_id": "xxx",
- "type": "abort",
- "reason": "wake_word_detected"
- }
- ```
-
-3. **MCP 消息**
- ```json
- {
- "session_id": "xxx",
- "type": "mcp",
- "payload": {
- "jsonrpc": "2.0",
- "id": 1,
- "result": {...}
- }
- }
- ```
-
-4. **Goodbye 消息**
- ```json
- {
- "session_id": "xxx",
- "type": "goodbye"
- }
- ```
-
-#### 3.3.2 服务器→设备端
-
-支持的消息类型与 WebSocket 协议一致,包括:
-- **STT**:语音识别结果
-- **TTS**:语音合成控制
-- **LLM**:情感表达控制
-- **MCP**:物联网控制
-- **System**:系统控制
-- **Custom**:自定义消息(可选)
-
----
-
-## 4. UDP 音频通道
-
-### 4.1 连接建立
-
-设备收到 MQTT Hello 响应后,使用其中的 UDP 连接信息建立音频通道:
-1. 解析 UDP 服务器地址和端口
-2. 解析加密密钥和随机数
-3. 初始化 AES-CTR 加密上下文
-4. 建立 UDP 连接
-
-### 4.2 音频数据格式
-
-#### 4.2.1 加密音频包结构
-
-```
-|type 1byte|flags 1byte|payload_len 2bytes|ssrc 4bytes|timestamp 4bytes|sequence 4bytes|
-|payload payload_len bytes|
-```
-
-**字段说明:**
-- `type`:数据包类型,固定为 0x01
-- `flags`:标志位,当前未使用
-- `payload_len`:负载长度(网络字节序)
-- `ssrc`:同步源标识符
-- `timestamp`:时间戳(网络字节序)
-- `sequence`:序列号(网络字节序)
-- `payload`:加密的 Opus 音频数据
-
-#### 4.2.2 加密算法
-
-使用 **AES-CTR** 模式加密:
-- **密钥**:128位,由服务器提供
-- **随机数**:128位,由服务器提供
-- **计数器**:包含时间戳和序列号信息
-
-### 4.3 序列号管理
-
-- **发送端**:`local_sequence_` 单调递增
-- **接收端**:`remote_sequence_` 验证连续性
-- **防重放**:拒绝序列号小于期望值的数据包
-- **容错处理**:允许轻微的序列号跳跃,记录警告
-
-### 4.4 错误处理
-
-1. **解密失败**:记录错误,丢弃数据包
-2. **序列号异常**:记录警告,但仍处理数据包
-3. **数据包格式错误**:记录错误,丢弃数据包
-
----
-
-## 5. 状态管理
-
-### 5.1 连接状态
-
-```mermaid
-stateDiagram
- direction TB
- [*] --> Disconnected
- Disconnected --> MqttConnecting: StartMqttClient()
- MqttConnecting --> MqttConnected: MQTT Connected
- MqttConnecting --> Disconnected: Connect Failed
- MqttConnected --> RequestingChannel: OpenAudioChannel()
- RequestingChannel --> ChannelOpened: Hello Exchange Success
- RequestingChannel --> MqttConnected: Hello Timeout/Failed
- ChannelOpened --> UdpConnected: UDP Connect Success
- UdpConnected --> AudioStreaming: Start Audio Transfer
- AudioStreaming --> UdpConnected: Stop Audio Transfer
- UdpConnected --> ChannelOpened: UDP Disconnect
- ChannelOpened --> MqttConnected: CloseAudioChannel()
- MqttConnected --> Disconnected: MQTT Disconnect
-```
-
-### 5.2 状态检查
-
-设备通过以下条件判断音频通道是否可用:
-```cpp
-bool IsAudioChannelOpened() const {
- return udp_ != nullptr && !error_occurred_ && !IsTimeout();
-}
-```
-
----
-
-## 6. 配置参数
-
-### 6.1 MQTT 配置
-
-从设置中读取的配置项:
-- `endpoint`:MQTT 服务器地址
-- `client_id`:客户端标识符
-- `username`:用户名
-- `password`:密码
-- `keepalive`:心跳间隔(默认240秒)
-- `publish_topic`:发布主题
-
-### 6.2 音频参数
-
-- **格式**:Opus
-- **采样率**:16000 Hz(设备端)/ 24000 Hz(服务器端)
-- **声道数**:1(单声道)
-- **帧时长**:60ms
-
----
-
-## 7. 错误处理与重连
-
-### 7.1 MQTT 重连机制
-
-- 连接失败时自动重试
-- 支持错误上报控制
-- 断线时触发清理流程
-
-### 7.2 UDP 连接管理
-
-- 连接失败时不自动重试
-- 依赖 MQTT 通道重新协商
-- 支持连接状态查询
-
-### 7.3 超时处理
-
-基类 `Protocol` 提供超时检测:
-- 默认超时时间:120 秒
-- 基于最后接收时间计算
-- 超时时自动标记为不可用
-
----
-
-## 8. 安全考虑
-
-### 8.1 传输加密
-
-- **MQTT**:支持 TLS/SSL 加密(端口8883)
-- **UDP**:使用 AES-CTR 加密音频数据
-
-### 8.2 认证机制
-
-- **MQTT**:用户名/密码认证
-- **UDP**:通过 MQTT 通道分发密钥
-
-### 8.3 防重放攻击
-
-- 序列号单调递增
-- 拒绝过期数据包
-- 时间戳验证
-
----
-
-## 9. 性能优化
-
-### 9.1 并发控制
-
-使用互斥锁保护 UDP 连接:
-```cpp
-std::lock_guard lock(channel_mutex_);
-```
-
-### 9.2 内存管理
-
-- 动态创建/销毁网络对象
-- 智能指针管理音频数据包
-- 及时释放加密上下文
-
-### 9.3 网络优化
-
-- UDP 连接复用
-- 数据包大小优化
-- 序列号连续性检查
-
----
-
-## 10. 与 WebSocket 协议的比较
-
-| 特性 | MQTT + UDP | WebSocket |
-|------|------------|-----------|
-| 控制通道 | MQTT | WebSocket |
-| 音频通道 | UDP (加密) | WebSocket (二进制) |
-| 实时性 | 高 (UDP) | 中等 |
-| 可靠性 | 中等 | 高 |
-| 复杂度 | 高 | 低 |
-| 加密 | AES-CTR | TLS |
-| 防火墙友好度 | 低 | 高 |
-
----
-
-## 11. 部署建议
-
-### 11.1 网络环境
-
-- 确保 UDP 端口可达
-- 配置防火墙规则
-- 考虑 NAT 穿透
-
-### 11.2 服务器配置
-
-- MQTT Broker 配置
-- UDP 服务器部署
-- 密钥管理系统
-
-### 11.3 监控指标
-
-- 连接成功率
-- 音频传输延迟
-- 数据包丢失率
-- 解密失败率
-
----
-
-## 12. 总结
-
-MQTT + UDP 混合协议通过以下设计实现高效的音视频通信:
-
-- **分离式架构**:控制与数据通道分离,各司其职
-- **加密保护**:AES-CTR 确保音频数据安全传输
-- **序列化管理**:防止重放攻击和数据乱序
-- **自动恢复**:支持连接断开后的自动重连
-- **性能优化**:UDP 传输保证音频数据的实时性
-
+# MQTT + UDP 混合通信协议文档
+
+基于代码实现整理的 MQTT + UDP 混合通信协议文档,概述设备端与服务器之间如何通过 MQTT 进行控制消息传输,通过 UDP 进行音频数据传输的交互方式。
+
+---
+
+## 1. 协议概览
+
+本协议采用混合传输方式:
+- **MQTT**:用于控制消息、状态同步、JSON 数据交换
+- **UDP**:用于实时音频数据传输,支持加密
+
+### 1.1 协议特点
+
+- **双通道设计**:控制与数据分离,确保实时性
+- **加密传输**:UDP 音频数据使用 AES-CTR 加密
+- **序列号保护**:防止数据包重放和乱序
+- **自动重连**:MQTT 连接断开时自动重连
+
+---
+
+## 2. 总体流程概览
+
+```mermaid
+sequenceDiagram
+ participant Device as ESP32 设备
+ participant MQTT as MQTT 服务器
+ participant UDP as UDP 服务器
+
+ Note over Device, UDP: 1. 建立 MQTT 连接
+ Device->>MQTT: MQTT Connect
+ MQTT->>Device: Connected
+
+ Note over Device, UDP: 2. 请求音频通道
+ Device->>MQTT: Hello Message (type: "hello", transport: "udp")
+ MQTT->>Device: Hello Response (UDP 连接信息 + 加密密钥)
+
+ Note over Device, UDP: 3. 建立 UDP 连接
+ Device->>UDP: UDP Connect
+ UDP->>Device: Connected
+
+ Note over Device, UDP: 4. 音频数据传输
+ loop 音频流传输
+ Device->>UDP: 加密音频数据 (Opus)
+ UDP->>Device: 加密音频数据 (Opus)
+ end
+
+ Note over Device, UDP: 5. 控制消息交换
+ par 控制消息
+ Device->>MQTT: Listen/TTS/MCP 消息
+ MQTT->>Device: STT/TTS/MCP 响应
+ end
+
+ Note over Device, UDP: 6. 关闭连接
+ Device->>MQTT: Goodbye Message
+ Device->>UDP: Disconnect
+```
+
+---
+
+## 3. MQTT 控制通道
+
+### 3.1 连接建立
+
+设备通过 MQTT 连接到服务器,连接参数包括:
+- **Endpoint**:MQTT 服务器地址和端口
+- **Client ID**:设备唯一标识符
+- **Username/Password**:认证凭据
+- **Keep Alive**:心跳间隔(默认240秒)
+
+### 3.2 Hello 消息交换
+
+#### 3.2.1 设备端发送 Hello
+
+```json
+{
+ "type": "hello",
+ "version": 3,
+ "transport": "udp",
+ "features": {
+ "mcp": true
+ },
+ "audio_params": {
+ "format": "opus",
+ "sample_rate": 16000,
+ "channels": 1,
+ "frame_duration": 60
+ }
+}
+```
+
+#### 3.2.2 服务器响应 Hello
+
+```json
+{
+ "type": "hello",
+ "transport": "udp",
+ "session_id": "xxx",
+ "audio_params": {
+ "format": "opus",
+ "sample_rate": 24000,
+ "channels": 1,
+ "frame_duration": 60
+ },
+ "udp": {
+ "server": "192.168.1.100",
+ "port": 8888,
+ "key": "0123456789ABCDEF0123456789ABCDEF",
+ "nonce": "0123456789ABCDEF0123456789ABCDEF"
+ }
+}
+```
+
+**字段说明:**
+- `udp.server`:UDP 服务器地址
+- `udp.port`:UDP 服务器端口
+- `udp.key`:AES 加密密钥(十六进制字符串)
+- `udp.nonce`:AES 加密随机数(十六进制字符串)
+
+### 3.3 JSON 消息类型
+
+#### 3.3.1 设备端→服务器
+
+1. **Listen 消息**
+ ```json
+ {
+ "session_id": "xxx",
+ "type": "listen",
+ "state": "start",
+ "mode": "manual"
+ }
+ ```
+
+2. **Abort 消息**
+ ```json
+ {
+ "session_id": "xxx",
+ "type": "abort",
+ "reason": "wake_word_detected"
+ }
+ ```
+
+3. **MCP 消息**
+ ```json
+ {
+ "session_id": "xxx",
+ "type": "mcp",
+ "payload": {
+ "jsonrpc": "2.0",
+ "id": 1,
+ "result": {...}
+ }
+ }
+ ```
+
+4. **Goodbye 消息**
+ ```json
+ {
+ "session_id": "xxx",
+ "type": "goodbye"
+ }
+ ```
+
+#### 3.3.2 服务器→设备端
+
+支持的消息类型与 WebSocket 协议一致,包括:
+- **STT**:语音识别结果
+- **TTS**:语音合成控制
+- **LLM**:情感表达控制
+- **MCP**:物联网控制
+- **System**:系统控制
+- **Custom**:自定义消息(可选)
+
+---
+
+## 4. UDP 音频通道
+
+### 4.1 连接建立
+
+设备收到 MQTT Hello 响应后,使用其中的 UDP 连接信息建立音频通道:
+1. 解析 UDP 服务器地址和端口
+2. 解析加密密钥和随机数
+3. 初始化 AES-CTR 加密上下文
+4. 建立 UDP 连接
+
+### 4.2 音频数据格式
+
+#### 4.2.1 加密音频包结构
+
+```
+|type 1byte|flags 1byte|payload_len 2bytes|ssrc 4bytes|timestamp 4bytes|sequence 4bytes|
+|payload payload_len bytes|
+```
+
+**字段说明:**
+- `type`:数据包类型,固定为 0x01
+- `flags`:标志位,当前未使用
+- `payload_len`:负载长度(网络字节序)
+- `ssrc`:同步源标识符
+- `timestamp`:时间戳(网络字节序)
+- `sequence`:序列号(网络字节序)
+- `payload`:加密的 Opus 音频数据
+
+#### 4.2.2 加密算法
+
+使用 **AES-CTR** 模式加密:
+- **密钥**:128位,由服务器提供
+- **随机数**:128位,由服务器提供
+- **计数器**:包含时间戳和序列号信息
+
+### 4.3 序列号管理
+
+- **发送端**:`local_sequence_` 单调递增
+- **接收端**:`remote_sequence_` 验证连续性
+- **防重放**:拒绝序列号小于期望值的数据包
+- **容错处理**:允许轻微的序列号跳跃,记录警告
+
+### 4.4 错误处理
+
+1. **解密失败**:记录错误,丢弃数据包
+2. **序列号异常**:记录警告,但仍处理数据包
+3. **数据包格式错误**:记录错误,丢弃数据包
+
+---
+
+## 5. 状态管理
+
+### 5.1 连接状态
+
+```mermaid
+stateDiagram
+ direction TB
+ [*] --> Disconnected
+ Disconnected --> MqttConnecting: StartMqttClient()
+ MqttConnecting --> MqttConnected: MQTT Connected
+ MqttConnecting --> Disconnected: Connect Failed
+ MqttConnected --> RequestingChannel: OpenAudioChannel()
+ RequestingChannel --> ChannelOpened: Hello Exchange Success
+ RequestingChannel --> MqttConnected: Hello Timeout/Failed
+ ChannelOpened --> UdpConnected: UDP Connect Success
+ UdpConnected --> AudioStreaming: Start Audio Transfer
+ AudioStreaming --> UdpConnected: Stop Audio Transfer
+ UdpConnected --> ChannelOpened: UDP Disconnect
+ ChannelOpened --> MqttConnected: CloseAudioChannel()
+ MqttConnected --> Disconnected: MQTT Disconnect
+```
+
+### 5.2 状态检查
+
+设备通过以下条件判断音频通道是否可用:
+```cpp
+bool IsAudioChannelOpened() const {
+ return udp_ != nullptr && !error_occurred_ && !IsTimeout();
+}
+```
+
+---
+
+## 6. 配置参数
+
+### 6.1 MQTT 配置
+
+从设置中读取的配置项:
+- `endpoint`:MQTT 服务器地址
+- `client_id`:客户端标识符
+- `username`:用户名
+- `password`:密码
+- `keepalive`:心跳间隔(默认240秒)
+- `publish_topic`:发布主题
+
+### 6.2 音频参数
+
+- **格式**:Opus
+- **采样率**:16000 Hz(设备端)/ 24000 Hz(服务器端)
+- **声道数**:1(单声道)
+- **帧时长**:60ms
+
+---
+
+## 7. 错误处理与重连
+
+### 7.1 MQTT 重连机制
+
+- 连接失败时自动重试
+- 支持错误上报控制
+- 断线时触发清理流程
+
+### 7.2 UDP 连接管理
+
+- 连接失败时不自动重试
+- 依赖 MQTT 通道重新协商
+- 支持连接状态查询
+
+### 7.3 超时处理
+
+基类 `Protocol` 提供超时检测:
+- 默认超时时间:120 秒
+- 基于最后接收时间计算
+- 超时时自动标记为不可用
+
+---
+
+## 8. 安全考虑
+
+### 8.1 传输加密
+
+- **MQTT**:支持 TLS/SSL 加密(端口8883)
+- **UDP**:使用 AES-CTR 加密音频数据
+
+### 8.2 认证机制
+
+- **MQTT**:用户名/密码认证
+- **UDP**:通过 MQTT 通道分发密钥
+
+### 8.3 防重放攻击
+
+- 序列号单调递增
+- 拒绝过期数据包
+- 时间戳验证
+
+---
+
+## 9. 性能优化
+
+### 9.1 并发控制
+
+使用互斥锁保护 UDP 连接:
+```cpp
+std::lock_guard lock(channel_mutex_);
+```
+
+### 9.2 内存管理
+
+- 动态创建/销毁网络对象
+- 智能指针管理音频数据包
+- 及时释放加密上下文
+
+### 9.3 网络优化
+
+- UDP 连接复用
+- 数据包大小优化
+- 序列号连续性检查
+
+---
+
+## 10. 与 WebSocket 协议的比较
+
+| 特性 | MQTT + UDP | WebSocket |
+|------|------------|-----------|
+| 控制通道 | MQTT | WebSocket |
+| 音频通道 | UDP (加密) | WebSocket (二进制) |
+| 实时性 | 高 (UDP) | 中等 |
+| 可靠性 | 中等 | 高 |
+| 复杂度 | 高 | 低 |
+| 加密 | AES-CTR | TLS |
+| 防火墙友好度 | 低 | 高 |
+
+---
+
+## 11. 部署建议
+
+### 11.1 网络环境
+
+- 确保 UDP 端口可达
+- 配置防火墙规则
+- 考虑 NAT 穿透
+
+### 11.2 服务器配置
+
+- MQTT Broker 配置
+- UDP 服务器部署
+- 密钥管理系统
+
+### 11.3 监控指标
+
+- 连接成功率
+- 音频传输延迟
+- 数据包丢失率
+- 解密失败率
+
+---
+
+## 12. 总结
+
+MQTT + UDP 混合协议通过以下设计实现高效的音视频通信:
+
+- **分离式架构**:控制与数据通道分离,各司其职
+- **加密保护**:AES-CTR 确保音频数据安全传输
+- **序列化管理**:防止重放攻击和数据乱序
+- **自动恢复**:支持连接断开后的自动重连
+- **性能优化**:UDP 传输保证音频数据的实时性
+
该协议适用于对实时性要求较高的语音交互场景,但需要在网络复杂度和传输性能之间做出权衡。
\ No newline at end of file
diff --git a/docs/v0/atoms3r-echo-base.jpg b/docs/v0/atoms3r-echo-base.jpg
old mode 100755
new mode 100644
diff --git a/docs/v1/movecall-cuican-esp32s3.jpg b/docs/v1/movecall-cuican-esp32s3.jpg
old mode 100755
new mode 100644
diff --git a/docs/websocket.md b/docs/websocket.md
index f767114..54de957 100644
--- a/docs/websocket.md
+++ b/docs/websocket.md
@@ -1,495 +1,495 @@
-以下是一份基于代码实现整理的 WebSocket 通信协议文档,概述设备端与服务器之间如何通过 WebSocket 进行交互。
-
-该文档仅基于所提供的代码推断,实际部署时可能需要结合服务器端实现进行进一步确认或补充。
-
----
-
-## 1. 总体流程概览
-
-1. **设备端初始化**
- - 设备上电、初始化 `Application`:
- - 初始化音频编解码器、显示屏、LED 等
- - 连接网络
- - 创建并初始化实现 `Protocol` 接口的 WebSocket 协议实例(`WebsocketProtocol`)
- - 进入主循环等待事件(音频输入、音频输出、调度任务等)。
-
-2. **建立 WebSocket 连接**
- - 当设备需要开始语音会话时(例如用户唤醒、手动按键触发等),调用 `OpenAudioChannel()`:
- - 根据配置获取 WebSocket URL
- - 设置若干请求头(`Authorization`, `Protocol-Version`, `Device-Id`, `Client-Id`)
- - 调用 `Connect()` 与服务器建立 WebSocket 连接
-
-3. **设备端发送 "hello" 消息**
- - 连接成功后,设备会发送一条 JSON 消息,示例结构如下:
- ```json
- {
- "type": "hello",
- "version": 1,
- "features": {
- "mcp": true
- },
- "transport": "websocket",
- "audio_params": {
- "format": "opus",
- "sample_rate": 16000,
- "channels": 1,
- "frame_duration": 60
- }
- }
- ```
- - 其中 `features` 字段为可选,内容根据设备编译配置自动生成。例如:`"mcp": true` 表示支持 MCP 协议。
- - `frame_duration` 的值对应 `OPUS_FRAME_DURATION_MS`(例如 60ms)。
-
-4. **服务器回复 "hello"**
- - 设备等待服务器返回一条包含 `"type": "hello"` 的 JSON 消息,并检查 `"transport": "websocket"` 是否匹配。
- - 服务器可选下发 `session_id` 字段,设备端收到后会自动记录。
- - 示例:
- ```json
- {
- "type": "hello",
- "transport": "websocket",
- "session_id": "xxx",
- "audio_params": {
- "format": "opus",
- "sample_rate": 24000,
- "channels": 1,
- "frame_duration": 60
- }
- }
- ```
- - 如果匹配,则认为服务器已就绪,标记音频通道打开成功。
- - 如果在超时时间(默认 10 秒)内未收到正确回复,认为连接失败并触发网络错误回调。
-
-5. **后续消息交互**
- - 设备端和服务器端之间可发送两种主要类型的数据:
- 1. **二进制音频数据**(Opus 编码)
- 2. **文本 JSON 消息**(用于传输聊天状态、TTS/STT 事件、MCP 协议消息等)
-
- - 在代码里,接收回调主要分为:
- - `OnData(...)`:
- - 当 `binary` 为 `true` 时,认为是音频帧;设备会将其当作 Opus 数据进行解码。
- - 当 `binary` 为 `false` 时,认为是 JSON 文本,需要在设备端用 cJSON 进行解析并做相应业务逻辑处理(如聊天、TTS、MCP 协议消息等)。
-
- - 当服务器或网络出现断连,回调 `OnDisconnected()` 被触发:
- - 设备会调用 `on_audio_channel_closed_()`,并最终回到空闲状态。
-
-6. **关闭 WebSocket 连接**
- - 设备在需要结束语音会话时,会调用 `CloseAudioChannel()` 主动断开连接,并回到空闲状态。
- - 或者如果服务器端主动断开,也会引发同样的回调流程。
-
----
-
-## 2. 通用请求头
-
-在建立 WebSocket 连接时,代码示例中设置了以下请求头:
-
-- `Authorization`: 用于存放访问令牌,形如 `"Bearer "`
-- `Protocol-Version`: 协议版本号,与 hello 消息体内的 `version` 字段保持一致
-- `Device-Id`: 设备物理网卡 MAC 地址
-- `Client-Id`: 软件生成的 UUID(擦除 NVS 或重新烧录完整固件会重置)
-
-这些头会随着 WebSocket 握手一起发送到服务器,服务器可根据需求进行校验、认证等。
-
----
-
-## 3. 二进制协议版本
-
-设备支持多种二进制协议版本,通过配置中的 `version` 字段指定:
-
-### 3.1 版本1(默认)
-直接发送 Opus 音频数据,无额外元数据。Websocket 协议会区分 text 与 binary。
-
-### 3.2 版本2
-使用 `BinaryProtocol2` 结构:
-```c
-struct BinaryProtocol2 {
- uint16_t version; // 协议版本
- uint16_t type; // 消息类型 (0: OPUS, 1: JSON)
- uint32_t reserved; // 保留字段
- uint32_t timestamp; // 时间戳(毫秒,用于服务器端AEC)
- uint32_t payload_size; // 负载大小(字节)
- uint8_t payload[]; // 负载数据
-} __attribute__((packed));
-```
-
-### 3.3 版本3
-使用 `BinaryProtocol3` 结构:
-```c
-struct BinaryProtocol3 {
- uint8_t type; // 消息类型
- uint8_t reserved; // 保留字段
- uint16_t payload_size; // 负载大小
- uint8_t payload[]; // 负载数据
-} __attribute__((packed));
-```
-
----
-
-## 4. JSON 消息结构
-
-WebSocket 文本帧以 JSON 方式传输,以下为常见的 `"type"` 字段及其对应业务逻辑。若消息里包含未列出的字段,可能为可选或特定实现细节。
-
-### 4.1 设备端→服务器
-
-1. **Hello**
- - 连接成功后,由设备端发送,告知服务器基本参数。
- - 例:
- ```json
- {
- "type": "hello",
- "version": 1,
- "features": {
- "mcp": true
- },
- "transport": "websocket",
- "audio_params": {
- "format": "opus",
- "sample_rate": 16000,
- "channels": 1,
- "frame_duration": 60
- }
- }
- ```
-
-2. **Listen**
- - 表示设备端开始或停止录音监听。
- - 常见字段:
- - `"session_id"`:会话标识
- - `"type": "listen"`
- - `"state"`:`"start"`, `"stop"`, `"detect"`(唤醒检测已触发)
- - `"mode"`:`"auto"`, `"manual"` 或 `"realtime"`,表示识别模式。
- - 例:开始监听
- ```json
- {
- "session_id": "xxx",
- "type": "listen",
- "state": "start",
- "mode": "manual"
- }
- ```
-
-3. **Abort**
- - 终止当前说话(TTS 播放)或语音通道。
- - 例:
- ```json
- {
- "session_id": "xxx",
- "type": "abort",
- "reason": "wake_word_detected"
- }
- ```
- - `reason` 值可为 `"wake_word_detected"` 或其他。
-
-4. **Wake Word Detected**
- - 用于设备端向服务器告知检测到唤醒词。
- - 在发送该消息之前,可提前发送唤醒词的 Opus 音频数据,用于服务器进行声纹检测。
- - 例:
- ```json
- {
- "session_id": "xxx",
- "type": "listen",
- "state": "detect",
- "text": "你好小明"
- }
- ```
-
-5. **MCP**
- - 推荐用于物联网控制的新一代协议。所有设备能力发现、工具调用等均通过 type: "mcp" 的消息进行,payload 内部为标准 JSON-RPC 2.0(详见 [MCP 协议文档](./mcp-protocol.md))。
-
- - **设备端到服务器发送 result 的例子:**
- ```json
- {
- "session_id": "xxx",
- "type": "mcp",
- "payload": {
- "jsonrpc": "2.0",
- "id": 1,
- "result": {
- "content": [
- { "type": "text", "text": "true" }
- ],
- "isError": false
- }
- }
- }
- ```
-
----
-
-### 4.2 服务器→设备端
-
-1. **Hello**
- - 服务器端返回的握手确认消息。
- - 必须包含 `"type": "hello"` 和 `"transport": "websocket"`。
- - 可能会带有 `audio_params`,表示服务器期望的音频参数,或与设备端对齐的配置。
- - 服务器可选下发 `session_id` 字段,设备端收到后会自动记录。
- - 成功接收后设备端会设置事件标志,表示 WebSocket 通道就绪。
-
-2. **STT**
- - `{"session_id": "xxx", "type": "stt", "text": "..."}`
- - 表示服务器端识别到了用户语音。(例如语音转文本结果)
- - 设备可能将此文本显示到屏幕上,后续再进入回答等流程。
-
-3. **LLM**
- - `{"session_id": "xxx", "type": "llm", "emotion": "happy", "text": "😀"}`
- - 服务器指示设备调整表情动画 / UI 表达。
-
-4. **TTS**
- - `{"session_id": "xxx", "type": "tts", "state": "start"}`:服务器准备下发 TTS 音频,设备端进入 "speaking" 播放状态。
- - `{"session_id": "xxx", "type": "tts", "state": "stop"}`:表示本次 TTS 结束。
- - `{"session_id": "xxx", "type": "tts", "state": "sentence_start", "text": "..."}`
- - 让设备在界面上显示当前要播放或朗读的文本片段(例如用于显示给用户)。
-
-5. **MCP**
- - 服务器通过 type: "mcp" 的消息下发物联网相关的控制指令或返回调用结果,payload 结构同上。
-
- - **服务器到设备端发送 tools/call 的例子:**
- ```json
- {
- "session_id": "xxx",
- "type": "mcp",
- "payload": {
- "jsonrpc": "2.0",
- "method": "tools/call",
- "params": {
- "name": "self.light.set_rgb",
- "arguments": { "r": 255, "g": 0, "b": 0 }
- },
- "id": 1
- }
- }
- ```
-
-6. **System**
- - 系统控制命令,常用于远程升级更新。
- - 例:
- ```json
- {
- "session_id": "xxx",
- "type": "system",
- "command": "reboot"
- }
- ```
- - 支持的命令:
- - `"reboot"`:重启设备
-
-7. **Custom**(可选)
- - 自定义消息,当 `CONFIG_RECEIVE_CUSTOM_MESSAGE` 启用时支持。
- - 例:
- ```json
- {
- "session_id": "xxx",
- "type": "custom",
- "payload": {
- "message": "自定义内容"
- }
- }
- ```
-
-8. **音频数据:二进制帧**
- - 当服务器发送音频二进制帧(Opus 编码)时,设备端解码并播放。
- - 若设备端正在处于 "listening" (录音)状态,收到的音频帧会被忽略或清空以防冲突。
-
----
-
-## 5. 音频编解码
-
-1. **设备端发送录音数据**
- - 音频输入经过可能的回声消除、降噪或音量增益后,通过 Opus 编码打包为二进制帧发送给服务器。
- - 根据协议版本,可能直接发送 Opus 数据(版本1)或使用带元数据的二进制协议(版本2/3)。
-
-2. **设备端播放收到的音频**
- - 收到服务器的二进制帧时,同样认定是 Opus 数据。
- - 设备端会进行解码,然后交由音频输出接口播放。
- - 如果服务器的音频采样率与设备不一致,会在解码后再进行重采样。
-
----
-
-## 6. 常见状态流转
-
-以下为常见设备端关键状态流转,与 WebSocket 消息对应:
-
-1. **Idle** → **Connecting**
- - 用户触发或唤醒后,设备调用 `OpenAudioChannel()` → 建立 WebSocket 连接 → 发送 `"type":"hello"`。
-
-2. **Connecting** → **Listening**
- - 成功建立连接后,若继续执行 `SendStartListening(...)`,则进入录音状态。此时设备会持续编码麦克风数据并发送到服务器。
-
-3. **Listening** → **Speaking**
- - 收到服务器 TTS Start 消息 (`{"type":"tts","state":"start"}`) → 停止录音并播放接收到的音频。
-
-4. **Speaking** → **Idle**
- - 服务器 TTS Stop (`{"type":"tts","state":"stop"}`) → 音频播放结束。若未继续进入自动监听,则返回 Idle;如果配置了自动循环,则再度进入 Listening。
-
-5. **Listening** / **Speaking** → **Idle**(遇到异常或主动中断)
- - 调用 `SendAbortSpeaking(...)` 或 `CloseAudioChannel()` → 中断会话 → 关闭 WebSocket → 状态回到 Idle。
-
-### 自动模式状态流转图
-
-```mermaid
-stateDiagram
- direction TB
- [*] --> kDeviceStateUnknown
- kDeviceStateUnknown --> kDeviceStateStarting:初始化
- kDeviceStateStarting --> kDeviceStateWifiConfiguring:配置WiFi
- kDeviceStateStarting --> kDeviceStateActivating:激活设备
- kDeviceStateActivating --> kDeviceStateUpgrading:检测到新版本
- kDeviceStateActivating --> kDeviceStateIdle:激活完成
- kDeviceStateIdle --> kDeviceStateConnecting:开始连接
- kDeviceStateConnecting --> kDeviceStateIdle:连接失败
- kDeviceStateConnecting --> kDeviceStateListening:连接成功
- kDeviceStateListening --> kDeviceStateSpeaking:开始说话
- kDeviceStateSpeaking --> kDeviceStateListening:结束说话
- kDeviceStateListening --> kDeviceStateIdle:手动终止
- kDeviceStateSpeaking --> kDeviceStateIdle:自动终止
-```
-
-### 手动模式状态流转图
-
-```mermaid
-stateDiagram
- direction TB
- [*] --> kDeviceStateUnknown
- kDeviceStateUnknown --> kDeviceStateStarting:初始化
- kDeviceStateStarting --> kDeviceStateWifiConfiguring:配置WiFi
- kDeviceStateStarting --> kDeviceStateActivating:激活设备
- kDeviceStateActivating --> kDeviceStateUpgrading:检测到新版本
- kDeviceStateActivating --> kDeviceStateIdle:激活完成
- kDeviceStateIdle --> kDeviceStateConnecting:开始连接
- kDeviceStateConnecting --> kDeviceStateIdle:连接失败
- kDeviceStateConnecting --> kDeviceStateListening:连接成功
- kDeviceStateIdle --> kDeviceStateListening:开始监听
- kDeviceStateListening --> kDeviceStateIdle:停止监听
- kDeviceStateIdle --> kDeviceStateSpeaking:开始说话
- kDeviceStateSpeaking --> kDeviceStateIdle:结束说话
-```
-
----
-
-## 7. 错误处理
-
-1. **连接失败**
- - 如果 `Connect(url)` 返回失败或在等待服务器 "hello" 消息时超时,触发 `on_network_error_()` 回调。设备会提示"无法连接到服务"或类似错误信息。
-
-2. **服务器断开**
- - 如果 WebSocket 异常断开,回调 `OnDisconnected()`:
- - 设备回调 `on_audio_channel_closed_()`
- - 切换到 Idle 或其他重试逻辑。
-
----
-
-## 8. 其它注意事项
-
-1. **鉴权**
- - 设备通过设置 `Authorization: Bearer ` 提供鉴权,服务器端需验证是否有效。
- - 如果令牌过期或无效,服务器可拒绝握手或在后续断开。
-
-2. **会话控制**
- - 代码中部分消息包含 `session_id`,用于区分独立的对话或操作。服务端可根据需要对不同会话做分离处理。
-
-3. **音频负载**
- - 代码里默认使用 Opus 格式,并设置 `sample_rate = 16000`,单声道。帧时长由 `OPUS_FRAME_DURATION_MS` 控制,一般为 60ms。可根据带宽或性能做适当调整。为了获得更好的音乐播放效果,服务器下行音频可能使用 24000 采样率。
-
-4. **协议版本配置**
- - 通过设置中的 `version` 字段配置二进制协议版本(1、2 或 3)
- - 版本1:直接发送 Opus 数据
- - 版本2:使用带时间戳的二进制协议,适用于服务器端 AEC
- - 版本3:使用简化的二进制协议
-
-5. **物联网控制推荐 MCP 协议**
- - 设备与服务器之间的物联网能力发现、状态同步、控制指令等,建议全部通过 MCP 协议(type: "mcp")实现。原有的 type: "iot" 方案已废弃。
- - MCP 协议可在 WebSocket、MQTT 等多种底层协议上传输,具备更好的扩展性和标准化能力。
- - 详细用法请参考 [MCP 协议文档](./mcp-protocol.md) 及 [MCP 物联网控制用法](./mcp-usage.md)。
-
-6. **错误或异常 JSON**
- - 当 JSON 中缺少必要字段,例如 `{"type": ...}`,设备端会记录错误日志(`ESP_LOGE(TAG, "Missing message type, data: %s", data);`),不会执行任何业务。
-
----
-
-## 9. 消息示例
-
-下面给出一个典型的双向消息示例(流程简化示意):
-
-1. **设备端 → 服务器**(握手)
- ```json
- {
- "type": "hello",
- "version": 1,
- "features": {
- "mcp": true
- },
- "transport": "websocket",
- "audio_params": {
- "format": "opus",
- "sample_rate": 16000,
- "channels": 1,
- "frame_duration": 60
- }
- }
- ```
-
-2. **服务器 → 设备端**(握手应答)
- ```json
- {
- "type": "hello",
- "transport": "websocket",
- "session_id": "xxx",
- "audio_params": {
- "format": "opus",
- "sample_rate": 16000
- }
- }
- ```
-
-3. **设备端 → 服务器**(开始监听)
- ```json
- {
- "session_id": "xxx",
- "type": "listen",
- "state": "start",
- "mode": "auto"
- }
- ```
- 同时设备端开始发送二进制帧(Opus 数据)。
-
-4. **服务器 → 设备端**(ASR 结果)
- ```json
- {
- "session_id": "xxx",
- "type": "stt",
- "text": "用户说的话"
- }
- ```
-
-5. **服务器 → 设备端**(TTS开始)
- ```json
- {
- "session_id": "xxx",
- "type": "tts",
- "state": "start"
- }
- ```
- 接着服务器发送二进制音频帧给设备端播放。
-
-6. **服务器 → 设备端**(TTS结束)
- ```json
- {
- "session_id": "xxx",
- "type": "tts",
- "state": "stop"
- }
- ```
- 设备端停止播放音频,若无更多指令,则回到空闲状态。
-
----
-
-## 10. 总结
-
-本协议通过在 WebSocket 上层传输 JSON 文本与二进制音频帧,完成功能包括音频流上传、TTS 音频播放、语音识别与状态管理、MCP 指令下发等。其核心特征:
-
-- **握手阶段**:发送 `"type":"hello"`,等待服务器返回。
-- **音频通道**:采用 Opus 编码的二进制帧双向传输语音流,支持多种协议版本。
-- **JSON 消息**:使用 `"type"` 为核心字段标识不同业务逻辑,包括 TTS、STT、MCP、WakeWord、System、Custom 等。
-- **扩展性**:可根据实际需求在 JSON 消息中添加字段,或在 headers 里进行额外鉴权。
-
-服务器与设备端需提前约定各类消息的字段含义、时序逻辑以及错误处理规则,方能保证通信顺畅。上述信息可作为基础文档,便于后续对接、开发或扩展。
+以下是一份基于代码实现整理的 WebSocket 通信协议文档,概述设备端与服务器之间如何通过 WebSocket 进行交互。
+
+该文档仅基于所提供的代码推断,实际部署时可能需要结合服务器端实现进行进一步确认或补充。
+
+---
+
+## 1. 总体流程概览
+
+1. **设备端初始化**
+ - 设备上电、初始化 `Application`:
+ - 初始化音频编解码器、显示屏、LED 等
+ - 连接网络
+ - 创建并初始化实现 `Protocol` 接口的 WebSocket 协议实例(`WebsocketProtocol`)
+ - 进入主循环等待事件(音频输入、音频输出、调度任务等)。
+
+2. **建立 WebSocket 连接**
+ - 当设备需要开始语音会话时(例如用户唤醒、手动按键触发等),调用 `OpenAudioChannel()`:
+ - 根据配置获取 WebSocket URL
+ - 设置若干请求头(`Authorization`, `Protocol-Version`, `Device-Id`, `Client-Id`)
+ - 调用 `Connect()` 与服务器建立 WebSocket 连接
+
+3. **设备端发送 "hello" 消息**
+ - 连接成功后,设备会发送一条 JSON 消息,示例结构如下:
+ ```json
+ {
+ "type": "hello",
+ "version": 1,
+ "features": {
+ "mcp": true
+ },
+ "transport": "websocket",
+ "audio_params": {
+ "format": "opus",
+ "sample_rate": 16000,
+ "channels": 1,
+ "frame_duration": 60
+ }
+ }
+ ```
+ - 其中 `features` 字段为可选,内容根据设备编译配置自动生成。例如:`"mcp": true` 表示支持 MCP 协议。
+ - `frame_duration` 的值对应 `OPUS_FRAME_DURATION_MS`(例如 60ms)。
+
+4. **服务器回复 "hello"**
+ - 设备等待服务器返回一条包含 `"type": "hello"` 的 JSON 消息,并检查 `"transport": "websocket"` 是否匹配。
+ - 服务器可选下发 `session_id` 字段,设备端收到后会自动记录。
+ - 示例:
+ ```json
+ {
+ "type": "hello",
+ "transport": "websocket",
+ "session_id": "xxx",
+ "audio_params": {
+ "format": "opus",
+ "sample_rate": 24000,
+ "channels": 1,
+ "frame_duration": 60
+ }
+ }
+ ```
+ - 如果匹配,则认为服务器已就绪,标记音频通道打开成功。
+ - 如果在超时时间(默认 10 秒)内未收到正确回复,认为连接失败并触发网络错误回调。
+
+5. **后续消息交互**
+ - 设备端和服务器端之间可发送两种主要类型的数据:
+ 1. **二进制音频数据**(Opus 编码)
+ 2. **文本 JSON 消息**(用于传输聊天状态、TTS/STT 事件、MCP 协议消息等)
+
+ - 在代码里,接收回调主要分为:
+ - `OnData(...)`:
+ - 当 `binary` 为 `true` 时,认为是音频帧;设备会将其当作 Opus 数据进行解码。
+ - 当 `binary` 为 `false` 时,认为是 JSON 文本,需要在设备端用 cJSON 进行解析并做相应业务逻辑处理(如聊天、TTS、MCP 协议消息等)。
+
+ - 当服务器或网络出现断连,回调 `OnDisconnected()` 被触发:
+ - 设备会调用 `on_audio_channel_closed_()`,并最终回到空闲状态。
+
+6. **关闭 WebSocket 连接**
+ - 设备在需要结束语音会话时,会调用 `CloseAudioChannel()` 主动断开连接,并回到空闲状态。
+ - 或者如果服务器端主动断开,也会引发同样的回调流程。
+
+---
+
+## 2. 通用请求头
+
+在建立 WebSocket 连接时,代码示例中设置了以下请求头:
+
+- `Authorization`: 用于存放访问令牌,形如 `"Bearer "`
+- `Protocol-Version`: 协议版本号,与 hello 消息体内的 `version` 字段保持一致
+- `Device-Id`: 设备物理网卡 MAC 地址
+- `Client-Id`: 软件生成的 UUID(擦除 NVS 或重新烧录完整固件会重置)
+
+这些头会随着 WebSocket 握手一起发送到服务器,服务器可根据需求进行校验、认证等。
+
+---
+
+## 3. 二进制协议版本
+
+设备支持多种二进制协议版本,通过配置中的 `version` 字段指定:
+
+### 3.1 版本1(默认)
+直接发送 Opus 音频数据,无额外元数据。Websocket 协议会区分 text 与 binary。
+
+### 3.2 版本2
+使用 `BinaryProtocol2` 结构:
+```c
+struct BinaryProtocol2 {
+ uint16_t version; // 协议版本
+ uint16_t type; // 消息类型 (0: OPUS, 1: JSON)
+ uint32_t reserved; // 保留字段
+ uint32_t timestamp; // 时间戳(毫秒,用于服务器端AEC)
+ uint32_t payload_size; // 负载大小(字节)
+ uint8_t payload[]; // 负载数据
+} __attribute__((packed));
+```
+
+### 3.3 版本3
+使用 `BinaryProtocol3` 结构:
+```c
+struct BinaryProtocol3 {
+ uint8_t type; // 消息类型
+ uint8_t reserved; // 保留字段
+ uint16_t payload_size; // 负载大小
+ uint8_t payload[]; // 负载数据
+} __attribute__((packed));
+```
+
+---
+
+## 4. JSON 消息结构
+
+WebSocket 文本帧以 JSON 方式传输,以下为常见的 `"type"` 字段及其对应业务逻辑。若消息里包含未列出的字段,可能为可选或特定实现细节。
+
+### 4.1 设备端→服务器
+
+1. **Hello**
+ - 连接成功后,由设备端发送,告知服务器基本参数。
+ - 例:
+ ```json
+ {
+ "type": "hello",
+ "version": 1,
+ "features": {
+ "mcp": true
+ },
+ "transport": "websocket",
+ "audio_params": {
+ "format": "opus",
+ "sample_rate": 16000,
+ "channels": 1,
+ "frame_duration": 60
+ }
+ }
+ ```
+
+2. **Listen**
+ - 表示设备端开始或停止录音监听。
+ - 常见字段:
+ - `"session_id"`:会话标识
+ - `"type": "listen"`
+ - `"state"`:`"start"`, `"stop"`, `"detect"`(唤醒检测已触发)
+ - `"mode"`:`"auto"`, `"manual"` 或 `"realtime"`,表示识别模式。
+ - 例:开始监听
+ ```json
+ {
+ "session_id": "xxx",
+ "type": "listen",
+ "state": "start",
+ "mode": "manual"
+ }
+ ```
+
+3. **Abort**
+ - 终止当前说话(TTS 播放)或语音通道。
+ - 例:
+ ```json
+ {
+ "session_id": "xxx",
+ "type": "abort",
+ "reason": "wake_word_detected"
+ }
+ ```
+ - `reason` 值可为 `"wake_word_detected"` 或其他。
+
+4. **Wake Word Detected**
+ - 用于设备端向服务器告知检测到唤醒词。
+ - 在发送该消息之前,可提前发送唤醒词的 Opus 音频数据,用于服务器进行声纹检测。
+ - 例:
+ ```json
+ {
+ "session_id": "xxx",
+ "type": "listen",
+ "state": "detect",
+ "text": "你好小明"
+ }
+ ```
+
+5. **MCP**
+ - 推荐用于物联网控制的新一代协议。所有设备能力发现、工具调用等均通过 type: "mcp" 的消息进行,payload 内部为标准 JSON-RPC 2.0(详见 [MCP 协议文档](./mcp-protocol.md))。
+
+ - **设备端到服务器发送 result 的例子:**
+ ```json
+ {
+ "session_id": "xxx",
+ "type": "mcp",
+ "payload": {
+ "jsonrpc": "2.0",
+ "id": 1,
+ "result": {
+ "content": [
+ { "type": "text", "text": "true" }
+ ],
+ "isError": false
+ }
+ }
+ }
+ ```
+
+---
+
+### 4.2 服务器→设备端
+
+1. **Hello**
+ - 服务器端返回的握手确认消息。
+ - 必须包含 `"type": "hello"` 和 `"transport": "websocket"`。
+ - 可能会带有 `audio_params`,表示服务器期望的音频参数,或与设备端对齐的配置。
+ - 服务器可选下发 `session_id` 字段,设备端收到后会自动记录。
+ - 成功接收后设备端会设置事件标志,表示 WebSocket 通道就绪。
+
+2. **STT**
+ - `{"session_id": "xxx", "type": "stt", "text": "..."}`
+ - 表示服务器端识别到了用户语音。(例如语音转文本结果)
+ - 设备可能将此文本显示到屏幕上,后续再进入回答等流程。
+
+3. **LLM**
+ - `{"session_id": "xxx", "type": "llm", "emotion": "happy", "text": "😀"}`
+ - 服务器指示设备调整表情动画 / UI 表达。
+
+4. **TTS**
+ - `{"session_id": "xxx", "type": "tts", "state": "start"}`:服务器准备下发 TTS 音频,设备端进入 "speaking" 播放状态。
+ - `{"session_id": "xxx", "type": "tts", "state": "stop"}`:表示本次 TTS 结束。
+ - `{"session_id": "xxx", "type": "tts", "state": "sentence_start", "text": "..."}`
+ - 让设备在界面上显示当前要播放或朗读的文本片段(例如用于显示给用户)。
+
+5. **MCP**
+ - 服务器通过 type: "mcp" 的消息下发物联网相关的控制指令或返回调用结果,payload 结构同上。
+
+ - **服务器到设备端发送 tools/call 的例子:**
+ ```json
+ {
+ "session_id": "xxx",
+ "type": "mcp",
+ "payload": {
+ "jsonrpc": "2.0",
+ "method": "tools/call",
+ "params": {
+ "name": "self.light.set_rgb",
+ "arguments": { "r": 255, "g": 0, "b": 0 }
+ },
+ "id": 1
+ }
+ }
+ ```
+
+6. **System**
+ - 系统控制命令,常用于远程升级更新。
+ - 例:
+ ```json
+ {
+ "session_id": "xxx",
+ "type": "system",
+ "command": "reboot"
+ }
+ ```
+ - 支持的命令:
+ - `"reboot"`:重启设备
+
+7. **Custom**(可选)
+ - 自定义消息,当 `CONFIG_RECEIVE_CUSTOM_MESSAGE` 启用时支持。
+ - 例:
+ ```json
+ {
+ "session_id": "xxx",
+ "type": "custom",
+ "payload": {
+ "message": "自定义内容"
+ }
+ }
+ ```
+
+8. **音频数据:二进制帧**
+ - 当服务器发送音频二进制帧(Opus 编码)时,设备端解码并播放。
+ - 若设备端正在处于 "listening" (录音)状态,收到的音频帧会被忽略或清空以防冲突。
+
+---
+
+## 5. 音频编解码
+
+1. **设备端发送录音数据**
+ - 音频输入经过可能的回声消除、降噪或音量增益后,通过 Opus 编码打包为二进制帧发送给服务器。
+ - 根据协议版本,可能直接发送 Opus 数据(版本1)或使用带元数据的二进制协议(版本2/3)。
+
+2. **设备端播放收到的音频**
+ - 收到服务器的二进制帧时,同样认定是 Opus 数据。
+ - 设备端会进行解码,然后交由音频输出接口播放。
+ - 如果服务器的音频采样率与设备不一致,会在解码后再进行重采样。
+
+---
+
+## 6. 常见状态流转
+
+以下为常见设备端关键状态流转,与 WebSocket 消息对应:
+
+1. **Idle** → **Connecting**
+ - 用户触发或唤醒后,设备调用 `OpenAudioChannel()` → 建立 WebSocket 连接 → 发送 `"type":"hello"`。
+
+2. **Connecting** → **Listening**
+ - 成功建立连接后,若继续执行 `SendStartListening(...)`,则进入录音状态。此时设备会持续编码麦克风数据并发送到服务器。
+
+3. **Listening** → **Speaking**
+ - 收到服务器 TTS Start 消息 (`{"type":"tts","state":"start"}`) → 停止录音并播放接收到的音频。
+
+4. **Speaking** → **Idle**
+ - 服务器 TTS Stop (`{"type":"tts","state":"stop"}`) → 音频播放结束。若未继续进入自动监听,则返回 Idle;如果配置了自动循环,则再度进入 Listening。
+
+5. **Listening** / **Speaking** → **Idle**(遇到异常或主动中断)
+ - 调用 `SendAbortSpeaking(...)` 或 `CloseAudioChannel()` → 中断会话 → 关闭 WebSocket → 状态回到 Idle。
+
+### 自动模式状态流转图
+
+```mermaid
+stateDiagram
+ direction TB
+ [*] --> kDeviceStateUnknown
+ kDeviceStateUnknown --> kDeviceStateStarting:初始化
+ kDeviceStateStarting --> kDeviceStateWifiConfiguring:配置WiFi
+ kDeviceStateStarting --> kDeviceStateActivating:激活设备
+ kDeviceStateActivating --> kDeviceStateUpgrading:检测到新版本
+ kDeviceStateActivating --> kDeviceStateIdle:激活完成
+ kDeviceStateIdle --> kDeviceStateConnecting:开始连接
+ kDeviceStateConnecting --> kDeviceStateIdle:连接失败
+ kDeviceStateConnecting --> kDeviceStateListening:连接成功
+ kDeviceStateListening --> kDeviceStateSpeaking:开始说话
+ kDeviceStateSpeaking --> kDeviceStateListening:结束说话
+ kDeviceStateListening --> kDeviceStateIdle:手动终止
+ kDeviceStateSpeaking --> kDeviceStateIdle:自动终止
+```
+
+### 手动模式状态流转图
+
+```mermaid
+stateDiagram
+ direction TB
+ [*] --> kDeviceStateUnknown
+ kDeviceStateUnknown --> kDeviceStateStarting:初始化
+ kDeviceStateStarting --> kDeviceStateWifiConfiguring:配置WiFi
+ kDeviceStateStarting --> kDeviceStateActivating:激活设备
+ kDeviceStateActivating --> kDeviceStateUpgrading:检测到新版本
+ kDeviceStateActivating --> kDeviceStateIdle:激活完成
+ kDeviceStateIdle --> kDeviceStateConnecting:开始连接
+ kDeviceStateConnecting --> kDeviceStateIdle:连接失败
+ kDeviceStateConnecting --> kDeviceStateListening:连接成功
+ kDeviceStateIdle --> kDeviceStateListening:开始监听
+ kDeviceStateListening --> kDeviceStateIdle:停止监听
+ kDeviceStateIdle --> kDeviceStateSpeaking:开始说话
+ kDeviceStateSpeaking --> kDeviceStateIdle:结束说话
+```
+
+---
+
+## 7. 错误处理
+
+1. **连接失败**
+ - 如果 `Connect(url)` 返回失败或在等待服务器 "hello" 消息时超时,触发 `on_network_error_()` 回调。设备会提示"无法连接到服务"或类似错误信息。
+
+2. **服务器断开**
+ - 如果 WebSocket 异常断开,回调 `OnDisconnected()`:
+ - 设备回调 `on_audio_channel_closed_()`
+ - 切换到 Idle 或其他重试逻辑。
+
+---
+
+## 8. 其它注意事项
+
+1. **鉴权**
+ - 设备通过设置 `Authorization: Bearer ` 提供鉴权,服务器端需验证是否有效。
+ - 如果令牌过期或无效,服务器可拒绝握手或在后续断开。
+
+2. **会话控制**
+ - 代码中部分消息包含 `session_id`,用于区分独立的对话或操作。服务端可根据需要对不同会话做分离处理。
+
+3. **音频负载**
+ - 代码里默认使用 Opus 格式,并设置 `sample_rate = 16000`,单声道。帧时长由 `OPUS_FRAME_DURATION_MS` 控制,一般为 60ms。可根据带宽或性能做适当调整。为了获得更好的音乐播放效果,服务器下行音频可能使用 24000 采样率。
+
+4. **协议版本配置**
+ - 通过设置中的 `version` 字段配置二进制协议版本(1、2 或 3)
+ - 版本1:直接发送 Opus 数据
+ - 版本2:使用带时间戳的二进制协议,适用于服务器端 AEC
+ - 版本3:使用简化的二进制协议
+
+5. **物联网控制推荐 MCP 协议**
+ - 设备与服务器之间的物联网能力发现、状态同步、控制指令等,建议全部通过 MCP 协议(type: "mcp")实现。原有的 type: "iot" 方案已废弃。
+ - MCP 协议可在 WebSocket、MQTT 等多种底层协议上传输,具备更好的扩展性和标准化能力。
+ - 详细用法请参考 [MCP 协议文档](./mcp-protocol.md) 及 [MCP 物联网控制用法](./mcp-usage.md)。
+
+6. **错误或异常 JSON**
+ - 当 JSON 中缺少必要字段,例如 `{"type": ...}`,设备端会记录错误日志(`ESP_LOGE(TAG, "Missing message type, data: %s", data);`),不会执行任何业务。
+
+---
+
+## 9. 消息示例
+
+下面给出一个典型的双向消息示例(流程简化示意):
+
+1. **设备端 → 服务器**(握手)
+ ```json
+ {
+ "type": "hello",
+ "version": 1,
+ "features": {
+ "mcp": true
+ },
+ "transport": "websocket",
+ "audio_params": {
+ "format": "opus",
+ "sample_rate": 16000,
+ "channels": 1,
+ "frame_duration": 60
+ }
+ }
+ ```
+
+2. **服务器 → 设备端**(握手应答)
+ ```json
+ {
+ "type": "hello",
+ "transport": "websocket",
+ "session_id": "xxx",
+ "audio_params": {
+ "format": "opus",
+ "sample_rate": 16000
+ }
+ }
+ ```
+
+3. **设备端 → 服务器**(开始监听)
+ ```json
+ {
+ "session_id": "xxx",
+ "type": "listen",
+ "state": "start",
+ "mode": "auto"
+ }
+ ```
+ 同时设备端开始发送二进制帧(Opus 数据)。
+
+4. **服务器 → 设备端**(ASR 结果)
+ ```json
+ {
+ "session_id": "xxx",
+ "type": "stt",
+ "text": "用户说的话"
+ }
+ ```
+
+5. **服务器 → 设备端**(TTS开始)
+ ```json
+ {
+ "session_id": "xxx",
+ "type": "tts",
+ "state": "start"
+ }
+ ```
+ 接着服务器发送二进制音频帧给设备端播放。
+
+6. **服务器 → 设备端**(TTS结束)
+ ```json
+ {
+ "session_id": "xxx",
+ "type": "tts",
+ "state": "stop"
+ }
+ ```
+ 设备端停止播放音频,若无更多指令,则回到空闲状态。
+
+---
+
+## 10. 总结
+
+本协议通过在 WebSocket 上层传输 JSON 文本与二进制音频帧,完成功能包括音频流上传、TTS 音频播放、语音识别与状态管理、MCP 指令下发等。其核心特征:
+
+- **握手阶段**:发送 `"type":"hello"`,等待服务器返回。
+- **音频通道**:采用 Opus 编码的二进制帧双向传输语音流,支持多种协议版本。
+- **JSON 消息**:使用 `"type"` 为核心字段标识不同业务逻辑,包括 TTS、STT、MCP、WakeWord、System、Custom 等。
+- **扩展性**:可根据实际需求在 JSON 消息中添加字段,或在 headers 里进行额外鉴权。
+
+服务器与设备端需提前约定各类消息的字段含义、时序逻辑以及错误处理规则,方能保证通信顺畅。上述信息可作为基础文档,便于后续对接、开发或扩展。
diff --git a/esptool.exe b/esptool.exe
new file mode 100755
index 0000000..b442514
Binary files /dev/null and b/esptool.exe differ
diff --git a/main/CMakeLists.txt b/main/CMakeLists.txt
index 130ebe1..440d734 100644
--- a/main/CMakeLists.txt
+++ b/main/CMakeLists.txt
@@ -1,833 +1,805 @@
-# Define default assets files (Absolute url starting with http or https is supported)
-set(ASSETS_URL_PREFIX "https://files.xiaozhi.me/assets/default/")
-
-set(ASSETS_PUHUI_COMMON_14_1 "${ASSETS_URL_PREFIX}none-font_puhui_common_14_1-none.bin")
-set(ASSETS_XIAOZHI_WAKENET_ONLY "${ASSETS_URL_PREFIX}wn9_nihaoxiaozhi_tts-none-none.bin")
-set(ASSETS_XIAOZHI_PUHUI_COMMON_14_1 "${ASSETS_URL_PREFIX}wn9_nihaoxiaozhi_tts-font_puhui_common_14_1-none.bin")
-set(ASSETS_XIAOZHI_PUHUI_COMMON_16_4_EMOJI_32 "${ASSETS_URL_PREFIX}wn9_nihaoxiaozhi_tts-font_puhui_common_16_4-emojis_32.bin")
-set(ASSETS_XIAOZHI_PUHUI_COMMON_16_4_EMOJI_64 "${ASSETS_URL_PREFIX}wn9_nihaoxiaozhi_tts-font_puhui_common_16_4-emojis_64.bin")
-set(ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64 "${ASSETS_URL_PREFIX}wn9_nihaoxiaozhi_tts-font_puhui_common_20_4-emojis_64.bin")
-set(ASSETS_XIAOZHI_PUHUI_COMMON_30_4_EMOJI_64 "${ASSETS_URL_PREFIX}wn9_nihaoxiaozhi_tts-font_puhui_common_30_4-emojis_64.bin")
-set(ASSETS_XIAOZHI_S_WAKENET_ONLY "${ASSETS_URL_PREFIX}wn9s_nihaoxiaozhi-none-none.bin")
-set(ASSETS_XIAOZHI_S_PUHUI_COMMON_14_1 "${ASSETS_URL_PREFIX}wn9s_nihaoxiaozhi-font_puhui_common_14_1-none.bin")
-set(ASSETS_XIAOZHI_S_PUHUI_COMMON_16_4_EMOJI_32 "${ASSETS_URL_PREFIX}wn9s_nihaoxiaozhi-font_puhui_common_16_4-emojis_32.bin")
-set(ASSETS_XIAOZHI_S_PUHUI_COMMON_20_4_EMOJI_32 "${ASSETS_URL_PREFIX}wn9s_nihaoxiaozhi-font_puhui_common_20_4-emojis_32.bin")
-set(ASSETS_XIAOZHI_S_PUHUI_COMMON_20_4_EMOJI_64 "${ASSETS_URL_PREFIX}wn9s_nihaoxiaozhi-font_puhui_common_20_4-emojis_64.bin")
-set(ASSETS_XIAOZHI_S_PUHUI_COMMON_30_4_EMOJI_64 "${ASSETS_URL_PREFIX}wn9s_nihaoxiaozhi-font_puhui_common_30_4-emojis_64.bin")
-
-# Embedded font files defined in `xiaozhi-fonts` component
-# Basic fonts include ASCII and about 600 characters used in assets/locales
-set(FONT_PUHUI_BASIC_14_1 font_puhui_basic_14_1)
-set(FONT_PUHUI_BASIC_16_4 font_puhui_basic_16_4)
-set(FONT_PUHUI_BASIC_20_4 font_puhui_basic_20_4)
-set(FONT_PUHUI_BASIC_30_4 font_puhui_basic_30_4)
-# Common fonts include about 7000 common characters generated with DeepSeek R1 tokenizer
-set(FONT_PUHUI_COMMON_14_1 font_puhui_14_1)
-set(FONT_PUHUI_COMMON_16_4 font_puhui_16_4)
-set(FONT_PUHUI_COMMON_20_4 font_puhui_20_4)
-set(FONT_PUHUI_COMMON_30_4 font_puhui_30_4)
-set(FONT_AWESOME_14_1 font_awesome_14_1)
-set(FONT_AWESOME_30_1 font_awesome_30_1)
-set(FONT_AWESOME_16_4 font_awesome_16_4)
-set(FONT_AWESOME_20_4 font_awesome_20_4)
-set(FONT_AWESOME_30_4 font_awesome_30_4)
-
-
-# Define source files
-set(SOURCES "audio/audio_codec.cc"
- "audio/audio_service.cc"
- "audio/codecs/no_audio_codec.cc"
- "audio/codecs/box_audio_codec.cc"
- "audio/codecs/es8311_audio_codec.cc"
- "audio/codecs/es8374_audio_codec.cc"
- "audio/codecs/es8388_audio_codec.cc"
- "audio/codecs/es8389_audio_codec.cc"
- "audio/codecs/dummy_audio_codec.cc"
- "audio/processors/audio_debugger.cc"
- "led/single_led.cc"
- "led/circular_strip.cc"
- "led/gpio_led.cc"
- "display/display.cc"
- "display/lcd_display.cc"
- "display/oled_display.cc"
- "display/lvgl_display/lvgl_display.cc"
- "display/lvgl_display/emoji_collection.cc"
- "display/lvgl_display/lvgl_theme.cc"
- "display/lvgl_display/lvgl_font.cc"
- "display/lvgl_display/lvgl_image.cc"
- "display/lvgl_display/gif/lvgl_gif.cc"
- "display/lvgl_display/gif/gifdec.c"
- "display/esplog_display.cc"
- "protocols/protocol.cc"
- "protocols/mqtt_protocol.cc"
- "protocols/websocket_protocol.cc"
- "protocols/sleep_music_protocol.cc"
- "mcp_server.cc"
- "system_info.cc"
- "application.cc"
- "ota.cc"
- "settings.cc"
- "device_state_event.cc"
- "assets.cc"
- "schedule_manager.cc"
- "timer_manager.cc"
- "main.cc"
- )
-
-set(INCLUDE_DIRS "." "display" "display/lvgl_display" "audio" "protocols")
-
-# Add board common files
-file(GLOB BOARD_COMMON_SOURCES ${CMAKE_CURRENT_SOURCE_DIR}/boards/common/*.cc)
-list(APPEND SOURCES ${BOARD_COMMON_SOURCES})
-list(APPEND INCLUDE_DIRS ${CMAKE_CURRENT_SOURCE_DIR}/boards/common)
-
-# Set default LVGL_TEXT_FONT and LVGL_ICON_FONT
-set(LVGL_TEXT_FONT ${FONT_PUHUI_COMMON_14_1})
-set(LVGL_ICON_FONT ${FONT_AWESOME_14_1})
-
-# Add board files according to BOARD_TYPE
-# Set default assets if the board uses partition table V2
-if(CONFIG_BOARD_TYPE_BREAD_COMPACT_WIFI)
- set(BOARD_TYPE "bread-compact-wifi")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_14_1})
- set(LVGL_ICON_FONT ${FONT_AWESOME_14_1})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_14_1})
-elseif(CONFIG_BOARD_TYPE_BREAD_COMPACT_ML307)
- set(BOARD_TYPE "bread-compact-ml307")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_14_1})
- set(LVGL_ICON_FONT ${FONT_AWESOME_14_1})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_14_1})
-elseif(CONFIG_BOARD_TYPE_BREAD_COMPACT_ESP32)
- set(BOARD_TYPE "bread-compact-esp32")
-elseif(CONFIG_BOARD_TYPE_BREAD_COMPACT_ESP32_LCD)
- set(BOARD_TYPE "bread-compact-esp32-lcd")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_COMMON_14_1})
- set(LVGL_ICON_FONT ${FONT_AWESOME_14_1})
-elseif(CONFIG_BOARD_TYPE_DF_K10)
- set(BOARD_TYPE "df-k10")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_DF_S3_AI_CAM)
- set(BOARD_TYPE "df-s3-ai-cam")
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_WAKENET_ONLY})
-elseif(CONFIG_BOARD_TYPE_ESP_BOX_3)
- set(BOARD_TYPE "esp-box-3")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ESP_BOX)
- set(BOARD_TYPE "esp-box")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ESP_BOX_LITE)
- set(BOARD_TYPE "esp-box-lite")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_KEVIN_BOX_1)
- set(BOARD_TYPE "kevin-box-1")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_14_1})
- set(LVGL_ICON_FONT ${FONT_AWESOME_14_1})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_14_1})
-elseif(CONFIG_BOARD_TYPE_KEVIN_BOX_2)
- set(BOARD_TYPE "kevin-box-2")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_14_1})
- set(LVGL_ICON_FONT ${FONT_AWESOME_14_1})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_14_1})
-elseif(CONFIG_BOARD_TYPE_KEVIN_C3)
- set(BOARD_TYPE "kevin-c3")
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_S_WAKENET_ONLY})
-elseif(CONFIG_BOARD_TYPE_KEVIN_SP_V3_DEV)
- set(BOARD_TYPE "kevin-sp-v3-dev")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_KEVIN_SP_V4_DEV)
- set(BOARD_TYPE "kevin-sp-v4-dev")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_KEVIN_YUYING_313LCD)
- set(BOARD_TYPE "kevin-yuying-313lcd")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_30_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_30_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_30_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_LICHUANG_DEV)
- set(BOARD_TYPE "lichuang-dev")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_LICHUANG_C3_DEV)
- set(BOARD_TYPE "lichuang-c3-dev")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_S_PUHUI_COMMON_20_4_EMOJI_32})
-elseif(CONFIG_BOARD_TYPE_MAGICLICK_2P4)
- set(BOARD_TYPE "magiclick-2p4")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_16_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_16_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_16_4_EMOJI_32})
-elseif(CONFIG_BOARD_TYPE_MAGICLICK_2P5)
- set(BOARD_TYPE "magiclick-2p5")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_16_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_16_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_16_4_EMOJI_32})
-elseif(CONFIG_BOARD_TYPE_MAGICLICK_C3)
- set(BOARD_TYPE "magiclick-c3")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_16_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_16_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_S_PUHUI_COMMON_16_4_EMOJI_32})
-elseif(CONFIG_BOARD_TYPE_MAGICLICK_C3_V2)
- set(BOARD_TYPE "magiclick-c3-v2")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_16_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_16_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_S_PUHUI_COMMON_16_4_EMOJI_32})
-elseif(CONFIG_BOARD_TYPE_M5STACK_CORE_S3)
- set(BOARD_TYPE "m5stack-core-s3")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_M5STACK_CORE_TAB5)
- set(BOARD_TYPE "m5stack-tab5")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_30_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_30_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_30_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ATOMS3_ECHO_BASE)
- set(BOARD_TYPE "atoms3-echo-base")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_16_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_16_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_16_4_EMOJI_32})
-elseif(CONFIG_BOARD_TYPE_ATOMS3R_ECHO_BASE)
- set(BOARD_TYPE "atoms3r-echo-base")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_16_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_16_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_16_4_EMOJI_32})
-elseif(CONFIG_BOARD_TYPE_ATOMS3R_CAM_M12_ECHO_BASE)
- set(BOARD_TYPE "atoms3r-cam-m12-echo-base")
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_WAKENET_ONLY})
-elseif(CONFIG_BOARD_TYPE_ATOM_ECHOS3R)
- set(BOARD_TYPE "atom-echos3r")
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_WAKENET_ONLY})
-elseif(CONFIG_BOARD_TYPE_ATOMMATRIX_ECHO_BASE)
- set(BOARD_TYPE "atommatrix-echo-base")
-elseif(CONFIG_BOARD_TYPE_XMINI_C3_V3)
- set(BOARD_TYPE "xmini-c3-v3")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_14_1})
- set(LVGL_ICON_FONT ${FONT_AWESOME_14_1})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_S_PUHUI_COMMON_14_1})
-elseif(CONFIG_BOARD_TYPE_XMINI_C3_4G)
- set(BOARD_TYPE "xmini-c3-4g")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_14_1})
- set(LVGL_ICON_FONT ${FONT_AWESOME_14_1})
- set(DEFAULT_ASSETS ${ASSETS_PUHUI_COMMON_14_1})
-elseif(CONFIG_BOARD_TYPE_XMINI_C3)
- set(BOARD_TYPE "xmini-c3")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_14_1})
- set(LVGL_ICON_FONT ${FONT_AWESOME_14_1})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_S_PUHUI_COMMON_14_1})
-elseif(CONFIG_BOARD_TYPE_ESP32S3_KORVO2_V3)
- set(BOARD_TYPE "esp32s3-korvo2-v3")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ESP_SPARKBOT)
- set(BOARD_TYPE "esp-sparkbot")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ESP_SPOT_S3)
- set(BOARD_TYPE "esp-spot-s3")
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_WAKENET_ONLY})
-elseif(CONFIG_BOARD_TYPE_ESP_HI)
- set(BOARD_TYPE "esp-hi")
-elseif(CONFIG_BOARD_TYPE_ECHOEAR)
- set(BOARD_TYPE "echoear")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_COMMON_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
-elseif(CONFIG_BOARD_TYPE_ESP32S3_AUDIO_BOARD)
- set(BOARD_TYPE "waveshare-s3-audio-board")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_16_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_16_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_16_4_EMOJI_32})
-elseif(CONFIG_BOARD_TYPE_ESP32S3_Touch_AMOLED_1_8)
- set(BOARD_TYPE "esp32-s3-touch-amoled-1.8")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_30_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_30_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_30_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ESP32S3_Touch_AMOLED_2_06)
- set(BOARD_TYPE "waveshare-s3-touch-amoled-2.06")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_30_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_30_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_30_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ESP32S3_Touch_AMOLED_1_75)
- set(BOARD_TYPE "waveshare-s3-touch-amoled-1.75")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_30_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_30_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_30_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ESP32S3_Touch_LCD_1_85C)
- set(BOARD_TYPE "esp32-s3-touch-lcd-1.85c")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_16_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_16_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_16_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ESP32S3_Touch_LCD_1_85)
- set(BOARD_TYPE "esp32-s3-touch-lcd-1.85")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_16_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_16_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_16_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ESP32S3_Touch_LCD_1_46)
- set(BOARD_TYPE "esp32-s3-touch-lcd-1.46")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_16_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_16_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_16_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ESP32S3_Touch_LCD_3_5)
- set(BOARD_TYPE "esp32-s3-touch-lcd-3.5")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ESP32S3_Touch_LCD_3_5B)
- set(BOARD_TYPE "waveshare-s3-touch-lcd-3.5b")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_16_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_16_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_16_4_EMOJI_32})
-elseif(CONFIG_BOARD_TYPE_ESP32C6_LCD_1_69)
- set(BOARD_TYPE "waveshare-c6-lcd-1.69")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_S_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ESP32C6_Touch_AMOLED_1_43)
- set(BOARD_TYPE "waveshare-c6-touch-amoled-1.43")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_30_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_30_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_S_PUHUI_COMMON_30_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ESP32P4_NANO)
- set(BOARD_TYPE "waveshare-p4-nano")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_30_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_30_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_30_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ESP32P4_WIFI6_Touch_LCD_4B)
- set(BOARD_TYPE "waveshare-p4-wifi6-touch-lcd-4b")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_30_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_30_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_30_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ESP32P4_WIFI6_Touch_LCD_XC)
- set(BOARD_TYPE "waveshare-p4-wifi6-touch-lcd-xc")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_30_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_30_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_30_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_BREAD_COMPACT_WIFI_LCD)
- set(BOARD_TYPE "bread-compact-wifi-lcd")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_16_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_16_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_16_4_EMOJI_32})
-elseif(CONFIG_BOARD_TYPE_TUDOUZI)
- set(BOARD_TYPE "tudouzi")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_14_1})
- set(LVGL_ICON_FONT ${FONT_AWESOME_14_1})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_14_1})
-elseif(CONFIG_BOARD_TYPE_LILYGO_T_CIRCLE_S3)
- set(BOARD_TYPE "lilygo-t-circle-s3")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_16_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_16_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_16_4_EMOJI_32})
-elseif(CONFIG_BOARD_TYPE_LILYGO_T_CAMERAPLUS_S3_V1_0_V1_1)
- set(BOARD_TYPE "lilygo-t-cameraplus-s3")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_LILYGO_T_DISPLAY_S3_PRO_MVSRLORA)
- set(BOARD_TYPE "lilygo-t-display-s3-pro-mvsrlora")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_MOVECALL_MOJI_ESP32S3)
- set(BOARD_TYPE "movecall-moji-esp32s3")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_MOVECALL_CUICAN_ESP32S3)
- set(BOARD_TYPE "movecall-cuican-esp32s3")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ATK_DNESP32S3)
- set(BOARD_TYPE "atk-dnesp32s3")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ATK_DNESP32S3_BOX)
- set(BOARD_TYPE "atk-dnesp32s3-box")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ATK_DNESP32S3_BOX0)
- set(BOARD_TYPE "atk-dnesp32s3-box0")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ATK_DNESP32S3_BOX2_WIFI)
- set(BOARD_TYPE "atk-dnesp32s3-box2-wifi")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ATK_DNESP32S3_BOX2_4G)
- set(BOARD_TYPE "atk-dnesp32s3-box2-4g")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ATK_DNESP32S3M_WIFI)
- set(BOARD_TYPE "atk-dnesp32s3m-wifi")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_16_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_16_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_16_4_EMOJI_32})
-elseif(CONFIG_BOARD_TYPE_ATK_DNESP32S3M_4G)
- set(BOARD_TYPE "atk-dnesp32s3m-4g")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_16_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_16_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_16_4_EMOJI_32})
-elseif(CONFIG_BOARD_TYPE_DU_CHATX)
- set(BOARD_TYPE "du-chatx")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_16_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_16_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_16_4_EMOJI_32})
-elseif(CONFIG_BOARD_TYPE_ESP32S3_Taiji_Pi)
- set(BOARD_TYPE "taiji-pi-s3")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_XINGZHI_Cube_0_85TFT_WIFI)
- set(BOARD_TYPE "xingzhi-cube-0.85tft-wifi")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_16_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_16_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_16_4_EMOJI_32})
-elseif(CONFIG_BOARD_TYPE_XINGZHI_Cube_0_85TFT_ML307)
- set(BOARD_TYPE "xingzhi-cube-0.85tft-ml307")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_16_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_16_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_16_4_EMOJI_32})
-elseif(CONFIG_BOARD_TYPE_XINGZHI_Cube_0_96OLED_WIFI)
- set(BOARD_TYPE "xingzhi-cube-0.96oled-wifi")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_14_1})
- set(LVGL_ICON_FONT ${FONT_AWESOME_14_1})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_14_1})
-elseif(CONFIG_BOARD_TYPE_XINGZHI_Cube_0_96OLED_ML307)
- set(BOARD_TYPE "xingzhi-cube-0.96oled-ml307")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_14_1})
- set(LVGL_ICON_FONT ${FONT_AWESOME_14_1})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_14_1})
-elseif(CONFIG_BOARD_TYPE_XINGZHI_Cube_1_54TFT_WIFI)
- set(BOARD_TYPE "xingzhi-cube-1.54tft-wifi")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_XINGZHI_Cube_1_54TFT_ML307)
- set(BOARD_TYPE "xingzhi-cube-1.54tft-ml307")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_SENSECAP_WATCHER)
- set(BOARD_TYPE "sensecap-watcher")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_30_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_30_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_DOIT_S3_AIBOX)
- set(BOARD_TYPE "doit-s3-aibox")
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_WAKENET_ONLY})
-elseif(CONFIG_BOARD_TYPE_MIXGO_NOVA)
- set(BOARD_TYPE "mixgo-nova")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_16_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_16_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_16_4_EMOJI_32})
-elseif(CONFIG_BOARD_TYPE_GENJUTECH_S3_1_54TFT)
- set(BOARD_TYPE "genjutech-s3-1.54tft")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ESP32_CGC)
- set(BOARD_TYPE "esp32-cgc")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_COMMON_14_1})
- set(LVGL_ICON_FONT ${FONT_AWESOME_14_1})
-elseif(CONFIG_BOARD_TYPE_ESP32_CGC_144)
- set(BOARD_TYPE "esp32-cgc-144")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_COMMON_14_1})
- set(LVGL_ICON_FONT ${FONT_AWESOME_14_1})
-elseif(CONFIG_BOARD_TYPE_ESP_S3_LCD_EV_Board)
- set(BOARD_TYPE "esp-s3-lcd-ev-board")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_30_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_30_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_30_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ESP_S3_LCD_EV_Board_2)
- set(BOARD_TYPE "esp-s3-lcd-ev-board-2")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_30_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_30_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_30_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ZHENGCHEN_1_54TFT_WIFI)
- set(BOARD_TYPE "zhengchen-1.54tft-wifi")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_MINSI_K08_DUAL)
- set(BOARD_TYPE "minsi-k08-dual")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ZHENGCHEN_1_54TFT_ML307)
- set(BOARD_TYPE "zhengchen-1.54tft-ml307")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_ESP32_S3_1_54_MUMA)
- set(BOARD_TYPE "sp-esp32-s3-1.54-muma")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_16_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_16_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_16_4_EMOJI_32})
-elseif(CONFIG_BOARD_TYPE_ESP32_S3_1_28_BOX)
- set(BOARD_TYPE "sp-esp32-s3-1.28-box")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_16_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_16_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_16_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_OTTO_ROBOT)
- set(BOARD_TYPE "otto-robot")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_COMMON_16_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_16_4})
-elseif(CONFIG_BOARD_TYPE_ELECTRON_BOT)
- set(BOARD_TYPE "electron-bot")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_COMMON_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
-elseif(CONFIG_BOARD_TYPE_BREAD_COMPACT_WIFI_CAM)
- set(BOARD_TYPE "bread-compact-wifi-s3cam")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_16_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_16_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_16_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_JIUCHUAN)
- set(BOARD_TYPE "jiuchuan-s3")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_LABPLUS_MPYTHON_V3)
- set(BOARD_TYPE "labplus-mpython-v3")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_LABPLUS_LEDONG_V2)
- set(BOARD_TYPE "labplus-ledong-v2")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
-elseif(CONFIG_BOARD_TYPE_SURFER_C3_1_14TFT)
- set(BOARD_TYPE "surfer-c3-1.14tft")
- set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
- set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_S_PUHUI_COMMON_20_4_EMOJI_32})
-elseif(CONFIG_BOARD_TYPE_ESP32S3_SMART_SPEAKER)
- set(BOARD_TYPE "esp32s3-smart-speaker")
- set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_WAKENET_ONLY})
-endif()
-
-file(GLOB BOARD_SOURCES
- ${CMAKE_CURRENT_SOURCE_DIR}/boards/${BOARD_TYPE}/*.cc
- ${CMAKE_CURRENT_SOURCE_DIR}/boards/${BOARD_TYPE}/*.c
-)
-list(APPEND SOURCES ${BOARD_SOURCES})
-
-# Select audio processor according to Kconfig
-if(CONFIG_USE_AUDIO_PROCESSOR)
- list(APPEND SOURCES "audio/processors/afe_audio_processor.cc")
-else()
- list(APPEND SOURCES "audio/processors/no_audio_processor.cc")
-endif()
-if(CONFIG_USE_AFE_WAKE_WORD)
- list(APPEND SOURCES "audio/wake_words/afe_wake_word.cc")
-elseif(CONFIG_USE_ESP_WAKE_WORD)
- list(APPEND SOURCES "audio/wake_words/esp_wake_word.cc")
-elseif(CONFIG_USE_CUSTOM_WAKE_WORD)
- list(APPEND SOURCES "audio/wake_words/custom_wake_word.cc")
-endif()
-
-# Select language directory according to Kconfig
-if(CONFIG_LANGUAGE_ZH_CN)
- set(LANG_DIR "zh-CN")
-elseif(CONFIG_LANGUAGE_ZH_TW)
- set(LANG_DIR "zh-TW")
-elseif(CONFIG_LANGUAGE_EN_US)
- set(LANG_DIR "en-US")
-elseif(CONFIG_LANGUAGE_JA_JP)
- set(LANG_DIR "ja-JP")
-elseif(CONFIG_LANGUAGE_KO_KR)
- set(LANG_DIR "ko-KR")
-elseif(CONFIG_LANGUAGE_VI_VN)
- set(LANG_DIR "vi-VN")
-elseif(CONFIG_LANGUAGE_TH_TH)
- set(LANG_DIR "th-TH")
-elseif(CONFIG_LANGUAGE_DE_DE)
- set(LANG_DIR "de-DE")
-elseif(CONFIG_LANGUAGE_FR_FR)
- set(LANG_DIR "fr-FR")
-elseif(CONFIG_LANGUAGE_ES_ES)
- set(LANG_DIR "es-ES")
-elseif(CONFIG_LANGUAGE_IT_IT)
- set(LANG_DIR "it-IT")
-elseif(CONFIG_LANGUAGE_RU_RU)
- set(LANG_DIR "ru-RU")
-elseif(CONFIG_LANGUAGE_AR_SA)
- set(LANG_DIR "ar-SA")
-elseif(CONFIG_LANGUAGE_HI_IN)
- set(LANG_DIR "hi-IN")
-elseif(CONFIG_LANGUAGE_PT_PT)
- set(LANG_DIR "pt-PT")
-elseif(CONFIG_LANGUAGE_PL_PL)
- set(LANG_DIR "pl-PL")
-elseif(CONFIG_LANGUAGE_CS_CZ)
- set(LANG_DIR "cs-CZ")
-elseif(CONFIG_LANGUAGE_FI_FI)
- set(LANG_DIR "fi-FI")
-elseif(CONFIG_LANGUAGE_TR_TR)
- set(LANG_DIR "tr-TR")
-elseif(CONFIG_LANGUAGE_ID_ID)
- set(LANG_DIR "id-ID")
-elseif(CONFIG_LANGUAGE_UK_UA)
- set(LANG_DIR "uk-UA")
-elseif(CONFIG_LANGUAGE_RO_RO)
- set(LANG_DIR "ro-RO")
-endif()
-
-# Define generation path
-set(LANG_JSON "${CMAKE_CURRENT_SOURCE_DIR}/assets/locales/${LANG_DIR}/language.json")
-set(LANG_HEADER "${CMAKE_CURRENT_SOURCE_DIR}/assets/lang_config.h")
-file(GLOB LANG_SOUNDS ${CMAKE_CURRENT_SOURCE_DIR}/assets/locales/${LANG_DIR}/*.ogg)
-file(GLOB COMMON_SOUNDS ${CMAKE_CURRENT_SOURCE_DIR}/assets/common/*.ogg)
-
-# If target chip is ESP32, exclude specific files to avoid build errors
-if(CONFIG_IDF_TARGET_ESP32)
- list(REMOVE_ITEM SOURCES "audio/codecs/box_audio_codec.cc"
- "audio/codecs/es8388_audio_codec.cc"
- "audio/codecs/es8389_audio_codec.cc"
- "led/gpio_led.cc"
- )
-endif()
-
-idf_component_register(SRCS ${SOURCES}
- EMBED_FILES ${LANG_SOUNDS} ${COMMON_SOUNDS}
- INCLUDE_DIRS ${INCLUDE_DIRS}
- WHOLE_ARCHIVE
- )
-
-# Use target_compile_definitions to define BOARD_TYPE, BOARD_NAME
-# If BOARD_NAME is empty, use BOARD_TYPE
-if(NOT BOARD_NAME)
- set(BOARD_NAME ${BOARD_TYPE})
-endif()
-target_compile_definitions(${COMPONENT_LIB}
- PRIVATE BOARD_TYPE=\"${BOARD_TYPE}\" BOARD_NAME=\"${BOARD_NAME}\"
- PRIVATE DEFAULT_ASSETS=\"${DEFAULT_ASSETS}\" LVGL_TEXT_FONT=${LVGL_TEXT_FONT} LVGL_ICON_FONT=${LVGL_ICON_FONT}
- )
-
-# Add generation rules
-add_custom_command(
- OUTPUT ${LANG_HEADER}
- COMMAND python ${PROJECT_DIR}/scripts/gen_lang.py
- --language "${LANG_DIR}"
- --output "${LANG_HEADER}"
- DEPENDS
- ${LANG_JSON}
- ${PROJECT_DIR}/scripts/gen_lang.py
- COMMENT "Generating ${LANG_DIR} language config"
-)
-
-# Force build generation dependencies
-add_custom_target(lang_header ALL
- DEPENDS ${LANG_HEADER}
-)
-
-if(CONFIG_BOARD_TYPE_ESP_HI)
-set(URL "https://github.com/espressif2022/image_player/raw/main/test_apps/test_8bit")
-set(SPIFFS_DIR "${CMAKE_BINARY_DIR}/emoji")
-file(MAKE_DIRECTORY ${SPIFFS_DIR})
-
-# List all files to download
-set(FILES_TO_DOWNLOAD "")
-list(APPEND FILES_TO_DOWNLOAD "Anger_enter.aaf" "Anger_loop.aaf" "Anger_return.aaf")
-list(APPEND FILES_TO_DOWNLOAD "happy_enter.aaf" "happy_loop.aaf" "happ_return.aaf")
-list(APPEND FILES_TO_DOWNLOAD "sad_enter.aaf" "sad_loop.aaf" "sad_return.aaf")
-list(APPEND FILES_TO_DOWNLOAD "scorn_enter.aaf" "scorn_loop.aaf" "scorn_return.aaf")
-list(APPEND FILES_TO_DOWNLOAD "left_enter.aaf" "left_loop.aaf" "left_return.aaf")
-list(APPEND FILES_TO_DOWNLOAD "right_enter.aaf" "right_loop.aaf" "right_return.aaf")
-list(APPEND FILES_TO_DOWNLOAD "asking.aaf" "blink_once.aaf" "blink_quick.aaf")
-list(APPEND FILES_TO_DOWNLOAD "connecting.aaf" "panic_enter.aaf" "panic_loop.aaf")
-list(APPEND FILES_TO_DOWNLOAD "panic_return.aaf" "wake.aaf")
-
-foreach(FILENAME IN LISTS FILES_TO_DOWNLOAD)
- set(REMOTE_FILE "${URL}/${FILENAME}")
- set(LOCAL_FILE "${SPIFFS_DIR}/${FILENAME}")
-
- # Check if local file exists
- if(EXISTS ${LOCAL_FILE})
- message(STATUS "File ${FILENAME} already exists, skipping download")
- else()
- message(STATUS "Downloading ${FILENAME}")
- file(DOWNLOAD ${REMOTE_FILE} ${LOCAL_FILE}
- STATUS DOWNLOAD_STATUS)
- list(GET DOWNLOAD_STATUS 0 STATUS_CODE)
- if(NOT STATUS_CODE EQUAL 0)
- message(FATAL_ERROR "Failed to download ${FILENAME} from ${URL}")
- endif()
- endif()
-endforeach()
-
-spiffs_create_partition_assets(
- assets_A
- ${SPIFFS_DIR}
- FLASH_IN_PROJECT
- MMAP_FILE_SUPPORT_FORMAT ".aaf"
-)
-endif()
-
-if(CONFIG_BOARD_TYPE_ECHOEAR)
-
-idf_build_get_property(build_components BUILD_COMPONENTS)
-foreach(COMPONENT ${build_components})
- if(COMPONENT MATCHES "esp_emote_gfx" OR COMPONENT MATCHES "espressif2022__esp_emote_gfx")
- set(EMOTE_GFX_COMPONENT ${COMPONENT})
- idf_component_get_property(EMOTE_GFX_COMPONENT_PATH ${EMOTE_GFX_COMPONENT} COMPONENT_DIR)
- set(SPIFFS_DIR "${EMOTE_GFX_COMPONENT_PATH}/emoji_normal")
- break()
- endif()
-endforeach()
-
-spiffs_create_partition_assets(
- assets_A
- ${SPIFFS_DIR}
- FLASH_IN_PROJECT
- MMAP_FILE_SUPPORT_FORMAT ".aaf, ttf, bin"
- IMPORT_INC_PATH ${CMAKE_CURRENT_SOURCE_DIR}/boards/${BOARD_TYPE}
-)
-endif()
-
-# Font configuration validation function
-function(validate_font_config board_name text_font default_assets)
- if(text_font)
- # Check if DEFAULT_ASSETS contains font
- if(default_assets AND default_assets MATCHES "font_")
- # Rule 1: If DEFAULT_ASSETS uses font, LVGL_TEXT_FONT must be BASIC
- if(NOT text_font MATCHES "basic")
- message(FATAL_ERROR "Font config error for ${board_name}: DEFAULT_ASSETS contains COMMON font but LVGL_TEXT_FONT is not BASIC (${text_font})")
- endif()
- else()
- # Rule 2: If no DEFAULT_ASSETS or DEFAULT_ASSETS doesn't contain font_, LVGL_TEXT_FONT must not be BASIC
- if(text_font MATCHES "basic")
- message(FATAL_ERROR "Font config error for ${board_name}: No DEFAULT_ASSETS with COMMON font but LVGL_TEXT_FONT is not COMMON (${text_font})")
- endif()
- endif()
- # Pass validation
- message(STATUS "Font config validation passed for ${board_name}: LVGL_TEXT_FONT=${text_font}, DEFAULT_ASSETS=${default_assets}")
- endif()
-endfunction()
-
-# DEFAULT_ASSETS prefix validation function
-function(validate_default_assets_prefix board_name default_assets)
- if(default_assets)
- # Check for ESP32S3/P4 target - DEFAULT_ASSETS cannot start with "wn9s_"
- if(CONFIG_IDF_TARGET_ESP32S3 OR CONFIG_IDF_TARGET_ESP32P4)
- if(default_assets MATCHES "^wn9s_")
- message(FATAL_ERROR "Assets config error for ${board_name}: DEFAULT_ASSETS cannot start with 'wn9s_' for ESP32S3 target (${default_assets})")
- endif()
- endif()
-
- # Check for ESP32C3/C6 target - DEFAULT_ASSETS cannot start with "wn9_"
- if(CONFIG_IDF_TARGET_ESP32C3 OR CONFIG_IDF_TARGET_ESP32C6)
- if(default_assets MATCHES "^wn9_")
- message(FATAL_ERROR "Assets config error for ${board_name}: DEFAULT_ASSETS cannot start with 'wn9_' for ESP32C3/C6 target (${default_assets})")
- endif()
- endif()
-
- # Pass validation
- message(STATUS "Assets prefix validation passed for ${board_name}: DEFAULT_ASSETS=${default_assets}")
- endif()
-endfunction()
-
-# Global font configuration validation
-# This will validate the current board's font configuration
-if(LVGL_TEXT_FONT)
- validate_font_config("${BOARD_TYPE}" "${LVGL_TEXT_FONT}" "${DEFAULT_ASSETS}")
-endif()
-
-# Global DEFAULT_ASSETS prefix validation
-# This will validate the current board's DEFAULT_ASSETS prefix configuration
-if(DEFAULT_ASSETS)
- validate_default_assets_prefix("${BOARD_TYPE}" "${DEFAULT_ASSETS}")
-endif()
-
-# Function to get local assets file path (handles both URL and local file)
-function(get_assets_local_file assets_source assets_local_file_var)
- # Check if it's a URL (starts with http:// or https://)
- if(assets_source MATCHES "^https?://")
- # It's a URL, download it
- get_filename_component(ASSETS_FILENAME "${assets_source}" NAME)
- set(ASSETS_LOCAL_FILE "${CMAKE_BINARY_DIR}/${ASSETS_FILENAME}")
- set(ASSETS_TEMP_FILE "${CMAKE_BINARY_DIR}/${ASSETS_FILENAME}.tmp")
-
- # Check if local file exists
- if(EXISTS ${ASSETS_LOCAL_FILE})
- message(STATUS "Assets file ${ASSETS_FILENAME} already exists, skipping download")
- else()
- message(STATUS "Downloading ${ASSETS_FILENAME}")
-
- # Clean up any existing temp file
- if(EXISTS ${ASSETS_TEMP_FILE})
- file(REMOVE ${ASSETS_TEMP_FILE})
- endif()
-
- # Download to temporary file first
- file(DOWNLOAD ${assets_source} ${ASSETS_TEMP_FILE}
- STATUS DOWNLOAD_STATUS)
- list(GET DOWNLOAD_STATUS 0 STATUS_CODE)
- if(NOT STATUS_CODE EQUAL 0)
- # Clean up temp file on failure
- if(EXISTS ${ASSETS_TEMP_FILE})
- file(REMOVE ${ASSETS_TEMP_FILE})
- endif()
- message(FATAL_ERROR "Failed to download ${ASSETS_FILENAME} from ${assets_source}")
- endif()
-
- # Move temp file to final location (atomic operation)
- file(RENAME ${ASSETS_TEMP_FILE} ${ASSETS_LOCAL_FILE})
- message(STATUS "Successfully downloaded ${ASSETS_FILENAME}")
- endif()
- else()
- # It's a local file path
- if(IS_ABSOLUTE "${assets_source}")
- set(ASSETS_LOCAL_FILE "${assets_source}")
- else()
- set(ASSETS_LOCAL_FILE "${CMAKE_CURRENT_SOURCE_DIR}/${assets_source}")
- endif()
-
- # Check if local file exists
- if(NOT EXISTS ${ASSETS_LOCAL_FILE})
- message(FATAL_ERROR "Assets file not found: ${ASSETS_LOCAL_FILE}")
- endif()
-
- message(STATUS "Using assets file: ${ASSETS_LOCAL_FILE}")
- endif()
-
- set(${assets_local_file_var} ${ASSETS_LOCAL_FILE} PARENT_SCOPE)
-endfunction()
-
-# Flash assets based on configuration
-if(CONFIG_FLASH_DEFAULT_ASSETS)
- # Flash default assets
- if(DEFAULT_ASSETS)
- get_assets_local_file("${DEFAULT_ASSETS}" ASSETS_LOCAL_FILE)
- esptool_py_flash_to_partition(flash "assets" "${ASSETS_LOCAL_FILE}")
- message(STATUS "Default assets download and flash configured: ${DEFAULT_ASSETS} -> assets partition")
- else()
- message(WARNING "FLASH_DEFAULT_ASSETS is enabled but no DEFAULT_ASSETS is defined for board ${BOARD_TYPE}")
- endif()
-elseif(CONFIG_FLASH_CUSTOM_ASSETS)
- # Flash custom assets
- get_assets_local_file("${CONFIG_CUSTOM_ASSETS_FILE}" ASSETS_LOCAL_FILE)
- esptool_py_flash_to_partition(flash "assets" "${ASSETS_LOCAL_FILE}")
- message(STATUS "Custom assets flash configured: ${ASSETS_LOCAL_FILE} -> assets partition")
-elseif(CONFIG_FLASH_NONE_ASSETS)
- message(STATUS "Assets flashing disabled (FLASH_NONE_ASSETS)")
-endif()
\ No newline at end of file
+# Define source files
+set(SOURCES "audio/audio_codec.cc"
+ "audio/audio_service.cc"
+ "audio/codecs/no_audio_codec.cc"
+ "audio/codecs/box_audio_codec.cc"
+ "audio/codecs/es8311_audio_codec.cc"
+ "audio/codecs/es8374_audio_codec.cc"
+ "audio/codecs/es8388_audio_codec.cc"
+ "audio/codecs/es8389_audio_codec.cc"
+ "audio/codecs/dummy_audio_codec.cc"
+ "audio/processors/audio_debugger.cc"
+ "led/single_led.cc"
+ "led/circular_strip.cc"
+ "led/gpio_led.cc"
+ "display/display.cc"
+ "display/lcd_display.cc"
+ "display/oled_display.cc"
+ "display/lvgl_display/lvgl_display.cc"
+ "display/emote_display.cc"
+ "display/lvgl_display/emoji_collection.cc"
+ "display/lvgl_display/lvgl_theme.cc"
+ "display/lvgl_display/lvgl_font.cc"
+ "display/lvgl_display/lvgl_image.cc"
+ "display/lvgl_display/gif/lvgl_gif.cc"
+ "display/lvgl_display/gif/gifdec.c"
+ "display/lvgl_display/jpg/image_to_jpeg.cpp"
+ "display/lvgl_display/jpg/jpeg_encoder.cpp"
+ "protocols/protocol.cc"
+ "protocols/mqtt_protocol.cc"
+ "protocols/websocket_protocol.cc"
+ "mcp_server.cc"
+ "system_info.cc"
+ "application.cc"
+ "alarm_manager.cc"
+ "ota.cc"
+ "settings.cc"
+ "device_state_event.cc"
+ "device_manager.cc"
+ "assets.cc"
+ "main.cc"
+ )
+
+set(INCLUDE_DIRS "." "display" "display/lvgl_display" "display/lvgl_display/jpg" "audio" "protocols")
+
+# Add board common files
+file(GLOB BOARD_COMMON_SOURCES ${CMAKE_CURRENT_SOURCE_DIR}/boards/common/*.cc)
+list(APPEND SOURCES ${BOARD_COMMON_SOURCES})
+list(APPEND INCLUDE_DIRS ${CMAKE_CURRENT_SOURCE_DIR}/boards/common)
+
+idf_build_get_property(build_components BUILD_COMPONENTS)
+# Function to find component dynamically by pattern
+function(find_component_by_pattern PATTERN COMPONENT_VAR PATH_VAR)
+ foreach(COMPONENT ${build_components})
+ if(COMPONENT MATCHES "${PATTERN}")
+ set(${COMPONENT_VAR} ${COMPONENT} PARENT_SCOPE)
+ idf_component_get_property(COMPONENT_PATH ${COMPONENT} COMPONENT_DIR)
+ set(${PATH_VAR} "${COMPONENT_PATH}" PARENT_SCOPE)
+ break()
+ endif()
+ endforeach()
+endfunction()
+
+# Set default BUILTIN_TEXT_FONT and BUILTIN_ICON_FONT
+set(BUILTIN_TEXT_FONT font_puhui_14_1)
+set(BUILTIN_ICON_FONT font_awesome_14_1)
+
+# Add board files according to BOARD_TYPE
+# Set default assets if the board uses partition table V2
+if(CONFIG_BOARD_TYPE_BREAD_COMPACT_WIFI)
+ set(BOARD_TYPE "bread-compact-wifi")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_14_1)
+ set(BUILTIN_ICON_FONT font_awesome_14_1)
+elseif(CONFIG_BOARD_TYPE_BREAD_COMPACT_ML307)
+ set(BOARD_TYPE "bread-compact-ml307")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_14_1)
+ set(BUILTIN_ICON_FONT font_awesome_14_1)
+elseif(CONFIG_BOARD_TYPE_BREAD_COMPACT_ESP32)
+ set(BOARD_TYPE "bread-compact-esp32")
+elseif(CONFIG_BOARD_TYPE_BREAD_COMPACT_ESP32_LCD)
+ set(BOARD_TYPE "bread-compact-esp32-lcd")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_14_1)
+ set(BUILTIN_ICON_FONT font_awesome_14_1)
+elseif(CONFIG_BOARD_TYPE_DF_K10)
+ set(BOARD_TYPE "df-k10")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_DF_S3_AI_CAM)
+ set(BOARD_TYPE "df-s3-ai-cam")
+elseif(CONFIG_BOARD_TYPE_ESP_BOX_3)
+ set(BOARD_TYPE "esp-box-3")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ESP_BOX)
+ set(BOARD_TYPE "esp-box")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ESP_BOX_LITE)
+ set(BOARD_TYPE "esp-box-lite")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_KEVIN_BOX_1)
+ set(BOARD_TYPE "kevin-box-1")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_14_1)
+ set(BUILTIN_ICON_FONT font_awesome_14_1)
+elseif(CONFIG_BOARD_TYPE_KEVIN_BOX_2)
+ set(BOARD_TYPE "kevin-box-2")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_14_1)
+ set(BUILTIN_ICON_FONT font_awesome_14_1)
+elseif(CONFIG_BOARD_TYPE_KEVIN_C3)
+ set(BOARD_TYPE "kevin-c3")
+elseif(CONFIG_BOARD_TYPE_KEVIN_SP_V3_DEV)
+ set(BOARD_TYPE "kevin-sp-v3-dev")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_KEVIN_SP_V4_DEV)
+ set(BOARD_TYPE "kevin-sp-v4-dev")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_KEVIN_YUYING_313LCD)
+ set(BOARD_TYPE "kevin-yuying-313lcd")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_30_4)
+ set(BUILTIN_ICON_FONT font_awesome_30_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_LICHUANG_DEV)
+ set(BOARD_TYPE "lichuang-dev")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_LICHUANG_C3_DEV)
+ set(BOARD_TYPE "lichuang-c3-dev")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_32)
+elseif(CONFIG_BOARD_TYPE_MAGICLICK_2P4)
+ set(BOARD_TYPE "magiclick-2p4")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_16_4)
+ set(BUILTIN_ICON_FONT font_awesome_16_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_32)
+elseif(CONFIG_BOARD_TYPE_MAGICLICK_2P5)
+ set(BOARD_TYPE "magiclick-2p5")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_16_4)
+ set(BUILTIN_ICON_FONT font_awesome_16_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_32)
+elseif(CONFIG_BOARD_TYPE_MAGICLICK_C3)
+ set(BOARD_TYPE "magiclick-c3")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_16_4)
+ set(BUILTIN_ICON_FONT font_awesome_16_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_32)
+elseif(CONFIG_BOARD_TYPE_MAGICLICK_C3_V2)
+ set(BOARD_TYPE "magiclick-c3-v2")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_16_4)
+ set(BUILTIN_ICON_FONT font_awesome_16_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_32)
+elseif(CONFIG_BOARD_TYPE_M5STACK_CORE_S3)
+ set(BOARD_TYPE "m5stack-core-s3")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_M5STACK_CORE_TAB5)
+ set(BOARD_TYPE "m5stack-tab5")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_30_4)
+ set(BUILTIN_ICON_FONT font_awesome_30_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ATOMS3_ECHO_BASE)
+ set(BOARD_TYPE "atoms3-echo-base")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_16_4)
+ set(BUILTIN_ICON_FONT font_awesome_16_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_32)
+elseif(CONFIG_BOARD_TYPE_ATOMS3R_ECHO_BASE)
+ set(BOARD_TYPE "atoms3r-echo-base")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_16_4)
+ set(BUILTIN_ICON_FONT font_awesome_16_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_32)
+elseif(CONFIG_BOARD_TYPE_ATOMS3R_CAM_M12_ECHO_BASE)
+ set(BOARD_TYPE "atoms3r-cam-m12-echo-base")
+elseif(CONFIG_BOARD_TYPE_ATOM_ECHOS3R)
+ set(BOARD_TYPE "atom-echos3r")
+elseif(CONFIG_BOARD_TYPE_ATOMMATRIX_ECHO_BASE)
+ set(BOARD_TYPE "atommatrix-echo-base")
+elseif(CONFIG_BOARD_TYPE_XMINI_C3_V3)
+ set(BOARD_TYPE "xmini-c3-v3")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_14_1)
+ set(BUILTIN_ICON_FONT font_awesome_14_1)
+elseif(CONFIG_BOARD_TYPE_XMINI_C3_4G)
+ set(BOARD_TYPE "xmini-c3-4g")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_14_1)
+ set(BUILTIN_ICON_FONT font_awesome_14_1)
+elseif(CONFIG_BOARD_TYPE_XMINI_C3)
+ set(BOARD_TYPE "xmini-c3")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_14_1)
+ set(BUILTIN_ICON_FONT font_awesome_14_1)
+elseif(CONFIG_BOARD_TYPE_ESP32S3_KORVO2_V3)
+ set(BOARD_TYPE "esp32s3-korvo2-v3")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ESP_SPARKBOT)
+ set(BOARD_TYPE "esp-sparkbot")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ESP_SPOT_S3)
+ set(BOARD_TYPE "esp-spot-s3")
+elseif(CONFIG_BOARD_TYPE_ESP_HI)
+ set(BOARD_TYPE "esp-hi")
+ # Set ESP_HI emoji directory for DEFAULT_ASSETS_EXTRA_FILES
+ set(DEFAULT_ASSETS_EXTRA_FILES "${CMAKE_BINARY_DIR}/emoji")
+elseif(CONFIG_BOARD_TYPE_ECHOEAR)
+ set(BOARD_TYPE "echoear")
+ set(BUILTIN_TEXT_FONT font_puhui_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ESP32S3_AUDIO_BOARD)
+ set(BOARD_TYPE "waveshare-s3-audio-board")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_16_4)
+ set(BUILTIN_ICON_FONT font_awesome_16_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_32)
+elseif(CONFIG_BOARD_TYPE_ESP32S3_Touch_AMOLED_1_8)
+ set(BOARD_TYPE "esp32-s3-touch-amoled-1.8")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_30_4)
+ set(BUILTIN_ICON_FONT font_awesome_30_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ESP32S3_Touch_AMOLED_2_06)
+ set(BOARD_TYPE "waveshare-s3-touch-amoled-2.06")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_30_4)
+ set(BUILTIN_ICON_FONT font_awesome_30_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ESP32S3_Touch_LCD_4B)
+ set(BOARD_TYPE "waveshare-s3-touch-lcd-4b")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_30_4)
+ set(BUILTIN_ICON_FONT font_awesome_30_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ESP32S3_Touch_AMOLED_1_75)
+ set(BOARD_TYPE "waveshare-s3-touch-amoled-1.75")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_30_4)
+ set(BUILTIN_ICON_FONT font_awesome_30_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ESP32S3_Touch_LCD_1_85C)
+ set(BOARD_TYPE "esp32-s3-touch-lcd-1.85c")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_16_4)
+ set(BUILTIN_ICON_FONT font_awesome_16_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ESP32S3_Touch_LCD_1_85)
+ set(BOARD_TYPE "esp32-s3-touch-lcd-1.85")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_16_4)
+ set(BUILTIN_ICON_FONT font_awesome_16_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ESP32S3_Touch_LCD_1_46)
+ set(BOARD_TYPE "esp32-s3-touch-lcd-1.46")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_16_4)
+ set(BUILTIN_ICON_FONT font_awesome_16_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ESP32S3_Touch_LCD_3_5)
+ set(BOARD_TYPE "esp32-s3-touch-lcd-3.5")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ESP32S3_Touch_LCD_3_5B)
+ set(BOARD_TYPE "waveshare-s3-touch-lcd-3.5b")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_16_4)
+ set(BUILTIN_ICON_FONT font_awesome_16_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_32)
+elseif(CONFIG_BOARD_TYPE_ESP32S3_Touch_LCD_3_49)
+ set(BOARD_TYPE "waveshare-s3-touch-lcd-3.49")
+ set(LVGL_TEXT_FONT font_puhui_basic_30_4)
+ set(LVGL_ICON_FONT font_awesome_30_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ESP32C6_LCD_1_69)
+ set(BOARD_TYPE "waveshare-c6-lcd-1.69")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ESP32C6_Touch_AMOLED_1_43)
+ set(BOARD_TYPE "waveshare-c6-touch-amoled-1.43")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_30_4)
+ set(BUILTIN_ICON_FONT font_awesome_30_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ESP32P4_NANO)
+ set(BOARD_TYPE "waveshare-p4-nano")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_30_4)
+ set(BUILTIN_ICON_FONT font_awesome_30_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ESP32P4_WIFI6_Touch_LCD_4B)
+ set(BOARD_TYPE "waveshare-p4-wifi6-touch-lcd-4b")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_30_4)
+ set(BUILTIN_ICON_FONT font_awesome_30_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ESP32P4_WIFI6_Touch_LCD_XC)
+ set(BOARD_TYPE "waveshare-p4-wifi6-touch-lcd-xc")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_30_4)
+ set(BUILTIN_ICON_FONT font_awesome_30_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_BREAD_COMPACT_WIFI_LCD)
+ set(BOARD_TYPE "bread-compact-wifi-lcd")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_16_4)
+ set(BUILTIN_ICON_FONT font_awesome_16_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_32)
+elseif(CONFIG_BOARD_TYPE_TUDOUZI)
+ set(BOARD_TYPE "tudouzi")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_14_1)
+ set(BUILTIN_ICON_FONT font_awesome_14_1)
+elseif(CONFIG_BOARD_TYPE_LILYGO_T_CIRCLE_S3)
+ set(BOARD_TYPE "lilygo-t-circle-s3")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_16_4)
+ set(BUILTIN_ICON_FONT font_awesome_16_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_32)
+elseif(CONFIG_BOARD_TYPE_LILYGO_T_CAMERAPLUS_S3_V1_0_V1_1)
+ set(BOARD_TYPE "lilygo-t-cameraplus-s3")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_LILYGO_T_DISPLAY_S3_PRO_MVSRLORA)
+ set(BOARD_TYPE "lilygo-t-display-s3-pro-mvsrlora")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_MOVECALL_MOJI_ESP32S3)
+ set(BOARD_TYPE "movecall-moji-esp32s3")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_MOVECALL_CUICAN_ESP32S3)
+ set(BOARD_TYPE "movecall-cuican-esp32s3")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ATK_DNESP32S3)
+ set(BOARD_TYPE "atk-dnesp32s3")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ATK_DNESP32S3_BOX)
+ set(BOARD_TYPE "atk-dnesp32s3-box")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ATK_DNESP32S3_BOX0)
+ set(BOARD_TYPE "atk-dnesp32s3-box0")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ATK_DNESP32S3_BOX2_WIFI)
+ set(BOARD_TYPE "atk-dnesp32s3-box2-wifi")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ATK_DNESP32S3_BOX2_4G)
+ set(BOARD_TYPE "atk-dnesp32s3-box2-4g")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ATK_DNESP32S3M_WIFI)
+ set(BOARD_TYPE "atk-dnesp32s3m-wifi")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_16_4)
+ set(BUILTIN_ICON_FONT font_awesome_16_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_32)
+elseif(CONFIG_BOARD_TYPE_ATK_DNESP32S3M_4G)
+ set(BOARD_TYPE "atk-dnesp32s3m-4g")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_16_4)
+ set(BUILTIN_ICON_FONT font_awesome_16_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_32)
+elseif(CONFIG_BOARD_TYPE_DU_CHATX)
+ set(BOARD_TYPE "du-chatx")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_16_4)
+ set(BUILTIN_ICON_FONT font_awesome_16_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_32)
+elseif(CONFIG_BOARD_TYPE_ESP32S3_Taiji_Pi)
+ set(BOARD_TYPE "taiji-pi-s3")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_XINGZHI_Cube_0_85TFT_WIFI)
+ set(BOARD_TYPE "xingzhi-cube-0.85tft-wifi")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_16_4)
+ set(BUILTIN_ICON_FONT font_awesome_16_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_32)
+elseif(CONFIG_BOARD_TYPE_XINGZHI_Cube_0_85TFT_ML307)
+ set(BOARD_TYPE "xingzhi-cube-0.85tft-ml307")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_16_4)
+ set(BUILTIN_ICON_FONT font_awesome_16_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_32)
+elseif(CONFIG_BOARD_TYPE_XINGZHI_Cube_0_96OLED_WIFI)
+ set(BOARD_TYPE "xingzhi-cube-0.96oled-wifi")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_14_1)
+ set(BUILTIN_ICON_FONT font_awesome_14_1)
+elseif(CONFIG_BOARD_TYPE_XINGZHI_Cube_0_96OLED_ML307)
+ set(BOARD_TYPE "xingzhi-cube-0.96oled-ml307")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_14_1)
+ set(BUILTIN_ICON_FONT font_awesome_14_1)
+elseif(CONFIG_BOARD_TYPE_XINGZHI_Cube_1_54TFT_WIFI)
+ set(BOARD_TYPE "xingzhi-cube-1.54tft-wifi")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_XINGZHI_Cube_1_54TFT_ML307)
+ set(BOARD_TYPE "xingzhi-cube-1.54tft-ml307")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_SENSECAP_WATCHER)
+ set(BOARD_TYPE "sensecap-watcher")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_30_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_DOIT_S3_AIBOX)
+ set(BOARD_TYPE "doit-s3-aibox")
+elseif(CONFIG_BOARD_TYPE_MIXGO_NOVA)
+ set(BOARD_TYPE "mixgo-nova")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_16_4)
+ set(BUILTIN_ICON_FONT font_awesome_16_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_32)
+elseif(CONFIG_BOARD_TYPE_GENJUTECH_S3_1_54TFT)
+ set(BOARD_TYPE "genjutech-s3-1.54tft")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ESP32_CGC)
+ set(BOARD_TYPE "esp32-cgc")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_14_1)
+ set(BUILTIN_ICON_FONT font_awesome_14_1)
+elseif(CONFIG_BOARD_TYPE_ESP32_CGC_144)
+ set(BOARD_TYPE "esp32-cgc-144")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_14_1)
+ set(BUILTIN_ICON_FONT font_awesome_14_1)
+elseif(CONFIG_BOARD_TYPE_ESP_S3_LCD_EV_Board)
+ set(BOARD_TYPE "esp-s3-lcd-ev-board")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_30_4)
+ set(BUILTIN_ICON_FONT font_awesome_30_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ESP_S3_LCD_EV_Board_2)
+ set(BOARD_TYPE "esp-s3-lcd-ev-board-2")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_30_4)
+ set(BUILTIN_ICON_FONT font_awesome_30_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ZHENGCHEN_1_54TFT_WIFI)
+ set(BOARD_TYPE "zhengchen-1.54tft-wifi")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_MINSI_K08_DUAL)
+ set(BOARD_TYPE "minsi-k08-dual")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ZHENGCHEN_1_54TFT_ML307)
+ set(BOARD_TYPE "zhengchen-1.54tft-ml307")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_ESP32_S3_1_54_MUMA)
+ set(BOARD_TYPE "sp-esp32-s3-1.54-muma")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_16_4)
+ set(BUILTIN_ICON_FONT font_awesome_16_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_32)
+elseif(CONFIG_BOARD_TYPE_ESP32_S3_1_28_BOX)
+ set(BOARD_TYPE "sp-esp32-s3-1.28-box")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_16_4)
+ set(BUILTIN_ICON_FONT font_awesome_16_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_OTTO_ROBOT)
+ set(BOARD_TYPE "otto-robot")
+ set(BUILTIN_TEXT_FONT font_puhui_16_4)
+ set(BUILTIN_ICON_FONT font_awesome_16_4)
+elseif(CONFIG_BOARD_TYPE_ELECTRON_BOT)
+ set(BOARD_TYPE "electron-bot")
+ set(BUILTIN_TEXT_FONT font_puhui_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+elseif(CONFIG_BOARD_TYPE_BREAD_COMPACT_WIFI_CAM)
+ set(BOARD_TYPE "bread-compact-wifi-s3cam")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_16_4)
+ set(BUILTIN_ICON_FONT font_awesome_16_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_JIUCHUAN)
+ set(BOARD_TYPE "jiuchuan-s3")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_LABPLUS_MPYTHON_V3)
+ set(BOARD_TYPE "labplus-mpython-v3")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_LABPLUS_LEDONG_V2)
+ set(BOARD_TYPE "labplus-ledong-v2")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+elseif(CONFIG_BOARD_TYPE_SURFER_C3_1_14TFT)
+ set(BOARD_TYPE "surfer-c3-1.14tft")
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_32)
+elseif(CONFIG_BOARD_TYPE_YUNLIAO_S3)
+ set(BOARD_TYPE "yunliao-s3")
+ set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
+ set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
+ set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
+elseif(CONFIG_BOARD_TYPE_JINAO_S3)
+ set(BOARD_TYPE "jinao-s3")
+ set(LVGL_TEXT_FONT ${FONT_PUHUI_BASIC_20_4})
+ set(LVGL_ICON_FONT ${FONT_AWESOME_20_4})
+ set(DEFAULT_ASSETS ${ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64})
+ set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
+ set(BUILTIN_ICON_FONT font_awesome_20_4)
+ set(DEFAULT_EMOJI_COLLECTION twemoji_64)
+endif()
+
+file(GLOB BOARD_SOURCES
+ ${CMAKE_CURRENT_SOURCE_DIR}/boards/${BOARD_TYPE}/*.cc
+ ${CMAKE_CURRENT_SOURCE_DIR}/boards/${BOARD_TYPE}/*.c
+)
+list(APPEND SOURCES ${BOARD_SOURCES})
+
+# Select audio processor according to Kconfig
+if(CONFIG_USE_AUDIO_PROCESSOR)
+ list(APPEND SOURCES "audio/processors/afe_audio_processor.cc")
+else()
+ list(APPEND SOURCES "audio/processors/no_audio_processor.cc")
+endif()
+if(CONFIG_IDF_TARGET_ESP32S3 OR CONFIG_IDF_TARGET_ESP32P4)
+ list(APPEND SOURCES "audio/wake_words/afe_wake_word.cc")
+ list(APPEND SOURCES "audio/wake_words/custom_wake_word.cc")
+else()
+ list(APPEND SOURCES "audio/wake_words/esp_wake_word.cc")
+endif()
+
+# Select language directory according to Kconfig
+if(CONFIG_LANGUAGE_ZH_CN)
+ set(LANG_DIR "zh-CN")
+elseif(CONFIG_LANGUAGE_ZH_TW)
+ set(LANG_DIR "zh-TW")
+elseif(CONFIG_LANGUAGE_EN_US)
+ set(LANG_DIR "en-US")
+elseif(CONFIG_LANGUAGE_JA_JP)
+ set(LANG_DIR "ja-JP")
+elseif(CONFIG_LANGUAGE_KO_KR)
+ set(LANG_DIR "ko-KR")
+elseif(CONFIG_LANGUAGE_VI_VN)
+ set(LANG_DIR "vi-VN")
+elseif(CONFIG_LANGUAGE_TH_TH)
+ set(LANG_DIR "th-TH")
+elseif(CONFIG_LANGUAGE_DE_DE)
+ set(LANG_DIR "de-DE")
+elseif(CONFIG_LANGUAGE_FR_FR)
+ set(LANG_DIR "fr-FR")
+elseif(CONFIG_LANGUAGE_ES_ES)
+ set(LANG_DIR "es-ES")
+elseif(CONFIG_LANGUAGE_IT_IT)
+ set(LANG_DIR "it-IT")
+elseif(CONFIG_LANGUAGE_RU_RU)
+ set(LANG_DIR "ru-RU")
+elseif(CONFIG_LANGUAGE_AR_SA)
+ set(LANG_DIR "ar-SA")
+elseif(CONFIG_LANGUAGE_HI_IN)
+ set(LANG_DIR "hi-IN")
+elseif(CONFIG_LANGUAGE_PT_PT)
+ set(LANG_DIR "pt-PT")
+elseif(CONFIG_LANGUAGE_PL_PL)
+ set(LANG_DIR "pl-PL")
+elseif(CONFIG_LANGUAGE_CS_CZ)
+ set(LANG_DIR "cs-CZ")
+elseif(CONFIG_LANGUAGE_FI_FI)
+ set(LANG_DIR "fi-FI")
+elseif(CONFIG_LANGUAGE_TR_TR)
+ set(LANG_DIR "tr-TR")
+elseif(CONFIG_LANGUAGE_ID_ID)
+ set(LANG_DIR "id-ID")
+elseif(CONFIG_LANGUAGE_UK_UA)
+ set(LANG_DIR "uk-UA")
+elseif(CONFIG_LANGUAGE_RO_RO)
+ set(LANG_DIR "ro-RO")
+endif()
+
+# Define generation path
+set(LANG_JSON "${CMAKE_CURRENT_SOURCE_DIR}/assets/locales/${LANG_DIR}/language.json")
+set(LANG_HEADER "${CMAKE_CURRENT_SOURCE_DIR}/assets/lang_config.h")
+file(GLOB LANG_SOUNDS ${CMAKE_CURRENT_SOURCE_DIR}/assets/locales/${LANG_DIR}/*.ogg)
+file(GLOB COMMON_SOUNDS ${CMAKE_CURRENT_SOURCE_DIR}/assets/common/*.ogg)
+
+# If target chip is ESP32, exclude specific files to avoid build errors
+if(CONFIG_IDF_TARGET_ESP32)
+ list(REMOVE_ITEM SOURCES "audio/codecs/box_audio_codec.cc"
+ "audio/codecs/es8388_audio_codec.cc"
+ "audio/codecs/es8389_audio_codec.cc"
+ "led/gpio_led.cc"
+ )
+endif()
+
+idf_component_register(SRCS ${SOURCES}
+ EMBED_FILES ${LANG_SOUNDS} ${COMMON_SOUNDS}
+ INCLUDE_DIRS ${INCLUDE_DIRS}
+ WHOLE_ARCHIVE
+ )
+
+# Use target_compile_definitions to define BOARD_TYPE, BOARD_NAME
+# If BOARD_NAME is empty, use BOARD_TYPE
+if(NOT BOARD_NAME)
+ set(BOARD_NAME ${BOARD_TYPE})
+endif()
+target_compile_definitions(${COMPONENT_LIB}
+ PRIVATE BOARD_TYPE=\"${BOARD_TYPE}\" BOARD_NAME=\"${BOARD_NAME}\"
+ PRIVATE BUILTIN_TEXT_FONT=${BUILTIN_TEXT_FONT} BUILTIN_ICON_FONT=${BUILTIN_ICON_FONT}
+ )
+
+# Add generation rules
+add_custom_command(
+ OUTPUT ${LANG_HEADER}
+ COMMAND python ${PROJECT_DIR}/scripts/gen_lang.py
+ --language "${LANG_DIR}"
+ --output "${LANG_HEADER}"
+ DEPENDS
+ ${LANG_JSON}
+ ${PROJECT_DIR}/scripts/gen_lang.py
+ COMMENT "Generating ${LANG_DIR} language config"
+)
+
+# Force build generation dependencies
+add_custom_target(lang_header ALL
+ DEPENDS ${LANG_HEADER}
+)
+
+# Find ESP-SR component dynamically
+find_component_by_pattern("espressif__esp-sr" ESP_SR_COMPONENT ESP_SR_COMPONENT_PATH)
+if(ESP_SR_COMPONENT_PATH)
+ set(ESP_SR_MODEL_PATH "${ESP_SR_COMPONENT_PATH}/model")
+endif()
+
+# Find xiaozhi-fonts component dynamically
+find_component_by_pattern("xiaozhi-fonts" XIAOZHI_FONTS_COMPONENT XIAOZHI_FONTS_COMPONENT_PATH)
+if(XIAOZHI_FONTS_COMPONENT_PATH)
+ set(XIAOZHI_FONTS_PATH "${XIAOZHI_FONTS_COMPONENT_PATH}")
+endif()
+
+if(CONFIG_BOARD_TYPE_ESP_HI)
+set(URL "https://github.com/espressif2022/image_player/raw/main/test_apps/test_8bit")
+set(EMOJI_DIR "${CMAKE_BINARY_DIR}/emoji")
+file(MAKE_DIRECTORY ${EMOJI_DIR})
+
+# List all files to download
+set(FILES_TO_DOWNLOAD "")
+list(APPEND FILES_TO_DOWNLOAD "Anger_enter.aaf" "Anger_loop.aaf" "Anger_return.aaf")
+list(APPEND FILES_TO_DOWNLOAD "happy_enter.aaf" "happy_loop.aaf" "happ_return.aaf")
+list(APPEND FILES_TO_DOWNLOAD "sad_enter.aaf" "sad_loop.aaf" "sad_return.aaf")
+list(APPEND FILES_TO_DOWNLOAD "scorn_enter.aaf" "scorn_loop.aaf" "scorn_return.aaf")
+list(APPEND FILES_TO_DOWNLOAD "left_enter.aaf" "left_loop.aaf" "left_return.aaf")
+list(APPEND FILES_TO_DOWNLOAD "right_enter.aaf" "right_loop.aaf" "right_return.aaf")
+list(APPEND FILES_TO_DOWNLOAD "asking.aaf" "blink_once.aaf" "blink_quick.aaf")
+list(APPEND FILES_TO_DOWNLOAD "connecting.aaf" "panic_enter.aaf" "panic_loop.aaf")
+list(APPEND FILES_TO_DOWNLOAD "panic_return.aaf" "wake.aaf")
+
+foreach(FILENAME IN LISTS FILES_TO_DOWNLOAD)
+ set(REMOTE_FILE "${URL}/${FILENAME}")
+ set(LOCAL_FILE "${EMOJI_DIR}/${FILENAME}")
+
+ # Check if local file exists
+ if(EXISTS ${LOCAL_FILE})
+ message(STATUS "File ${FILENAME} already exists, skipping download")
+ else()
+ message(STATUS "Downloading ${FILENAME}")
+ file(DOWNLOAD ${REMOTE_FILE} ${LOCAL_FILE}
+ STATUS DOWNLOAD_STATUS)
+ list(GET DOWNLOAD_STATUS 0 STATUS_CODE)
+ if(NOT STATUS_CODE EQUAL 0)
+ message(FATAL_ERROR "Failed to download ${FILENAME} from ${URL}")
+ endif()
+ endif()
+endforeach()
+
+endif()
+
+
+# Function to build default assets based on configuration
+function(build_default_assets_bin)
+ # Set output path for generated assets.bin
+ set(GENERATED_ASSETS_BIN "${CMAKE_BINARY_DIR}/generated_assets.bin")
+
+ # Prepare arguments for build script
+ set(BUILD_ARGS
+ "--sdkconfig" "${SDKCONFIG}"
+ "--output" "${GENERATED_ASSETS_BIN}"
+ )
+
+ # Add builtin text font if defined
+ if(BUILTIN_TEXT_FONT)
+ list(APPEND BUILD_ARGS "--builtin_text_font" "${BUILTIN_TEXT_FONT}")
+ endif()
+
+ # Add default emoji collection if defined
+ if(DEFAULT_EMOJI_COLLECTION)
+ list(APPEND BUILD_ARGS "--emoji_collection" "${DEFAULT_EMOJI_COLLECTION}")
+ endif()
+
+ # Add default assets extra files if defined
+ if(DEFAULT_ASSETS_EXTRA_FILES)
+ list(APPEND BUILD_ARGS "--extra_files" "${DEFAULT_ASSETS_EXTRA_FILES}")
+ endif()
+
+ list(APPEND BUILD_ARGS "--esp_sr_model_path" "${ESP_SR_MODEL_PATH}")
+ list(APPEND BUILD_ARGS "--xiaozhi_fonts_path" "${XIAOZHI_FONTS_PATH}")
+
+ # Create custom command to build assets
+ add_custom_command(
+ OUTPUT ${GENERATED_ASSETS_BIN}
+ COMMAND python ${PROJECT_DIR}/scripts/build_default_assets.py ${BUILD_ARGS}
+ DEPENDS
+ ${SDKCONFIG}
+ ${PROJECT_DIR}/scripts/build_default_assets.py
+ COMMENT "Building default assets.bin based on configuration"
+ VERBATIM
+ )
+
+ # Create target for generated assets
+ add_custom_target(generated_default_assets ALL
+ DEPENDS ${GENERATED_ASSETS_BIN}
+ )
+
+ # Set the generated file path in parent scope
+ set(GENERATED_ASSETS_LOCAL_FILE ${GENERATED_ASSETS_BIN} PARENT_SCOPE)
+
+ message(STATUS "Default assets build configured: ${GENERATED_ASSETS_BIN}")
+endfunction()
+
+
+# Function to get local assets file path (handles both URL and local file)
+function(get_assets_local_file assets_source assets_local_file_var)
+ # Check if it's a URL (starts with http:// or https://)
+ if(assets_source MATCHES "^https?://")
+ # It's a URL, download it
+ get_filename_component(ASSETS_FILENAME "${assets_source}" NAME)
+ set(ASSETS_LOCAL_FILE "${CMAKE_BINARY_DIR}/${ASSETS_FILENAME}")
+ set(ASSETS_TEMP_FILE "${CMAKE_BINARY_DIR}/${ASSETS_FILENAME}.tmp")
+
+ # Check if local file exists
+ if(EXISTS ${ASSETS_LOCAL_FILE})
+ message(STATUS "Assets file ${ASSETS_FILENAME} already exists, skipping download")
+ else()
+ message(STATUS "Downloading ${ASSETS_FILENAME}")
+
+ # Clean up any existing temp file
+ if(EXISTS ${ASSETS_TEMP_FILE})
+ file(REMOVE ${ASSETS_TEMP_FILE})
+ endif()
+
+ # Download to temporary file first
+ file(DOWNLOAD ${assets_source} ${ASSETS_TEMP_FILE}
+ STATUS DOWNLOAD_STATUS)
+ list(GET DOWNLOAD_STATUS 0 STATUS_CODE)
+ if(NOT STATUS_CODE EQUAL 0)
+ # Clean up temp file on failure
+ if(EXISTS ${ASSETS_TEMP_FILE})
+ file(REMOVE ${ASSETS_TEMP_FILE})
+ endif()
+ message(FATAL_ERROR "Failed to download ${ASSETS_FILENAME} from ${assets_source}")
+ endif()
+
+ # Move temp file to final location (atomic operation)
+ file(RENAME ${ASSETS_TEMP_FILE} ${ASSETS_LOCAL_FILE})
+ message(STATUS "Successfully downloaded ${ASSETS_FILENAME}")
+ endif()
+ else()
+ # It's a local file path
+ if(IS_ABSOLUTE "${assets_source}")
+ set(ASSETS_LOCAL_FILE "${assets_source}")
+ else()
+ set(ASSETS_LOCAL_FILE "${CMAKE_CURRENT_SOURCE_DIR}/${assets_source}")
+ endif()
+
+ # Check if local file exists
+ if(NOT EXISTS ${ASSETS_LOCAL_FILE})
+ message(FATAL_ERROR "Assets file not found: ${ASSETS_LOCAL_FILE}")
+ endif()
+
+ message(STATUS "Using assets file: ${ASSETS_LOCAL_FILE}")
+ endif()
+
+ set(${assets_local_file_var} ${ASSETS_LOCAL_FILE} PARENT_SCOPE)
+endfunction()
+
+
+partition_table_get_partition_info(size "--partition-name assets" "size")
+partition_table_get_partition_info(offset "--partition-name assets" "offset")
+if ("${size}" AND "${offset}")
+ # Flash assets based on configuration
+ if(CONFIG_FLASH_DEFAULT_ASSETS)
+ # Build default assets based on configuration
+ build_default_assets_bin()
+ esptool_py_flash_to_partition(flash "assets" "${GENERATED_ASSETS_LOCAL_FILE}")
+ message(STATUS "Generated default assets flash configured: ${GENERATED_ASSETS_LOCAL_FILE} -> assets partition")
+ elseif(CONFIG_FLASH_CUSTOM_ASSETS)
+ # Flash custom assets
+ get_assets_local_file("${CONFIG_CUSTOM_ASSETS_FILE}" ASSETS_LOCAL_FILE)
+ esptool_py_flash_to_partition(flash "assets" "${ASSETS_LOCAL_FILE}")
+ message(STATUS "Custom assets flash configured: ${ASSETS_LOCAL_FILE} -> assets partition")
+ elseif(CONFIG_FLASH_NONE_ASSETS)
+ message(STATUS "Assets flashing disabled (FLASH_NONE_ASSETS)")
+ endif()
+else()
+ message(STATUS "Assets partition not found, using v1 partition table")
+endif()
diff --git a/main/Kconfig.projbuild b/main/Kconfig.projbuild
index 57f7456..c069a76 100644
--- a/main/Kconfig.projbuild
+++ b/main/Kconfig.projbuild
@@ -1,595 +1,630 @@
-menu "Xiaozhi Assistant"
-
-config OTA_URL
- string "Default OTA URL"
- default "https://api.tenclass.net/xiaozhi/ota/"
- help
- The application will access this URL to check for new firmwares and server address.
-
-choice
- prompt "Flash Assets"
- default FLASH_NONE_ASSETS
- help
- Select the assets to flash.
-
- config FLASH_NONE_ASSETS
- bool "Do not flash assets"
- config FLASH_DEFAULT_ASSETS
- bool "Flash Default Assets"
- config FLASH_CUSTOM_ASSETS
- bool "Flash Custom Assets"
-endchoice
-
-config CUSTOM_ASSETS_FILE
- depends on FLASH_CUSTOM_ASSETS
- string "Custom Assets File"
- default "assets.bin"
- help
- The custom assets file to flash.
- It can be a local file relative to the project directory or a remote url.
-
-choice
- prompt "Default Language"
- default LANGUAGE_ZH_CN
- help
- Select device display language
-
- config LANGUAGE_ZH_CN
- bool "Chinese"
- config LANGUAGE_ZH_TW
- bool "Chinese Traditional"
- config LANGUAGE_EN_US
- bool "English"
- config LANGUAGE_JA_JP
- bool "Japanese"
- config LANGUAGE_KO_KR
- bool "Korean"
- config LANGUAGE_VI_VN
- bool "Vietnamese"
- config LANGUAGE_TH_TH
- bool "Thai"
- config LANGUAGE_DE_DE
- bool "German"
- config LANGUAGE_FR_FR
- bool "French"
- config LANGUAGE_ES_ES
- bool "Spanish"
- config LANGUAGE_IT_IT
- bool "Italian"
- config LANGUAGE_RU_RU
- bool "Russian"
- config LANGUAGE_AR_SA
- bool "Arabic"
- config LANGUAGE_HI_IN
- bool "Hindi"
- config LANGUAGE_PT_PT
- bool "Portuguese"
- config LANGUAGE_PL_PL
- bool "Polish"
- config LANGUAGE_CS_CZ
- bool "Czech"
- config LANGUAGE_FI_FI
- bool "Finnish"
- config LANGUAGE_TR_TR
- bool "Turkish"
- config LANGUAGE_ID_ID
- bool "Indonesian"
- config LANGUAGE_UK_UA
- bool "Ukrainian"
- config LANGUAGE_RO_RO
- bool "Romanian"
-endchoice
-
-choice BOARD_TYPE
- prompt "Board Type"
- default BOARD_TYPE_BREAD_COMPACT_WIFI
- help
- Board type. 开发板类型
- config BOARD_TYPE_BREAD_COMPACT_WIFI
- bool "面包板新版接线(WiFi)"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_BREAD_COMPACT_WIFI_LCD
- bool "面包板新版接线(WiFi)+ LCD"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_BREAD_COMPACT_WIFI_CAM
- bool "面包板新版接线(WiFi)+ LCD + Camera"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ESP32S3_SMART_SPEAKER
- bool "ESP32-S3 智能音箱(PCM5102+INMP441)"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_BREAD_COMPACT_ML307
- bool "面包板新版接线(ML307 AT)"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_BREAD_COMPACT_ESP32
- bool "面包板(WiFi) ESP32 DevKit"
- depends on IDF_TARGET_ESP32
- config BOARD_TYPE_BREAD_COMPACT_ESP32_LCD
- bool "面包板(WiFi+ LCD) ESP32 DevKit"
- depends on IDF_TARGET_ESP32
- config BOARD_TYPE_XMINI_C3_V3
- bool "虾哥 Mini C3 V3"
- depends on IDF_TARGET_ESP32C3
- config BOARD_TYPE_XMINI_C3_4G
- bool "虾哥 Mini C3 4G"
- depends on IDF_TARGET_ESP32C3
- config BOARD_TYPE_XMINI_C3
- bool "虾哥 Mini C3"
- depends on IDF_TARGET_ESP32C3
- config BOARD_TYPE_ESP32S3_KORVO2_V3
- bool "ESP32S3_KORVO2_V3开发板"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ESP_SPARKBOT
- bool "ESP-SparkBot开发板"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ESP_SPOT_S3
- bool "ESP-Spot-S3"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ESP_HI
- bool "ESP-HI"
- depends on IDF_TARGET_ESP32C3
- config BOARD_TYPE_ECHOEAR
- bool "EchoEar"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ESP_BOX_3
- bool "ESP BOX 3"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ESP_BOX
- bool "ESP BOX"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ESP_BOX_LITE
- bool "ESP BOX Lite"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_KEVIN_BOX_1
- bool "Kevin Box 1"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_KEVIN_BOX_2
- bool "Kevin Box 2"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_KEVIN_C3
- bool "Kevin C3"
- depends on IDF_TARGET_ESP32C3
- config BOARD_TYPE_KEVIN_SP_V3_DEV
- bool "Kevin SP V3开发板"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_KEVIN_SP_V4_DEV
- bool "Kevin SP V4开发板"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ESP32_CGC
- bool "ESP32 CGC"
- depends on IDF_TARGET_ESP32
- config BOARD_TYPE_ESP32_CGC_144
- bool "ESP32 CGC 144"
- depends on IDF_TARGET_ESP32
- config BOARD_TYPE_KEVIN_YUYING_313LCD
- bool "鱼鹰科技3.13LCD开发板"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_LICHUANG_DEV
- bool "立创·实战派ESP32-S3开发板"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_LICHUANG_C3_DEV
- bool "立创·实战派ESP32-C3开发板"
- depends on IDF_TARGET_ESP32C3
- config BOARD_TYPE_DF_K10
- bool "DFRobot 行空板 k10"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_DF_S3_AI_CAM
- bool "DFRobot ESP32-S3 AI智能摄像头模块"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_MAGICLICK_2P4
- bool "神奇按钮 Magiclick_2.4"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_MAGICLICK_2P5
- bool "神奇按钮 Magiclick_2.5"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_MAGICLICK_C3
- bool "神奇按钮 Magiclick_C3"
- depends on IDF_TARGET_ESP32C3
- config BOARD_TYPE_MAGICLICK_C3_V2
- bool "神奇按钮 Magiclick_C3_v2"
- depends on IDF_TARGET_ESP32C3
- config BOARD_TYPE_M5STACK_CORE_S3
- bool "M5Stack CoreS3"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_M5STACK_CORE_TAB5
- bool "M5Stack Tab5"
- depends on IDF_TARGET_ESP32P4
- config BOARD_TYPE_ATOMS3_ECHO_BASE
- bool "AtomS3 + Echo Base"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ATOMS3R_ECHO_BASE
- bool "AtomS3R + Echo Base"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ATOMS3R_CAM_M12_ECHO_BASE
- bool "AtomS3R CAM/M12 + Echo Base"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ATOM_ECHOS3R
- bool "AtomEchoS3R"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ATOMMATRIX_ECHO_BASE
- bool "AtomMatrix + Echo Base"
- depends on IDF_TARGET_ESP32
- config BOARD_TYPE_ESP32S3_AUDIO_BOARD
- bool "Waveshare ESP32-S3-Audio-Board"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ESP32S3_Touch_AMOLED_1_8
- bool "Waveshare ESP32-S3-Touch-AMOLED-1.8"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ESP32S3_Touch_AMOLED_2_06
- bool "Waveshare ESP32-S3-Touch-AMOLED-2.06"
- config BOARD_TYPE_ESP32S3_Touch_AMOLED_1_75
- bool "Waveshare ESP32-S3-Touch-AMOLED-1.75"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ESP32S3_Touch_LCD_1_85C
- bool "Waveshare ESP32-S3-Touch-LCD-1.85C"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ESP32S3_Touch_LCD_1_85
- bool "Waveshare ESP32-S3-Touch-LCD-1.85"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ESP32S3_Touch_LCD_1_46
- bool "Waveshare ESP32-S3-Touch-LCD-1.46"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ESP32C6_LCD_1_69
- bool "Waveshare ESP32-C6-LCD-1.69"
- depends on IDF_TARGET_ESP32C6
- config BOARD_TYPE_ESP32C6_Touch_AMOLED_1_43
- bool "Waveshare ESP32-C6-Touch-AMOLOED-1.43"
- depends on IDF_TARGET_ESP32C6
- config BOARD_TYPE_ESP32S3_Touch_LCD_3_5
- bool "Waveshare ESP32-S3-Touch-LCD-3.5"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ESP32S3_Touch_LCD_3_5B
- bool "Waveshare ESP32-S3-Touch-LCD-3.5B"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ESP32P4_NANO
- bool "Waveshare ESP32-P4-NANO"
- depends on IDF_TARGET_ESP32P4
- config BOARD_TYPE_ESP32P4_WIFI6_Touch_LCD_4B
- bool "Waveshare ESP32-P4-WIFI6-Touch-LCD-4B"
- depends on IDF_TARGET_ESP32P4
- config BOARD_TYPE_ESP32P4_WIFI6_Touch_LCD_XC
- bool "Waveshare ESP32-P4-WIFI6-Touch-LCD-3.4C or ESP32-P4-WIFI6-Touch-LCD-4C"
- depends on IDF_TARGET_ESP32P4
- config BOARD_TYPE_TUDOUZI
- bool "土豆子"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_LILYGO_T_CIRCLE_S3
- bool "LILYGO T-Circle-S3"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_LILYGO_T_CAMERAPLUS_S3_V1_0_V1_1
- bool "LILYGO T-CameraPlus-S3_V1_0_V1_1"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_LILYGO_T_CAMERAPLUS_S3_V1_2
- bool "LILYGO T-CameraPlus-S3_V1_2"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_LILYGO_T_DISPLAY_S3_PRO_MVSRLORA
- bool "LILYGO T-Display-S3-Pro-MVSRLora"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_LILYGO_T_DISPLAY_S3_PRO_MVSRLORA_NO_BATTERY
- bool "LILYGO T-Display-S3-Pro-MVSRLora_No_Battery"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_MOVECALL_MOJI_ESP32S3
- bool "Movecall Moji 小智AI衍生版"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_MOVECALL_CUICAN_ESP32S3
- bool "Movecall CuiCan 璀璨·AI吊坠"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ATK_DNESP32S3
- bool "正点原子DNESP32S3开发板"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ATK_DNESP32S3_BOX
- bool "正点原子DNESP32S3-BOX"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ATK_DNESP32S3_BOX0
- bool "正点原子DNESP32S3-BOX0"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ATK_DNESP32S3_BOX2_WIFI
- bool "正点原子DNESP32S3-BOX2-WIFI"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ATK_DNESP32S3_BOX2_4G
- bool "正点原子DNESP32S3-BOX2-4G"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ATK_DNESP32S3M_WIFI
- bool "正点原子DNESP32S3M-WIFI"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ATK_DNESP32S3M_4G
- bool "正点原子DNESP32S3M-4G"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_DU_CHATX
- bool "嘟嘟开发板CHATX(wifi)"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ESP32S3_Taiji_Pi
- bool "太极小派esp32s3"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_XINGZHI_Cube_0_85TFT_WIFI
- bool "无名科技星智0.85(WIFI)"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_XINGZHI_Cube_0_85TFT_ML307
- bool "无名科技星智0.85(ML307)"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_XINGZHI_Cube_0_96OLED_WIFI
- bool "无名科技星智0.96(WIFI)"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_XINGZHI_Cube_0_96OLED_ML307
- bool "无名科技星智0.96(ML307)"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_XINGZHI_Cube_1_54TFT_WIFI
- bool "无名科技星智1.54(WIFI)"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_XINGZHI_Cube_1_54TFT_ML307
- bool "无名科技星智1.54(ML307)"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_SENSECAP_WATCHER
- bool "SenseCAP Watcher"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_DOIT_S3_AIBOX
- bool "四博智联AI陪伴盒子"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_MIXGO_NOVA
- bool "元控·青春"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_GENJUTECH_S3_1_54TFT
- bool "亘具科技1.54(s3)"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ESP_S3_LCD_EV_Board
- bool "乐鑫ESP S3 LCD EV Board开发板"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ESP_S3_LCD_EV_Board_2
- bool "乐鑫ESP S3 LCD EV Board 2开发板"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ZHENGCHEN_1_54TFT_WIFI
- bool "征辰科技1.54(WIFI)"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ZHENGCHEN_1_54TFT_ML307
- bool "征辰科技1.54(ML307)"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_MINSI_K08_DUAL
- bool "敏思科技K08(DUAL)"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ESP32_S3_1_54_MUMA
- bool "Spotpear ESP32-S3-1.54-MUMA"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_ESP32_S3_1_28_BOX
- bool "Spotpear ESP32-S3-1.28-BOX"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_OTTO_ROBOT
- bool "ottoRobot"
- depends on IDF_TARGET_ESP32S3
- select LV_USE_GIF
- select LV_GIF_CACHE_DECODE_DATA
- config BOARD_TYPE_ELECTRON_BOT
- bool "electronBot"
- depends on IDF_TARGET_ESP32S3
- select LV_USE_GIF
- select LV_GIF_CACHE_DECODE_DATA
- config BOARD_TYPE_JIUCHUAN
- bool "九川智能"
- config BOARD_TYPE_LABPLUS_MPYTHON_V3
- bool "labplus mpython_v3 board"
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_LABPLUS_LEDONG_V2
- bool "labplus ledong_v2 board"
- depends on IDF_TARGET_ESP32S3
- depends on IDF_TARGET_ESP32S3
- config BOARD_TYPE_SURFER_C3_1_14TFT
- bool "Surfer-C3-1-14TFT"
- depends on IDF_TARGET_ESP32C3
- config BOARD_TYPE_YUNLIAO_S3
- bool "小智云聊-S3"
- depends on IDF_TARGET_ESP32S3
-endchoice
-
-choice ESP_S3_LCD_EV_Board_Version_TYPE
- depends on BOARD_TYPE_ESP_S3_LCD_EV_Board
- prompt "EV_BOARD Type"
- default ESP_S3_LCD_EV_Board_1p4
- help
- 开发板硬件版本型号选择
- config ESP_S3_LCD_EV_Board_1p4
- bool "乐鑫ESP32_S3_LCD_EV_Board-MB_V1.4"
- config ESP_S3_LCD_EV_Board_1p5
- bool "乐鑫ESP32_S3_LCD_EV_Board-MB_V1.5"
-endchoice
-
-choice DISPLAY_OLED_TYPE
- depends on BOARD_TYPE_BREAD_COMPACT_WIFI || BOARD_TYPE_BREAD_COMPACT_ML307 || BOARD_TYPE_BREAD_COMPACT_ESP32
- prompt "OLED Type"
- default OLED_SSD1306_128X32
- help
- OLED 屏幕类型选择
- config OLED_SSD1306_128X32
- bool "SSD1306, 分辨率128*32"
- config OLED_SSD1306_128X64
- bool "SSD1306, 分辨率128*64"
- config OLED_SH1106_128X64
- bool "SH1106, 分辨率128*64"
-endchoice
-
-choice DISPLAY_LCD_TYPE
- depends on BOARD_TYPE_BREAD_COMPACT_WIFI_LCD || BOARD_TYPE_BREAD_COMPACT_ESP32_LCD || BOARD_TYPE_ESP32_CGC || BOARD_TYPE_ESP32P4_NANO || BOARD_TYPE_ESP32P4_WIFI6_Touch_LCD_XC || BOARD_TYPE_BREAD_COMPACT_WIFI_CAM
- prompt "LCD Type"
- default LCD_ST7789_240X320
- help
- 屏幕类型选择
- config LCD_ST7789_240X320
- bool "ST7789, 分辨率240*320, IPS"
- config LCD_ST7789_240X320_NO_IPS
- bool "ST7789, 分辨率240*320, 非IPS"
- config LCD_ST7789_170X320
- bool "ST7789, 分辨率170*320"
- config LCD_ST7789_172X320
- bool "ST7789, 分辨率172*320"
- config LCD_ST7789_240X280
- bool "ST7789, 分辨率240*280"
- config LCD_ST7789_240X240
- bool "ST7789, 分辨率240*240"
- config LCD_ST7789_240X240_7PIN
- bool "ST7789, 分辨率240*240, 7PIN"
- config LCD_ST7789_240X135
- bool "ST7789, 分辨率240*135"
- config LCD_ST7735_128X160
- bool "ST7735, 分辨率128*160"
- config LCD_ST7735_128X128
- bool "ST7735, 分辨率128*128"
- config LCD_ST7796_320X480
- bool "ST7796, 分辨率320*480 IPS"
- config LCD_ST7796_320X480_NO_IPS
- bool "ST7796, 分辨率320*480, 非IPS"
- config LCD_ILI9341_240X320
- bool "ILI9341, 分辨率240*320"
- config LCD_ILI9341_240X320_NO_IPS
- bool "ILI9341, 分辨率240*320, 非IPS"
- config LCD_GC9A01_240X240
- bool "GC9A01, 分辨率240*240, 圆屏"
- config LCD_TYPE_800_1280_10_1_INCH
- bool "Waveshare 101M-8001280-IPS-CT-K Display"
- config LCD_TYPE_800_1280_10_1_INCH_A
- bool "Waveshare 10.1-DSI-TOUCH-A Display"
- config LCD_TYPE_800_800_3_4_INCH
- bool "Waveshare ESP32-P4-WIFI6-Touch-LCD-3.4C with 800*800 3.4inch round display"
- config LCD_TYPE_720_720_4_INCH
- bool "Waveshare ESP32-P4-WIFI6-Touch-LCD-4C with 720*720 4inch round display"
- config LCD_CUSTOM
- bool "自定义屏幕参数"
-endchoice
-
-choice DISPLAY_ESP32S3_KORVO2_V3
- depends on BOARD_TYPE_ESP32S3_KORVO2_V3
- prompt "ESP32S3_KORVO2_V3 LCD Type"
- default ESP32S3_KORVO2_V3_LCD_ST7789
- help
- 屏幕类型选择
- config ESP32S3_KORVO2_V3_LCD_ST7789
- bool "ST7789, 分辨率240*280"
- config ESP32S3_KORVO2_V3_LCD_ILI9341
- bool "ILI9341, 分辨率240*320"
-endchoice
-
-choice DISPLAY_ESP32S3_AUDIO_BOARD
- depends on BOARD_TYPE_ESP32S3_AUDIO_BOARD
- prompt "ESP32S3_AUDIO_BOARD LCD Type"
- default AUDIO_BOARD_LCD_JD9853
- help
- 屏幕类型选择
- config AUDIO_BOARD_LCD_JD9853
- bool "JD9853, 分辨率320*172"
- config AUDIO_BOARD_LCD_ST7789
- bool "ST7789, 分辨率240*320"
-endchoice
-
-config USE_WECHAT_MESSAGE_STYLE
- bool "Enable WeChat Message Style"
- default n
- help
- 使用微信聊天界面风格
-
-config USE_ESP_WAKE_WORD
- bool "Enable Wake Word Detection (without AFE)"
- default n
- depends on IDF_TARGET_ESP32C3 || IDF_TARGET_ESP32C5 || IDF_TARGET_ESP32C6 || (IDF_TARGET_ESP32 && SPIRAM)
- help
- 支持 ESP32 C3、ESP32 C5 与 ESP32 C6,增加ESP32支持(需要开启PSRAM)
-
-config USE_AFE_WAKE_WORD
- bool "Enable Wake Word Detection (AFE)"
- default y
- depends on (IDF_TARGET_ESP32S3 || IDF_TARGET_ESP32P4) && SPIRAM
- help
- 需要 ESP32 S3 与 PSRAM 支持
-
-config USE_CUSTOM_WAKE_WORD
- bool "Enable Custom Wake Word Detection"
- default n
- depends on (IDF_TARGET_ESP32S3 || IDF_TARGET_ESP32P4) && SPIRAM && (!USE_AFE_WAKE_WORD)
- help
- 需要 ESP32 S3 与 PSRAM 支持
-
-config CUSTOM_WAKE_WORD
- string "Custom Wake Word"
- default "xiao tu dou"
- depends on USE_CUSTOM_WAKE_WORD
- help
- 自定义唤醒词,中文用拼音表示,每个字之间用空格隔开
-
-config CUSTOM_WAKE_WORD_DISPLAY
- string "Custom Wake Word Display"
- default "小土豆"
- depends on USE_CUSTOM_WAKE_WORD
- help
- 唤醒后发送给服务器的问候语
-
-config CUSTOM_WAKE_WORD_THRESHOLD
- int "Custom Wake Word Threshold (%)"
- default 20
- range 1 99
- depends on USE_CUSTOM_WAKE_WORD
- help
- 自定义唤醒词阈值,范围1-99,越小越敏感,默认10
-
-config USE_AUDIO_PROCESSOR
- bool "Enable Audio Noise Reduction"
- default y
- depends on (IDF_TARGET_ESP32S3 || IDF_TARGET_ESP32P4) && SPIRAM
- help
- 需要 ESP32 S3 与 PSRAM 支持
-
-config USE_DEVICE_AEC
- bool "Enable Device-Side AEC"
- default n
- depends on USE_AUDIO_PROCESSOR && (BOARD_TYPE_ESP_BOX_3 || BOARD_TYPE_ESP_BOX || BOARD_TYPE_ESP_BOX_LITE || BOARD_TYPE_LICHUANG_DEV || BOARD_TYPE_ESP32S3_KORVO2_V3 || BOARD_TYPE_ESP32S3_Touch_AMOLED_1_75 || BOARD_TYPE_ESP32S3_Touch_AMOLED_2_06 || BOARD_TYPE_ESP32P4_WIFI6_Touch_LCD_4B || BOARD_TYPE_ESP32P4_WIFI6_Touch_LCD_XC || BOARD_TYPE_ESP_S3_LCD_EV_Board_2 || BOARD_TYPE_YUNLIAO_S3)
- help
- 因为性能不够,不建议和微信聊天界面风格同时开启
-
-config USE_SERVER_AEC
- bool "Enable Server-Side AEC (Unstable)"
- default n
- depends on USE_AUDIO_PROCESSOR
- help
- 启用服务器端 AEC,需要服务器支持
-
-config USE_AUDIO_DEBUGGER
- bool "Enable Audio Debugger"
- default n
- help
- 启用音频调试功能,通过UDP发送音频数据
-
-config USE_ACOUSTIC_WIFI_PROVISIONING
- bool "Enable Acoustic WiFi Provisioning"
- default n
- help
- 启用声波配网功能,使用音频信号传输 WiFi 配置数据
-
-config AUDIO_DEBUG_UDP_SERVER
- string "Audio Debug UDP Server Address"
- default "192.168.2.100:8000"
- depends on USE_AUDIO_DEBUGGER
- help
- UDP服务器地址,格式: IP:PORT,用于接收音频调试数据
-
-config RECEIVE_CUSTOM_MESSAGE
- bool "Enable Custom Message Reception"
- default n
- help
- 启用接收自定义消息功能,允许设备接收来自服务器的自定义消息(最好通过 MQTT 协议)
-
-menu "TAIJIPAI_S3_CONFIG"
- depends on BOARD_TYPE_ESP32S3_Taiji_Pi
- choice I2S_TYPE_TAIJIPI_S3
- depends on BOARD_TYPE_ESP32S3_Taiji_Pi
- prompt "taiji-pi-S3 I2S Type"
- default TAIJIPAI_I2S_TYPE_STD
- help
- I2S 类型选择
- config TAIJIPAI_I2S_TYPE_STD
- bool "I2S Type STD"
- config TAIJIPAI_I2S_TYPE_PDM
- bool "I2S Type PDM"
- endchoice
-
- config I2S_USE_2SLOT
- bool "Enable Use 2 Slot"
- default n
- help
- 启动双声道
-endmenu
-
-endmenu
\ No newline at end of file
+menu "Xiaozhi Assistant"
+
+config OTA_URL
+ string "Default OTA URL"
+ default "https://api.tenclass.net/xiaozhi/ota/"
+ help
+ The application will access this URL to check for new firmwares and server address.
+
+choice
+ prompt "Flash Assets"
+ default FLASH_DEFAULT_ASSETS
+ help
+ Select the assets to flash.
+
+ config FLASH_NONE_ASSETS
+ bool "Do not flash assets"
+ config FLASH_DEFAULT_ASSETS
+ bool "Flash Default Assets"
+ config FLASH_CUSTOM_ASSETS
+ bool "Flash Custom Assets"
+endchoice
+
+config CUSTOM_ASSETS_FILE
+ depends on FLASH_CUSTOM_ASSETS
+ string "Custom Assets File"
+ default "assets.bin"
+ help
+ The custom assets file to flash.
+ It can be a local file relative to the project directory or a remote url.
+
+choice
+ prompt "Default Language"
+ default LANGUAGE_ZH_CN
+ help
+ Select device display language
+
+ config LANGUAGE_ZH_CN
+ bool "Chinese"
+ config LANGUAGE_ZH_TW
+ bool "Chinese Traditional"
+ config LANGUAGE_EN_US
+ bool "English"
+ config LANGUAGE_JA_JP
+ bool "Japanese"
+ config LANGUAGE_KO_KR
+ bool "Korean"
+ config LANGUAGE_VI_VN
+ bool "Vietnamese"
+ config LANGUAGE_TH_TH
+ bool "Thai"
+ config LANGUAGE_DE_DE
+ bool "German"
+ config LANGUAGE_FR_FR
+ bool "French"
+ config LANGUAGE_ES_ES
+ bool "Spanish"
+ config LANGUAGE_IT_IT
+ bool "Italian"
+ config LANGUAGE_RU_RU
+ bool "Russian"
+ config LANGUAGE_AR_SA
+ bool "Arabic"
+ config LANGUAGE_HI_IN
+ bool "Hindi"
+ config LANGUAGE_PT_PT
+ bool "Portuguese"
+ config LANGUAGE_PL_PL
+ bool "Polish"
+ config LANGUAGE_CS_CZ
+ bool "Czech"
+ config LANGUAGE_FI_FI
+ bool "Finnish"
+ config LANGUAGE_TR_TR
+ bool "Turkish"
+ config LANGUAGE_ID_ID
+ bool "Indonesian"
+ config LANGUAGE_UK_UA
+ bool "Ukrainian"
+ config LANGUAGE_RO_RO
+ bool "Romanian"
+endchoice
+
+choice BOARD_TYPE
+ prompt "Board Type"
+ default BOARD_TYPE_BREAD_COMPACT_WIFI
+ help
+ Board type. 开发板类型
+ config BOARD_TYPE_BREAD_COMPACT_WIFI
+ bool "Bread Compact WiFi (面包板)"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_BREAD_COMPACT_WIFI_LCD
+ bool "Bread Compact WiFi + LCD (面包板)"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_BREAD_COMPACT_WIFI_CAM
+ bool "Bread Compact WiFi + LCD + Camera (面包板)"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_BREAD_COMPACT_ML307
+ bool "Bread Compact ML307/EC801E (面包板 4G)"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_BREAD_COMPACT_ESP32
+ bool "Bread Compact ESP32 DevKit (面包板)"
+ depends on IDF_TARGET_ESP32
+ config BOARD_TYPE_BREAD_COMPACT_ESP32_LCD
+ bool "Bread Compact ESP32 DevKit + LCD (面包板)"
+ depends on IDF_TARGET_ESP32
+ config BOARD_TYPE_XMINI_C3_V3
+ bool "Xmini C3 V3"
+ depends on IDF_TARGET_ESP32C3
+ config BOARD_TYPE_XMINI_C3_4G
+ bool "Xmini C3 4G"
+ depends on IDF_TARGET_ESP32C3
+ config BOARD_TYPE_XMINI_C3
+ bool "Xmini C3"
+ depends on IDF_TARGET_ESP32C3
+ config BOARD_TYPE_ESP32S3_KORVO2_V3
+ bool "ESP32S3 KORVO2 V3"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ESP_SPARKBOT
+ bool "ESP-SparkBot"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ESP_SPOT_S3
+ bool "ESP-Spot-S3"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ESP_HI
+ bool "ESP-HI"
+ depends on IDF_TARGET_ESP32C3
+ config BOARD_TYPE_ECHOEAR
+ bool "EchoEar"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ESP_BOX_3
+ bool "ESP BOX 3"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ESP_BOX
+ bool "ESP BOX"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ESP_BOX_LITE
+ bool "ESP BOX Lite"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_KEVIN_BOX_1
+ bool "Kevin Box 1"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_KEVIN_BOX_2
+ bool "Kevin Box 2"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_KEVIN_C3
+ bool "Kevin C3"
+ depends on IDF_TARGET_ESP32C3
+ config BOARD_TYPE_KEVIN_SP_V3_DEV
+ bool "Kevin SP V3"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_KEVIN_SP_V4_DEV
+ bool "Kevin SP V4"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ESP32_CGC
+ bool "ESP32 CGC"
+ depends on IDF_TARGET_ESP32
+ config BOARD_TYPE_ESP32_CGC_144
+ bool "ESP32 CGC 144"
+ depends on IDF_TARGET_ESP32
+ config BOARD_TYPE_KEVIN_YUYING_313LCD
+ bool "鱼鹰科技 3.13LCD"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_LICHUANG_DEV
+ bool "立创·实战派 ESP32-S3"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_LICHUANG_C3_DEV
+ bool "立创·实战派 ESP32-C3"
+ depends on IDF_TARGET_ESP32C3
+ config BOARD_TYPE_DF_K10
+ bool "DFRobot 行空板 k10"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_DF_S3_AI_CAM
+ bool "DFRobot ESP32-S3 AI智能摄像头模块"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_MAGICLICK_2P4
+ bool "神奇按钮 Magiclick_2.4"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_MAGICLICK_2P5
+ bool "神奇按钮 Magiclick_2.5"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_MAGICLICK_C3
+ bool "神奇按钮 Magiclick_C3"
+ depends on IDF_TARGET_ESP32C3
+ config BOARD_TYPE_MAGICLICK_C3_V2
+ bool "神奇按钮 Magiclick_C3_v2"
+ depends on IDF_TARGET_ESP32C3
+ config BOARD_TYPE_M5STACK_CORE_S3
+ bool "M5Stack CoreS3"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_M5STACK_CORE_TAB5
+ bool "M5Stack Tab5"
+ depends on IDF_TARGET_ESP32P4
+ config BOARD_TYPE_ATOMS3_ECHO_BASE
+ bool "AtomS3 + Echo Base"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ATOMS3R_ECHO_BASE
+ bool "AtomS3R + Echo Base"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ATOMS3R_CAM_M12_ECHO_BASE
+ bool "AtomS3R CAM/M12 + Echo Base"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ATOM_ECHOS3R
+ bool "AtomEchoS3R"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ATOMMATRIX_ECHO_BASE
+ bool "AtomMatrix + Echo Base"
+ depends on IDF_TARGET_ESP32
+ config BOARD_TYPE_ESP32S3_AUDIO_BOARD
+ bool "Waveshare ESP32-S3-Audio-Board"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ESP32S3_Touch_AMOLED_1_8
+ bool "Waveshare ESP32-S3-Touch-AMOLED-1.8"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ESP32S3_Touch_AMOLED_2_06
+ bool "Waveshare ESP32-S3-Touch-AMOLED-2.06"
+ config BOARD_TYPE_ESP32S3_Touch_AMOLED_1_75
+ bool "Waveshare ESP32-S3-Touch-AMOLED-1.75"
+ config BOARD_TYPE_ESP32S3_Touch_LCD_4B
+ bool "Waveshare ESP32-S3-Touch-LCD-4B"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ESP32S3_Touch_LCD_1_85C
+ bool "Waveshare ESP32-S3-Touch-LCD-1.85C"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ESP32S3_Touch_LCD_1_85
+ bool "Waveshare ESP32-S3-Touch-LCD-1.85"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ESP32S3_Touch_LCD_1_46
+ bool "Waveshare ESP32-S3-Touch-LCD-1.46"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ESP32C6_LCD_1_69
+ bool "Waveshare ESP32-C6-LCD-1.69"
+ depends on IDF_TARGET_ESP32C6
+ config BOARD_TYPE_ESP32C6_Touch_AMOLED_1_43
+ bool "Waveshare ESP32-C6-Touch-AMOLOED-1.43"
+ depends on IDF_TARGET_ESP32C6
+ config BOARD_TYPE_ESP32S3_Touch_LCD_3_49
+ bool "Waveshare ESP32-S3-Touch-LCD-3.49"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ESP32S3_Touch_LCD_3_5
+ bool "Waveshare ESP32-S3-Touch-LCD-3.5"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ESP32S3_Touch_LCD_3_5B
+ bool "Waveshare ESP32-S3-Touch-LCD-3.5B"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ESP32P4_NANO
+ bool "Waveshare ESP32-P4-NANO"
+ depends on IDF_TARGET_ESP32P4
+ config BOARD_TYPE_ESP32P4_WIFI6_Touch_LCD_4B
+ bool "Waveshare ESP32-P4-WIFI6-Touch-LCD-4B"
+ depends on IDF_TARGET_ESP32P4
+ config BOARD_TYPE_ESP32P4_WIFI6_Touch_LCD_XC
+ bool "Waveshare ESP32-P4-WIFI6-Touch-LCD-3.4C or ESP32-P4-WIFI6-Touch-LCD-4C"
+ depends on IDF_TARGET_ESP32P4
+ config BOARD_TYPE_TUDOUZI
+ bool "土豆子"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_LILYGO_T_CIRCLE_S3
+ bool "LILYGO T-Circle-S3"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_LILYGO_T_CAMERAPLUS_S3_V1_0_V1_1
+ bool "LILYGO T-CameraPlus-S3_V1_0_V1_1"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_LILYGO_T_CAMERAPLUS_S3_V1_2
+ bool "LILYGO T-CameraPlus-S3_V1_2"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_LILYGO_T_DISPLAY_S3_PRO_MVSRLORA
+ bool "LILYGO T-Display-S3-Pro-MVSRLora"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_LILYGO_T_DISPLAY_S3_PRO_MVSRLORA_NO_BATTERY
+ bool "LILYGO T-Display-S3-Pro-MVSRLora_No_Battery"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_MOVECALL_MOJI_ESP32S3
+ bool "Movecall Moji 小智AI衍生版"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_MOVECALL_CUICAN_ESP32S3
+ bool "Movecall CuiCan 璀璨·AI吊坠"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ATK_DNESP32S3
+ bool "正点原子DNESP32S3开发板"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ATK_DNESP32S3_BOX
+ bool "正点原子DNESP32S3-BOX"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ATK_DNESP32S3_BOX0
+ bool "正点原子DNESP32S3-BOX0"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ATK_DNESP32S3_BOX2_WIFI
+ bool "正点原子DNESP32S3-BOX2-WIFI"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ATK_DNESP32S3_BOX2_4G
+ bool "正点原子DNESP32S3-BOX2-4G"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ATK_DNESP32S3M_WIFI
+ bool "正点原子DNESP32S3M-WIFI"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ATK_DNESP32S3M_4G
+ bool "正点原子DNESP32S3M-4G"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_DU_CHATX
+ bool "嘟嘟开发板CHATX(wifi)"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ESP32S3_Taiji_Pi
+ bool "太极小派esp32s3"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_XINGZHI_Cube_0_85TFT_WIFI
+ bool "无名科技星智0.85(WIFI)"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_XINGZHI_Cube_0_85TFT_ML307
+ bool "无名科技星智0.85(ML307)"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_XINGZHI_Cube_0_96OLED_WIFI
+ bool "无名科技星智0.96(WIFI)"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_XINGZHI_Cube_0_96OLED_ML307
+ bool "无名科技星智0.96(ML307)"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_XINGZHI_Cube_1_54TFT_WIFI
+ bool "无名科技星智1.54(WIFI)"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_XINGZHI_Cube_1_54TFT_ML307
+ bool "无名科技星智1.54(ML307)"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_SENSECAP_WATCHER
+ bool "SenseCAP Watcher"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_DOIT_S3_AIBOX
+ bool "四博智联AI陪伴盒子"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_MIXGO_NOVA
+ bool "元控·青春"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_GENJUTECH_S3_1_54TFT
+ bool "亘具科技1.54(s3)"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ESP_S3_LCD_EV_Board
+ bool "乐鑫ESP S3 LCD EV Board开发板"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ESP_S3_LCD_EV_Board_2
+ bool "乐鑫ESP S3 LCD EV Board 2开发板"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ZHENGCHEN_1_54TFT_WIFI
+ bool "征辰科技1.54(WIFI)"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ZHENGCHEN_1_54TFT_ML307
+ bool "征辰科技1.54(ML307)"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_MINSI_K08_DUAL
+ bool "敏思科技K08(DUAL)"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ESP32_S3_1_54_MUMA
+ bool "Spotpear ESP32-S3-1.54-MUMA"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_ESP32_S3_1_28_BOX
+ bool "Spotpear ESP32-S3-1.28-BOX"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_OTTO_ROBOT
+ bool "ottoRobot"
+ depends on IDF_TARGET_ESP32S3
+ select LV_USE_GIF
+ select LV_GIF_CACHE_DECODE_DATA
+ config BOARD_TYPE_ELECTRON_BOT
+ bool "electronBot"
+ depends on IDF_TARGET_ESP32S3
+ select LV_USE_GIF
+ select LV_GIF_CACHE_DECODE_DATA
+ config BOARD_TYPE_JIUCHUAN
+ bool "九川智能"
+ config BOARD_TYPE_LABPLUS_MPYTHON_V3
+ bool "labplus mpython_v3 board"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_LABPLUS_LEDONG_V2
+ bool "labplus ledong_v2 board"
+ depends on IDF_TARGET_ESP32S3
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_SURFER_C3_1_14TFT
+ bool "Surfer-C3-1.14TFT"
+ depends on IDF_TARGET_ESP32C3
+ config BOARD_TYPE_YUNLIAO_S3
+ bool "小智云聊-S3"
+ depends on IDF_TARGET_ESP32S3
+ config BOARD_TYPE_JINAO_S3
+ bool "极脑ESP32-S3开发板"
+ depends on IDF_TARGET_ESP32S3
+endchoice
+
+choice ESP_S3_LCD_EV_Board_Version_TYPE
+ depends on BOARD_TYPE_ESP_S3_LCD_EV_Board
+ prompt "EV_BOARD Type"
+ default ESP_S3_LCD_EV_Board_1p4
+ config ESP_S3_LCD_EV_Board_1p4
+ bool "乐鑫ESP32_S3_LCD_EV_Board-MB_V1.4"
+ config ESP_S3_LCD_EV_Board_1p5
+ bool "乐鑫ESP32_S3_LCD_EV_Board-MB_V1.5"
+endchoice
+
+choice DISPLAY_OLED_TYPE
+ depends on BOARD_TYPE_BREAD_COMPACT_WIFI || BOARD_TYPE_BREAD_COMPACT_ML307 || BOARD_TYPE_BREAD_COMPACT_ESP32
+ prompt "OLED Type"
+ default OLED_SSD1306_128X32
+ help
+ OLED Monochrome Display Type
+ config OLED_SSD1306_128X32
+ bool "SSD1306 128*32"
+ config OLED_SSD1306_128X64
+ bool "SSD1306 128*64"
+ config OLED_SH1106_128X64
+ bool "SH1106 128*64"
+endchoice
+
+choice DISPLAY_LCD_TYPE
+ depends on BOARD_TYPE_BREAD_COMPACT_WIFI_LCD || BOARD_TYPE_BREAD_COMPACT_ESP32_LCD || BOARD_TYPE_ESP32_CGC || BOARD_TYPE_ESP32P4_NANO || BOARD_TYPE_ESP32P4_WIFI6_Touch_LCD_XC || BOARD_TYPE_BREAD_COMPACT_WIFI_CAM
+ prompt "LCD Type"
+ default LCD_ST7789_240X320
+ help
+ LCD Display Type
+ config LCD_ST7789_240X320
+ bool "ST7789 240*320, IPS"
+ config LCD_ST7789_240X320_NO_IPS
+ bool "ST7789 240*320, Non-IPS"
+ config LCD_ST7789_170X320
+ bool "ST7789 170*320"
+ config LCD_ST7789_172X320
+ bool "ST7789 172*320"
+ config LCD_ST7789_240X280
+ bool "ST7789 240*280"
+ config LCD_ST7789_240X240
+ bool "ST7789 240*240"
+ config LCD_ST7789_240X240_7PIN
+ bool "ST7789 240*240, 7PIN"
+ config LCD_ST7789_240X135
+ bool "ST7789 240*135"
+ config LCD_ST7735_128X160
+ bool "ST7735 128*160"
+ config LCD_ST7735_128X128
+ bool "ST7735 128*128"
+ config LCD_ST7796_320X480
+ bool "ST7796 320*480 IPS"
+ config LCD_ST7796_320X480_NO_IPS
+ bool "ST7796 320*480, Non-IPS"
+ config LCD_ILI9341_240X320
+ bool "ILI9341 240*320"
+ config LCD_ILI9341_240X320_NO_IPS
+ bool "ILI9341 240*320, Non-IPS"
+ config LCD_GC9A01_240X240
+ bool "GC9A01 240*240 Circle"
+ config LCD_TYPE_800_1280_10_1_INCH
+ bool "Waveshare 101M-8001280-IPS-CT-K Display"
+ config LCD_TYPE_800_1280_10_1_INCH_A
+ bool "Waveshare 10.1-DSI-TOUCH-A Display"
+ config LCD_TYPE_800_800_3_4_INCH
+ bool "Waveshare ESP32-P4-WIFI6-Touch-LCD-3.4C with 800*800 3.4inch round display"
+ config LCD_TYPE_720_720_4_INCH
+ bool "Waveshare ESP32-P4-WIFI6-Touch-LCD-4C with 720*720 4inch round display"
+ config LCD_CUSTOM
+ bool "Custom LCD (自定义屏幕参数)"
+endchoice
+
+choice DISPLAY_ESP32S3_KORVO2_V3
+ depends on BOARD_TYPE_ESP32S3_KORVO2_V3
+ prompt "ESP32S3_KORVO2_V3 LCD Type"
+ default ESP32S3_KORVO2_V3_LCD_ST7789
+ help
+ LCD Display Type
+ config ESP32S3_KORVO2_V3_LCD_ST7789
+ bool "ST7789 240*280"
+ config ESP32S3_KORVO2_V3_LCD_ILI9341
+ bool "ILI9341 240*320"
+endchoice
+
+choice DISPLAY_ESP32S3_AUDIO_BOARD
+ depends on BOARD_TYPE_ESP32S3_AUDIO_BOARD
+ prompt "ESP32S3_AUDIO_BOARD LCD Type"
+ default AUDIO_BOARD_LCD_JD9853
+ help
+ LCD Display Type
+ config AUDIO_BOARD_LCD_JD9853
+ bool "JD9853 320*172"
+ config AUDIO_BOARD_LCD_ST7789
+ bool "ST7789 240*320"
+endchoice
+
+choice DISPLAY_STYLE
+ prompt "Select display style"
+ default USE_DEFAULT_MESSAGE_STYLE
+ help
+ Select display style for Xiaozhi device
+
+ config USE_DEFAULT_MESSAGE_STYLE
+ bool "Enable default message style"
+
+ config USE_WECHAT_MESSAGE_STYLE
+ bool "Enable WeChat Message Style"
+
+ config USE_EMOTE_MESSAGE_STYLE
+ bool "Emote animation style"
+ depends on BOARD_TYPE_ESP_BOX_3 || BOARD_TYPE_ECHOEAR
+endchoice
+
+choice WAKE_WORD_TYPE
+ prompt "Wake Word Implementation Type"
+ default USE_AFE_WAKE_WORD if (IDF_TARGET_ESP32S3 || IDF_TARGET_ESP32P4) && SPIRAM
+ default WAKE_WORD_DISABLED
+ help
+ Choose the type of wake word implementation to use
+
+ config WAKE_WORD_DISABLED
+ bool "Disabled"
+ help
+ Disable wake word detection
+
+ config USE_ESP_WAKE_WORD
+ bool "Wakenet model without AFE"
+ depends on IDF_TARGET_ESP32C3 || IDF_TARGET_ESP32C5 || IDF_TARGET_ESP32C6 || (IDF_TARGET_ESP32 && SPIRAM)
+ help
+ Support ESP32 C3、ESP32 C5 与 ESP32 C6, and (ESP32 with PSRAM)
+
+ config USE_AFE_WAKE_WORD
+ bool "Wakenet model with AFE"
+ depends on (IDF_TARGET_ESP32S3 || IDF_TARGET_ESP32P4) && SPIRAM
+ help
+ Support AEC if available, requires ESP32 S3 and PSRAM
+
+ config USE_CUSTOM_WAKE_WORD
+ bool "Multinet model (Custom Wake Word)"
+ depends on (IDF_TARGET_ESP32S3 || IDF_TARGET_ESP32P4) && SPIRAM
+ help
+ Requires ESP32 S3 and PSRAM
+
+endchoice
+
+config CUSTOM_WAKE_WORD
+ string "Custom Wake Word"
+ default "xiao tu dou"
+ depends on USE_CUSTOM_WAKE_WORD
+ help
+ Custom Wake Word, use pinyin for Chinese, separated by spaces
+
+config CUSTOM_WAKE_WORD_DISPLAY
+ string "Custom Wake Word Display"
+ default "小土豆"
+ depends on USE_CUSTOM_WAKE_WORD
+ help
+ Greeting sent to the server after wake word detection
+
+config CUSTOM_WAKE_WORD_THRESHOLD
+ int "Custom Wake Word Threshold (%)"
+ default 20
+ range 1 99
+ depends on USE_CUSTOM_WAKE_WORD
+ help
+ Custom Wake Word Threshold, range 1-99, the smaller the more sensitive, default 20
+
+config SEND_WAKE_WORD_DATA
+ bool "Send Wake Word Data"
+ default y
+ depends on USE_AFE_WAKE_WORD || USE_CUSTOM_WAKE_WORD
+ help
+ Send wake word data to the server as the first message of the conversation and wait for response
+
+config USE_AUDIO_PROCESSOR
+ bool "Enable Audio Noise Reduction"
+ default y
+ depends on (IDF_TARGET_ESP32S3 || IDF_TARGET_ESP32P4) && SPIRAM
+ help
+ Requires ESP32 S3 and PSRAM
+
+config USE_DEVICE_AEC
+ bool "Enable Device-Side AEC"
+ default n
+ depends on USE_AUDIO_PROCESSOR && (BOARD_TYPE_ESP_BOX_3 || BOARD_TYPE_ESP_BOX || BOARD_TYPE_ESP_BOX_LITE \
+ || BOARD_TYPE_LICHUANG_DEV || BOARD_TYPE_ESP32S3_KORVO2_V3 || BOARD_TYPE_ESP32S3_Touch_AMOLED_1_75 \
+ || BOARD_TYPE_ESP32S3_Touch_AMOLED_2_06 || BOARD_TYPE_ESP32S3_Touch_LCD_4B || BOARD_TYPE_ESP32P4_WIFI6_Touch_LCD_4B \
+ || BOARD_TYPE_ESP32P4_WIFI6_Touch_LCD_XC || BOARD_TYPE_ESP_S3_LCD_EV_Board_2 || BOARD_TYPE_YUNLIAO_S3 \
+ || BOARD_TYPE_ECHOEAR || BOARD_TYPE_ESP32S3_Touch_LCD_3_49)
+ help
+ To work properly, device-side AEC requires a clean output reference path from the speaker signal and physical acoustic isolation between the microphone and speaker.
+
+config USE_SERVER_AEC
+ bool "Enable Server-Side AEC (Unstable)"
+ default n
+ depends on USE_AUDIO_PROCESSOR
+ help
+ To work perperly, server-side AEC requires server support
+
+config USE_AUDIO_DEBUGGER
+ bool "Enable Audio Debugger"
+ default n
+ help
+ Enable audio debugger, send audio data through UDP to the host machine
+
+config AUDIO_DEBUG_UDP_SERVER
+ string "Audio Debug UDP Server Address"
+ default "192.168.2.100:8000"
+ depends on USE_AUDIO_DEBUGGER
+ help
+ UDP server address, format: IP:PORT, used to receive audio debugging data
+
+config USE_ACOUSTIC_WIFI_PROVISIONING
+ bool "Enable Acoustic WiFi Provisioning"
+ default n
+ help
+ Enable acoustic WiFi provisioning, use audio signal to transmit WiFi configuration data
+
+config RECEIVE_CUSTOM_MESSAGE
+ bool "Enable Custom Message Reception"
+ default n
+ help
+ Enable custom message reception, allow the device to receive custom messages from the server (preferably through the MQTT protocol)
+
+menu TAIJIPAI_S3_CONFIG
+ depends on BOARD_TYPE_ESP32S3_Taiji_Pi
+ choice I2S_TYPE_TAIJIPI_S3
+ prompt "taiji-pi-S3 I2S Type"
+ default TAIJIPAI_I2S_TYPE_STD
+ help
+ I2S 类型选择
+ config TAIJIPAI_I2S_TYPE_STD
+ bool "I2S Type STD"
+ config TAIJIPAI_I2S_TYPE_PDM
+ bool "I2S Type PDM"
+ endchoice
+
+ config I2S_USE_2SLOT
+ bool "Enable I2S 2 Slot"
+ default n
+ help
+ 启动双声道
+endmenu
+
+endmenu
diff --git a/main/alarm_manager.cc b/main/alarm_manager.cc
new file mode 100644
index 0000000..972f48e
--- /dev/null
+++ b/main/alarm_manager.cc
@@ -0,0 +1,671 @@
+#include "alarm_manager.h"
+#include
+#include
+#include
+#include
+#include
+#include
+#include
+#include
+
+#define TAG "AlarmManager"
+#define ALARM_SETTINGS_NAMESPACE "alarms"
+
+AlarmManager::AlarmManager()
+ : initialized_(false), next_alarm_id_(1),
+ default_snooze_minutes_(5), default_max_snooze_count_(3) {
+}
+
+AlarmManager::~AlarmManager() {
+ Cleanup();
+}
+
+void AlarmManager::Initialize() {
+ if (initialized_) {
+ return;
+ }
+
+ ESP_LOGI(TAG, "Initializing Alarm Manager");
+
+ // 初始化设置存储
+ settings_ = std::make_unique(ALARM_SETTINGS_NAMESPACE, true);
+
+ // 从存储中加载闹钟
+ LoadAlarmsFromStorage();
+
+ // 获取下一个闹钟ID
+ next_alarm_id_ = settings_->GetInt("next_id", 1);
+
+ initialized_ = true;
+ ESP_LOGI(TAG, "Alarm Manager initialized with %d alarms", alarms_.size());
+}
+
+void AlarmManager::Cleanup() {
+ if (!initialized_) {
+ return;
+ }
+
+ ESP_LOGI(TAG, "Cleaning up Alarm Manager");
+
+ // 停止所有活动的闹钟
+ StopAllActiveAlarms();
+
+ // 保存数据
+ SaveAlarmsToStorage();
+
+ // 清理资源
+ {
+ std::lock_guard lock(alarms_mutex_);
+ alarms_.clear();
+ }
+
+ settings_.reset();
+ initialized_ = false;
+}
+
+int AlarmManager::AddAlarm(int hour, int minute, AlarmRepeatMode repeat_mode,
+ const std::string& label, const std::string& music_name) {
+ if (!initialized_) {
+ ESP_LOGE(TAG, "AlarmManager not initialized");
+ return -1;
+ }
+
+ if (hour < 0 || hour > 23 || minute < 0 || minute > 59) {
+ ESP_LOGE(TAG, "Invalid time: %02d:%02d", hour, minute);
+ return -1;
+ }
+
+ std::lock_guard lock(alarms_mutex_);
+
+ auto alarm = std::make_unique();
+ alarm->id = GetNextAlarmId();
+ alarm->hour = hour;
+ alarm->minute = minute;
+ alarm->repeat_mode = repeat_mode;
+ alarm->label = label;
+ alarm->music_name = music_name;
+ alarm->status = kAlarmEnabled;
+ alarm->snooze_minutes = default_snooze_minutes_;
+ alarm->max_snooze_count = default_max_snooze_count_;
+
+ // 设置星期掩码
+ switch (repeat_mode) {
+ case kAlarmDaily:
+ alarm->weekdays_mask = 0b1111111; // 每天
+ break;
+ case kAlarmWeekdays:
+ alarm->weekdays_mask = 0b0111110; // 周一到周五
+ break;
+ case kAlarmWeekends:
+ alarm->weekdays_mask = 0b1000001; // 周六周日
+ break;
+ default:
+ alarm->weekdays_mask = 0; // 一次性或自定义
+ break;
+ }
+
+ int alarm_id = alarm->id;
+ alarms_.push_back(std::move(alarm));
+
+ // 保存到存储
+ SaveAlarmToStorage(*alarms_.back());
+ settings_->SetInt("next_id", next_alarm_id_);
+
+ ESP_LOGI(TAG, "Added alarm %d: %02d:%02d, repeat=%d, label='%s', music='%s'",
+ alarm_id, hour, minute, repeat_mode, label.c_str(), music_name.c_str());
+
+ return alarm_id;
+}
+
+bool AlarmManager::RemoveAlarm(int alarm_id) {
+ if (!initialized_) {
+ return false;
+ }
+
+ std::lock_guard lock(alarms_mutex_);
+
+ auto it = std::find_if(alarms_.begin(), alarms_.end(),
+ [alarm_id](const auto& alarm) { return alarm->id == alarm_id; });
+
+ if (it != alarms_.end()) {
+ ESP_LOGI(TAG, "Removing alarm %d", alarm_id);
+ alarms_.erase(it);
+ RemoveAlarmFromStorage(alarm_id);
+ return true;
+ }
+
+ ESP_LOGW(TAG, "Alarm %d not found for removal", alarm_id);
+ return false;
+}
+
+bool AlarmManager::EnableAlarm(int alarm_id, bool enabled) {
+ if (!initialized_) {
+ return false;
+ }
+
+ std::lock_guard lock(alarms_mutex_);
+
+ auto it = std::find_if(alarms_.begin(), alarms_.end(),
+ [alarm_id](const auto& alarm) { return alarm->id == alarm_id; });
+
+ if (it != alarms_.end()) {
+ (*it)->status = enabled ? kAlarmEnabled : kAlarmDisabled;
+ SaveAlarmToStorage(**it);
+ ESP_LOGI(TAG, "Alarm %d %s", alarm_id, enabled ? "enabled" : "disabled");
+ return true;
+ }
+
+ return false;
+}
+
+bool AlarmManager::ModifyAlarm(int alarm_id, int hour, int minute, AlarmRepeatMode repeat_mode,
+ const std::string& label, const std::string& music_name) {
+ if (!initialized_) {
+ return false;
+ }
+
+ if (hour < 0 || hour > 23 || minute < 0 || minute > 59) {
+ ESP_LOGE(TAG, "Invalid time: %02d:%02d", hour, minute);
+ return false;
+ }
+
+ std::lock_guard lock(alarms_mutex_);
+
+ auto it = std::find_if(alarms_.begin(), alarms_.end(),
+ [alarm_id](const auto& alarm) { return alarm->id == alarm_id; });
+
+ if (it != alarms_.end()) {
+ (*it)->hour = hour;
+ (*it)->minute = minute;
+ (*it)->repeat_mode = repeat_mode;
+ (*it)->label = label;
+ (*it)->music_name = music_name;
+
+ // 重新设置星期掩码
+ switch (repeat_mode) {
+ case kAlarmDaily:
+ (*it)->weekdays_mask = 0b1111111;
+ break;
+ case kAlarmWeekdays:
+ (*it)->weekdays_mask = 0b0111110;
+ break;
+ case kAlarmWeekends:
+ (*it)->weekdays_mask = 0b1000001;
+ break;
+ default:
+ break;
+ }
+
+ SaveAlarmToStorage(**it);
+ ESP_LOGI(TAG, "Modified alarm %d: %02d:%02d", alarm_id, hour, minute);
+ return true;
+ }
+
+ return false;
+}
+
+std::vector AlarmManager::GetAllAlarms() const {
+ if (!initialized_) {
+ return {};
+ }
+
+ std::lock_guard lock(alarms_mutex_);
+ std::vector result;
+
+ for (const auto& alarm : alarms_) {
+ result.push_back(*alarm);
+ }
+
+ return result;
+}
+
+AlarmItem* AlarmManager::GetAlarm(int alarm_id) {
+ if (!initialized_) {
+ return nullptr;
+ }
+
+ std::lock_guard lock(alarms_mutex_);
+
+ auto it = std::find_if(alarms_.begin(), alarms_.end(),
+ [alarm_id](const auto& alarm) { return alarm->id == alarm_id; });
+
+ return (it != alarms_.end()) ? it->get() : nullptr;
+}
+
+std::vector AlarmManager::GetActiveAlarms() const {
+ if (!initialized_) {
+ return {};
+ }
+
+ std::lock_guard lock(alarms_mutex_);
+ std::vector result;
+
+ for (const auto& alarm : alarms_) {
+ if (alarm->status == kAlarmTriggered || alarm->status == kAlarmSnoozed) {
+ result.push_back(*alarm);
+ }
+ }
+
+ return result;
+}
+
+std::string AlarmManager::GetNextAlarmInfo() const {
+ if (!initialized_) {
+ return "闹钟管理器未初始化";
+ }
+
+ std::lock_guard lock(alarms_mutex_);
+
+ // 查找下一个要触发的闹钟
+ AlarmItem* next_alarm = nullptr;
+ int64_t current_time = GetCurrentTimeInMinutes();
+ int current_weekday = GetCurrentWeekday();
+ int64_t min_time_diff = 24 * 60 * 7; // 一周的分钟数
+
+ for (const auto& alarm : alarms_) {
+ if (alarm->status != kAlarmEnabled) {
+ continue;
+ }
+
+ // 计算今天和明天的时间差
+ int64_t alarm_time = alarm->hour * 60 + alarm->minute;
+
+ for (int day_offset = 0; day_offset < 7; day_offset++) {
+ int check_weekday = (current_weekday + day_offset) % 7;
+
+ if (day_offset == 0 && alarm_time <= current_time) {
+ continue; // 今天已经过了
+ }
+
+ if (alarm->repeat_mode == kAlarmOnce && day_offset > 0) {
+ continue; // 一次性闹钟只检查今天
+ }
+
+ if (IsWeekdayActive(*alarm, check_weekday)) {
+ int64_t time_diff = day_offset * 24 * 60 + alarm_time - current_time;
+ if (day_offset == 0) {
+ time_diff = alarm_time - current_time;
+ }
+
+ if (time_diff < min_time_diff) {
+ min_time_diff = time_diff;
+ next_alarm = alarm.get();
+ }
+ break;
+ }
+ }
+ }
+
+ if (!next_alarm) {
+ return "无活动闹钟";
+ }
+
+ // 格式化下一个闹钟信息
+ std::ostringstream oss;
+ oss << "下个闹钟: " << FormatTime(next_alarm->hour, next_alarm->minute);
+
+ if (min_time_diff < 24 * 60) {
+ int hours = min_time_diff / 60;
+ int minutes = min_time_diff % 60;
+ if (hours > 0) {
+ oss << " (" << hours << "小时" << minutes << "分钟后)";
+ } else {
+ oss << " (" << minutes << "分钟后)";
+ }
+ } else {
+ int days = min_time_diff / (24 * 60);
+ oss << " (" << days << "天后)";
+ }
+
+ if (!next_alarm->label.empty()) {
+ oss << " - " << next_alarm->label;
+ }
+
+ return oss.str();
+}
+
+bool AlarmManager::SnoozeAlarm(int alarm_id) {
+ if (!initialized_) {
+ return false;
+ }
+
+ std::lock_guard lock(alarms_mutex_);
+
+ auto it = std::find_if(alarms_.begin(), alarms_.end(),
+ [alarm_id](const auto& alarm) { return alarm->id == alarm_id; });
+
+ if (it != alarms_.end() && (*it)->status == kAlarmTriggered) {
+ if ((*it)->snooze_count < (*it)->max_snooze_count) {
+ (*it)->status = kAlarmSnoozed;
+ (*it)->snooze_count++;
+ (*it)->next_snooze_time = esp_timer_get_time() / 1000000 + (*it)->snooze_minutes * 60;
+
+ ESP_LOGI(TAG, "Snoozed alarm %d for %d minutes (count: %d/%d)",
+ alarm_id, (*it)->snooze_minutes, (*it)->snooze_count, (*it)->max_snooze_count);
+
+ if (on_alarm_snoozed_) {
+ on_alarm_snoozed_(**it);
+ }
+ return true;
+ } else {
+ ESP_LOGI(TAG, "Alarm %d exceeded max snooze count, stopping", alarm_id);
+ StopAlarm(alarm_id);
+ }
+ }
+
+ return false;
+}
+
+bool AlarmManager::StopAlarm(int alarm_id) {
+ if (!initialized_) {
+ return false;
+ }
+
+ std::lock_guard lock(alarms_mutex_);
+
+ auto it = std::find_if(alarms_.begin(), alarms_.end(),
+ [alarm_id](const auto& alarm) { return alarm->id == alarm_id; });
+
+ if (it != alarms_.end() &&
+ ((*it)->status == kAlarmTriggered || (*it)->status == kAlarmSnoozed)) {
+
+ AlarmStatus old_status = (*it)->status;
+ (*it)->status = ((*it)->repeat_mode == kAlarmOnce) ? kAlarmDisabled : kAlarmEnabled;
+ (*it)->snooze_count = 0;
+ (*it)->next_snooze_time = 0;
+
+ ESP_LOGI(TAG, "Stopped alarm %d", alarm_id);
+
+ if (on_alarm_stopped_) {
+ on_alarm_stopped_(**it);
+ }
+
+ return true;
+ }
+
+ return false;
+}
+
+void AlarmManager::StopAllActiveAlarms() {
+ if (!initialized_) {
+ return;
+ }
+
+ std::lock_guard lock(alarms_mutex_);
+
+ for (auto& alarm : alarms_) {
+ if (alarm->status == kAlarmTriggered || alarm->status == kAlarmSnoozed) {
+ alarm->status = (alarm->repeat_mode == kAlarmOnce) ? kAlarmDisabled : kAlarmEnabled;
+ alarm->snooze_count = 0;
+ alarm->next_snooze_time = 0;
+
+ if (on_alarm_stopped_) {
+ on_alarm_stopped_(*alarm);
+ }
+ }
+ }
+
+ ESP_LOGI(TAG, "Stopped all active alarms");
+}
+
+void AlarmManager::CheckAlarms() {
+ if (!initialized_) {
+ return;
+ }
+
+ int64_t current_time_seconds = esp_timer_get_time() / 1000000;
+ int64_t current_time_minutes = GetCurrentTimeInMinutes();
+
+ std::lock_guard lock(alarms_mutex_);
+
+ for (auto& alarm : alarms_) {
+ // 检查贪睡闹钟
+ if (alarm->status == kAlarmSnoozed &&
+ current_time_seconds >= alarm->next_snooze_time) {
+
+ alarm->status = kAlarmTriggered;
+ alarm->next_snooze_time = 0;
+
+ ESP_LOGI(TAG, "Snooze ended for alarm %d, triggering again", alarm->id);
+
+ if (on_alarm_triggered_) {
+ on_alarm_triggered_(*alarm);
+ }
+ continue;
+ }
+
+ // 检查正常闹钟触发
+ if (alarm->status != kAlarmEnabled) {
+ continue;
+ }
+
+ int64_t alarm_time_minutes = alarm->hour * 60 + alarm->minute;
+
+ // 检查是否是触发时间(精确到分钟)
+ if (alarm_time_minutes != current_time_minutes) {
+ continue;
+ }
+
+ // 检查是否应该在今天触发
+ if (!ShouldTriggerToday(*alarm)) {
+ continue;
+ }
+
+ // 防止重复触发(同一分钟内)
+ int64_t current_time_in_seconds = esp_timer_get_time() / 1000000;
+ if (alarm->last_triggered_time > 0 &&
+ (current_time_in_seconds - alarm->last_triggered_time) < 60) {
+ continue;
+ }
+
+ // 触发闹钟
+ alarm->status = kAlarmTriggered;
+ alarm->last_triggered_time = current_time_in_seconds;
+ alarm->snooze_count = 0;
+
+ ESP_LOGI(TAG, "Triggering alarm %d: %02d:%02d - %s",
+ alarm->id, alarm->hour, alarm->minute, alarm->label.c_str());
+
+ if (on_alarm_triggered_) {
+ on_alarm_triggered_(*alarm);
+ }
+ }
+}
+
+void AlarmManager::SetAlarmTriggeredCallback(AlarmTriggeredCallback callback) {
+ on_alarm_triggered_ = callback;
+}
+
+void AlarmManager::SetAlarmSnoozeCallback(AlarmSnoozeCallback callback) {
+ on_alarm_snoozed_ = callback;
+}
+
+void AlarmManager::SetAlarmStopCallback(AlarmStopCallback callback) {
+ on_alarm_stopped_ = callback;
+}
+
+void AlarmManager::SetDefaultSnoozeMinutes(int minutes) {
+ default_snooze_minutes_ = std::max(1, std::min(60, minutes));
+}
+
+void AlarmManager::SetDefaultMaxSnoozeCount(int count) {
+ default_max_snooze_count_ = std::max(0, std::min(10, count));
+}
+
+// 静态工具方法
+std::string AlarmManager::FormatTime(int hour, int minute) {
+ std::ostringstream oss;
+ oss << std::setfill('0') << std::setw(2) << hour
+ << ":" << std::setfill('0') << std::setw(2) << minute;
+ return oss.str();
+}
+
+std::string AlarmManager::FormatAlarmTime(const AlarmItem& alarm) {
+ std::ostringstream oss;
+ oss << FormatTime(alarm.hour, alarm.minute);
+
+ switch (alarm.repeat_mode) {
+ case kAlarmOnce:
+ oss << " (一次)";
+ break;
+ case kAlarmDaily:
+ oss << " (每日)";
+ break;
+ case kAlarmWeekdays:
+ oss << " (工作日)";
+ break;
+ case kAlarmWeekends:
+ oss << " (周末)";
+ break;
+ case kAlarmCustom:
+ oss << " (自定义)";
+ break;
+ }
+
+ return oss.str();
+}
+
+bool AlarmManager::IsWeekdayActive(const AlarmItem& alarm, int weekday) {
+ if (alarm.repeat_mode == kAlarmOnce) {
+ return true; // 一次性闹钟在任何一天都可以触发
+ }
+
+ return (alarm.weekdays_mask & (1 << weekday)) != 0;
+}
+
+// 私有方法实现
+void AlarmManager::LoadAlarmsFromStorage() {
+ std::lock_guard lock(alarms_mutex_);
+ alarms_.clear();
+
+ // 读取闹钟数量
+ int alarm_count = settings_->GetInt("count", 0);
+ ESP_LOGI(TAG, "Loading %d alarms from storage", alarm_count);
+
+ for (int i = 0; i < alarm_count; i++) {
+ std::string alarm_key = "alarm_" + std::to_string(i);
+ std::string alarm_json = settings_->GetString(alarm_key);
+
+ if (alarm_json.empty()) {
+ continue;
+ }
+
+ cJSON* json = cJSON_Parse(alarm_json.c_str());
+ if (!json) {
+ ESP_LOGW(TAG, "Failed to parse alarm JSON: %s", alarm_key.c_str());
+ continue;
+ }
+
+ auto alarm = std::make_unique();
+
+ // 解析JSON数据
+ if (auto id = cJSON_GetObjectItem(json, "id")) alarm->id = id->valueint;
+ if (auto hour = cJSON_GetObjectItem(json, "hour")) alarm->hour = hour->valueint;
+ if (auto minute = cJSON_GetObjectItem(json, "minute")) alarm->minute = minute->valueint;
+ if (auto repeat = cJSON_GetObjectItem(json, "repeat")) alarm->repeat_mode = (AlarmRepeatMode)repeat->valueint;
+ if (auto mask = cJSON_GetObjectItem(json, "weekdays")) alarm->weekdays_mask = mask->valueint;
+ if (auto status = cJSON_GetObjectItem(json, "status")) alarm->status = (AlarmStatus)status->valueint;
+ if (auto label = cJSON_GetObjectItem(json, "label")) alarm->label = label->valuestring;
+ if (auto music = cJSON_GetObjectItem(json, "music")) alarm->music_name = music->valuestring;
+ if (auto snooze_min = cJSON_GetObjectItem(json, "snooze_minutes")) alarm->snooze_minutes = snooze_min->valueint;
+ if (auto max_snooze = cJSON_GetObjectItem(json, "max_snooze")) alarm->max_snooze_count = max_snooze->valueint;
+
+ // 重置运行时状态
+ alarm->snooze_count = 0;
+ alarm->last_triggered_time = 0;
+ alarm->next_snooze_time = 0;
+ if (alarm->status == kAlarmTriggered || alarm->status == kAlarmSnoozed) {
+ alarm->status = kAlarmEnabled;
+ }
+
+ alarms_.push_back(std::move(alarm));
+ cJSON_Delete(json);
+ }
+
+ ESP_LOGI(TAG, "Loaded %d alarms successfully", alarms_.size());
+}
+
+void AlarmManager::SaveAlarmsToStorage() {
+ if (!settings_) {
+ return;
+ }
+
+ std::lock_guard lock(alarms_mutex_);
+
+ // 保存闹钟数量
+ settings_->SetInt("count", alarms_.size());
+
+ // 保存每个闹钟
+ for (size_t i = 0; i < alarms_.size(); i++) {
+ std::string alarm_key = "alarm_" + std::to_string(i);
+ SaveAlarmToStorage(*alarms_[i]);
+ }
+
+ ESP_LOGI(TAG, "Saved %d alarms to storage", alarms_.size());
+}
+
+void AlarmManager::SaveAlarmToStorage(const AlarmItem& alarm) {
+ if (!settings_) {
+ return;
+ }
+
+ cJSON* json = cJSON_CreateObject();
+
+ cJSON_AddNumberToObject(json, "id", alarm.id);
+ cJSON_AddNumberToObject(json, "hour", alarm.hour);
+ cJSON_AddNumberToObject(json, "minute", alarm.minute);
+ cJSON_AddNumberToObject(json, "repeat", alarm.repeat_mode);
+ cJSON_AddNumberToObject(json, "weekdays", alarm.weekdays_mask);
+ cJSON_AddNumberToObject(json, "status", alarm.status);
+ cJSON_AddStringToObject(json, "label", alarm.label.c_str());
+ cJSON_AddStringToObject(json, "music", alarm.music_name.c_str());
+ cJSON_AddNumberToObject(json, "snooze_minutes", alarm.snooze_minutes);
+ cJSON_AddNumberToObject(json, "max_snooze", alarm.max_snooze_count);
+
+ char* json_string = cJSON_PrintUnformatted(json);
+
+ // 找到这个闹钟在数组中的位置
+ auto it = std::find_if(alarms_.begin(), alarms_.end(),
+ [&alarm](const auto& a) { return a->id == alarm.id; });
+
+ if (it != alarms_.end()) {
+ size_t index = std::distance(alarms_.begin(), it);
+ std::string alarm_key = "alarm_" + std::to_string(index);
+ settings_->SetString(alarm_key, json_string);
+ }
+
+ cJSON_free(json_string);
+ cJSON_Delete(json);
+}
+
+void AlarmManager::RemoveAlarmFromStorage(int alarm_id) {
+ // 重新保存所有闹钟(简单实现)
+ SaveAlarmsToStorage();
+}
+
+int AlarmManager::GetNextAlarmId() {
+ return next_alarm_id_++;
+}
+
+bool AlarmManager::ShouldTriggerToday(const AlarmItem& alarm) const {
+ if (alarm.repeat_mode == kAlarmOnce) {
+ return true;
+ }
+
+ int weekday = GetCurrentWeekday();
+ return IsWeekdayActive(alarm, weekday);
+}
+
+int64_t AlarmManager::GetCurrentTimeInMinutes() const {
+ time_t now;
+ time(&now);
+ struct tm* timeinfo = localtime(&now);
+ return timeinfo->tm_hour * 60 + timeinfo->tm_min;
+}
+
+int AlarmManager::GetCurrentWeekday() const {
+ time_t now;
+ time(&now);
+ struct tm* timeinfo = localtime(&now);
+ return timeinfo->tm_wday; // 0=周日, 1=周一, ..., 6=周六
+}
diff --git a/main/alarm_manager.h b/main/alarm_manager.h
new file mode 100644
index 0000000..81fcdbc
--- /dev/null
+++ b/main/alarm_manager.h
@@ -0,0 +1,140 @@
+#ifndef ALARM_MANAGER_H
+#define ALARM_MANAGER_H
+
+#include
+#include
+#include
+#include
+#include
+#include "settings.h"
+
+// 闹钟重复模式
+enum AlarmRepeatMode {
+ kAlarmOnce = 0, // 一次性闹钟
+ kAlarmDaily = 1, // 每日重复
+ kAlarmWeekdays = 2, // 工作日(周一到周五)
+ kAlarmWeekends = 3, // 周末(周六周日)
+ kAlarmCustom = 4 // 自定义星期(使用weekdays_mask)
+};
+
+// 闹钟状态
+enum AlarmStatus {
+ kAlarmEnabled = 0, // 启用
+ kAlarmDisabled = 1, // 禁用
+ kAlarmTriggered = 2, // 已触发(等待贪睡或关闭)
+ kAlarmSnoozed = 3 // 贪睡中
+};
+
+// 闹钟项结构
+struct AlarmItem {
+ int id; // 闹钟ID
+ int hour; // 小时 (0-23)
+ int minute; // 分钟 (0-59)
+ AlarmRepeatMode repeat_mode; // 重复模式
+ uint8_t weekdays_mask; // 星期掩码 (bit0=周日, bit1=周一, ..., bit6=周六)
+ AlarmStatus status; // 闹钟状态
+ std::string label; // 闹钟标签/备注
+ std::string music_name; // 指定的音乐名称(空则使用默认铃声)
+ int snooze_count; // 当前贪睡次数
+ int max_snooze_count; // 最大贪睡次数 (默认3次)
+ int snooze_minutes; // 贪睡间隔(分钟,默认5分钟)
+ int64_t last_triggered_time; // 上次触发时间戳(避免重复触发)
+ int64_t next_snooze_time; // 下次贪睡时间戳
+
+ AlarmItem() : id(0), hour(0), minute(0), repeat_mode(kAlarmOnce),
+ weekdays_mask(0), status(kAlarmEnabled), label(""),
+ music_name(""), snooze_count(0), max_snooze_count(3),
+ snooze_minutes(5), last_triggered_time(0), next_snooze_time(0) {}
+};
+
+// 闹钟触发回调类型
+using AlarmTriggeredCallback = std::function;
+using AlarmSnoozeCallback = std::function;
+using AlarmStopCallback = std::function;
+
+class AlarmManager {
+public:
+ static AlarmManager& GetInstance() {
+ static AlarmManager instance;
+ return instance;
+ }
+
+ // 删除拷贝构造函数和赋值运算符
+ AlarmManager(const AlarmManager&) = delete;
+ AlarmManager& operator=(const AlarmManager&) = delete;
+
+ // 初始化和清理
+ void Initialize();
+ void Cleanup();
+
+ // 闹钟管理
+ int AddAlarm(int hour, int minute, AlarmRepeatMode repeat_mode = kAlarmOnce,
+ const std::string& label = "", const std::string& music_name = "");
+ bool RemoveAlarm(int alarm_id);
+ bool EnableAlarm(int alarm_id, bool enabled = true);
+ bool ModifyAlarm(int alarm_id, int hour, int minute, AlarmRepeatMode repeat_mode = kAlarmOnce,
+ const std::string& label = "", const std::string& music_name = "");
+
+ // 查询功能
+ std::vector GetAllAlarms() const;
+ AlarmItem* GetAlarm(int alarm_id);
+ std::vector GetActiveAlarms() const;
+ std::string GetNextAlarmInfo() const; // 获取下一个闹钟的信息字符串
+
+ // 贪睡和停止
+ bool SnoozeAlarm(int alarm_id);
+ bool StopAlarm(int alarm_id);
+ void StopAllActiveAlarms();
+
+ // 时间检查 (由Application的CLOCK_TICK调用)
+ void CheckAlarms();
+
+ // 回调设置
+ void SetAlarmTriggeredCallback(AlarmTriggeredCallback callback);
+ void SetAlarmSnoozeCallback(AlarmSnoozeCallback callback);
+ void SetAlarmStopCallback(AlarmStopCallback callback);
+
+ // 配置设置
+ void SetDefaultSnoozeMinutes(int minutes);
+ void SetDefaultMaxSnoozeCount(int count);
+
+ // 时间工具
+ static std::string FormatTime(int hour, int minute);
+ static std::string FormatAlarmTime(const AlarmItem& alarm);
+ static bool IsWeekdayActive(const AlarmItem& alarm, int weekday); // 0=周日, 1=周一, ..., 6=周六
+
+private:
+ AlarmManager();
+ ~AlarmManager();
+
+ // 内部方法
+ void LoadAlarmsFromStorage();
+ void SaveAlarmsToStorage();
+ void SaveAlarmToStorage(const AlarmItem& alarm);
+ void RemoveAlarmFromStorage(int alarm_id);
+
+ int GetNextAlarmId();
+ bool ShouldTriggerToday(const AlarmItem& alarm) const;
+ int64_t GetCurrentTimeInMinutes() const; // 获取当前时间的分钟数(从午夜开始)
+ int GetCurrentWeekday() const; // 获取当前星期几
+
+ // 成员变量
+ std::vector> alarms_;
+ std::unique_ptr settings_;
+ bool initialized_;
+ int next_alarm_id_;
+
+ // 配置
+ int default_snooze_minutes_;
+ int default_max_snooze_count_;
+
+ // 回调函数
+ AlarmTriggeredCallback on_alarm_triggered_;
+ AlarmSnoozeCallback on_alarm_snoozed_;
+ AlarmStopCallback on_alarm_stopped_;
+
+ // 互斥锁保护
+ mutable std::mutex alarms_mutex_;
+};
+
+#endif // ALARM_MANAGER_H
diff --git a/main/application.cc b/main/application.cc
index b2381d8..e5e9a30 100644
--- a/main/application.cc
+++ b/main/application.cc
@@ -1,984 +1,1222 @@
-#include "application.h"
-#include "board.h"
-#include "display.h"
-#include "system_info.h"
-#include "audio_codec.h"
-#include "mqtt_protocol.h"
-#include "websocket_protocol.h"
-#include "assets/lang_config.h"
-#include "mcp_server.h"
-#include "assets.h"
-#include "settings.h"
-
-#include
-#include
-#include
-#include
-#include
-#include
-
-#define TAG "Application"
-
-
-static const char* const STATE_STRINGS[] = {
- "unknown",
- "starting",
- "configuring",
- "idle",
- "connecting",
- "listening",
- "speaking",
- "upgrading",
- "activating",
- "audio_testing",
- "fatal_error",
- "invalid_state"
-};
-
-Application::Application() {
- event_group_ = xEventGroupCreate();
-
-#if CONFIG_USE_DEVICE_AEC && CONFIG_USE_SERVER_AEC
-#error "CONFIG_USE_DEVICE_AEC and CONFIG_USE_SERVER_AEC cannot be enabled at the same time"
-#elif CONFIG_USE_DEVICE_AEC
- aec_mode_ = kAecOnDeviceSide;
-#elif CONFIG_USE_SERVER_AEC
- aec_mode_ = kAecOnServerSide;
-#else
- aec_mode_ = kAecOff;
-#endif
-
- esp_timer_create_args_t clock_timer_args = {
- .callback = [](void* arg) {
- Application* app = (Application*)arg;
- xEventGroupSetBits(app->event_group_, MAIN_EVENT_CLOCK_TICK);
- },
- .arg = this,
- .dispatch_method = ESP_TIMER_TASK,
- .name = "clock_timer",
- .skip_unhandled_events = true
- };
- esp_timer_create(&clock_timer_args, &clock_timer_handle_);
-}
-
-Application::~Application() {
- if (clock_timer_handle_ != nullptr) {
- esp_timer_stop(clock_timer_handle_);
- esp_timer_delete(clock_timer_handle_);
- }
- vEventGroupDelete(event_group_);
-}
-
-void Application::CheckAssetsVersion() {
- auto& board = Board::GetInstance();
- auto display = board.GetDisplay();
- auto assets = board.GetAssets();
- if (!assets) {
- ESP_LOGE(TAG, "Assets is not set for board %s", BOARD_NAME);
- return;
- }
-
- if (!assets->partition_valid()) {
- ESP_LOGE(TAG, "Assets partition is not valid for board %s", BOARD_NAME);
- return;
- }
-
- Settings settings("assets", true);
- // Check if there is a new assets need to be downloaded
- std::string download_url = settings.GetString("download_url");
- if (!download_url.empty()) {
- settings.EraseKey("download_url");
- }
- if (download_url.empty() && !assets->checksum_valid()) {
- download_url = assets->default_assets_url();
- }
-
- if (!download_url.empty()) {
- char message[256];
- snprintf(message, sizeof(message), Lang::Strings::FOUND_NEW_ASSETS, download_url.c_str());
- Alert(Lang::Strings::LOADING_ASSETS, message, "cloud_arrow_down", Lang::Sounds::OGG_UPGRADE);
-
- // Wait for the audio service to be idle for 3 seconds
- vTaskDelay(pdMS_TO_TICKS(3000));
- SetDeviceState(kDeviceStateUpgrading);
- board.SetPowerSaveMode(false);
- display->SetChatMessage("system", Lang::Strings::PLEASE_WAIT);
-
- bool success = assets->Download(download_url, [display](int progress, size_t speed) -> void {
- std::thread([display, progress, speed]() {
- char buffer[32];
- snprintf(buffer, sizeof(buffer), "%d%% %uKB/s", progress, speed / 1024);
- display->SetChatMessage("system", buffer);
- }).detach();
- });
-
- board.SetPowerSaveMode(true);
- vTaskDelay(pdMS_TO_TICKS(1000));
-
- if (!success) {
- Alert(Lang::Strings::ERROR, Lang::Strings::DOWNLOAD_ASSETS_FAILED, "circle_xmark", Lang::Sounds::OGG_EXCLAMATION);
- vTaskDelay(pdMS_TO_TICKS(2000));
- return;
- }
- }
-
- // Apply assets
- assets->Apply();
- display->SetChatMessage("system", "");
- display->SetEmotion("microchip_ai");
-}
-
-void Application::CheckNewVersion(Ota& ota) {
- const int MAX_RETRY = 10;
- int retry_count = 0;
- int retry_delay = 10; // 初始重试延迟为10秒
-
- auto& board = Board::GetInstance();
- while (true) {
- SetDeviceState(kDeviceStateActivating);
- auto display = board.GetDisplay();
- display->SetStatus(Lang::Strings::CHECKING_NEW_VERSION);
-
- if (!ota.CheckVersion()) {
- retry_count++;
- if (retry_count >= MAX_RETRY) {
- ESP_LOGE(TAG, "Too many retries, exit version check");
- return;
- }
-
- char buffer[256];
- snprintf(buffer, sizeof(buffer), Lang::Strings::CHECK_NEW_VERSION_FAILED, retry_delay, ota.GetCheckVersionUrl().c_str());
- Alert(Lang::Strings::ERROR, buffer, "cloud_slash", Lang::Sounds::OGG_EXCLAMATION);
-
- ESP_LOGW(TAG, "Check new version failed, retry in %d seconds (%d/%d)", retry_delay, retry_count, MAX_RETRY);
- for (int i = 0; i < retry_delay; i++) {
- vTaskDelay(pdMS_TO_TICKS(1000));
- if (device_state_ == kDeviceStateIdle) {
- break;
- }
- }
- retry_delay *= 2; // 每次重试后延迟时间翻倍
- continue;
- }
- retry_count = 0;
- retry_delay = 10; // 重置重试延迟时间
-
- if (ota.HasNewVersion()) {
- if (UpgradeFirmware(ota)) {
- return; // This line will never be reached after reboot
- }
- // If upgrade failed, continue to normal operation (don't break, just fall through)
- }
-
- // No new version, mark the current version as valid
- ota.MarkCurrentVersionValid();
- if (!ota.HasActivationCode() && !ota.HasActivationChallenge()) {
- xEventGroupSetBits(event_group_, MAIN_EVENT_CHECK_NEW_VERSION_DONE);
- // Exit the loop if done checking new version
- break;
- }
-
- display->SetStatus(Lang::Strings::ACTIVATION);
- // Activation code is shown to the user and waiting for the user to input
- if (ota.HasActivationCode()) {
- ShowActivationCode(ota.GetActivationCode(), ota.GetActivationMessage());
- }
-
- // This will block the loop until the activation is done or timeout
- for (int i = 0; i < 10; ++i) {
- ESP_LOGI(TAG, "Activating... %d/%d", i + 1, 10);
- esp_err_t err = ota.Activate();
- if (err == ESP_OK) {
- xEventGroupSetBits(event_group_, MAIN_EVENT_CHECK_NEW_VERSION_DONE);
- break;
- } else if (err == ESP_ERR_TIMEOUT) {
- vTaskDelay(pdMS_TO_TICKS(3000));
- } else {
- vTaskDelay(pdMS_TO_TICKS(10000));
- }
- if (device_state_ == kDeviceStateIdle) {
- break;
- }
- }
- }
-}
-
-void Application::ShowActivationCode(const std::string& code, const std::string& message) {
- struct digit_sound {
- char digit;
- const std::string_view& sound;
- };
- static const std::array digit_sounds{{
- digit_sound{'0', Lang::Sounds::OGG_0},
- digit_sound{'1', Lang::Sounds::OGG_1},
- digit_sound{'2', Lang::Sounds::OGG_2},
- digit_sound{'3', Lang::Sounds::OGG_3},
- digit_sound{'4', Lang::Sounds::OGG_4},
- digit_sound{'5', Lang::Sounds::OGG_5},
- digit_sound{'6', Lang::Sounds::OGG_6},
- digit_sound{'7', Lang::Sounds::OGG_7},
- digit_sound{'8', Lang::Sounds::OGG_8},
- digit_sound{'9', Lang::Sounds::OGG_9}
- }};
-
- // This sentence uses 9KB of SRAM, so we need to wait for it to finish
- Alert(Lang::Strings::ACTIVATION, message.c_str(), "link", Lang::Sounds::OGG_ACTIVATION);
-
- for (const auto& digit : code) {
- auto it = std::find_if(digit_sounds.begin(), digit_sounds.end(),
- [digit](const digit_sound& ds) { return ds.digit == digit; });
- if (it != digit_sounds.end()) {
- audio_service_.PlaySound(it->sound);
- }
- }
-}
-
-void Application::Alert(const char* status, const char* message, const char* emotion, const std::string_view& sound) {
- ESP_LOGW(TAG, "Alert [%s] %s: %s", emotion, status, message);
- auto display = Board::GetInstance().GetDisplay();
- display->SetStatus(status);
- display->SetEmotion(emotion);
- display->SetChatMessage("system", message);
- if (!sound.empty()) {
- audio_service_.PlaySound(sound);
- }
-}
-
-void Application::DismissAlert() {
- if (device_state_ == kDeviceStateIdle) {
- auto display = Board::GetInstance().GetDisplay();
- display->SetStatus(Lang::Strings::STANDBY);
- display->SetEmotion("neutral");
- display->SetChatMessage("system", "");
- }
-}
-
-void Application::ToggleChatState() {
- if (device_state_ == kDeviceStateActivating) {
- SetDeviceState(kDeviceStateIdle);
- return;
- } else if (device_state_ == kDeviceStateWifiConfiguring) {
- audio_service_.EnableAudioTesting(true);
- SetDeviceState(kDeviceStateAudioTesting);
- return;
- } else if (device_state_ == kDeviceStateAudioTesting) {
- audio_service_.EnableAudioTesting(false);
- SetDeviceState(kDeviceStateWifiConfiguring);
- return;
- }
-
- if (!protocol_) {
- ESP_LOGE(TAG, "Protocol not initialized");
- return;
- }
-
- if (device_state_ == kDeviceStateIdle) {
- Schedule([this]() {
- if (!protocol_->IsAudioChannelOpened()) {
- SetDeviceState(kDeviceStateConnecting);
- if (!protocol_->OpenAudioChannel()) {
- return;
- }
- }
-
- SetListeningMode(aec_mode_ == kAecOff ? kListeningModeAutoStop : kListeningModeRealtime);
- });
- } else if (device_state_ == kDeviceStateSpeaking) {
- Schedule([this]() {
- AbortSpeaking(kAbortReasonNone);
- });
- } else if (device_state_ == kDeviceStateListening) {
- Schedule([this]() {
- protocol_->CloseAudioChannel();
- });
- }
-}
-
-void Application::StartListening() {
- if (device_state_ == kDeviceStateActivating) {
- SetDeviceState(kDeviceStateIdle);
- return;
- } else if (device_state_ == kDeviceStateWifiConfiguring) {
- audio_service_.EnableAudioTesting(true);
- SetDeviceState(kDeviceStateAudioTesting);
- return;
- }
-
- if (!protocol_) {
- ESP_LOGE(TAG, "Protocol not initialized");
- return;
- }
-
- if (device_state_ == kDeviceStateIdle) {
- Schedule([this]() {
- if (!protocol_->IsAudioChannelOpened()) {
- SetDeviceState(kDeviceStateConnecting);
- if (!protocol_->OpenAudioChannel()) {
- return;
- }
- }
-
- SetListeningMode(kListeningModeManualStop);
- });
- } else if (device_state_ == kDeviceStateSpeaking) {
- Schedule([this]() {
- AbortSpeaking(kAbortReasonNone);
- SetListeningMode(kListeningModeManualStop);
- });
- }
-}
-
-void Application::StopListening() {
- if (device_state_ == kDeviceStateAudioTesting) {
- audio_service_.EnableAudioTesting(false);
- SetDeviceState(kDeviceStateWifiConfiguring);
- return;
- }
-
- const std::array valid_states = {
- kDeviceStateListening,
- kDeviceStateSpeaking,
- kDeviceStateIdle,
- };
- // If not valid, do nothing
- if (std::find(valid_states.begin(), valid_states.end(), device_state_) == valid_states.end()) {
- return;
- }
-
- Schedule([this]() {
- if (device_state_ == kDeviceStateListening) {
- protocol_->SendStopListening();
- SetDeviceState(kDeviceStateIdle);
- }
- });
-}
-
-void Application::Start() {
- auto& board = Board::GetInstance();
- SetDeviceState(kDeviceStateStarting);
-
- /* Setup the display */
- auto display = board.GetDisplay();
-
- /* Setup the audio service */
- auto codec = board.GetAudioCodec();
- audio_service_.Initialize(codec);
- audio_service_.Start();
-
- AudioServiceCallbacks callbacks;
- callbacks.on_send_queue_available = [this]() {
- xEventGroupSetBits(event_group_, MAIN_EVENT_SEND_AUDIO);
- };
- callbacks.on_wake_word_detected = [this](const std::string& wake_word) {
- xEventGroupSetBits(event_group_, MAIN_EVENT_WAKE_WORD_DETECTED);
- };
- callbacks.on_vad_change = [this](bool speaking) {
- xEventGroupSetBits(event_group_, MAIN_EVENT_VAD_CHANGE);
- };
- audio_service_.SetCallbacks(callbacks);
-
- /* Start the clock timer to update the status bar */
- esp_timer_start_periodic(clock_timer_handle_, 1000000);
-
- /* Wait for the network to be ready */
- board.StartNetwork();
-
- // Update the status bar immediately to show the network state
- display->UpdateStatusBar(true);
-
- // Check for new assets version
- CheckAssetsVersion();
-
- // Check for new firmware version or get the MQTT broker address
- Ota ota;
- CheckNewVersion(ota);
-
- // Initialize the protocol
- display->SetStatus(Lang::Strings::LOADING_PROTOCOL);
-
- // Add MCP common tools before initializing the protocol
- auto& mcp_server = McpServer::GetInstance();
- mcp_server.AddCommonTools();
- mcp_server.AddUserOnlyTools();
-
- if (ota.HasMqttConfig()) {
- protocol_ = std::make_unique();
- } else if (ota.HasWebsocketConfig()) {
- protocol_ = std::make_unique();
- } else {
- ESP_LOGW(TAG, "No protocol specified in the OTA config, using MQTT");
- protocol_ = std::make_unique();
- }
-
- protocol_->OnConnected([this]() {
- DismissAlert();
- });
-
- protocol_->OnNetworkError([this](const std::string& message) {
- last_error_message_ = message;
- xEventGroupSetBits(event_group_, MAIN_EVENT_ERROR);
- });
- protocol_->OnIncomingAudio([this](std::unique_ptr packet) {
- if (device_state_ == kDeviceStateSpeaking) {
- audio_service_.PushPacketToDecodeQueue(std::move(packet));
- }
- });
- protocol_->OnAudioChannelOpened([this, codec, &board]() {
- board.SetPowerSaveMode(false);
- if (protocol_->server_sample_rate() != codec->output_sample_rate()) {
- ESP_LOGW(TAG, "Server sample rate %d does not match device output sample rate %d, resampling may cause distortion",
- protocol_->server_sample_rate(), codec->output_sample_rate());
- }
- });
- protocol_->OnAudioChannelClosed([this, &board]() {
- board.SetPowerSaveMode(true);
- Schedule([this]() {
- auto display = Board::GetInstance().GetDisplay();
- display->SetChatMessage("system", "");
- SetDeviceState(kDeviceStateIdle);
- });
- });
- protocol_->OnIncomingJson([this, display](const cJSON* root) {
- // Parse JSON data
- auto type = cJSON_GetObjectItem(root, "type");
- if (strcmp(type->valuestring, "tts") == 0) {
- auto state = cJSON_GetObjectItem(root, "state");
- if (strcmp(state->valuestring, "start") == 0) {
- Schedule([this]() {
- aborted_ = false;
- if (device_state_ == kDeviceStateIdle || device_state_ == kDeviceStateListening) {
- SetDeviceState(kDeviceStateSpeaking);
- }
- });
- } else if (strcmp(state->valuestring, "stop") == 0) {
- Schedule([this]() {
- if (device_state_ == kDeviceStateSpeaking) {
- if (listening_mode_ == kListeningModeManualStop) {
- SetDeviceState(kDeviceStateIdle);
- } else {
- SetDeviceState(kDeviceStateListening);
- }
- }
- });
- } else if (strcmp(state->valuestring, "sentence_start") == 0) {
- auto text = cJSON_GetObjectItem(root, "text");
- if (cJSON_IsString(text)) {
- ESP_LOGI(TAG, "<< %s", text->valuestring);
- Schedule([this, display, message = std::string(text->valuestring)]() {
- display->SetChatMessage("assistant", message.c_str());
- });
- }
- }
- } else if (strcmp(type->valuestring, "stt") == 0) {
- auto text = cJSON_GetObjectItem(root, "text");
- if (cJSON_IsString(text)) {
- ESP_LOGI(TAG, ">> %s", text->valuestring);
- Schedule([this, display, message = std::string(text->valuestring)]() {
- display->SetChatMessage("user", message.c_str());
- });
- }
- } else if (strcmp(type->valuestring, "llm") == 0) {
- auto emotion = cJSON_GetObjectItem(root, "emotion");
- if (cJSON_IsString(emotion)) {
- Schedule([this, display, emotion_str = std::string(emotion->valuestring)]() {
- display->SetEmotion(emotion_str.c_str());
- });
- }
- } else if (strcmp(type->valuestring, "mcp") == 0) {
- auto payload = cJSON_GetObjectItem(root, "payload");
- if (cJSON_IsObject(payload)) {
- McpServer::GetInstance().ParseMessage(payload);
- }
- } else if (strcmp(type->valuestring, "system") == 0) {
- auto command = cJSON_GetObjectItem(root, "command");
- if (cJSON_IsString(command)) {
- ESP_LOGI(TAG, "System command: %s", command->valuestring);
- if (strcmp(command->valuestring, "reboot") == 0) {
- // Do a reboot if user requests a OTA update
- Schedule([this]() {
- Reboot();
- });
- } else {
- ESP_LOGW(TAG, "Unknown system command: %s", command->valuestring);
- }
- }
- } else if (strcmp(type->valuestring, "alert") == 0) {
- auto status = cJSON_GetObjectItem(root, "status");
- auto message = cJSON_GetObjectItem(root, "message");
- auto emotion = cJSON_GetObjectItem(root, "emotion");
- if (cJSON_IsString(status) && cJSON_IsString(message) && cJSON_IsString(emotion)) {
- Alert(status->valuestring, message->valuestring, emotion->valuestring, Lang::Sounds::OGG_VIBRATION);
- } else {
- ESP_LOGW(TAG, "Alert command requires status, message and emotion");
- }
-#if CONFIG_RECEIVE_CUSTOM_MESSAGE
- } else if (strcmp(type->valuestring, "custom") == 0) {
- auto payload = cJSON_GetObjectItem(root, "payload");
- ESP_LOGI(TAG, "Received custom message: %s", cJSON_PrintUnformatted(root));
- if (cJSON_IsObject(payload)) {
- Schedule([this, display, payload_str = std::string(cJSON_PrintUnformatted(payload))]() {
- display->SetChatMessage("system", payload_str.c_str());
- });
- } else {
- ESP_LOGW(TAG, "Invalid custom message format: missing payload");
- }
-#endif
- } else {
- ESP_LOGW(TAG, "Unknown message type: %s", type->valuestring);
- }
- });
- bool protocol_started = protocol_->Start();
-
- SystemInfo::PrintHeapStats();
- SetDeviceState(kDeviceStateIdle);
-
- has_server_time_ = ota.HasServerTime();
- if (protocol_started) {
- std::string message = std::string(Lang::Strings::VERSION) + ota.GetCurrentVersion();
- display->ShowNotification(message.c_str());
- display->SetChatMessage("system", "");
- // Play the success sound to indicate the device is ready
- audio_service_.PlaySound(Lang::Sounds::OGG_SUCCESS);
- }
-
- // Start the main event loop task with priority 3
- xTaskCreate([](void* arg) {
- ((Application*)arg)->MainEventLoop();
- vTaskDelete(NULL);
- }, "main_event_loop", 2048 * 4, this, 3, &main_event_loop_task_handle_);
-}
-
-// Add a async task to MainLoop
-void Application::Schedule(std::function callback) {
- {
- std::lock_guard lock(mutex_);
- main_tasks_.push_back(std::move(callback));
- }
- xEventGroupSetBits(event_group_, MAIN_EVENT_SCHEDULE);
-}
-
-// The Main Event Loop controls the chat state and websocket connection
-// If other tasks need to access the websocket or chat state,
-// they should use Schedule to call this function
-void Application::MainEventLoop() {
- while (true) {
- auto bits = xEventGroupWaitBits(event_group_, MAIN_EVENT_SCHEDULE |
- MAIN_EVENT_SEND_AUDIO |
- MAIN_EVENT_WAKE_WORD_DETECTED |
- MAIN_EVENT_VAD_CHANGE |
- MAIN_EVENT_CLOCK_TICK |
- MAIN_EVENT_ERROR, pdTRUE, pdFALSE, portMAX_DELAY);
-
- if (bits & MAIN_EVENT_ERROR) {
- SetDeviceState(kDeviceStateIdle);
- Alert(Lang::Strings::ERROR, last_error_message_.c_str(), "circle_xmark", Lang::Sounds::OGG_EXCLAMATION);
- }
-
- if (bits & MAIN_EVENT_SEND_AUDIO) {
- while (auto packet = audio_service_.PopPacketFromSendQueue()) {
- if (protocol_ && !protocol_->SendAudio(std::move(packet))) {
- break;
- }
- }
- }
-
- if (bits & MAIN_EVENT_WAKE_WORD_DETECTED) {
- OnWakeWordDetected();
- }
-
- if (bits & MAIN_EVENT_VAD_CHANGE) {
- if (device_state_ == kDeviceStateListening) {
- auto led = Board::GetInstance().GetLed();
- led->OnStateChanged();
- }
- }
-
- if (bits & MAIN_EVENT_SCHEDULE) {
- std::unique_lock lock(mutex_);
- auto tasks = std::move(main_tasks_);
- lock.unlock();
- for (auto& task : tasks) {
- task();
- }
- }
-
- if (bits & MAIN_EVENT_CLOCK_TICK) {
- clock_ticks_++;
- auto display = Board::GetInstance().GetDisplay();
- display->UpdateStatusBar();
-
- // Print the debug info every 10 seconds
- if (clock_ticks_ % 10 == 0) {
- // SystemInfo::PrintTaskCpuUsage(pdMS_TO_TICKS(1000));
- // SystemInfo::PrintTaskList();
- SystemInfo::PrintHeapStats();
- }
- }
- }
-}
-
-void Application::OnWakeWordDetected() {
- if (!protocol_) {
- return;
- }
-
- if (device_state_ == kDeviceStateIdle) {
- audio_service_.EncodeWakeWord();
-
- if (!protocol_->IsAudioChannelOpened()) {
- SetDeviceState(kDeviceStateConnecting);
- if (!protocol_->OpenAudioChannel()) {
- audio_service_.EnableWakeWordDetection(true);
- return;
- }
- }
-
- auto wake_word = audio_service_.GetLastWakeWord();
- ESP_LOGI(TAG, "Wake word detected: %s", wake_word.c_str());
-#if CONFIG_USE_AFE_WAKE_WORD || CONFIG_USE_CUSTOM_WAKE_WORD
- // Encode and send the wake word data to the server
- while (auto packet = audio_service_.PopWakeWordPacket()) {
- protocol_->SendAudio(std::move(packet));
- }
- // Set the chat state to wake word detected
- protocol_->SendWakeWordDetected(wake_word);
- SetListeningMode(aec_mode_ == kAecOff ? kListeningModeAutoStop : kListeningModeRealtime);
-#else
- SetListeningMode(aec_mode_ == kAecOff ? kListeningModeAutoStop : kListeningModeRealtime);
- // Play the pop up sound to indicate the wake word is detected
- audio_service_.PlaySound(Lang::Sounds::OGG_POPUP);
-#endif
- } else if (device_state_ == kDeviceStateSpeaking) {
- AbortSpeaking(kAbortReasonWakeWordDetected);
- } else if (device_state_ == kDeviceStateActivating) {
- SetDeviceState(kDeviceStateIdle);
- }
-}
-
-void Application::AbortSpeaking(AbortReason reason) {
- ESP_LOGI(TAG, "Abort speaking");
- aborted_ = true;
- if (protocol_) {
- protocol_->SendAbortSpeaking(reason);
- }
-}
-
-void Application::SetListeningMode(ListeningMode mode) {
- listening_mode_ = mode;
- SetDeviceState(kDeviceStateListening);
-}
-
-void Application::SetDeviceState(DeviceState state) {
- if (device_state_ == state) {
- return;
- }
-
- clock_ticks_ = 0;
- auto previous_state = device_state_;
- device_state_ = state;
- ESP_LOGI(TAG, "STATE: %s", STATE_STRINGS[device_state_]);
-
- // Send the state change event
- DeviceStateEventManager::GetInstance().PostStateChangeEvent(previous_state, state);
-
- auto& board = Board::GetInstance();
- auto display = board.GetDisplay();
- auto led = board.GetLed();
- led->OnStateChanged();
- switch (state) {
- case kDeviceStateUnknown:
- case kDeviceStateIdle:
- display->SetStatus(Lang::Strings::STANDBY);
- display->SetEmotion("neutral");
- audio_service_.EnableVoiceProcessing(false);
- audio_service_.EnableWakeWordDetection(true);
- break;
- case kDeviceStateConnecting:
- display->SetStatus(Lang::Strings::CONNECTING);
- display->SetEmotion("neutral");
- display->SetChatMessage("system", "");
- break;
- case kDeviceStateListening:
- display->SetStatus(Lang::Strings::LISTENING);
- display->SetEmotion("neutral");
-
- // Make sure the audio processor is running
- if (!audio_service_.IsAudioProcessorRunning()) {
- // Send the start listening command
- protocol_->SendStartListening(listening_mode_);
- audio_service_.EnableVoiceProcessing(true);
- audio_service_.EnableWakeWordDetection(false);
- }
- break;
- case kDeviceStateSpeaking:
- display->SetStatus(Lang::Strings::SPEAKING);
-
- if (listening_mode_ != kListeningModeRealtime) {
- audio_service_.EnableVoiceProcessing(false);
- // Only AFE wake word can be detected in speaking mode
-#if CONFIG_USE_AFE_WAKE_WORD
- audio_service_.EnableWakeWordDetection(true);
-#else
- audio_service_.EnableWakeWordDetection(false);
-#endif
- }
- audio_service_.ResetDecoder();
- break;
- default:
- // Do nothing
- break;
- }
-}
-
-void Application::Reboot() {
- ESP_LOGI(TAG, "Rebooting...");
- // Disconnect the audio channel
- if (protocol_ && protocol_->IsAudioChannelOpened()) {
- protocol_->CloseAudioChannel();
- }
- protocol_.reset();
- audio_service_.Stop();
-
- vTaskDelay(pdMS_TO_TICKS(1000));
- esp_restart();
-}
-
-bool Application::UpgradeFirmware(Ota& ota, const std::string& url) {
- auto& board = Board::GetInstance();
- auto display = board.GetDisplay();
-
- // Use provided URL or get from OTA object
- std::string upgrade_url = url.empty() ? ota.GetFirmwareUrl() : url;
- std::string version_info = url.empty() ? ota.GetFirmwareVersion() : "(Manual upgrade)";
-
- // Close audio channel if it's open
- if (protocol_ && protocol_->IsAudioChannelOpened()) {
- ESP_LOGI(TAG, "Closing audio channel before firmware upgrade");
- protocol_->CloseAudioChannel();
- }
- ESP_LOGI(TAG, "Starting firmware upgrade from URL: %s", upgrade_url.c_str());
-
- Alert(Lang::Strings::OTA_UPGRADE, Lang::Strings::UPGRADING, "download", Lang::Sounds::OGG_UPGRADE);
- vTaskDelay(pdMS_TO_TICKS(3000));
-
- SetDeviceState(kDeviceStateUpgrading);
-
- std::string message = std::string(Lang::Strings::NEW_VERSION) + version_info;
- display->SetChatMessage("system", message.c_str());
-
- board.SetPowerSaveMode(false);
- audio_service_.Stop();
- vTaskDelay(pdMS_TO_TICKS(1000));
-
- bool upgrade_success = ota.StartUpgradeFromUrl(upgrade_url, [display](int progress, size_t speed) {
- std::thread([display, progress, speed]() {
- char buffer[32];
- snprintf(buffer, sizeof(buffer), "%d%% %uKB/s", progress, speed / 1024);
- display->SetChatMessage("system", buffer);
- }).detach();
- });
-
- if (!upgrade_success) {
- // Upgrade failed, restart audio service and continue running
- ESP_LOGE(TAG, "Firmware upgrade failed, restarting audio service and continuing operation...");
- audio_service_.Start(); // Restart audio service
- board.SetPowerSaveMode(true); // Restore power save mode
- Alert(Lang::Strings::ERROR, Lang::Strings::UPGRADE_FAILED, "circle_xmark", Lang::Sounds::OGG_EXCLAMATION);
- vTaskDelay(pdMS_TO_TICKS(3000));
- return false;
- } else {
- // Upgrade success, reboot immediately
- ESP_LOGI(TAG, "Firmware upgrade successful, rebooting...");
- display->SetChatMessage("system", "Upgrade successful, rebooting...");
- vTaskDelay(pdMS_TO_TICKS(1000)); // Brief pause to show message
- Reboot();
- return true;
- }
-}
-
-void Application::WakeWordInvoke(const std::string& wake_word) {
- if (device_state_ == kDeviceStateIdle) {
- ToggleChatState();
- Schedule([this, wake_word]() {
- if (protocol_) {
- protocol_->SendWakeWordDetected(wake_word);
- }
- });
- } else if (device_state_ == kDeviceStateSpeaking) {
- Schedule([this]() {
- AbortSpeaking(kAbortReasonNone);
- });
- } else if (device_state_ == kDeviceStateListening) {
- Schedule([this]() {
- if (protocol_) {
- protocol_->CloseAudioChannel();
- }
- });
- }
-}
-
-bool Application::CanEnterSleepMode() {
- if (device_state_ != kDeviceStateIdle) {
- return false;
- }
-
- if (protocol_ && protocol_->IsAudioChannelOpened()) {
- return false;
- }
-
- if (!audio_service_.IsIdle()) {
- return false;
- }
-
- // Now it is safe to enter sleep mode
- return true;
-}
-
-void Application::SendMcpMessage(const std::string& payload) {
- if (protocol_ == nullptr) {
- return;
- }
-
- // Make sure you are using main thread to send MCP message
- if (xTaskGetCurrentTaskHandle() == main_event_loop_task_handle_) {
- ESP_LOGI(TAG, "Send MCP message in main thread");
- protocol_->SendMcpMessage(payload);
- } else {
- ESP_LOGI(TAG, "Send MCP message in sub thread");
- Schedule([this, payload = std::move(payload)]() {
- protocol_->SendMcpMessage(payload);
- });
- }
-}
-
-void Application::SetAecMode(AecMode mode) {
- aec_mode_ = mode;
- Schedule([this]() {
- auto& board = Board::GetInstance();
- auto display = board.GetDisplay();
- switch (aec_mode_) {
- case kAecOff:
- audio_service_.EnableDeviceAec(false);
- display->ShowNotification(Lang::Strings::RTC_MODE_OFF);
- break;
- case kAecOnServerSide:
- audio_service_.EnableDeviceAec(false);
- display->ShowNotification(Lang::Strings::RTC_MODE_ON);
- break;
- case kAecOnDeviceSide:
- audio_service_.EnableDeviceAec(true);
- display->ShowNotification(Lang::Strings::RTC_MODE_ON);
- break;
- }
-
- // If the AEC mode is changed, close the audio channel
- if (protocol_ && protocol_->IsAudioChannelOpened()) {
- protocol_->CloseAudioChannel();
- }
- });
-}
-
-// 新增:接收外部音频数据(如音乐播放)
-void Application::AddAudioData(AudioStreamPacket&& packet) {
- auto codec = Board::GetInstance().GetAudioCodec();
- if (device_state_ == kDeviceStateIdle && codec->output_enabled()) {
- // packet.payload包含的是原始PCM数据(int16_t)
- if (packet.payload.size() >= 2) {
- size_t num_samples = packet.payload.size() / sizeof(int16_t);
- std::vector pcm_data(num_samples);
- memcpy(pcm_data.data(), packet.payload.data(), packet.payload.size());
-
- // 检查采样率是否匹配,如果不匹配则进行简单重采样
- if (packet.sample_rate != codec->output_sample_rate()) {
- // ESP_LOGI(TAG, "Resampling music audio from %d to %d Hz",
- // packet.sample_rate, codec->output_sample_rate());
-
- // 验证采样率参数
- if (packet.sample_rate <= 0 || codec->output_sample_rate() <= 0) {
- ESP_LOGE(TAG, "Invalid sample rates: %d -> %d",
- packet.sample_rate, codec->output_sample_rate());
- return;
- }
-
- std::vector resampled;
-
- if (packet.sample_rate > codec->output_sample_rate()) {
- ESP_LOGI(TAG, "Music Player: Adjust the sampling rate from %d Hz to %d Hz",
- codec->output_sample_rate(), packet.sample_rate);
-
- // 尝试动态切换采样率
- if (codec->SetOutputSampleRate(packet.sample_rate)) {
- ESP_LOGI(TAG, "Successfully switched to music playback sampling rate: %d Hz", packet.sample_rate);
- } else {
- ESP_LOGW(TAG, "Unable to switch sampling rate, continue using current sampling rate: %d Hz", codec->output_sample_rate());
- }
- } else {
- if (packet.sample_rate > codec->output_sample_rate()) {
- // 下采样:简单丢弃部分样本
- float downsample_ratio = static_cast(packet.sample_rate) / codec->output_sample_rate();
- size_t expected_size = static_cast(pcm_data.size() / downsample_ratio + 0.5f);
- std::vector resampled(expected_size);
- size_t resampled_index = 0;
-
- for (size_t i = 0; i < pcm_data.size(); ++i) {
- if (i % static_cast(downsample_ratio) == 0) {
- resampled[resampled_index++] = pcm_data[i];
- }
- }
-
- pcm_data = std::move(resampled);
- ESP_LOGI(TAG, "Downsampled %d -> %d samples (ratio: %.2f)",
- pcm_data.size(), resampled.size(), downsample_ratio);
- } else if (packet.sample_rate < codec->output_sample_rate()) {
- // 上采样:线性插值
- float upsample_ratio = codec->output_sample_rate() / static_cast(packet.sample_rate);
- size_t expected_size = static_cast(pcm_data.size() * upsample_ratio + 0.5f);
- resampled.reserve(expected_size);
-
- for (size_t i = 0; i < pcm_data.size(); ++i) {
- // 添加原始样本
- resampled.push_back(pcm_data[i]);
-
-
- // 计算需要插值的样本数
- int interpolation_count = static_cast(upsample_ratio) - 1;
- if (interpolation_count > 0 && i + 1 < pcm_data.size()) {
- int16_t current = pcm_data[i];
- int16_t next = pcm_data[i + 1];
- for (int j = 1; j <= interpolation_count; ++j) {
- float t = static_cast(j) / (interpolation_count + 1);
- int16_t interpolated = static_cast(current + (next - current) * t);
- resampled.push_back(interpolated);
- }
- } else if (interpolation_count > 0) {
- // 最后一个样本,直接重复
- for (int j = 1; j <= interpolation_count; ++j) {
- resampled.push_back(pcm_data[i]);
- }
- }
- }
-
- ESP_LOGI(TAG, "Upsampled %d -> %d samples (ratio: %.2f)",
- pcm_data.size(), resampled.size(), upsample_ratio);
- }
- }
-
- pcm_data = std::move(resampled);
- }
-
- // 确保音频输出已启用
- if (!codec->output_enabled()) {
- codec->EnableOutput(true);
- }
-
- // 发送PCM数据到音频编解码器
- codec->OutputData(pcm_data);
-
- audio_service_.UpdateOutputTimestamp();
- }
- }
-}
-
-void Application::PlaySound(const std::string_view& sound) {
- audio_service_.PlaySound(sound);
+#include "application.h"
+#include "board.h"
+#include "display.h"
+#include "system_info.h"
+#include "audio_codec.h"
+#include "mqtt_protocol.h"
+#include "websocket_protocol.h"
+#include "assets/lang_config.h"
+#include "mcp_server.h"
+#include "assets.h"
+#include "settings.h"
+
+#include
+#include
+#include
+#include
+#include
+#include
+#include
+#include
+
+#define TAG "Application"
+
+
+static const char* const STATE_STRINGS[] = {
+ "unknown",
+ "starting",
+ "configuring",
+ "idle",
+ "connecting",
+ "listening",
+ "speaking",
+ "upgrading",
+ "activating",
+ "audio_testing",
+ "fatal_error",
+ "invalid_state"
+};
+
+Application::Application() {
+ event_group_ = xEventGroupCreate();
+
+#if CONFIG_USE_DEVICE_AEC && CONFIG_USE_SERVER_AEC
+#error "CONFIG_USE_DEVICE_AEC and CONFIG_USE_SERVER_AEC cannot be enabled at the same time"
+#elif CONFIG_USE_DEVICE_AEC
+ aec_mode_ = kAecOnDeviceSide;
+#elif CONFIG_USE_SERVER_AEC
+ aec_mode_ = kAecOnServerSide;
+#else
+ aec_mode_ = kAecOff;
+#endif
+
+ esp_timer_create_args_t clock_timer_args = {
+ .callback = [](void* arg) {
+ Application* app = (Application*)arg;
+ xEventGroupSetBits(app->event_group_, MAIN_EVENT_CLOCK_TICK);
+ },
+ .arg = this,
+ .dispatch_method = ESP_TIMER_TASK,
+ .name = "clock_timer",
+ .skip_unhandled_events = true
+ };
+ esp_timer_create(&clock_timer_args, &clock_timer_handle_);
+}
+
+Application::~Application() {
+ if (clock_timer_handle_ != nullptr) {
+ esp_timer_stop(clock_timer_handle_);
+ esp_timer_delete(clock_timer_handle_);
+ }
+ vEventGroupDelete(event_group_);
+}
+
+void Application::CheckAssetsVersion() {
+ auto& board = Board::GetInstance();
+ auto display = board.GetDisplay();
+ auto& assets = Assets::GetInstance();
+
+ if (!assets.partition_valid()) {
+ ESP_LOGW(TAG, "Assets partition is disabled for board %s", BOARD_NAME);
+ return;
+ }
+
+ Settings settings("assets", true);
+ // Check if there is a new assets need to be downloaded
+ std::string download_url = settings.GetString("download_url");
+
+ if (!download_url.empty()) {
+ settings.EraseKey("download_url");
+
+ char message[256];
+ snprintf(message, sizeof(message), Lang::Strings::FOUND_NEW_ASSETS, download_url.c_str());
+ Alert(Lang::Strings::LOADING_ASSETS, message, "cloud_arrow_down", Lang::Sounds::OGG_UPGRADE);
+
+ // Wait for the audio service to be idle for 3 seconds
+ vTaskDelay(pdMS_TO_TICKS(3000));
+ SetDeviceState(kDeviceStateUpgrading);
+ board.SetPowerSaveMode(false);
+ display->SetChatMessage("system", Lang::Strings::PLEASE_WAIT);
+
+ bool success = assets.Download(download_url, [display](int progress, size_t speed) -> void {
+ std::thread([display, progress, speed]() {
+ char buffer[32];
+ snprintf(buffer, sizeof(buffer), "%d%% %uKB/s", progress, speed / 1024);
+ display->SetChatMessage("system", buffer);
+ }).detach();
+ });
+
+ board.SetPowerSaveMode(true);
+ vTaskDelay(pdMS_TO_TICKS(1000));
+
+ if (!success) {
+ Alert(Lang::Strings::ERROR, Lang::Strings::DOWNLOAD_ASSETS_FAILED, "circle_xmark", Lang::Sounds::OGG_EXCLAMATION);
+ vTaskDelay(pdMS_TO_TICKS(2000));
+ return;
+ }
+ }
+
+ // Apply assets
+ assets.Apply();
+ display->SetChatMessage("system", "");
+ display->SetEmotion("microchip_ai");
+}
+
+void Application::CheckNewVersion(Ota& ota) {
+ const int MAX_RETRY = 10;
+ int retry_count = 0;
+ int retry_delay = 10; // 初始重试延迟为10秒
+
+ auto& board = Board::GetInstance();
+ while (true) {
+ SetDeviceState(kDeviceStateActivating);
+ auto display = board.GetDisplay();
+ display->SetStatus(Lang::Strings::CHECKING_NEW_VERSION);
+
+ if (!ota.CheckVersion()) {
+ retry_count++;
+ if (retry_count >= MAX_RETRY) {
+ ESP_LOGE(TAG, "Too many retries, exit version check");
+ return;
+ }
+
+ char buffer[256];
+ snprintf(buffer, sizeof(buffer), Lang::Strings::CHECK_NEW_VERSION_FAILED, retry_delay, ota.GetCheckVersionUrl().c_str());
+ Alert(Lang::Strings::ERROR, buffer, "cloud_slash", Lang::Sounds::OGG_EXCLAMATION);
+
+ ESP_LOGW(TAG, "Check new version failed, retry in %d seconds (%d/%d)", retry_delay, retry_count, MAX_RETRY);
+ for (int i = 0; i < retry_delay; i++) {
+ vTaskDelay(pdMS_TO_TICKS(1000));
+ if (device_state_ == kDeviceStateIdle) {
+ break;
+ }
+ }
+ retry_delay *= 2; // 每次重试后延迟时间翻倍
+ continue;
+ }
+ retry_count = 0;
+ retry_delay = 10; // 重置重试延迟时间
+
+ if (ota.HasNewVersion()) {
+ if (UpgradeFirmware(ota)) {
+ return; // This line will never be reached after reboot
+ }
+ // If upgrade failed, continue to normal operation (don't break, just fall through)
+ }
+
+ // No new version, mark the current version as valid
+ ota.MarkCurrentVersionValid();
+ if (!ota.HasActivationCode() && !ota.HasActivationChallenge()) {
+ xEventGroupSetBits(event_group_, MAIN_EVENT_CHECK_NEW_VERSION_DONE);
+ // Exit the loop if done checking new version
+ break;
+ }
+
+ display->SetStatus(Lang::Strings::ACTIVATION);
+ // Activation code is shown to the user and waiting for the user to input
+ if (ota.HasActivationCode()) {
+ ShowActivationCode(ota.GetActivationCode(), ota.GetActivationMessage());
+ }
+
+ // This will block the loop until the activation is done or timeout
+ for (int i = 0; i < 10; ++i) {
+ ESP_LOGI(TAG, "Activating... %d/%d", i + 1, 10);
+ esp_err_t err = ota.Activate();
+ if (err == ESP_OK) {
+ xEventGroupSetBits(event_group_, MAIN_EVENT_CHECK_NEW_VERSION_DONE);
+ break;
+ } else if (err == ESP_ERR_TIMEOUT) {
+ vTaskDelay(pdMS_TO_TICKS(3000));
+ } else {
+ vTaskDelay(pdMS_TO_TICKS(10000));
+ }
+ if (device_state_ == kDeviceStateIdle) {
+ break;
+ }
+ }
+ }
+}
+
+void Application::ShowActivationCode(const std::string& code, const std::string& message) {
+ struct digit_sound {
+ char digit;
+ const std::string_view& sound;
+ };
+ static const std::array digit_sounds{{
+ digit_sound{'0', Lang::Sounds::OGG_0},
+ digit_sound{'1', Lang::Sounds::OGG_1},
+ digit_sound{'2', Lang::Sounds::OGG_2},
+ digit_sound{'3', Lang::Sounds::OGG_3},
+ digit_sound{'4', Lang::Sounds::OGG_4},
+ digit_sound{'5', Lang::Sounds::OGG_5},
+ digit_sound{'6', Lang::Sounds::OGG_6},
+ digit_sound{'7', Lang::Sounds::OGG_7},
+ digit_sound{'8', Lang::Sounds::OGG_8},
+ digit_sound{'9', Lang::Sounds::OGG_9}
+ }};
+
+ // This sentence uses 9KB of SRAM, so we need to wait for it to finish
+ Alert(Lang::Strings::ACTIVATION, message.c_str(), "link", Lang::Sounds::OGG_ACTIVATION);
+
+ for (const auto& digit : code) {
+ auto it = std::find_if(digit_sounds.begin(), digit_sounds.end(),
+ [digit](const digit_sound& ds) { return ds.digit == digit; });
+ if (it != digit_sounds.end()) {
+ audio_service_.PlaySound(it->sound);
+ }
+ }
+}
+
+void Application::Alert(const char* status, const char* message, const char* emotion, const std::string_view& sound) {
+ ESP_LOGW(TAG, "Alert [%s] %s: %s", emotion, status, message);
+ auto display = Board::GetInstance().GetDisplay();
+ display->SetStatus(status);
+ display->SetEmotion(emotion);
+ display->SetChatMessage("system", message);
+ if (!sound.empty()) {
+ audio_service_.PlaySound(sound);
+ }
+}
+
+void Application::DismissAlert() {
+ if (device_state_ == kDeviceStateIdle) {
+ auto display = Board::GetInstance().GetDisplay();
+ display->SetStatus(Lang::Strings::STANDBY);
+ display->SetEmotion("neutral");
+ display->SetChatMessage("system", "");
+ }
+}
+
+void Application::ToggleChatState() {
+ if (device_state_ == kDeviceStateActivating) {
+ SetDeviceState(kDeviceStateIdle);
+ return;
+ } else if (device_state_ == kDeviceStateWifiConfiguring) {
+ audio_service_.EnableAudioTesting(true);
+ SetDeviceState(kDeviceStateAudioTesting);
+ return;
+ } else if (device_state_ == kDeviceStateAudioTesting) {
+ audio_service_.EnableAudioTesting(false);
+ SetDeviceState(kDeviceStateWifiConfiguring);
+ return;
+ }
+
+ if (!protocol_) {
+ ESP_LOGE(TAG, "Protocol not initialized");
+ return;
+ }
+
+ if (device_state_ == kDeviceStateIdle) {
+ Schedule([this]() {
+ if (!protocol_->IsAudioChannelOpened()) {
+ SetDeviceState(kDeviceStateConnecting);
+ if (!protocol_->OpenAudioChannel()) {
+ return;
+ }
+ }
+
+ SetListeningMode(aec_mode_ == kAecOff ? kListeningModeAutoStop : kListeningModeRealtime);
+ });
+ } else if (device_state_ == kDeviceStateSpeaking) {
+ Schedule([this]() {
+ AbortSpeaking(kAbortReasonNone);
+ });
+ } else if (device_state_ == kDeviceStateListening) {
+ Schedule([this]() {
+ protocol_->CloseAudioChannel();
+ });
+ }
+}
+
+void Application::StartListening() {
+ if (device_state_ == kDeviceStateActivating) {
+ SetDeviceState(kDeviceStateIdle);
+ return;
+ } else if (device_state_ == kDeviceStateWifiConfiguring) {
+ audio_service_.EnableAudioTesting(true);
+ SetDeviceState(kDeviceStateAudioTesting);
+ return;
+ }
+
+ if (!protocol_) {
+ ESP_LOGE(TAG, "Protocol not initialized");
+ return;
+ }
+
+ if (device_state_ == kDeviceStateIdle) {
+ Schedule([this]() {
+ if (!protocol_->IsAudioChannelOpened()) {
+ SetDeviceState(kDeviceStateConnecting);
+ if (!protocol_->OpenAudioChannel()) {
+ return;
+ }
+ }
+
+ SetListeningMode(kListeningModeManualStop);
+ });
+ } else if (device_state_ == kDeviceStateSpeaking) {
+ Schedule([this]() {
+ AbortSpeaking(kAbortReasonNone);
+ SetListeningMode(kListeningModeManualStop);
+ });
+ }
+}
+
+void Application::StopListening() {
+ if (device_state_ == kDeviceStateAudioTesting) {
+ audio_service_.EnableAudioTesting(false);
+ SetDeviceState(kDeviceStateWifiConfiguring);
+ return;
+ }
+
+ const std::array valid_states = {
+ kDeviceStateListening,
+ kDeviceStateSpeaking,
+ kDeviceStateIdle,
+ };
+ // If not valid, do nothing
+ if (std::find(valid_states.begin(), valid_states.end(), device_state_) == valid_states.end()) {
+ return;
+ }
+
+ Schedule([this]() {
+ if (device_state_ == kDeviceStateListening) {
+ protocol_->SendStopListening();
+ SetDeviceState(kDeviceStateIdle);
+ }
+ });
+}
+
+void Application::Start() {
+ auto& board = Board::GetInstance();
+ SetDeviceState(kDeviceStateStarting);
+
+ /* Setup the display */
+ auto display = board.GetDisplay();
+
+ // Print board name/version info
+ display->SetChatMessage("system", SystemInfo::GetUserAgent().c_str());
+
+ /* Setup the audio service */
+ auto codec = board.GetAudioCodec();
+ audio_service_.Initialize(codec);
+ audio_service_.Start();
+
+ AudioServiceCallbacks callbacks;
+ callbacks.on_send_queue_available = [this]() {
+ xEventGroupSetBits(event_group_, MAIN_EVENT_SEND_AUDIO);
+ };
+ callbacks.on_wake_word_detected = [this](const std::string& wake_word) {
+ xEventGroupSetBits(event_group_, MAIN_EVENT_WAKE_WORD_DETECTED);
+ };
+ callbacks.on_vad_change = [this](bool speaking) {
+ xEventGroupSetBits(event_group_, MAIN_EVENT_VAD_CHANGE);
+ };
+ audio_service_.SetCallbacks(callbacks);
+
+ // Start the main event loop task with priority 3
+ xTaskCreate([](void* arg) {
+ ((Application*)arg)->MainEventLoop();
+ vTaskDelete(NULL);
+ }, "main_event_loop", 2048 * 4, this, 3, &main_event_loop_task_handle_);
+
+ /* Start the clock timer to update the status bar */
+ esp_timer_start_periodic(clock_timer_handle_, 1000000);
+
+ /* Wait for the network to be ready */
+ board.StartNetwork();
+
+ // Update the status bar immediately to show the network state
+ display->UpdateStatusBar(true);
+
+ // Check for new assets version
+ CheckAssetsVersion();
+
+ // Check for new firmware version or get the MQTT broker address
+ Ota ota;
+ CheckNewVersion(ota);
+
+ // Initialize the protocol
+ display->SetStatus(Lang::Strings::LOADING_PROTOCOL);
+
+ // Add MCP common tools before initializing the protocol
+ auto& mcp_server = McpServer::GetInstance();
+ mcp_server.AddCommonTools();
+ mcp_server.AddUserOnlyTools();
+
+ if (ota.HasMqttConfig()) {
+ protocol_ = std::make_unique();
+ } else if (ota.HasWebsocketConfig()) {
+ protocol_ = std::make_unique();
+ } else {
+ ESP_LOGW(TAG, "No protocol specified in the OTA config, using MQTT");
+ protocol_ = std::make_unique();
+ }
+
+ protocol_->OnConnected([this]() {
+ DismissAlert();
+ });
+
+ protocol_->OnNetworkError([this](const std::string& message) {
+ last_error_message_ = message;
+ xEventGroupSetBits(event_group_, MAIN_EVENT_ERROR);
+ });
+ protocol_->OnIncomingAudio([this](std::unique_ptr packet) {
+ if (device_state_ == kDeviceStateSpeaking) {
+ audio_service_.PushPacketToDecodeQueue(std::move(packet));
+ }
+ });
+ protocol_->OnAudioChannelOpened([this, codec, &board]() {
+ board.SetPowerSaveMode(false);
+ if (protocol_->server_sample_rate() != codec->output_sample_rate()) {
+ ESP_LOGW(TAG, "Server sample rate %d does not match device output sample rate %d, resampling may cause distortion",
+ protocol_->server_sample_rate(), codec->output_sample_rate());
+ }
+ });
+ protocol_->OnAudioChannelClosed([this, &board]() {
+ board.SetPowerSaveMode(true);
+ Schedule([this]() {
+ auto display = Board::GetInstance().GetDisplay();
+ display->SetChatMessage("system", "");
+ SetDeviceState(kDeviceStateIdle);
+ });
+ });
+ protocol_->OnIncomingJson([this, display](const cJSON* root) {
+ // Parse JSON data
+ auto type = cJSON_GetObjectItem(root, "type");
+ if (strcmp(type->valuestring, "tts") == 0) {
+ auto state = cJSON_GetObjectItem(root, "state");
+ if (strcmp(state->valuestring, "start") == 0) {
+ Schedule([this]() {
+ aborted_ = false;
+ if (device_state_ == kDeviceStateIdle || device_state_ == kDeviceStateListening) {
+ SetDeviceState(kDeviceStateSpeaking);
+ }
+ });
+ } else if (strcmp(state->valuestring, "stop") == 0) {
+ Schedule([this]() {
+ if (device_state_ == kDeviceStateSpeaking) {
+ if (listening_mode_ == kListeningModeManualStop) {
+ SetDeviceState(kDeviceStateIdle);
+ } else {
+ SetDeviceState(kDeviceStateListening);
+ }
+ }
+ });
+ } else if (strcmp(state->valuestring, "sentence_start") == 0) {
+ auto text = cJSON_GetObjectItem(root, "text");
+ if (cJSON_IsString(text)) {
+ ESP_LOGI(TAG, "<< %s", text->valuestring);
+ Schedule([this, display, message = std::string(text->valuestring)]() {
+ display->SetChatMessage("assistant", message.c_str());
+ });
+ }
+ }
+ } else if (strcmp(type->valuestring, "stt") == 0) {
+ auto text = cJSON_GetObjectItem(root, "text");
+ if (cJSON_IsString(text)) {
+ ESP_LOGI(TAG, ">> %s", text->valuestring);
+ Schedule([this, display, message = std::string(text->valuestring)]() {
+ display->SetChatMessage("user", message.c_str());
+ });
+ }
+ } else if (strcmp(type->valuestring, "llm") == 0) {
+ auto emotion = cJSON_GetObjectItem(root, "emotion");
+ if (cJSON_IsString(emotion)) {
+ Schedule([this, display, emotion_str = std::string(emotion->valuestring)]() {
+ display->SetEmotion(emotion_str.c_str());
+ });
+ }
+ } else if (strcmp(type->valuestring, "mcp") == 0) {
+ auto payload = cJSON_GetObjectItem(root, "payload");
+ if (cJSON_IsObject(payload)) {
+ McpServer::GetInstance().ParseMessage(payload);
+ }
+ } else if (strcmp(type->valuestring, "system") == 0) {
+ auto command = cJSON_GetObjectItem(root, "command");
+ if (cJSON_IsString(command)) {
+ ESP_LOGI(TAG, "System command: %s", command->valuestring);
+ if (strcmp(command->valuestring, "reboot") == 0) {
+ // Do a reboot if user requests a OTA update
+ Schedule([this]() {
+ Reboot();
+ });
+ } else {
+ ESP_LOGW(TAG, "Unknown system command: %s", command->valuestring);
+ }
+ }
+ } else if (strcmp(type->valuestring, "alert") == 0) {
+ auto status = cJSON_GetObjectItem(root, "status");
+ auto message = cJSON_GetObjectItem(root, "message");
+ auto emotion = cJSON_GetObjectItem(root, "emotion");
+ if (cJSON_IsString(status) && cJSON_IsString(message) && cJSON_IsString(emotion)) {
+ Alert(status->valuestring, message->valuestring, emotion->valuestring, Lang::Sounds::OGG_VIBRATION);
+ } else {
+ ESP_LOGW(TAG, "Alert command requires status, message and emotion");
+ }
+#if CONFIG_RECEIVE_CUSTOM_MESSAGE
+ } else if (strcmp(type->valuestring, "custom") == 0) {
+ auto payload = cJSON_GetObjectItem(root, "payload");
+ ESP_LOGI(TAG, "Received custom message: %s", cJSON_PrintUnformatted(root));
+ if (cJSON_IsObject(payload)) {
+ Schedule([this, display, payload_str = std::string(cJSON_PrintUnformatted(payload))]() {
+ display->SetChatMessage("system", payload_str.c_str());
+ });
+ } else {
+ ESP_LOGW(TAG, "Invalid custom message format: missing payload");
+ }
+#endif
+ } else {
+ ESP_LOGW(TAG, "Unknown message type: %s", type->valuestring);
+ }
+ });
+ bool protocol_started = protocol_->Start();
+
+ SystemInfo::PrintHeapStats();
+ SetDeviceState(kDeviceStateIdle);
+
+ has_server_time_ = ota.HasServerTime();
+ if (protocol_started) {
+ std::string message = std::string(Lang::Strings::VERSION) + ota.GetCurrentVersion();
+ display->ShowNotification(message.c_str());
+ display->SetChatMessage("system", "");
+
+ // 初始化闹钟管理器
+ auto& alarm_manager = AlarmManager::GetInstance();
+ alarm_manager.Initialize();
+
+ // 设置闹钟回调
+ alarm_manager.SetAlarmTriggeredCallback([this](const AlarmItem& alarm) {
+ Schedule([this, alarm]() { OnAlarmTriggered(alarm); });
+ });
+ alarm_manager.SetAlarmSnoozeCallback([this](const AlarmItem& alarm) {
+ Schedule([this, alarm]() { OnAlarmSnoozed(alarm); });
+ });
+ alarm_manager.SetAlarmStopCallback([this](const AlarmItem& alarm) {
+ Schedule([this, alarm]() { OnAlarmStopped(alarm); });
+ });
+
+ // Play the success sound to indicate the device is ready
+ audio_service_.PlaySound(Lang::Sounds::OGG_SUCCESS);
+ }
+}
+
+// Add a async task to MainLoop
+void Application::Schedule(std::function callback) {
+ {
+ std::lock_guard lock(mutex_);
+ main_tasks_.push_back(std::move(callback));
+ }
+ xEventGroupSetBits(event_group_, MAIN_EVENT_SCHEDULE);
+}
+
+// The Main Event Loop controls the chat state and websocket connection
+// If other tasks need to access the websocket or chat state,
+// they should use Schedule to call this function
+void Application::MainEventLoop() {
+ while (true) {
+ auto bits = xEventGroupWaitBits(event_group_, MAIN_EVENT_SCHEDULE |
+ MAIN_EVENT_SEND_AUDIO |
+ MAIN_EVENT_WAKE_WORD_DETECTED |
+ MAIN_EVENT_VAD_CHANGE |
+ MAIN_EVENT_CLOCK_TICK |
+ MAIN_EVENT_ERROR, pdTRUE, pdFALSE, portMAX_DELAY);
+
+ if (bits & MAIN_EVENT_ERROR) {
+ SetDeviceState(kDeviceStateIdle);
+ Alert(Lang::Strings::ERROR, last_error_message_.c_str(), "circle_xmark", Lang::Sounds::OGG_EXCLAMATION);
+ }
+
+ if (bits & MAIN_EVENT_SEND_AUDIO) {
+ while (auto packet = audio_service_.PopPacketFromSendQueue()) {
+ if (protocol_ && !protocol_->SendAudio(std::move(packet))) {
+ break;
+ }
+ }
+ }
+
+ if (bits & MAIN_EVENT_WAKE_WORD_DETECTED) {
+ OnWakeWordDetected();
+ }
+
+ if (bits & MAIN_EVENT_VAD_CHANGE) {
+ if (device_state_ == kDeviceStateListening) {
+ auto led = Board::GetInstance().GetLed();
+ led->OnStateChanged();
+ }
+ }
+
+ if (bits & MAIN_EVENT_SCHEDULE) {
+ std::unique_lock lock(mutex_);
+ auto tasks = std::move(main_tasks_);
+ lock.unlock();
+ for (auto& task : tasks) {
+ task();
+ }
+ }
+
+ if (bits & MAIN_EVENT_CLOCK_TICK) {
+ clock_ticks_++;
+ auto display = Board::GetInstance().GetDisplay();
+ display->UpdateStatusBar();
+ display->OnClockTimer();
+
+ // 检查闹钟(每秒检查一次)
+ auto& alarm_manager = AlarmManager::GetInstance();
+ alarm_manager.CheckAlarms();
+
+ // 更新音乐播放进度(每秒更新一次)
+ if (is_music_playing_) {
+ UpdateMusicProgress();
+ }
+
+ // Print the debug info every 10 seconds
+ if (clock_ticks_ % 10 == 0) {
+ // SystemInfo::PrintTaskCpuUsage(pdMS_TO_TICKS(1000));
+ // SystemInfo::PrintTaskList();
+ SystemInfo::PrintHeapStats();
+ }
+ }
+ }
+}
+
+void Application::OnWakeWordDetected() {
+ if (!protocol_) {
+ return;
+ }
+
+ if (device_state_ == kDeviceStateIdle) {
+ audio_service_.EncodeWakeWord();
+
+ if (!protocol_->IsAudioChannelOpened()) {
+ SetDeviceState(kDeviceStateConnecting);
+ if (!protocol_->OpenAudioChannel()) {
+ audio_service_.EnableWakeWordDetection(true);
+ return;
+ }
+ }
+
+ auto wake_word = audio_service_.GetLastWakeWord();
+ ESP_LOGI(TAG, "Wake word detected: %s", wake_word.c_str());
+#if CONFIG_SEND_WAKE_WORD_DATA
+ // Encode and send the wake word data to the server
+ while (auto packet = audio_service_.PopWakeWordPacket()) {
+ protocol_->SendAudio(std::move(packet));
+ }
+ // Set the chat state to wake word detected
+ protocol_->SendWakeWordDetected(wake_word);
+ SetListeningMode(aec_mode_ == kAecOff ? kListeningModeAutoStop : kListeningModeRealtime);
+#else
+ SetListeningMode(aec_mode_ == kAecOff ? kListeningModeAutoStop : kListeningModeRealtime);
+ // Play the pop up sound to indicate the wake word is detected
+ audio_service_.PlaySound(Lang::Sounds::OGG_POPUP);
+#endif
+ } else if (device_state_ == kDeviceStateSpeaking) {
+ AbortSpeaking(kAbortReasonWakeWordDetected);
+ } else if (device_state_ == kDeviceStateActivating) {
+ SetDeviceState(kDeviceStateIdle);
+ }
+}
+
+void Application::AbortSpeaking(AbortReason reason) {
+ ESP_LOGI(TAG, "Abort speaking");
+ aborted_ = true;
+ if (protocol_) {
+ protocol_->SendAbortSpeaking(reason);
+ }
+}
+
+void Application::SetListeningMode(ListeningMode mode) {
+ listening_mode_ = mode;
+ SetDeviceState(kDeviceStateListening);
+}
+
+void Application::SetDeviceState(DeviceState state) {
+ if (device_state_ == state) {
+ return;
+ }
+
+ clock_ticks_ = 0;
+ auto previous_state = device_state_;
+ device_state_ = state;
+ ESP_LOGI(TAG, "STATE: %s", STATE_STRINGS[device_state_]);
+
+ // Send the state change event
+ DeviceStateEventManager::GetInstance().PostStateChangeEvent(previous_state, state);
+
+ auto& board = Board::GetInstance();
+ auto display = board.GetDisplay();
+ auto led = board.GetLed();
+ led->OnStateChanged();
+ display->OnStateChanged();
+ switch (state) {
+ case kDeviceStateUnknown:
+ case kDeviceStateIdle:
+ display->SetStatus(Lang::Strings::STANDBY);
+ display->SetEmotion("neutral");
+ audio_service_.EnableVoiceProcessing(false);
+ audio_service_.EnableWakeWordDetection(true);
+ break;
+ case kDeviceStateConnecting:
+ display->SetStatus(Lang::Strings::CONNECTING);
+ display->SetEmotion("neutral");
+ display->SetChatMessage("system", "");
+ break;
+ case kDeviceStateListening:
+ display->SetStatus(Lang::Strings::LISTENING);
+ display->SetEmotion("neutral");
+
+ // Make sure the audio processor is running
+ if (!audio_service_.IsAudioProcessorRunning()) {
+ // Send the start listening command
+ protocol_->SendStartListening(listening_mode_);
+ audio_service_.EnableVoiceProcessing(true);
+ audio_service_.EnableWakeWordDetection(false);
+ }
+ break;
+ case kDeviceStateSpeaking:
+ display->SetStatus(Lang::Strings::SPEAKING);
+
+ if (listening_mode_ != kListeningModeRealtime) {
+ audio_service_.EnableVoiceProcessing(false);
+ // Only AFE wake word can be detected in speaking mode
+ audio_service_.EnableWakeWordDetection(audio_service_.IsAfeWakeWord());
+ }
+ audio_service_.ResetDecoder();
+ break;
+ default:
+ // Do nothing
+ break;
+ }
+}
+
+void Application::Reboot() {
+ ESP_LOGI(TAG, "Rebooting...");
+ // Disconnect the audio channel
+ if (protocol_ && protocol_->IsAudioChannelOpened()) {
+ protocol_->CloseAudioChannel();
+ }
+ protocol_.reset();
+ audio_service_.Stop();
+
+ vTaskDelay(pdMS_TO_TICKS(1000));
+ esp_restart();
+}
+
+bool Application::UpgradeFirmware(Ota& ota, const std::string& url) {
+ auto& board = Board::GetInstance();
+ auto display = board.GetDisplay();
+
+ // Use provided URL or get from OTA object
+ std::string upgrade_url = url.empty() ? ota.GetFirmwareUrl() : url;
+ std::string version_info = url.empty() ? ota.GetFirmwareVersion() : "(Manual upgrade)";
+
+ // Close audio channel if it's open
+ if (protocol_ && protocol_->IsAudioChannelOpened()) {
+ ESP_LOGI(TAG, "Closing audio channel before firmware upgrade");
+ protocol_->CloseAudioChannel();
+ }
+ ESP_LOGI(TAG, "Starting firmware upgrade from URL: %s", upgrade_url.c_str());
+
+ Alert(Lang::Strings::OTA_UPGRADE, Lang::Strings::UPGRADING, "download", Lang::Sounds::OGG_UPGRADE);
+ vTaskDelay(pdMS_TO_TICKS(3000));
+
+ SetDeviceState(kDeviceStateUpgrading);
+
+ std::string message = std::string(Lang::Strings::NEW_VERSION) + version_info;
+ display->SetChatMessage("system", message.c_str());
+
+ board.SetPowerSaveMode(false);
+ audio_service_.Stop();
+ vTaskDelay(pdMS_TO_TICKS(1000));
+
+ bool upgrade_success = ota.StartUpgradeFromUrl(upgrade_url, [display](int progress, size_t speed) {
+ std::thread([display, progress, speed]() {
+ char buffer[32];
+ snprintf(buffer, sizeof(buffer), "%d%% %uKB/s", progress, speed / 1024);
+ display->SetChatMessage("system", buffer);
+ }).detach();
+ });
+
+ if (!upgrade_success) {
+ // Upgrade failed, restart audio service and continue running
+ ESP_LOGE(TAG, "Firmware upgrade failed, restarting audio service and continuing operation...");
+ audio_service_.Start(); // Restart audio service
+ board.SetPowerSaveMode(true); // Restore power save mode
+ Alert(Lang::Strings::ERROR, Lang::Strings::UPGRADE_FAILED, "circle_xmark", Lang::Sounds::OGG_EXCLAMATION);
+ vTaskDelay(pdMS_TO_TICKS(3000));
+ return false;
+ } else {
+ // Upgrade success, reboot immediately
+ ESP_LOGI(TAG, "Firmware upgrade successful, rebooting...");
+ display->SetChatMessage("system", "Upgrade successful, rebooting...");
+ vTaskDelay(pdMS_TO_TICKS(1000)); // Brief pause to show message
+ Reboot();
+ return true;
+ }
+}
+
+void Application::WakeWordInvoke(const std::string& wake_word) {
+ if (device_state_ == kDeviceStateIdle) {
+ ToggleChatState();
+ Schedule([this, wake_word]() {
+ if (protocol_) {
+ protocol_->SendWakeWordDetected(wake_word);
+ }
+ });
+ } else if (device_state_ == kDeviceStateSpeaking) {
+ Schedule([this]() {
+ AbortSpeaking(kAbortReasonNone);
+ });
+ } else if (device_state_ == kDeviceStateListening) {
+ Schedule([this]() {
+ if (protocol_) {
+ protocol_->CloseAudioChannel();
+ }
+ });
+ }
+}
+
+bool Application::CanEnterSleepMode() {
+ if (device_state_ != kDeviceStateIdle) {
+ return false;
+ }
+
+ if (protocol_ && protocol_->IsAudioChannelOpened()) {
+ return false;
+ }
+
+ if (!audio_service_.IsIdle()) {
+ return false;
+ }
+
+ // Now it is safe to enter sleep mode
+ return true;
+}
+
+void Application::SendMcpMessage(const std::string& payload) {
+ if (protocol_ == nullptr) {
+ return;
+ }
+
+ // Make sure you are using main thread to send MCP message
+ if (xTaskGetCurrentTaskHandle() == main_event_loop_task_handle_) {
+ protocol_->SendMcpMessage(payload);
+ } else {
+ Schedule([this, payload = std::move(payload)]() {
+ protocol_->SendMcpMessage(payload);
+ });
+ }
+}
+
+void Application::SetAecMode(AecMode mode) {
+ aec_mode_ = mode;
+ Schedule([this]() {
+ auto& board = Board::GetInstance();
+ auto display = board.GetDisplay();
+ switch (aec_mode_) {
+ case kAecOff:
+ audio_service_.EnableDeviceAec(false);
+ display->ShowNotification(Lang::Strings::RTC_MODE_OFF);
+ break;
+ case kAecOnServerSide:
+ audio_service_.EnableDeviceAec(false);
+ display->ShowNotification(Lang::Strings::RTC_MODE_ON);
+ break;
+ case kAecOnDeviceSide:
+ audio_service_.EnableDeviceAec(true);
+ display->ShowNotification(Lang::Strings::RTC_MODE_ON);
+ break;
+ }
+
+ // If the AEC mode is changed, close the audio channel
+ if (protocol_ && protocol_->IsAudioChannelOpened()) {
+ protocol_->CloseAudioChannel();
+ }
+ });
+}
+
+void Application::PlaySound(const std::string_view& sound) {
+ audio_service_.PlaySound(sound);
+}
+
+// 新增:接收外部音频数据(如音乐播放)
+void Application::AddAudioData(AudioStreamPacket&& packet) {
+ auto codec = Board::GetInstance().GetAudioCodec();
+ if (device_state_ == kDeviceStateIdle && codec->output_enabled()) {
+ // packet.payload包含的是原始PCM数据(int16_t)
+ if (packet.payload.size() >= 2) {
+ size_t num_samples = packet.payload.size() / sizeof(int16_t);
+ std::vector pcm_data(num_samples);
+ memcpy(pcm_data.data(), packet.payload.data(), packet.payload.size());
+
+ // 检查采样率是否匹配,如果不匹配则进行简单重采样
+ if (packet.sample_rate != codec->output_sample_rate()) {
+ // 验证采样率参数
+ if (packet.sample_rate <= 0 || codec->output_sample_rate() <= 0) {
+ ESP_LOGE(TAG, "Invalid sample rates: %d -> %d",
+ packet.sample_rate, codec->output_sample_rate());
+ return;
+ }
+
+ // 尝试动态切换采样率
+ if (codec->SetOutputSampleRate(packet.sample_rate)) {
+ ESP_LOGI(TAG, "Successfully switched to music playback sampling rate: %d Hz", packet.sample_rate);
+ } else {
+ ESP_LOGW(TAG, "Unable to switch sampling rate, continue using current sampling rate: %d Hz", codec->output_sample_rate());
+ // 如果无法切换采样率,继续使用当前的采样率进行处理
+ if (packet.sample_rate > codec->output_sample_rate()) {
+ // 下采样:简单丢弃部分样本
+ float downsample_ratio = static_cast(packet.sample_rate) / codec->output_sample_rate();
+ size_t expected_size = static_cast(pcm_data.size() / downsample_ratio + 0.5f);
+ std::vector resampled(expected_size);
+ size_t resampled_index = 0;
+
+ for (size_t i = 0; i < pcm_data.size(); ++i) {
+ if (i % static_cast(downsample_ratio) == 0) {
+ resampled[resampled_index++] = pcm_data[i];
+ }
+ }
+
+ pcm_data = std::move(resampled);
+ ESP_LOGI(TAG, "Downsampled %d -> %d samples (ratio: %.2f)",
+ pcm_data.size(), resampled.size(), downsample_ratio);
+ } else if (packet.sample_rate < codec->output_sample_rate()) {
+ // 上采样:线性插值
+ float upsample_ratio = codec->output_sample_rate() / static_cast(packet.sample_rate);
+ size_t expected_size = static_cast(pcm_data.size() * upsample_ratio + 0.5f);
+ std::vector resampled(expected_size);
+
+ for (size_t i = 0; i < pcm_data.size(); ++i) {
+ // 添加原始样本
+ resampled[i * static_cast(upsample_ratio)] = pcm_data[i];
+
+ // 计算需要插值的样本数
+ int interpolation_count = static_cast(upsample_ratio) - 1;
+ if (interpolation_count > 0 && i + 1 < pcm_data.size()) {
+ int16_t current = pcm_data[i];
+ int16_t next = pcm_data[i + 1];
+ for (int j = 1; j <= interpolation_count; ++j) {
+ float t = static_cast(j) / (interpolation_count + 1);
+ int16_t interpolated = static_cast(current + (next - current) * t);
+ resampled[i * static_cast(upsample_ratio) + j] = interpolated;
+ }
+ } else if (interpolation_count > 0) {
+ // 最后一个样本,直接重复
+ for (int j = 1; j <= interpolation_count; ++j) {
+ resampled[i * static_cast(upsample_ratio) + j] = pcm_data[i];
+ }
+ }
+ }
+
+ pcm_data = std::move(resampled);
+ ESP_LOGI(TAG, "Upsampled %d -> %d samples (ratio: %.2f)",
+ pcm_data.size() / static_cast(upsample_ratio), pcm_data.size(), upsample_ratio);
+ }
+ }
+ }
+
+ // 确保音频输出已启用
+ if (!codec->output_enabled()) {
+ codec->EnableOutput(true);
+ }
+
+ // 发送PCM数据到音频编解码器
+ codec->OutputData(pcm_data);
+
+ audio_service_.UpdateOutputTimestamp();
+ }
+ }
+}
+
+// 随机闹钟音乐列表 - 流行、经典、适合早晨的歌曲
+static const std::vector DEFAULT_ALARM_SONGS = {
+ "晴天", "七里香", "青花瓷", "稻香", "彩虹", "告白气球", "说好不哭",
+ "夜曲", "花海", "简单爱", "听妈妈的话", "东风破", "菊花台",
+ "起风了", "红豆", "好久不见", "匆匆那年", "老男孩", "那些年",
+ "小幸运", "成都", "南山南", "演员", "体面", "盗将行", "大鱼",
+ "新不了情", "月亮代表我的心", "甜蜜蜜", "邓丽君", "我只在乎你",
+ "友谊之光", "童年", "海阔天空", "光辉岁月", "真的爱你", "喜欢你",
+ "突然好想你", "情非得已", "温柔", "倔强", "知足", "三个傻瓜",
+ "恋爱循环", "千本樱", "打上花火", "lemon", "残酷天使的行动纲领",
+ "鸟笼", "虹", "青鸟", "closer", "sugar", "shape of you",
+ "despacito", "perfect", "happier", "someone like you"
+};
+
+// 获取随机闹钟音乐
+static std::string GetRandomAlarmMusic() {
+ if (DEFAULT_ALARM_SONGS.empty()) {
+ return "";
+ }
+
+ // 使用当前时间作为随机种子
+ srand(esp_timer_get_time() / 1000000);
+ size_t index = rand() % DEFAULT_ALARM_SONGS.size();
+ return DEFAULT_ALARM_SONGS[index];
+}
+
+// 闹钟回调方法实现
+void Application::OnAlarmTriggered(const AlarmItem& alarm) {
+ ESP_LOGI("Application", "Alarm triggered: %s at %02d:%02d",
+ alarm.label.c_str(), alarm.hour, alarm.minute);
+
+ auto& board = Board::GetInstance();
+ auto display = board.GetDisplay();
+ auto music = board.GetMusic();
+
+ // 显示闹钟信息
+ std::string alarm_message = "🎵 闹钟";
+ if (!alarm.label.empty()) {
+ alarm_message += "\n" + alarm.label;
+ }
+ alarm_message += "\n" + AlarmManager::FormatTime(alarm.hour, alarm.minute);
+
+ // 优先在时钟界面显示(如果支持)
+ display->ShowAlarmOnIdleScreen(alarm_message.c_str());
+
+ // 同时设置聊天消息(作为备用)
+ display->SetChatMessage("system", alarm_message.c_str());
+ display->SetEmotion("music");
+
+ // 确定要播放的音乐
+ std::string music_to_play;
+ if (!alarm.music_name.empty()) {
+ // 使用用户指定的音乐
+ music_to_play = alarm.music_name;
+ ESP_LOGI("Application", "Playing user specified alarm music: %s", music_to_play.c_str());
+ } else {
+ // 随机选择一首默认闹钟音乐
+ music_to_play = GetRandomAlarmMusic();
+ ESP_LOGI("Application", "Playing random alarm music: %s", music_to_play.c_str());
+ }
+
+ // 播放音乐
+ if (music && !music_to_play.empty()) {
+ // 更新显示,显示正在播放的歌曲
+ std::string playing_message = "🎵 正在播放: " + music_to_play;
+ display->SetChatMessage("system", playing_message.c_str());
+
+ // 开始下载并播放音乐
+ if (music->Download(music_to_play)) {
+ ESP_LOGI("Application", "Successfully started alarm music: %s", music_to_play.c_str());
+
+ // 开始音乐进度跟踪
+ current_music_name_ = music_to_play;
+ music_start_time_ms_ = esp_timer_get_time() / 1000; // 转换为毫秒
+ is_music_playing_ = true;
+
+ // 尝试获取真实的歌曲长度
+ int real_duration = music->GetCurrentSongDurationSeconds();
+ if (real_duration > 0) {
+ music_duration_seconds_ = real_duration;
+ ESP_LOGI("Application", "Got real song duration: %d seconds", real_duration);
+ }
+
+ // 启动进度显示
+ display->SetMusicProgress(music_to_play.c_str(), 0, music_duration_seconds_, 0.0f);
+ } else {
+ ESP_LOGW("Application", "Failed to download alarm music: %s, using fallback", music_to_play.c_str());
+ // 如果下载失败,播放默认铃声
+ audio_service_.PlaySound(Lang::Sounds::OGG_VIBRATION);
+ }
+ } else {
+ ESP_LOGW("Application", "Music service not available or no music selected, using default alarm sound");
+ // 如果没有音乐功能或选择失败,播放默认铃声
+ audio_service_.PlaySound(Lang::Sounds::OGG_VIBRATION);
+ }
+
+ // 显示闹钟控制提示
+ std::string control_message = "🎵 说\"贪睡\"延后5分钟,说\"关闭闹钟\"停止音乐";
+ display->ShowNotification(control_message.c_str());
+}
+
+void Application::OnAlarmSnoozed(const AlarmItem& alarm) {
+ ESP_LOGI("Application", "Alarm snoozed: %s, count: %d/%d",
+ alarm.label.c_str(), alarm.snooze_count, alarm.max_snooze_count);
+
+ auto& board = Board::GetInstance();
+ auto display = board.GetDisplay();
+
+ // 隐藏空闲屏幕上的闹钟信息
+ display->HideAlarmOnIdleScreen();
+
+ // 停止当前播放的音乐
+ auto music = board.GetMusic();
+ if (music) {
+ music->StopStreaming();
+ }
+
+ // 停止音乐进度跟踪并清除音乐界面
+ is_music_playing_ = false;
+ display->ClearMusicInfo();
+
+ std::string snooze_message = "💤 闹钟已贪睡 " + std::to_string(alarm.snooze_minutes) + " 分钟";
+ display->SetChatMessage("system", snooze_message.c_str());
+ display->SetEmotion("neutral");
+
+ audio_service_.PlaySound(Lang::Sounds::OGG_SUCCESS);
+}
+
+void Application::OnAlarmStopped(const AlarmItem& alarm) {
+ ESP_LOGI("Application", "Alarm stopped: %s", alarm.label.c_str());
+
+ auto& board = Board::GetInstance();
+ auto display = board.GetDisplay();
+
+ // 隐藏空闲屏幕上的闹钟信息
+ display->HideAlarmOnIdleScreen();
+
+ // 停止当前播放的音乐
+ auto music = board.GetMusic();
+ if (music) {
+ music->StopStreaming();
+ }
+
+ // 停止音乐进度跟踪并清除音乐界面
+ is_music_playing_ = false;
+ display->ClearMusicInfo();
+
+ display->SetChatMessage("system", "✅ 闹钟已关闭");
+ display->SetEmotion("neutral");
+
+ // 显示下一个闹钟信息
+ auto& alarm_manager = AlarmManager::GetInstance();
+ std::string next_alarm_info = alarm_manager.GetNextAlarmInfo();
+ display->ShowNotification(next_alarm_info.c_str());
+
+ audio_service_.PlaySound(Lang::Sounds::OGG_SUCCESS);
+}
+
+// 获取默认闹钟音乐列表
+std::vector Application::GetDefaultAlarmMusicList() const {
+ return DEFAULT_ALARM_SONGS;
+}
+
+// 更新音乐播放进度
+void Application::UpdateMusicProgress() {
+ if (!is_music_playing_) {
+ return;
+ }
+
+ auto& board = Board::GetInstance();
+ auto music = board.GetMusic();
+ auto display = board.GetDisplay();
+
+ if (!music || !display) {
+ return;
+ }
+
+ // 从音乐播放器获取真实的播放信息
+ int real_current_seconds = music->GetCurrentPlayTimeSeconds();
+ int real_duration_seconds = music->GetCurrentSongDurationSeconds();
+ float real_progress_percent = music->GetPlayProgress();
+
+ // 更新存储的歌曲长度(如果有变化)
+ if (real_duration_seconds > 0 && real_duration_seconds != music_duration_seconds_) {
+ music_duration_seconds_ = real_duration_seconds;
+ ESP_LOGI("Application", "Updated song duration: %d seconds", music_duration_seconds_);
+ }
+
+ // 检查是否播放结束
+ bool is_still_playing = music->IsDownloading() || (real_current_seconds < real_duration_seconds && real_current_seconds > 0);
+
+ if (!is_still_playing && real_current_seconds >= real_duration_seconds && real_duration_seconds > 0) {
+ is_music_playing_ = false; // 停止跟踪
+ ESP_LOGI("Application", "Music playback finished: %s (%d/%d seconds)",
+ current_music_name_.c_str(), real_current_seconds, real_duration_seconds);
+
+ // 🎵 音乐播放完毕,自动停止所有活跃的闹钟
+ auto& alarm_manager = AlarmManager::GetInstance();
+ auto active_alarms = alarm_manager.GetActiveAlarms();
+ if (!active_alarms.empty()) {
+ ESP_LOGI("Application", "Auto-stopping alarms after music finished");
+
+ // 停止闹钟
+ for (const auto& alarm : active_alarms) {
+ alarm_manager.StopAlarm(alarm.id);
+ }
+
+ // 在界面上显示用户确认消息
+ auto& board = Board::GetInstance();
+ auto display = board.GetDisplay();
+ if (display) {
+ display->SetChatMessage("user", "我听到你的闹钟啦 ✅");
+ display->SetEmotion("happy");
+ }
+ }
+ }
+
+ // 更新显示(使用真实的播放时间)
+ if (is_music_playing_) {
+ display->SetMusicProgress(current_music_name_.c_str(),
+ real_current_seconds,
+ real_duration_seconds,
+ real_progress_percent);
+
+ ESP_LOGD("Application", "Music progress: %s - %d/%d seconds (%.1f%%)",
+ current_music_name_.c_str(), real_current_seconds, real_duration_seconds, real_progress_percent);
+ } else {
+ // 播放结束,清除界面
+ display->ClearMusicInfo();
+ }
}
\ No newline at end of file
diff --git a/main/application.h b/main/application.h
index 4fdfb99..d0d5c57 100644
--- a/main/application.h
+++ b/main/application.h
@@ -1,111 +1,129 @@
-#ifndef _APPLICATION_H_
-#define _APPLICATION_H_
-
-#include
-#include
-#include
-#include
-
-#include
-#include
-#include
-#include
-
-#include "protocol.h"
-#include "ota.h"
-#include "audio_service.h"
-#include "device_state_event.h"
-
-
-#define MAIN_EVENT_SCHEDULE (1 << 0)
-#define MAIN_EVENT_SEND_AUDIO (1 << 1)
-#define MAIN_EVENT_WAKE_WORD_DETECTED (1 << 2)
-#define MAIN_EVENT_VAD_CHANGE (1 << 3)
-#define MAIN_EVENT_ERROR (1 << 4)
-#define MAIN_EVENT_CHECK_NEW_VERSION_DONE (1 << 5)
-#define MAIN_EVENT_CLOCK_TICK (1 << 6)
-
-
-enum AecMode {
- kAecOff,
- kAecOnDeviceSide,
- kAecOnServerSide,
-};
-
-class Application {
-public:
- static Application& GetInstance() {
- static Application instance;
- return instance;
- }
- // 删除拷贝构造函数和赋值运算符
- Application(const Application&) = delete;
- Application& operator=(const Application&) = delete;
-
- void Start();
- void MainEventLoop();
- DeviceState GetDeviceState() const { return device_state_; }
- bool IsVoiceDetected() const { return audio_service_.IsVoiceDetected(); }
- void Schedule(std::function callback);
- void SetDeviceState(DeviceState state);
- void Alert(const char* status, const char* message, const char* emotion = "", const std::string_view& sound = "");
- void DismissAlert();
- void AbortSpeaking(AbortReason reason);
- void ToggleChatState();
- void StartListening();
- void StopListening();
- void Reboot();
- void WakeWordInvoke(const std::string& wake_word);
- bool UpgradeFirmware(Ota& ota, const std::string& url = "");
- bool CanEnterSleepMode();
- void SendMcpMessage(const std::string& payload);
- void SetAecMode(AecMode mode);
- AecMode GetAecMode() const { return aec_mode_; }
- void PlaySound(const std::string_view& sound);
- AudioService& GetAudioService() { return audio_service_; }
- void AddAudioData(AudioStreamPacket&& packet);
-
-private:
- Application();
- ~Application();
-
- std::mutex mutex_;
- std::deque> main_tasks_;
- std::unique_ptr protocol_;
- EventGroupHandle_t event_group_ = nullptr;
- esp_timer_handle_t clock_timer_handle_ = nullptr;
- volatile DeviceState device_state_ = kDeviceStateUnknown;
- ListeningMode listening_mode_ = kListeningModeAutoStop;
- AecMode aec_mode_ = kAecOff;
- std::string last_error_message_;
- AudioService audio_service_;
-
- bool has_server_time_ = false;
- bool aborted_ = false;
- int clock_ticks_ = 0;
- TaskHandle_t check_new_version_task_handle_ = nullptr;
- TaskHandle_t main_event_loop_task_handle_ = nullptr;
-
- void OnWakeWordDetected();
- void CheckNewVersion(Ota& ota);
- void CheckAssetsVersion();
- void ShowActivationCode(const std::string& code, const std::string& message);
- void SetListeningMode(ListeningMode mode);
-};
-
-
-class TaskPriorityReset {
-public:
- TaskPriorityReset(BaseType_t priority) {
- original_priority_ = uxTaskPriorityGet(NULL);
- vTaskPrioritySet(NULL, priority);
- }
- ~TaskPriorityReset() {
- vTaskPrioritySet(NULL, original_priority_);
- }
-
-private:
- BaseType_t original_priority_;
-};
-
-#endif // _APPLICATION_H_
+#ifndef _APPLICATION_H_
+#define _APPLICATION_H_
+
+#include
+#include
+#include
+#include
+
+#include
+#include
+#include
+#include
+
+#include "protocol.h"
+#include "ota.h"
+#include "audio_service.h"
+#include "device_state_event.h"
+#include "alarm_manager.h"
+
+
+#define MAIN_EVENT_SCHEDULE (1 << 0)
+#define MAIN_EVENT_SEND_AUDIO (1 << 1)
+#define MAIN_EVENT_WAKE_WORD_DETECTED (1 << 2)
+#define MAIN_EVENT_VAD_CHANGE (1 << 3)
+#define MAIN_EVENT_ERROR (1 << 4)
+#define MAIN_EVENT_CHECK_NEW_VERSION_DONE (1 << 5)
+#define MAIN_EVENT_CLOCK_TICK (1 << 6)
+
+
+enum AecMode {
+ kAecOff,
+ kAecOnDeviceSide,
+ kAecOnServerSide,
+};
+
+class Application {
+public:
+ static Application& GetInstance() {
+ static Application instance;
+ return instance;
+ }
+ // 删除拷贝构造函数和赋值运算符
+ Application(const Application&) = delete;
+ Application& operator=(const Application&) = delete;
+
+ void Start();
+ void MainEventLoop();
+ DeviceState GetDeviceState() const { return device_state_; }
+ bool IsVoiceDetected() const { return audio_service_.IsVoiceDetected(); }
+ void Schedule(std::function callback);
+ void SetDeviceState(DeviceState state);
+ void Alert(const char* status, const char* message, const char* emotion = "", const std::string_view& sound = "");
+ void DismissAlert();
+ void AbortSpeaking(AbortReason reason);
+ void ToggleChatState();
+ void StartListening();
+ void StopListening();
+ void Reboot();
+ void WakeWordInvoke(const std::string& wake_word);
+ bool UpgradeFirmware(Ota& ota, const std::string& url = "");
+ bool CanEnterSleepMode();
+ void SendMcpMessage(const std::string& payload);
+ void SetAecMode(AecMode mode);
+ AecMode GetAecMode() const { return aec_mode_; }
+ void PlaySound(const std::string_view& sound);
+ // 新增:接收外部音频数据(如音乐播放)
+ void AddAudioData(AudioStreamPacket&& packet);
+ AudioService& GetAudioService() { return audio_service_; }
+
+ // 闹钟功能
+ AlarmManager& GetAlarmManager() { return AlarmManager::GetInstance(); }
+ std::vector GetDefaultAlarmMusicList() const;
+
+private:
+ Application();
+ ~Application();
+
+ std::mutex mutex_;
+ std::deque> main_tasks_;
+ std::unique_ptr protocol_;
+ EventGroupHandle_t event_group_ = nullptr;
+ esp_timer_handle_t clock_timer_handle_ = nullptr;
+ volatile DeviceState device_state_ = kDeviceStateUnknown;
+ ListeningMode listening_mode_ = kListeningModeAutoStop;
+ AecMode aec_mode_ = kAecOff;
+ std::string last_error_message_;
+ AudioService audio_service_;
+
+ bool has_server_time_ = false;
+ bool aborted_ = false;
+ int clock_ticks_ = 0;
+ TaskHandle_t check_new_version_task_handle_ = nullptr;
+ TaskHandle_t main_event_loop_task_handle_ = nullptr;
+
+ void OnWakeWordDetected();
+ void CheckNewVersion(Ota& ota);
+ void CheckAssetsVersion();
+ void ShowActivationCode(const std::string& code, const std::string& message);
+ void SetListeningMode(ListeningMode mode);
+
+ // 闹钟相关私有方法
+ void OnAlarmTriggered(const AlarmItem& alarm);
+ void OnAlarmSnoozed(const AlarmItem& alarm);
+ void OnAlarmStopped(const AlarmItem& alarm);
+
+ // 音乐进度跟踪相关
+ void UpdateMusicProgress();
+ std::string current_music_name_;
+ int64_t music_start_time_ms_ = 0; // 音乐开始播放的时间戳
+ int music_duration_seconds_ = 180; // 默认歌曲长度(3分钟)
+ bool is_music_playing_ = false;
+};
+
+
+class TaskPriorityReset {
+public:
+ TaskPriorityReset(BaseType_t priority) {
+ original_priority_ = uxTaskPriorityGet(NULL);
+ vTaskPrioritySet(NULL, priority);
+ }
+ ~TaskPriorityReset() {
+ vTaskPrioritySet(NULL, original_priority_);
+ }
+
+private:
+ BaseType_t original_priority_;
+};
+
+#endif // _APPLICATION_H_
diff --git a/main/assets.cc b/main/assets.cc
index 48d790f..94b602e 100644
--- a/main/assets.cc
+++ b/main/assets.cc
@@ -1,406 +1,517 @@
-#include "assets.h"
-#include "board.h"
-#include "display.h"
-#include "application.h"
-#include "lvgl_theme.h"
-
-#include
-#include
-#include
-#include
-
-
-#define TAG "Assets"
-
-struct mmap_assets_table {
- char asset_name[32]; /*!< Name of the asset */
- uint32_t asset_size; /*!< Size of the asset */
- uint32_t asset_offset; /*!< Offset of the asset */
- uint16_t asset_width; /*!< Width of the asset */
- uint16_t asset_height; /*!< Height of the asset */
-};
-
-
-Assets::Assets(std::string default_assets_url) {
- if (default_assets_url.find("http") == 0) {
- default_assets_url_ = default_assets_url;
- } else {
- ESP_LOGE(TAG, "The default assets url is not a http url: %s", default_assets_url.c_str());
- }
-
- // Initialize the partition
- InitializePartition();
-}
-
-Assets::~Assets() {
- if (mmap_handle_ != 0) {
- esp_partition_munmap(mmap_handle_);
- }
-}
-
-uint32_t Assets::CalculateChecksum(const char* data, uint32_t length) {
- uint32_t checksum = 0;
- for (uint32_t i = 0; i < length; i++) {
- checksum += data[i];
- }
- return checksum & 0xFFFF;
-}
-
-bool Assets::InitializePartition() {
- partition_valid_ = false;
- checksum_valid_ = false;
- assets_.clear();
-
- partition_ = esp_partition_find_first(ESP_PARTITION_TYPE_ANY, ESP_PARTITION_SUBTYPE_ANY, "assets");
- if (partition_ == nullptr) {
- ESP_LOGI(TAG, "No assets partition found");
- return false;
- }
-
- int free_pages = spi_flash_mmap_get_free_pages(SPI_FLASH_MMAP_DATA);
- uint32_t storage_size = free_pages * 64 * 1024;
- ESP_LOGI(TAG, "The storage free size is %ld KB", storage_size / 1024);
- ESP_LOGI(TAG, "The partition size is %ld KB", partition_->size / 1024);
- if (storage_size < partition_->size) {
- ESP_LOGE(TAG, "The free size %ld KB is less than assets partition required %ld KB", storage_size / 1024, partition_->size / 1024);
- return false;
- }
-
- esp_err_t err = esp_partition_mmap(partition_, 0, partition_->size, ESP_PARTITION_MMAP_DATA, (const void**)&mmap_root_, &mmap_handle_);
- if (err != ESP_OK) {
- ESP_LOGE(TAG, "Failed to mmap assets partition: %s", esp_err_to_name(err));
- return false;
- }
-
- partition_valid_ = true;
-
- uint32_t stored_files = *(uint32_t*)(mmap_root_ + 0);
- uint32_t stored_chksum = *(uint32_t*)(mmap_root_ + 4);
- uint32_t stored_len = *(uint32_t*)(mmap_root_ + 8);
-
- if (stored_len > partition_->size - 12) {
- ESP_LOGD(TAG, "The stored_len (0x%lx) is greater than the partition size (0x%lx) - 12", stored_len, partition_->size);
- return false;
- }
-
- auto start_time = esp_timer_get_time();
- uint32_t calculated_checksum = CalculateChecksum(mmap_root_ + 12, stored_len);
- auto end_time = esp_timer_get_time();
- ESP_LOGI(TAG, "The checksum calculation time is %d ms", int((end_time - start_time) / 1000));
-
- if (calculated_checksum != stored_chksum) {
- ESP_LOGE(TAG, "The calculated checksum (0x%lx) does not match the stored checksum (0x%lx)", calculated_checksum, stored_chksum);
- return false;
- }
-
- checksum_valid_ = true;
-
- for (uint32_t i = 0; i < stored_files; i++) {
- auto item = (const mmap_assets_table*)(mmap_root_ + 12 + i * sizeof(mmap_assets_table));
- auto asset = Asset{
- .size = static_cast(item->asset_size),
- .offset = static_cast(12 + sizeof(mmap_assets_table) * stored_files + item->asset_offset)
- };
- assets_[item->asset_name] = asset;
- }
- return checksum_valid_;
-}
-
-bool Assets::Apply() {
- void* ptr = nullptr;
- size_t size = 0;
- if (!GetAssetData("index.json", ptr, size)) {
- ESP_LOGE(TAG, "The index.json file is not found");
- return false;
- }
- cJSON* root = cJSON_ParseWithLength(static_cast(ptr), size);
- if (root == nullptr) {
- ESP_LOGE(TAG, "The index.json file is not valid");
- return false;
- }
-
- cJSON* version = cJSON_GetObjectItem(root, "version");
- if (cJSON_IsNumber(version)) {
- if (version->valuedouble > 1) {
- ESP_LOGE(TAG, "The assets version %d is not supported, please upgrade the firmware", version->valueint);
- return false;
- }
- }
-
- cJSON* srmodels = cJSON_GetObjectItem(root, "srmodels");
- if (cJSON_IsString(srmodels)) {
- std::string srmodels_file = srmodels->valuestring;
- if (GetAssetData(srmodels_file, ptr, size)) {
- if (models_list_ != nullptr) {
- esp_srmodel_deinit(models_list_);
- models_list_ = nullptr;
- }
- models_list_ = srmodel_load(static_cast(ptr));
- if (models_list_ != nullptr) {
- auto& app = Application::GetInstance();
- app.GetAudioService().SetModelsList(models_list_);
- } else {
- ESP_LOGE(TAG, "Failed to load srmodels.bin");
- }
- } else {
- ESP_LOGE(TAG, "The srmodels file %s is not found", srmodels_file.c_str());
- }
- }
-
-#ifdef HAVE_LVGL
- auto& theme_manager = LvglThemeManager::GetInstance();
- auto light_theme = theme_manager.GetTheme("light");
- auto dark_theme = theme_manager.GetTheme("dark");
-
- cJSON* font = cJSON_GetObjectItem(root, "text_font");
- if (cJSON_IsString(font)) {
- std::string fonts_text_file = font->valuestring;
- if (GetAssetData(fonts_text_file, ptr, size)) {
- auto text_font = std::make_shared(ptr);
- if (text_font->font() == nullptr) {
- ESP_LOGE(TAG, "Failed to load fonts.bin");
- return false;
- }
- if (light_theme != nullptr) {
- light_theme->set_text_font(text_font);
- }
- if (dark_theme != nullptr) {
- dark_theme->set_text_font(text_font);
- }
- } else {
- ESP_LOGE(TAG, "The font file %s is not found", fonts_text_file.c_str());
- }
- }
-
- cJSON* emoji_collection = cJSON_GetObjectItem(root, "emoji_collection");
- if (cJSON_IsArray(emoji_collection)) {
- auto custom_emoji_collection = std::make_shared();
- int emoji_count = cJSON_GetArraySize(emoji_collection);
- for (int i = 0; i < emoji_count; i++) {
- cJSON* emoji = cJSON_GetArrayItem(emoji_collection, i);
- if (cJSON_IsObject(emoji)) {
- cJSON* name = cJSON_GetObjectItem(emoji, "name");
- cJSON* file = cJSON_GetObjectItem(emoji, "file");
- if (cJSON_IsString(name) && cJSON_IsString(file)) {
- if (!GetAssetData(file->valuestring, ptr, size)) {
- ESP_LOGE(TAG, "Emoji %s image file %s is not found", name->valuestring, file->valuestring);
- continue;
- }
- custom_emoji_collection->AddEmoji(name->valuestring, new LvglRawImage(ptr, size));
- }
- }
- }
- if (light_theme != nullptr) {
- light_theme->set_emoji_collection(custom_emoji_collection);
- }
- if (dark_theme != nullptr) {
- dark_theme->set_emoji_collection(custom_emoji_collection);
- }
- }
-
- cJSON* skin = cJSON_GetObjectItem(root, "skin");
- if (cJSON_IsObject(skin)) {
- cJSON* light_skin = cJSON_GetObjectItem(skin, "light");
- if (cJSON_IsObject(light_skin) && light_theme != nullptr) {
- cJSON* text_color = cJSON_GetObjectItem(light_skin, "text_color");
- cJSON* background_color = cJSON_GetObjectItem(light_skin, "background_color");
- cJSON* background_image = cJSON_GetObjectItem(light_skin, "background_image");
- if (cJSON_IsString(text_color)) {
- light_theme->set_text_color(LvglTheme::ParseColor(text_color->valuestring));
- }
- if (cJSON_IsString(background_color)) {
- light_theme->set_background_color(LvglTheme::ParseColor(background_color->valuestring));
- light_theme->set_chat_background_color(LvglTheme::ParseColor(background_color->valuestring));
- }
- if (cJSON_IsString(background_image)) {
- if (!GetAssetData(background_image->valuestring, ptr, size)) {
- ESP_LOGE(TAG, "The background image file %s is not found", background_image->valuestring);
- return false;
- }
- auto background_image = std::make_shared(ptr);
- light_theme->set_background_image(background_image);
- }
- }
- cJSON* dark_skin = cJSON_GetObjectItem(skin, "dark");
- if (cJSON_IsObject(dark_skin) && dark_theme != nullptr) {
- cJSON* text_color = cJSON_GetObjectItem(dark_skin, "text_color");
- cJSON* background_color = cJSON_GetObjectItem(dark_skin, "background_color");
- cJSON* background_image = cJSON_GetObjectItem(dark_skin, "background_image");
- if (cJSON_IsString(text_color)) {
- dark_theme->set_text_color(LvglTheme::ParseColor(text_color->valuestring));
- }
- if (cJSON_IsString(background_color)) {
- dark_theme->set_background_color(LvglTheme::ParseColor(background_color->valuestring));
- dark_theme->set_chat_background_color(LvglTheme::ParseColor(background_color->valuestring));
- }
- if (cJSON_IsString(background_image)) {
- if (!GetAssetData(background_image->valuestring, ptr, size)) {
- ESP_LOGE(TAG, "The background image file %s is not found", background_image->valuestring);
- return false;
- }
- auto background_image = std::make_shared(ptr);
- dark_theme->set_background_image(background_image);
- }
- }
- }
-#endif
-
- auto display = Board::GetInstance().GetDisplay();
- ESP_LOGI(TAG, "Refreshing display theme...");
-
- auto current_theme = display->GetTheme();
- if (current_theme != nullptr) {
- display->SetTheme(current_theme);
- }
- cJSON_Delete(root);
- return true;
-}
-
-bool Assets::Download(std::string url, std::function progress_callback) {
- ESP_LOGI(TAG, "Downloading new version of assets from %s", url.c_str());
-
- // 取消当前资源分区的内存映射
- if (mmap_handle_ != 0) {
- esp_partition_munmap(mmap_handle_);
- mmap_handle_ = 0;
- mmap_root_ = nullptr;
- }
- checksum_valid_ = false;
- assets_.clear();
-
- // 下载新的资源文件
- auto network = Board::GetInstance().GetNetwork();
- auto http = network->CreateHttp(0);
-
- if (!http->Open("GET", url)) {
- ESP_LOGE(TAG, "Failed to open HTTP connection");
- return false;
- }
-
- if (http->GetStatusCode() != 200) {
- ESP_LOGE(TAG, "Failed to get assets, status code: %d", http->GetStatusCode());
- return false;
- }
-
- size_t content_length = http->GetBodyLength();
- if (content_length == 0) {
- ESP_LOGE(TAG, "Failed to get content length");
- return false;
- }
-
- if (content_length > partition_->size) {
- ESP_LOGE(TAG, "Assets file size (%u) is larger than partition size (%lu)", content_length, partition_->size);
- return false;
- }
-
- // 定义扇区大小为4KB(ESP32的标准扇区大小)
- const size_t SECTOR_SIZE = esp_partition_get_main_flash_sector_size();
-
- // 计算需要擦除的扇区数量
- size_t sectors_to_erase = (content_length + SECTOR_SIZE - 1) / SECTOR_SIZE; // 向上取整
- size_t total_erase_size = sectors_to_erase * SECTOR_SIZE;
-
- ESP_LOGI(TAG, "Sector size: %u, content length: %u, sectors to erase: %u, total erase size: %u",
- SECTOR_SIZE, content_length, sectors_to_erase, total_erase_size);
-
- // 写入新的资源文件到分区,一边erase一边写入
- char buffer[512];
- size_t total_written = 0;
- size_t recent_written = 0;
- size_t current_sector = 0;
- auto last_calc_time = esp_timer_get_time();
-
- while (true) {
- int ret = http->Read(buffer, sizeof(buffer));
- if (ret < 0) {
- ESP_LOGE(TAG, "Failed to read HTTP data: %s", esp_err_to_name(ret));
- return false;
- }
-
- if (ret == 0) {
- break;
- }
-
- // 检查是否需要擦除新的扇区
- size_t write_end_offset = total_written + ret;
- size_t needed_sectors = (write_end_offset + SECTOR_SIZE - 1) / SECTOR_SIZE;
-
- // 擦除需要的新扇区
- while (current_sector < needed_sectors) {
- size_t sector_start = current_sector * SECTOR_SIZE;
- size_t sector_end = (current_sector + 1) * SECTOR_SIZE;
-
- // 确保擦除范围不超过分区大小
- if (sector_end > partition_->size) {
- ESP_LOGE(TAG, "Sector end (%u) exceeds partition size (%lu)", sector_end, partition_->size);
- return false;
- }
-
- ESP_LOGD(TAG, "Erasing sector %u (offset: %u, size: %u)", current_sector, sector_start, SECTOR_SIZE);
- esp_err_t err = esp_partition_erase_range(partition_, sector_start, SECTOR_SIZE);
- if (err != ESP_OK) {
- ESP_LOGE(TAG, "Failed to erase sector %u at offset %u: %s", current_sector, sector_start, esp_err_to_name(err));
- return false;
- }
-
- current_sector++;
- }
-
- // 写入数据到分区
- esp_err_t err = esp_partition_write(partition_, total_written, buffer, ret);
- if (err != ESP_OK) {
- ESP_LOGE(TAG, "Failed to write to assets partition at offset %u: %s", total_written, esp_err_to_name(err));
- return false;
- }
-
- total_written += ret;
- recent_written += ret;
-
- // 计算进度和速度
- if (esp_timer_get_time() - last_calc_time >= 1000000 || total_written == content_length || ret == 0) {
- size_t progress = total_written * 100 / content_length;
- size_t speed = recent_written; // 每秒的字节数
- ESP_LOGI(TAG, "Progress: %u%% (%u/%u), Speed: %u B/s, Sectors erased: %u",
- progress, total_written, content_length, speed, current_sector);
- if (progress_callback) {
- progress_callback(progress, speed);
- }
- last_calc_time = esp_timer_get_time();
- recent_written = 0; // 重置最近写入的字节数
- }
- }
-
- http->Close();
-
- if (total_written != content_length) {
- ESP_LOGE(TAG, "Downloaded size (%u) does not match expected size (%u)", total_written, content_length);
- return false;
- }
-
- ESP_LOGI(TAG, "Assets download completed, total written: %u bytes, total sectors erased: %u",
- total_written, current_sector);
-
- // 重新初始化资源分区
- if (!InitializePartition()) {
- ESP_LOGE(TAG, "Failed to re-initialize assets partition");
- return false;
- }
-
- return true;
-}
-
-bool Assets::GetAssetData(const std::string& name, void*& ptr, size_t& size) {
- auto asset = assets_.find(name);
- if (asset == assets_.end()) {
- return false;
- }
- auto data = (const char*)(mmap_root_ + asset->second.offset);
- if (data[0] != 'Z' || data[1] != 'Z') {
- ESP_LOGE(TAG, "The asset %s is not valid with magic %02x%02x", name.c_str(), data[0], data[1]);
- return false;
- }
-
- ptr = static_cast(const_cast(data + 2));
- size = asset->second.size;
- return true;
-}
+#include "assets.h"
+#include "board.h"
+#include "display.h"
+#include "application.h"
+#include "lvgl_theme.h"
+#include "emote_display.h"
+
+#include
+#include
+#include
+#include
+
+
+#define TAG "Assets"
+
+struct mmap_assets_table {
+ char asset_name[32]; /*!< Name of the asset */
+ uint32_t asset_size; /*!< Size of the asset */
+ uint32_t asset_offset; /*!< Offset of the asset */
+ uint16_t asset_width; /*!< Width of the asset */
+ uint16_t asset_height; /*!< Height of the asset */
+};
+
+
+Assets::Assets() {
+ // Initialize the partition
+ InitializePartition();
+}
+
+Assets::~Assets() {
+ if (mmap_handle_ != 0) {
+ esp_partition_munmap(mmap_handle_);
+ }
+}
+
+uint32_t Assets::CalculateChecksum(const char* data, uint32_t length) {
+ uint32_t checksum = 0;
+ for (uint32_t i = 0; i < length; i++) {
+ checksum += data[i];
+ }
+ return checksum & 0xFFFF;
+}
+
+bool Assets::InitializePartition() {
+ partition_valid_ = false;
+ checksum_valid_ = false;
+ assets_.clear();
+
+ partition_ = esp_partition_find_first(ESP_PARTITION_TYPE_ANY, ESP_PARTITION_SUBTYPE_ANY, "assets");
+ if (partition_ == nullptr) {
+ ESP_LOGI(TAG, "No assets partition found");
+ return false;
+ }
+
+ int free_pages = spi_flash_mmap_get_free_pages(SPI_FLASH_MMAP_DATA);
+ uint32_t storage_size = free_pages * 64 * 1024;
+ ESP_LOGI(TAG, "The storage free size is %ld KB", storage_size / 1024);
+ ESP_LOGI(TAG, "The partition size is %ld KB", partition_->size / 1024);
+ if (storage_size < partition_->size) {
+ ESP_LOGE(TAG, "The free size %ld KB is less than assets partition required %ld KB", storage_size / 1024, partition_->size / 1024);
+ return false;
+ }
+
+ esp_err_t err = esp_partition_mmap(partition_, 0, partition_->size, ESP_PARTITION_MMAP_DATA, (const void**)&mmap_root_, &mmap_handle_);
+ if (err != ESP_OK) {
+ ESP_LOGE(TAG, "Failed to mmap assets partition: %s", esp_err_to_name(err));
+ return false;
+ }
+
+ partition_valid_ = true;
+
+ uint32_t stored_files = *(uint32_t*)(mmap_root_ + 0);
+ uint32_t stored_chksum = *(uint32_t*)(mmap_root_ + 4);
+ uint32_t stored_len = *(uint32_t*)(mmap_root_ + 8);
+
+ if (stored_len > partition_->size - 12) {
+ ESP_LOGD(TAG, "The stored_len (0x%lx) is greater than the partition size (0x%lx) - 12", stored_len, partition_->size);
+ return false;
+ }
+
+ auto start_time = esp_timer_get_time();
+ uint32_t calculated_checksum = CalculateChecksum(mmap_root_ + 12, stored_len);
+ auto end_time = esp_timer_get_time();
+ ESP_LOGI(TAG, "The checksum calculation time is %d ms", int((end_time - start_time) / 1000));
+
+ if (calculated_checksum != stored_chksum) {
+ ESP_LOGE(TAG, "The calculated checksum (0x%lx) does not match the stored checksum (0x%lx)", calculated_checksum, stored_chksum);
+ return false;
+ }
+
+ checksum_valid_ = true;
+
+ for (uint32_t i = 0; i < stored_files; i++) {
+ auto item = (const mmap_assets_table*)(mmap_root_ + 12 + i * sizeof(mmap_assets_table));
+ auto asset = Asset{
+ .size = static_cast(item->asset_size),
+ .offset = static_cast(12 + sizeof(mmap_assets_table) * stored_files + item->asset_offset)
+ };
+ assets_[item->asset_name] = asset;
+ }
+ return checksum_valid_;
+}
+
+bool Assets::Apply() {
+ void* ptr = nullptr;
+ size_t size = 0;
+ if (!GetAssetData("index.json", ptr, size)) {
+ ESP_LOGE(TAG, "The index.json file is not found");
+ return false;
+ }
+
+ cJSON* root = cJSON_ParseWithLength(static_cast(ptr), size);
+ if (root == nullptr) {
+ ESP_LOGE(TAG, "The index.json file is not valid");
+ return false;
+ }
+
+ cJSON* version = cJSON_GetObjectItem(root, "version");
+ if (cJSON_IsNumber(version)) {
+ if (version->valuedouble > 1) {
+ ESP_LOGE(TAG, "The assets version %d is not supported, please upgrade the firmware", version->valueint);
+ return false;
+ }
+ }
+
+ cJSON* srmodels = cJSON_GetObjectItem(root, "srmodels");
+ if (cJSON_IsString(srmodels)) {
+ std::string srmodels_file = srmodels->valuestring;
+ if (GetAssetData(srmodels_file, ptr, size)) {
+ if (models_list_ != nullptr) {
+ esp_srmodel_deinit(models_list_);
+ models_list_ = nullptr;
+ }
+ models_list_ = srmodel_load(static_cast(ptr));
+ if (models_list_ != nullptr) {
+ auto& app = Application::GetInstance();
+ app.GetAudioService().SetModelsList(models_list_);
+ } else {
+ ESP_LOGE(TAG, "Failed to load srmodels.bin");
+ }
+ } else {
+ ESP_LOGE(TAG, "The srmodels file %s is not found", srmodels_file.c_str());
+ }
+ }
+
+#ifdef HAVE_LVGL
+ auto& theme_manager = LvglThemeManager::GetInstance();
+ auto light_theme = theme_manager.GetTheme("light");
+ auto dark_theme = theme_manager.GetTheme("dark");
+
+ cJSON* font = cJSON_GetObjectItem(root, "text_font");
+ if (cJSON_IsString(font)) {
+ std::string fonts_text_file = font->valuestring;
+ if (GetAssetData(fonts_text_file, ptr, size)) {
+ auto text_font = std::make_shared(ptr);
+ if (text_font->font() == nullptr) {
+ ESP_LOGE(TAG, "Failed to load fonts.bin");
+ return false;
+ }
+ if (light_theme != nullptr) {
+ light_theme->set_text_font(text_font);
+ }
+ if (dark_theme != nullptr) {
+ dark_theme->set_text_font(text_font);
+ }
+ } else {
+ ESP_LOGE(TAG, "The font file %s is not found", fonts_text_file.c_str());
+ }
+ }
+
+ cJSON* emoji_collection = cJSON_GetObjectItem(root, "emoji_collection");
+ if (cJSON_IsArray(emoji_collection)) {
+ auto custom_emoji_collection = std::make_shared();
+ int emoji_count = cJSON_GetArraySize(emoji_collection);
+ for (int i = 0; i < emoji_count; i++) {
+ cJSON* emoji = cJSON_GetArrayItem(emoji_collection, i);
+ if (cJSON_IsObject(emoji)) {
+ cJSON* name = cJSON_GetObjectItem(emoji, "name");
+ cJSON* file = cJSON_GetObjectItem(emoji, "file");
+ cJSON* eaf = cJSON_GetObjectItem(emoji, "eaf");
+ if (cJSON_IsString(name) && cJSON_IsString(file) && (NULL== eaf)) {
+ if (!GetAssetData(file->valuestring, ptr, size)) {
+ ESP_LOGE(TAG, "Emoji %s image file %s is not found", name->valuestring, file->valuestring);
+ continue;
+ }
+ custom_emoji_collection->AddEmoji(name->valuestring, new LvglRawImage(ptr, size));
+ }
+ }
+ }
+ if (light_theme != nullptr) {
+ light_theme->set_emoji_collection(custom_emoji_collection);
+ }
+ if (dark_theme != nullptr) {
+ dark_theme->set_emoji_collection(custom_emoji_collection);
+ }
+ }
+
+ cJSON* skin = cJSON_GetObjectItem(root, "skin");
+ if (cJSON_IsObject(skin)) {
+ cJSON* light_skin = cJSON_GetObjectItem(skin, "light");
+ if (cJSON_IsObject(light_skin) && light_theme != nullptr) {
+ cJSON* text_color = cJSON_GetObjectItem(light_skin, "text_color");
+ cJSON* background_color = cJSON_GetObjectItem(light_skin, "background_color");
+ cJSON* background_image = cJSON_GetObjectItem(light_skin, "background_image");
+ if (cJSON_IsString(text_color)) {
+ light_theme->set_text_color(LvglTheme::ParseColor(text_color->valuestring));
+ }
+ if (cJSON_IsString(background_color)) {
+ light_theme->set_background_color(LvglTheme::ParseColor(background_color->valuestring));
+ light_theme->set_chat_background_color(LvglTheme::ParseColor(background_color->valuestring));
+ }
+ if (cJSON_IsString(background_image)) {
+ if (!GetAssetData(background_image->valuestring, ptr, size)) {
+ ESP_LOGE(TAG, "The background image file %s is not found", background_image->valuestring);
+ return false;
+ }
+ auto background_image = std::make_shared(ptr);
+ light_theme->set_background_image(background_image);
+ }
+ }
+ cJSON* dark_skin = cJSON_GetObjectItem(skin, "dark");
+ if (cJSON_IsObject(dark_skin) && dark_theme != nullptr) {
+ cJSON* text_color = cJSON_GetObjectItem(dark_skin, "text_color");
+ cJSON* background_color = cJSON_GetObjectItem(dark_skin, "background_color");
+ cJSON* background_image = cJSON_GetObjectItem(dark_skin, "background_image");
+ if (cJSON_IsString(text_color)) {
+ dark_theme->set_text_color(LvglTheme::ParseColor(text_color->valuestring));
+ }
+ if (cJSON_IsString(background_color)) {
+ dark_theme->set_background_color(LvglTheme::ParseColor(background_color->valuestring));
+ dark_theme->set_chat_background_color(LvglTheme::ParseColor(background_color->valuestring));
+ }
+ if (cJSON_IsString(background_image)) {
+ if (!GetAssetData(background_image->valuestring, ptr, size)) {
+ ESP_LOGE(TAG, "The background image file %s is not found", background_image->valuestring);
+ return false;
+ }
+ auto background_image = std::make_shared(ptr);
+ dark_theme->set_background_image(background_image);
+ }
+ }
+ }
+
+ auto display = Board::GetInstance().GetDisplay();
+ ESP_LOGI(TAG, "Refreshing display theme...");
+
+ auto current_theme = display->GetTheme();
+ if (current_theme != nullptr) {
+ display->SetTheme(current_theme);
+ }
+#elif defined(CONFIG_USE_EMOTE_MESSAGE_STYLE)
+ auto &board = Board::GetInstance();
+ auto display = board.GetDisplay();
+ auto emote_display = dynamic_cast(display);
+
+ cJSON* font = cJSON_GetObjectItem(root, "text_font");
+ if (cJSON_IsString(font)) {
+ std::string fonts_text_file = font->valuestring;
+ if (GetAssetData(fonts_text_file, ptr, size)) {
+ auto text_font = std::make_shared(ptr);
+ if (text_font->font() == nullptr) {
+ ESP_LOGE(TAG, "Failed to load fonts.bin");
+ return false;
+ }
+
+ if (emote_display) {
+ emote_display->AddTextFont(text_font);
+ }
+ } else {
+ ESP_LOGE(TAG, "The font file %s is not found", fonts_text_file.c_str());
+ }
+ }
+
+ cJSON* emoji_collection = cJSON_GetObjectItem(root, "emoji_collection");
+ if (cJSON_IsArray(emoji_collection)) {
+ int emoji_count = cJSON_GetArraySize(emoji_collection);
+ if (emote_display) {
+ for (int i = 0; i < emoji_count; i++) {
+ cJSON* icon = cJSON_GetArrayItem(emoji_collection, i);
+ if (cJSON_IsObject(icon)) {
+ cJSON* name = cJSON_GetObjectItem(icon, "name");
+ cJSON* file = cJSON_GetObjectItem(icon, "file");
+
+ if (cJSON_IsString(name) && cJSON_IsString(file)) {
+ if (GetAssetData(file->valuestring, ptr, size)) {
+ cJSON* eaf = cJSON_GetObjectItem(icon, "eaf");
+ bool lack_value = false;
+ bool loop_value = false;
+ int fps_value = 0;
+
+ if (cJSON_IsObject(eaf)) {
+ cJSON* lack = cJSON_GetObjectItem(eaf, "lack");
+ cJSON* loop = cJSON_GetObjectItem(eaf, "loop");
+ cJSON* fps = cJSON_GetObjectItem(eaf, "fps");
+
+ lack_value = lack ? cJSON_IsTrue(lack) : false;
+ loop_value = loop ? cJSON_IsTrue(loop) : false;
+ fps_value = fps ? fps->valueint : 0;
+
+ emote_display->AddEmojiData(name->valuestring, ptr, size,
+ static_cast(fps_value),
+ loop_value, lack_value);
+ }
+
+ } else {
+ ESP_LOGE(TAG, "Emoji \"%10s\" image file %s is not found", name->valuestring, file->valuestring);
+ }
+ }
+ }
+ }
+ }
+ }
+
+ cJSON* icon_collection = cJSON_GetObjectItem(root, "icon_collection");
+ if (cJSON_IsArray(icon_collection)) {
+ if (emote_display) {
+ int icon_count = cJSON_GetArraySize(icon_collection);
+ for (int i = 0; i < icon_count; i++) {
+ cJSON* icon = cJSON_GetArrayItem(icon_collection, i);
+ if (cJSON_IsObject(icon)) {
+ cJSON* name = cJSON_GetObjectItem(icon, "name");
+ cJSON* file = cJSON_GetObjectItem(icon, "file");
+
+ if (cJSON_IsString(name) && cJSON_IsString(file)) {
+ if (GetAssetData(file->valuestring, ptr, size)) {
+ emote_display->AddIconData(name->valuestring, ptr, size);
+ } else {
+ ESP_LOGE(TAG, "Icon \"%10s\" image file %s is not found", name->valuestring, file->valuestring);
+ }
+ }
+ }
+ }
+ }
+ }
+
+ cJSON* layout_json = cJSON_GetObjectItem(root, "layout");
+ if (cJSON_IsArray(layout_json)) {
+ int layout_count = cJSON_GetArraySize(layout_json);
+
+ for (int i = 0; i < layout_count; i++) {
+ cJSON* layout_item = cJSON_GetArrayItem(layout_json, i);
+ if (cJSON_IsObject(layout_item)) {
+ cJSON* name = cJSON_GetObjectItem(layout_item, "name");
+ cJSON* align = cJSON_GetObjectItem(layout_item, "align");
+ cJSON* x = cJSON_GetObjectItem(layout_item, "x");
+ cJSON* y = cJSON_GetObjectItem(layout_item, "y");
+ cJSON* width = cJSON_GetObjectItem(layout_item, "width");
+ cJSON* height = cJSON_GetObjectItem(layout_item, "height");
+
+ if (cJSON_IsString(name) && cJSON_IsString(align) && cJSON_IsNumber(x) && cJSON_IsNumber(y)) {
+ int width_val = cJSON_IsNumber(width) ? width->valueint : 0;
+ int height_val = cJSON_IsNumber(height) ? height->valueint : 0;
+
+ if (emote_display) {
+ emote_display->AddLayoutData(name->valuestring, align->valuestring,
+ x->valueint, y->valueint, width_val, height_val);
+ }
+ } else {
+ ESP_LOGW(TAG, "Invalid layout item %d: missing required fields", i);
+ }
+ }
+ }
+ }
+#endif
+
+ cJSON_Delete(root);
+ return true;
+}
+
+bool Assets::Download(std::string url, std::function progress_callback) {
+ ESP_LOGI(TAG, "Downloading new version of assets from %s", url.c_str());
+
+ // 取消当前资源分区的内存映射
+ if (mmap_handle_ != 0) {
+ esp_partition_munmap(mmap_handle_);
+ mmap_handle_ = 0;
+ mmap_root_ = nullptr;
+ }
+ checksum_valid_ = false;
+ assets_.clear();
+
+ // 下载新的资源文件
+ auto network = Board::GetInstance().GetNetwork();
+ auto http = network->CreateHttp(0);
+
+ if (!http->Open("GET", url)) {
+ ESP_LOGE(TAG, "Failed to open HTTP connection");
+ return false;
+ }
+
+ if (http->GetStatusCode() != 200) {
+ ESP_LOGE(TAG, "Failed to get assets, status code: %d", http->GetStatusCode());
+ return false;
+ }
+
+ size_t content_length = http->GetBodyLength();
+ if (content_length == 0) {
+ ESP_LOGE(TAG, "Failed to get content length");
+ return false;
+ }
+
+ if (content_length > partition_->size) {
+ ESP_LOGE(TAG, "Assets file size (%u) is larger than partition size (%lu)", content_length, partition_->size);
+ return false;
+ }
+
+ // 定义扇区大小为4KB(ESP32的标准扇区大小)
+ const size_t SECTOR_SIZE = esp_partition_get_main_flash_sector_size();
+
+ // 计算需要擦除的扇区数量
+ size_t sectors_to_erase = (content_length + SECTOR_SIZE - 1) / SECTOR_SIZE; // 向上取整
+ size_t total_erase_size = sectors_to_erase * SECTOR_SIZE;
+
+ ESP_LOGI(TAG, "Sector size: %u, content length: %u, sectors to erase: %u, total erase size: %u",
+ SECTOR_SIZE, content_length, sectors_to_erase, total_erase_size);
+
+ // 写入新的资源文件到分区,一边erase一边写入
+ char buffer[512];
+ size_t total_written = 0;
+ size_t recent_written = 0;
+ size_t current_sector = 0;
+ auto last_calc_time = esp_timer_get_time();
+
+ while (true) {
+ int ret = http->Read(buffer, sizeof(buffer));
+ if (ret < 0) {
+ ESP_LOGE(TAG, "Failed to read HTTP data: %s", esp_err_to_name(ret));
+ return false;
+ }
+
+ if (ret == 0) {
+ break;
+ }
+
+ // 检查是否需要擦除新的扇区
+ size_t write_end_offset = total_written + ret;
+ size_t needed_sectors = (write_end_offset + SECTOR_SIZE - 1) / SECTOR_SIZE;
+
+ // 擦除需要的新扇区
+ while (current_sector < needed_sectors) {
+ size_t sector_start = current_sector * SECTOR_SIZE;
+ size_t sector_end = (current_sector + 1) * SECTOR_SIZE;
+
+ // 确保擦除范围不超过分区大小
+ if (sector_end > partition_->size) {
+ ESP_LOGE(TAG, "Sector end (%u) exceeds partition size (%lu)", sector_end, partition_->size);
+ return false;
+ }
+
+ ESP_LOGD(TAG, "Erasing sector %u (offset: %u, size: %u)", current_sector, sector_start, SECTOR_SIZE);
+ esp_err_t err = esp_partition_erase_range(partition_, sector_start, SECTOR_SIZE);
+ if (err != ESP_OK) {
+ ESP_LOGE(TAG, "Failed to erase sector %u at offset %u: %s", current_sector, sector_start, esp_err_to_name(err));
+ return false;
+ }
+
+ current_sector++;
+ }
+
+ // 写入数据到分区
+ esp_err_t err = esp_partition_write(partition_, total_written, buffer, ret);
+ if (err != ESP_OK) {
+ ESP_LOGE(TAG, "Failed to write to assets partition at offset %u: %s", total_written, esp_err_to_name(err));
+ return false;
+ }
+
+ total_written += ret;
+ recent_written += ret;
+
+ // 计算进度和速度
+ if (esp_timer_get_time() - last_calc_time >= 1000000 || total_written == content_length || ret == 0) {
+ size_t progress = total_written * 100 / content_length;
+ size_t speed = recent_written; // 每秒的字节数
+ ESP_LOGI(TAG, "Progress: %u%% (%u/%u), Speed: %u B/s, Sectors erased: %u",
+ progress, total_written, content_length, speed, current_sector);
+ if (progress_callback) {
+ progress_callback(progress, speed);
+ }
+ last_calc_time = esp_timer_get_time();
+ recent_written = 0; // 重置最近写入的字节数
+ }
+ }
+
+ http->Close();
+
+ if (total_written != content_length) {
+ ESP_LOGE(TAG, "Downloaded size (%u) does not match expected size (%u)", total_written, content_length);
+ return false;
+ }
+
+ ESP_LOGI(TAG, "Assets download completed, total written: %u bytes, total sectors erased: %u",
+ total_written, current_sector);
+
+ // 重新初始化资源分区
+ if (!InitializePartition()) {
+ ESP_LOGE(TAG, "Failed to re-initialize assets partition");
+ return false;
+ }
+
+ return true;
+}
+
+bool Assets::GetAssetData(const std::string& name, void*& ptr, size_t& size) {
+ auto asset = assets_.find(name);
+ if (asset == assets_.end()) {
+ return false;
+ }
+ auto data = (const char*)(mmap_root_ + asset->second.offset);
+ if (data[0] != 'Z' || data[1] != 'Z') {
+ ESP_LOGE(TAG, "The asset %s is not valid with magic %02x%02x", name.c_str(), data[0], data[1]);
+ return false;
+ }
+
+ ptr = static_cast(const_cast(data + 2));
+ size = asset->second.size;
+ return true;
+}
diff --git a/main/assets.h b/main/assets.h
index ff9a59e..5907c0d 100644
--- a/main/assets.h
+++ b/main/assets.h
@@ -1,65 +1,52 @@
-#ifndef ASSETS_H
-#define ASSETS_H
-
-#include
-#include
-#include
-
-#include
-#include
-#include
-
-
-// All combinations of wakenet_model, text_font, emoji_collection can be found from the following url:
-// https://github.com/78/xiaozhi-fonts/releases/tag/assets
-
-#define ASSETS_PUHUI_COMMON_14_1 "none-font_puhui_common_14_1-none.bin"
-#define ASSETS_XIAOZHI_WAKENET "wn9_nihaoxiaozhi_tts-none-none.bin"
-#define ASSETS_XIAOZHI_WAKENET_SMALL "wn9s_nihaoxiaozhi-none-none.bin"
-#define ASSETS_XIAOZHI_PUHUI_COMMON_14_1 "wn9_nihaoxiaozhi_tts-font_puhui_common_14_1-none.bin"
-#define ASSETS_XIAOZHI_PUHUI_COMMON_16_4_EMOJI_32 "wn9_nihaoxiaozhi_tts-font_puhui_common_16_4-emojis_32.bin"
-#define ASSETS_XIAOZHI_PUHUI_COMMON_16_4_EMOJI_64 "wn9_nihaoxiaozhi_tts-font_puhui_common_16_4-emojis_64.bin"
-#define ASSETS_XIAOZHI_PUHUI_COMMON_20_4_EMOJI_64 "wn9_nihaoxiaozhi_tts-font_puhui_common_20_4-emojis_64.bin"
-#define ASSETS_XIAOZHI_PUHUI_COMMON_30_4_EMOJI_64 "wn9_nihaoxiaozhi_tts-font_puhui_common_30_4-emojis_64.bin"
-#define ASSETS_XIAOZHI_S_PUHUI_COMMON_14_1 "wn9s_nihaoxiaozhi-font_puhui_common_14_1-none.bin"
-#define ASSETS_XIAOZHI_S_PUHUI_COMMON_16_4_EMOJI_32 "wn9s_nihaoxiaozhi-font_puhui_common_16_4-emojis_32.bin"
-#define ASSETS_XIAOZHI_S_PUHUI_COMMON_20_4_EMOJI_32 "wn9s_nihaoxiaozhi-font_puhui_common_20_4-emojis_32.bin"
-#define ASSETS_XIAOZHI_S_PUHUI_COMMON_20_4_EMOJI_64 "wn9s_nihaoxiaozhi-font_puhui_common_20_4-emojis_64.bin"
-#define ASSETS_XIAOZHI_S_PUHUI_COMMON_30_4_EMOJI_64 "wn9s_nihaoxiaozhi-font_puhui_common_30_4-emojis_64.bin"
-
-struct Asset {
- size_t size;
- size_t offset;
-};
-
-class Assets {
-public:
- Assets(std::string default_assets_url);
- ~Assets();
-
- bool Download(std::string url, std::function progress_callback);
- bool Apply();
-
- inline bool partition_valid() const { return partition_valid_; }
- inline bool checksum_valid() const { return checksum_valid_; }
- inline std::string default_assets_url() const { return default_assets_url_; }
-
-private:
- Assets(const Assets&) = delete;
- Assets& operator=(const Assets&) = delete;
-
- bool InitializePartition();
- uint32_t CalculateChecksum(const char* data, uint32_t length);
- bool GetAssetData(const std::string& name, void*& ptr, size_t& size);
-
- const esp_partition_t* partition_ = nullptr;
- esp_partition_mmap_handle_t mmap_handle_ = 0;
- const char* mmap_root_ = nullptr;
- bool partition_valid_ = false;
- bool checksum_valid_ = false;
- std::string default_assets_url_;
- srmodel_list_t* models_list_ = nullptr;
- std::map assets_;
-};
-
-#endif
+#ifndef ASSETS_H
+#define ASSETS_H
+
+#include
+#include
+#include
+
+#include
+#include
+#include
+
+
+struct Asset {
+ size_t size;
+ size_t offset;
+};
+
+class Assets {
+public:
+ static Assets& GetInstance() {
+ static Assets instance;
+ return instance;
+ }
+ ~Assets();
+
+ bool Download(std::string url, std::function progress_callback);
+ bool Apply();
+ bool GetAssetData(const std::string& name, void*& ptr, size_t& size);
+
+ inline bool partition_valid() const { return partition_valid_; }
+ inline bool checksum_valid() const { return checksum_valid_; }
+ inline std::string default_assets_url() const { return default_assets_url_; }
+
+private:
+ Assets();
+ Assets(const Assets&) = delete;
+ Assets& operator=(const Assets&) = delete;
+
+ bool InitializePartition();
+ uint32_t CalculateChecksum(const char* data, uint32_t length);
+
+ const esp_partition_t* partition_ = nullptr;
+ esp_partition_mmap_handle_t mmap_handle_ = 0;
+ const char* mmap_root_ = nullptr;
+ bool partition_valid_ = false;
+ bool checksum_valid_ = false;
+ std::string default_assets_url_;
+ srmodel_list_t* models_list_ = nullptr;
+ std::map assets_;
+};
+
+#endif
diff --git a/main/assets/lang_config.h b/main/assets/lang_config.h
index 77479bc..0c28b12 100644
--- a/main/assets/lang_config.h
+++ b/main/assets/lang_config.h
@@ -1,218 +1,218 @@
-// Auto-generated language config
-// Language: zh-CN with en-US fallback
-#pragma once
-
-#include
-
-#ifndef zh_cn
- #define zh_cn // 預設語言
-#endif
-
-namespace Lang {
- // 语言元数据
- constexpr const char* CODE = "zh-CN";
-
- // 字符串资源 (en-US as fallback for missing keys)
- namespace Strings {
- constexpr const char* ACCESS_VIA_BROWSER = ",浏览器访问 ";
- constexpr const char* ACTIVATION = "激活设备";
- constexpr const char* BATTERY_CHARGING = "正在充电";
- constexpr const char* BATTERY_FULL = "电量已满";
- constexpr const char* BATTERY_LOW = "电量不足";
- constexpr const char* BATTERY_NEED_CHARGE = "电量低,请充电";
- constexpr const char* CHECKING_NEW_VERSION = "检查新版本...";
- constexpr const char* CHECK_NEW_VERSION_FAILED = "检查新版本失败,将在 %d 秒后重试:%s";
- constexpr const char* CONNECTED_TO = "已连接 ";
- constexpr const char* CONNECTING = "连接中...";
- constexpr const char* CONNECTION_SUCCESSFUL = "Connection Successful";
- constexpr const char* CONNECT_TO = "连接 ";
- constexpr const char* CONNECT_TO_HOTSPOT = "手机连接热点 ";
- constexpr const char* DETECTING_MODULE = "检测模组...";
- constexpr const char* DOWNLOAD_ASSETS_FAILED = "下载资源失败";
- constexpr const char* ENTERING_WIFI_CONFIG_MODE = "进入配网模式...";
- constexpr const char* ERROR = "错误";
- constexpr const char* FOUND_NEW_ASSETS = "发现新资源: %s";
- constexpr const char* HELLO_MY_FRIEND = "你好,我的朋友!";
- constexpr const char* INFO = "信息";
- constexpr const char* INITIALIZING = "正在初始化...";
- constexpr const char* LISTENING = "聆听中...";
- constexpr const char* LOADING_ASSETS = "加载资源...";
- constexpr const char* LOADING_PROTOCOL = "登录服务器...";
- constexpr const char* MAX_VOLUME = "最大音量";
- constexpr const char* MUTED = "已静音";
- constexpr const char* NEW_VERSION = "新版本 ";
- constexpr const char* OTA_UPGRADE = "OTA 升级";
- constexpr const char* PIN_ERROR = "请插入 SIM 卡";
- constexpr const char* PLEASE_WAIT = "请稍候...";
- constexpr const char* REGISTERING_NETWORK = "等待网络...";
- constexpr const char* REG_ERROR = "无法接入网络,请检查流量卡状态";
- constexpr const char* RTC_MODE_OFF = "AEC 关闭";
- constexpr const char* RTC_MODE_ON = "AEC 开启";
- constexpr const char* SCANNING_WIFI = "扫描 Wi-Fi...";
- constexpr const char* SERVER_ERROR = "发送失败,请检查网络";
- constexpr const char* SERVER_NOT_CONNECTED = "无法连接服务,请稍后再试";
- constexpr const char* SERVER_NOT_FOUND = "正在寻找可用服务";
- constexpr const char* SERVER_TIMEOUT = "等待响应超时";
- constexpr const char* SPEAKING = "说话中...";
- constexpr const char* STANDBY = "待命";
- constexpr const char* SWITCH_TO_4G_NETWORK = "切换到 4G...";
- constexpr const char* SWITCH_TO_WIFI_NETWORK = "切换到 Wi-Fi...";
- constexpr const char* UPGRADE_FAILED = "升级失败";
- constexpr const char* UPGRADING = "正在升级系统...";
- constexpr const char* VERSION = "版本 ";
- constexpr const char* VOLUME = "音量 ";
- constexpr const char* WARNING = "警告";
- constexpr const char* WIFI_CONFIG_MODE = "配网模式";
- }
-
- // 音效资源 (en-US as fallback for missing audio files)
- namespace Sounds {
-
- extern const char ogg_0_start[] asm("_binary_0_ogg_start");
- extern const char ogg_0_end[] asm("_binary_0_ogg_end");
- static const std::string_view OGG_0 {
- static_cast(ogg_0_start),
- static_cast(ogg_0_end - ogg_0_start)
- };
-
- extern const char ogg_1_start[] asm("_binary_1_ogg_start");
- extern const char ogg_1_end[] asm("_binary_1_ogg_end");
- static const std::string_view OGG_1 {
- static_cast(ogg_1_start),
- static_cast(ogg_1_end - ogg_1_start)
- };
-
- extern const char ogg_2_start[] asm("_binary_2_ogg_start");
- extern const char ogg_2_end[] asm("_binary_2_ogg_end");
- static const std::string_view OGG_2 {
- static_cast(ogg_2_start),
- static_cast(ogg_2_end - ogg_2_start)
- };
-
- extern const char ogg_3_start[] asm("_binary_3_ogg_start");
- extern const char ogg_3_end[] asm("_binary_3_ogg_end");
- static const std::string_view OGG_3 {
- static_cast(ogg_3_start),
- static_cast(ogg_3_end - ogg_3_start)
- };
-
- extern const char ogg_4_start[] asm("_binary_4_ogg_start");
- extern const char ogg_4_end[] asm("_binary_4_ogg_end");
- static const std::string_view OGG_4 {
- static_cast(ogg_4_start),
- static_cast(ogg_4_end - ogg_4_start)
- };
-
- extern const char ogg_5_start[] asm("_binary_5_ogg_start");
- extern const char ogg_5_end[] asm("_binary_5_ogg_end");
- static const std::string_view OGG_5 {
- static_cast(ogg_5_start),
- static_cast(ogg_5_end - ogg_5_start)
- };
-
- extern const char ogg_6_start[] asm("_binary_6_ogg_start");
- extern const char ogg_6_end[] asm("_binary_6_ogg_end");
- static const std::string_view OGG_6 {
- static_cast(ogg_6_start),
- static_cast(ogg_6_end - ogg_6_start)
- };
-
- extern const char ogg_7_start[] asm("_binary_7_ogg_start");
- extern const char ogg_7_end[] asm("_binary_7_ogg_end");
- static const std::string_view OGG_7 {
- static_cast(ogg_7_start),
- static_cast(ogg_7_end - ogg_7_start)
- };
-
- extern const char ogg_8_start[] asm("_binary_8_ogg_start");
- extern const char ogg_8_end[] asm("_binary_8_ogg_end");
- static const std::string_view OGG_8 {
- static_cast(ogg_8_start),
- static_cast(ogg_8_end - ogg_8_start)
- };
-
- extern const char ogg_9_start[] asm("_binary_9_ogg_start");
- extern const char ogg_9_end[] asm("_binary_9_ogg_end");
- static const std::string_view OGG_9 {
- static_cast(ogg_9_start),
- static_cast(ogg_9_end - ogg_9_start)
- };
-
- extern const char ogg_activation_start[] asm("_binary_activation_ogg_start");
- extern const char ogg_activation_end[] asm("_binary_activation_ogg_end");
- static const std::string_view OGG_ACTIVATION {
- static_cast(ogg_activation_start),
- static_cast(ogg_activation_end - ogg_activation_start)
- };
-
- extern const char ogg_err_pin_start[] asm("_binary_err_pin_ogg_start");
- extern const char ogg_err_pin_end[] asm("_binary_err_pin_ogg_end");
- static const std::string_view OGG_ERR_PIN {
- static_cast(ogg_err_pin_start),
- static_cast(ogg_err_pin_end - ogg_err_pin_start)
- };
-
- extern const char ogg_err_reg_start[] asm("_binary_err_reg_ogg_start");
- extern const char ogg_err_reg_end[] asm("_binary_err_reg_ogg_end");
- static const std::string_view OGG_ERR_REG {
- static_cast(ogg_err_reg_start),
- static_cast(ogg_err_reg_end - ogg_err_reg_start)
- };
-
- extern const char ogg_exclamation_start[] asm("_binary_exclamation_ogg_start");
- extern const char ogg_exclamation_end[] asm("_binary_exclamation_ogg_end");
- static const std::string_view OGG_EXCLAMATION {
- static_cast(ogg_exclamation_start),
- static_cast(ogg_exclamation_end - ogg_exclamation_start)
- };
-
- extern const char ogg_low_battery_start[] asm("_binary_low_battery_ogg_start");
- extern const char ogg_low_battery_end[] asm("_binary_low_battery_ogg_end");
- static const std::string_view OGG_LOW_BATTERY {
- static_cast(ogg_low_battery_start),
- static_cast(ogg_low_battery_end - ogg_low_battery_start)
- };
-
- extern const char ogg_popup_start[] asm("_binary_popup_ogg_start");
- extern const char ogg_popup_end[] asm("_binary_popup_ogg_end");
- static const std::string_view OGG_POPUP {
- static_cast(ogg_popup_start),
- static_cast(ogg_popup_end - ogg_popup_start)
- };
-
- extern const char ogg_success_start[] asm("_binary_success_ogg_start");
- extern const char ogg_success_end[] asm("_binary_success_ogg_end");
- static const std::string_view OGG_SUCCESS {
- static_cast(ogg_success_start),
- static_cast(ogg_success_end - ogg_success_start)
- };
-
- extern const char ogg_upgrade_start[] asm("_binary_upgrade_ogg_start");
- extern const char ogg_upgrade_end[] asm("_binary_upgrade_ogg_end");
- static const std::string_view OGG_UPGRADE {
- static_cast(ogg_upgrade_start),
- static_cast(ogg_upgrade_end - ogg_upgrade_start)
- };
-
- extern const char ogg_vibration_start[] asm("_binary_vibration_ogg_start");
- extern const char ogg_vibration_end[] asm("_binary_vibration_ogg_end");
- static const std::string_view OGG_VIBRATION {
- static_cast(ogg_vibration_start),
- static_cast(ogg_vibration_end - ogg_vibration_start)
- };
-
- extern const char ogg_welcome_start[] asm("_binary_welcome_ogg_start");
- extern const char ogg_welcome_end[] asm("_binary_welcome_ogg_end");
- static const std::string_view OGG_WELCOME {
- static_cast(ogg_welcome_start),
- static_cast(ogg_welcome_end - ogg_welcome_start)
- };
-
- extern const char ogg_wificonfig_start[] asm("_binary_wificonfig_ogg_start");
- extern const char ogg_wificonfig_end[] asm("_binary_wificonfig_ogg_end");
- static const std::string_view OGG_WIFICONFIG {
- static_cast(ogg_wificonfig_start),
- static_cast(ogg_wificonfig_end - ogg_wificonfig_start)
- };
- }
-}
+// Auto-generated language config
+// Language: en-US with en-US fallback
+#pragma once
+
+#include
+
+#ifndef en_us
+ #define en_us // 預設語言
+#endif
+
+namespace Lang {
+ // 语言元数据
+ constexpr const char* CODE = "en-US";
+
+ // 字符串资源 (en-US as fallback for missing keys)
+ namespace Strings {
+ constexpr const char* ACCESS_VIA_BROWSER = " Config URL: ";
+ constexpr const char* ACTIVATION = "Activation";
+ constexpr const char* BATTERY_CHARGING = "Charging";
+ constexpr const char* BATTERY_FULL = "Battery full";
+ constexpr const char* BATTERY_LOW = "Low battery";
+ constexpr const char* BATTERY_NEED_CHARGE = "Low battery, please charge";
+ constexpr const char* CHECKING_NEW_VERSION = "Checking for new version...";
+ constexpr const char* CHECK_NEW_VERSION_FAILED = "Check for new version failed, will retry in %d seconds: %s";
+ constexpr const char* CONNECTED_TO = "Connected to ";
+ constexpr const char* CONNECTING = "Connecting...";
+ constexpr const char* CONNECTION_SUCCESSFUL = "Connection Successful";
+ constexpr const char* CONNECT_TO = "Connect to ";
+ constexpr const char* CONNECT_TO_HOTSPOT = "Hotspot: ";
+ constexpr const char* DETECTING_MODULE = "Detecting module...";
+ constexpr const char* DOWNLOAD_ASSETS_FAILED = "Failed to download assets";
+ constexpr const char* ENTERING_WIFI_CONFIG_MODE = "Entering Wi-Fi configuration mode...";
+ constexpr const char* ERROR = "Error";
+ constexpr const char* FOUND_NEW_ASSETS = "Found new assets: %s";
+ constexpr const char* HELLO_MY_FRIEND = "Hello, my friend!";
+ constexpr const char* INFO = "Information";
+ constexpr const char* INITIALIZING = "Initializing...";
+ constexpr const char* LISTENING = "Listening...";
+ constexpr const char* LOADING_ASSETS = "Loading assets...";
+ constexpr const char* LOADING_PROTOCOL = "Logging in...";
+ constexpr const char* MAX_VOLUME = "Max volume";
+ constexpr const char* MUTED = "Muted";
+ constexpr const char* NEW_VERSION = "New version ";
+ constexpr const char* OTA_UPGRADE = "OTA Upgrade";
+ constexpr const char* PIN_ERROR = "Please insert SIM card";
+ constexpr const char* PLEASE_WAIT = "Please wait...";
+ constexpr const char* REGISTERING_NETWORK = "Waiting for network...";
+ constexpr const char* REG_ERROR = "Unable to access network, please check SIM card status";
+ constexpr const char* RTC_MODE_OFF = "AEC Off";
+ constexpr const char* RTC_MODE_ON = "AEC On";
+ constexpr const char* SCANNING_WIFI = "Scanning Wi-Fi...";
+ constexpr const char* SERVER_ERROR = "Sending failed, please check the network";
+ constexpr const char* SERVER_NOT_CONNECTED = "Unable to connect to service, please try again later";
+ constexpr const char* SERVER_NOT_FOUND = "Looking for available service";
+ constexpr const char* SERVER_TIMEOUT = "Waiting for response timeout";
+ constexpr const char* SPEAKING = "Speaking...";
+ constexpr const char* STANDBY = "Standby";
+ constexpr const char* SWITCH_TO_4G_NETWORK = "Switching to 4G...";
+ constexpr const char* SWITCH_TO_WIFI_NETWORK = "Switching to Wi-Fi...";
+ constexpr const char* UPGRADE_FAILED = "Upgrade failed";
+ constexpr const char* UPGRADING = "System is upgrading...";
+ constexpr const char* VERSION = "Ver ";
+ constexpr const char* VOLUME = "Volume ";
+ constexpr const char* WARNING = "Warning";
+ constexpr const char* WIFI_CONFIG_MODE = "Wi-Fi Configuration Mode";
+ }
+
+ // 音效资源 (en-US as fallback for missing audio files)
+ namespace Sounds {
+
+ extern const char ogg_0_start[] asm("_binary_0_ogg_start");
+ extern const char ogg_0_end[] asm("_binary_0_ogg_end");
+ static const std::string_view OGG_0 {
+ static_cast(ogg_0_start),
+ static_cast(ogg_0_end - ogg_0_start)
+ };
+
+ extern const char ogg_1_start[] asm("_binary_1_ogg_start");
+ extern const char ogg_1_end[] asm("_binary_1_ogg_end");
+ static const std::string_view OGG_1 {
+ static_cast(ogg_1_start),
+ static_cast(ogg_1_end - ogg_1_start)
+ };
+
+ extern const char ogg_2_start[] asm("_binary_2_ogg_start");
+ extern const char ogg_2_end[] asm("_binary_2_ogg_end");
+ static const std::string_view OGG_2 {
+ static_cast(ogg_2_start),
+ static_cast(ogg_2_end - ogg_2_start)
+ };
+
+ extern const char ogg_3_start[] asm("_binary_3_ogg_start");
+ extern const char ogg_3_end[] asm("_binary_3_ogg_end");
+ static const std::string_view OGG_3 {
+ static_cast(ogg_3_start),
+ static_cast(ogg_3_end - ogg_3_start)
+ };
+
+ extern const char ogg_4_start[] asm("_binary_4_ogg_start");
+ extern const char ogg_4_end[] asm("_binary_4_ogg_end");
+ static const std::string_view OGG_4 {
+ static_cast(ogg_4_start),
+ static_cast(ogg_4_end - ogg_4_start)
+ };
+
+ extern const char ogg_5_start[] asm("_binary_5_ogg_start");
+ extern const char ogg_5_end[] asm("_binary_5_ogg_end");
+ static const std::string_view OGG_5 {
+ static_cast(ogg_5_start),
+ static_cast(ogg_5_end - ogg_5_start)
+ };
+
+ extern const char ogg_6_start[] asm("_binary_6_ogg_start");
+ extern const char ogg_6_end[] asm("_binary_6_ogg_end");
+ static const std::string_view OGG_6 {
+ static_cast(ogg_6_start),
+ static_cast(ogg_6_end - ogg_6_start)
+ };
+
+ extern const char ogg_7_start[] asm("_binary_7_ogg_start");
+ extern const char ogg_7_end[] asm("_binary_7_ogg_end");
+ static const std::string_view OGG_7 {
+ static_cast(ogg_7_start),
+ static_cast(ogg_7_end - ogg_7_start)
+ };
+
+ extern const char ogg_8_start[] asm("_binary_8_ogg_start");
+ extern const char ogg_8_end[] asm("_binary_8_ogg_end");
+ static const std::string_view OGG_8 {
+ static_cast(ogg_8_start),
+ static_cast(ogg_8_end - ogg_8_start)
+ };
+
+ extern const char ogg_9_start[] asm("_binary_9_ogg_start");
+ extern const char ogg_9_end[] asm("_binary_9_ogg_end");
+ static const std::string_view OGG_9 {
+ static_cast(ogg_9_start),
+ static_cast(ogg_9_end - ogg_9_start)
+ };
+
+ extern const char ogg_activation_start[] asm("_binary_activation_ogg_start");
+ extern const char ogg_activation_end[] asm("_binary_activation_ogg_end");
+ static const std::string_view OGG_ACTIVATION {
+ static_cast(ogg_activation_start),
+ static_cast