TinkerBarn/BoxRFID-Touch

# BoxRFID-Touch 基于 **ESP32-2432S028R (CYD)** 和 **PN532** 的独立 RFID/NFC 触摸屏工具，适用于多个耗材生态系统。 支持的独立工作流程： - **OpenSpool Standard** RFID/NFC 标签 - **Snapmaker U1** 搭配 **paxx12 Extended Firmware**，用于扩展的 OpenSpool 工作流程 - **QIDI Q2**、**QIDI Plus 4** 和 **QIDI Max 4** 搭配 **QIDI Box**

## 网页安装器 ## [打开 BoxRFID-Touch 网页安装器](https://tinkerbarn.github.io/BoxRFID-Touch/) 网页安装器现在提供三个清晰的选项： - **V2.1 经典 QIDI** 适用于经典固件系列 - **V4.0.1 回退版** 适用于之前的 QIDI + OpenSpool 组合发布 - **V4.1 当前版本** 适用于最新的组合固件 ## 视频 [](https://youtu.be/4cGLlr9Ckx4?is=iYzOwJqUVbCeVkuv) ## 固件概览 | 固件系列 | 版本 | 状态 | 最佳使用场景 | 安装器 | | --- | --- | --- | --- | --- | | BoxRFID OpenSpool Edition | V4.1 | 当前版本 | 推荐给大多数需要 QIDI + OpenSpool 一体化固件的用户 | 是 | | BoxRFID OpenSpool Edition | V4.0.1 | 稳定回退版 | 保留的前一组合发布版，作为从 V4.1 回退的选择 | 是 | | BoxRFID OpenSpool Edition | V3.7 | 旧版组合发布 | 早期组合发布版，保留以供兼容性和参考 | 否 | | BoxRFID-Touch | V2.1 | 稳定经典版 | 经典的仅 QIDI 工作流程 | 是 | | BoxRFID-Touch | V2.0 | 旧版 | 旧版经典 QIDI 发布版，仅保留用于兼容性 | 否 | 本仓库中的公共固件文件夹： - [BoxRFID-Touch V2.0](./firmware/boxrfid-touch/v2.0/) - [BoxRFID-Touch V2.1](./firmware/boxrfid-touch/v2.1/) - [BoxRFID OpenSpool Edition V3.7](./firmware/boxrfid-openspool/v3.7/) - [BoxRFID OpenSpool Edition V4.0](./firmware/boxrfid-openspool/v4.0/) - [BoxRFID OpenSpool Edition V4.0.1](./firmware/boxrfid-openspool/v4.0.1/) - [BoxRFID OpenSpool Edition V4.1](./firmware/boxrfid-openspool/v4.1/) 源代码文件夹： - [BoxRFID-Touch V2.1 源代码](./source/boxrfid-touch/v2.1/) - [BoxRFID OpenSpool Edition V3.7 源代码](./source/boxrfid-openspool/v3.7/) - [BoxRFID OpenSpool Edition V4.0 源代码](./source/boxrfid-openspool/v4.0/) - [BoxRFID OpenSpool Edition V4.0.1 源代码](./source/boxrfid-openspool/v4.0.1/) - [BoxRFID OpenSpool Edition V4.1 源代码](./source/boxrfid-openspool/v4.1/) 文档： - [固件矩阵](./docs/firmware-matrix.md) - [版本历史](./docs/version-history.md) - [BoxRFID-Touch V2.1 文档](./docs/BoxRFID-Touch/BoxRFID-Touch.md) - [BoxRFID OpenSpool Edition V4.0 / V4.0.1 / V4.1 文档](./docs/BoxRFID-OpenSpool-Edition/BoxRFID-OpenSpool-Edition.md) ## 功能说明 BoxRFID-Touch 是一个用于兼容耗材 RFID/NFC 标签和盒子的独立读取器/写入器，因此日常使用无需连接 PC。 它专为三个明确区分的工作流程组设计： - **OpenSpool Standard** RFID/NFC 标签 - **Snapmaker U1** 搭配 **paxx12 Extended Firmware**，使用扩展的 OpenSpool 数据模型 - **QIDI Q2 / Plus 4 / Max 4** 与 **QIDI Box** 搭配使用 固件系列的核心功能： - 手动标签读取 - 主屏幕自动标签读取 - 触摸屏直接标签写入 - 多语言用户界面 - 持久化设置存储 - 本地可编辑的材料和制造商列表 OpenSpool Edition 的额外功能： - 一个固件中包含 QIDI 模式和 OpenSpool 模式 - OpenSpool Standard 和 **Snapmaker U1 / paxx12 Extended Firmware** 工作流程 - 灵活的颜色、HEX、数字和变体输入 - 基于每个型号的 QIDI 数据库 - V4.x 版本线中支持基于 MicroSD 和 Wi-Fi 的官方 QIDI CFG ## V4.1 更新内容 最新版本亮点： - 当前的 **QIDI Box + OpenSpool 一体化发布版** - 支持 **QIDI Q2**、**QIDI Plus 4** 和 **QIDI Max 4** 搭配 **QIDI Box** - 当存在 SD 卡时，**自动将用户设置和编辑的列表备份到 MicroSD** - 在固件更新或设备更换后**自动恢复**，因此设置、材料、制造商和变体可以随卡迁移 - 改进了 `officiall_filas_list.cfg` 的**网络界面**，具有英文 UI、上传状态、存储文件检测、卡内容列表和直接 CFG 内容查看功能 - 添加了 **mDNS 访问**，因此也可以通过 `http://boxrfid.local` 访问网络界面 - 改进了 **MicroSD 状态更新**，在相关设置页面上支持运行时热插拔检测 - 专用的 **SD 卡工具**，包括内容查看和带文件夹结构重建的格式化 - 用于 `officiall_filas_list.cfg` 的 **Wi-Fi 设置** 和 **浏览器上传** - 对所有三种 QIDI 打印机型号的 **MicroSD 官方 QIDI CFG 支持** - 在读取缺少可选值的标签后，改进了 **OpenSpool 写入默认值** - 改进了 **键盘布局**、**触摸处理** 和 **设置流程** - 添加了 **设备上的 Wi-Fi 调试工具**，支持重新连接 - 在安装器中保留了 **V4.0.1** 作为用户希望从最新版本回退时的备用路径 完整的持续发布历史，请参见 [版本历史](./docs/version-history.md)。 ## 我该使用哪个版本 - 如果您想要用于 **QIDI Box**、**OpenSpool Standard** 和 **Snapmaker U1 with paxx12 Extended Firmware** 的最新版本，请选择 **BoxRFID OpenSpool Edition V4.1**。 - 如果您想要作为备用的前一组合发布版，请选择 **BoxRFID OpenSpool Edition V4.0.1**。 - 仅当您特别想要旧版组合发布时，才选择 **BoxRFID OpenSpool Edition V3.7**。 - 如果您只需要经典 QIDI 固件系列，请选择 **BoxRFID-Touch V2.1**。 - 仅当您特别需要旧版经典固件时，才使用 **BoxRFID-Touch V2.0**。 ## 安装 ### 网页安装器 1. 通过 USB 连接 ESP32 开发板。 2. 打开 [网页安装器](https://tinkerbarn.github.io/BoxRFID-Touch/)。 3. 点击 **连接**。 4. 选择正确的串口。 5. 选择所需的固件： - `V4.1` 用于最新的组合发布版 - `V4.0.1` 用于组合回退发布版 - `V3.7` 用于旧版组合发布版 - `V2.1` 用于经典 QIDI 发布版 6. 刷写固件。 注意事项： - 使用 **Chrome** 或 **Edge** 浏览器 - 使用**支持数据传输的 USB 数据线** - 如果没有立即检测到开发板，请重新连接 - 如有必要，连接时按住 **BOOT** 按钮 - 刷写将覆盖设备上现有的固件 ## 硬件 主要硬件： - **ESP32-2432S028R CYD** - **PN532 NFC/RFID 模块** - **USB 数据线** - **跳线** 支持的标签类型： - **QIDI 工作流程：** MIFARE Classic 1K 标签 - **OpenSpool 工作流程：** NTAG215 标签 ## 兼容性 ### BoxRFID OpenSpool 版 V4.1 QIDI 支持： - **QIDI Q2** 搭配 **QIDI Box** - **QIDI Plus 4** 搭配 **QIDI Box** - **QIDI Max 4** 搭配 **QIDI Box** OpenSpool 支持： - **OpenSpool Standard** RFID/NFC 标签 - **Snapmaker U1** 搭配 **paxx12 Extended Firmware** - **Snapmaker U1** 搭配 **OpenRFID 支持** ### BoxRFID-Touch V2.1 用于以下场景的经典固件系列： - **经典 QIDI 风格的工作流程** - **MIFARE Classic 1K 标签** ## 接线 使用前将 PN532 模块设置为 **I2C 模式**。 ``` ESP32-2432S028R CYD PN532 ------------------- ----- 3.3V -> VCC GND -> GND GPIO 27 -> SDA GPIO 22 -> SCL ``` ## 物料清单 电子元件： - **ESP32-2432S028R CYD** [Amazon 德国](https://www.amazon.de/dp/B0CG2WQGP9) [Amazon 美国](https://www.amazon.com/dp/B0DNM4SKSJ) - **PN532 NFC/RFID 模块** [Amazon 德国](https://www.amazon.de/dp/B0D86CPN5J) [Amazon 美国](https://www.amazon.com/dp/B01I1J17LC) - **母对母 USB-C 数据线** [Amazon 德国](https://www.amazon.de/dp/B0DSLNJMDR) [Amazon 美国](https://www.amazon.com/dp/B0C1X7P9K2) - **USB-C 开关** [Amazon 德国](https://www.amazon.de/dp/B0CG11Y3MD) [Amazon 美国](https://www.amazon.com/dp/B0F23RKY9Z) - **跳线** 外壳： - [MakerWorld 上的 BoxRFID-Touch 外壳](https://makerworld.com/de/models/2518866-boxrfid-case-rfid-reader-writer-for-qidi-box#profileId-2770921) ## 照片与截图 ### 硬件

