Break free from the constraints of traditional wired connections with BT121 and STM32F103RB

/*!
 * @file main.c
 * @brief BT Click Example.
 *
 * # Description
 * This example demonstrates the use of BT click board.
 *
 * The demo application is composed of two sections :
 *
 * ## Application Init
 * Initializes the driver and configures the click board.
 *
 * ## Application Task
 * Handles most of the events required for this example, the packages of events not 
 * supported in this example will be just displayed on the USB UART.
 * The event handler will display all messages sent from the remote device on the USB UART and 
 * send back the predefined response message "DONE".
 * There are two specific commands which can be sent from the remote device:
 * "led blink" - calls @b bt_led_blink function for a 5 seconds time period.
 * "check buttons" - calls @b bt_check_buttons function.
 *
 * ## Additional Function
 * - static void bt_event_handler ( bt_t *ctx )
 * - static void bt_led_blink ( bt_t *ctx )
 * - static void bt_check_buttons ( bt_t *ctx )
 *
 * @note
 * We have used the Serial Bluetooth Terminal smartphone application for the test. 
 * A smartphone and the click board must be paired in order to exchange messages with each other.
 *
 * @author Stefan Filipovic
 *
 */

#include "board.h"
#include "log.h"
#include "bt.h"

static bt_t bt;
static log_t logger;

/**
 * @brief BT event handler function.
 * @details This function handles most of the events required for this example.
 * It will respond to all messages sent from the remote device with a message "DONE".
 * There are two specific commands which can be sent from the remote device:
 * "led blink" - calls @b bt_led_blink function for a 5 seconds time frame.
 * "check buttons" - calls @b bt_check_buttons function.
 * @param[in] ctx : Click context object.
 * See #bt_t object definition for detailed explanation.
 * @return None.
 * @note The click board must be configured and the remote device must be connected to it.
 */
static void bt_event_handler ( bt_t *ctx );

/**
 * @brief BT led blink function.
 * @details This function toggles the LEDs on the click board.
 * @param[in] ctx : Click context object.
 * See #bt_t object definition for detailed explanation.
 * @param[in] time_s : LED blinking time in seconds.
 * @return None.
 * @note None.
 */
static void bt_led_blink ( bt_t *ctx, uint16_t time_s );

/**
 * @brief BT check buttons function.
 * @details This function checks all buttons state and displays the result on the USB UART.
 * @param[in] ctx : Click context object.
 * See #bt_t object definition for detailed explanation.
 * @return None.
 * @note None.
 */
static void bt_check_buttons ( bt_t *ctx );

void application_init ( void ) 
{
    log_cfg_t log_cfg;  /**< Logger config object. */
    bt_cfg_t bt_cfg;    /**< Click config object. */

    /** 
     * Logger initialization.
     * Default baud rate: 115200
     * Default log level: LOG_LEVEL_DEBUG
     * @note If USB_UART_RX and USB_UART_TX 
     * are defined as HAL_PIN_NC, you will 
     * need to define them manually for log to work. 
     * See @b LOG_MAP_USB_UART macro definition for detailed explanation.
     */
    LOG_MAP_USB_UART( log_cfg );
    log_init( &logger, &log_cfg );
    Delay_ms( 100 );
    log_info( &logger, " Application Init " );

    // Click initialization.

    bt_cfg_setup( &bt_cfg );
    BT_MAP_MIKROBUS( bt_cfg, MIKROBUS_1 );
    err_t init_flag  = bt_init( &bt, &bt_cfg );
    if ( UART_ERROR == init_flag ) 
    {
        log_error( &logger, " Application Init Error. " );
        log_info( &logger, " Please, run program again... " );

        for ( ; ; );
    }

    log_printf( &logger, " Default Config : %s\r\n\n", ( char * )
                         ( BT_OK == bt_default_cfg ( &bt ) ? "OK" : "FAIL" ) );

    log_printf( &logger, " Set Local Name : %s\r\n\n", ( char * )
                        ( BT_OK == bt_set_local_name ( &bt, "MikroE - BT click" ) ? "OK" : "FAIL" ) );
    
    log_printf( &logger, " Delete Bondings : %s\r\n\n", ( char * )
                        ( BT_OK == bt_delete_bondings ( &bt ) ? "OK" : "FAIL" ) );
    
    log_printf( &logger, " Set Bondable Mode : %s\r\n\n", ( char * )
                        ( BT_OK == bt_set_bondable_mode ( &bt, BT_SM_SET_BONDABLE_ALLOWED ) ? "OK" : "FAIL" ) );
    
    log_printf( &logger, " Set GAP Mode : %s\r\n\n", ( char * )
                        ( BT_OK == bt_set_gap_mode ( &bt, BT_GAP_MODE_CONNECTABLE, 
                                                          BT_GAP_MODE_DISCOVERABLE, 
                                                          BT_GAP_MODE_NOT_LIMITED ) ? "OK" : "FAIL" ) );
    
    log_printf( &logger, " RFCOMM Start Server : %s\r\n\n", ( char * )
                        ( BT_OK == bt_rfcomm_start_server ( &bt, BT_RFCOMM_SERVER_DEF_SDP_ID, 
                                                                 BT_RFCOMM_SERVER_DEF_STREAM_DEST ) ? "OK" : "FAIL" ) );

    log_info( &logger, " Application Task " );
}

