电路项目 · 2026/10/13
树莓派5上搭建GTK4 NFC读取器应用
树莓派5上搭建GTK4 NFC读取器应用,支持Type 2、3、4或5的NFC标签,支持RF技术A、B、F或V,使用RUL SDK和SPI通信协议,GTK4 GUI应用,用于读取NFC标签和NDEF消息
本文是基于 Instructables 公开项目生成的中文制作指南,不转载原文全文。完整图片、图纸、精确尺寸、评论和作者原说明请访问原文链接。
树莓派5上搭建GTK4 NFC读取器应用

项目概览
本项目旨在将PTX205R NFC读取器与树莓派5结合,创建一个GTK4 GUI应用,用于读取NFC标签和NDEF消息。该项目适合具有基本电子和编程知识的爱好者。核心原理涉及使用RUL SDK和SPI通信协议。准备方式包括安装必要的软件包、配置树莓派和连接PTX205R评估板。制作顺序包括准备PTX205R评估板、配置树莓派、连接板子、克隆仓库、构建和运行应用。关键风险包括硬件连接错误和软件配置不当。需要查原图的地方包括连接PTX205R EB PMOD到树莓派5 SPI引脚的具体细节。可以按自己的材料调整的地方包括使用不同的NFC标签类型和RF技术。建议在开始前检查工作台、工具和安全装备,确保所有材料和工具都准备就绪。同时,建议测试方法包括使用不同的NFC标签和NDEF消息来验证应用的功能。
基本信息
- 原文标题:GTK4 NFC Reader App for the Raspberry Pi
- 原作者:NFCRenCS
- 来源板块:电路
- 原发布时间:2026-10-12 06:52:48.0
- 原文链接:https://www.instructables.com/GTK4-NFC-Reader-App-for-the-Raspberry-Pi/
- 难度判断:中等/需要基本的电子和编程知识
- 原项目步骤数:7
- 原项目图片数:6
- Instructables 浏览数:24
- Instructables 收藏数:0
- 原项目许可:by-nc-sa
开始前准备
- 开始前,请确保工作台清洁、工具齐全、安全装备完善。建议查看原图确认PTX205R评估板和树莓派5的连接细节。
- 工具校准:确保所有工具都处于良好的工作状态,尤其是焊接铁和剥线钳。
- 安全装备:戴上防静电手环和安全眼镜,以防止静电损伤和眼部伤害。
- 材料预处理:检查PTX205R评估板和树莓派5是否有任何损伤或缺陷。确保所有材料和工具都准备就绪。
材料与工具
- Raspberry Pi 5:作为主控板,需要启用SPI功能。
- PTX205R EB:NFC读取器评估板,需要连接到树莓派5的SPI引脚。
- Raspbian OS:树莓派的操作系统,需要安装必要的软件包。
- GTK4 dev package:用于创建GTK4 GUI应用,需要安装libgtk-4-dev软件包。
- NFC Tag(s):用于测试应用的NFC标签,支持Type 2、3、4或5,RF技术A、B、F或V。
可操作步骤
步骤 1:Prepare the PTX205R Evaluation Board

准备PTX205R评估板:在PTX205R EB上焊接跳线,连接MCU OFF和PMOD_VDD到VDD_IO。同时,焊接PMOD连接器,如果没有的话。有1张图,建议查看原步骤图片确认。
步骤 2:Prepare the Raspberry Pi 5
准备树莓派5:启用SPI功能,安装必要的软件包,包括cmake和libgtk-4-dev。有0张图,建议查看原步骤文本确认。
步骤 3:Connect the Board to the Raspberry
连接板子:将PTX205R EB PMOD连接到树莓派5的SPI引脚,包括MOSI、MISO、SCK、NSS、IRQ和SEN。同时,连接GND和USB-C口。有0张图,建议查看原步骤文本确认。
步骤 4:Clone the Repository
克隆仓库:克隆RUL SDK的GitHub仓库,包括GTK GUI示例代码。有0张图,建议查看原步骤文本确认。
- 原步骤链接:https://www.instructables.com/GTK4-NFC-Reader-App-for-the-Raspberry-Pi/step4/Clone-the-Repository/
步骤 5:Build and Run

构建和运行:配置cmake,构建应用,运行应用。有1张图,建议查看原步骤图片确认。
步骤 6:Reading NFC Tags


读取NFC标签:点击START按钮,应用将显示发现的NFC标签信息。支持多个标签,但本应用未实现。有3张图,建议查看原步骤图片确认。
- 原步骤链接:https://www.instructables.com/GTK4-NFC-Reader-App-for-the-Raspberry-Pi/step6/Reading-NFC-Tags/
步骤 7:Final Words
原文这一节主要是作者的补充说明、经验记录或总结,自动稿不直接搬运原文。复刻时请打开原步骤链接查看图片、上下文和作者原说明,并把这一节当作最终检查或背景参考。
制作提醒
- 安全:在处理电子元件时,必须戴上防静电手环和安全眼镜,以防止静电损伤和眼部伤害。
- 调试:如果应用无法读取NFC标签,检查PTX205R评估板和树莓派5的连接是否正确,软件配置是否正确。
- 校准:应用不需要校准,但建议测试不同类型的NFC标签和NDEF消息,以验证应用的功能。
- 成品测试:测试应用的功能,包括读取NFC标签和NDEF消息。
验收与排错
- 验收:检查应用是否能够读取NFC标签和NDEF消息,是否能够正确显示标签信息。
- 排错:如果应用无法读取NFC标签,检查PTX205R评估板和树莓派5的连接是否正确,软件配置是否正确。
- 错误修正:如果应用出现错误,检查错误日志,根据错误信息进行修正。
- 性能优化:建议优化应用的性能,包括减少延迟和提高读取速度。
可选改造
- 支持多个NFC标签:本应用未实现多个标签的支持,建议添加此功能。
- 增加NDEF消息解析:应用仅显示NDEF消息作为UTF-8字符串,建议增加解析NDEF消息的功能。
- 添加用户界面:应用的用户界面较简单,建议添加更多功能,包括设置和关于界面。
阅读提示
这篇中文内容用于快速判断项目是否值得进一步阅读和复刻。涉及精确尺寸、电路连接、安全操作、图纸和图片细节时,请以 Instructables 原文为准:https://www.instructables.com/GTK4-NFC-Reader-App-for-the-Raspberry-Pi/