For CircuitPython 5.0.0-beta.0 and later

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 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 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.

_bleio and other changes: for CircuitPython 5.0.0-alpha.4

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.

Improve ble_demo_central.py example

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.

Alpha release for CircuitPython 5.0.0-alpha.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.

Alpha release for CircuitPython 5.0.0-alpha.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.

Allow UARTServer.write() to write more than 20 bytes

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

Improve UARTServer example

Improve UARTServer example: now retries after connection dropped.

To use in CircuitPython, simply install the Adafruit CircuitPython bundle.

Read the docs for info on how to use it.

Initial release

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.

Read the docs for info on how to use it.