Changelogs » Adafruit-circuitpython-ble

Adafruit-circuitpython-ble

5.2.0

Add the `adafruit-blinka-bleio` dependency for basic Linux BLE scanning support.

To use in CircuitPython, simply install the [Adafruit CircuitPython bundle](https://circuitpython.org/libraries).

To use in CPython, `pip3 install adafruit-circuitpython-ble`.

Read the [docs](http://circuitpython.readthedocs.io/projects/ble/en/latest/) for info on how to use it.

5.1.1

Tweak setup.py so `adafruit_ble` has members on Raspberry Pi.

To use in CircuitPython, simply install the [Adafruit CircuitPython bundle](https://circuitpython.org/libraries).

To use in CPython, `pip3 install adafruit-circuitpython-ble`.

Read the [docs](http://circuitpython.readthedocs.io/projects/ble/en/latest/) for info on how to use it.

5.1.0

Add service data support in advertisements.

To use in CircuitPython, simply install the [Adafruit CircuitPython bundle](https://circuitpython.org/libraries).

To use in CPython, `pip3 install adafruit-circuitpython-ble`.

Read the [docs](http://circuitpython.readthedocs.io/projects/ble/en/latest/) for info on how to use it.

5.0.3

- Update `DeviceInfoService` to use latest internal API. Allow it to query a remote service.

To use in CircuitPython, simply install the [Adafruit CircuitPython bundle](https://circuitpython.org/libraries).

To use in CPython, `pip3 install adafruit-circuitpython-ble`.

Read the [docs](http://circuitpython.readthedocs.io/projects/ble/en/latest/) for info on how to use it.

5.0.2

Fix packaging so that it finds sub-packages and remove use of mocks for testing. We rely on Blinka's _bleio stubs now.

To use in CircuitPython, simply install the [Adafruit CircuitPython bundle](https://circuitpython.org/libraries).

To use in CPython, `pip3 install adafruit-circuitpython-ble`.

Read the [docs](http://circuitpython.readthedocs.io/projects/ble/en/latest/) for info on how to use it.

5.0.1

Prevent plotter example from swamping Mu with input. Fixes 57.  Thanks dglaude!

To use in CircuitPython, simply install the [Adafruit CircuitPython bundle](https://circuitpython.org/libraries).

To use in CPython, `pip3 install adafruit-circuitpython-ble`.

Read the [docs](http://circuitpython.readthedocs.io/projects/ble/en/latest/) for info on how to use it.

5.0.0

- Supply default HID descriptor for HIDService.
- Fix lazy advertising field instantiation; this fixes problems with advertising flags.
- Fix doc formatting.

To use in CircuitPython, simply install the [Adafruit CircuitPython bundle](https://circuitpython.org/libraries).

To use in CPython, `pip3 install adafruit-circuitpython-ble`.

Read the [docs](http://circuitpython.readthedocs.io/projects/ble/en/latest/) for info on how to use it.

4.0.1

This release includes:
* A fix to the way this library was packaged in PyPi. While this library is only supported for CircuitPython use, our CI wasn't able to import this as a dependency for another library.

To use in CircuitPython, simply install the [Adafruit CircuitPython bundle](https://circuitpython.org/libraries).

To use in CPython, `pip3 install adafruit-circuitpython-ble`.

Read the [docs](http://circuitpython.readthedocs.io/projects/ble/en/latest/) for info on how to use it.

4.0.0

Main Changes:
* ANCS (Apple Notification Center Service) now has its own repository, [Adafruit_CircuitPython_BLE_Apple_Notification_Center](https://github.com/adafruit/Adafruit_CircuitPython_BLE_Apple_Notification_Center)
* Magic Light also has its own repository, [Adafruit_CircuitPython_BLE_Magic_Light](https://github.com/adafruit/Adafruit_CircuitPython_BLE_Magic_Light)
* Apple Media Service (previously unimplemented) was also moved to its own repository, [Adafruit_CircuitPython_BLE_Apple_Media](https://github.com/adafruit/Adafruit_CircuitPython_BLE_Apple_Media)


Other changes:
* Repository was migrated from Travis to GitHub Actions
* Bug fixes

3.1.2

Changes in how advertising was done in CircuitPython caused this to fail. This fixes the problem.

To use in CircuitPython, simply install the [Adafruit CircuitPython bundle](https://github.com/adafruit/Adafruit_CircuitPython_Bundle).

Read the [docs](http://circuitpython.readthedocs.io/projects/ble/en/latest/) for info on how to use it.

3.1.1

To use in CircuitPython, simply install the [Adafruit CircuitPython bundle](https://github.com/adafruit/Adafruit_CircuitPython_Bundle).

Read the [docs](http://circuitpython.readthedocs.io/projects/ble/en/latest/) for info on how to use it.

3.1.0

For use with CircuitPython 5.0.0-beta.0 or later.

- Add Apple Notification Service support and example.
- Fix iOS HID.
- Add Magic Light LED lightbulb support and example.
- `Add BLERadio.name` and `BLERadio.tx_power` properties.
- Include `BLERadio.name` in advertisement scan response

This release is not compatible with CircuitPython 4.1.0. For 4.1.0, use release [1.0.2](https://github.com/adafruit/Adafruit_CircuitPython_BLE/tree/1.0.2) of this library. Due to current limitations in our library bundle packaging, the 4.x library bundle will contain this release, not the [1.0.2](https://github.com/adafruit/Adafruit_CircuitPython_BLE/tree/1.0.2) release.

To use in CircuitPython, simply install the [Adafruit CircuitPython bundle](https://github.com/adafruit/Adafruit_CircuitPython_Bundle).

Read the [docs](http://circuitpython.readthedocs.io/projects/ble/en/latest/) for info on how to use it.

3.0.0

This release is an extensive rewrite. It is compatible with CircuitPython 5.0.0-beta.0 and later. It is being released as a regular release, not as a pre-release.

This release is not compatible with CircuitPython 4.1.0. For 4.1.0, use release [1.0.2](https://github.com/adafruit/Adafruit_CircuitPython_BLE/tree/1.0.2) of this library. Due to current limitations in our library bundle packaging, the 4.x library bundle will contain this release, not the [1.0.2](https://github.com/adafruit/Adafruit_CircuitPython_BLE/tree/1.0.2) release.

- Match `_bleio` changes in CircuitPython 5.0.0-beta.0.
- Define BLE services declaratively, so that they may be used either on the client or server side of the connection.
-  Rework advertising packet construction.
- Update examples for new API, and add some new examples.
- Do a CircuitPython version check to ensure compatibility.

2.0.1alpha.2

This pre-release is compatible with CircuitPython 5.0.0-alpha.2, .3, and .4, and .5. `bleio` has been renamed to `_bleio` and there are other changes for compatibility.

2.0.1alpha.1

This pre-release is compatible with the upcoming CircuitPython 5.0.0-alpha.1 pre-release.

- Improve ble_demo_central.py example so it reconnects to any compatible peripheral after disconnect.

2.0.0alpha.1

This pre-release is compatible with the upcoming CircuitPython 5.0.0-alpha.1 pre-release.

- `advertising.py` refactored.
- Added `SolicitedAdvertisement`, for peripherals requesting services from centrals.
- Use new `properties` bitmask to set `Characteristic` properties.
- Added `CurrentTimeClient` as an useful example of a peripheral acting as a client.
- Initial BLE HID code, but it doesn't work, so don't try it.

2.0.0alpha.0

This pre-release is meant to be used with `bleio` in CircuitPython 5.0.0-alpha.0 and later. It is not backward compatible with `bleio` in CircuitPython 4.x.

- New `UART_Client` and `Scanner` functionality added.
- `UART_Server` moved from `uart.py` to `uart_server.py`.
- Refactoring of advertisement data code. Advertisements are now built in Python instead of in C.
- Various other updates and renamings.
- `Beacon` code improved.
- Examples updated.

1.0.2

Allow UARTServer.write() to write buffers of indefinite length.

1.0.1

Improve UARTServer example: now retries after connection dropped.

To use in CircuitPython, simply install the [Adafruit CircuitPython bundle](https://github.com/adafruit/Adafruit_CircuitPython_Bundle).

Read the [docs](http://circuitpython.readthedocs.io/projects/ble/en/latest/) for info on how to use it.

1.0.0

Includes:
- `LocationBeacon` - an iBeacon-style beacon
- `EddystoneURLBeacon`
- `UARTServer`  - a `Peripheral` running an implementation of the Nordic UART Service (NUS). Provides a stream interface for reading.

_[note - not yet in bundle as of the date of this release, but will be added soon]_

To use in CircuitPython, simply install the [Adafruit CircuitPython bundle](https://github.com/adafruit/Adafruit_CircuitPython_Bundle).

Read the [docs](http://circuitpython.readthedocs.io/projects/ble/en/latest/) for info on how to use it.