mirror of
https://github.com/bluekitchen/btstack.git
synced 2025-02-04 15:39:59 +00:00
47 lines
1.6 KiB
Markdown
47 lines
1.6 KiB
Markdown
|
|
# 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](https://github.com/bluekitchen/btstack/) 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](https://github.com/rpetrich/theos) 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
|
|
|
|
|
|
|