README.md (2d04a09a69f613efe06b79a1590fde15b7c8f869) README.md (bac2979a30d414ca7ccf9c7127f8a0761e4a1ba8)
1# Welcome to BTstack
2
1# Welcome to BTstack
2
3BTstack is BlueKitchen's implementation of the official Bluetooth stack. It is well suited for small, resource-constraint devices
3BTstack is [BlueKitchen's](http://bluekitchen-gmbh.com) implementation of the official Bluetooth stack.
4It is well suited for small, resource-constraint devices
4such as 8 or 16 bit embedded systems as it is highly configurable and comes with an ultra small memory footprint.
5A minimal configuration for an SPP server on a MSP430 can run in 32 kB FLASH and only 4 kB of RAM.
6
7It connects to the Bluetooth modules via different Bluetooth HCI transport layers (e.g., HCI H4 UART and
8H5 the "Tree-Wire" protocol). The various platforms can be easily targeted by providing the necessary
9UART, CPU, and CLOCK implementations.
10
11On smaller embedded systems, a minimal run loop implementation allows to use BTstack without a Real Time OS (RTOS).
12If a RTOS is already provided, BTstack can be integrated and run as a single thread.
13
14On larger systems, BTstack provides a daemon that connects to a Bluetooth module.
15Multiple applications can communicate with this daemon over different inter-process communication methods.
16
17BTstack supports both, the Central and the Peripheral Role of Bluetooth 4.0 Low Energy specification.
18It can be configures as both a single mode or a dual mode stack.
19
5such as 8 or 16 bit embedded systems as it is highly configurable and comes with an ultra small memory footprint.
6A minimal configuration for an SPP server on a MSP430 can run in 32 kB FLASH and only 4 kB of RAM.
7
8It connects to the Bluetooth modules via different Bluetooth HCI transport layers (e.g., HCI H4 UART and
9H5 the "Tree-Wire" protocol). The various platforms can be easily targeted by providing the necessary
10UART, CPU, and CLOCK implementations.
11
12On smaller embedded systems, a minimal run loop implementation allows to use BTstack without a Real Time OS (RTOS).
13If a RTOS is already provided, BTstack can be integrated and run as a single thread.
14
15On larger systems, BTstack provides a daemon that connects to a Bluetooth module.
16Multiple applications can communicate with this daemon over different inter-process communication methods.
17
18BTstack supports both, the Central and the Peripheral Role of Bluetooth 4.0 Low Energy specification.
19It can be configures as both a single mode or a dual mode stack.
20
20For starters, download the [BTstack Manual v1.1](http://bluekitchen-gmbh.com/docs/btstack-gettingstarted-1.1.pdf)
21For starters, download the [BTstack Manual](https://github.com/bluekitchen/btstack/blob/master/docs/manual/btstack-manual.pdf)
21and look for an Architecture overview and the Getting started example for MSP430.
22
23BTstack is free for non-commercial use. For commercial use, <a href="mailto:[email protected]">tell us</a?=>
24a bit about your project to get a quote.
25The Serial Port Profile (SPP) and the Bluetooth 4.0 Low Energy Peripheral role (LE Peripheral) have been qualified with
26the Bluetooth SIG (QD ID 54558). This summer, we plan to qualify for Bluetooth Core 4.2,
27together with LE Central, PAN/BNEP and HSP.
28
29## Supported Protocols
22and look for an Architecture overview and the Getting started example for MSP430.
23
24BTstack is free for non-commercial use. For commercial use, <a href="mailto:[email protected]">tell us</a?=>
25a bit about your project to get a quote.
26The Serial Port Profile (SPP) and the Bluetooth 4.0 Low Energy Peripheral role (LE Peripheral) have been qualified with
27the Bluetooth SIG (QD ID 54558). This summer, we plan to qualify for Bluetooth Core 4.2,
28together with LE Central, PAN/BNEP and HSP.
29
30## Supported Protocols
30* L2CAP
31* RFCOMM
32* SDP
33* BNEP
34* ATT
35* SM
31* L2CAP
32* RFCOMM
33* SDP
34* BNEP
35* ATT
36* SM
36
37
38
37## Supported Profiles
39## Supported Profiles
38* GAP
39* IOP
40* SPP
41* PAN
42* GATT
43* Coming soon: HSP, HFP, and more.
40* GAP
41* IOP
42* SPP
43* PAN
44* GATT
45
46Coming soon: HSP, HFP, and more.
47
48## Supported Platforms
49Embedded Platforms |
50----------------------- |
51ez430-rf2560 |
52msp-exp430f5438-cc2564b |
53msp430f5229lp-cc2564b |
54stm32-f103rb-nucleo |
55pic32-harmony |
56
57Other Platforms |
58----------------------- |
59posix |
60libusb |
61iOS |
62mtk |
63java |
64
65## Supported Chipsets
66Chipsets | Status
67-------------- | ------
68TI CC256x | complete, incl. eHCIll support
69CSR 8811, 8510 | H4 only
70EM 9301 | experimental use on Arduino Shield
71CSR USB Dongles | complete
72Broadcom USB Dongles | complete
73