基于开源 xTouch 项目制作的 xtouch-CN，是运行在 2.8 英寸 ESP32 CYD 触摸屏上的拓竹打印机监控与控制固件。放在打印机旁边，就能查看打印进度、温度和耗材状态，完成常用操作，不用每次都打开手机或电脑。
- 项目地址：https://github.com/tbc0309/xtouch-CN
- 固件下载：https://github.com/tbc0309/xtouch-CN/releases/latest
- 配置生成与在线刷写
界面展示
以下为中文实机界面，按首页、温度、控制、耗材、设置、设备与版本、设备选择、项目链接排列。
主要功能
中文界面与多语言。 普通文字和大号数字使用腾讯 W7 字体，支持简体中文、繁体中文、英语、法语、俄语和日语，可直接在设置中切换。内置字库覆盖界面文案，外部传入的打印文件名不保证所有汉字都能显示。
多台打印机切换。 配置文件最多保存 100 台打印机，一次连接其中一台，可以设置自定义名称。4 台以内点击首页设备卡按顺序切换；超过 4 台则打开可滚动的设备列表，长按也能打开列表。收到打印机型号后，首页显示相应机型图片，未识别时保留 xTouch 标志。
打印状态与常用控制。 查看打印进度、喷嘴和热床温度，进行温度、风扇、速度、灯光及运动控制。具体功能取决于打印机型号与固件支持，不能把显示了机型图片等同于所有功能都经过实机验证。
AMS 与外置耗材。 首页顶部显示实际耗材颜色，多台 AMS 可点击轮换；耗材页支持分组查看，AMS 数量较多时横向滑动，外置耗材入口固定显示。选择耗材后可确认进料、退料和 RFID 重读；剩余量较低时用不同颜色提醒。部分打印机固件会限制局域网控制，相关操作需按项目文档检查局域网及开发者模式。
初始化后可脱离 SD 卡。 首次从 SD 卡导入 Wi-Fi、打印机等配置，之后配置、语言、触摸校准保存在机器内部。重新插卡会进行配置同步，原版单设备配置也可自动转换并保留备份。
SD 卡升级与 OTA。 可以用 SD 卡更新，也可以通过本项目的 OTA 更新。开机只对更新检查设置最长 15 秒的等待限制，固件下载另行处理；连续点击设置页版本号三次可手动检查更新。
安装与配置
支持原版 xTouch 固件通过 SD 卡直接升级为本项目 xtouch-CN 固件，无需先用 USB 重刷。
下载本项目的 xtouch-2.8.bin，重命名为 firmware.bin 放到 SD 卡根目录，插卡开机即可升级。保留原有连接配置和触摸校准，升级前移除旧的 xtouch/ota.json。
需要与上游 xTouch 兼容的 2.8 英寸 ESP32 CYD 硬件，屏幕驱动和引脚不同的开发板不能直接通刷。
- 电脑使用 Chrome 或 Edge 打开 配置生成与在线刷写。数据线连接 CYD 主板，在「在线刷写」中选择串口并按提示安装；保留内部配置与触摸校准时不要勾选 Erase device。
- 在网页「配置生成」中填写 Wi-Fi、打印机地址、序列号和局域网访问码，下载 xtouch.json 放到 SD 卡根目录。网页默认中文，可切换英文；填写内容仅在当前浏览器处理。
- 首次启动完成触摸校准并导入配置，连接成功后即可使用。配置导入后可移除 SD 卡。
- SD 卡升级使用 xtouch-2.8.bin，重命名为 firmware.bin 放到卡根目录；OTA 和内部配置同步的详细步骤见项目文档。
配置文件包含 Wi-Fi 密码和打印机访问码，请自行保管，分享配置时先删除这些信息。
说明
本项目是基于上游 xTouch 的个人开源改版，与拓竹官方及硬件商家无关联。不提供技术支持和交流，使用中遇到问题请自行查阅文档或询问 AI 解决。
