profet23a

\mainpage Main Page

---

PROFET 2 3A click

PROFET 2 Click is a compact add-on board that contains a smart high-side power switch. This board features the BTS70802EPAXUMA1, a dual-channel, high-side power switch with embedded protection and diagnosis feature from Infineon Technologies.

click Product page

---

Click library

• Author : Luka Filipovic
• Date : Jun 2021.
• Type : ADC type

Software Support

We provide a library for the PROFET23A Click as well as a demo application (example), developed using MikroElektronika compilers. The demo can run on all the main MikroElektronika development boards.

Package can be downloaded/installed directly from NECTO Studio Package Manager(recommended way), downloaded from our LibStock™ or found on Mikroe github account.

Library Description

This library contains API for PROFET23A Click driver.

Standard key functions :

• profet23a_cfg_setup Config Object Initialization function.

void profet23a_cfg_setup ( profet23a_cfg_t *cfg );

• profet23a_init Initialization function.

PROFET23A_RETVAL profet23a_init ( profet23a_t *ctx, profet23a_cfg_t *cfg );

• profet23a_default_cfg Click Default Configuration function.

void profet23a_default_cfg ( profet23a_t *ctx );

Example key functions :

• profet23a_set_mode Set mode device mode for specific channel channel.

err_t profet23a_set_mode ( profet23a_t *ctx, profet23a_channel_t channel, uint8_t mode );

• profet23a_read_an_pin_voltage Read AN pin voltage level function.

err_t profet23a_read_an_pin_voltage ( profet23a_t *ctx, float *data_out );

• profet23a_set_den Set diagnostic enable pin state.

void profet23a_set_den ( profet23a_t *ctx, uint8_t state );

Example Description

This example showcases the ability of the PROFET 2 3A Click board. It configures Host MCU for communication and then enables and disables output channel. Besides that, it reads the voltage of IS pin and calculates current on output for the channel 0.

The demo application is composed of two sections :

Application Init

Initialization of the communication modules(ADC and UART) and additional pins for controlling the device.

void application_init ( void )
{
    log_cfg_t log_cfg;  /**< Logger config object. */
    profet23a_cfg_t profet23a_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 );
    log_info( &logger, " Application Init " );

    // Click initialization.
    profet23a_cfg_setup( &profet23a_cfg );
    PROFET23A_MAP_MIKROBUS( profet23a_cfg, MIKROBUS_1 );
    if ( ADC_ERROR == profet23a_init( &profet23a, &profet23a_cfg ) )
    {
        log_error( &logger, " Application Init Error. " );
        log_info( &logger, " Please, run program again... " );

        for ( ; ; );
    }
    profet23a_default_cfg ( &profet23a );
    log_info( &logger, " Application Task " );
    Delay_ms ( 1000 );
}

Application Task

On every iteration of the task device switches between DIAGNOSTIC and OFF mode while it reads the voltage of IS pin and with that calculates current on output for channel 0.

void application_task ( void ) 
{
    static uint8_t mode = PROFET23A_DIAGNOSTIC_ON;
    float profet23a_an_voltage = 0;
    
    err_t error_val = profet23a_set_mode( &profet23a, PROFET23A_CHANNEL_0, mode );
    
    if ( error_val )
    {
        log_error( &logger, "Channe/Mode" );
    }
    
    if ( PROFET23A_DIAGNOSTIC_ON == profet23a.mode )
    {
        mode = PROFET23A_MODE_OFF;
        log_printf( &logger, " > Output ON Channel %u in diagnostic mode\r\n", ( uint16_t )profet23a.channel );
        Delay_ms ( 1000 );
    }
    else
    {
        mode = PROFET23A_DIAGNOSTIC_ON;
        log_printf( &logger, " > Output OFF\r\n" );
    }

    if ( profet23a_read_an_pin_voltage ( &profet23a, &profet23a_an_voltage ) != ADC_ERROR )
    {
        log_printf( &logger, " > IS Voltage \t~ %.3f[V]\r\n", profet23a_an_voltage );
        
        float current = profet23a_an_voltage * profet23a.kilis / profet23a.rsens;
        log_printf( &logger, " > OUT Current \t~ %.3f[A]\r\n", current );
    }  
    
    log_printf( &logger, "*******************************************\r\n" );
    
    Delay_ms ( 1000 );
    Delay_ms ( 1000 );
}

Note

Formula for calculating current on load: I_load = voltage(IS) x kILIS(1800) / rsens(1.2 kΩ)

The full application code, and ready to use projects can be installed directly from NECTO Studio Package Manager(recommended way), downloaded from our LibStock™ or found on Mikroe github account.

Other Mikroe Libraries used in the example:

• MikroSDK.Board
• MikroSDK.Log
• Click.PROFET23A

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. UART terminal is available in all MikroElektronika compilers.

---