基于浏览器原生 WebUSB + WebSerial + WebHID API 的工具，专为 Brady 扫描枪和 USB 打印机设计。离线运行，无需服务器，即插即用。

👉 点击进入Web USB 扫描枪+打印机 配置页面

项目简介

从 2026 年 4 月启动，历经 20+ 个版本迭代，从扫描枪配置码工具一路演进为覆盖扫描枪 + 打印机的完整控制平台。

功能总览

📱 扫描枪配置码

配置码查询、分类管理、一键发送。6 大分类覆盖 Brady 扫描枪所有常用设置：

• 基础设置（恢复出厂、蜂鸣器、LED）
• 接口设置（USB 串口、键盘口、RS232）
• 数据格式（前缀/后缀、码制启用/禁用）
• 扫描模式（手动触发、连续扫描、感应扫描）
• 高级功能（数据编辑、定时关闭）
• 恢复默认

📊 条码生成

支持 Code128 / EAN / UPC / QR / DataMatrix / Aztec 等 15+ 种条码格式，SVG/PNG 双模式切换，正方形码约束。

🔌 串口调试

收发测试、十六进制显示、常用命令快捷发送。支持 Brady 16 43 0D SYN 前缀协议。

📸 抓图

通过串口向扫描枪发送 IMGSHP. 命令，捕获摄像头实时画面，支持 JPEG/BMP/原始单色格式。

📦 固件升级

扫描枪：YMODEM 协议串口升级，支持 OSPV 兼容文件头预处理，升级完成后自动 HID 断连触发重启。

打印机：USB 自定义 XML 协议升级，完整流程 握手→UpgradeResource Prepare→UploadFile 分块→UpgradeResource kernel 触发→END_CONN。异步执行不阻塞，实时进度查询，大号百分比动画进度条。

🖨️ 打印机功能（全系打印机 | v1.7）

完整 USB 打印机控制方案，支持：

配置管理

• 17 项配置参数读写（介质/打印质量/打印区域/动作/系统）
• 多包读取解决大响应截断
• 状态码映射（0=空闲, 128=打印中, 132=缺纸）
• 导出/导入 XML 配置
• IP 子网掩码网关配置
• 蓝牙设备名称配置
• 恢复出厂设置（支持选择性重置）

打印指令

• DP 命令发送 & 原始数据打印
• 标签校准（Testfeed）
• 走纸（FF）

多型号框架

• PC300T / PC310T 配置字段完整定义
• PX940 配置骨架

📂 文件管理 🆕

打印机端文件浏览与管理：

• 按目录 / 按类型（字体/图片/脚本/表单/应用）浏览
• 文件上传（分块 40960 bytes + CRC 校验）
• 文件下载（支持各种打印机文件）
• 文件删除
• 上传路径从之前的硬编码修复为动态当前目录

📦 打印机固件升级 🆕

完整的固件升级解决方案：

• 选择 .bin 文件后自动解析固件头显示版本号 / 平台 / 内核 / P Core / 签名信息
• 异步上传不阻塞 HTTP，后台线程执行
• 实时进度 API 查询 + 前端轮询
• 大号百分比数字 + 渐变色进度条（蓝→橙→绿）+ 脉冲动画
• 支持取消操作

协议流程：

1
2
3

握手 → RQ_CONN → UpgradeResource Prepare → UploadFile 
→ PACKET 分块（40960 bytes/块，CRC校验）→ UpgradeResource kernel 
→ END_CONN

固件信息分析示例（firmware-signed.bin）：

版本演进

关键技术突破

免驱动可与打印机连接配置
基于 Web USB 与扫描枪串口通信，实现 web 配置操作扫描枪，固件升级
自定义 XML 协议实现打印机文件管理 & 固件升级（分块传输 + CRC 校验 + 异步执行）

后续规划

• 打印机配置字段补全（PX940 / PC42 / PM45）
• Windows 驱动 DEVMODE 格式逆向
• 前端构建脚本自动生成所有型号 config-defs
• 配置导出/导入增加型号信息
• 打印机固件升级路径与参数可配置