ESP-HaloPanel 是一款基于 ESP32-C2 开发的超低成本智能家居面板，面板中央配备一个圆形屏幕用于显示信息，屏幕周围均匀分布了 6 个触摸按键，用于控制操作。

本文链接：https://blog.youkuaiyun.com/lianmengde/article/details/145359923

ESP-HaloPanel 嵌入式系统代码设计架构与C代码实现方案

我将为 ESP-HaloPanel 项目设计一个可靠、高效且可扩展的嵌入式系统平台。这个方案将涵盖从需求分析到系统实现，再到测试验证和维护升级的完整流程，并提供详细的代码设计架构和具体的C代码实现，确保项目采用的技术和方法都经过实践验证。
关注微信公众号，提前获取相关推文
在这里插入图片描述

1. 需求分析与系统设计

1.1 需求分析

ESP-HaloPanel 的核心需求可以归纳为：

低成本: 基于 ESP32-C2 芯片，强调成本效益。
智能家居面板: 作为智能家居系统的控制中心，具备信息显示和交互功能。
圆形屏幕显示: 中央圆形屏幕用于显示关键信息，例如时间、温湿度、设备状态、自定义图标等。
触摸按键控制: 6 个触摸按键用于用户交互，实现对智能家居设备的控制和面板操作。
Wi-Fi 连接: 支持 Wi-Fi 网络连接，实现与智能家居网关、云平台或其他设备的通信。
Home Assistant 集成 (可选): 具备与 Home Assistant 等主流智能家居平台的集成能力，方便用户接入现有生态。
低功耗: 作为常驻设备，需要考虑功耗优化，尤其是在电池供电场景下（虽然图片中未明确提及电池供电，但低功耗是智能家居设备的普遍需求）。
OTA 升级: 支持空中升级 (OTA)，方便后续功能更新和 bug 修复。
稳定可靠: 系统需要稳定运行，避免崩溃或死机，确保用户体验。
易于维护和扩展: 代码架构需要清晰模块化，方便后续维护和功能扩展。

1.2 系统设计原则

基于以上需求，我们遵循以下系统设计原则：

分层架构: 采用分层架构，将系统划分为不同的功能层，降低耦合度，提高可维护性和可扩展性。
模块化设计: 将每个功能层进一步细分为模块，每个模块负责特定的任务，提高代码复用率和可测试性。
事件驱动: 系统采用事件驱动架构，对触摸事件、定时器事件、网络事件等进行响应，提高系统响应速度和资源利用率。
异步处理: 对于耗时操作 (例如网络请求、显示刷新)，采用异步处理，避免阻塞主线程，提高系统流畅性。
资源优化: 充分考虑 ESP32-C2 的资源限制，优化内存使用和 CPU 占用，确保系统高效运行。
错误处理: 建立完善的错误处理机制，包括错误检测、错误日志、错误恢复等，提高系统鲁棒性。
可移植性: 代码设计尽量考虑可移植性，方便未来迁移到其他平台或芯片。

1.3 系统架构设计

我们为 ESP-HaloPanel 设计一个典型的三层嵌入式系统架构：

+-----------------------+
|     应用层 (Application Layer)     |  (智能家居面板应用逻辑，用户界面，业务逻辑)
+-----------------------+
         |
         |  应用接口 (Application Interface - API)
         V
+-----------------------+
|     中间件层 (Middleware Layer)    |  (系统服务，驱动抽象，通用功能组件)
+-----------------------+
         |
         |  硬件抽象层接口 (Hardware Abstraction Layer Interface - HAL Interface)
         V
+-----------------------+
|     硬件层 (Hardware Layer)       |  (ESP32-C2 硬件驱动，底层操作)
+-----------------------+

各层功能详细说明:

硬件层 (Hardware Layer):
- ESP32-C2 芯片驱动: 直接与 ESP32-C2 硬件交互，包括 GPIO 控制、SPI 通信 (屏幕驱动)、I2C 通信 (触摸芯片驱动或其他外设)、定时器、中断管理、Wi-Fi 驱动等。
- 硬件初始化: 负责系统硬件的初始化配置，例如时钟配置、GPIO 初始化、外设初始化等。
- 底层驱动接口: 向上层提供统一的硬件操作接口 (HAL Interface)，例如 GPIO 读写接口、SPI 传输接口、I2C 传输接口等，隐藏底层硬件细节。
中间件层 (Middleware Layer):
- 硬件抽象层 (HAL): 对硬件层提供的底层驱动接口进行抽象封装，提供更高级、更易用的硬件操作接口，例如屏幕驱动 HAL (绘制点、线、图形、文本)、触摸驱动 HAL (触摸事件检测、触摸坐标获取)、Wi-Fi HAL (Wi-Fi 连接、数据传输)。
- 系统服务:
  - 任务调度器 (Task Scheduler/RTOS Abstraction): 管理系统中的任务，实现任务的创建、删除、调度和同步。根据项目复杂度，可以选择简单的合作式调度器或 FreeRTOS 等实时操作系统。
  - 定时器服务 (Timer Service): 提供定时器功能，用于周期性任务执行、延时操作等。
  - 事件管理服务 (Event Manager): 管理系统中的事件，实现事件的发布和订阅，用于模块间的异步通信。
  - 配置管理服务 (Configuration Manager): 负责系统配置信息的加载、保存和管理，例如 Wi-Fi 配置、设备名称、用户设置等。
  - 日志服务 (Log Service): 记录系统运行日志，方便调试和问题排查。
  - OTA 升级服务 (OTA Service): 实现空中升级功能，包括固件下载、固件校验、固件更新等。
- 通用组件:
  - UI 框架 (UI Framework): 提供 UI 组件库 (按钮、文本框、图标等)、UI 布局管理、UI 事件处理等功能，简化 UI 开发。
  - 触摸输入管理器 (Touch Input Manager): 处理触摸输入事件，包括触摸检测、触摸坐标解析、触摸手势识别 (例如点击、长按、滑动 - 本项目主要关注点击事件)。
  - 网络通信管理器 (Network Communication Manager): 封装网络协议 (例如 TCP/IP, MQTT, HTTP)，提供网络连接、数据发送和接收等功能，方便应用层进行网络通信。
  - 数据解析与序列化组件 (Data Parsing & Serialization): 处理数据格式转换 (例如 JSON, XML, Protobuf)，方便数据交换和存储。
应用层 (Application Layer):
- 智能家居面板应用: 实现 ESP-HaloPanel 的核心功能，包括：
  - UI 界面显示: 圆形屏幕显示时间、日期、温湿度、设备状态、自定义图标等信息。
  - 触摸按键交互: 响应触摸按键事件，控制智能家居设备 (例如灯光、开关、传感器数据显示)。
  - 网络通信: 与智能家居网关、云平台或其他设备进行数据交互，例如获取设备状态、发送控制指令。
  - 本地配置: 用户可以通过触摸按键进行本地配置，例如 Wi-Fi 配置、设备名称设置等。
  - Home Assistant 集成 (可选): 实现与 Home Assistant 的 MQTT 或 HTTP API 集成，将面板接入 Home Assistant 生态。

2. 代码设计架构详解

2.1 模块划分与接口设计

基于上述分层架构，我们进一步细化模块划分和接口设计，并使用伪代码或 UML 类图进行描述。

硬件层 (Hardware Layer)

