# LIIONspecs.h File Reference

## Detailed Description

Li-Ion specifications.

Contains example definitions of Li-Ion battery specifications.

Application note:
  AVR458: Charging Li-Ion Batteries with BC100

Documentation:
  For comprehensive code documentation, supported compilers, compiler settings and supported devices see readme.html

Author:
  Atmel Corporation: http://www.atmel.com
  Support email: avr@atmel.com
  Original author:

$Name$

Revision
  4254

$RCSfile$

URL
  http://revisor.norway.atmel.com/AppsAVR8/avr458_Charging_Li-Ion_Batteries_with_BC100/trunk/code/IAR/LIIONspecs.h

Date
  2008-07-25 12:32:45 +0200 (fr, 25 jul 2008)

Definition in file LIIONspecs.h.

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

## Defines
#define | BAT_CELL_NUMBER 1
| Number of cells in battery.
#define | BAT_CURRENT_HYST 5
| Charge current hysteresis, in mA.
#define | BAT_CURRENT_PREQUAL 150
| Constant charge current, in mA, during prequalification mode.
#define | BAT_TEMPERATURE_MAX 45
| Maximum cell temperature (Celsius).
#define | BAT_TEMPERATURE_MIN 0
| Minimum Cell temperature (Celsius).
#define | BAT_TIME_PREQUAL 9
| Maximum time for prequalification, in minutes.
#define | BAT_VOLTAGE_HYST 10
| Charge voltage hysteresis, in mV.
#define | BAT_VOLTAGE_LOW (CELL_VOLTAGE_LOW * BAT_CELL_NUMBER)
| Minimum voltage, in mV, to consider battery charged.
#define | BAT_VOLTAGE_MAX
| Max battery voltage for temp. range T1.
#define | BAT_VOLTAGE_MAX_T0
| Max battery voltage for temp. range T0.
#define | BAT_VOLTAGE_MAX_T2
| Max battery voltage for temp. range T2.
#define | BAT_VOLTAGE_MAX_T3
| Max battery voltage for temp. range T3.
#define | BAT_VOLTAGE_MIN (CELL_VOLTAGE_MIN * BAT_CELL_NUMBER)
| Minimum voltage, in mV, to consider battery safe to charge.
#define | BAT_VOLTAGE_PREQUAL (CELL_VOLTAGE_PREQUAL * BAT_CELL_NUMBER)
| Charge voltage to achieve, in mV, during prequalification mode.
#define | CELL_VOLTAGE_LOW 4050
| Minimum voltage to consider cell charged at, in mV.
#define | CELL_VOLTAGE_MAX 4200
| Max cell voltage (for temp. range T1 if compliant with Japanese regulations).
#define | CELL_VOLTAGE_MAX_T0 4100
#define | CELL_VOLTAGE_MAX_T2 4150
| Max cell voltage for temp. range T2.
#define | CELL_VOLTAGE_MAX_T3 4100
| Max cell voltage for temp. range T3.
#define | CELL_VOLTAGE_MIN 2750
| Minimum voltage to start charging at, in mV.
#define | CELL_VOLTAGE_PREQUAL 3000
| Target voltage during prequalification, in mV.
#define | CELL_VOLTAGE_SAFETY 0
| Buffer for unmatched batteries.

## Define Documentation

#define BAT_CELL_NUMBER 1

Number of cells in battery.

Definition at line 73 of file LIIONspecs.h.

#define BAT_CURRENT_HYST 5

Charge current hysteresis, in mA.

Definition at line 89 of file LIIONspecs.h.

Referenced by ConstantCurrent(), and MaxVoltageAndCurrent().

#define BAT_CURRENT_PREQUAL 150

Constant charge current, in mA, during prequalification mode.

Note:
  This is typically lower than the main charge current.

Definition at line 86 of file LIIONspecs.h.

Referenced by Charge().

#define BAT_TEMPERATURE_MAX 45

Maximum cell temperature (Celsius).

Definition at line 76 of file LIIONspecs.h.

Referenced by Charge().

#define BAT_TEMPERATURE_MIN 0

Minimum Cell temperature (Celsius).

Definition at line 79 of file LIIONspecs.h.

Referenced by Charge().

#define BAT_TIME_PREQUAL 9

Maximum time for prequalification, in minutes.

Definition at line 82 of file LIIONspecs.h.

Referenced by Charge().

#define BAT_VOLTAGE_HYST 10

