Skip to content

墨印 MoInk 基线版本：R1.3.1

Choose a tag to compare

View all tags
@atunverse atunverse released this 17 Oct 16:27
· 3 commits to main since this release
R1.3.1
147b5bb

墨印 MoInk 基线版本：R1.3.1

⚠️ 本版是硬件适配批次：排线档引脚重新分配 + 电池分压电阻改 1M:1M。
⚠️ 用【排线】接法的板子升级后必须按新接线核对（见下表），接错会不亮屏。
⚠️ 自本版起 Release 继续累积保留，历史版本不删除。
⚠️ 升级不重置设置，已有的轮播图也保留。

本次更新（相对 R1.3.0）

1. ★ 排线档引脚改版

gpio_preset = 1（排线）的引脚表整体重排：

信号 新排线档 旧排线档（R1.3.0 及更早）
ADC（电池） GPIO0 GPIO0
KEY（唤醒） GPIO1 GPIO5 ← 变了
LOCK（自锁） GPIO2 GPIO2（固定，不在这八个脚里）
BUSY GPIO3 GPIO1 ← 变了
RST GPIO4 GPIO3 ← 变了
DC GPIO5 GPIO4 ← 变了
CS GPIO6 GPIO6
SCK GPIO7 GPIO7
DIN（MOSI） GPIO10 GPIO10

默认档（SCK=4 / DIN=6 / CS=7 / DC=1 / RST=3 / BUSY=10，唤醒=5，ADC=0）与
整合板档（SCK=4 / DIN=3 / CS=5 / DC=6 / RST=7 / BUSY=10，唤醒=1，ADC=0）未改动。

2. ★ 电池分压电阻 100k:100k → 1M:1M

分压比 (1M+1M)/1M = 2.0，与原来的 100k:100k 完全相同，所以固件里的
BAT_DIV_NUM/BAT_DIV_DEN 保持 200/100 不动 —— 这不是漏改，改电阻值不影响系数。

⚠️ 1M 电阻的源阻抗约 500 kΩ，ESP32-C3 的 ADC 在这种高阻源下读数会偏低
（几十 mV 量级），电量百分比可能整体偏小。建议 ADC 端并联 100 nF 到地；
若换上板后电量明显不准，用万用表实测电池电压后按实测值重新标定
src/power.c 的 BAT_FULLSCALE_MV（当前 3100 mV @ 12 dB）。

3. 版本与工具

  • 版本号 R1.3.0 → R1.3.1；控制页 meta 同步，src/index_html.h 重新固化。
  • tools/smoke_page.js 的版本断言改为动态读取 src/version.h 的
    MOINK_VERSION 与 CONTRACT 版头，后续升版不必再改门禁脚本。
  • 本版为纯参数 / 注释改动，无逻辑变更。

升级须知

  • R1.2.0 及之后的设备可直接网页 OTA：进设备页面「设置 → 系统维护与升级」，
    上传 moink_R1.3.1_app.bin 即可（分区表未变）。
  • R1.1.x 及更早的设备必须线刷：分区表在 R1.2.0 变更过（新增 store 存储分区），
    只能用数据线整包刷 moink_R1.3.1_merged.bin。
  • 排线档设备：档位号没变（仍为第 2 档），升级后会自动套用新表，按新接线接好即可；
    但之前用「自定义」档手工填旧脚位的，升级后必须进页面按新接线重选一遍。
    改动 GPIO 必须重启才生效（选完点「保存并重启」）。
  • 升级不重置设置（沿用 R1.2.2 语义：只清 a1_mode / a11_var 两个废弃键），
    热点名与密码保留，已存的轮播图保留。
  • 传 .html 只热更控制页，不重启，刷新浏览器即生效。
  • 本版固件仍没有 /api/ota 与 /api/web（R1.2.0 起删除），R1.1.x 的旧页面
    无法升级本版设备，请使用本包内的页面。

兼容性

  • api 保持 2：16 字节帧头格式与语义零变动，分区表零变动 —— 可与 R1.3.0 / R1.2.x 互刷。
  • 算法基线 B2 12/12 MATCH，色彩与几何规格未变。
  • 固件体积与 R1.3.0 相同（1,003,426 B / 76.6%），RAM 39,660 B（12.1%），0 告警。

资产说明

  • MoInk-FlashKit-R1.3.1.zip：Windows 一键刷机包，解压后双击 bat 即可
    （自动选串口、跳过蓝牙虚拟口）；包内「使用说明.txt」含完整验收清单与排线档新旧对照表
  • moink_R1.3.1_merged.bin：固件整包（R1.1.x 及更早线刷用，0x0 整包写入，含分区表，控制页已内嵌）
  • moink_R1.3.1_app.bin：OTA 升级包（R1.2.0 起设备网页升级用）
  • page-R1.3.1.html：控制页热更包（网页上传，免刷机）

版本校验

刷完在设备页面「设置 → 设备信息」应显示：版本 R1.3.1 / 接口 2。

真机验收清单（四项）

  • V1 排线档引脚（★本版重点）：设成「排线」档 → 「保存并重启」→ 重启后能正常刷屏、
    四色正确、方向正常。若黑屏 / 白屏，先核对接线是否符合上表。
  • V2 电量读数：接电池，控制页电量百分比与万用表实测电压相符（误差 5% 以内可接受）；
    1M 高阻源若读数明显偏低，并 100 nF 电容或重新标定。
  • V3 轮播抽检（R1.3.0 功能）：传一张图 → 屏幕显示且图库出现缩略图；短按按键切到下一张。
  • V4 升级兼容：用 moink_R1.3.1_app.bin 网页 OTA（分区表未变）；
    升级后已有的轮播图与设置都应保留。
Assets 6
Loading