Python 3 version of Nordic Semiconductor nrfutil utility and Python library (modified by Adafruit)
adafruit-nrfutil is a Python package that includes the
adafruit-nrfutil command line utility
This package is derived from the Nordic Semiconductor ASA package https://github.com/NordicSemiconductor/pc-nrfutil, version 0.5.3. THe code has been converted from Python 2 to Python 3.
nrfutil has been renamed to
adafruit-nrfutil to distinguish it from the
This tool can be used used with the Adafruit nRF52 Feather to flash firmware images onto the device using the simple serial port.
This library is written for Python 3.5+. It is no longer Python 2 compatible!
Run the following commands to make
adafruit-nrfutil available from the command line
or to development platforms like the Arduino IDE or CircuitPython:
OS X and Linux
To install in user space in your home directory:
$ cd Adafruit_nRF52_nrfutil $ pip3 install -r requirements.txt $ python3 setup.py install --user
If you get permission errors when running
pip3 install, your
pip3 is older
or is set to try to install in the system directories. In that case use the
$ cd Adafruit_nRF52_nrfutil $ pip3 install -r --user requirements.txt $ python3 setup.py install --user
If you want to install in system directories (generally not recommended):
$ cd Adafruit_nRF52_nrfutil $ sudo pip3 install -r requirements.txt $ sudo python3 setup.py install
Note: When installing requirements if you encounter the message
Cannot uninstall 'six'. It is a distutils installed project ...,
you may need to add
--ignore-installed six when running pip.
Option 1: Pre-Built Binary
A pre-built 32-bit version of adafruit-nrfutil.exe is included as part of this repo in the
binaries/win32 folder. You can use this pre-built binary by adding it to your
Option 2: Build nrfutil from Source
Make sure that you have Python 3.5 available on your system.
To generate a self-contained Windows
.exe version of the utility (Windows only),
run these commands in a CMD window:
pip3 install pyinstaller cd Adafruit_nRF52_nrfuil pip3 install -r requirements.txt cd Adafruit_nRF52_nrfutil\nordicsemi pyinstaller __main__.py --onefile --clean --name adafruit-nrfutil
You will find the .exe in
Copy or move it elsewhere for your convenience, such as directory in your %PATH%.
To get info on the usage of adafruit-nrfutil:
To convert an nRF52 .hex file into a DFU pkg file that the serial bootloader can make use of:
adafruit-nrfutil dfu genpkg --dev-type 0x0052 --application firmware.hex dfu-package.zip
To flash a DFU pkg file over serial:
adafruit-nrfutil dfu serial --package dfu-package.zip -p /dev/tty.SLAB_USBtoUART -b 115200