- 4.9.0 and master184.108.40.206.04.2
- 4.9.0 and masteriOSmacOS(Intel)macOS(ARM)LinuxtvOSwatchOS
OTA DFU Library for Mac and iOS, compatible with nRF5x SoCs
Create/Update your Podfile with the following contents
target 'YourAppTargetName' do use_frameworks! pod 'iOSDFULibrary' end
Open the newly created
Import the library to any of your classes by using
import iOSDFULibrary and begin working on your project
Create a new Cartfile in your project's root with the following contents
github "NordicSemiconductor/IOS-Pods-DFU-Library" ~> x.y //Replace x.y with your required version
Build with carthage
carthage update --platform iOS //also OSX platform is available for macOS builds
Carthage will build the iOSDFULibrary.framework and ZipFramework.framework files in Carthage/Build/, you may now copy all those files to your project and use the library, additionally, carthade also builds *.dsym files if you need to resymbolicate crash logs. you may want to keep those files bundled with your builds for future use.
For Swift Package Manager:
// swift-tools-version:5.1 import PackageDescription let package = Package( name: "<Your Product Name>", dependencies: [ .package( url: "https://github.com/NordicSemiconductor/IOS-Pods-DFU-Library", .upToNextMajor(from: "<Desired Version, e.g. 4.9.0>") ) ], targets: [.target(name: "<Your Target Name>", dependencies: ["NordicDFU"])] )
The nRF5x Series chips are flash-based SoCs, and as such they represent the most flexible solution available. A key feature of the nRF5x Series and their associated software architecture and S-Series SoftDevices is the possibility for Over-The-Air Device Firmware Upgrade (OTA-DFU). See Figure 1. OTA-DFU allows firmware upgrades to be issued and downloaded to products in the field via the cloud and so enables OEMs to fix bugs and introduce new features to products that are already out on the market. This brings added security and flexibility to product development when using the nRF5x Series SoCs.
This repository contains a tested library for iOS 8+ platform which may be used to perform Device Firmware Update on the nRF5x device using an iPhone or an iPad.
DFU library has been designed to make it very easy to include these devices into your application. It is compatible with all Bootloader/DFU versions.
In order the DFU to work with iOS, the target device MUST have the Service Changed characteristic with Indicate property in the Generic Attribute service. Without this characteristic iOS will assume that services of this device will never change and will not invalidate them after switching to DFU bootloader mode.
See the documentation for more information.
The library is compatible with nRF51 and nRF52 devices with S-Series Soft Device and the DFU Bootloader flashed on.
This library is fully backwards compatible and supports both the new and legacy DFU. The experimental buttonless DFU service from SDK 12 is supported since version 1.1.0. Due to the fact, that this experimental service from SDK 12 is not safe, you have to call dfuInitiator.enableUnsafeExperimentalButtonlessServiceInSecureDfu = true to enable it, this is off by default. Read the method documentation for details. It is recommended to use the Buttonless service from SDK 13 (for non-bonded devices, or 14 for bonded). Both are supported since DFU Library 1.3.0.
Check platform folders for mode details about compatibility for each library.
An unofficial library for both iOS and Android that is based on this library is available for React Native: react-native-nordic-dfu
A library for both iOS and Android that is based on this library is available for Flutter: flutter-nordic-dfu