Metadata-Version: 2.1
Name: adafruit-nrfutil
Version: 0.5.3.post5
Summary: Python 3 version of Nordic Semiconductor nrfutil utility and Python library (modified by Adafruit)
Home-page: https://github.com/adafruit/Adafruit_nRF52_nrfutil
Author: Nordic Semiconductor ASA (modified by Adafruit Industries LLC)
Author-email: circuitpython@adafruit.com
License: Nordic Semicondictor proprietary license
Description: # adafruit-nrfutil
        
        `adafruit-nrfutil` is a Python package that includes the `adafruit-nrfutil` command line utility
        and the `nordicsemi` library.
        
        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.
        
        The executable `nrfutil` has been renamed to `adafruit-nrfutil` to distinguish it from the
        original executable.
        
        This tool can be used used with the [Adafruit nRF52 Feather](https://www.adafruit.com/product/3406)
        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!
        
        # Installation
        
        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
        `--user` flag:
        
        ```
        $ 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.
        
        ### Windows
        
        #### 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
        systems `$PATH` variable
        
        #### 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 `Adafruit_nRF52_nrfutil\nordicsemi\adafruit-nrfutil.exe`.
        Copy or move it elsewhere for your convenience, such as directory in your %PATH%.
        
        # Usage
        
        To get info on the usage of adafruit-nrfutil:
        
        ```
        adafruit-nrfutil --help
        ```
        
        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
        ```
        
Keywords: nordic nrf52 ble bluetooth dfu ota softdevice serialization nrfutil pc-nrfutil adafruit circuitpython
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Topic :: System :: Networking
Classifier: Topic :: System :: Hardware :: Hardware Drivers
Classifier: Topic :: Software Development :: Embedded Systems
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3.5
Description-Content-Type: text/markdown
