') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); })(); GitHub - unDefFtr/QuoteImage: Offline image display for Quote/0 · GitHub
Skip to content
BranchesTags

Repository files navigation

QuoteImage

QuoteImage 用手机把普通图片处理成黑白电子纸画面，并通过 Bluetooth Low Energy（BLE）发送到 MindReset Quote/0。项目包含 Android/iOS Flutter 应用、 ESP32-C3 ESP-IDF/FreeRTOS 固件、UC8251D 显示驱动和一套带认证、校验及进度反馈的 BLE 应用协议。

文档入口

文档适合谁内容
用户指南QuoteImage 使用者首次配对、图片处理、发送、设备管理、故障排查
开发者指南开发、测试和维护人员项目结构、架构、环境、开发流程、测试、部署和发布
BLE 协议规范客户端/固件开发者GATT、配对认证、帧传输和状态码的字节级约定
移动端说明Flutter 开发者移动端常用命令与实现摘要
固件说明固件开发者ESP-IDF 构建、引脚、部署、迁移和配对恢复

系统概览

手机图片
-> 解码与 EXIF 方向校正
-> 旋转、缩放/裁切、灰度与抖动
-> 152 x 296、1 bit、5624 字节帧
-> BLE 认证、分块传输与 CRC32 校验
-> Quote/0 刷新电子纸并进入深度睡眠

图片处理全部在手机后台 isolate 中完成，微控制器只接收最终帧。预览图和发送帧 由同一个像素循环生成；可配置的电量覆盖层由固件在右上角合成，并由应用另行预览。

快速开始

开发环境需要 Flutter 3.41 或更高版本、Python 3、CMake/Ninja，以及已经安装并 激活的 ESP-IDF 5.5.x。连接真机后运行：

make bootstrap
make check
make mobile-run

向 Quote/0 构建并部署 ESP-IDF 固件：

make device-install PORT=/dev/cu.usbmodemXXXX

从旧 MicroPython 固件首次迁移需改用 make device-migrate PORT=...，该操作会整片 擦除并要求重新配对；后续 device-install 会保留 NVS 中的名称和凭证。完整环境准备、 真机运行和恢复流程见开发者指南。

硬件与传输规格

  • 主控：ESP32-C3
  • 屏幕：UC8251D，152 x 296 单色电子纸
  • 帧格式：逐行、MSB-first，0 为黑、1 为白，共 5624 字节
  • 连接：BLE，自定义 GATT 服务，标准 Battery Service
  • 完整性：协议版本、帧长度、连续偏移和 CRC32 均在刷新前校验
  • 持久化：设备保存名称、一个授权凭证和右上角小块显示快照；完整图片仅保存在 RAM

一键检查

make check

该命令会运行 C 宿主机测试、ESP-IDF 完整构建、legacy MicroPython 测试，以及 Flutter 静态分析和测试。它不覆盖真实射频环境、硬件引脚、屏幕 BUSY 时序和电子纸 波形，这些仍需在 Quote/0 真机上验证。

About

Offline image display for Quote/0

Resources

Readme
Activity

Stars

4 stars

Watchers

0 watching

Forks

3 forks
Report repository

Releases

Packages

Contributors

Languages