From 86921f48626740cb561afdced9d6a8a99eb2bdf4 Mon Sep 17 00:00:00 2001 From: Create123 Date: Tue, 26 Aug 2025 14:05:10 +0800 Subject: [PATCH] Add M5Stack AtomEchoS3R Board. (#1123) Signed-off-by: hlym123 --- main/CMakeLists.txt | 4 +- main/Kconfig.projbuild | 3 + main/boards/atom-echos3r/README.md | 45 ++++++++++++ main/boards/atom-echos3r/atom_echos3r.cc | 92 ++++++++++++++++++++++++ main/boards/atom-echos3r/config.h | 29 ++++++++ main/boards/atom-echos3r/config.json | 12 ++++ 6 files changed, 184 insertions(+), 1 deletion(-) create mode 100644 main/boards/atom-echos3r/README.md create mode 100644 main/boards/atom-echos3r/atom_echos3r.cc create mode 100644 main/boards/atom-echos3r/config.h create mode 100644 main/boards/atom-echos3r/config.json diff --git a/main/CMakeLists.txt b/main/CMakeLists.txt index b76c39b7..25279376 100644 --- a/main/CMakeLists.txt +++ b/main/CMakeLists.txt @@ -86,6 +86,8 @@ elseif(CONFIG_BOARD_TYPE_ATOMS3R_ECHO_BASE) set(BOARD_TYPE "atoms3r-echo-base") 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) @@ -394,4 +396,4 @@ spiffs_create_partition_assets( MMAP_FILE_SUPPORT_FORMAT ".aaf, ttf, bin" IMPORT_INC_PATH ${CMAKE_CURRENT_SOURCE_DIR}/boards/${BOARD_TYPE} ) -endif() \ No newline at end of file +endif() diff --git a/main/Kconfig.projbuild b/main/Kconfig.projbuild index a79718a1..0c75ecc4 100644 --- a/main/Kconfig.projbuild +++ b/main/Kconfig.projbuild @@ -178,6 +178,9 @@ choice BOARD_TYPE 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 diff --git a/main/boards/atom-echos3r/README.md b/main/boards/atom-echos3r/README.md new file mode 100644 index 00000000..5340cdfe --- /dev/null +++ b/main/boards/atom-echos3r/README.md @@ -0,0 +1,45 @@ +# AtomEchoS3R +## 简介 + +AtomEchoS3R 是 M5Stack 推出的基于 ESP32-S3-PICO-1-N8R8 的物联网可编程控制器，采用了 ES8311 单声道音频解码器、MEMS 麦克风和 NS4150B 功率放大器的集成方案。 + +开发版**不带屏幕、不带额外按键**，需要使用语音唤醒。必要时，需要使用 `idf.py monitor` 查看 log 以确定运行状态。 + +## 配置、编译命令 + +**配置编译目标为 ESP32S3** + +```bash +idf.py set-target esp32s3 +``` + +**打开 menuconfig 并配置** + +```bash +idf.py menuconfig +``` + +分别配置如下选项： + +- `Xiaozhi Assistant` → `Board Type` → 选择 `AtomEchoS3R` +- `Partition Table` → `Custom partition CSV file` → 删除原有内容，输入 `partitions/v1/8m.csv` +- `Serial flasher config` → `Flash size` → 选择 `8 MB` +- `Component config` → `ESP PSRAM` → `Support for external, SPI-connected RAM` → `SPI RAM config` → 选择 `Octal Mode PSRAM` + +按 `S` 保存，按 `Q` 退出。 + +**编译** + +```bash +idf.py build +``` + +**烧录** + +将 AtomEchoS3R 连接到电脑，按住侧面 RESET 按键，直到 RESET 按键下方绿灯闪烁。 + +```bash +idf.py flash +``` + +烧录完毕后，按一下 RESET 按钮重启设备。 diff --git a/main/boards/atom-echos3r/atom_echos3r.cc b/main/boards/atom-echos3r/atom_echos3r.cc new file mode 100644 index 00000000..7f6ff675 --- /dev/null +++ b/main/boards/atom-echos3r/atom_echos3r.cc @@ -0,0 +1,92 @@ +#include "wifi_board.h" +#include "codecs/es8311_audio_codec.h" +#include "application.h" +#include "button.h" +#include "config.h" +#include "i2c_device.h" +#include "assets/lang_config.h" + +#include +#include +#include + +#define TAG "AtomEchoS3R" + + +class AtomEchoS3rBaseBoard : public WifiBoard { +private: + i2c_master_bus_handle_t i2c_bus_; + Button boot_button_; + void InitializeI2c() { + // Initialize I2C peripheral + i2c_master_bus_config_t i2c_bus_cfg = { + .i2c_port = I2C_NUM_0, + .sda_io_num = AUDIO_CODEC_I2C_SDA_PIN, + .scl_io_num = AUDIO_CODEC_I2C_SCL_PIN, + .clk_source = I2C_CLK_SRC_DEFAULT, + .glitch_ignore_cnt = 7, + .intr_priority = 0, + .trans_queue_depth = 0, + .flags = { + .enable_internal_pullup = 1, + }, + }; + ESP_ERROR_CHECK(i2c_new_master_bus(&i2c_bus_cfg, &i2c_bus_)); + } + + void I2cDetect() { + uint8_t address; + printf(" 0 1 2 3 4 5 6 7 8 9 a b c d e f\r\n"); + for (int i = 0; i < 128; i += 16) { + printf("%02x: ", i); + for (int j = 0; j < 16; j++) { + fflush(stdout); + address = i + j; + esp_err_t ret = i2c_master_probe(i2c_bus_, address, pdMS_TO_TICKS(200)); + if (ret == ESP_OK) { + printf("%02x ", address); + } else if (ret == ESP_ERR_TIMEOUT) { + printf("UU "); + } else { + printf("-- "); + } + } + printf("\r\n"); + } + } + + void InitializeButtons() { + boot_button_.OnClick([this]() { + auto& app = Application::GetInstance(); + if (app.GetDeviceState() == kDeviceStateStarting && !WifiStation::GetInstance().IsConnected()) { + ResetWifiConfiguration(); + } + app.ToggleChatState(); + }); + } +public: + AtomEchoS3rBaseBoard() : boot_button_(USER_BUTTON_GPIO) { + InitializeI2c(); + I2cDetect(); + InitializeButtons(); + } + + virtual AudioCodec* GetAudioCodec() override { + static Es8311AudioCodec audio_codec( + i2c_bus_, + I2C_NUM_0, + AUDIO_INPUT_SAMPLE_RATE, + AUDIO_OUTPUT_SAMPLE_RATE, + AUDIO_I2S_GPIO_MCLK, + AUDIO_I2S_GPIO_BCLK, + AUDIO_I2S_GPIO_WS, + AUDIO_I2S_GPIO_DOUT, + AUDIO_I2S_GPIO_DIN, + AUDIO_CODEC_GPIO_PA, + AUDIO_CODEC_ES8311_ADDR, + false); + return &audio_codec; + } +}; + +DECLARE_BOARD(AtomEchoS3rBaseBoard); diff --git a/main/boards/atom-echos3r/config.h b/main/boards/atom-echos3r/config.h new file mode 100644 index 00000000..4803c426 --- /dev/null +++ b/main/boards/atom-echos3r/config.h @@ -0,0 +1,29 @@ +#ifndef _BOARD_CONFIG_H_ +#define _BOARD_CONFIG_H_ + +// AtomEchoS3R Board configuration + +#include + +#define AUDIO_INPUT_REFERENCE true +#define AUDIO_INPUT_SAMPLE_RATE 24000 +#define AUDIO_OUTPUT_SAMPLE_RATE 24000 + +#define AUDIO_I2S_GPIO_MCLK GPIO_NUM_11 +#define AUDIO_I2S_GPIO_WS GPIO_NUM_3 +#define AUDIO_I2S_GPIO_BCLK GPIO_NUM_17 +#define AUDIO_I2S_GPIO_DIN GPIO_NUM_4 +#define AUDIO_I2S_GPIO_DOUT GPIO_NUM_48 + +#define AUDIO_CODEC_I2C_SDA_PIN GPIO_NUM_45 +#define AUDIO_CODEC_I2C_SCL_PIN GPIO_NUM_0 +#define AUDIO_CODEC_ES8311_ADDR ES8311_CODEC_DEFAULT_ADDR +#define AUDIO_CODEC_GPIO_PA GPIO_NUM_18 + +#define BUILTIN_LED_GPIO GPIO_NUM_NC +#define USER_BUTTON_GPIO GPIO_NUM_41 +#define VOLUME_UP_BUTTON_GPIO GPIO_NUM_NC +#define VOLUME_DOWN_BUTTON_GPIO GPIO_NUM_NC + + +#endif // _BOARD_CONFIG_H_ diff --git a/main/boards/atom-echos3r/config.json b/main/boards/atom-echos3r/config.json new file mode 100644 index 00000000..ca1367ea --- /dev/null +++ b/main/boards/atom-echos3r/config.json @@ -0,0 +1,12 @@ +{ + "target": "esp32s3", + "builds": [ + { + "name": "atom-echos3r", + "sdkconfig_append": [ + "CONFIG_ESPTOOLPY_FLASHSIZE_8MB=y", + "CONFIG_PARTITION_TABLE_CUSTOM_FILENAME=\"partitions/v1/8m.csv\"" + ] + } + ] +}