Skip to content

Releases: datascale-ai/inksight

InkSight v0.6.0

20 Jun 05:29
6e71de0

Choose a tag to compare

InkSight v0.6.0

Overview

v0.6.0 是一次固件与设备状态机制的同步升级。建议从 v0.5.x 升级的用户同时更新后端、Web 前端和设备固件,尤其是使用电池供电、始终活跃模式、深度睡眠唤醒、AI 语音对话、多 WiFi 配网的设备。

本版本继续覆盖 v0.5.0 已发布的固件矩阵,并新增:

  • ESP32-C3-WROOM32的集成版本固件:epd_42_zhongjingyuan_bw_gxepd2_gye042a87_smt_wroom32e.bin

Key Changes

  • AI 语音对话优化:移除短按单次对话入口,只保留长按进入对话;AI 播放时暂停处理麦克风输入,播放结束后清空 capture queue,减少 AI 听到自己声音后自问自答。支持在 AI 对话模式中再次长按语音按钮可退出对话。
  • SMT_WROOM32E 电压检测支持SMT_WROOM32E 使用 GPIO35 电池检测,并走 ADC 校准分支,和 WROOM02 类似按实测硬件分压还原真实电池电压。
  • 电量计算统一:设备端统一上报真实电池电压,后端 / 前端统一按锂电曲线计算百分比:4.20V = 100%3.70V = 50%3.00V = 0%
  • 深度睡眠正式启用:间隔刷新后设备会进入 deep sleep,支持定时唤醒与 PIN_CFG_BTN 按钮唤醒。
  • 始终活跃模式完善:Web 开启 always_active 后设备保持活跃;关闭后设备可同步切回 interval/deep sleep。
  • 多 WiFi 配网增强:设备最多保存 5 个 WiFi;开机按顺序尝试,全部失败后自动进入配网页。配网页“已保存网络”列表新增“连接”按钮,使用设备 NVS 内已保存密码连接,不需要再次输入密码。

Upgrade Notes

  • 建议所有 v0.5.x 用户升级到 v0.6.0 固件。旧固件仍可连接新服务端,但电量显示、活跃状态同步、深度睡眠唤醒等行为可能不完整。
  • 本版本改变了电量上报语义:固件应上报真实电池电压,百分比由后端 / 前端统一计算。
  • 已保存 WiFi 密码只保存在设备 NVS 中,不会返回给浏览器。若“连接已保存网络”失败,请重新输入密码并使用“连接并保存”更新该网络。

Firmware Matrix

4.2 寸主流矩阵

资产文件名 说明
epd_42_wsv2_ssd1683_c3_promini.bin 微雪 v2 4.2 寸, SSD1683 黑白面板, 2 色, ESP32-C3 ProMini
epd_42_wsv2_ssd1683_c3_std.bin 微雪 v2 4.2 寸, SSD1683 黑白面板, 2 色, ESP32-C3 标准板
epd_42_wsv2_ssd1683_wroom32e.bin 微雪 v2 4.2 寸, SSD1683 黑白面板, 2 色, ESP32-WROOM-32E
epd_42_zhongjingyuan_bw_gxepd2_gye042a87_c3_promini.bin 中景园 4.2 寸, GYE042A87 / SSD1683 黑白面板, 2 色, ESP32-C3 ProMini
epd_42_zhongjingyuan_bw_gxepd2_gye042a87_c3_std.bin 中景园 4.2 寸, GYE042A87 / SSD1683 黑白面板, 2 色, ESP32-C3 标准板
epd_42_zhongjingyuan_bw_gxepd2_gye042a87_wroom32e.bin 中景园 4.2 寸, GYE042A87 / SSD1683 黑白面板, 2 色, ESP32-WROOM-32E
epd_42_zhongjingyuan_bw_gxepd2_gye042a87_smt_wroom32e.bin 中景园 4.2 寸, GYE042A87 / SSD1683 黑白面板, 2 色, SMT ESP32-WROOM-32E
epd_42_gdem042f52_jd79668_c3_promini.bin 佳显 4.2 寸, GDEM042F52 / JD79668 四色, 4 色, ESP32-C3 ProMini
epd_42_gdem042f52_jd79668_c3_std.bin 佳显 4.2 寸, GDEM042F52 / JD79668 四色, 4 色, ESP32-C3 标准板
epd_42_gdem042f52_jd79668_wroom32e.bin 佳显 4.2 寸, GDEM042F52 / JD79668 四色, 4 色, ESP32-WROOM-32E
epd_42_depg0420ry683_ssd1683_c3_promini.bin 广义顺 4.2 寸, DEPG0420RY683 四色, 4 色, ESP32-C3 ProMini
epd_42_wroom32e_ai_chat.bin 微雪 v2 4.2 寸 + AI Chat 专用固件, ESP32-WROOM-32E
epd_42_wroom32e_vocab_review.bin 微雪 v2 4.2 寸 + 背单词模式固件, ESP32-WROOM-32E

