52梯控论坛

标题: GSWXXN/NFCToolsGUI [打印本页]

作者: admin    时间: 2026-10-29 12:18
标题: GSWXXN/NFCToolsGUI
# 【工具分享】GSWXXN/NFCToolsGUI:跨平台 PN532 图形化工具使用整理

> 本帖为公开技术资料的整理与改写,仅面向自有设备与合法技术调试场景,请勿用于任何未经授权的用途。原始项目地址见文末。

## 适用场景

NFCToolsGUI 是一个面向 PN532 读卡器的跨平台图形界面程序,支持 Windows、Linux 和 macOS。适合以下场景参考:

- 手头有 PN532 硬件,希望在桌面上以图形界面完成常规读写与调试操作;
- 需要在多个操作系统上使用同一套工具链,减少环境差异带来的折腾;
- 希望基于开源项目自行编译、二次开发或学习其实现思路。

## 原理简述

该项目本质上是对若干命令行 NFC 工具的图形化封装,通过 Electron 构建跨平台桌面界面,底层调用 libnfc 等库与 PN532 硬件通信。根据项目说明,其主要功能包括:

- 使用 MFOC 进行卡片处理;
- 写卡、格式化卡;
- UFUID 锁卡;
- HardNested 处理;
- 字典测试;
- Dump 编辑与 Dump 对比。

**驱动安装**:以 CH341 为例,Windows 需下载安装 CH341SER;macOS 需安装 CH341SER_MAC;Linux 内核通常已内置 CH341 驱动,一般无需单独安装,若内核未包含可尝试 CH341SER_LINUX。

**编译核心组件**:

- Windows:安装 MSYS2 后,在项目目录的 CMD 中执行 `C:\msys64\msys2_shell.cmd -mingw64 -defterm -here -no-start -c ./compile.sh`(路径按实际安装位置替换)。
- Linux(以 Ubuntu 为例):先安装依赖 `curl autoconf libtool pkg-config patchelf liblzma-dev libreadline-dev`,再执行 `sh ./compile.sh`;不同发行版依赖名称可能不同。
- macOS:先 `brew install autoconf automake libtool pkg-config`,再执行 `sh ./compile.sh`。

**编译 GUI**:安装 Node.js 后,在项目目录执行 `npm install` 与 `npm run make`,产物位于 `out` 目录;也可用 `npm run start` 进行调试。

**用户文件目录**:除安装目录外,程序还会在以下位置存放用户文件——Windows 为 `%APPDATA%\NFCToolsGUI`;Linux 为 `$XDG_CONFIG_HOME/NFCToolsGUI` 或 `~/.config/NFCToolsGUI`;macOS 为 `~/Library/Application Support/NFCToolsGUI`。

**Linux 常见问题**:

- 找不到 `ttyUSB0` 等串口:可先执行 `sudo dmesg | grep brltty` 查看,若输出显示串口被 brltty 占用(如 `interface 0 claimed by ch341 while 'brltty' sets config #1`),可执行 `sudo apt remove brltty` 卸载后重新插拔设备。
- 能找到串口但打不开:通常是权限问题。可将当前用户加入 dialout 组(`sudo usermod -a -G dialout <用户名>`),重新登录后生效;也




欢迎光临 52梯控论坛 (https://52tikong.com/) Powered by Discuz! X3.4