hallcurrent17  2.1.0.0
Main Page

Hall Current 17 click

Hall Current 17 Click is a compact add-on board that contains a precise solution for AC/DC current sensing. This board features the ACS37010, a high-accuracy current sensor from Allegro MicroSystems. The ACS37010 has a high operating bandwidth of 450kHz and a fast response time of 1.3μs response time. It features a highly isolated compact surface-mount package, low internal primary conductor resistance, low sensitivity error, low offset voltage over temperature, and more.

click Product page


Click library

  • Author : Nenad Filipovic
  • Date : Aug 2023.
  • Type : SPI type

Software Support

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

Standard key functions :

Example key functions :

Example Description

This example demonstrates the use of Hall Current 17 Click board™ by reading and displaying the current measurements.

The demo application is composed of two sections :

Application Init

The initialization of SPI module and log UART. After driver initialization, the app sets the default configuration.

void application_init ( void )
{
log_cfg_t log_cfg;
hallcurrent17_cfg_t hallcurrent17_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
// Click initialization.
hallcurrent17_cfg_setup( &hallcurrent17_cfg );
HALLCURRENT17_MAP_MIKROBUS( hallcurrent17_cfg, MIKROBUS_1 );
if ( SPI_MASTER_ERROR == hallcurrent17_init( &hallcurrent17, &hallcurrent17_cfg ) )
{
log_error( &logger, " Communication init." );
for ( ; ; );
}
if ( HALLCURRENT17_ERROR == hallcurrent17_default_cfg ( &hallcurrent17 ) )
{
log_error( &logger, " Default configuration." );
for ( ; ; );
}
log_info( &logger, " Application Task " );
}

Application Task

The demo application reads the current measurements [A] and displays the results. Results are being sent to the UART Terminal, where you can track their changes.

void application_task ( void )
{
static float current = 0.0;
if ( HALLCURRENT17_OK == hallcurrent17_get_current( &hallcurrent17, &current ) )
{
log_printf( &logger, " Current: %.3f [A]\r\n", current );
}
log_printf( &logger, " --------------------\r\n" );
Delay_ms ( 1000 );
}

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

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.


hallcurrent17_get_vout
err_t hallcurrent17_get_vout(hallcurrent17_t *ctx, float *adc_vout)
Hall Current 17 get Vout function.
hallcurrent17_get_vref
err_t hallcurrent17_get_vref(hallcurrent17_t *ctx, float *adc_vref)
Hall Current 17 get Vref function.
hallcurrent17_cfg_t
Hall Current 17 Click configuration object.
Definition: hallcurrent17.h:179
application_task
void application_task(void)
Definition: main.c:66
hallcurrent17_default_cfg
err_t hallcurrent17_default_cfg(hallcurrent17_t *ctx)
Hall Current 17 default configuration function.
hallcurrent17_init
err_t hallcurrent17_init(hallcurrent17_t *ctx, hallcurrent17_cfg_t *cfg)
Hall Current 17 initialization function.
hallcurrent17_get_current
err_t hallcurrent17_get_current(hallcurrent17_t *ctx, float *current)
Hall Current 17 get current function.
application_init
void application_init(void)
Definition: main.c:30
HALLCURRENT17_OK
@ HALLCURRENT17_OK
Definition: hallcurrent17.h:199
hallcurrent17_t
Hall Current 17 Click context object.
Definition: hallcurrent17.h:164
HALLCURRENT17_ERROR
@ HALLCURRENT17_ERROR
Definition: hallcurrent17.h:200
HALLCURRENT17_MAP_MIKROBUS
#define HALLCURRENT17_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition: hallcurrent17.h:150
hallcurrent17_cfg_setup
void hallcurrent17_cfg_setup(hallcurrent17_cfg_t *cfg)
Hall Current 17 configuration object setup function.