2.9 寸

资产文件名 说明
epd_29_c3_promini.bin 2.9 寸, SSD1683 类矩阵屏, ESP32-C3 ProMini
epd_29_wroom32e.bin 2.9 寸, SSD1683 类矩阵屏, ESP32-WROOM-32E

WFT0420CZ15 4.2 寸

资产文件名 说明
epd_42_wft0cz15_bw_c3_promini.bin WFT0420CZ15 黑白 1 bpp, ESP32-C3 ProMini
epd_42_wft0cz15_bw_c3_std.bin WFT0420CZ15 黑白 1 bpp, ESP32-C3 标准板
epd_42_wft0cz15_bwr_c3_promini.bin WFT0420CZ15 黑白红 2 bpp, ESP32-C3 ProMini
epd_42_wft0cz15_bwr_c3_std.bin WFT0420CZ15 黑白红 2 bpp, ESP32-C3 标准板
epd_42_wft0cz15_bwr_c3_wroom02.bin WFT0420CZ15 黑白红 2 bpp, ESP32-C3-WROOM-02
epd_42_wft0cz15_bwr_wroom32e.bin WFT0420CZ15 黑白红 2 bpp, ESP32-WROOM-32E

5.83 寸 UC8179

资产文件名 说明
epd_583_uc8179_c3_promini_firmware_merged.bin 5.83 寸 UC8179, ESP32-C3 ProMini
epd_583_uc8179_c3_wroom02_firmware_merged.bin 5.83 寸 UC8179, ESP32-C3-WROOM-02
epd_583_uc8179_wroom32e_firmware_merged.bin 5.83 寸 UC8179, ESP32-WROOM-32E

Android 客户端

本版本未修改 Android 客户端代码,Release 中附带的 APK 沿用 v0.5.0 版本,方便用户在同一页面下载完整安装包。

InkSight v0.5

20 Apr 02:55

Choose a tag to compare

InkSight v0.5

Overview

v0.5 新增 ESP32-WROOM-32E 语音交互功能(单轮/多轮对话、语音切换模式),扩展相框模式支持多图轮播,优化设备鉴权与额度管理,修复多项 bug。首发固件以 4.2 寸矩阵为主(含 ai_chat 专用固件);同一 v0.5.0 Release 后续增补 2.9 寸、WFT0420CZ15 4.2 寸(黑白 / 三色)、5.83 寸 UC8179 合并固件(与下表文件名一致)。

Firmware Matrix(4.2 寸主流矩阵)

