mirror/btstack
1
0
Fork 0
mirror of https://github.com/bluekitchen/btstack.git synced 2024-12-28 15:20:39 +00:00
Code Issues Packages Projects Releases Wiki Activity
Dual-mode Bluetooth stack, with small memory footprint.
3,317 Commits 41 Branches 23 Tags 223 MiB
C 94.6%
Assembly 2%
C++ 1.1%
Makefile 0.7%
HTML 0.6%
Other 0.8%
9fdec5a4f1
Go to file
Matthias Ringwald 9fdec5a4f1 ignore .pklg files
2015-04-11 22:06:16 +02:00
ble log uuid128 instad of using printf 2015-04-10 12:39:28 +02:00
chipset-cc256x allow for vendor-specific command to set public bd addr 2015-02-10 21:30:12 +00:00
chipset-csr set HCI_NOP_DISABLE for CSR chipsets 2015-03-31 14:42:38 +02:00
chipset-em9301 fix set bd addr command for em9301 2015-02-10 22:59:00 +00:00
docs docu update: use gap_set_local_name instead of hci_write_local_name 2015-04-10 12:33:07 +02:00
example use gap_set_local_name instead of hci_write_local_name 2015-04-10 12:32:30 +02:00
eZ430-RF2560 removed old xcode project, added readme for ez430-rf2560 2014-11-15 18:04:05 +00:00
include/btstack updated docu style 2015-04-09 17:09:04 +02:00
java add java/gen to .gitignore 2015-03-30 21:35:33 +02:00
m4
MSP-EXP430F5438-CC256x remove dir after moving it to platforms 2015-03-29 21:51:51 +02:00
platforms use gap_set_local_name instead of hci_write_local_name 2015-04-10 12:32:30 +02:00
src check for blocks being freed twice 2015-04-11 22:05:44 +02:00
test renamed central_device_db* files into le_device_db* 2015-03-02 21:40:56 +00:00
tools fix match copyright 2015-02-06 16:12:25 +00:00
.gitignore ignore .pklg files 2015-04-11 22:06:16 +02:00
bootstrap.sh
config.guess
config.sub
configure.ac link against lws2_32 on mingw32 2014-11-09 21:49:42 +00:00
ltmain.sh
Makefile.am
README.md added links for embedded platforms 2015-04-10 12:08:48 +02:00

README.md

Welcome to BTstack

BTstack is BlueKitchen's implementation of the official Bluetooth stack. It is well suited for small, resource-constraint devices such as 8 or 16 bit embedded systems as it is highly configurable and comes with an ultra small memory footprint. A minimal configuration for an SPP server on a MSP430 can run in 32 kB FLASH and only 4 kB of RAM.

It connects to the Bluetooth modules via different Bluetooth HCI transport layers (e.g., HCI H4 UART and H5 the "Tree-Wire" protocol). The various platforms can be easily targeted by providing the necessary UART, CPU, and CLOCK implementations.

On smaller embedded systems, a minimal run loop implementation allows to use BTstack without a Real Time OS (RTOS). If a RTOS is already provided, BTstack can be integrated and run as a single thread.

On larger systems, BTstack provides a daemon that connects to a Bluetooth module. Multiple applications can communicate with this daemon over different inter-process communication methods.

BTstack supports both, the Central and the Peripheral Role of Bluetooth 4.0 Low Energy specification. It can be configures as both a single mode or a dual mode stack.

For starters, download the BTstack Manual and look for an Architecture overview and the Getting started example for MSP430.

BTstack is free for non-commercial use. For commercial use, tell us a bit about your project to get a quote. The Serial Port Profile (SPP) and the Bluetooth 4.0 Low Energy Peripheral role (LE Peripheral) have been qualified with the Bluetooth SIG (QD ID 54558). This summer, we plan to qualify for Bluetooth Core 4.2, together with LE Central, PAN/BNEP and HSP.

Supported Protocols

  • L2CAP
  • RFCOMM
  • SDP
  • BNEP
  • ATT
  • SM

Supported Profiles

  • GAP
  • IOP
  • SPP
  • PAN
  • GATT

Coming soon: HSP, HFP, and more.

Supported Platforms

Embedded Platforms:

Other Platforms:

  • posix: Unix-based system talking to Bluetooth module via serial port
  • libusb: Unix-based system talking via USB Bluetooth dongle
  • daemon: TCP and Unix domain named socket client-server architecture supporting multiple clients
  • java: Java wrapper for daemon
  • iOS: daemon for iOS jailbreak devices, C client-server API
  • mtk: daemon for rooted Android devices, based on Mediatek MT65xx processor, Java and C client-server API

Supported Chipsets

Chipsets Status
TI CC256x complete, incl. eHCIll support
CSR 8811, 8510 H4 only
EM 9301 experimental use on Arduino Shield
CSR USB Dongles complete
Broadcom USB Dongles complete