pwrmeter3  2.1.0.0
Main Page

PWR Meter 3 click

PWR Meter 3 Click is a compact add-on board that measures voltage and current through the connected load. This board features the ACS37800, an I2C-configurable power monitoring solution from Allegro MicroSystems, which simplifies the addition of power monitoring to many AC/DC powered systems. The ACS37800’s Hall-effect-based current sensing technology achieves reinforced isolation ratings (4800 VRMS) alongside a reliable ±90A bidirectional current sensing. It also has two LED indicators for the realization of visual detection of some anomalies in operation, such as under/overvoltage and fast overcurrent fault detection.

click Product page


Click library

  • Author : Stefan Filipovic
  • Date : Oct 2022.
  • Type : I2C type

Software Support

We provide a library for the PWR Meter 3 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 PWR Meter 3 Click driver.

Standard key functions :

Example key functions :

Example Description

This example demonstrates the use of PWR Meter 3 click board by reading and displaying the voltage, current, and power RMS measurements.

The demo application is composed of two sections :

Application Init

Initializes the driver and performs the click default configuration which sets the DC measurement

and VRMS thresholds to about 28V for overvoltage and about 9.3V for undervoltage flag.

void application_init ( void )
{
log_cfg_t log_cfg;
pwrmeter3_cfg_t pwrmeter3_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
// Click initialization.
pwrmeter3_cfg_setup( &pwrmeter3_cfg );
PWRMETER3_MAP_MIKROBUS( pwrmeter3_cfg, MIKROBUS_1 );
if ( I2C_MASTER_ERROR == pwrmeter3_init( &pwrmeter3, &pwrmeter3_cfg ) )
{
log_error( &logger, " Communication init." );
for ( ; ; );
}
if ( PWRMETER3_ERROR == pwrmeter3_default_cfg ( &pwrmeter3 ) )
{
log_error( &logger, " Default configuration." );
for ( ; ; );
}
log_info( &logger, " Application Task " );
}

Application Task

Reads the voltage and current RMS values averaged from 500 samples, then calculates the power from it

and displays the results on the USB UART. Also if an UV or OV flag is detected it will be logged accordingly.

void application_task ( void )
{
float v_rms, i_rms;
if ( PWRMETER3_OK == pwrmeter3_read_average_rms ( &pwrmeter3, &v_rms, &i_rms, PWRMETER3_DEF_AVG_SAMPLES ) )
{
if ( !pwrmeter3_get_dio0_pin ( &pwrmeter3 ) )
{
log_printf ( &logger, " Over-voltage detected!\r\n" );
}
if ( !pwrmeter3_get_dio1_pin ( &pwrmeter3 ) )
{
log_printf ( &logger, " Under-voltage detected!\r\n" );
}
log_printf ( &logger, " Voltage: %.2f V\r\n", v_rms );
log_printf ( &logger, " Current: %.2f A\r\n", i_rms );
log_printf ( &logger, " Power: %.2f W\r\n\n", i_rms * v_rms );
}
}

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

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.


pwrmeter3_init
err_t pwrmeter3_init(pwrmeter3_t *ctx, pwrmeter3_cfg_t *cfg)
PWR Meter 3 initialization function.
PWRMETER3_OK
@ PWRMETER3_OK
Definition: pwrmeter3.h:251
pwrmeter3_get_dio1_pin
uint8_t pwrmeter3_get_dio1_pin(pwrmeter3_t *ctx)
PWR Meter 3 get dio1 pin function.
pwrmeter3_get_dio0_pin
uint8_t pwrmeter3_get_dio0_pin(pwrmeter3_t *ctx)
PWR Meter 3 get dio0 pin function.
application_task
void application_task(void)
Definition: main.c:66
pwrmeter3_default_cfg
err_t pwrmeter3_default_cfg(pwrmeter3_t *ctx)
PWR Meter 3 default configuration function.
PWRMETER3_MAP_MIKROBUS
#define PWRMETER3_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition: pwrmeter3.h:194
pwrmeter3_t
PWR Meter 3 Click context object.
Definition: pwrmeter3.h:209
PWRMETER3_ERROR
@ PWRMETER3_ERROR
Definition: pwrmeter3.h:252
pwrmeter3_cfg_setup
void pwrmeter3_cfg_setup(pwrmeter3_cfg_t *cfg)
PWR Meter 3 configuration object setup function.
application_init
void application_init(void)
Definition: main.c:30
pwrmeter3_read_average_rms
err_t pwrmeter3_read_average_rms(pwrmeter3_t *ctx, float *v_rms, float *i_rms, uint16_t num_avg)
PWR Meter 3 read average rms function.
PWRMETER3_DEF_AVG_SAMPLES
#define PWRMETER3_DEF_AVG_SAMPLES
Definition: pwrmeter3.h:166
pwrmeter3_cfg_t
PWR Meter 3 Click configuration object.
Definition: pwrmeter3.h:232