void application_task ( void ) 
{
    bt_event_handler( &bt );
}

void main ( void ) 
{
    application_init( );

    for ( ; ; ) 
    {
        application_task( );
    }
}

static void bt_event_handler ( bt_t *ctx )
{
    bt_package_t pkg;
    
    if ( BT_OK == bt_read_package ( ctx, &pkg ) ) 
    {
        if ( BT_MSG_TYPE_EVENT == pkg.msg_type )
        {
            if ( BT_MSG_CLASS_ENDPOINT == pkg.msg_class )
            {
                if ( BT_MSG_ID_EVT_ENDPOINT_DATA == pkg.msg_id )
                {
                    log_printf( &logger, " The endpoint 0x%.2X received data: ", ( uint16_t ) pkg.payload[ 0 ] );
                    for ( uint8_t cnt = 0; cnt < pkg.payload[ 1 ]; cnt++ )
                    {
                        log_printf( &logger, "%c", pkg.payload[ cnt + 2 ] );
                    }
                    if ( memcmp ( &pkg.payload[ 2 ], "check buttons", 13 ) == 0 )
                    {
                        bt_check_buttons( ctx );
                    }
                    if ( memcmp ( &pkg.payload[ 2 ], "led blink", 9 ) == 0 )
                    {
                        bt_led_blink( ctx, 5 );
                    }
                    log_printf( &logger, " Sending the message \"DONE\" back to the remote device : %s\r\n\n", ( char * )
                                        ( BT_OK == bt_endpoint_send_data ( &bt, &pkg.payload[ 0 ], "DONE\r\n" ) ? "OK" : "FAIL" ) );
                }  
            }
            else if ( BT_MSG_CLASS_CONNECTION == pkg.msg_class )
            {
                if ( BT_MSG_ID_EVT_CONNECTION_OPENED == pkg.msg_id )
                {
                    log_printf( &logger, " Connection 0x%.2X: OPENED\r\n", ( uint16_t ) pkg.payload[ 7 ]  );
                    log_printf( &logger, " Address of remote device: " );
                    log_printf( &logger, "%.2X:%.2X:%.2X:%.2X:%.2X:%.2X\r\n", ( uint16_t ) pkg.payload[ 5 ],
                                                                              ( uint16_t ) pkg.payload[ 4 ], 
                                                                              ( uint16_t ) pkg.payload[ 3 ],
                                                                              ( uint16_t ) pkg.payload[ 2 ],
                                                                              ( uint16_t ) pkg.payload[ 1 ],
                                                                              ( uint16_t ) pkg.payload[ 0 ] );
                    log_printf( &logger, " Role of the local device : %s\r\n", ( char * )
                                        ( 0 == pkg.payload[ 6 ] ? "Peripheral" : "Central" ) );
                    
                    log_printf( &logger, " Bonded : %s\r\n\n", 
                                         0xFF == pkg.payload[ 8 ] ? "NO" : "YES" );
                }
                else if ( BT_MSG_ID_EVT_CONNECTION_CLOSED == pkg.msg_id )
                {
                    log_printf( &logger, " Connection 0x%.2X: CLOSED\r\n\n", ( uint16_t ) pkg.payload[ 2 ] );
                }
            }
            else if ( BT_MSG_CLASS_SM == pkg.msg_class )
            {
                if ( BT_MSG_ID_EVT_SM_BONDED == pkg.msg_id )
                {
                    log_printf( &logger, " Connection 0x%.2X: %s\r\n\n", 
                                         ( uint16_t ) pkg.payload[ 0 ], ( char * )
                                         ( 0xFF != pkg.payload[ 1 ] ? "BONDED" : "NOT BONDED" ) );
                }
            }
            else if ( BT_MSG_CLASS_RFCOMM == pkg.msg_class )
            {
                if ( BT_MSG_ID_EVT_RFCOMM_OPENED == pkg.msg_id )
                {
                    log_printf( &logger, " RFCOMM connection 0x%.2X: OPENED\r\n", ( uint16_t ) pkg.payload[ 0 ] );
                    log_printf( &logger, " Address of remote device: " );
                    log_printf( &logger, "%.2X:%.2X:%.2X:%.2X:%.2X:%.2X\r\n\n", ( uint16_t ) pkg.payload[ 6 ],
                                                                                ( uint16_t ) pkg.payload[ 5 ], 
                                                                                ( uint16_t ) pkg.payload[ 4 ],
                                                                                ( uint16_t ) pkg.payload[ 3 ],
                                                                                ( uint16_t ) pkg.payload[ 2 ],
                                                                                ( uint16_t ) pkg.payload[ 1 ] );
                }
                else if ( BT_MSG_ID_EVT_RFCOMM_MODEM_STATUS == pkg.msg_id )
                {
                    log_printf( &logger, " RFCOMM connection 0x%.2X status: 0x%.2X\r\n\n", 
                                         ( uint16_t ) pkg.payload[ 0 ], 
                                         ( uint16_t ) pkg.payload[ 1 ] );
                }
            }
            else
            {
                log_printf( &logger, " Message Type: 0x%.2X\r\n", ( uint16_t ) pkg.msg_type );
                log_printf( &logger, " Payload len: 0x%.2X\r\n", ( uint16_t ) pkg.payload_len );
                log_printf( &logger, " Message Class: 0x%.2X\r\n", ( uint16_t ) pkg.msg_class );
                log_printf( &logger, " Message ID: 0x%.2X\r\n", ( uint16_t ) pkg.msg_id );
                
                if ( pkg.payload_len > 0 )
                {
                    log_printf( &logger, " Payload: " );
                    for ( uint8_t cnt = 0; cnt < pkg.payload_len; cnt++ )
                    {
                        log_printf( &logger, " 0x%.2X ", ( uint16_t ) pkg.payload[ cnt ] );
                    }
                    log_printf( &logger, "\r\n\n" );
                }
            }
        }
        else
        {
            log_error( &logger, " No event message type.\r\n" );
            log_printf( &logger, " Message Type: 0x%.2X\r\n", ( uint16_t ) pkg.msg_type );
        }
    }
    else
    {
        log_error( &logger, " Reading package.\r\n" );
    }
    Delay_ms( 100 );
}

