uFR Shell 是一个命令行软件界面，用于在多个操作系统上执行 μFR 系列硬件命令。 正如软件标题所暗示的那样，这是一个 shell 环境，其中包含一组由 μFR 读取器库定义的变量。
Docs & Software Download
软件概述
软件功能：
- 由μFR系列库和API（应用程序编程接口）定义的一组函数。
可用的编程语言：
- 可执行软件
支持的操作系统、平台和环境：
- 视窗操作系统
- Linux 操作系统
- MAC 操作系统
- 树莓派
支持的标签、标签、卡片：
- 米法尔迷你®
- MIFARE Classic® （1K， 4K， EV1）
- MIFARE Ultralight®
- 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。
键入命令：
- 阅读器打开
如果读取器状态为“正常”，我们可以继续。 否则，请检查是否已正确安装硬件。
EXAMPLE 1
要获取硬件序列号，请使用以下命令：
- 获取阅读器序列号
如果命令未定义其他参数，则默认输出具有十六进制格式。
EXAMPLE 2
要以其他格式获取数据输出，您需要在可用格式中指定输出格式模式：
- 十六进制（参数 h），
- 字符串（参数 s）
- 十进制（参数 d）。
指定输出格式的命令行现在将有两个元素：
- '功能''参数模式。
EXAMPLE 3
与读卡器序列号一样，要获取卡 ID 默认输出，只需使用以下命令：
- GetCardIdEx
对于此命令行，控制台将以默认十六进制格式显示卡类型、UID 和 UID 输出。
EXAMPLE 4
卡 ID 输出具有树输出值。 前面的示例显示了命令行
中未定义参数模式的卡 ID 输出此示例说明如何获取混合输出格式。 uFR 外壳允许您为每个输出值定义特定的参数模式。
命令行应如下所示：
-
- “功能” “1.参数模式“ '2.参数模式' '3.参数模式'
EXAMPLE 5
如果未在命令行中定义所有参数，则没有分配参数模式的输出卷格式将保留十六进制格式（默认）。
预期树值和预定义双参数模式的命令行具有以下结构：
- “功能” “1.参数模式“ '2.参数模式'
第 3.2 节说明如何定义指定参数的输出值格式。 但是，如果需要经常以非十六进制格式获取输出，则可以更改所有输出值的默认格式，而不是单独定义每个参数。
对于永久输出格式更改（直到当前控制台关闭），请运行命令行：
- 设置输出“新参数模式”
上面的屏幕截图显示了预设为字符串（参数 s）的默认输入值格式。
EXAMPLE 1
现在让我们使用简单的命令行运行测试：
- GetCardIdEx
现在，即使命令行没有定义其他参数模式，输出结果也是字符串值。
如您所见，所有输出值都是字符串值，反斜杠字符 （） 位于其第一个字符的位置。 软件会自动将此字符添加到包含不可打印字符的输出值中。
EXAMPLE 2
下一个示例显示值可打印时的字符串输出。
让我们仅使用可打印字符将内容写入卡片中。
示例命令行为：
- WriteUserData “example-test”
注意：要记录的字符串内容在命令行中用引号引起来。
现在，阅读内容输出。 命令行为：
-
- 读取用户数据
在这种情况下，输出的开头没有反斜杠字符。 其余的输出内容（遵循先前记录的内容）是默认值 – 未使用的字节显示为xFF值。
4. uFR 外壳 – 支持的操作系统环境中的实现差异
- Windows OS – Windows 系统上的实现不需要额外的权限即可使用 uFR Shell 函数。 正确安装 ufr 阅读器及其库就足够了。
- Linux 操作系统 – 与 Linux 系统中的常规一样，uFR Shell 软件与设备通信的全部功能需要适当的用户权限。
- MacOS – 为确保此操作系统上的即时软件功能，请将 libuRCoder.dylib 库复制到系统库文件夹中。
本手册提供了具有几个基本功能的软件示例。 软件下载包中包含所有受支持功能的列表。