Electronic parts

PN532 RFID sensor

Set PN532 to I2C mode

ESP32-2432S028R

### 组装

Connect the cables

ESP32 detail view

PN532 detail view

### 设备

Front view

Back view

Side view

Mounted device

### V4.1 工作流程动画 下面的动画展示了当前 **BoxRFID OpenSpool Edition V4.1** 直接在设备 UI 上的写入工作流程。

QIDI write workflow Write flow for QIDI mode with manufacturer, material, color selection, and successful tag writing.

OpenSpool Standard write workflow Standard OpenSpool tag writing with color picker, HEX input, temperature editing, and successful tag writing.

Snapmaker U1 write workflow Extended OpenSpool workflow for Snapmaker U1 including advanced material fields, multiple colors, and successful tag writing.

### UI 截图

Home

Read Tag

Write Main

Setup Main

## 相关项目 如果您需要 Windows 桌面程序，请参见 [BoxRFID](https://github.com/TinkerBarn/BoxRFID)。 ## 许可证 CC BY-NC-SA 4.0

标签：3D打印, ESP32, NFC, OpenSpool, PN532, QIDI, RFID, Snapmaker, 固件, 多生态系统支持, 嵌入式系统, 开源硬件, 物联网, 独立设备, 耗材管理, 触摸屏, 设备管理