charger9  2.0.0.0
Main Page

Charger 9 click

Charger 9 click is a Li-Ion (Li+, Li-Po) battery charger, capable of charging one, two or three battery cells. It is based on the MAX1757, an integrated Li+ battery charger with many features that allow safe and reliable charging.

click Product page


Click library

  • Author : MikroE Team
  • Date : Dec 2019.
  • Type : GPIO type

Software Support

We provide a library for the Charger9 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 form compilers IDE(recommended way), or downloaded from our LibStock, or found on mikroE github account.

Library Description

This library contains API for Charger9 Click driver.

Standard key functions :

Example key functions :

  • Enable function

    CHARGER9_RETVAL charger9_enable ( charger9_t *ctx, CHARGER9_STATE pwr_state );

  • Fast-Charge Indicate function

    CHARGER9_RETVAL charger9_fast_charge_ind ( charger9_t *ctx );

  • Full-Charge Indicate function

    CHARGER9_RETVAL charger9_full_charge_ind ( charger9_t *ctx );

Examples Description

This application is battery charger, capable of charging one, two or three battery cells.

The demo application is composed of two sections :

Application Init

Initializes GPIO driver and turns OFF the charger as initial state.

void application_init ( void )
{
log_cfg_t log_cfg;
// Logger initialization.
log_cfg.level = LOG_LEVEL_DEBUG;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, "---- Application Init ----" );
// Click initialization.
CHARGER9_MAP_MIKROBUS( cfg, MIKROBUS_1 );
charger9_init( &charger9, &cfg );
en_flag = CHARGER9_DISABLE;
Delay_ms( 100 );
log_printf( &logger, "** Charger 9 initialization done ** \r\n" );
}

Application Task

Checks which command was sent by user and performs the selected command. Also checks the fault condition, and when fault condition is detected sends a report message to the uart terminal and turns OFF the charger.

{
CHARGER9_RETVAL charge_state;
if ( en_flag == CHARGER9_DISABLE )
{
en_flag = CHARGER9_ENABLE;
Delay_ms( 2000 );
log_printf( &logger, "** Charger 9 is enabled ** \r\n" );
}
charge_state = charger9_full_charge_ind( &charger9 );
if ( charge_state == CHARGER9_IND_ACTIVE )
{
log_printf( &logger, "** Full-Charge state ** \r\n" );
Delay_ms( 2000 );
}
charge_state = charger9_fast_charge_ind( &charger9 );
if ( charge_state == CHARGER9_IND_ACTIVE )
{
log_printf( &logger, "** Fast-Charge state ** \r\n" );
Delay_ms( 2000 );
}
charge_state = charger9_fault_ind ( &charger9 );
if ( charge_state == CHARGER9_IND_ACTIVE )
{
en_flag = CHARGER9_DISABLE;
Delay_ms( 3000 );
log_printf( &logger, "** Fault condition! ** \r\n" );
log_printf( &logger, "** Charger 9 is disabled ** \r\n" );
}
}

Note

When user sends a desired command to the charger, a report message will be sent to the uart terminal as indication to the user. The possible commands, for Charger 9 control, will be written to the uart terminal. The alarm sound will be generated on the determined commands: enable, disable and fault condition detecting.

The full application code, and ready to use projects can be installed directly form compilers IDE(recommneded) or found on LibStock page or mikroE GitHub accaunt.

Other mikroE Libraries used in the example:

  • MikroSDK.Board
  • MikroSDK.Log
  • Click.Charger9

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. The terminal available in all Mikroelektronika compilers, or any other terminal application of your choice, can be used to read the message.


charger9_fast_charge_ind
CHARGER9_RETVAL charger9_fast_charge_ind(charger9_t *ctx)
Fast-Charge Indicate function.
charger9_cfg_t
Click configuration structure definition.
Definition: charger9.h:115
CHARGER9_IND_ACTIVE
#define CHARGER9_IND_ACTIVE
Definition: charger9.h:83
CHARGER9_DISABLE
#define CHARGER9_DISABLE
Definition: charger9.h:74
CHARGER9_MAP_MIKROBUS
#define CHARGER9_MAP_MIKROBUS(cfg, mikrobus)
Definition: charger9.h:51
CHARGER9_RETVAL
#define CHARGER9_RETVAL
Definition: charger9.h:62
application_task
void application_task()
Definition: main.c:66
charger9_enable
CHARGER9_RETVAL charger9_enable(charger9_t *ctx, CHARGER9_STATE pwr_state)
Enable function.
charger9_fault_ind
CHARGER9_RETVAL charger9_fault_ind(charger9_t *ctx)
Fault Indicate function.
charger9_init
CHARGER9_RETVAL charger9_init(charger9_t *ctx, charger9_cfg_t *cfg)
Initialization function.
CHARGER9_ENABLE
#define CHARGER9_ENABLE
Definition: charger9.h:73
application_init
void application_init(void)
Definition: main.c:41
charger9_full_charge_ind
CHARGER9_RETVAL charger9_full_charge_ind(charger9_t *ctx)
Full-Charge Indicate function.
charger9_cfg_setup
void charger9_cfg_setup(charger9_cfg_t *cfg)
Config Object Initialization function.