Light Console——基于 RK3588 与 ESP32-S3 的智能灯控交互终端产品系统Vibe Coding

面向虚拟拍摄、影视灯光及舞台控制等需要实体交互的场景，开发集硬件输入、状态显示与设备控制于一体的专用终端。针对普通鼠标键盘操作不够直观、实体控制器与软件界面割裂、设备故障难以定位等问题，将按键、旋钮、轨迹球和外圈编码器接入统一控制平台，通过触摸屏实时呈现设备状态，并提供灯光指示、风扇和网络配置功能，为后续接入 UE5 场景控制提供基础。

项目包括硬件输入采集、实时诊断、输出控制、网络配置和系统部署五个模块。支持26路按键、3个旋钮、双光学传感器轨迹球及外圈编码器的输入展示，显示按键状态、运动累计量、输入频率、通信错误和设备连接情况；支持23路按键指示灯独立开关与四档统一亮度调节，并提供风扇自动／手动控制。界面可查看电池电压、温湿度、传感器质量和设备日志，支持双无线网卡的 Wi-Fi 扫描与连接管理。系统上电后自动进入全屏应用，具备启动 Logo、静默启动、程序异常恢复及完整镜像部署能力，同时提供 UE5 通信接口和模拟联调工具。

项目采用“ESP32-S3 硬件采集、RK3588 控制服务、Web 交互界面”的分层架构。ESP32-S3 使用 C 实现输入采集，通过 USB CDC 传输二进制数据；RK3588 运行 Ubuntu，使用 Rust、Tokio 和 Axum 实现异步通信、协议解析、状态管理及 HTTP／WebSocket 服务；前端使用 TypeScript 和 Vite 构建触摸交互界面。实现重点包括约500Hz输入数据的累计与界面聚合更新、COBS分帧与CRC校验、命令确认及状态读回、断线恢复和旧固件兼容。针对嵌入式部署，完成 HDMI 启动日志隐藏、Logo 旋转与交接、应用启动白屏修复，以及 systemd 自启和镜像封装。