Library Description

This library performs a control of the Buck 13 click board, which is used to convert the input DC voltage, in the range from 6.5V to 50V, to output DC voltage of 3.3V, with maximal current of 3A. Library uses SPI serial interface to allow the ADC output reading from the Buck 13. For more details check documentation.

Key functions:

• void buck13_spiDriverInit( T_BUCK13_P gpioObj, T_BUCK13_P spiObj ) - This function initializes SPI serial interface.
• void buck13_enable( T_BUCK13_STATE pwr_state ) - This function allows user to perform a control of the Buck 13 output.
• uint16_t buck13_getVoltage( void ) - This function returns the output voltage value calculated to millivolts.

Examples description

The application is composed of three sections :

• System Initialization - Initializes peripherals and pins.
• Application Initialization - Initializes SPI serial interface and turns OFF the Buck 13 output as default state. Also writes possible commands to the uart terminal.
• Application Task - (code snippet) - Checks the command entered by user and executes the operation determined by selected command. If entered command was invalid sends a report to the uart terminal. Also the report will be sent to the uart terminal after each entered command and executed operation. Note: Input voltage range is from 6.5V to 50V Output voltage is about 3.3V Current limit is 3A.

void applicationTask()
{
    rx_dat = UART_Rdy_Ptr();
    
    if (rx_dat != 0)
    {
        rx_dat = UART_Rd_Ptr();
        
        switch (rx_dat)
        {
            case 'e' :
            {
                if (out_state == _BUCK13_DISABLE)
                {
                    buck13_enable( _BUCK13_ENABLE );
                    out_state = _BUCK13_ENABLE;
                    mikrobus_logWrite( "** Buck 13 output is enabled now.", _LOG_LINE );
                }
                else
                {
                    mikrobus_logWrite( "** Buck 13 output is already enabled.", _LOG_LINE );
                }
            break;
            }
            case 'd' :
            {
                if (out_state == _BUCK13_ENABLE)
                {
                    buck13_enable( _BUCK13_DISABLE );
                    out_state = _BUCK13_DISABLE;
                    mikrobus_logWrite( "** Buck 13 output is disabled now.", _LOG_LINE );
                }
                else
                {
                    mikrobus_logWrite( "** Buck 13 output is already disabled.", _LOG_LINE );
                }
            break;
            }
            case 'v' :
            {
                out_voltage = buck13_getVoltage();
                
                WordToStr( out_voltage, text );
                Ltrim( text );
                mikrobus_logWrite( "** VOUT = ", _LOG_TEXT );
                mikrobus_logWrite( text, _LOG_TEXT );
                mikrobus_logWrite( " mV.", _LOG_LINE );
            break;
            }
            case 'c' :
            {
                writeCmd();
            break;
            }
            default :
            {
                mikrobus_logWrite( "*****    Invalid command.    *****", _LOG_LINE );
                writeCmd();
            break;
            }
        }
    }
}

Additional Functions :

• writeCmd - Writes possible commands for the user to the uart terminal.

Other mikroE Libraries used in the example:

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