Charge voltage hysteresis, in mV.

Definition at line 92 of file LIIONspecs.h.

Referenced by ConstantVoltage(), and MaxVoltageAndCurrent().

#define BAT_VOLTAGE_LOW (CELL_VOLTAGE_LOW * BAT_CELL_NUMBER)

Minimum voltage, in mV, to consider battery charged.

Definition at line 109 of file LIIONspecs.h.

Referenced by BatteryStatusRefresh().

#define BAT_VOLTAGE_MAX

Value:

    (CELL_VOLTAGE_MAX * BAT_CELL_NUMBER) - \
                                  ((BAT_CELL_NUMBER - 1) * CELL_VOLTAGE_SAFETY)

Max battery voltage for temp. range T1.

Definition at line 99 of file LIIONspecs.h.

Referenced by Charge(), and MaxVoltageAndCurrent().

#define BAT_VOLTAGE_MAX_T0

Value:

    (CELL_VOLTAGE_MAX_T0 * BAT_CELL_NUMBER) - \
                                  ((BAT_CELL_NUMBER - 1) * CELL_VOLTAGE_SAFETY)

Max battery voltage for temp. range T0.

Definition at line 96 of file LIIONspecs.h.

Referenced by MaxVoltageAndCurrent().

#define BAT_VOLTAGE_MAX_T2

Value:

    (CELL_VOLTAGE_MAX_T2 * BAT_CELL_NUMBER) - \
                                  ((BAT_CELL_NUMBER - 1) * CELL_VOLTAGE_SAFETY)

Max battery voltage for temp. range T2.

Definition at line 102 of file LIIONspecs.h.

Referenced by MaxVoltageAndCurrent().

#define BAT_VOLTAGE_MAX_T3

Value:

    (CELL_VOLTAGE_MAX_T3 * BAT_CELL_NUMBER) - \
                                  ((BAT_CELL_NUMBER - 1) * CELL_VOLTAGE_SAFETY)

Max battery voltage for temp. range T3.

Definition at line 105 of file LIIONspecs.h.

Referenced by MaxVoltageAndCurrent().

#define BAT_VOLTAGE_MIN (CELL_VOLTAGE_MIN * BAT_CELL_NUMBER)

Minimum voltage, in mV, to consider battery safe to charge.

Definition at line 112 of file LIIONspecs.h.

Referenced by BatteryStatusRefresh().

#define BAT_VOLTAGE_PREQUAL (CELL_VOLTAGE_PREQUAL * BAT_CELL_NUMBER)

Charge voltage to achieve, in mV, during prequalification mode.

Definition at line 115 of file LIIONspecs.h.

Referenced by Charge().

#define CELL_VOLTAGE_LOW 4050

Minimum voltage to consider cell charged at, in mV.

Definition at line 59 of file LIIONspecs.h.

#define CELL_VOLTAGE_MAX 4200

Max cell voltage (for temp. range T1 if compliant with Japanese regulations).

Definition at line 54 of file LIIONspecs.h.

#define CELL_VOLTAGE_MAX_T0 4100

Max cell voltage for temp. range T0.

Definition at line 52 of file LIIONspecs.h.

#define CELL_VOLTAGE_MAX_T2 4150

Max cell voltage for temp. range T2.

Definition at line 55 of file LIIONspecs.h.

#define CELL_VOLTAGE_MAX_T3 4100

Max cell voltage for temp. range T3.

Definition at line 56 of file LIIONspecs.h.

#define CELL_VOLTAGE_MIN 2750

Minimum voltage to start charging at, in mV.

Definition at line 62 of file LIIONspecs.h.

#define CELL_VOLTAGE_PREQUAL 3000

Target voltage during prequalification, in mV.

Definition at line 65 of file LIIONspecs.h.

#define CELL_VOLTAGE_SAFETY 0

Buffer for unmatched batteries.

If we are charging a multicell battery and the cells aren't matched, we may risk overcharging at least one. Therefore, we may subtract this constant per additional cell in battery to allow for a "buffer".

Note:
  Set to 0 if batteries are properly matched.

  If this is changed to something higher than (CELL_VOLTAGE_MAX - CELL_VOLTAGE_LOW), and the number of cells is great enough, the limit BAT_VOLTAGE_LOW will become higher than BAT_VOLTAGE_MAX. This will cause the charger to keep trying to charge, but instantly finishing because the battery voltage is already at max.

Definition at line 36 of file LIIONspecs.h.