资产文件名 说明
epd_42_wsv2_ssd1683_c3_promini.bin 微雪 v2 4.2 寸, SSD1683 黑白面板, 2 色, ESP32-C3 ProMini
epd_42_wsv2_ssd1683_c3_std.bin 微雪 v2 4.2 寸, SSD1683 黑白面板, 2 色, ESP32-C3 标准板
epd_42_wsv2_ssd1683_wroom32e.bin 微雪 v2 4.2 寸, SSD1683 黑白面板, 2 色, ESP32-WROOM-32E(支持语音)
epd_42_zhongjingyuan_bw_gxepd2_gye042a87_c3_promini.bin 中景园 4.2 寸, GYE042A87 / SSD1683 黑白面板, 2 色, ESP32-C3 ProMini
epd_42_zhongjingyuan_bw_gxepd2_gye042a87_c3_std.bin 中景园 4.2 寸, GYE042A87 / SSD1683 黑白面板, 2 色, ESP32-C3 标准板
epd_42_zhongjingyuan_bw_gxepd2_gye042a87_wroom32e.bin 中景园 4.2 寸, GYE042A87 / SSD1683 黑白面板, 2 色, ESP32-WROOM-32E(支持语音)
epd_42_gdem042f52_jd79668_c3_promini.bin 佳显四色 4.2 寸, GDEM042F52 / JD79668 四色, 4 色, ESP32-C3 ProMini
epd_42_gdem042f52_jd79668_c3_std.bin 佳显四色 4.2 寸, GDEM042F52 / JD79668 四色, 4 色, ESP32-C3 标准板
epd_42_gdem042f52_jd79668_wroom32e.bin 佳显四色 4.2 寸, GDEM042F52 / JD79668 四色, 4 色, ESP32-WROOM-32E(支持语音)
epd_42_depg0420ry683_ssd1683_c3_promini.bin 广义顺 4.2 寸, DEPG0420RY683 四色, 4 色, ESP32-C3 ProMini
epd_42_wroom32e_ai_chat.bin 微雪 v2 4.2 寸 + 语音对话专用固件, ESP32-WROOM-32E(开机自动进入 AI Chat)

Firmware Matrix(增补,仍属 v0.5.0 Release)

2.9 寸

资产文件名 说明
epd_29_c3_promini.bin 2.9 寸, SSD1683 类矩阵屏, ESP32-C3 ProMini
epd_29_wroom32e.bin 2.9 寸, SSD1683 类矩阵屏, ESP32-WROOM-32E(支持语音)

