nrf51osx Files

Example projects for CrossWorks CrossStudio for ARM for the nrf51822 development kits 
-------------------------------------------------------------------------------------

NOTES AND INSTALL
-----------------

These example projects are compatible with SDK V6.0.0 build 43681 *only*. 

You need CrossWorks CrossStudio for ARM V3.2, licensed (temporary eval license is fine). You then need to install the two Nordic packages CrossWorks provide. (Tool .. Package Manager)

When you have the SDK downloaded and installed, cd into the Board directory

	cd nrf51_sdk_v6_0_0_43681/nrf51822/Board

There, and only there, unzip the downloaded file

	unzip Crossworks_Examples_v6_0_0_43681.zip

It will create the following files

	nrf6310/blinky_example/crossworks/blinky_example.hzp  
	nrf6310/s110/ble_app_hrs/crossworks/ble_app_hrs.hzp  
	pca10000/blinky_example/crossworks/blinky_example.hzp  
	pca10000/s110/ble_app_hrs/crossworks/ble_app_hrs.hzp  
	pca10001/blinky_example/crossworks/blinky_example.hzp  
	pca10001/s110/ble_app_hrs/crossworks/ble_app_hrs.hzp  

Alternatively, unpack the zip file somewhere and drag in the correct subdirectory for the board/boards you want to test making sure they end up in those exact locations (the paths in the build are relative to the solution directory)


OPENING AND RUNNING THE PROJECTS
--------------------------------

Each of those is a solution you can open in Crossworks. Ensure you have the correct board, there are two examples for each board, the blinky_example is a simple app, the ble_app_hrs examples require you to put a compatible softdevice on the chip first (see below). 

To open the solution use File->Open Solution.. and select the .hzp file. Use Project->Set Active Project to ensure you have the project you want, either blinky_example or ble_app_hrs. f7 to build. 

When you've built it, Target->Connect->SEGGER JLink to attach to the Segger (once done for a given project, you rarely need to do this again). 

f5 to debug. 


SOFTDEVICE INSTALL
------------------

The softdevice required here is s110_nrf51822_7.0.0 or similar, a V7 s110 softdevice. There are two ways to install the softdevice

1) Use any of the Nordic or other tools to put the softdevice on the chip. This is recommended because you don't need to tell Crossworks where your hex file is. Alternatively ... 

2) Each of the ble_app_hrm solutions has two projects in it, one is the app called 'ble_app_hrs', the other is called 'softdevice_download'. If you look at that project's 'Project Properties' -> 'Common' you will find a property called 'Load File' which has a placeholder softdevice path in it. 

Double-click and edit the property to be the path of the softdevice .hex file on your machine, something like

	~/<path>/s110_nrf51822_7/s110_nrf51822_7.0.0_softdevice.hex

Select the current project as 'softdevice_download' using Project->Set Active Project
Target->Connect->SEGGER JLink
Target->Download softdevice_download

This will put the softdevice on the chip if you got all the steps right. Then change the project back to ble_app_hrm and you can install and debug that, the softdevice will remain on the chip.