Bluetooth

RDA8910

On the RDA8910 chipset, BT 4.2 dual mode is available. However, Logicrom currently only supports BLE mode of operation as a GATT server and GATT client for connecting other external BLE devices.

BLE server can be used either in command line interface mode or as a Bluetooth serial port. When using in BLE serial port mode, a device file is created with the name /dev/blehost0 which supports standard IO calls similar to UART. Refer to the UART API for more information.

The SDK offers GATT client interface APIs to facilitate interaction with external BLE devices. These APIs enable various operations, including:

• Search: Discover available BLE devices in the vicinity.

• Find Services: Identify services offered by the connected BLE device.

• Find Characteristics and Descriptors: Explore specific characteristics and associated descriptors within the discovered services.

• Read/Write Characteristic: Retrieve information from or send data to the identified characteristics.

BLE API Reference

• Bluetooth LE
  • Header File
  • Functions
  • Unions
  • Structures
  • Macros
  • Type Definitions
  • Enumerations

MT2503/MT6261

On MediaTek GSM chipset, BT3.0 with EDR can work in BT host and client mode. Currently, only the SPP profile is supported by the SDK. BT host supports command line interface mode and BT serial (SPP) mode. In BT serial mode, a device file with the name /dev/bthost0 is created to use Bluetooth host as a standard UART interface. Refer to the UART API for more information.

For client mode of operation, device files are created under /dev/btclient/ after Bluetooth device search is performed. The application can initiate pairing, and standard IO operation can then be performed via system calls.

Bluetooth API Reference

• Bluetooth Classic
  • Header File
  • Functions
  • Structures
  • Macros
  • Enumerations

Note

Some ASR1603 based module has Bluetooth hardware support but it is not currently supported by Logicrom OpenCPU SDK.

Example Usage

#include <hw/bluetooth.h>

/*
 * For 4G Modules
 *
 * Initialize BT in BLE mode, with CLI enable
 */
bt_device_init(BT_LE, "Custom Name", TRUE);

/*
 * For 2G Modules
 *
 * Initialize BT in classic mode with CLI enable
 */
bt_device_init(BT_CLASSIC, "Custom Name", TRUE);