mirror/btstack
1
0
Fork 0
mirror of https://github.com/bluekitchen/btstack.git synced 2025-01-26 03:35:20 +00:00
Code Issues Packages Projects Releases Wiki Activity
btstack/platforms/ios/README.md
Matthias Ringwald 0acdfac72b fix markup
2015-07-10 23:29:37 +02:00

1.6 KiB
Raw Blame History

BTstack for iOS

BTstack for iOS provides an alternative Bluetooth stack for iOS devices with a public API.

It supports the following Bluetooth Classic protocols:

  • L2CAP
  • RFCOMM
  • SDP

Based on these protocols, applications or daemons can implement various Bluetooth profiles. Packages that already use BTstack are: BTstack GPS, Blutrol, WeBe++, and various game emulators.

Note: As BTstack directly uses the Bluetooth hardware, the iOS Bluetooth is automatically disabled for BTstack applications & services. You can always turn BTstack off in Settings->BTstack.

Please visit the project page at GitHub for technical information and check the platform/ios subfolder.

How to develop

To write BTstack-based applications, you don't need to compile the BTstack Cydia package. You can just install it on your JB iOS device and copy /usr/lib/libBTstack.dylib into your project and add btstack/include to your project includes. See btstack/platforms/example/WiiMoteOpenGLDemo for a Xcode-base example. In general, I highly recommend to use theos to create apps & daemons for JB iOS devices instead of using Xcode.

Compile Instructions

Install the following tools:

  • Xcode 6.4 as /Applications/Xcode.app
  • Xcode 4.4.1 as /Applications/Xcode-4.4.1.app/
  • rpetrich's theos fork with "lippoplastic" support

Set the $THEOS environment variable to the location of theos, e.g. like:

export THEOS=/Projects/theos

Go to btstack/platforms/ios and run make

cd btstack
make package

If everything went right, you'll end up with a .deb package that you can install via:

make install