本指南适用于 Zectrix Note 4C 四色电子墨水屏开发板。Note 4C 使用 4.2 英寸黑、白、红、黄四色屏，固件与黑白版 Note 4 不通用。
首次使用前，请先下载并刷入适用于 Note 4C 的合并固件。推荐使用极趣云平台网页刷机；熟悉命令行的开发者也可以使用 esptool。
以下固件仅适用于 Zectrix Note 4C 四色屏。请勿刷入黑白版 Note 4、其他尺寸屏幕或引脚定义不同的 ESP32-S3 开发板。
立即下载 Note 4C 合并固件（mergebin.bin）
notellm-2bp-v6.5.9-2bp-3fbbabb-20260705-mergebin.bin0x000026f209f7cdea8f62bff73f2e877e3ab421917c17497a2a23340129c6ef43fc36下载后建议核对文件名、文件大小和 SHA-256，再开始刷写。
0x0000。刷写过程中请勿拔出 USB 数据线、关闭网页或让电脑进入休眠。
先安装 esptool：
python3 -m pip install --upgrade esptool
macOS 常见串口形式：
/dev/cu.usbmodemXXXX
/dev/cu.usbserial-XXXX
Windows 常见串口为 COM3、COM4 等。
进入固件下载目录，将串口替换为电脑实际识别到的端口后执行：
python3 -m esptool \
--chip esp32s3 \
--port /dev/cu.usbmodemXXXX \
--baud 460800 \
write-flash 0x0 notellm-2bp-v6.5.9-2bp-3fbbabb-20260705-mergebin.bin
Windows 用户将 python3 改为 python，并把串口替换为实际的 COM 端口。
如果自动连接失败：
务必将合并固件写入 0x0。不要把单独的 OTA 应用镜像当作合并固件使用。
zectrix-s3-epaper-4.2主要引脚：
| 功能 | GPIO |
|---|---|
| 上键 | 39 |
| 下键 / 电源相关 | 18 |
| BOOT / 确认键 | 0 |
| 墨水屏 DC | 10 |
| 墨水屏 CS | 11 |
| 墨水屏 CLK | 12 |
| 墨水屏 MOSI | 13 |
| 墨水屏 RESET | 9 |
| 墨水屏 BUSY | 8 |
| 墨水屏电源 | 6 |
四色墨水屏刷新较慢。按键后请等待当前刷新完成，不要连续快速操作。
首次启动且设备中没有保存 Wi-Fi 时，固件会自动进入配网模式。如果没有自动进入，请按以下步骤操作：
ZecTrix 开头的热点，该热点默认没有密码。http://192.168.4.1。建议使用 2.4GHz Wi-Fi；ESP32-S3 无法连接仅开放 5GHz 的网络。
首次连接后的显示问题： 首次成功连接 Wi-Fi 后，相册页面可能仍显示“未连接”。这是已知的状态刷新问题，不代表设备一定没有联网。请按一下 RESET 手动复位，或先切换到其他页面再返回“相册”，即可刷新并显示实际连接状态。
热点：InkScreen-AP
密码：12345678
http://192.168.4.1。网页会在浏览器端自动完成缩放和四色转换，不需要提前把图片转换成 BIN。
请注意区分两个热点：
ZecTrix...：用于首次配置家庭 Wi-Fi，默认无密码。InkScreen-AP：用于相册热点传图，密码为 12345678。设备连接家庭 Wi-Fi 后，可以通过局域网长期管理图片：
http://设备IP/。局域网页面支持上传图片、预览四色转换结果、展示和管理图片，以及设置轮播。
设备 IP 可能发生变化，请以“设置”页面当前显示的地址为准。
固件项目：
LazyYoun/youn-ink-fourcolor-firmware
git clone https://github.com/LazyYoun/youn-ink-fourcolor-firmware.git
cd youn-ink-fourcolor-firmware/firmware
仓库 README 当前推荐 ESP-IDF 6.0。进入 ESP-IDF 环境后：
idf.py set-target esp32s3
idf.py menuconfig
在配置菜单中确认：
Xiaozhi Assistant
└── ZecTrix EPD panel type
└── 4-color BWRY SSD2683 EPD
对应配置：
CONFIG_ZECTRIX_EPD_PANEL_4COLOR_SSD2683=y
然后编译和烧录：
idf.py build
idf.py -p /dev/cu.usbmodemXXXX flash monitor
串口名称请替换为电脑实际识别到的设备端口。退出监视器使用 Ctrl + ]。
当前公开仓库的源码和四色驱动可供阅读与二次开发，但从零编译流程仍可能受公开文件完整度影响：
2bp，目前没有可直接对应版本的 Git tag。开始开发前，请优先阅读仓库最新 README、提交记录和 Issues，并以仓库当前状态为准。
Note 4C 是面向开发者的硬件开发板，默认不包含软件二次开发服务。开发过程中，可以将上述 GitHub 仓库交给 Codex、WorkBuddy 等 AI 编程工具，辅助阅读代码、排查构建问题和进行二次开发。
如怀疑设备存在硬件问题，请准备设备型号、固件文件名、操作步骤和屏幕提示，并通过以下方式联系我们：
工作人员会在工作时间协助判断和处理。