hal_gpio.c/h: GPIO 驱动模块
- hal_gpio_init(gpio_pin_t pin, gpio_mode_t mode): 初始化 GPIO 引脚
- hal_gpio_set_level(gpio_pin_t pin, gpio_level_t level): 设置 GPIO 输出电平
- hal_gpio_get_level(gpio_pin_t pin): 读取 GPIO 输入电平
- hal_gpio_register_interrupt(gpio_pin_t pin, gpio_interrupt_mode_t mode, gpio_interrupt_callback_t callback, void *arg): 注册 GPIO 中断
- … (更多 GPIO 操作接口)
hal_spi.c/h: SPI 驱动模块 (用于屏幕)
- hal_spi_init(spi_config_t *config): 初始化 SPI 总线
- hal_spi_transfer(spi_device_t device, const uint8_t *tx_buf, uint8_t *rx_buf, size_t len): SPI 数据传输
- hal_spi_device_add(spi_config_t *device_config): 添加 SPI 设备
- … (更多 SPI 操作接口)
hal_i2c.c/h: I2C 驱动模块 (如果需要触摸芯片或其他 I2C 外设)
- … (类似 SPI 驱动，提供 I2C 初始化、传输接口)
hal_timer.c/h: 定时器驱动模块
- hal_timer_init(timer_config_t *config): 初始化定时器
- hal_timer_start(timer_id_t timer_id): 启动定时器
- hal_timer_stop(timer_id_t timer_id): 停止定时器
- hal_timer_register_callback(timer_id_t timer_id, timer_callback_t callback, void *arg): 注册定时器回调函数
- … (更多定时器操作接口)
hal_touch.c/h: 触摸驱动模块 (假设使用 I2C 触摸芯片)
- hal_touch_init(touch_config_t *config): 初始化触摸芯片
- hal_touch_get_event(touch_event_t *event): 获取触摸事件 (例如触摸按下、释放、坐标)
- … (更多触摸操作接口)
hal_display.c/h: 屏幕驱动模块 (针对圆形屏幕)
- hal_display_init(display_config_t *config): 初始化屏幕
- hal_display_draw_pixel(uint16_t x, uint16_t y, color_t color): 绘制像素点
- hal_display_draw_line(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2, color_t color): 绘制直线
- hal_display_draw_circle(uint16_t x, uint16_t y, uint16_t radius, color_t color): 绘制圆形
- hal_display_draw_text(uint16_t x, uint16_t y, const char *text, font_t *font, color_t color): 绘制文本
- hal_display_fill_rect(uint16_t x, uint16_t y, uint16_t width, uint16_t height, color_t color): 填充矩形
- hal_display_clear(color_t color): 清屏
- hal_display_flush(): 刷新显示
- … (更多显示操作接口，例如图片显示)
hal_wifi.c/h: Wi-Fi 驱动模块 (基于 ESP-IDF 或 lwIP)
- hal_wifi_init(wifi_config_t *config): 初始化 Wi-Fi
- hal_wifi_connect(const char *ssid, const char *password): 连接 Wi-Fi 网络
- hal_wifi_disconnect(): 断开 Wi-Fi 连接
- hal_wifi_get_ip_address(char *ip_address, size_t len): 获取 IP 地址
- hal_wifi_send_data(const uint8_t *data, size_t len): 发送 Wi-Fi 数据 (底层封装 TCP/UDP)
- hal_wifi_register_data_callback(wifi_data_callback_t callback, void *arg): 注册 Wi-Fi 数据接收回调函数
- … (更多 Wi-Fi 操作接口)

中间件层 (Middleware Layer)

