mirror of
https://github.com/bluekitchen/btstack.git
synced 2024-12-28 15:20:39 +00:00
78 lines
4.1 KiB
Markdown
78 lines
4.1 KiB
Markdown
# Welcome to BTstack
|
|
|
|
BTstack is [BlueKitchen's](http://bluekitchen-gmbh.com) 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](https://github.com/bluekitchen/btstack/raw/master/docs/manual/btstack-manual.pdf)
|
|
and look for an Architecture overview and the Getting started example for MSP430.
|
|
|
|
BTstack is free for non-commercial use. For commercial use, <a href="mailto:contact@bluekitchen-gmbh.com">tell us</a>
|
|
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.
|
|
|
|
## Evaluation Platforms
|
|
|
|
#### Embedded Platforms:
|
|
* [EZ430-RF256x Bluetooth Evaluation Tool for MSP430](http://www.ti.com/tool/ez430-rf256x)
|
|
* [MSP430F5438 Experimenter Board for MSP430](http://www.ti.com/tool/msp-exp430f5438) with [Bluetooth CC2564 Module Evaluation Board](http://www.ti.com/tool/cc2564modnem)
|
|
* [MSP-EXP430F5529LP LaunchPad](http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430f5529lp.html#tabs) with [Bluetooth CC2564 Module Evaluation Board](http://www.ti.com/tool/cc2564modnem) and [EM Adapter BoosterPack](http://www.ti.com/tool/boost-ccemadapter) with additional 32768Hz quartz oscillator
|
|
* [STM32 Nucleo development board NUCLEO-F103RB](http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1847/PF259875) with [Bluetooth CC2564 Module Evaluation Board](http://www.ti.com/tool/cc2564modnem) and [EM Adapter BoosterPack](http://www.ti.com/tool/boost-ccemadapter) with additional 32768Hz quartz oscillator
|
|
* [Microchip's PIC32 Bluetooth Audio Development Kit](http://www.microchip.com/Developmenttools/ProductDetails.aspx?PartNO=DV320032)
|
|
|
|
#### 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, WL183x | complete incl. eHCIll support (chipset-cc256x)
|
|
CSR 8811, 8510 | H4 only (chipset-csr)
|
|
STM STLC2500D | working, no support for custom deep sleep management (chipset-stlc2500d)
|
|
EM 9301 | experimental use on Arduino Shield (chipset-em9301)
|
|
CSR USB Dongles | complete
|
|
Broadcom USB Dongles | complete
|
|
|
|
## Discussion and Community Support
|
|
[BTstack Google Group](http://groups.google.com/group/btstack-dev)
|