# StickyNote-ESP32S3 **Repository Path**: ytfdhb/StickyNote-ESP32S3 ## Basic Information - **Project Name**: StickyNote-ESP32S3 - **Description**: ESP32-S3 Camera, Preview & BLE Image Transfer | ESP32-S3 拍照、预览与 BLE 图片传输 - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: codex/open-source-preview - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 1 - **Created**: 2026-11-20 - **Last Updated**: 2026-11-20 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # StickyNote ESP32-S3 [English documentation](README.md) ![StickyNote 硬件与电子纸](docs/images/device-overview.jpg) StickyNote 是一个基于 ESP-IDF 的固件原型,面向 Seeed Studio XIAO ESP32S3 Sense。它拍摄图像,在 ST7735 小屏上预览,生成 XTE/XTEK 图像产物,并通过 BLE 发送到兼容的电子纸设备。本项目是 C/ESP-IDF 工程,不是 Arduino `.ino` 草图。 开源预览版包含源代码、公开测试和独立的公开图像后端,不包含闭源算法、二进制库、 ABI 头文件、manifest、hash 或预编译固件。设备码 152 和 165 共用并启用 `e6-480x720-badge-xte` 六色工牌画像:480×720 竖屏、270 度线方向旋转、 `STANDARD_E6` 布局、primary RGB 色板和仓库内独立实现的标准 Atkinson 算法。 680×960 六色相框仍是独立的四分区布局,并使用校准过的公开 Floyd-Steinberg 路径。 ## 硬件 参考组合包括 XIAO ESP32S3 Sense(8 MB Flash、8 MB PSRAM)、OV2640 摄像头、 1.44 英寸 128×128 ST7735 SPI TFT、快门/确认取消按键,以及匹配 XTE/XTEK 画像的 BLE 电子纸相框或工牌。参见[硬件说明](docs/hardware.md)、 [支持设备](docs/supported-devices.md)和[接线指南](docs/hardware/xiao-esp32s3-sense-st7735-wiring.md)。 `docs/images` 中的照片来自此前私有原型;再分发权仍需确认,照片不是硬件验收证据。 ## 流程 1. 启动实时取景; 2. 拍摄并查看画面; 3. 确认图像,扫描目标广播,绑定已核对的业务身份和设备码; 4. 生成图像产物并通过 BLE 传输; 5. 等待目标设备校验并刷新电子纸。 [流程说明](docs/workflow.md)将每阶段对应到固件组件,并说明主机测试、串口日志和 实体照片分别能证明什么。 ## 构建与测试 激活 ESP-IDF 6.0.1 后在仓库根目录执行: ```powershell idf.py -C firmware -B .debug-runs\idf601-product set-target esp32s3 idf.py -C firmware -B .debug-runs\idf601-product build idf.py -C firmware -B .debug-runs\idf601-product -p COMx flash monitor python -m unittest discover -s tests -q ``` 将 `COMx` 换成实际串口,并将生成物放在 `.debug-runs`。构建成功只证明编译和链接, 不能证明相机、BLE 传输或电子纸实体刷新;详见[构建和烧录](docs/release/build-and-flash.md)。 ## 图像后端 `firmware/components/epd_quantizer` 提供统一的画像驱动量化接口:快速最近色路径、 仓库内独立的定点 Floyd-Steinberg、仓库内独立的标准 Atkinson(完整误差按 1/8 分给 六个邻点),以及 Atkinson 工牌路径的黑/白/黄/红/蓝/绿 primary RGB 色板。校准 E6 色板和四分区变换只用于独立的 680×960 相框画像。两种算法都有主机/Unity 固定向量、 reader error、workspace、yield、packing、RLE 和 XTEK 覆盖;参见[算法后端](docs/algorithm-backends.md) 和[抖动架构](docs/architecture/dithering.md)。 ## 仓库结构 ```text firmware/ ESP-IDF 产品、验证和 Unity 工程 tests/ Python 主机测试和公开协议参考 tools/ 主机产物与图像参考工具 docs/ 硬件、流程、协议、架构和发布说明 ``` ## 许可证与证据边界 原创源代码和文档以 [Apache License 2.0](LICENSE) 提供,署名见 [NOTICE](NOTICE)。 第三方组件保留各自许可证,详见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。 媒体权利独立于源码许可证。发布前请审查硬件、电气、无线电、隐私和许可证边界;没有 相机/显示证据时,不能把构建或串口协议结果称为实体刷新通过。