HumanApi

In this blogpost I will explain all steps you need to take to get a HumanApi prototype running on your iPhone and in Xcode. This article does not cover how to do the same for other types of devices but it should be fairly simple if you are familiar with the respective native platform of the device.

Video

Take a look at following video which runs through all required steps. Every step then is explained in detail in this blogpost.

Prerequisites

I have created all prototypes on a MacBook Pro running Mac OSX 10.6.2 – if you encounter issues, please visit the HumanApi forum, we’ll try to figure out the issues there

You also already have to have the btstack deamon installed on your iPhone. If you don’t have it installed this prototype won’t be able to receive Bluetooth data. There is a very good tutorial on the btstack WIKI which describes all the steps you need to take to get btstack running.

1. Clone the HumanApi git repository

$ git clone git@github.com:nonken/humanapi.git

2. Make sure all git submodules are initialized and updated

$ git submodule init
$ git submodule update

3. Create the HumanApi prototype PhoneGap project for testing

$ cd build
$ make clean
$ make tempinfo

(tempinfo is the name of the HumanApi prototype you want to test)

Setting up Xcode

Now things get a little bit complicated, if you are used to iPhone provisioning though this should be fairly simple for you. If this is completely new, go take a look at the Apple Developer pages which give you excellent material on how to set up provisioning profiles for your applications.

1. Select the correct provisioning profile in the Projects Settings.

2. Change the Bundle Identifier in the appname-Info.plist to match your provisioning profile

Adding btstack header files and dylib

Now we are almost done with the required steps, all we have to do now is tell Xcode to also include the btstack header files and dylib when compiling the app.

1. The required files are already copied over to your dev/prototypename/iphone/Plugins directory. All you need to do is make Xcode aware of them by dragging them onto the Plugins folder within Xcode.

2. Open the Project settings again and add following line to the Other C Flags field:

-I/absolutepathto/git/humanapi/prototypes/dev/ecg/iphone/Plugins

On my machine this would be:

-I/Users/nikolaionken/dev/git/humanapi/prototypes/dev/ecg/iphone/Plugins

3. Include the Bluetooth header file (this will be made easier!)

Open up Classes/appnameAppDelegate.h and add following line:

#import "Bluetooth.h"

Then open up Classes/appnameAppDelegate.m and add folowing to “webViewDidFinishLoad”:

Bluetooth *myblue = [[Bluetooth alloc] init];
[myblue initBlueTooth:theWebView];

Testing the app

1. Open up the Xcode Organizer and open the Console tab of your connected device.

2. Compile the application in Xcode and wait for it to start on your device.

3. You now should see following logs (or something similar)

... : Turn on the Arduino BT
... : Please enter PIN 12345 on remote device
... : Channel successfully opened:

This entry was posted on Saturday, January 2nd, 2010 at 2:07 pm and is filed under Tutorials. You can follow any responses to this entry through the RSS 2.0 feed. You can leave a response, or trackback from your own site.