resolve conflict

This commit is contained in:
Tomato Me
2026-04-17 10:48:13 +08:00
30 changed files with 5282 additions and 960 deletions

View File

@ -160,7 +160,7 @@ elseif(CONFIG_BOARD_TYPE_LICHUANG_DEV_C3)
set(DEFAULT_EMOJI_COLLECTION twemoji_32)
elseif(CONFIG_BOARD_TYPE_EDA_TV_PRO)
set(MANUFACTURER "lceda-course-examples")
set(BOARD_TYPE "eda-tv-pro")
set(BOARD_TYPE "eda-tv-pro")
elseif(CONFIG_BOARD_TYPE_EDA_ROBOT_PRO)
set(MANUFACTURER "lceda-course-examples")
set(BOARD_TYPE "eda-robot-pro")
@ -645,12 +645,12 @@ elseif(CONFIG_BOARD_TYPE_XINGZHI_METAL_1_54_WIFI)
set(BOARD_TYPE "xingzhi-metal-1.54-wifi")
set(BUILTIN_TEXT_FONT font_noto_basic_20_4)
set(BUILTIN_ICON_FONT font_awesome_20_4)
set(DEFAULT_EMOJI_COLLECTION noto-emoji_128)
set(DEFAULT_EMOJI_COLLECTION noto-emoji_128)
elseif(CONFIG_BOARD_TYPE_XINGZHI_ABS_2_0)
set(BOARD_TYPE "xingzhi-abs-2.0")
set(BUILTIN_TEXT_FONT font_noto_basic_20_4)
set(BUILTIN_ICON_FONT font_awesome_20_4)
set(DEFAULT_EMOJI_COLLECTION noto-emoji_128)
set(DEFAULT_EMOJI_COLLECTION noto-emoji_128)
elseif(CONFIG_BOARD_TYPE_SEEED_STUDIO_SENSECAP_WATCHER)
set(BOARD_TYPE "sensecap-watcher")
set(BUILTIN_TEXT_FONT font_noto_basic_30_4)
@ -710,7 +710,7 @@ elseif(CONFIG_BOARD_TYPE_ZHENGCHEN_CAM_ML307)
set(BOARD_TYPE "zhengchen-cam-ml307")
set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
set(BUILTIN_ICON_FONT font_awesome_20_4)
set(DEFAULT_EMOJI_COLLECTION twemoji_64)
set(DEFAULT_EMOJI_COLLECTION twemoji_64)
elseif(CONFIG_BOARD_TYPE_SPOTPEAR_ESP32_S3_1_54_MUMA)
set(BOARD_TYPE "sp-esp32-s3-1.54-muma")
set(BUILTIN_TEXT_FONT font_puhui_basic_16_4)
@ -780,6 +780,11 @@ elseif(CONFIG_BOARD_TYPE_Freenove_ESP32S3_DISPLAY_2_8_LCD)
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_AI_VOX3)
set(BOARD_TYPE "nulllab-ai-vox-v3")
set(BUILTIN_TEXT_FONT font_puhui_basic_20_4)
set(BUILTIN_ICON_FONT font_awesome_20_4)
set(DEFAULT_EMOJI_COLLECTION twemoji_64)
endif()
if(MANUFACTURER)
@ -901,14 +906,14 @@ file(GLOB LANG_SOUNDS ${CMAKE_CURRENT_SOURCE_DIR}/assets/locales/${LANG_DIR}/*.o
# If not en-US, collect en-US audio files as fallback for missing files
if(NOT LANG_DIR STREQUAL "en-US")
file(GLOB EN_US_SOUNDS ${CMAKE_CURRENT_SOURCE_DIR}/assets/locales/en-US/*.ogg)
# Extract filenames (without path) from current language
set(EXISTING_NAMES "")
foreach(SOUND_FILE ${LANG_SOUNDS})
get_filename_component(FILENAME ${SOUND_FILE} NAME)
list(APPEND EXISTING_NAMES ${FILENAME})
endforeach()
# Only add en-US audio files that are missing in current language
foreach(EN_SOUND ${EN_US_SOUNDS})
get_filename_component(FILENAME ${EN_SOUND} NAME)
@ -1039,7 +1044,7 @@ 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")
@ -1061,31 +1066,31 @@ endif()
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}
@ -1096,15 +1101,15 @@ function(build_default_assets_bin)
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()
@ -1117,18 +1122,18 @@ function(get_assets_local_file assets_source assets_local_file_var)
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)
@ -1140,7 +1145,7 @@ function(get_assets_local_file assets_source assets_local_file_var)
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}")
@ -1152,15 +1157,15 @@ function(get_assets_local_file assets_source assets_local_file_var)
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()

View File

@ -130,7 +130,7 @@ choice BOARD_TYPE
depends on IDF_TARGET_ESP32S3
config BOARD_TYPE_BREAD_COMPACT_WIFI_CAM
bool "Bread Compact WiFi + LCD + Camera (面包板)"
depends on IDF_TARGET_ESP32S3
depends on IDF_TARGET_ESP32S3
config BOARD_TYPE_BREAD_COMPACT_ML307
bool "Bread Compact ML307/EC801E (面包板 4G)"
depends on IDF_TARGET_ESP32S3
@ -545,6 +545,9 @@ choice BOARD_TYPE
config BOARD_TYPE_Freenove_ESP32S3_DISPLAY_2_8_LCD
bool "Freenove ESP32S3 Display 2.8 LCD"
depends on IDF_TARGET_ESP32S3
config BOARD_TYPE_AI_VOX3
bool "NULLLAB-AI-VOX3"
depends on IDF_TARGET_ESP32S3
endchoice
choice
@ -677,7 +680,7 @@ endchoice
choice DISPLAY_ESP32S3_TOUCH_LCD_1_85C
depends on BOARD_TYPE_WAVESHARE_ESP32_S3_TOUCH_LCD_1_85C
prompt "ESP32S3_TOUCH_LCD_1_85C version"
default VERSION_2_0
default VERSION_2_0
help
hardware version
config VERSION_1_0
@ -805,7 +808,7 @@ config USE_DEVICE_AEC
|| BOARD_TYPE_WAVESHARE_ESP32_P4_WIFI6_TOUCH_LCD_3_4C || BOARD_TYPE_WAVESHARE_ESP32_P4_WIFI6_TOUCH_LCD_4C || BOARD_TYPE_ESP_S3_LCD_EV_Board_2 || BOARD_TYPE_YUNLIAO_S3 \
|| BOARD_TYPE_WAVESHARE_ESP32_P4_WIFI6_TOUCH_LCD_7 || BOARD_TYPE_WAVESHARE_ESP32_P4_WIFI6_TOUCH_LCD_8 || BOARD_TYPE_WAVESHARE_ESP32_P4_WIFI6_TOUCH_LCD_10_1 \
|| BOARD_TYPE_ESP_VOCAT || BOARD_TYPE_WAVESHARE_ESP32_S3_TOUCH_LCD_3_49 || BOARD_TYPE_WAVESHARE_ESP32_S3_RLCD_4_2 || BOARD_TYPE_ZHENGCHEN_CAM || BOARD_TYPE_ZHENGCHEN_CAM_ML307 \
|| BOARD_TYPE_WAVESHARE_ESP32_S3_TOUCH_LCD_4_3C || BOARD_TYPE_WAVESHARE_ESP32_S3_TOUCH_LCD_1_54 || BOARD_TYPE_WAVESHARE_ESP32_S3_LCD_0_85 || BOARD_TYPE_WAVESHARE_ESP32_S3_TOUCH_AMOLED_1_43C)
|| BOARD_TYPE_WAVESHARE_ESP32_S3_TOUCH_LCD_4_3C || BOARD_TYPE_WAVESHARE_ESP32_S3_TOUCH_LCD_1_54 || BOARD_TYPE_WAVESHARE_ESP32_S3_LCD_0_85 || BOARD_TYPE_AI_VOX3 || BOARD_TYPE_WAVESHARE_ESP32_S3_TOUCH_AMOLED_1_43C)
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.

View File

@ -43,6 +43,33 @@ M5Stack Cardputer Adv 是一款基于 ESP32-S3FN8 (Stamp-S3A) 的卡片式电脑
1. 按下 BOOT 按钮进入配网模式
2. 连接 WiFi 后即可使用语音助手功能
## 烧录参数
芯片: ESP32-S3, Flash: 8MB, 模式: DIO, 频率: 80MHz
| 地址 | 文件 |
|------|------|
| 0x0 | bootloader/bootloader.bin |
| 0x8000 | partition_table/partition-table.bin |
| 0xd000 | ota_data_initial.bin |
| 0x20000 | xiaozhi.bin |
| 0x600000 | generated_assets.bin |
烧录命令 (build 目录为 `build-cardputer-adv`):
```bash
python -m esptool --chip esp32s3 -b 460800 -p PORT \
--before default_reset --after hard_reset \
write_flash --flash_mode dio --flash_size 8MB --flash_freq 80m \
0x0 build-cardputer-adv/bootloader/bootloader.bin \
0x8000 build-cardputer-adv/partition_table/partition-table.bin \
0xd000 build-cardputer-adv/ota_data_initial.bin \
0x20000 build-cardputer-adv/xiaozhi.bin \
0x600000 build-cardputer-adv/generated_assets.bin
```
`PORT` 替换为实际串口设备路径(如 `/dev/cu.usbmodem21101`)。
## 参考链接
- [M5Stack Cardputer Adv 官方文档](https://docs.m5stack.com/en/core/Cardputer-Adv)

View File

@ -39,7 +39,7 @@
#define DISPLAY_SWAP_XY true
#define DISPLAY_OFFSET_X 40
#define DISPLAY_OFFSET_Y 52
#define DISPLAY_OFFSET_Y 53
#define DISPLAY_SPI_MOSI_PIN GPIO_NUM_35
#define DISPLAY_SPI_SCLK_PIN GPIO_NUM_36
@ -49,8 +49,9 @@
#define DISPLAY_BACKLIGHT_PIN GPIO_NUM_38
#define DISPLAY_BACKLIGHT_OUTPUT_INVERT false
// Keyboard TCA8418 I2C address
// Keyboard TCA8418 I2C address and interrupt pin
#define KEYBOARD_TCA8418_ADDR 0x34
#define KEYBOARD_INT_PIN GPIO_NUM_11
// IMU BMI270 I2C address
#define IMU_BMI270_ADDR 0x68

View File

@ -1,20 +1,30 @@
#include "wifi_board.h"
#include "wifi_config_ui.h"
#include "codecs/es8311_audio_codec.h"
#include "display/lcd_display.h"
#include "application.h"
#include "button.h"
#include "config.h"
#include "i2c_device.h"
#include "tca8418_keyboard.h"
#include <esp_log.h>
#include <driver/i2c_master.h>
#include <driver/i2s_common.h>
#include <driver/spi_common.h>
#include <esp_lcd_panel_io.h>
#include <esp_lcd_panel_ops.h>
#include <esp_lcd_panel_vendor.h>
#include <wifi_manager.h>
#include <ssid_manager.h>
#include <algorithm>
#include <memory>
#define TAG "CardputerAdv"
// Backlight uses percentage scale (0-100). Keep a minimum of 30% to avoid a too-dim screen.
#define MIN_BRIGHTNESS 30
class M5StackCardputerAdvBoard : public WifiBoard {
private:
i2c_master_bus_handle_t i2c_bus_;
@ -22,6 +32,9 @@ private:
Button boot_button_;
esp_lcd_panel_io_handle_t panel_io_ = nullptr;
esp_lcd_panel_handle_t panel_ = nullptr;
Tca8418Keyboard* keyboard_ = nullptr;
std::unique_ptr<WifiConfigUI> wifi_config_ui_;
bool wifi_config_mode_ = false;
void InitializeI2c() {
ESP_LOGI(TAG, "Initialize I2C bus");
@ -117,6 +130,185 @@ private:
});
}
void InitializeKeyboard() {
ESP_LOGI(TAG, "Initialize TCA8418 keyboard");
keyboard_ = new Tca8418Keyboard(i2c_bus_, KEYBOARD_TCA8418_ADDR, KEYBOARD_INT_PIN);
keyboard_->Initialize();
// Set legacy callback for volume/brightness control
keyboard_->SetKeyCallback([this](LegacyKeyCode key) {
HandleLegacyKeyPress(key);
});
// Set full key event callback for WiFi config and text input
keyboard_->SetKeyEventCallback([this](const KeyEvent& event) {
HandleKeyEvent(event);
});
}
void HandleKeyEvent(const KeyEvent& event) {
// Handle WiFi config mode
if (wifi_config_mode_ && wifi_config_ui_) {
auto result = wifi_config_ui_->HandleKeyEvent(event);
if (result == WifiConfigResult::Connected) {
ESP_LOGI(TAG, "WiFi connected via keyboard config");
ExitWifiConfigMode();
} else if (result == WifiConfigResult::Cancelled) {
ESP_LOGI(TAG, "WiFi config cancelled");
ExitWifiConfigMode();
}
return;
}
// Handle W and S keys during WiFi configuring state (scanning screen)
auto& app = Application::GetInstance();
if (app.GetDeviceState() == kDeviceStateWifiConfiguring && event.pressed) {
if (event.key_code == KC_W) {
ESP_LOGI(TAG, "W key pressed - entering keyboard WiFi config");
StartKeyboardWifiConfig();
} else if (event.key_code == KC_S) {
ESP_LOGI(TAG, "S key pressed - showing saved WiFi list");
StartKeyboardWifiConfigSaved();
}
}
}
void HandleLegacyKeyPress(LegacyKeyCode key) {
// Skip if in WiFi config mode
if (wifi_config_mode_) {
return;
}
auto& app = Application::GetInstance();
auto* codec = GetAudioCodec();
auto* backlight = GetBacklight();
switch (key) {
case KEY_UP: {
// Volume up
int current_vol = codec->output_volume();
int step = (current_vol <= 20 || current_vol >= 80) ? 1 : 10;
int new_vol = std::min(100, current_vol + step);
codec->SetOutputVolume(new_vol);
char msg[32];
snprintf(msg, sizeof(msg), "Volume: %d%%", new_vol);
display_->ShowNotification(msg, 1500);
ESP_LOGI(TAG, "Volume up: %d%%", new_vol);
break;
}
case KEY_DOWN: {
// Volume down
int current_vol = codec->output_volume();
int step = (current_vol <= 20 || current_vol >= 80) ? 1 : 10;
int new_vol = std::max(0, current_vol - step);
codec->SetOutputVolume(new_vol);
char msg[32];
snprintf(msg, sizeof(msg), "Volume: %d%%", new_vol);
display_->ShowNotification(msg, 1500);
ESP_LOGI(TAG, "Volume down: %d%%", new_vol);
break;
}
case KEY_RIGHT: {
// Brightness up
uint8_t current_br = backlight->brightness();
int step = (current_br <= (MIN_BRIGHTNESS + 20) || current_br >= 80) ? 1 : 10;
int new_br = std::min(100, (int)current_br + step);
backlight->SetBrightness(new_br, true);
char msg[32];
snprintf(msg, sizeof(msg), "Brightness: %d%%", new_br);
display_->ShowNotification(msg, 1500);
ESP_LOGI(TAG, "Brightness up: %d%%", new_br);
break;
}
case KEY_LEFT: {
// Brightness down (minimum 30%)
uint8_t current_br = backlight->brightness();
int step = (current_br <= (MIN_BRIGHTNESS + 20) || current_br >= 80) ? 1 : 10;
int new_br = std::max((int)MIN_BRIGHTNESS, (int)current_br - step);
backlight->SetBrightness(new_br, true);
char msg[32];
snprintf(msg, sizeof(msg), "Brightness: %d%%", new_br);
display_->ShowNotification(msg, 1500);
ESP_LOGI(TAG, "Brightness down: %d%%", new_br);
break;
}
case KEY_ENTER: {
// Match boot button behavior (start/stop chat depending on current state).
if (app.GetDeviceState() != kDeviceStateStarting) {
app.ToggleChatState();
ESP_LOGI(TAG, "Enter key: Toggle chat state");
}
break;
}
default:
break;
}
}
void StartKeyboardWifiConfig() {
ESP_LOGI(TAG, "Starting keyboard WiFi config UI");
wifi_config_mode_ = true;
wifi_config_ui_ = std::make_unique<WifiConfigUI>(display_);
wifi_config_ui_->SetConnectCallback([this](const std::string& ssid, const std::string& password) {
AttemptWifiConnection(ssid, password);
});
wifi_config_ui_->Start();
}
void StartKeyboardWifiConfigSaved() {
ESP_LOGI(TAG, "Starting keyboard WiFi config UI (saved list)");
wifi_config_mode_ = true;
wifi_config_ui_ = std::make_unique<WifiConfigUI>(display_);
wifi_config_ui_->SetConnectCallback([this](const std::string& ssid, const std::string& password) {
AttemptWifiConnection(ssid, password);
});
wifi_config_ui_->StartWithSavedList();
}
void AttemptWifiConnection(const std::string& ssid, const std::string& password) {
ESP_LOGI(TAG, "Attempting WiFi connection to: %s", ssid.c_str());
// Add to SSID manager (will be saved and used for connection)
auto& ssid_manager = SsidManager::GetInstance();
ssid_manager.AddSsid(ssid, password);
// Stop config AP mode and trigger reconnection with new credentials
auto& wifi_manager = WifiManager::GetInstance();
if (wifi_manager.IsConfigMode()) {
wifi_manager.StopConfigAp();
}
// Start station mode to connect
wifi_manager.StartStation();
// Wait for connection result (with timeout)
bool connected = false;
for (int i = 0; i < 100; i++) { // 10 second timeout
vTaskDelay(pdMS_TO_TICKS(100));
if (wifi_manager.IsConnected()) {
connected = true;
break;
}
}
if (wifi_config_ui_) {
wifi_config_ui_->OnConnectResult(connected);
}
}
void ExitWifiConfigMode() {
ESP_LOGI(TAG, "Exiting keyboard WiFi config mode");
wifi_config_mode_ = false;
wifi_config_ui_.reset();
// Restart normal WiFi connection flow
auto& app = Application::GetInstance();
if (app.GetDeviceState() == kDeviceStateWifiConfiguring) {
// Try to connect with saved credentials
TryWifiConnect();
}
}
public:
M5StackCardputerAdvBoard() : boot_button_(BOOT_BUTTON_GPIO) {
InitializeI2c();
@ -124,23 +316,31 @@ public:
InitializeSpi();
InitializeSt7789Display();
InitializeButtons();
InitializeKeyboard();
GetBacklight()->RestoreBrightness();
}
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_PA_PIN,
AUDIO_CODEC_ES8311_ADDR,
false); // use_mclk = false, Cardputer Adv has no MCLK pin
// Cardputer Adv (no MCLK, internal clocking) needs I2S channels
// disabled after construction so esp_codec_dev_open can configure
// the ES8311 codec before channels start running.
static struct CardputerAdvEs8311 : public Es8311AudioCodec {
CardputerAdvEs8311(void* i2c, i2c_port_t port, int in_rate, int out_rate,
gpio_num_t mclk, gpio_num_t bclk, gpio_num_t ws,
gpio_num_t dout, gpio_num_t din, gpio_num_t pa,
uint8_t addr, bool use_mclk)
: Es8311AudioCodec(i2c, port, in_rate, out_rate,
mclk, bclk, ws, dout, din, pa, addr, use_mclk) {
i2s_channel_disable(tx_handle_);
i2s_channel_disable(rx_handle_);
}
} 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_PA_PIN, AUDIO_CODEC_ES8311_ADDR,
false); // use_mclk = false
return &audio_codec;
}

View File

@ -0,0 +1,418 @@
#include "tca8418_keyboard.h"
#include <esp_log.h>
#define TAG "TCA8418"
// TCA8418 additional registers
#define TCA8418_REG_GPIO_INT_EN_1 0x1A
#define TCA8418_REG_GPIO_INT_EN_2 0x1B
#define TCA8418_REG_GPIO_INT_EN_3 0x1C
#define TCA8418_REG_GPIO_DAT_STAT_1 0x14
#define TCA8418_REG_GPIO_DAT_STAT_2 0x15
#define TCA8418_REG_GPIO_DAT_STAT_3 0x16
#define TCA8418_REG_GPIO_DAT_OUT_1 0x17
#define TCA8418_REG_GPIO_DAT_OUT_2 0x18
#define TCA8418_REG_GPIO_DAT_OUT_3 0x19
#define TCA8418_REG_GPIO_INT_LVL_1 0x20
#define TCA8418_REG_GPIO_INT_LVL_2 0x21
#define TCA8418_REG_GPIO_INT_LVL_3 0x22
#define TCA8418_REG_DEBOUNCE_DIS_1 0x29
#define TCA8418_REG_DEBOUNCE_DIS_2 0x2A
#define TCA8418_REG_DEBOUNCE_DIS_3 0x2B
#define TCA8418_REG_GPIO_PULL_1 0x2C
#define TCA8418_REG_GPIO_PULL_2 0x2D
#define TCA8418_REG_GPIO_PULL_3 0x2E
// Config register bits
#define TCA8418_CFG_AI 0x80 // Auto-increment for read/write
#define TCA8418_CFG_GPI_E_CFG 0x40 // GPI event mode config
#define TCA8418_CFG_OVR_FLOW_M 0x20 // Overflow mode
#define TCA8418_CFG_INT_CFG 0x10 // Interrupt config
#define TCA8418_CFG_OVR_FLOW_IEN 0x08 // Overflow interrupt enable
#define TCA8418_CFG_K_LCK_IEN 0x04 // Keypad lock interrupt enable
#define TCA8418_CFG_GPI_IEN 0x02 // GPI interrupt enable
// Interrupt status bits
#define TCA8418_INT_STAT_CAD_INT 0x10 // CTRL-ALT-DEL interrupt
#define TCA8418_INT_STAT_OVR_FLOW 0x08 // Overflow interrupt
#define TCA8418_INT_STAT_K_LCK_INT 0x04 // Key lock interrupt
#define TCA8418_INT_STAT_GPI_INT 0x02 // GPI interrupt
#define TCA8418_INT_STAT_K_INT 0x01 // Key event interrupt
// Key value structure for mapping
struct KeyValue {
const char* normal; // Normal character
uint8_t normal_code; // Normal key code
const char* shifted; // Shifted character
uint8_t shifted_code; // Shifted key code (same as normal for letters)
};
// 4x14 keyboard matrix mapping (based on M5Cardputer-UserDemo)
// Row 0: ` 1 2 3 4 5 6 7 8 9 0 - = Del
// Row 1: Tab Q W E R T Y U I O P [ ] Backslash
// Row 2: Shift CapsLk A S D F G H J K L ; ' Enter
// Row 3: Ctrl Opt Alt Z X C V B N M , . / Space
static const KeyValue KEY_MAP[4][14] = {
// Row 0
{{"`", KC_GRAVE, "~", KC_GRAVE},
{"1", KC_1, "!", KC_1},
{"2", KC_2, "@", KC_2},
{"3", KC_3, "#", KC_3},
{"4", KC_4, "$", KC_4},
{"5", KC_5, "%", KC_5},
{"6", KC_6, "^", KC_6},
{"7", KC_7, "&", KC_7},
{"8", KC_8, "*", KC_8},
{"9", KC_9, "(", KC_9},
{"0", KC_0, ")", KC_0},
{"-", KC_MINUS, "_", KC_MINUS},
{"=", KC_EQUAL, "+", KC_EQUAL},
{"", KC_BACKSPACE, "", KC_BACKSPACE}}, // Del/Backspace
// Row 1
{{"", KC_TAB, "", KC_TAB}, // Tab
{"q", KC_Q, "Q", KC_Q},
{"w", KC_W, "W", KC_W},
{"e", KC_E, "E", KC_E},
{"r", KC_R, "R", KC_R},
{"t", KC_T, "T", KC_T},
{"y", KC_Y, "Y", KC_Y},
{"u", KC_U, "U", KC_U},
{"i", KC_I, "I", KC_I},
{"o", KC_O, "O", KC_O},
{"p", KC_P, "P", KC_P},
{"[", KC_LBRACKET, "{", KC_LBRACKET},
{"]", KC_RBRACKET, "}", KC_RBRACKET},
{"\\", KC_BACKSLASH, "|", KC_BACKSLASH}},
// Row 2
{{"", KC_LSHIFT, "", KC_LSHIFT}, // Shift
{"", KC_CAPSLOCK, "", KC_CAPSLOCK}, // CapsLock
{"a", KC_A, "A", KC_A},
{"s", KC_S, "S", KC_S},
{"d", KC_D, "D", KC_D},
{"f", KC_F, "F", KC_F},
{"g", KC_G, "G", KC_G},
{"h", KC_H, "H", KC_H},
{"j", KC_J, "J", KC_J},
{"k", KC_K, "K", KC_K},
{"l", KC_L, "L", KC_L},
{";", KC_SEMICOLON, ":", KC_SEMICOLON},
{"'", KC_APOSTROPHE, "\"", KC_APOSTROPHE},
{"", KC_ENTER, "", KC_ENTER}}, // Enter
// Row 3
{{"", KC_LCTRL, "", KC_LCTRL}, // Ctrl
{"", KC_LOPT, "", KC_LOPT}, // Opt
{"", KC_LALT, "", KC_LALT}, // Alt
{"z", KC_Z, "Z", KC_Z},
{"x", KC_X, "X", KC_X},
{"c", KC_C, "C", KC_C},
{"v", KC_V, "V", KC_V},
{"b", KC_B, "B", KC_B},
{"n", KC_N, "N", KC_N},
{"m", KC_M, "M", KC_M},
{",", KC_COMMA, "<", KC_COMMA},
{".", KC_DOT, ">", KC_DOT},
{"/", KC_SLASH, "?", KC_SLASH},
{" ", KC_SPACE, " ", KC_SPACE}}
};
// Cardputer Adv uses TCA8418 in a 7x8 matrix, but the physical keyboard layout
// matches Cardputer's 4x14 mapping. Remap raw (row,col) from the 7x8 scan into
// the 4x14 logical layout (based on M5Cardputer-UserDemo CardputerADV branch).
static inline bool RemapRawKeyToLogical(uint8_t& row, uint8_t& col) {
// Raw scan: row 0..6, col 0..7
if (row >= 7 || col >= 8) {
return false;
}
// Col: every raw row contributes two logical columns (left/right half)
uint8_t mapped_col = (row * 2) + ((col > 3) ? 1 : 0); // 0..13
// Row: derived from raw col (wrap every 4)
uint8_t mapped_row = (col + 4) % 4; // 0..3
row = mapped_row;
col = mapped_col;
return true;
}
static inline uint64_t LogicalKeyMask(uint8_t row, uint8_t col) {
// 4x14 = 56 keys, fits in 64-bit
uint8_t idx = (row * 14) + col;
if (idx >= 64) {
return 0;
}
return 1ULL << idx;
}
Tca8418Keyboard::Tca8418Keyboard(i2c_master_bus_handle_t i2c_bus, uint8_t addr, gpio_num_t int_pin)
: I2cDevice(i2c_bus, addr), int_pin_(int_pin) {
}
Tca8418Keyboard::~Tca8418Keyboard() {
if (task_handle_) {
vTaskDelete(task_handle_);
task_handle_ = nullptr;
}
gpio_isr_handler_remove(int_pin_);
}
void Tca8418Keyboard::Initialize() {
ESP_LOGI(TAG, "Initializing TCA8418 keyboard");
// Configure keyboard matrix
ConfigureMatrix();
// Flush any pending events
FlushEvents();
// Enable interrupts
EnableInterrupts();
// Configure GPIO interrupt pin
gpio_config_t io_conf = {};
// IRQ is active-low and can stay low while events are pending, so use ANYEDGE.
io_conf.intr_type = GPIO_INTR_ANYEDGE;
io_conf.mode = GPIO_MODE_INPUT;
io_conf.pin_bit_mask = (1ULL << int_pin_);
// Cardputer Adv board provides external pull-ups; keep internal pulls disabled.
io_conf.pull_up_en = GPIO_PULLUP_DISABLE;
io_conf.pull_down_en = GPIO_PULLDOWN_DISABLE;
gpio_config(&io_conf);
// Install GPIO ISR service if not already installed
gpio_install_isr_service(0);
gpio_isr_handler_add(int_pin_, GpioIsrHandler, this);
// Create keyboard task
xTaskCreate(KeyboardTask, "keyboard_task", 4096, this, 5, &task_handle_);
ESP_LOGI(TAG, "TCA8418 keyboard initialized");
}
void Tca8418Keyboard::ConfigureMatrix() {
// Cardputer Adv keyboard is wired as a 7x8 matrix (rows: R0-R6, cols: C0-C7).
// KP_GPIO1: R0-R7 (bits 0-7)
// KP_GPIO2: C0-C7 (bits 0-7)
// KP_GPIO3: C8-C9 + GPIO (unused here)
WriteReg(TCA8418_REG_KP_GPIO_1, 0x7F); // R0-R6
WriteReg(TCA8418_REG_KP_GPIO_2, 0xFF); // C0-C7
WriteReg(TCA8418_REG_KP_GPIO_3, 0x00); // no extended cols
}
void Tca8418Keyboard::EnableInterrupts() {
// Enable key event interrupt
uint8_t cfg = TCA8418_CFG_KE_IEN | TCA8418_CFG_OVR_FLOW_M | TCA8418_CFG_INT_CFG;
WriteReg(TCA8418_REG_CFG, cfg);
}
void Tca8418Keyboard::FlushEvents() {
// Read and discard all pending key events
uint8_t event;
int count = 0;
while ((event = GetEvent()) != 0 && count < 10) {
count++;
}
// Clear interrupt status
WriteReg(TCA8418_REG_INT_STAT, 0x1F);
}
uint8_t Tca8418Keyboard::GetEvent() {
return ReadReg(TCA8418_REG_KEY_EVENT_A);
}
void Tca8418Keyboard::UpdateModifierState(uint8_t row, uint8_t col, bool pressed) {
// Shift key: row 2, col 0
if (row == 2 && col == 0) {
if (pressed) {
modifier_mask_ |= KEY_MOD_SHIFT;
} else {
modifier_mask_ &= ~KEY_MOD_SHIFT;
}
}
// Ctrl key: row 3, col 0
else if (row == 3 && col == 0) {
if (pressed) {
modifier_mask_ |= KEY_MOD_CTRL;
} else {
modifier_mask_ &= ~KEY_MOD_CTRL;
}
}
// Alt key: row 3, col 2
else if (row == 3 && col == 2) {
if (pressed) {
modifier_mask_ |= KEY_MOD_ALT;
} else {
modifier_mask_ &= ~KEY_MOD_ALT;
}
}
// Opt key: row 3, col 1
else if (row == 3 && col == 1) {
if (pressed) {
modifier_mask_ |= KEY_MOD_OPT;
} else {
modifier_mask_ &= ~KEY_MOD_OPT;
}
}
// CapsLock key: row 2, col 1 (toggle on press)
else if (row == 2 && col == 1 && pressed) {
caps_lock_on_ = !caps_lock_on_;
ESP_LOGD(TAG, "CapsLock toggled: %s", caps_lock_on_ ? "ON" : "OFF");
}
}
LegacyKeyCode Tca8418Keyboard::MapLegacyKeyCode(uint8_t row, uint8_t col) {
// Arrow keys mapping based on M5Cardputer layout:
// UP: ; key - row 2, col 11
// DOWN: . key - row 3, col 11
// LEFT: , key - row 3, col 10
// RIGHT: / key - row 3, col 12
// ENTER: enter key - row 2, col 13
if (row == 2 && col == 11) return KEY_UP; // ; key
if (row == 3 && col == 11) return KEY_DOWN; // . key
if (row == 3 && col == 10) return KEY_LEFT; // , key
if (row == 3 && col == 12) return KEY_RIGHT; // / key
if (row == 2 && col == 13) return KEY_ENTER; // Enter key
return KEY_OTHER;
}
KeyEvent Tca8418Keyboard::MapKeyEvent(uint8_t row, uint8_t col, bool pressed) {
KeyEvent event;
event.pressed = pressed;
event.is_modifier = false;
event.key_code = KC_NONE;
event.key_char = "";
if (row >= 4 || col >= 14) {
return event;
}
const KeyValue& kv = KEY_MAP[row][col];
event.key_code = kv.normal_code;
// Check if this is a modifier key
if (event.key_code == KC_LSHIFT || event.key_code == KC_LCTRL ||
event.key_code == KC_LALT || event.key_code == KC_LOPT ||
event.key_code == KC_CAPSLOCK) {
event.is_modifier = true;
event.key_char = "";
return event;
}
// Determine if we should use shifted version
bool use_shifted = false;
// Check if this is a letter key (a-z)
bool is_letter = (event.key_code >= KC_A && event.key_code <= KC_Z);
if (is_letter) {
// For letters, use XOR of shift and caps lock (Shift reverses CapsLock)
bool shift_pressed = (modifier_mask_ & KEY_MOD_SHIFT) != 0;
use_shifted = shift_pressed != caps_lock_on_; // XOR semantics
} else {
// For non-letters (numbers, symbols), only use shift
use_shifted = (modifier_mask_ & KEY_MOD_SHIFT) != 0;
}
if (use_shifted) {
event.key_char = kv.shifted;
} else {
event.key_char = kv.normal;
}
return event;
}
void IRAM_ATTR Tca8418Keyboard::GpioIsrHandler(void* arg) {
Tca8418Keyboard* keyboard = static_cast<Tca8418Keyboard*>(arg);
keyboard->isr_flag_ = true;
// Wake up the keyboard task
BaseType_t xHigherPriorityTaskWoken = pdFALSE;
if (keyboard->task_handle_) {
vTaskNotifyGiveFromISR(keyboard->task_handle_, &xHigherPriorityTaskWoken);
portYIELD_FROM_ISR(xHigherPriorityTaskWoken);
}
}
void Tca8418Keyboard::KeyboardTask(void* arg) {
Tca8418Keyboard* keyboard = static_cast<Tca8418Keyboard*>(arg);
while (true) {
// Wait for interrupt notification
ulTaskNotifyTake(pdTRUE, portMAX_DELAY);
// Small delay for debounce / allow event FIFO to fill
vTaskDelay(pdMS_TO_TICKS(5));
// Drain pending key events until the IRQ condition clears.
for (int guard = 0; guard < 128; guard++) {
uint8_t int_stat = keyboard->ReadReg(TCA8418_REG_INT_STAT);
if ((int_stat & TCA8418_INT_STAT_K_INT) == 0) {
keyboard->isr_flag_ = false;
break;
}
uint8_t event = keyboard->GetEvent();
if (event == 0) {
// No event available, try clearing and re-checking.
keyboard->WriteReg(TCA8418_REG_INT_STAT, 0x1F);
vTaskDelay(pdMS_TO_TICKS(1));
continue;
}
bool pressed = (event & 0x80) != 0;
uint8_t key_code = event & 0x7F;
if (key_code == 0) {
continue;
}
// Raw decode: TCA8418 key code = (row * 10) + col + 1
uint8_t raw_row = (key_code - 1) / 10;
uint8_t raw_col = (key_code - 1) % 10;
// Cardputer Adv uses 7x8, so ignore events outside 0..6/0..7.
uint8_t row = raw_row;
uint8_t col = raw_col;
if (!RemapRawKeyToLogical(row, col)) {
ESP_LOGD(TAG, "Ignored key: code=%d raw_row=%d raw_col=%d", key_code, raw_row, raw_col);
continue;
}
// De-duplicate spurious repeated press/release events (debounce/IRQ quirks).
const uint64_t mask = LogicalKeyMask(row, col);
if (mask != 0) {
const bool was_pressed = (keyboard->key_state_mask_ & mask) != 0;
if (pressed == was_pressed) {
continue;
}
if (pressed) {
keyboard->key_state_mask_ |= mask;
} else {
keyboard->key_state_mask_ &= ~mask;
}
}
ESP_LOGD(TAG, "Key %s: code=%d raw=(%d,%d) mapped=(%d,%d)",
pressed ? "pressed" : "released", key_code, raw_row, raw_col, row, col);
keyboard->UpdateModifierState(row, col, pressed);
if (keyboard->key_event_callback_) {
KeyEvent key_event = keyboard->MapKeyEvent(row, col, pressed);
keyboard->key_event_callback_(key_event);
}
if (pressed && keyboard->key_callback_) {
LegacyKeyCode mapped_key = keyboard->MapLegacyKeyCode(row, col);
if (mapped_key != KEY_OTHER && mapped_key != KEY_NONE) {
keyboard->key_callback_(mapped_key);
}
}
}
// Clear all interrupt status bits (K_INT, GPI, overflow, etc.)
keyboard->WriteReg(TCA8418_REG_INT_STAT, 0x1F);
}
}

View File

@ -0,0 +1,155 @@
#ifndef TCA8418_KEYBOARD_H
#define TCA8418_KEYBOARD_H
#include "i2c_device.h"
#include <functional>
#include <driver/gpio.h>
#include <freertos/FreeRTOS.h>
#include <freertos/task.h>
// TCA8418 Register definitions
#define TCA8418_REG_CFG 0x01
#define TCA8418_REG_INT_STAT 0x02
#define TCA8418_REG_KEY_LCK_EC 0x03
#define TCA8418_REG_KEY_EVENT_A 0x04
#define TCA8418_REG_KP_GPIO_1 0x1D
#define TCA8418_REG_KP_GPIO_2 0x1E
#define TCA8418_REG_KP_GPIO_3 0x1F
// Config register bits
#define TCA8418_CFG_KE_IEN 0x01 // Key events interrupt enable
// Modifier key masks
enum KeyModifier {
KEY_MOD_NONE = 0x00,
KEY_MOD_SHIFT = 0x01,
KEY_MOD_CTRL = 0x02,
KEY_MOD_ALT = 0x04,
KEY_MOD_OPT = 0x08,
};
// HID-compatible key codes
enum KeyCode {
KC_NONE = 0x00,
KC_A = 0x04,
KC_B = 0x05,
KC_C = 0x06,
KC_D = 0x07,
KC_E = 0x08,
KC_F = 0x09,
KC_G = 0x0A,
KC_H = 0x0B,
KC_I = 0x0C,
KC_J = 0x0D,
KC_K = 0x0E,
KC_L = 0x0F,
KC_M = 0x10,
KC_N = 0x11,
KC_O = 0x12,
KC_P = 0x13,
KC_Q = 0x14,
KC_R = 0x15,
KC_S = 0x16,
KC_T = 0x17,
KC_U = 0x18,
KC_V = 0x19,
KC_W = 0x1A,
KC_X = 0x1B,
KC_Y = 0x1C,
KC_Z = 0x1D,
KC_1 = 0x1E,
KC_2 = 0x1F,
KC_3 = 0x20,
KC_4 = 0x21,
KC_5 = 0x22,
KC_6 = 0x23,
KC_7 = 0x24,
KC_8 = 0x25,
KC_9 = 0x26,
KC_0 = 0x27,
KC_ENTER = 0x28,
KC_ESC = 0x29,
KC_BACKSPACE = 0x2A,
KC_TAB = 0x2B,
KC_SPACE = 0x2C,
KC_MINUS = 0x2D,
KC_EQUAL = 0x2E,
KC_LBRACKET = 0x2F,
KC_RBRACKET = 0x30,
KC_BACKSLASH = 0x31,
KC_SEMICOLON = 0x33,
KC_APOSTROPHE = 0x34,
KC_GRAVE = 0x35,
KC_COMMA = 0x36,
KC_DOT = 0x37,
KC_SLASH = 0x38,
KC_CAPSLOCK = 0x39,
KC_RIGHT = 0x4F,
KC_LEFT = 0x50,
KC_DOWN = 0x51,
KC_UP = 0x52,
KC_LSHIFT = 0xE1,
KC_LCTRL = 0xE0,
KC_LALT = 0xE2,
KC_LOPT = 0xE3,
};
// Key event structure with full information
struct KeyEvent {
bool pressed; // true = pressed, false = released
bool is_modifier; // true if this is a modifier key
uint8_t key_code; // HID key code (KeyCode enum)
const char* key_char; // Character representation (e.g., "a", "A", "1", "!")
};
// Legacy key codes for backward compatibility
enum LegacyKeyCode {
KEY_NONE = 0,
KEY_UP,
KEY_DOWN,
KEY_LEFT,
KEY_RIGHT,
KEY_ENTER,
KEY_OTHER
};
class Tca8418Keyboard : public I2cDevice {
public:
using KeyCallback = std::function<void(LegacyKeyCode key)>;
using KeyEventCallback = std::function<void(const KeyEvent& event)>;
Tca8418Keyboard(i2c_master_bus_handle_t i2c_bus, uint8_t addr, gpio_num_t int_pin);
~Tca8418Keyboard();
void Initialize();
void SetKeyCallback(KeyCallback callback) { key_callback_ = callback; }
void SetKeyEventCallback(KeyEventCallback callback) { key_event_callback_ = callback; }
// Get current modifier state
uint8_t GetModifierMask() const { return modifier_mask_; }
bool IsShiftPressed() const { return (modifier_mask_ & KEY_MOD_SHIFT) != 0; }
bool IsCapsLockOn() const { return caps_lock_on_; }
private:
gpio_num_t int_pin_;
KeyCallback key_callback_;
KeyEventCallback key_event_callback_;
TaskHandle_t task_handle_ = nullptr;
volatile bool isr_flag_ = false;
uint8_t modifier_mask_ = 0;
bool caps_lock_on_ = false;
uint64_t key_state_mask_ = 0; // 4x14 logical keys, bit=1 means pressed
void ConfigureMatrix();
void EnableInterrupts();
void FlushEvents();
uint8_t GetEvent();
LegacyKeyCode MapLegacyKeyCode(uint8_t row, uint8_t col);
KeyEvent MapKeyEvent(uint8_t row, uint8_t col, bool pressed);
void UpdateModifierState(uint8_t row, uint8_t col, bool pressed);
static void IRAM_ATTR GpioIsrHandler(void* arg);
static void KeyboardTask(void* arg);
};
#endif // TCA8418_KEYBOARD_H

View File

@ -0,0 +1,705 @@
#include "wifi_config_ui.h"
#include <esp_log.h>
#include <esp_wifi.h>
#include <wifi_manager.h>
#include <ssid_manager.h>
#include <cstring>
#define TAG "WifiConfigUI"
WifiConfigUI::WifiConfigUI(LcdDisplay* display)
: display_(display),
state_(WifiConfigState::Scanning),
is_active_(false),
selected_index_(0),
scroll_offset_(0),
saved_selected_index_(0),
saved_scroll_offset_(0),
input_focus_on_password_(false),
cursor_visible_(true),
last_cursor_toggle_(0) {
}
WifiConfigUI::~WifiConfigUI() {
}
void WifiConfigUI::Start() {
ESP_LOGI(TAG, "Starting WiFi config UI");
is_active_ = true;
state_ = WifiConfigState::Scanning;
selected_index_ = 0;
scroll_offset_ = 0;
input_ssid_.clear();
input_password_.clear();
selected_ssid_.clear();
// Load saved WiFi list
LoadSavedWifiList();
// Start scanning
StartScanning();
}
void WifiConfigUI::StartWithSavedList() {
ESP_LOGI(TAG, "Starting WiFi config UI with saved list");
is_active_ = true;
selected_index_ = 0;
scroll_offset_ = 0;
input_ssid_.clear();
input_password_.clear();
selected_ssid_.clear();
// Show saved list directly (ShowSavedList will load the list)
ShowSavedList();
}
void WifiConfigUI::StartScanning() {
state_ = WifiConfigState::Scanning;
lv_obj_t* canvas = lv_scr_act();
lv_obj_clean(canvas);
DrawHeader("扫描 WiFi 中...");
DrawFooter("请稍候...");
// Perform WiFi scan
DoWifiScan();
// Show results
if (scan_results_.empty()) {
lv_obj_clean(canvas);
DrawHeader("未找到 WiFi");
DrawFooter("W:手动输入 Esc:退出");
} else {
state_ = WifiConfigState::SelectWifi;
ShowScanResults();
}
}
void WifiConfigUI::DoWifiScan() {
scan_results_.clear();
// Use WifiManager's scan capability if available, otherwise do direct scan
// Note: We need to be careful not to disrupt existing WiFi state
// Configure scan
wifi_scan_config_t scan_config = {};
scan_config.show_hidden = false;
scan_config.scan_type = WIFI_SCAN_TYPE_ACTIVE;
scan_config.scan_time.active.min = 100;
scan_config.scan_time.active.max = 300;
// Start scan (blocking) - WiFi should already be initialized by WifiManager
esp_err_t err = esp_wifi_scan_start(&scan_config, true);
if (err != ESP_OK) {
ESP_LOGE(TAG, "WiFi scan failed: %s", esp_err_to_name(err));
return;
}
// Get scan results
uint16_t ap_count = 0;
esp_wifi_scan_get_ap_num(&ap_count);
if (ap_count > 0) {
wifi_ap_record_t* ap_records = new wifi_ap_record_t[ap_count];
esp_wifi_scan_get_ap_records(&ap_count, ap_records);
for (int i = 0; i < ap_count && i < 20; i++) {
WifiScanResult result;
result.ssid = std::string(reinterpret_cast<char*>(ap_records[i].ssid));
result.rssi = ap_records[i].rssi;
result.is_encrypted = (ap_records[i].authmode != WIFI_AUTH_OPEN);
// Skip empty SSIDs
if (!result.ssid.empty()) {
scan_results_.push_back(result);
}
}
delete[] ap_records;
}
ESP_LOGI(TAG, "Found %d WiFi networks", (int)scan_results_.size());
}
void WifiConfigUI::ShowScanResults() {
DrawWifiList(scan_results_, selected_index_, scroll_offset_);
}
void WifiConfigUI::ShowPasswordInput() {
// Only clear password and set state on first entry (not on redraw)
if (state_ != WifiConfigState::InputPassword) {
state_ = WifiConfigState::InputPassword;
input_password_.clear();
}
RedrawPasswordInput();
}
void WifiConfigUI::RedrawPasswordInput() {
lv_obj_t* canvas = lv_scr_act();
lv_obj_clean(canvas);
DrawHeader("输入密码");
// Show selected SSID
lv_obj_t* label = lv_label_create(canvas);
lv_label_set_text_fmt(label, "连接: %s", selected_ssid_.c_str());
lv_obj_set_style_text_color(label, lv_color_hex(0x00FF00), 0);
lv_obj_align(label, LV_ALIGN_TOP_LEFT, 5, 5);
lv_obj_t* pwd_label = lv_label_create(canvas);
lv_label_set_text(pwd_label, "请输入密码:");
lv_obj_set_style_text_color(pwd_label, lv_color_hex(0xFFFFFF), 0);
lv_obj_align(pwd_label, LV_ALIGN_TOP_LEFT, 5, 30);
lv_obj_t* input_label = lv_label_create(canvas);
std::string display_pwd(input_password_.length(), '*');
display_pwd += cursor_visible_ ? "_" : " ";
lv_label_set_text_fmt(input_label, ">>> %s", display_pwd.c_str());
lv_obj_set_style_text_color(input_label, lv_color_hex(0xFFFF00), 0);
lv_obj_align(input_label, LV_ALIGN_TOP_LEFT, 5, 55);
DrawFooter("Enter:确认 Esc:返回");
}
void WifiConfigUI::ShowManualInput() {
// Only clear inputs and set state on first entry (not on redraw)
if (state_ != WifiConfigState::InputSsid && state_ != WifiConfigState::InputManualPwd) {
state_ = WifiConfigState::InputSsid;
input_ssid_.clear();
input_password_.clear();
input_focus_on_password_ = false;
}
RedrawManualInput();
}
void WifiConfigUI::RedrawManualInput() {
lv_obj_t* canvas = lv_scr_act();
lv_obj_clean(canvas);
DrawHeader("手动设置 WiFi");
lv_obj_t* ssid_label = lv_label_create(canvas);
lv_label_set_text(ssid_label, "SSID:");
lv_obj_set_style_text_color(ssid_label, lv_color_hex(0xFFFFFF), 0);
lv_obj_align(ssid_label, LV_ALIGN_TOP_LEFT, 5, 25);
lv_obj_t* ssid_input = lv_label_create(canvas);
std::string ssid_display = ">>> " + input_ssid_;
if (!input_focus_on_password_) {
ssid_display += cursor_visible_ ? "_" : " ";
}
lv_label_set_text(ssid_input, ssid_display.c_str());
lv_obj_set_style_text_color(ssid_input, input_focus_on_password_ ? lv_color_hex(0x888888) : lv_color_hex(0xFFFF00), 0);
lv_obj_align(ssid_input, LV_ALIGN_TOP_LEFT, 5, 45);
lv_obj_t* pwd_label = lv_label_create(canvas);
lv_label_set_text(pwd_label, "密码:");
lv_obj_set_style_text_color(pwd_label, lv_color_hex(0xFFFFFF), 0);
lv_obj_align(pwd_label, LV_ALIGN_TOP_LEFT, 5, 70);
lv_obj_t* pwd_input = lv_label_create(canvas);
std::string pwd_display = ">>> " + std::string(input_password_.length(), '*');
if (input_focus_on_password_) {
pwd_display += cursor_visible_ ? "_" : " ";
}
lv_label_set_text(pwd_input, pwd_display.c_str());
lv_obj_set_style_text_color(pwd_input, input_focus_on_password_ ? lv_color_hex(0xFFFF00) : lv_color_hex(0x888888), 0);
lv_obj_align(pwd_input, LV_ALIGN_TOP_LEFT, 5, 90);
DrawFooter("Tab:切换 Enter:确认 Esc:返回");
}
void WifiConfigUI::ShowSavedList() {
state_ = WifiConfigState::SavedList;
saved_selected_index_ = 0;
saved_scroll_offset_ = 0;
LoadSavedWifiList();
DrawSavedWifiList();
}
void WifiConfigUI::DrawSavedWifiList() {
lv_obj_t* canvas = lv_scr_act();
lv_obj_clean(canvas);
char title[48];
snprintf(title, sizeof(title), "已保存的 WiFi (%d/10)", (int)saved_wifi_list_.size());
DrawHeader(title);
if (saved_wifi_list_.empty()) {
lv_obj_t* empty_label = lv_label_create(canvas);
lv_label_set_text(empty_label, "没有已保存的 WiFi");
lv_obj_set_style_text_color(empty_label, lv_color_hex(0x888888), 0);
lv_obj_align(empty_label, LV_ALIGN_CENTER, 0, 0);
DrawFooter("Esc:返回");
return;
}
int y_offset = 25;
int visible_count = std::min((int)saved_wifi_list_.size() - saved_scroll_offset_, MAX_VISIBLE_ITEMS);
for (int i = 0; i < visible_count; i++) {
int idx = saved_scroll_offset_ + i;
bool is_selected = (idx == saved_selected_index_);
lv_obj_t* item_label = lv_label_create(canvas);
char item_text[48];
snprintf(item_text, sizeof(item_text), "%s %d. %s",
is_selected ? ">" : " ",
idx + 1,
saved_wifi_list_[idx].first.c_str());
lv_label_set_text(item_label, item_text);
lv_obj_set_style_text_color(item_label, is_selected ? lv_color_hex(0x00FF00) : lv_color_hex(0xFFFFFF), 0);
lv_obj_align(item_label, LV_ALIGN_TOP_LEFT, 5, y_offset);
y_offset += 20;
}
DrawFooter("↑↓:选择 Enter:连接 Del:删除 Esc:返回");
}
void WifiConfigUI::ShowConnecting() {
state_ = WifiConfigState::Connecting;
lv_obj_t* canvas = lv_scr_act();
lv_obj_clean(canvas);
DrawHeader("连接中...");
lv_obj_t* ssid_label = lv_label_create(canvas);
lv_label_set_text_fmt(ssid_label, "正在连接: %s", selected_ssid_.c_str());
lv_obj_set_style_text_color(ssid_label, lv_color_hex(0xFFFF00), 0);
lv_obj_align(ssid_label, LV_ALIGN_CENTER, 0, 0);
DrawFooter("请稍候...");
}
void WifiConfigUI::ShowSuccess() {
state_ = WifiConfigState::Success;
lv_obj_t* canvas = lv_scr_act();
lv_obj_clean(canvas);
DrawHeader("连接成功!");
lv_obj_t* ssid_label = lv_label_create(canvas);
lv_label_set_text_fmt(ssid_label, "已连接: %s", selected_ssid_.c_str());
lv_obj_set_style_text_color(ssid_label, lv_color_hex(0x00FF00), 0);
lv_obj_align(ssid_label, LV_ALIGN_CENTER, 0, -10);
lv_obj_t* saved_label = lv_label_create(canvas);
lv_label_set_text(saved_label, "WiFi 配置已保存");
lv_obj_set_style_text_color(saved_label, lv_color_hex(0x00FFFF), 0);
lv_obj_align(saved_label, LV_ALIGN_CENTER, 0, 15);
DrawFooter("Enter:继续");
}
void WifiConfigUI::ShowFailed() {
state_ = WifiConfigState::Failed;
lv_obj_t* canvas = lv_scr_act();
lv_obj_clean(canvas);
DrawHeader("连接失败");
lv_obj_t* ssid_label = lv_label_create(canvas);
lv_label_set_text_fmt(ssid_label, "无法连接: %s", selected_ssid_.c_str());
lv_obj_set_style_text_color(ssid_label, lv_color_hex(0xFF0000), 0);
lv_obj_align(ssid_label, LV_ALIGN_CENTER, 0, 0);
DrawFooter("Enter:重试 Esc:返回");
}
void WifiConfigUI::DrawHeader(const char* title) {
lv_obj_t* canvas = lv_scr_act();
lv_obj_t* header = lv_label_create(canvas);
lv_label_set_text(header, title);
lv_obj_set_style_text_color(header, lv_color_hex(0x00FFFF), 0);
lv_obj_align(header, LV_ALIGN_TOP_LEFT, 5, 2);
}
void WifiConfigUI::DrawFooter(const char* hint) {
lv_obj_t* canvas = lv_scr_act();
lv_obj_t* footer = lv_label_create(canvas);
lv_label_set_text(footer, hint);
lv_obj_set_style_text_color(footer, lv_color_hex(0x888888), 0);
lv_obj_set_style_text_font(footer, &lv_font_montserrat_14, 0);
lv_obj_align(footer, LV_ALIGN_BOTTOM_LEFT, 5, -2);
}
void WifiConfigUI::DrawWifiList(const std::vector<WifiScanResult>& list, int selected, int scroll) {
lv_obj_t* canvas = lv_scr_act();
lv_obj_clean(canvas);
DrawHeader("选择 WiFi");
int y_offset = 25;
int visible_count = std::min((int)list.size() - scroll, MAX_VISIBLE_ITEMS);
for (int i = 0; i < visible_count; i++) {
int idx = scroll + i;
bool is_selected = (idx == selected);
const WifiScanResult& wifi = list[idx];
lv_obj_t* item_label = lv_label_create(canvas);
std::string signal = GetSignalBars(wifi.rssi);
char item_text[64];
snprintf(item_text, sizeof(item_text), "%s%d.%-12s %4ddBm %s",
is_selected ? ">" : " ",
idx + 1,
wifi.ssid.substr(0, 12).c_str(),
wifi.rssi,
signal.c_str());
lv_label_set_text(item_label, item_text);
lv_obj_set_style_text_color(item_label, is_selected ? lv_color_hex(0x00FF00) : lv_color_hex(0xFFFFFF), 0);
lv_obj_align(item_label, LV_ALIGN_TOP_LEFT, 2, y_offset);
y_offset += 20;
}
DrawFooter("↑↓:选择 Enter:连接 W:手动 S:已保存");
}
std::string WifiConfigUI::GetSignalBars(int8_t rssi) {
if (rssi >= -50) return "████";
if (rssi >= -60) return "███░";
if (rssi >= -70) return "██░░";
if (rssi >= -80) return "█░░░";
return "░░░░";
}
void WifiConfigUI::LoadSavedWifiList() {
saved_wifi_list_.clear();
auto& ssid_manager = SsidManager::GetInstance();
const auto& ssid_list = ssid_manager.GetSsidList();
for (const auto& item : ssid_list) {
saved_wifi_list_.push_back({item.ssid, item.password});
}
}
void WifiConfigUI::SaveWifiCredentials(const std::string& ssid, const std::string& password) {
auto& ssid_manager = SsidManager::GetInstance();
ssid_manager.AddSsid(ssid, password);
ESP_LOGI(TAG, "Saved WiFi credentials for: %s", ssid.c_str());
}
void WifiConfigUI::DeleteSavedWifi(int index) {
if (index >= 0 && index < (int)saved_wifi_list_.size()) {
auto& ssid_manager = SsidManager::GetInstance();
ssid_manager.RemoveSsid(index);
ESP_LOGI(TAG, "Deleted saved WiFi at index: %d", index);
LoadSavedWifiList();
}
}
void WifiConfigUI::AttemptConnection() {
ShowConnecting();
if (connect_callback_) {
connect_callback_(selected_ssid_, input_password_);
}
}
void WifiConfigUI::OnConnectResult(bool success) {
if (success) {
SaveWifiCredentials(selected_ssid_, input_password_);
ShowSuccess();
} else {
ShowFailed();
}
}
WifiConfigResult WifiConfigUI::HandleKeyEvent(const KeyEvent& event) {
// Only handle key press events, skip modifiers
if (!event.pressed || event.is_modifier) {
return WifiConfigResult::None;
}
// Check for ESC to cancel from Scanning or SelectWifi states
// (other states handle ESC in their own handlers to navigate back)
if (event.key_code == KC_ESC) {
if (state_ == WifiConfigState::Scanning ||
state_ == WifiConfigState::SelectWifi) {
is_active_ = false;
return WifiConfigResult::Cancelled;
}
}
// Check if not active (was cancelled in a handler)
if (!is_active_) {
return WifiConfigResult::Cancelled;
}
switch (state_) {
case WifiConfigState::Scanning:
HandleScanningKey(event);
break;
case WifiConfigState::SelectWifi:
HandleSelectWifiKey(event);
break;
case WifiConfigState::InputPassword:
HandlePasswordInputKey(event);
break;
case WifiConfigState::InputSsid:
case WifiConfigState::InputManualPwd:
HandleManualInputKey(event);
break;
case WifiConfigState::SavedList:
HandleSavedListKey(event);
break;
case WifiConfigState::Connecting:
HandleConnectingKey(event);
break;
case WifiConfigState::Success:
HandleResultKey(event);
if (event.key_code == KC_ENTER) {
is_active_ = false;
return WifiConfigResult::Connected;
}
break;
case WifiConfigState::Failed:
HandleResultKey(event);
break;
}
// Check if cancelled by a handler
if (!is_active_) {
return WifiConfigResult::Cancelled;
}
return WifiConfigResult::None;
}
void WifiConfigUI::HandleScanningKey(const KeyEvent& event) {
if (event.key_code == KC_W) {
ShowManualInput();
} else if (event.key_code == KC_S) {
ShowSavedList();
}
// ESC is handled in HandleKeyEvent
}
void WifiConfigUI::HandleSelectWifiKey(const KeyEvent& event) {
switch (event.key_code) {
case KC_UP:
case KC_SEMICOLON: // ; key as UP
if (selected_index_ > 0) {
selected_index_--;
if (selected_index_ < scroll_offset_) {
scroll_offset_ = selected_index_;
}
ShowScanResults();
}
break;
case KC_DOWN:
case KC_DOT: // . key as DOWN
if (selected_index_ < (int)scan_results_.size() - 1) {
selected_index_++;
if (selected_index_ >= scroll_offset_ + MAX_VISIBLE_ITEMS) {
scroll_offset_ = selected_index_ - MAX_VISIBLE_ITEMS + 1;
}
ShowScanResults();
}
break;
case KC_ENTER:
if (!scan_results_.empty()) {
selected_ssid_ = scan_results_[selected_index_].ssid;
ShowPasswordInput();
}
break;
case KC_W:
ShowManualInput();
break;
case KC_S:
ShowSavedList();
break;
default:
break;
}
// ESC is handled in HandleKeyEvent
}
void WifiConfigUI::HandlePasswordInputKey(const KeyEvent& event) {
switch (event.key_code) {
case KC_ENTER:
if (!input_password_.empty()) {
AttemptConnection();
}
break;
case KC_ESC:
state_ = WifiConfigState::SelectWifi;
ShowScanResults();
break;
case KC_BACKSPACE:
if (!input_password_.empty()) {
input_password_.pop_back();
RedrawPasswordInput();
}
break;
case KC_SPACE:
if (input_password_.length() < MAX_INPUT_LENGTH) {
input_password_ += ' ';
RedrawPasswordInput();
}
break;
default:
// Add character if it's a printable key
if (event.key_char && strlen(event.key_char) > 0 && input_password_.length() < MAX_INPUT_LENGTH) {
input_password_ += event.key_char;
RedrawPasswordInput();
}
break;
}
}
void WifiConfigUI::HandleManualInputKey(const KeyEvent& event) {
std::string* current_input = input_focus_on_password_ ? &input_password_ : &input_ssid_;
switch (event.key_code) {
case KC_TAB:
input_focus_on_password_ = !input_focus_on_password_;
if (input_focus_on_password_) {
state_ = WifiConfigState::InputManualPwd;
} else {
state_ = WifiConfigState::InputSsid;
}
RedrawManualInput();
break;
case KC_ENTER:
if (!input_ssid_.empty()) {
selected_ssid_ = input_ssid_;
AttemptConnection();
}
break;
case KC_ESC:
state_ = WifiConfigState::SelectWifi;
ShowScanResults();
break;
case KC_BACKSPACE:
if (!current_input->empty()) {
current_input->pop_back();
RedrawManualInput();
}
break;
case KC_SPACE:
if (current_input->length() < MAX_INPUT_LENGTH) {
*current_input += ' ';
RedrawManualInput();
}
break;
default:
// Add character if it's a printable key
if (event.key_char && strlen(event.key_char) > 0 && current_input->length() < MAX_INPUT_LENGTH) {
*current_input += event.key_char;
RedrawManualInput();
}
break;
}
}
void WifiConfigUI::HandleSavedListKey(const KeyEvent& event) {
switch (event.key_code) {
case KC_UP:
case KC_SEMICOLON:
if (saved_selected_index_ > 0) {
saved_selected_index_--;
if (saved_selected_index_ < saved_scroll_offset_) {
saved_scroll_offset_ = saved_selected_index_;
}
DrawSavedWifiList();
}
break;
case KC_DOWN:
case KC_DOT:
if (saved_selected_index_ < (int)saved_wifi_list_.size() - 1) {
saved_selected_index_++;
if (saved_selected_index_ >= saved_scroll_offset_ + MAX_VISIBLE_ITEMS) {
saved_scroll_offset_ = saved_selected_index_ - MAX_VISIBLE_ITEMS + 1;
}
DrawSavedWifiList();
}
break;
case KC_ENTER:
if (!saved_wifi_list_.empty()) {
selected_ssid_ = saved_wifi_list_[saved_selected_index_].first;
input_password_ = saved_wifi_list_[saved_selected_index_].second;
AttemptConnection();
}
break;
case KC_BACKSPACE: // Del key for delete
if (!saved_wifi_list_.empty()) {
DeleteSavedWifi(saved_selected_index_);
if (saved_selected_index_ >= (int)saved_wifi_list_.size() && saved_selected_index_ > 0) {
saved_selected_index_--;
}
DrawSavedWifiList();
}
break;
case KC_ESC:
state_ = WifiConfigState::SelectWifi;
ShowScanResults();
break;
default:
break;
}
}
void WifiConfigUI::HandleConnectingKey(const KeyEvent& event) {
// No key handling during connection
(void)event;
}
void WifiConfigUI::HandleResultKey(const KeyEvent& event) {
if (state_ == WifiConfigState::Success) {
if (event.key_code == KC_ENTER) {
// Will be handled in HandleKeyEvent to return Connected
}
} else if (state_ == WifiConfigState::Failed) {
if (event.key_code == KC_ENTER) {
// Retry - go back to password input (keep password for retry)
state_ = WifiConfigState::InputPassword;
RedrawPasswordInput();
} else if (event.key_code == KC_ESC) {
state_ = WifiConfigState::SelectWifi;
ShowScanResults();
}
}
}
void WifiConfigUI::UpdateCursor() {
uint32_t now = esp_log_timestamp();
if (now - last_cursor_toggle_ >= CURSOR_BLINK_MS) {
cursor_visible_ = !cursor_visible_;
last_cursor_toggle_ = now;
// Refresh display for input states (use Redraw functions to avoid clearing input)
if (state_ == WifiConfigState::InputPassword) {
RedrawPasswordInput();
} else if (state_ == WifiConfigState::InputSsid || state_ == WifiConfigState::InputManualPwd) {
RedrawManualInput();
}
}
}

View File

@ -0,0 +1,133 @@
#ifndef WIFI_CONFIG_UI_H
#define WIFI_CONFIG_UI_H
#include "tca8418_keyboard.h"
#include "display/lcd_display.h"
#include <string>
#include <vector>
#include <functional>
// WiFi scan result structure
struct WifiScanResult {
std::string ssid;
int8_t rssi;
bool is_encrypted;
};
// WiFi configuration UI state machine
enum class WifiConfigState {
Scanning, // Scanning for WiFi networks
SelectWifi, // Selecting from WiFi list
InputPassword, // Entering password for selected WiFi
InputSsid, // Manual SSID input
InputManualPwd, // Manual password input (after SSID)
SavedList, // Viewing saved WiFi list
Connecting, // Connecting to WiFi
Success, // Connection successful
Failed // Connection failed
};
// Result of WiFi configuration
enum class WifiConfigResult {
None, // Still in progress
Connected, // Successfully connected
Cancelled // User cancelled
};
class WifiConfigUI {
public:
using ConnectCallback = std::function<void(const std::string& ssid, const std::string& password)>;
WifiConfigUI(LcdDisplay* display);
~WifiConfigUI();
// Start the WiFi configuration UI
void Start();
// Start directly with saved WiFi list
void StartWithSavedList();
// Handle keyboard events, returns result
WifiConfigResult HandleKeyEvent(const KeyEvent& event);
// Set callback for when connection should be attempted
void SetConnectCallback(ConnectCallback callback) { connect_callback_ = callback; }
// Notify connection result
void OnConnectResult(bool success);
// Check if UI is active
bool IsActive() const { return is_active_; }
// Update cursor blink state (call periodically from main loop)
void UpdateCursor();
private:
LcdDisplay* display_;
WifiConfigState state_;
bool is_active_;
ConnectCallback connect_callback_;
// WiFi scan results
std::vector<WifiScanResult> scan_results_;
int selected_index_;
int scroll_offset_;
// Saved WiFi list
std::vector<std::pair<std::string, std::string>> saved_wifi_list_;
int saved_selected_index_;
int saved_scroll_offset_;
// Input buffers
std::string input_ssid_;
std::string input_password_;
std::string selected_ssid_;
bool input_focus_on_password_; // For manual input: true = password field, false = ssid field
// Cursor blinking
bool cursor_visible_;
uint32_t last_cursor_toggle_;
static constexpr uint32_t CURSOR_BLINK_MS = 500;
// Display constants
static constexpr int MAX_VISIBLE_ITEMS = 4;
static constexpr int MAX_INPUT_LENGTH = 64;
// State handlers
void StartScanning();
void ShowScanResults();
void ShowPasswordInput();
void ShowManualInput();
void ShowSavedList();
void ShowConnecting();
void ShowSuccess();
void ShowFailed();
// Redraw functions (don't reset state/input)
void RedrawPasswordInput();
void RedrawManualInput();
// Input handlers
void HandleScanningKey(const KeyEvent& event);
void HandleSelectWifiKey(const KeyEvent& event);
void HandlePasswordInputKey(const KeyEvent& event);
void HandleManualInputKey(const KeyEvent& event);
void HandleSavedListKey(const KeyEvent& event);
void HandleConnectingKey(const KeyEvent& event);
void HandleResultKey(const KeyEvent& event);
// Helper functions
void DrawHeader(const char* title);
void DrawFooter(const char* hint);
void DrawInputField(const char* label, const std::string& value, bool is_password, bool is_active);
void DrawWifiList(const std::vector<WifiScanResult>& list, int selected, int scroll_offset);
void DrawSavedWifiList();
std::string GetSignalBars(int8_t rssi);
void LoadSavedWifiList();
void SaveWifiCredentials(const std::string& ssid, const std::string& password);
void DeleteSavedWifi(int index);
void DoWifiScan();
void AttemptConnection();
};
#endif // WIFI_CONFIG_UI_H

View File

@ -0,0 +1,29 @@
# NULLLAB-AI-VOX3
## 概述
AI-VOX3是AI VOX的升级款是一款专为AI语音交互应用设计的高性能嵌入式开发板。其核心采用ESP32-S3-R8芯片并板载16MB Flash存储器。集成了丰富的硬件资源支持快速开发与灵活扩展。集五合一功能(AI聊天/天气时钟/无线对讲机MP3音乐播放器/网络电台)同时支持本地语音唤醒、指令识别和语音合成可广泛应用于智能家居、教育设备和物联网终端等领域。其PCB尺寸兼容乐高插销可直接安装在积木C款上便于DIY搭建同时配套AI-VOX3扩展板与MD40电机驱动板助力开发者基于板载资源快速构建原型并通过丰富接口实现个性化功能扩展大幅缩短开发周期。
## 功能特点
- 搭载 ESP32-S3R8 高性能 Xtensa 32 位 LX7 双核处理器主频高达240MHz
- 支持 2.4 GHz Wi-Fi (802.11 b/g/n) 和 Bluetooth 5 (LE),板载天线
- ESP32-S3R8芯片内置 512 KB SRAM 和 384 KB ROM以及8MB PSRAM板载16 MB Flash 存储芯片
- 采用 Type-C 接口,支持程序下载、板载供电及锂电池充电,兼容主流开发环境,简化开发与电源管理流程
- 采用电源复位按键二合一将系统复位和开关机集成到Power按键中短按开机或系统复位长按关机简化操作
- 可接1.54寸240×240分辨率SPI接口LCDST7789提供直观图形化交互界面
- 预留LCD排线和OLED插口可以选择OLED或者LCD彩屏显示
- 板载ES8311音频编码解码器与3W音频放大器NS4150B支持高保真音频输入/输出,需外接喇叭
- 双麦克风设计,板载模拟麦克风,还可以外挂模拟麦克风,支持单麦打断
- 板载SD Card接口支持大容量存储扩展
- 板载BOOT按键、2个按键GPIO46/45及WS2812B RGB灯便于交互调试与状态指示
- 引出一组8个GPIO排针接口GPIO43/44/42/48/4/3/2/1支持多种外设接入
- 预留一个4pin PH2.0接口可以方便通过PH2.0供电,也可以和其他主控通讯
- 配套外接AI-VOX3扩展板可通过其扩展板的排针接口扩展更多功能
- 配套外接MD40电机驱动板可通过其驱动板运行多个电机
- 板载充电升压5V 2.4A输出一体电路支持外接锂电池供电并通过IO18 ADC实时检测电量
- 支持ESP-IDF、Arduino IDE、AilyBlockly
## Power按键说明
AI-VOX3取消了传统的Reset复位按键改为使用Power按键统一操作短按一次Power按键则进行开机或系统复位长按Power按键则进行关机。

View File

@ -0,0 +1,237 @@
#pragma once
#include <driver/gpio.h>
#include <driver/i2c_master.h>
#include <esp_codec_dev.h>
#include <esp_codec_dev_defaults.h>
#include <esp_log.h>
#include "audio/audio_codec.h"
class AIVOX3AudioCodec : public AudioCodec {
private:
const audio_codec_data_if_t* data_if_ = nullptr;
const audio_codec_ctrl_if_t* ctrl_if_ = nullptr;
const audio_codec_if_t* codec_if_ = nullptr;
const audio_codec_gpio_if_t* gpio_if_ = nullptr;
esp_codec_dev_handle_t output_dev_ = nullptr;
esp_codec_dev_handle_t input_dev_ = nullptr;
// ref buffer used for aec
std::vector<int16_t> ref_buffer_;
int read_pos_ = 0;
int write_pos_ = 0;
void CreateDuplexChannels(gpio_num_t mclk, gpio_num_t bclk, gpio_num_t ws, gpio_num_t dout,
gpio_num_t din) {
assert(input_sample_rate_ == output_sample_rate_);
i2s_chan_config_t chan_cfg = {
.id = I2S_NUM_0,
.role = I2S_ROLE_MASTER,
.dma_desc_num = AUDIO_CODEC_DMA_DESC_NUM,
.dma_frame_num = AUDIO_CODEC_DMA_FRAME_NUM,
.auto_clear = true,
.intr_priority = 0,
};
ESP_ERROR_CHECK(i2s_new_channel(&chan_cfg, &tx_handle_, &rx_handle_));
i2s_std_config_t std_cfg = {
.clk_cfg = {.sample_rate_hz = (uint32_t)output_sample_rate_,
.clk_src = I2S_CLK_SRC_DEFAULT,
.mclk_multiple = I2S_MCLK_MULTIPLE_128},
.slot_cfg = {.data_bit_width = I2S_DATA_BIT_WIDTH_16BIT,
.slot_bit_width = I2S_SLOT_BIT_WIDTH_AUTO,
.slot_mode = I2S_SLOT_MODE_STEREO,
.slot_mask = I2S_STD_SLOT_BOTH,
.ws_width = I2S_DATA_BIT_WIDTH_16BIT,
.ws_pol = false,
.bit_shift = true},
.gpio_cfg = {.mclk = mclk,
.bclk = bclk,
.ws = ws,
.dout = dout,
.din = din,
.invert_flags = {.mclk_inv = false, .bclk_inv = false, .ws_inv = false}},
};
ESP_ERROR_CHECK(i2s_channel_init_std_mode(tx_handle_, &std_cfg));
ESP_ERROR_CHECK(i2s_channel_init_std_mode(rx_handle_, &std_cfg));
ESP_LOGI("AIVOX3AudioCodec", "Duplex channels created");
}
virtual int Read(int16_t* dest, int samples) override {
if (input_enabled_) {
if (!input_reference_) {
ESP_ERROR_CHECK_WITHOUT_ABORT(
esp_codec_dev_read(input_dev_, (void*)dest, samples * sizeof(int16_t)));
} else {
int size = samples / input_channels_;
std::vector<int16_t> data(size);
// read mic data
ESP_ERROR_CHECK_WITHOUT_ABORT(esp_codec_dev_read(input_dev_, (void*)data.data(),
data.size() * sizeof(int16_t)));
int j = 0;
int i = 0;
while (i < samples) {
// mic data
dest[i++] = data[j++];
// ref data
dest[i++] = read_pos_ < write_pos_ ? ref_buffer_[read_pos_++] : 0;
}
if (read_pos_ == write_pos_) {
read_pos_ = write_pos_ = 0;
}
}
}
return samples;
}
virtual int Write(const int16_t* data, int samples) override {
if (output_enabled_) {
ESP_ERROR_CHECK_WITHOUT_ABORT(
esp_codec_dev_write(output_dev_, (void*)data, samples * sizeof(int16_t)));
if (input_reference_) { // 板子不支持硬件回采,采用缓存播放缓存来实现回声消除
if (write_pos_ - read_pos_ + samples > ref_buffer_.size()) {
assert(ref_buffer_.size() >= samples);
// 写溢出,只保留最近的数据
read_pos_ = write_pos_ + samples - ref_buffer_.size();
}
if (read_pos_) {
if (write_pos_ != read_pos_) {
memmove(ref_buffer_.data(), ref_buffer_.data() + read_pos_,
(write_pos_ - read_pos_) * sizeof(int16_t));
}
write_pos_ -= read_pos_;
read_pos_ = 0;
}
memcpy(&ref_buffer_[write_pos_], data, samples * sizeof(int16_t));
write_pos_ += samples;
}
}
return samples;
}
public:
AIVOX3AudioCodec(void* i2c_master_handle, i2c_port_t i2c_port, int input_sample_rate,
int output_sample_rate, gpio_num_t mclk, gpio_num_t bclk, gpio_num_t ws,
gpio_num_t dout, gpio_num_t din, uint8_t es8311_addr,
bool input_reference = false) {
duplex_ = true; // 是否双工
input_reference_ = input_reference; // 是否使用参考输入,实现回声消除
if (input_reference) {
ref_buffer_.resize(960 * 2);
}
input_channels_ = 1 + input_reference_;
input_sample_rate_ = input_sample_rate;
output_sample_rate_ = output_sample_rate;
CreateDuplexChannels(mclk, bclk, ws, dout, din);
// Do initialize of related interface: data_if, ctrl_if and gpio_if
audio_codec_i2s_cfg_t i2s_cfg = {
.port = I2S_NUM_0,
.rx_handle = rx_handle_,
.tx_handle = tx_handle_,
};
data_if_ = audio_codec_new_i2s_data(&i2s_cfg);
assert(data_if_ != NULL);
// Output
audio_codec_i2c_cfg_t i2c_cfg = {
.port = i2c_port,
.addr = es8311_addr,
.bus_handle = i2c_master_handle,
};
ctrl_if_ = audio_codec_new_i2c_ctrl(&i2c_cfg);
assert(ctrl_if_ != NULL);
gpio_if_ = audio_codec_new_gpio();
assert(gpio_if_ != NULL);
es8311_codec_cfg_t es8311_cfg = {};
es8311_cfg.ctrl_if = ctrl_if_;
es8311_cfg.gpio_if = gpio_if_;
es8311_cfg.codec_mode = ESP_CODEC_DEV_WORK_MODE_BOTH;
es8311_cfg.pa_pin = GPIO_NUM_NC;
es8311_cfg.use_mclk = true;
es8311_cfg.hw_gain.pa_voltage = 5.0;
es8311_cfg.hw_gain.codec_dac_voltage = 3.3;
es8311_cfg.pa_reverted = false;
es8311_cfg.mclk_div = I2S_MCLK_MULTIPLE_128;
codec_if_ = es8311_codec_new(&es8311_cfg);
assert(codec_if_ != NULL);
esp_codec_dev_cfg_t dev_cfg = {
.dev_type = ESP_CODEC_DEV_TYPE_OUT,
.codec_if = codec_if_,
.data_if = data_if_,
};
output_dev_ = esp_codec_dev_new(&dev_cfg);
assert(output_dev_ != NULL);
dev_cfg.dev_type = ESP_CODEC_DEV_TYPE_IN;
input_dev_ = esp_codec_dev_new(&dev_cfg);
assert(input_dev_ != NULL);
esp_codec_set_disable_when_closed(output_dev_, false);
esp_codec_set_disable_when_closed(input_dev_, false);
ESP_LOGI("AIVOX3AudioCodec", "AIVOX3AudioCodec initialized");
}
virtual ~AIVOX3AudioCodec() {
ESP_ERROR_CHECK(esp_codec_dev_close(output_dev_));
esp_codec_dev_delete(output_dev_);
ESP_ERROR_CHECK(esp_codec_dev_close(input_dev_));
esp_codec_dev_delete(input_dev_);
audio_codec_delete_codec_if(codec_if_);
audio_codec_delete_ctrl_if(ctrl_if_);
audio_codec_delete_gpio_if(gpio_if_);
audio_codec_delete_data_if(data_if_);
}
virtual void SetOutputVolume(int volume) override {
ESP_ERROR_CHECK(esp_codec_dev_set_out_vol(output_dev_, volume));
AudioCodec::SetOutputVolume(volume);
}
virtual void EnableInput(bool enable) override {
if (enable == input_enabled_) {
return;
}
if (enable) {
esp_codec_dev_sample_info_t fs = {
.bits_per_sample = 16,
.channel = 1,
.channel_mask = 0,
.sample_rate = (uint32_t)input_sample_rate_,
.mclk_multiple = I2S_MCLK_MULTIPLE_128,
};
ESP_ERROR_CHECK(esp_codec_dev_open(input_dev_, &fs));
ESP_ERROR_CHECK(esp_codec_dev_set_in_gain(input_dev_, 37.5));
} else {
ESP_ERROR_CHECK(esp_codec_dev_close(input_dev_));
}
AudioCodec::EnableInput(enable);
}
virtual void EnableOutput(bool enable) override {
if (enable == output_enabled_) {
return;
}
if (enable) {
// Play 16bit 1 channel
esp_codec_dev_sample_info_t fs = {
.bits_per_sample = 16,
.channel = 1,
.channel_mask = 0,
.sample_rate = (uint32_t)output_sample_rate_,
.mclk_multiple = I2S_MCLK_MULTIPLE_128,
};
ESP_ERROR_CHECK(esp_codec_dev_open(output_dev_, &fs));
ESP_ERROR_CHECK(esp_codec_dev_set_out_vol(output_dev_, output_volume_));
} else {
ESP_ERROR_CHECK(esp_codec_dev_close(output_dev_));
}
AudioCodec::EnableOutput(enable);
}
};

View File

@ -0,0 +1,205 @@
#include <driver/rtc_io.h>
#include <esp_lcd_panel_vendor.h>
#include <esp_log.h>
#include <esp_sleep.h>
#include <wifi_station.h>
#include "application.h"
#include "assets/lang_config.h"
#include "button.h"
#include "config.h"
#include "display/lcd_display.h"
#include "dual_network_board.h"
#include "led/single_led.h"
#include "ai_vox3_audio_codec.h"
#include "power_manager.h"
#define TAG "AIVOX3"
class AIVOX3 : public DualNetworkBoard {
private:
Button boot_button_;
Button volume_up_button_;
Button volume_down_button_;
PowerManager* power_manager_;
i2c_master_bus_handle_t codec_i2c_bus_;
LcdDisplay* display_;
void InitializePowerManager() {
power_manager_ = new PowerManager(BATTERY_LEVEL_PIN, BATTERY_CHARGING_PIN);
}
void InitializeI2c() {
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, &codec_i2c_bus_));
}
void InitializeSpi() {
spi_bus_config_t buscfg = {};
buscfg.mosi_io_num = DISPLAY_MOSI_PIN;
buscfg.miso_io_num = GPIO_NUM_NC;
buscfg.sclk_io_num = DISPLAY_CLK_PIN;
buscfg.quadwp_io_num = GPIO_NUM_NC;
buscfg.quadhd_io_num = GPIO_NUM_NC;
buscfg.max_transfer_sz = DISPLAY_WIDTH * DISPLAY_HEIGHT * sizeof(uint16_t);
ESP_ERROR_CHECK(spi_bus_initialize(SPI3_HOST, &buscfg, SPI_DMA_CH_AUTO));
}
void InitializeLcdDisplay() {
esp_lcd_panel_io_handle_t panel_io = nullptr;
esp_lcd_panel_handle_t panel = nullptr;
// 液晶屏控制IO初始化
ESP_LOGD(TAG, "Install panel IO");
esp_lcd_panel_io_spi_config_t io_config = {};
io_config.cs_gpio_num = DISPLAY_CS_PIN;
io_config.dc_gpio_num = DISPLAY_DC_PIN;
io_config.spi_mode = DISPLAY_SPI_MODE;
io_config.pclk_hz = 40 * 1000 * 1000;
io_config.trans_queue_depth = 10;
io_config.lcd_cmd_bits = 8;
io_config.lcd_param_bits = 8;
ESP_ERROR_CHECK(esp_lcd_new_panel_io_spi(SPI3_HOST, &io_config, &panel_io));
// 初始化液晶屏驱动芯片
ESP_LOGD(TAG, "Install LCD driver");
esp_lcd_panel_dev_config_t panel_config = {};
panel_config.reset_gpio_num = DISPLAY_RST_PIN;
panel_config.rgb_ele_order = DISPLAY_RGB_ORDER;
panel_config.bits_per_pixel = 16;
ESP_ERROR_CHECK(esp_lcd_new_panel_st7789(panel_io, &panel_config, &panel));
esp_lcd_panel_reset(panel);
esp_lcd_panel_init(panel);
esp_lcd_panel_invert_color(panel, DISPLAY_INVERT_COLOR);
esp_lcd_panel_swap_xy(panel, DISPLAY_SWAP_XY);
esp_lcd_panel_mirror(panel, DISPLAY_MIRROR_X, DISPLAY_MIRROR_Y);
display_ = new SpiLcdDisplay(panel_io, panel, DISPLAY_WIDTH, DISPLAY_HEIGHT,
DISPLAY_OFFSET_X, DISPLAY_OFFSET_Y, DISPLAY_MIRROR_X,
DISPLAY_MIRROR_Y, DISPLAY_SWAP_XY);
}
void InitializeButtons() {
boot_button_.OnClick([this]() {
auto& app = Application::GetInstance();
if (GetNetworkType() == NetworkType::WIFI) {
if (app.GetDeviceState() == kDeviceStateStarting ||
app.GetDeviceState() == kDeviceStateWifiConfiguring) {
// cast to WifiBoard
auto& wifi_board = static_cast<WifiBoard&>(GetCurrentBoard());
wifi_board.EnterWifiConfigMode();
}
}
app.ToggleChatState();
});
boot_button_.OnLongPress([this]() {
auto& app = Application::GetInstance();
if (app.GetDeviceState() == kDeviceStateStarting ||
app.GetDeviceState() == kDeviceStateWifiConfiguring) {
SwitchNetworkType();
}
});
#if CONFIG_USE_DEVICE_AEC
boot_button_.OnDoubleClick([this]() {
auto& app = Application::GetInstance();
if (app.GetDeviceState() == kDeviceStateIdle) {
app.SetAecMode(app.GetAecMode() == kAecOff ? kAecOnDeviceSide : kAecOff);
}
});
#endif
volume_up_button_.OnClick([this]() {
auto codec = GetAudioCodec();
auto volume = codec->output_volume() + 10;
if (volume > 100) {
volume = 100;
}
codec->SetOutputVolume(volume);
GetDisplay()->ShowNotification(Lang::Strings::VOLUME + std::to_string(volume));
});
volume_up_button_.OnLongPress([this]() {
GetAudioCodec()->SetOutputVolume(100);
GetDisplay()->ShowNotification(Lang::Strings::MAX_VOLUME);
});
volume_down_button_.OnClick([this]() {
auto codec = GetAudioCodec();
auto volume = codec->output_volume() - 10;
if (volume < 0) {
volume = 0;
}
codec->SetOutputVolume(volume);
GetDisplay()->ShowNotification(Lang::Strings::VOLUME + std::to_string(volume));
});
volume_down_button_.OnLongPress([this]() {
GetAudioCodec()->SetOutputVolume(0);
GetDisplay()->ShowNotification(Lang::Strings::MUTED);
});
}
// 物联网初始化,添加对 AI 可见设备
void InitializeTools() {}
public:
AIVOX3()
: DualNetworkBoard(ML307_TX_PIN, ML307_RX_PIN, GPIO_NUM_NC, DEFAULT_4G_NETWORK),
boot_button_(BOOT_BUTTON_GPIO),
volume_up_button_(VOLUME_UP_BUTTON_GPIO),
volume_down_button_(VOLUME_DOWN_BUTTON_GPIO) {
InitializeI2c();
InitializeSpi();
InitializeLcdDisplay();
InitializePowerManager();
InitializeButtons();
InitializeTools();
GetBacklight()->RestoreBrightness();
}
virtual Led* GetLed() override {
static SingleLed led(BUILTIN_LED_GPIO);
return &led;
}
virtual AudioCodec* GetAudioCodec() override {
static AIVOX3AudioCodec audio_codec(
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_ES8311_ADDR, AUDIO_INPUT_REFERENCE);
return &audio_codec;
}
virtual Display* GetDisplay() override { return display_; }
virtual Backlight* GetBacklight() override {
static PwmBacklight backlight(DISPLAY_BACKLIGHT_PIN, DISPLAY_BACKLIGHT_OUTPUT_INVERT);
return &backlight;
}
virtual bool GetBatteryLevel(int& level, bool& charging, bool& discharging) override {
charging = power_manager_->IsCharging();
discharging = power_manager_->IsDischarging();
level = power_manager_->GetBatteryLevel();
return true;
}
};
DECLARE_BOARD(AIVOX3);

View File

@ -0,0 +1,54 @@
#pragma once
#include <driver/gpio.h>
#define DEFAULT_4G_NETWORK 0
#if CONFIG_USE_DEVICE_AEC
#define AUDIO_INPUT_REFERENCE true
#else
#define AUDIO_INPUT_REFERENCE false
#endif
#define AUDIO_INPUT_SAMPLE_RATE 24000
#define AUDIO_OUTPUT_SAMPLE_RATE 24000
#define AUDIO_I2S_GPIO_MCLK GPIO_NUM_11
#define AUDIO_I2S_GPIO_BCLK GPIO_NUM_10
#define AUDIO_I2S_GPIO_WS GPIO_NUM_8
#define AUDIO_I2S_GPIO_DOUT GPIO_NUM_7
#define AUDIO_I2S_GPIO_DIN GPIO_NUM_9
#define AUDIO_CODEC_PA_PIN GPIO_NUM_NC
#define AUDIO_CODEC_I2C_SDA_PIN GPIO_NUM_13
#define AUDIO_CODEC_I2C_SCL_PIN GPIO_NUM_12
#define AUDIO_CODEC_ES8311_ADDR ES8311_CODEC_DEFAULT_ADDR
#define BUILTIN_LED_GPIO GPIO_NUM_41
#define BOOT_BUTTON_GPIO GPIO_NUM_0
#define VOLUME_UP_BUTTON_GPIO GPIO_NUM_46
#define VOLUME_DOWN_BUTTON_GPIO GPIO_NUM_45
#define DISPLAY_BACKLIGHT_PIN GPIO_NUM_16
#define DISPLAY_MOSI_PIN GPIO_NUM_21
#define DISPLAY_CLK_PIN GPIO_NUM_17
#define DISPLAY_DC_PIN GPIO_NUM_14
#define DISPLAY_RST_PIN GPIO_NUM_NC
#define DISPLAY_CS_PIN GPIO_NUM_15
#define DISPLAY_WIDTH 240
#define DISPLAY_HEIGHT 240
#define DISPLAY_MIRROR_X false
#define DISPLAY_MIRROR_Y false
#define DISPLAY_SWAP_XY false
#define DISPLAY_INVERT_COLOR true
#define DISPLAY_RGB_ORDER LCD_RGB_ELEMENT_ORDER_RGB
#define DISPLAY_OFFSET_X 0
#define DISPLAY_OFFSET_Y 0
#define DISPLAY_BACKLIGHT_OUTPUT_INVERT false
#define DISPLAY_SPI_MODE 0
#define BATTERY_LEVEL_PIN GPIO_NUM_18
#define BATTERY_CHARGING_PIN GPIO_NUM_47
#define ML307_TX_PIN GPIO_NUM_44
#define ML307_RX_PIN GPIO_NUM_43

View File

@ -0,0 +1,9 @@
{
"target": "esp32s3",
"builds": [
{
"name": "nulllab-ai-vox-v3",
"sdkconfig_append": ["CONFIG_ESP_CONSOLE_NONE=y"]
}
]
}

View File

@ -0,0 +1,150 @@
#pragma once
#include <driver/gpio.h>
#include <esp_adc/adc_oneshot.h>
#include <esp_log.h>
#include <esp_timer.h>
class PowerManager {
private:
static constexpr uint32_t BATTERY_LEVEL_MIN = 2048;
static constexpr uint32_t BATTERY_LEVEL_MAX = 2330;
static constexpr size_t ADC_VALUES_COUNT = 10;
static constexpr size_t CHARGING_COUNT = 5;
esp_timer_handle_t timer_handle_ = nullptr;
gpio_num_t adc_pin_ = GPIO_NUM_NC;
uint16_t adc_values_[ADC_VALUES_COUNT];
size_t adc_values_index_ = 0;
size_t adc_values_count_ = 0;
uint8_t battery_level_ = 100;
gpio_num_t charging_pin_ = GPIO_NUM_NC;
bool is_charging_ = false;
int unchanging_count = 0;
adc_oneshot_unit_handle_t adc_handle_;
adc_channel_t adc_channel_;
void CheckBatteryStatus() {
if (charging_pin_ != GPIO_NUM_NC) {
bool new_charging_status = gpio_get_level(charging_pin_) == 1;
if (new_charging_status) {
unchanging_count = 0;
} else {
unchanging_count++;
if (is_charging_ && unchanging_count < 5) {
new_charging_status = true;
}
}
is_charging_ = new_charging_status;
}
ReadBatteryAdcData();
}
void ReadBatteryAdcData() {
int adc_value;
ESP_ERROR_CHECK(adc_oneshot_read(adc_handle_, adc_channel_, &adc_value));
adc_values_[adc_values_index_] = adc_value;
adc_values_index_ = (adc_values_index_ + 1) % ADC_VALUES_COUNT;
if (adc_values_count_ < ADC_VALUES_COUNT) {
adc_values_count_++;
}
uint32_t average_adc = 0;
for (size_t i = 0; i < adc_values_count_; i++) {
average_adc += adc_values_[i];
}
average_adc /= adc_values_count_;
CalculateBatteryLevel(average_adc);
ESP_LOGI("PowerManager", "ADC值: %d 平均值: %ld 电量: %u%%", adc_value, average_adc,
battery_level_);
}
void CalculateBatteryLevel(uint32_t average_adc) {
if (average_adc <= BATTERY_LEVEL_MIN) {
battery_level_ = 0;
} else if (average_adc >= BATTERY_LEVEL_MAX) {
battery_level_ = 100;
} else {
float ratio = static_cast<float>(average_adc - BATTERY_LEVEL_MIN) /
(BATTERY_LEVEL_MAX - BATTERY_LEVEL_MIN);
battery_level_ = ratio * 100;
}
}
public:
PowerManager(gpio_num_t adc_pin_, gpio_num_t charging_pin)
: adc_pin_(adc_pin_), charging_pin_(charging_pin) {
// 初始化充电引脚
if (charging_pin_ != GPIO_NUM_NC) {
gpio_config_t io_conf = {};
io_conf.intr_type = GPIO_INTR_DISABLE;
io_conf.mode = GPIO_MODE_INPUT;
io_conf.pin_bit_mask = (1ULL << charging_pin_);
io_conf.pull_down_en = GPIO_PULLDOWN_DISABLE;
io_conf.pull_up_en = GPIO_PULLUP_DISABLE;
gpio_config(&io_conf);
}
esp_timer_create_args_t timer_args = {
.callback =
[](void* arg) {
PowerManager* self = static_cast<PowerManager*>(arg);
self->CheckBatteryStatus();
},
.arg = this,
.dispatch_method = ESP_TIMER_TASK,
.name = "battery_check_timer",
.skip_unhandled_events = true,
};
ESP_ERROR_CHECK(esp_timer_create(&timer_args, &timer_handle_));
ESP_ERROR_CHECK(esp_timer_start_periodic(timer_handle_, 1000000)); // 1秒
InitializeAdc();
}
void InitializeAdc() {
adc_unit_t adc_unit;
ESP_ERROR_CHECK(adc_oneshot_io_to_channel(adc_pin_, &adc_unit, &adc_channel_));
adc_oneshot_unit_init_cfg_t init_config = {
.unit_id = adc_unit,
.ulp_mode = ADC_ULP_MODE_DISABLE,
};
ESP_ERROR_CHECK(adc_oneshot_new_unit(&init_config, &adc_handle_));
adc_oneshot_chan_cfg_t chan_config = {
.atten = ADC_ATTEN_DB_12,
.bitwidth = ADC_BITWIDTH_12,
};
ESP_ERROR_CHECK(adc_oneshot_config_channel(adc_handle_, adc_channel_, &chan_config));
}
~PowerManager() {
if (timer_handle_) {
esp_timer_stop(timer_handle_);
esp_timer_delete(timer_handle_);
}
if (adc_handle_) {
adc_oneshot_del_unit(adc_handle_);
}
}
bool IsCharging() {
// 如果电量已经满了,则不再显示充电中
if (battery_level_ == 100) {
return false;
}
return is_charging_;
}
bool IsDischarging() {
// 没有区分充电和放电,所以直接返回相反状态
return !is_charging_;
}
uint8_t GetBatteryLevel() { return battery_level_; }
};