Library Description

This library allows to establish a communication with the BT Audio 2 click (BM62 module). On this way we can perform a full control of the module, such as playing songs control, EQ control, Bluetooth connection control, status reading, etc. The response reading and checking are also supported by this library. For more details, please, check full documentation.

Key functions:

• void btaudio2_response_handler_set( void ( *handler )( uint8_t*, uint16_t*, uint16_t* ) ); - This function sets handler on the function that should be performed.
• btaudio2_err_t btaudio2_make_call( uint8_t data_base, unsigned char *phone_num ); - This command is used to trigger HF action for making an outgoing call.
• btaudio2_err_t btaudio2_song_ctrl( uint8_t ctrl_byte ); - This command is used to perform the song control, such as the song volume, song selection, etc.

Examples description

The application is composed of three sections :

• System Initialization - Initializes all necessary peripherals and pins.
• Application Initialization - Initializes UART interface and performs the BTM device enabling, reset and mode configuration. Also sets a default callback function for the response checking.
• Application Task - (code snippet) - Allows user to execute a full music control, such as volume control, song control, EQ control, BT power control. Note: By using driver functions user can perform the all other module functionality. Using the selected UART terminal user can check every command and event response.

void application_task( )
{
    uint8_t rx_dat = UART_Rdy_Ptr( );

    if ( rx_dat != RX_UART_NOT_READY )
    {
        rx_dat = UART_Rd_Ptr( );
    
        switch ( rx_dat )
        {
            case 'o' :
            {
                btaudio2_power_on_off( );
            break;
            }
            case 's' :
            {
                btaudio2_play_ctrl( BTAUDIO2_STOP );
                
                mikrobus_logWrite( ">> Command: ", _LOG_TEXT );
                log_response( );
            break;
            }
            case 'p' :
            {
                btaudio2_play_ctrl( BTAUDIO2_PLAY_PAUSE );
                
                mikrobus_logWrite( ">> Command: ", _LOG_TEXT );
                log_response( );
            break;
            }
            case '4' :
            {
                btaudio2_song_ctrl( BTAUDIO2_PREV_SONG );
                
                mikrobus_logWrite( ">> Command: ", _LOG_TEXT );
                log_response( );
            break;
            }
            case '6' :
            {
                btaudio2_song_ctrl( BTAUDIO2_NEXT_SONG );
                
                mikrobus_logWrite( ">> Command: ", _LOG_TEXT );
                log_response( );
            break;
            }
            case '+' :
            {
                btaudio2_song_ctrl( BTAUDIO2_VOLUME_UP );
                
                mikrobus_logWrite( ">> Command: ", _LOG_TEXT );
                log_response( );
            break;
            }
            case '-' :
            {
                btaudio2_song_ctrl( BTAUDIO2_VOLUME_DOWN );
                
                mikrobus_logWrite( ">> Command: ", _LOG_TEXT );
                log_response( );
            break;
            }
            case 'e' :
            {
                set_eq_mode( );
                
                mikrobus_logWrite( ">> Command: ", _LOG_TEXT );
                log_response( );
            break;
            }
            default :
            {
            break;
            }
        }
    }

    check_response_ready( );
}

Additional Functions :

• collect_response - Collects a response sequence to the response buffer.
• log_response - Sends the response to the determined uart terminal.
• check_response_ready - Checks response ready flag and if the response is ready then calls the log_response function.
• set_eq_mode - Performs the changing of 10 differents EQ modes of the BTM device. The uart rx interrupt will catch every byte which was sent to the uart rx buffer on the host mcu.

Other mikroE Libraries used in the example:

• Conversions
• C_String
• 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.