> For the complete documentation index, see [llms.txt](https://danielsogl.gitbook.io/awesome-cordova-plugins/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://danielsogl.gitbook.io/awesome-cordova-plugins/plugins/plugins/ble.md).

# BLE

This plugin enables communication between a phone and Bluetooth Low Energy (BLE) peripherals.

The plugin provides a simple JavaScript API for iOS and Android.

* Scan for peripherals
* Connect to a peripheral
* Read the value of a characteristic
* Write new value to a characteristic
* Get notified when characteristic's value changes

Advertising information is returned when scanning for peripherals. Service, characteristic, and property info is returned when connecting to a peripheral. All access is via service and characteristic UUIDs. The plugin manages handles internally.

Simultaneous connections to multiple peripherals are supported.

## Installation

```bash
ionic cordova plugin add cordova-plugin-ble-central
npm install @awesome-cordova-plugins/ble
```

**Plugin Repo:** <https://github.com/don/cordova-plugin-ble-central>

## Supported Platforms

* Android
* iOS

## Further Information

* [Installation Guide](/awesome-cordova-plugins/installation.md)
* [FAQ](/awesome-cordova-plugins/faq.md)