uFR Shell是一个命令行软件接口，用于在多个操作系统上执行μ FR系列硬件命令。正如软件标题所示，这是一个shell环境，具有一组由µFR读取器库定义的变量。
文档和软件下载
软件概述
软件功能:
- 定义的函数集µFR系列库和API(应用程序编程接口)。
可用的编程语言:
- 可执行的软件
支持的操作系统、平台和环境:
- Windows操作系统
- Linux操作系统
- MAC OS
- 覆盆子π
支持的标签、标签、卡片:
- 非接触式读卡器迷你®
- MIFARE Classic®(1K, 4K, EV1)
- 非接触式读卡器超轻型®
- MIFARE超轻C®
- MIFARE Plus®(2K, 4K)
- MIFARE DESFire®(Light, 2K, 4K, 8K, EV1, EV2)
- NXP NTAG®21x (210, 213, 215, 216, Tag Tamper)
- NXP NTAG®4xx DNA (413,424)
建议的硬件:
- µFR纳米
- µFR Nano Online
- µFR经典
- µFR经典CS
- µFR提前
- µFR XL
- Base HD(µFR兼容模式)
软件下载
描述
uFR Shell可执行软件允许在控制台模式下为μ FR系列设备执行命令行。
软件手册
2.uFR Shell -命令行接口
无论操作系统如何，uFR Shell软件都是作为命令终端运行的。软件版本显示在屏幕的第一行。
3.uFR Shell -软件功能
要使用uFR Shell软件在uFR设备上执行命令，您需要了解所有可用的功能。您可以在软件根文件夹UFR-Shell_list-of-functions.txt文件中找到函数列表。
请查看更多详细信息，以及功能实现和应用的说明API文档。
- uFR Shell -命令行执行
要为您的命令行选择正确的函数，我们建议首先研究函数帮助和所有函数描述。
3.2 - uFR Shell命令行执行示例
现在，让我们看看它是如何工作的。
首先，我们需要与连接的µFR读取器建立通信。我们的第一个命令是ReaderOpen。
输入命令:
- ReaderOpen
如果阅读器状态为OK，我们可以继续。否则，请检查硬件安装是否正确。
示例1
使用命令获取硬件序列号:
- GetReaderSerialNumber
如果该命令没有定义其他参数，则默认输出为HEX格式。
示例2
要获得其他格式的数据输出，需要在可用的格式模式中指定输出格式模式:
- 十六进制(参数h)，
- 字符串(参数年代）
- 小数(参数d)。
指定输出格式的命令行现在将有两个元素:
- '函数' '参数模式'
示例3
与Reader序列号一样，要获取Card ID默认输出，只需使用以下命令:
- GetCardIdEx
对于这个命令行，控制台将以默认的HEX格式显示Card类型、UID和UID输出。
示例4
Card ID输出有3个输出值。前面的示例显示了命令行中没有定义参数模式的Card ID输出
这个示例解释了如何获得混合输出格式。uFR Shell允许您为每个输出值定义特定的参数模式。
命令行应该是这样的:
-
- “函数””1。参数模式' ' 2。参数模式' ' 3。参数模式”
示例5
如果您没有在命令行中定义所有参数，那么没有指定参数模式的输出卷格式将保持HEX格式(默认)。
预期的树值和预定义的双参数模式的命令行具有以下结构:
- “函数””1。参数模式' ' 2。参数模式”
第3.2节解释了如何定义指定参数的输出值格式。但是，如果您需要经常以非十六进制格式获得输出，您可以更改所有输出值的默认格式，而不是单独定义每个参数。
对于永久输出格式更改(直到当前控制台关闭)，运行命令行:
- 设置输出“新参数模式”
上面的屏幕截图显示了预设为String (parameter)的默认输入值格式年代)。
示例1
现在让我们用简单的命令行运行测试:
- GetCardIdEx
现在输出结果是字符串值，即使命令行没有定义额外的参数模式。
如您所见，所有输出值都是带有反斜杠字符()在他们的第一个字符的地方。软件自动将此字符添加到包含不可打印字符的输出值中。
示例2
下一个示例显示了当值可打印时的字符串输出。
让我们只用可打印的字符将内容写入卡片。
命令行示例如下:
- WriteUserData“示例测试”
注意:需要记录的字符串内容在命令行中用引号括起来。
现在，读取内容输出。命令行:
-
- ReadUserData
在这种情况下，输出开头没有反斜杠字符。其余的输出内容(在先前记录的内容之后)是默认值—未使用的字节显示为xFF值。
4.uFR Shell -支持的操作系统环境中的实现差异
- Windows操作系统-在Windows系统上的实现不需要额外的权限来使用uFR Shell函数。正确安装ufr阅读器及其库就足够了。
- Linux操作系统—通常在Linux系统中，uFR Shell软件与设备通信的全部功能需要适当的用户权限。
- MacOS -为了确保软件在该操作系统上的即时功能，请复制libuRCoder。将Dylib库放入系统库文件夹中。
本手册介绍了几个基本功能的软件示例。列表中包含了所有支持的函数软件下载包。