uFR Shell是一个命令行软件界面,用于在多个操作系统上执行μFR系列硬件命令。正如软件标题所暗示的那样,这是一个shell环境,其中包含一组由μFR读取器库定义的变量。
文档和软件下载
软件概述
软件功能:
- 由μfr系列库和api(应用程序编程接口)定义的一组函数。
可用的编程语言:
- 可执行软件
支持的操作系统、平台和环境:
- 视窗操作系统
- Linux操作系统
- MAC操作系统
- 树莓派
支持的标签、标签、卡片:
- 米法尔迷你®
- MIFARE经典®(1K, 4K, EV1)
- 非接触式读卡器超轻型®
- mifare超轻c®
- MIFARE Plus®(2K, 4K)
- MIFARE DESFire®(Light, 2K, 4K, 8K, EV1, EV2)
- 恩智浦NTAG®21x(210, 213, 215, 216,标签篡改)
- 恩智浦NTAG®4xx DNA (413,424)
推荐硬件:
- 微fr纳米
- μfr纳米在线
- 微阻燃经典
- μfr经典cs
- 微fr预付款
- 微fr xl
- 基本高清(微fr兼容模式)
软件下载
d标注
uFR Shell可执行软件可在控制台模式下为μFR系列设备执行命令行。
软件手册
2.uFR外壳-命令行界面
无论操作系统如何,uFR Shell软件都作为命令终端运行。软件版本显示在屏幕的第一行。
3.uFR外壳-软件功能
要使用uFR Shell软件在uFR设备上执行命令,您需要深入了解所有可用功能。您可以在软件根文件夹UFR-Shell_list-of-functions.txt中找到函数列表。
请在API文档中查找更多详细信息以及函数实现和应用的说明。
3.1 - uFR外壳-命令行执行
要为命令行选择正确的函数,我们建议先研究函数帮助中的所有函数说明。
3.2 - uFR外壳-命令行执行示例
现在,让我们看看它是如何工作的。
首先,我们需要与连接的μfr阅读器建立通信。因此,我们的第一个命令将是ReaderOpen。
键入命令:
- 阅读器打开
如果读取器状态为“正常”,我们可以继续。否则,请检查是否已正确安装硬件。
示例1
要获取硬件序列号,请使用以下命令:
- 获取阅读器序列号
如果命令未定义其他参数,则默认输出具有十六进制格式。
示例2
要以其他格式获取数据输出,您需要在可用格式中指定输出格式模式:
- 十六进制(参数h),
- 字符串(参数年代)
- 十进制(参数d)。
指定输出格式的命令行现在将有两个元素:
- '功能''参数模式。
示例3
与读卡器序列号一样,要获取卡id默认输出,只需使用以下命令:
- GetCardIdEx
对于此命令行,控制台将以默认十六进制格式显示卡类型,uid和uid输出。
示例4
卡id输出具有树输出值。前面的示例显示了命令行
中未定义参数模式的卡id输出此示例说明如何获取混合输出格式。uFR外壳允许您为每个输出值定义特定的参数模式。
命令行应如下所示:
-
- “功能”“1”。“参数模式”“2.参数模式”'3.参数模式'
示例5
如果未在命令行中定义所有参数,则没有分配参数模式的输出卷格式将保留十六进制格式(默认)。
预期树值和预定义双参数模式的命令行具有以下结构:
- “功能”“1”。“参数模式”“2.参数模式”
第3.2节说明如何定义指定参数的输出值格式。但是,如果需要经常以非十六进制格式获取输出,则可以更改所有输出值的默认格式,而不是单独定义每个参数。
对于永久输出格式更改(直到当前控制台关闭),请运行命令行:
- 设置输出"新参数模式"
上面的屏幕截图显示了预设为字符串(参数s)的默认输入值格式。
示例1
现在让我们使用简单的命令行运行测试:
- GetCardIdEx
现在,即使命令行没有定义其他参数模式,输出结果也是字符串值。
如您所见,所有输出值都是字符串值,反斜杠字符 () 位于其第一个字符的位置。软件会自动将此字符添加到包含不可打印字符的输出值中。
示例2
下一个示例显示值可打印时的字符串输出。
让我们仅使用可打印字符将内容写入卡片中。
示例命令行为:
- WriteUserData“示例测试”
注意:要记录的字符串内容在命令行中用引号引起来。
现在,阅读内容输出。命令行为:
-
- 读取用户数据
在这种情况下,输出的开头没有反斜杠字符。其余的输出内容(遵循先前记录的内容)是默认值-未使用的字节显示为xFF值。
4.uFR外壳-支持的操作系统环境中的实现差异
- Windows操作系统—Windows系统上的实现不需要额外的权限即可使用uFR Shell函数。正确安装ufr阅读器及其库就足够了。
- Linux操作系统——与Linux系统中的常规一样,这里壳软件与设备通信的全部功能需要适当的用户权限。
- MacOS -为确保此操作系统上的即时软件功能,请将libuRCoder。Dylib库复制到系统库文件夹中。
本手册提供了具有几个基本功能的软件示例。软件下载包中包含所有受支持功能的列表。