WFT0420CZ15(4.2 寸,软件 SPI,EPD_PANEL_42_WFT

资产文件名 说明
epd_42_wft0cz15_bw_c3_promini.bin WFT0420CZ15 黑白 1 bpp, ESP32-C3 ProMini
epd_42_wft0cz15_bw_c3_std.bin WFT0420CZ15 黑白 1 bpp, ESP32-C3 标准板(非 USB-CDC)
epd_42_wft0cz15_bwr_c3_promini.bin WFT0420CZ15 黑白红 2 bpp(三色), ESP32-C3 ProMini
epd_42_wft0cz15_bwr_c3_std.bin WFT0420CZ15 黑白红 2 bpp, ESP32-C3 标准板(非 USB-CDC)
epd_42_wft0cz15_bwr_c3_wroom02.bin WFT0420CZ15 黑白红 2 bpp, ESP32-C3-WROOM-02
epd_42_wft0cz15_bwr_wroom32e.bin WFT0420CZ15 黑白红 2 bpp, ESP32-WROOM-32E(支持语音)

5.83 寸 UC8179(合并固件 _firmware_merged

资产文件名 说明
epd_583_uc8179_c3_promini_firmware_merged.bin 5.83 寸 UC8179, ESP32-C3 ProMini
epd_583_uc8179_c3_wroom02_firmware_merged.bin 5.83 寸 UC8179, ESP32-C3-WROOM-02
epd_583_uc8179_wroom32e_firmware_merged.bin 5.83 寸 UC8179, ESP32-WROOM-32E(支持语音)

2026-05-28 增补:背单词模式固件

资产文件名 说明
epd_42_wroom32e_vocab_review.bin SSD1683 4.2 寸 + 新增背单词模式固件, ESP32-WROOM-32E(支持按键翻面、切换评分与提交)

Android 客户端

资产文件名 说明
inksight_v1.apk InkSight 手机客户端(Android),与本版固件及后端能力配套;请在 Release 资源区下载安装
inksight_v2.apk 2026-05-28 更新:InkSight 手机客户端新版安装包,补充背单词模式和更多可编辑模式配置能力。安装新版前,请先卸载旧版 APP,并删除手机中已下载的旧安装包,避免误装旧版本。

Key Changes

  • 多尺寸面板(同版 Release 增补):2.9 寸、WFT0420CZ15 4.2 寸、5.83 寸 UC8179 合并固件与既有 4.2 矩阵一并发布;Web 刷机列表从 GitHub v0.5.0 资产自动生成
  • 语音交互(仅 WROOM-32E):单轮/多轮对话、语音切换模式,后端基于百炼 ASR + TTS
  • 相框模式:多图上传与轮播;重构自定义模式渲染链路
  • 电源与 OTA:锂电池电量计算优化;修复手机 OTA 芯片识别、多固件选择
  • 天气与预览:新增 QWeather 天气备用源;优化预览缓存;修复服务器部署 OTA 问题
  • 鉴权与设备:修复设备 owner 脏数据与解绑逻辑;加强主机访问权限与管理员鉴权
  • 手机 APP:Wi-Fi OTA;发现页自定义模式上传;支持中文名登录

v0.4

01 Apr 12:00

Choose a tag to compare

Overview

v0.4 聚焦 4.2 寸固件兼容性扩展、按键交互优化和常驻在线能力增强。本次补充了更完整的 4.2 寸固件矩阵,覆盖黑白与四色面板,以及 ESP32-C3 ProMini、ESP32-C3 标准板、ESP32-WROOM-32E 三类开发板。

Firmware Matrix

  • epd_42_wsv2_ssd1683_c3_promini.bin: 微雪 v2 4.2 寸, SSD1683 黑白面板, 2 色, ESP32-C3 ProMini
  • epd_42_wsv2_ssd1683_c3_std.bin: 微雪 v2 4.2 寸, SSD1683 黑白面板, 2 色, ESP32-C3 标准板
  • epd_42_wsv2_ssd1683_wroom32e.bin: 微雪 v2 4.2 寸, SSD1683 黑白面板, 2 色, ESP32-WROOM-32E
  • epd_42_zhongjingyuan_bw_gxepd2_gye042a87_c3_promini.bin: 中景园 4.2 寸, GYE042A87 / SSD1683 黑白面板, 2 色, ESP32-C3 ProMini
  • epd_42_zhongjingyuan_bw_gxepd2_gye042a87_c3_std.bin: 中景园 4.2 寸, GYE042A87 / SSD1683 黑白面板, 2 色, ESP32-C3 标准板
  • epd_42_zhongjingyuan_bw_gxepd2_gye042a87_wroom32e.bin: 中景园 4.2 寸, GYE042A87 / SSD1683 黑白面板, 2 色, ESP32-WROOM-32E
  • epd_42_gdem042f52_jd79668_c3_promini.bin: 大连佳显 4.2 寸, GDEM042F52 / JD79668 彩屏, 4 色, ESP32-C3 ProMini
  • epd_42_gdem042f52_jd79668_c3_std.bin: 大连佳显 4.2 寸, GDEM042F52 / JD79668 彩屏, 4 色, ESP32-C3 标准板
  • epd_42_gdem042f52_jd79668_wroom32e.bin: 大连佳显 4.2 寸, GDEM042F52 / JD79668 彩屏, 4 色, ESP32-WROOM-32E
  • epd_42_depg0420ry683_ssd1683_c3_promini.bin: 广义顺 4.2 寸, DEPG0420RY683 面板, 4 色, ESP32-C3 ProMini

Key Changes

  • 扩展 4.2 寸面板兼容性,补齐黑白与四色面板构建矩阵
  • 优化不同面板的刷新、忙等待、休眠和在线预览刷新行为
  • 改进联网、配网、提醒显示和活跃模式下的整体体验
  • Portal 页面与串口提示信息进一步完善

v0.3

14 Mar 10:15

Choose a tag to compare

Overview

This release brings major improvements to InkSight across mode sharing, preview experience, user API configuration, backend architecture, and firmware compatibility. It focuses on making the platform easier to try without hardware, easier to extend with community-created modes, and more flexible for users who want to use their own model credentials.

Highlights

  • Added Mode Plaza / Discover, allowing users to create custom modes and publish them to a shared gallery.
  • Added device-free preview, so users can preview e-ink modes directly from the web interface without a physical device.
  • Added user-provided API key support for LLM-related flows.
  • Improved account-based device management and access control.
  • Expanded firmware compatibility with additional board/display targets, including ESP32-WROOM-32E and initial 2.9-inch support.

Key Changes

Mode System

  • Added mode discovery, publishing, installation, and sharing related flows.
  • Improved custom mode creation and preview support.

Preview

  • Added web-based preview without requiring device binding.
  • Improved preview stability and fixed API-key usage in preview-related flows.

Accounts and Configuration

  • Added richer user profile settings for LLM provider and API key management.
  • Improved quota, invitation-code, and access-control related behavior.

Backend and Web

  • Refactored backend APIs into modular route-based components.
  • Expanded localization, web flows, and automated test coverage.

Firmware

  • Added new PlatformIO targets and board profiles.
  • Added ESP32-WROOM-32E support.
  • Added initial 2.9-inch display adaptation and related runtime/display improvements.

v0.2

09 Mar 11:10

Choose a tag to compare

Release InkSight v0.2

Overview

v0.2 brings a major upgrade across the backend, firmware, web configuration experience, and device management model. This release focuses on secure device pairing, account-based device access control, a new Next.js web app, a more extensible JSON-driven mode system, and a more reliable provisioning and runtime workflow.

Highlights

  • New account-based device management with login, ownership, member sharing, and access requests
  • Safer device pairing flow with explicit claim / pair-code based binding
  • New Next.js web app for config, claim, flashing, docs, and public website pages
  • Expanded JSON-driven content mode system with more built-in modes and custom mode support
  • Improved firmware provisioning, remote control flow, and offline cache support
  • Stronger backend auth, device token handling, config/state APIs, and stats pipeline
  • Expanded automated tests, CI checks, and firmware release workflow

Key Changes

Device Pairing and Security

  • Added user login and device membership model
  • Hardened config access so unbound users cannot configure arbitrary devices by MAC
  • Added explicit claim / pair-code based device binding flow
  • Improved portal pairing UX, redirect flow, and reprovisioning behavior

Web App

  • Added a new Next.js web app under webapp/
  • Supports login, device config, claim flow, firmware flashing, docs, and widget pages
  • Added richer config management, device list, member management, and request approval UI

Mode System

  • Expanded built-in modes
  • Continued migration toward JSON-defined modes
  • Added mode preview, mode generation, and custom mode editing support
    bi

Firmware

  • Improved captive portal flow
  • Added better network / token / claim handling
  • Added offline cache support
  • Improved runtime control and display behavior

Backend and Platform

  • Added auth / crypto / DB support modules
  • Improved config store, renderer, stats, and API surface
  • Expanded integration and auth test coverage
  • Improved CI and release automation

v0.1

05 Mar 11:52
b607eec

Choose a tag to compare

Release the 0.1 version of InkSight

Overview

inco (墨鱼) is an intelligent e-ink desktop companion built around InkSight. It uses a backend LLM to generate personalized content based on real-time context — weather, time of day, date, and solar terms — and renders it on a 4.2-inch e-ink screen.

The backend is built on the OpenAI-compatible SDK, working with DeepSeek, Alibaba Bailian (Qwen), and Moonshot (Kimi). Modes are extensible via a JSON config-driven system.

Key Features

  • 10+ Content Modes — Stoic, Roast, Zen, Daily, Briefing, ArtWall, Recipe, Fitness, Poetry, Countdown + AI-based custom modes
  • Extensible Mode System — Define new modes via JSON config (prompt, layout, style)
  • 4 Refresh Strategies — Random, Sequential, Time-Bound, Smart
  • On-Demand Refresh — Button-triggered refresh/switch and remote web trigger
  • Statistics Dashboard — Device status, battery trends, mode usage, cache hit rate
  • WiFi Provisioning — Captive portal setup flow
  • Web Configuration — Full settings management with preview and history
  • Smart Caching — Batch pre-generated content and faster response
  • Multi-LLM Support — DeepSeek, Qwen, Moonshot, and OpenAI-compatible APIs
  • Ultra-Low Power — Deep sleep design for long battery life

Release Assets

  • inksight-firmware-v0.1.0-merged-epd_42.bin

Contributors