AgentRing 生态 · 专属嵌入式硬件副屏 · README 声明 Apache 2.0

AgentRing ESP32 LCD

桌角常显的 AI 额度硬件仪表 · ESP32-P4 · LVGL 9

基于微雪 7" 1024×600 IPS 全贴合液晶屏，通过低功耗蓝牙 (BLE) 或 USB-C 串口与 Mac 本地直连。将 Apple Watch 质感的同心圆环物理实体化，零云端中转，板端不存 Token。

微雪 7" IPS 1024×600 全贴合液晶屏 · LVGL 9 双缓冲直接驱动

DEMO 界面规格模拟 · 严格 1:1 像素复刻

Interactive Preview

动态交互与控制模拟

在网页端体验固件逻辑：调节硬件 PWM 背光亮度、查看各家 Provider 同心圆环排版，以及用量告急着色机制。（注：本模块为网页端模拟演示数据）

副屏控制中枢与 Providers 演示

模拟触控顶部状态栏呼出的控制中心面板与 NVS 存储档位

硬件 LEDC 调光模拟 (10% ~ 100%) 100%

切换查看 Provider 状态单环 / 双环

告急分级着色测试正常 (>20%)

Codex 单环 7 天

7天总额度 95% 3d 12h

• 动态线宽：线宽按外径 12% 计算，呼吸间隙 4.5%（四列布局时线宽约 18px，三列约 21px，双列约 24px）。

• 中心通透留白：坚决不在圆环中央堆叠百分比大字，保证视觉纯净无干扰。

• 三通道扁平告急行：左侧标签、中间加粗数值（动态告急变色）、右侧重置倒计时。

• 硬件 RTC 自动校时：每次 Mac 端推送时无感校正系统时钟，顶部状态栏精准走时。

Hardware & Firmware

免整机操作系统开销，通电即加载固件。双核 RISC-V @ 400MHz 与 MIPI DSI 控制器协同工作，配合 1024×600 分辨率下的双缓冲直接驱动，有效减少画面撕裂。

ESP32-P4 RISC-V SoC 双核 RISC-V @ 400MHz，配备 32MB 片外 PSRAM，专为嵌入式大屏 GUI 与快速 JSON 解析设计。

MIPI DSI 双缓冲直驱 采用 EK79007 MIPI 控制器与 LVGL 9 双缓冲直接模式 (Double-Direct)，有效减少屏幕撕裂与频闪。

LEDC PWM 硬件调光 点击顶栏呼出浮动控制面板，10%~100% 连续触控调光与 4 档快捷预设，由 NVS 非易失掉电记忆。

Privacy & Connection

板端不连外网 Wi-Fi，不存储任何平台 API Token。所有额度计算由 Mac 端 AgentRing 本地完成，经低功耗蓝牙 (BLE) 或 USB-C 串口点对点直连推流。

Open Source Guide

项目基于 ESP-IDF v5.5 构建，README 声明基于 Apache 2.0 协议开源。遵循标准工作流即可在本地完成编译与烧录。

获取微雪 Waveshare ESP32-P4-WIFI6-Touch-LCD-7B 官方开发板套件（自带 7 英寸 1024×600 IPS 电容屏与 Type-C 数据线）。

从 GitHub 克隆固件工程，并进入工程目录：

git clone https://github.com/haorui-lab/agentRing-ESP32-LCD.git

使用 ESP-IDF v5.5 工具链，单行命令完成目标构建并烧录：

idf.py set-target esp32p4 && idf.py build flash monitor

在 Mac 上运行 AgentRing 状态栏应用，应用将自动通过 CoreBluetooth 扫描并由应用后台发现并建立连接（蓝牙名 AgentRing-LCD-XXXX），即刻开始推流。