HinarUI / OLED UI DESIGN

HinarUI v4

Original OLED UI Design based on Embedded Platform, with complete software, hardware and shell design.
基于嵌入式平台的原创 OLED UI 设计，包含软硬件与外壳方案

Github: https://github.com/890mn/HinarUI
Bilibili: https://www.bilibili.com/video/BV1kB2eB7Eua/

软件部分 / Project Structure

HinarUI
├─ example/              # PlatformIO demo (esp-wrover-kit by default)
│  ├─ include/
│  ├─ lib/HinarUI/       # Linked library for the demo
│  └─ src/
├─ include/              
│  ├─ boards/            # Board-level pin/I2C config
│  │  └─ esp_wrover_kit.h
│  ├─ fonts/             # Built-in fonts + optional.md for custom fonts
│  ├─ HinarUI/           # Core headers
│  └─ modules/
└─ src/                  # Library sources (core + modules)
   ├─ boards/
   ├─ core/
   └─ modules/

架构与性能

引入帧缓管理：新增 FrameBufferManager，在 ESP32 上使用队列与双缓冲（PSRAM 可选）分离渲染与推屏，支持目标帧率限速
显示管线优化：HinarUIDisplay 支持 PSRAM 双缓冲、区域刷新，I2C 速率提升，推屏效率提升

低功耗与静态页

OFF 键行为重定义：仅在 Module 状态进入静态睡眠页（显示电量/充电状态/SHT30 温湿度、波浪电量条）
睡眠页定期刷新，充电检测 ADC 阈值，CHARGING 状态圆点实时反映

性能监控与帧率

perf 模块分离为后台任务，FPS/覆盖率显示在开发者模式顶栏
计时基于显示推屏帧，避免主循环阻塞影响统计

配置与模块

Menu 配置/动画：flow speed、stepCount 解耦
模块调优：新增充电检测阈值、SHT30 滤波接口 Sht30Status，电池接口 BatteryStatus
新增板级引脚定义 CHARGE_SENSE_PIN，用于 USB 供电检测

UI 与视觉

静态睡眠页电量条改为单段高亮波浪效果，状态/温湿度行布局优化
顶栏/页面文案调整

Usage

About how to adapt this project on your board, here gives some tips:

Quick start as a library:

#include 
#include "HinarUI_Core.h"

void setup() {
    menu.create();
}

void loop() {
    menu.loop();
}

Board / pin adaptation:

Edit include/boards/esp_wrover_kit.h for pins and I2C addresses:

static constexpr int I2C_SDA = 21;
static constexpr int I2C_SCL = 22;
static constexpr uint8_t OLED_ADDR = 0x3C;
static constexpr int KEY_ENTER = 32;
static constexpr int KEY_BACK  = 35;
// ... KEY_OFF/KEY_CYCLE/VBAT/CHARGE_SENSE etc.
// SHT30_ADDR, OLED_ADDR 可按需要改为 0x3D/0x45