Library Description

The library covers all the necessary functions to control AudioAmp 3 click board. A library performs a standard I2C interface communication.

Key functions:

• AUDIOAMP3_STATUS_T audioamp3_setGainLvl( uint8_t gainLvl ) - Set the gain lvl function.
• AUDIOAMP3_STATUS_T audioamp3_setChannelMuteMode( uint8_t sChannel ) - Set the mute mode of channel function.
• AUDIOAMP3_STATUS_T audioamp3_setPlayMode() - Set the play mode for all channels function.

Examples description

The application is composed of three sections :

• System Initialization - Initializes I2C, GPIO and LOG structures, set INT pins as input and RST and PWM pins as output and start to write log.
• Application Initialization - Initialization driver enables - I2C, sets: power up, channel 1 & 2 to low-low state, mute all channels, run diagnostics, hardware reset, read diagnostics and play, also write log.
• Application Task - (code snippet) This is an example which demonstrates the use of AudioAmp 3 click board. Waits for valid user input and executes functions based on set of valid commands. Results are being sent to the Usart Terminal where you can track their changes.
• Commands : '+' - volume up '-' - volume down 'P' - play 'M' - mute

void applicationTask()
{
    char receivedData;

    if ( UART_Rdy_Ptr() )
    {
        receivedData = UART_Rd_Ptr();

        switch ( receivedData )
        {
            case '+' :
            {
                for( cnt = _AUDIOAMP3_MIN_GAIN; cnt < _AUDIOAMP3_GAIN_5; cnt++ )
                {
                    statusFlag = audioamp3_setGainLvl( cnt );

                    mikrobus_logWrite( "   -  Volume Up  -", _LOG_LINE );
                    Delay_1sec();
                }
                mikrobus_logWrite( "---------------------", _LOG_LINE );
                break;
            }
            case '-' :
            {
                for( cnt = _AUDIOAMP3_MAX_GAIN; cnt > _AUDIOAMP3_GAIN_0; cnt-- )
                {
                    statusFlag = audioamp3_setGainLvl( cnt );

                    mikrobus_logWrite( "   - Volume Down -", _LOG_LINE );
                    Delay_1sec();
                }
                mikrobus_logWrite( "---------------------", _LOG_LINE );
                break;
            }
            case '=' :
            {
                audioamp3_setGainLvl( _AUDIOAMP3_MEDIUM_GAIN );
                mikrobus_logWrite( "   - Medium Vol. -", _LOG_LINE );
                mikrobus_logWrite( "---------------------", _LOG_LINE );
                break;
            }
            case 'M' :
            {
                audioamp3_setChannelMuteMode( _AUDIOAMP3_SELECT_ALL_CHANNELS );
                mikrobus_logWrite( "  Mute All Channel  ", _LOG_LINE );
                mikrobus_logWrite( "--------------------", _LOG_LINE );
                break;
            }
            case 'P' :
            {
                audioamp3_setPlayMode();
                mikrobus_logWrite( "        Play        ", _LOG_LINE );
                mikrobus_logWrite( "--------------------", _LOG_LINE );
                break;
            }
        }
    }
}

Other mikroE Libraries used in the example:

• I2C
• 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.