Getting Started with nRF Studio Go on OSX and Linux
Clone this wiki locally
Nordic's tool for creating custom services on their radios is called nRFGoStudio. It runs only on Windows. Since none of us are Windows users, we had to get it to run on OSX or Linux. Sandeep got it running using PlayOnMac](http://www.playonmac.com/en/) using the following steps.
Here's a screencapture of the whole process. The video will download because we don't know how to embed video in markdown. Patches for this accepted.
- Download and install PlayOnMac
- Download nRFGoStudio installer (32-bit) version 1.16.1. Note that 1.17.0 crashed on OS X 10.9 as of 2014-06-09, so we used 1.6.1 for stability.
- Open PlayOnMac disk image and drag PlayOnMac to the Applications folder:
- Eject the PlayOnMac disk image.
- Open PlayOnMac from the Applications folder. PlayOnMac will run you through a setup wizard: PlayOnMac requires a number of extra elements, including Microsoft fonts, XQuartz, and X11, if they're not already installed on your system. When it asks you to install those elements, let it do so, and it'll do it automatically. You'll have to agree to the end user license agreements for the fonts, XQuartz, and X11 as you go.
- When all the dependencies are installed, you'll get to the main PlayOnMac screen:
- Now you're going to install nRFGoStudio under PlayOnMac. Click on Install and you'll get the PlayOnMac Install Menu:
- Click on Install a non-listed program. PlayOnMac will instruct you to leave the default location, and to not tick the checkbox 'Run the program' if asked. Click OK to that. Next you'll get the Manual Install wizard:
- Click next, and you'll get asked to either Install a program in a new virtual drive, or to Edit or update an existing application. Choose the former:
- Then you'll be asked to name your virtual drive. We're calling ours nRFGoStudio, but you can call yours anything you want.
- When you're asked "What would you like to do before installation?", leave all options unclicked and click Next:
- PlayOnMac will now make a new virtual drive. When it's done, it'll ask you to pick a file to run. Click Browse, and you'll get a file browser. Browse to the nRFGo installer (probably in your Downloads folder) and select it. Then click Next:
- This will open up the nRFGoStudio Installer. Confirm that you want to install it, and agree to the end user license agreement:
- When you're asked to choose the setup type, pick Typical, then click Begin.
- You'll also need to install the JLink OB CDC Driver package to install virtual serial ports for PlayOnMac. Let the installer run and agree to the end user license agreement:
- When asked for the install location, you can go with the default. After that, click Install and the CDC drivers will be installed.
- Next, PlayOnMac will ask if you want to make a shortcut. Choose nRFGoStudio.exe and click Next. This will create a shortcut to launch nRFGoStudio on your Desktop, so give it any name you want, or stick with the default, nRFGoStudio:
- Finally, choose I Don't Want To Make Another Shortcut and click Next:
- You'll get the main PlayOnMac screen, with nRFGoStudio as an item you can launch. Now you're ready to launch nRFGoStudio to make some custom Bluetooth LE services.
Creating Custom Services with nRFGo Studio
The nRF8001 radio does not let you define services and characteristics directly from your Arduino code. Instead, they must be defined in nRFgo Studio.
Follow this example to generate the
services.h configuration file for the LED service example.
Once you have generated the
services.h file which defines the services and characteristics,
Add a new tab to your Arduino project containing the
Then go ahead and modify the generated
#include "hal_platform.h" #include "aci.h"
#include <stdint.h> #include <hal_platform.h> #include <aci.h>
See the LED service example for further details.