本指南面向具有 ESP32 基础的开发者。Zectrix Note 4C 是 4.2 英寸黑、白、红、黄四色电子墨水屏开发板，固件与黑白版 Note 4 不通用。
zectrix-s3-epaper-4.2主要引脚：
| 功能 | GPIO |
|---|---|
| 上键 | 39 |
| 下键 / 电源相关 | 18 |
| BOOT / 确认键 | 0 |
| 墨水屏 DC | 10 |
| 墨水屏 CS | 11 |
| 墨水屏 CLK | 12 |
| 墨水屏 MOSI | 13 |
| 墨水屏 RESET | 9 |
| 墨水屏 BUSY | 8 |
| 墨水屏电源 | 6 |
请勿把本固件刷入引脚定义不同的 ESP32-S3 开发板。
四色墨水屏刷新较慢，按键后请等待当前刷新完成，不要连续快速操作。
首次启动且设备中没有保存 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 可能发生变化，请以设置页面当前显示的地址为准。
当前提供的 Note 4C 合并固件：
下载 notellm-2bp-v6.5.9-2bp-3fbbabb-20260705-mergebin.bin
0x000026f209f7cdea8f62bff73f2e877e3ab421917c17497a2a23340129c6ef43fc36下载后建议核对文件名、文件大小和 SHA-256，再开始刷写。
0x0000。刷写过程中请勿拔出 USB 数据线、关闭网页或让电脑进入休眠。
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 应用镜像当作合并固件使用。
固件项目：
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，以仓库当前状态为准。