Library Description

The library covers all the necessary functions to control Buck & Boost Click board™. Library performs a standard I2C interface communication.

Key functions:

• void buckandboost_device_enable ( uint8_t state ) - Enable device function.
• (uint8_t out_value ) - Set buck output voltage function.
• (buckandboost_status_t *s_data ) - Get status function.

Examples description

The application is composed of three sections :

• System Initialization - Initializes I2C and start to write log.
• Application Initialization - Initialization driver enables - I2C, enable and wake up device, set normal mode, set Buck current limit to 1.1 A and save configuration, also write log.
• Application Task - (code snippet) This is an example which demonstrates the use of Buck & Boost Click board™. The display status is updated every 5 seconds on USART terminal while the application cycles the various voltage values on all channel outputs one by one. Vout[1] - 1.8V, Vout[2] - 1.1V, Vout[3] - 1.8V, Vout[4] - 1.05V, Vout[5] - 1.25V and Vout[6] - 9V. All data logs write on USB uart changes for every 5 sec.

void application_task ( )
{
    check_status = buckandboost_set_buck_out_voltage
    ( BUCKANDBOOST_OUTPUT_CH_1, BUCKANDBOOST_BUCK_OUTPUT_VOLTAGE_1800mV );
    Delay_ms( 10 );

    if ( check_status == BUCKANDBOOST_STATUS_OK )
    {
        mikrobus_logWrite( "  Output Voltage 1 : 1.8V   ", _LOG_LINE );
        mikrobus_logWrite( "- - - - - - - - - - - - - - ", _LOG_LINE );
    }

    buckandboost_send_cmd ( BUCKANDBOOST_CMD_SAVECONFIG );
    buckandboost_get_status ( BUCKANDBOOST_OUTPUT_CH_1, &status_data );
    display_status( );
    Delay_ms( 2000 );

    check_status = buckandboost_set_buck_out_voltage
    ( BUCKANDBOOST_OUTPUT_CH_2, BUCKANDBOOST_BUCK_OUTPUT_VOLTAGE_1100mV );
    Delay_ms( 10 );

    if ( check_status == BUCKANDBOOST_STATUS_OK )
    {
        mikrobus_logWrite( "  Output Voltage 2 : 1.1V   ", _LOG_LINE );
        mikrobus_logWrite( "- - - - - - - - - - - - - - ", _LOG_LINE );
    }

    buckandboost_send_cmd ( BUCKANDBOOST_CMD_SAVECONFIG );
    buckandboost_get_status ( BUCKANDBOOST_OUTPUT_CH_2, &status_data );
    display_status( );

    Delay_ms( 2000 );

    check_status = buckandboost_set_buck_out_voltage
    ( BUCKANDBOOST_OUTPUT_CH_3, BUCKANDBOOST_BUCK_OUTPUT_VOLTAGE_1800mV );
    Delay_ms( 10 );

    if ( check_status == BUCKANDBOOST_STATUS_OK )
    {
        mikrobus_logWrite( "  Output Voltage 3 : 1.8V   ", _LOG_LINE );
        mikrobus_logWrite( "- - - - - - - - - - - - - - ", _LOG_LINE );
    }

    buckandboost_get_status ( BUCKANDBOOST_OUTPUT_CH_3, &status_data );
    display_status( );

    Delay_ms( 2000 );

    check_status = buckandboost_set_buck_out_voltage
    ( BUCKANDBOOST_OUTPUT_CH_4, BUCKANDBOOST_BUCK_OUTPUT_VOLTAGE_1050mV );
    Delay_ms( 10 );

    if ( check_status == BUCKANDBOOST_STATUS_OK )
    {
        mikrobus_logWrite( "  Output Voltage 4 : 1.05V  ", _LOG_LINE );
        mikrobus_logWrite( "- - - - - - - - - - - - - - ", _LOG_LINE );
    }

    buckandboost_get_status ( BUCKANDBOOST_OUTPUT_CH_4, &status_data );
    display_status( );
    Delay_ms( 2000 );

    check_status = buckandboost_set_buck_out_voltage
    ( BUCKANDBOOST_OUTPUT_CH_5, BUCKANDBOOST_BUCK_OUTPUT_VOLTAGE_1250mV );
    Delay_ms( 10 );

    if ( check_status == BUCKANDBOOST_STATUS_OK )
    {
        mikrobus_logWrite( "  Output Voltage 5 : 1.25V  ", _LOG_LINE );
        mikrobus_logWrite( "- - - - - - - - - - - - - - ", _LOG_LINE );
    }
    buckandboost_get_status ( BUCKANDBOOST_OUTPUT_CH_5, &status_data );
    display_status( );
    Delay_ms( 2000 );
    
    check_status = buckandboost_set_boost_out_voltage
    ( BUCKANDBOOST_BOOST_OUTPUT_VOLTAGE_9000mV );
    Delay_ms( 10 );

    if ( check_status == BUCKANDBOOST_STATUS_OK )
    {
        mikrobus_logWrite( "  Output Voltage 6 : 9.00V   ", _LOG_LINE );
        mikrobus_logWrite( "- - - - - - - - - - - - - - ", _LOG_LINE );
    }
    buckandboost_get_status ( BUCKANDBOOST_OUTPUT_CH_6, &status_data );
    display_status( );
    Delay_ms( 2000 );
}

• void display_status ( void ) - Display status.

Other mikroE Libraries used in the example:

• I2C
• UART
• Conversions

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.