charger  2.1.0.0
Main Page

Charger click

Charger Click is a compact add-on board providing a standalone battery charger and monitor. This board features Microchip's MCP73831, a miniature single-cell, fully integrated Li-Ion, Li-Polymer charge management controller. The charge voltage of the MCP73831 is set to 4.20V, and a charge current to 250mA with an external resistor. In addition, this Click boardâ„¢ features the DS2438, a smart battery monitor that monitors the total amount of current going into and out of the battery.

click Product page


Click library

  • Author : Stefan Filipovic
  • Date : Feb 2024.
  • Type : One Wire type

Software Support

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

Standard key functions :

Example key functions :

Example Description

This example demonstrates the use of Charger click board by monitoring the battery charging status.

The demo application is composed of two sections :

Application Init

Initializes the driver, performs the click default configuration, calibrates the zero current charging offset, and resets the elapsed time counter.

void application_init ( void )
{
log_cfg_t log_cfg;
charger_cfg_t charger_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
// Click initialization.
charger_cfg_setup( &charger_cfg );
CHARGER_MAP_MIKROBUS( charger_cfg, MIKROBUS_1 );
if ( ONE_WIRE_ERROR == charger_init( &charger, &charger_cfg ) )
{
log_error( &logger, " Communication init." );
for ( ; ; );
}
if ( CHARGER_ERROR == charger_default_cfg ( &charger ) )
{
log_error( &logger, " Default configuration." );
for ( ; ; );
}
log_printf( &logger, "\r\n Zero current calibration process\r\n" );
log_printf( &logger, " Keep the battery disconnected in the next 5 seconds\r\n" );
Delay_ms ( 3000 );
{
log_error( &logger, " Calibration." );
for ( ; ; );
}
log_printf( &logger, " Calibration done!\r\n\n" );
if ( CHARGER_OK == charger_write_elapsed_time ( &charger, 0 ) )
{
log_printf( &logger, " Elapsed time reset done!\r\n\n" );
}
log_info( &logger, " Application Task " );
}

Application Task

Reads the chip internal temperature, battery and system VDD, battery charging

current, and the elapsed time counter, approximately once per second. All data are displayed on the USB UART where you can track their changes.

void application_task ( void )
{
float temperature = 0;
float batt_vdd = 0;
float system_vdd = 0;
float current = 0;
uint32_t elapsed_time = 0;
if ( CHARGER_OK == charger_read_temperature ( &charger, &temperature ) )
{
log_printf( &logger, " Temperature: %.2f degC\r\n", temperature );
}
if ( CHARGER_OK == charger_read_batt_vdd ( &charger, &batt_vdd ) )
{
log_printf( &logger, " Battery VDD: %.3f V\r\n", batt_vdd );
}
if ( CHARGER_OK == charger_read_system_vdd ( &charger, &system_vdd ) )
{
log_printf( &logger, " System VDD: %.3f V\r\n", system_vdd );
}
if ( CHARGER_OK == charger_read_current ( &charger, &current ) )
{
log_printf( &logger, " Charging current: %.3f A\r\n", current );
}
if ( CHARGER_OK == charger_read_elapsed_time ( &charger, &elapsed_time ) )
{
log_printf( &logger, " Elapsed time: %lu s\r\n\n", elapsed_time );
}
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.Charger

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.


charger_read_current
err_t charger_read_current(charger_t *ctx, float *current)
Charger read current function.
charger_write_elapsed_time
err_t charger_write_elapsed_time(charger_t *ctx, uint32_t seconds)
Charger write elapsed time function.
charger_init
err_t charger_init(charger_t *ctx, charger_cfg_t *cfg)
Charger initialization function.
charger_default_cfg
err_t charger_default_cfg(charger_t *ctx)
Charger default configuration function.
application_task
void application_task(void)
Definition: main.c:82
charger_read_elapsed_time
err_t charger_read_elapsed_time(charger_t *ctx, uint32_t *seconds)
Charger read elapsed time function.
charger_t
Charger Click context object.
Definition: charger.h:174
CHARGER_MAP_MIKROBUS
#define CHARGER_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition: charger.h:151
charger_cfg_t
Charger Click configuration object.
Definition: charger.h:188
charger_read_batt_vdd
err_t charger_read_batt_vdd(charger_t *ctx, float *voltage)
Charger read battery VDD function.
charger_calibrate_current
err_t charger_calibrate_current(charger_t *ctx)
Charger calibrate current function.
charger_read_system_vdd
err_t charger_read_system_vdd(charger_t *ctx, float *voltage)
Charger read system VDD function.
application_init
void application_init(void)
Definition: main.c:31
CHARGER_ERROR
@ CHARGER_ERROR
Definition: charger.h:204
charger_read_temperature
err_t charger_read_temperature(charger_t *ctx, float *temperature)
Charger read temperature function.
charger_cfg_setup
void charger_cfg_setup(charger_cfg_t *cfg)
Charger configuration object setup function.
CHARGER_OK
@ CHARGER_OK
Definition: charger.h:203