Library Description

The library covers all the necessary functions to control BLE 4 Click board. A library performs the communication with the NINA-B312-00B series Bluetooth® 5 low energy module via UART interface.

Key functions:

• void ble4_uartWrite( uint8_t *txData ) - UART write function.
• void ble4_setDeviceName( uint8_t *deviceName ) - Set device name setting function.
• uint8_t ble4_readByte() - Read Single Byte.

Examples description

The application is composed of three sections :

• System Initialization - Initializes UART, sets AN and INT pin as input and RST, CS and PWM pin as output and start to write log.
• Application Initialization - Initialization driver enables - UART, hardware reset BLE module, restores factory settings of the module, set device name, select data mode and start to send data.
• Application Task - (code snippet) - This is an example which demonstrates the use of BLE 4 Click board. If 'READ' - repeatedly sends string "mikroE". If 'WRITE' - receives messages from NINA-B3 series Bluetooth® 5 low energy module and LOGs received message. Results are being sent to the Usart Terminal where you can track their changes.

void applicationTask()
{
    char tmp;
    uint8_t rdyFlag;

    if ( moduleMode == _BLE4_READ_MODE )
    {
        rdyFlag = ble4_byteReady();

        if ( 1 == rdyFlag )
        {
            tmp = ble4_readByte();
            mikrobus_logWrite( &tmp, _LOG_BYTE );
        }
    }
    else if ( moduleMode == _BLE4_WRITE_MODE )
    {
        for ( cnt = 0; cnt < 9; cnt++ )
        {
            ble4_writeByte( MESSAGE_DATA[ cnt ] );
            Delay_1sec();
        }

        Delay_1sec();
    }
}

Other mikroE Libraries used in the example:

• UART

Additional notes and informations

Depending on the development board you are using, you may need USB UART click, USB UART 2 click or RS232 click to connect to your PC, for development systems with no UART to USB interface available on the board. The terminal available in all MikroElektronika compilers, or any other terminal application of your choice, can be used to read the message.