osal_task.c/h: 任务调度器抽象层 (如果使用 RTOS，则封装 RTOS API)
- osal_task_create(task_func_t func, const char *name, uint32_t stack_size, void *param, task_priority_t priority, task_handle_t *handle): 创建任务
- osal_task_delete(task_handle_t handle): 删除任务
- osal_task_delay(uint32_t ms): 任务延时
- osal_mutex_create(mutex_handle_t *mutex): 创建互斥锁
- osal_mutex_lock(mutex_handle_t mutex): 获取互斥锁
- osal_mutex_unlock(mutex_handle_t mutex): 释放互斥锁
- osal_queue_create(queue_handle_t *queue, uint32_t item_size, uint32_t queue_len): 创建消息队列
- osal_queue_send(queue_handle_t queue, void *item, uint32_t timeout_ms): 发送消息到队列
- osal_queue_receive(queue_handle_t queue, void *item, uint32_t timeout_ms): 从队列接收消息
- … (更多 OS 抽象接口，例如信号量、事件组等，根据实际需求选择)
service_timer.c/h: 定时器服务
- timer_service_create_timer(uint32_t period_ms, timer_callback_t callback, void *arg): 创建定时器
- timer_service_start_timer(timer_id_t timer_id): 启动定时器
- timer_service_stop_timer(timer_id_t timer_id): 停止定时器
- timer_service_delete_timer(timer_id_t timer_id): 删除定时器
service_event.c/h: 事件管理服务
- event_service_register_event(event_id_t event_id): 注册事件
- event_service_subscribe_event(event_id_t event_id, event_callback_t callback, void *arg): 订阅事件
- event_service_publish_event(event_id_t event_id, void *data): 发布事件
service_config.c/h: 配置管理服务 (可以使用 NVS Flash 或 SPI Flash 存储配置)
- config_service_init(): 初始化配置服务
- config_service_load_config(): 加载配置信息
- config_service_save_config(): 保存配置信息
- config_service_get_string(const char *key, char *value, size_t len): 获取字符串配置项
- config_service_set_string(const char *key, const char *value): 设置字符串配置项
- config_service_get_int(const char *key, int32_t *value): 获取整数配置项
- config_service_set_int(const char *key, int32_t value): 设置整数配置项
- … (更多配置项操作接口)
service_log.c/h: 日志服务
- log_service_init(): 初始化日志服务
- log_service_debug(const char *tag, const char *format, ...): 打印调试日志
- log_service_info(const char *tag, const char *format, ...): 打印信息日志
- log_service_warn(const char *tag, const char *format, ...): 打印警告日志
- log_service_error(const char *tag, const char *format, ...): 打印错误日志
service_ota.c/h: OTA 升级服务 (可以使用 ESP-IDF OTA 组件或自定义实现)
- ota_service_init(): 初始化 OTA 服务
- ota_service_start_upgrade(const char *firmware_url): 启动 OTA 升级
- ota_service_get_upgrade_status(): 获取 OTA 升级状态
ui_framework.c/h: UI 框架 (简化 UI 开发，可以基于开源 GUI 库或者自定义实现)
- ui_init(): 初始化 UI 框架
- ui_create_window(window_id_t id, uint16_t width, uint16_t height): 创建窗口
- ui_create_label(window_id_t window_id, label_id_t id, uint16_t x, uint16_t y, const char *text, font_t *font, color_t color): 创建标签
- ui_create_button(window_id_t window_id, button_id_t id, uint16_t x, uint16_t y, uint16_t width, uint16_t height, const char *text, button_callback_t callback, void *arg): 创建按钮
- ui_set_label_text(label_id_t id, const char *text): 设置标签文本
- ui_set_button_text(button_id_t id, const char *text): 设置按钮文本
- ui_draw_window(window_id_t window_id): 绘制窗口
- … (更多 UI 组件和操作接口)
input_touch.c/h: 触摸输入管理器
- touch_input_init(): 初始化触摸输入管理器
- touch_input_process_event(touch_event_t *event): 处理触摸事件 (来自 hal_touch 驱动)
- touch_input_register_button_callback(uint8_t button_index, touch_button_callback_t callback, void *arg): 注册触摸按键回调函数
network_manager.c/h: 网络通信管理器 (可以使用 MQTT 或 HTTP 客户端库)
- network_init(): 初始化网络管理器
- network_connect_wifi(const char *ssid, const char *password): 连接 Wi-Fi
- network_subscribe_mqtt(const char *topic, mqtt_callback_t callback, void *arg): 订阅 MQTT 主题
- network_publish_mqtt(const char *topic, const char *payload): 发布 MQTT 消息