adafruit-nrfutil

adafruit-nrfutil 是一个Python包，包含 adafruit-nrfutil 命令行工具和 nordicsemi 库。

此包源自Nordic Semiconductor ASA的 pc-nrfutil 包，版本 0.5.3。代码已从Python 2转换为Python 3。

可执行文件 nrfutil 已重命名为 adafruit-nrfutil 以区别于原始可执行文件。

此工具可与 Adafruit nRF52 Feather 一起使用，通过简单的串行端口将固件映像烧录到设备上。

此库是为Python 3.5+编写的。它不再兼容Python 2！

安装

先决条件

• Python3
• pip3

运行以下命令以在命令行或Arduino IDE、CircuitPython等开发平台中使adafruit-nrfutil可用

从PyPI安装

这是推荐的方法，用于安装最新版本

$ pip3 install --user adafruit-nrfutil

从源安装

如果您在通过PyPi安装时遇到问题或想修改工具，请使用此方法。首先克隆此存储库并进入其文件夹。

$ git clone https://github.com/adafruit/Adafruit_nRF52_nrfutil.git
$ cd Adafruit_nRF52_nrfutil

注意：以下命令使用python3，但如果您在Windows上，您可能需要将其更改为python，因为Windows上Python 3.x的安装仍然使用python.exe的名称

在您的家目录中安装用户空间

$ pip3 install -r requirements.txt
$ python3 setup.py install

如果您在运行pip3 install时遇到权限错误，您的pip3可能较旧或设置为尝试在系统目录中安装。在这种情况下，请使用--user标志

$ pip3 install -r --user requirements.txt
$ python3 setup.py install

如果您想安装到系统目录中（通常不推荐）

$ sudo pip3 install -r requirements.txt
$ sudo python3 setup.py install

创建自包含的二进制文件

要生成工具的自包含可执行二进制文件（适用于Windows和MacOS），请运行以下命令

pip3 install pyinstaller
cd Adafruit_nRF52_nrfutil
pip3 install -r requirements.txt
cd Adafruit_nRF52_nrfutil\nordicsemi
pyinstaller __main__.py --onefile --clean --name adafruit-nrfutil

您将在Adafruit_nRF52_nrfutil\nordicsemi\dist\adafruit-nrfutil（如果是在Windows上，带有.exe）中找到.exe。根据您的需要将其复制或移动到其他位置，例如您的%PATH%目录。

用法

获取关于adafruit-nrfutil用法的详细信息

adafruit-nrfutil --help

将nRF52 .hex文件转换为DFU pkg文件，供串行引导加载程序使用

adafruit-nrfutil dfu genpkg --dev-type 0x0052 --application firmware.hex dfu-package.zip

通过串行线刷写DFU pkg文件

adafruit-nrfutil dfu serial --package dfu-package.zip -p /dev/tty.SLAB_USBtoUART -b 115200