头部屏幕说明
ELF3 头部显示屏用于显示机器人基础状态信息，可以做一些可爱的表情让机器人显的更活泼，二次开发时，该屏幕支持蓝牙和WIFI通信，可以无线传输数据，同时也支持触摸交互。
功能概览
头部显示屏可用于：
- 机器人表情：做一些可爱的表情让机器人显的更活泼。
- 数据显示：支持蓝牙和WIFI通信，可以无线传输数据。
- 触摸交互：屏幕支持触摸，可编写交互程序。
硬件平台
头部显示屏基于 Waveshare ESP32-S3-Touch-LCD-2.1 触摸屏开发板，适合作为机器人状态显示和简单交互界面。
| 项目 | 说明 |
|---|---|
| 主控 | ESP32-S3R8，Xtensa 32 位 LX7 双核处理器，最高 240MHz |
| 屏幕 | 2.1 英寸触摸屏，480 × 480 分辨率，262K 色 |
| 存储 | 16MB Flash，8MB PSRAM |
| 无线连接 | 2.4GHz Wi-Fi，Bluetooth 5 (BLE) |
| 常用接口 | USB Type-C、UART、I2C、Micro SD 卡座 |
| 板载资源 | QMI8658 六轴传感器、RTC等 |
接口注意
进行硬件调试时，请先参考 Waveshare 官方手册确认接口使用限制，避免错误编写程序导致屏幕程序卡死，如果卡死无法烧录程序，可以参考官方手册里的步骤重新烧录固件
屏幕使用
在实机上，头部显示屏通过 USB 线 与机器人主控连接。该 USB 连接可用于屏幕程序烧录、调试
基本使用流程如下：
- 确认机器人整机电池电源已打开。
- 检查头部显示屏与机器人主控之间的 USB 连接是否可靠。
- 显示屏点亮就没问题
通信方式
当前实机默认采用 USB 有线连接，适合烧录、调试。屏幕硬件本身也支持 Bluetooth 5 (BLE) 和 2.4GHz Wi-Fi，但无线通信链路、通信协议和主控侧数据发送程序需要根据项目需求自行开发。
| 通信方式 | 当前用途 | 说明 |
|---|---|---|
| USB | 烧录、调试、主控连接 | 推荐作为默认开发和调试方式 |
| Bluetooth 5 (BLE) | 可扩展无线通信 | 需自行开发配对、数据协议和显示逻辑 |
| 2.4GHz Wi-Fi | 可扩展无线通信 | 需自行开发网络连接、数据协议和异常恢复逻辑 |
二次开发指南
头部显示屏程序维护在 https://github.com/Luckyt1/bxi_show 仓库中。需要修改显示内容、页面布局、背光策略、通信方式或重新烧录固件时，建议按以下顺序处理：
- 阅读
bxi_show仓库中的构建、烧录和依赖说明。 - 根据项目实际使用的开发框架，参考 Waveshare 的 Arduino 或 ESP-IDF 开发文档配置环境。
- 使用 USB 连接屏幕与开发主机，完成编译、烧录和串口调试。
- 烧录完成后，先在机器人静止状态下检查数据刷新是否正常，再进入运动调试流程。
常见可开发内容包括： - 有LVGL图形库，可以编写表情动作 - 调整电压、电量、温度等字段的显示布局。 - 增加机器人状态、网络状态或调试状态提示。 - 修改屏幕亮度、息屏时间和唤醒逻辑。 - 扩展BLE 或 Wi-Fi 数据通信。 - 增加异常状态的颜色、图标或文字提醒。
调试检查项
| 现象 | 可能原因 | 处理建议 |
|---|---|---|
| 屏幕不亮 | 整机电源未打开、屏幕未供电、USB 连接松动或固件未运行 | 检查电池电源、屏幕供电和 USB 线缆，必要时重启设备 |
| 屏幕亮起但数据不更新 | 主控侧数据未发送、通信异常或显示程序异常 | 检查 主控侧程序状态，必要时重启屏幕 |
| 烧录失败 | USB 线异常、端口占用、驱动或下载模式异常 | 更换 USB 线或端口，关闭占用串口的程序，并按仓库说明重新进入烧录流程 |