Releases: gl-inet/gl-ble-sdk
Releases · gl-inet/gl-ble-sdk
v2.0.0
GL-BLE-SDK Release v2.0.0
NOTE:
Before using gl-ble-sdk release v2.0.0, please ensure that the firmware version of the device BLE module is v4.2.0. If not, it will cause the gl-ble-sdk to fail to work properly.
New Features
| Feature | Description |
|---|---|
| Multi Advertising | Support multiple broadcasts at the same time, up to 4. |
| Extended Advertising and Periodic Advertising | Support Extended Advertising. 1.Maximum 1024 bytes of data can be set for unconnectable extended advertising. 2.Maximum 191 bytes of data can be set for connectable extended advertising. Support Periodic Advertising. 1.Maximum 1024 bytes of data can be set for Periodic advertising. |
| Synchronizate to Periodic Advertising | Support synchronizate to Periodic Advertising |
| Coded phy | Support advertising transmitted on the coded phy (S=8, 125k), and scan on the coded phy. |
| Dynamic GATT DataBase | Support dynamic managing the local GATT database. |
New AIPs
| New API | Description |
|---|---|
| gl_ble_start_discovery | Start ble scanner. |
| gl_ble_start_synchronize | Start synchronize to periodic advertising. |
| gl_ble_stop_synchronize | Stop synchronize to periodic advertising. |
| gl_ble_create_adv_handle | Create advertising handle, up to 4. This handle needs to be created before starting advertising. |
| gl_ble_delete_adv_handle | Delete advertising handle. |
| gl_ble_start_legacy_adv | Start legacy advertising. |
| gl_ble_start_extended_adv | Start extended advertising. |
| gl_ble_start_periodic_adv | Start periodic advertising. |
| gl_ble_set_legacy_adv_data | To set legacy advertising packet data. |
| gl_ble_set_extended_adv_data | To set extended advertising packet data. |
| gl_ble_set_periodic_adv_data | To set periodic advertising packet data. |
| gl_ble_set_gattdb | To set dynamic GATT DataBase. |
Change APIs
| Previous API | Current API |
|---|---|
| gl_ble_discovery | gl_ble_start_discovery |
| gl_ble_start_adv | gl_ble_start_legacy_adv gl_ble_start_extended_adv gl_ble_start_periodic_adv |
| gl_ble_adv_data | gl_ble_set_legacy_adv_data gl_ble_set_extended_adv_data gl_ble_set_periodic_adv_data |
v1.4.0
GL-BLE-SDK Release v1.4.0
NOTE:
Before using gl-ble-sdk release v1.4.0, please ensure that the firmware version of the device BLE module is v2.13.10. If not, it may be cause the gl-ble-sdk to fail to work properly. In generally, the firmware of the factory default BLE module version of the device which list in README can adapt to the gl-ble-sdk release v1.4.0.
Features
| Feature | Description |
|---|---|
| BLE module switch | Support enable / disable BLE module. |
| BLE module reset | Support reset the BLE Module by hardware. |
| BLE mac address | Support view the BLE mac address. |
| TX_Power configurably | Support set the global maximum radiated TX power levels for Bluetooth. |
| Advertising | Support Legacy Advertising. Maximum 31bytes of data can be set for Legacy advertising. |
| Scanner | Support reports an advertising data or scan response packet from an advertising device that uses legacy advertising PDUs. |
| Connection | Support BLE connection. Include view the connection rssi, read or write the characteristic value, and notify the CCCD. |
AIPs
| API | Description |
|---|---|
| gl_ble_init | Init ble thread. |
| gl_ble_destroy | Destroy the ble thread and wait for thread resources to be received. |
| gl_ble_subscribe | Subscribe events generate from BLE module. |
| gl_ble_unsubscribe | Unsubscribe events generate from BLE module. |
| gl_ble_enable | Enable or disable the BLE module. |
| gl_ble_hard_reset | Hardware reset the ble modele. |
| gl_ble_get_mac | Read the Bluetooth public address used by the device. |
| gl_ble_set_power | Set the global maximum TX power for Bluetooth. |
| gl_ble_adv_data | Act as BLE slave, set user defined data in advertising packets, scan response packets or periodic advertising packets. |
| gl_ble_adv | Act as BLE slave, Set and Start legacy Avertising. |
| gl_ble_stop_adv | Act as BLE slave, stop the advertising of the given advertising set. |
| gl_ble_send_notify | Act as BLE slave, send notifications or indications to one or more remote GATT clients. |
| gl_ble_discovery | Act as master, Set and start the BLE discovery. |
| gl_ble_stop_discovery | Act as master, End the current GAP discovery procedure. |
| gl_ble_connect | Act as master, Start connect to a remote BLE device. |
| gl_ble_disconnect | Act as master, disconnect with remote device. |
| gl_ble_get_rssi | Act as master, get the latest RSSI value of a Bluetooth connection. |
| gl_ble_get_service | Act as master, Get service list of a remote GATT server. |
| gl_ble_get_char | Act as master, Get characteristic list of a remote GATT server. |
| gl_ble_read_char | Act as master, Read value of specified characteristic in a remote gatt server. |
| gl_ble_write_char | Act as master, Write value to specified characteristic in a remote gatt server. |
| gl_ble_set_notify | Act as master, Enable or disable the notification or indication of a remote gatt server. |