Skip to content

Releases: gl-inet/gl-ble-sdk

v2.0.0

06 Jan 12:02

Choose a tag to compare

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

06 Jan 12:02

Choose a tag to compare

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.