current9  2.1.0.0
Main Page

Current 9 click

Current 9 Click is a compact add-on board providing a precise and accurate current sensing solution. This board features the CT415-HSN830DR, high-bandwidth and ultra-low-noise XtremeSense® TMR current sensor designed for the current range up to 30A from Crocus Technology. This sensor also features an integrated current-carrying conductor which handles rated current and generates a current measurement as a linear analog output voltage, accomplishing a total output error of about ±1% full-scale. After that, the user is allowed to process the output voltage in analog or digital form.

click Product page


Click library

  • Author : Stefan Filipovic
  • Date : Aug 2022.
  • Type : ADC/I2C type

Software Support

We provide a library for the Current 9 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 Current 9 Click driver.

Standard key functions :

Example key functions :

  • current9_read_voltage This function reads raw ADC value and converts it to proportional voltage level.
    err_t current9_read_voltage ( current9_t *ctx, float *voltage );
  • current9_read_current This function reads the input current level [A] based on CURRENT9_NUM_CONVERSIONS of voltage measurements.
    err_t current9_read_current ( current9_t *ctx, float *current );
  • current9_set_vref This function sets the voltage reference for Current 9 click driver.
    err_t current9_set_vref ( current9_t *ctx, float vref );

Example Description

This example demonstrates the use of Current 9 click board by reading and displaying the input current measurements.

The demo application is composed of two sections :

Application Init

Initializes the driver and logger.

void application_init ( void )
{
log_cfg_t log_cfg;
current9_cfg_t current9_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
// Click initialization.
current9_cfg_setup( &current9_cfg );
CURRENT9_MAP_MIKROBUS( current9_cfg, MIKROBUS_1 );
err_t init_flag = current9_init( &current9, &current9_cfg );
if ( ( ADC_ERROR == init_flag ) || ( I2C_MASTER_ERROR == init_flag ) )
{
log_error( &logger, " Communication init." );
for ( ; ; );
}
log_info( &logger, " Application Task " );
}

Application Task

Reads the input current measurements and displays the results on the USB UART approximately once per second.

void application_task ( void )
{
float current = 0;
if ( CURRENT9_OK == current9_read_current ( &current9, &current ) )
{
log_printf( &logger, " Current : %.3f[A]\r\n\n", current );
Delay_ms( 1000 );
}
}

Note

For better accuracy, set the voltage reference by using the current9_set_vref function,

increase the number of conversions by modifying the CURRENT9_NUM_CONVERSIONS macro, and adjust the CURRENT9_ZERO_CURRENT_OFFSET voltage value.

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.Current9

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.


current9_cfg_t
Current 9 Click configuration object.
Definition: current9.h:147
application_task
void application_task(void)
Definition: main.c:65
current9_init
err_t current9_init(current9_t *ctx, current9_cfg_t *cfg)
Current 9 initialization function.
current9_read_current
err_t current9_read_current(current9_t *ctx, float *current)
Current 9 read current function.
current9_t
Current 9 Click context object.
Definition: current9.h:131
application_init
void application_init(void)
Definition: main.c:34
current9_cfg_setup
void current9_cfg_setup(current9_cfg_t *cfg)
Current 9 configuration object setup function.
CURRENT9_OK
@ CURRENT9_OK
Definition: current9.h:168
CURRENT9_MAP_MIKROBUS
#define CURRENT9_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition: current9.h:107
current9_set_vref
err_t current9_set_vref(current9_t *ctx, float vref)
Current 9 set vref function.
current9_read_voltage
err_t current9_read_voltage(current9_t *ctx, float *voltage)
Current 9 read voltage level function.