nrf51-sdk

Module to contain files provided by the nordic nRF51 SDK. The latest version of this module uses files from Nordic SDK 8.1.0. The files are extracted from [here] (https://developer.nordicsemi.com/nRF51_SDK/nRF51_SDK_v8.x.x/nRF51_SDK_8.1.0_b6ed55f.zip).

Changes made to Nordic files

The files are kept the same as much as possible to the Nordic SDK. Modifications are made in order to integrate with mbed.

Porting new versions of Nordic SDK

A list of files currently requierd by mbed is maintained in script/required_files.txt. A python script is written to help porting from nordic sdk releases. required_files.txt is parsed to find a list of filenames. The script searches for these filenames in the sdk folder, and copy then into the yotta module mirroring the folder structure in the sdk. extraIncludes is automatically added to module.json to allow direct inclusion of noridc headers with just the filename.

Script usage

python pick_nrf51_files.py [options] <full-noridc-sdk-path> <nrf51-sdk-yotta-module-path>
options: --purge   : to delete all existing files and start again
         --dry-run : to list the files to be copied but not actually copy them

There are files in the sdk with the same filename but in different folder. This is dealt with by excluding certain directories. The excluded directories are listed in pick_nrf51_files.py.

After running the script, the changes in the previous section will have to be applied manually again.

Folder structure or even file name can change between releases of the nordic sdk, hence a degree of manual adjustment is needed when porting.

Using Noridc Headers

The nordic sdk is written in C and yotta modules support C++. If you are trying to include Nordic files in a cpp program, you need to use the extern "C" keyword around the includes.

extern "C" {
#include "softdevice_handler.h"
}