static void bt_led_blink ( bt_t *ctx, uint16_t time_s )
{
    for ( uint16_t cnt = 0; cnt < time_s; cnt++ )
    {
        bt_hardware_write_gpio ( ctx, BT_HARDWARE_CONFIG_PORT_B, 
                                      BT_HARDWARE_ALL_LEDS_PIN_MASK, 
                                      BT_HARDWARE_ALL_LEDS_PIN_MASK );
        Delay_ms ( 500 );
        bt_hardware_write_gpio ( ctx, BT_HARDWARE_CONFIG_PORT_B, 
                                      BT_HARDWARE_ALL_LEDS_PIN_MASK, 
                                      0 );
        Delay_ms ( 500 );
    }
}

static void bt_check_buttons ( bt_t *ctx )
{
    uint16_t port_data = 0;
    
    if ( BT_OK == bt_hardware_read_gpio ( ctx, BT_HARDWARE_CONFIG_PORT_B, 
                                               BT_HARDWARE_ALL_BUTTONS_PIN_MASK, 
                                               &port_data ) )
    {
        log_printf( &logger, "\r\n Buttons pressed : - " );
    
        if ( port_data & BT_HARDWARE_BUTTON1_PIN_MASK )
        {
            log_printf( &logger, "1 - " );
        }
        
        if ( port_data & BT_HARDWARE_BUTTON2_PIN_MASK )
        {
            log_printf( &logger, "2 - " );
        }
        
        if ( port_data & BT_HARDWARE_BUTTON3_PIN_MASK )
        {
            log_printf( &logger, "3 - " );
        }
        
        if ( port_data & BT_HARDWARE_BUTTON4_PIN_MASK )
        {
            log_printf( &logger, "4 - " );
        }
        
        if ( port_data & BT_HARDWARE_BUTTON5_PIN_MASK )
        {
            log_printf( &logger, "5 - " );
        }
        
        if ( ( port_data & BT_HARDWARE_ALL_BUTTONS_PIN_MASK ) == 0 )
        {
            log_printf( &logger, "None - " );
        }
        log_printf( &logger, "\r\n\n" );
    }
    else
    {
        log_error( &logger, " Reading GPIO.\r\n" );
    }
}

// ------------------------------------------------------------------------ END