The Lithium-Ion Battery (liion) interface (

), found under the
Electrochemistry>Battery Interfaces branch (

) when adding a physics interface, is used to compute the potential and current distributions in a lithium-ion battery. Multiple intercalating electrode materials can be used, and voltage losses due to solid-electrolyte-interface (SEI) layers are also included.
Alternatively, a single-ion conductor charge balance, used by default by the Lithium-Ion Battery, Single-Ion Conductor (liion) (

) entry in the model wizard, may be used for the electrolyte. This option is typically applicable to solid electrolytes.
The cl variable is not solved for when using the single-ion conductor charge balance model.
The cs variable is solved for in an extra dimension, using an internal discretization in the particle dimension, not visible in the ordinary model geometry. The
cs dependent variable, named
liion.cs_xxx (where
xxx is the tag of the node, for instance
pce1), can be used to set for instance concentration varying diffusion coefficients in the particle. The spatial variable of the particle is named
xs_liion_xxx (for instance,
xs_liion_pce1).
The surface, center and average values of cs can also be evaluated in the real dimension by the variable names
liion.cs_surface,
liion.cs_center, and
liion.cs_average, respectively.
When this physics interface is added, these default nodes are also added to the Model Builder —
Electrolyte,
Insulation, and
Initial Values. Then, from the
Physics toolbar, add other nodes that implement, for example,
Porous Electrodes and nonporous
Electrodes, and boundary conditions. You can also right-click
Lithium-Ion Battery to select physics features from the context menu.
The Label is the default physics interface name.
The Name is used primarily as a scope prefix for variables defined by the physics interface. Refer to such physics interface variables in expressions using the pattern
<name>.<variable_name>. In order to distinguish between variables belonging to different physics interfaces, the
name string must be unique. Only letters, numbers, and underscores (_) are permitted in the
Name field. The first character must be a letter.
The default Name (for the first physics interface in the model) is
liion.
The Binary 1:1 liquid electrolyte option uses concentrated electrolyte theory to solve for the lithium salt concentration and the potential as dependent variables in the electrolyte phase. The option applicable to liquid (or plasticized) organic solvent-based lithium salt electrolytes.
The Single-ion conductor solves for the electrolyte potential by assuming that all charge in the electrolyte phase is carried by the positive lithium ions only, so that the concentration of lithium ions in the electrolyte can be assumed to be constant. The option is typically applicable to solid phase electrolytes, or electrolytes where the electrolyte conductivity is not changing as a result of the ion transport in the cell. Since the electrolyte concentration is not solved for, the single-ion conductor option reduces the computational load and complexity.
Convection can be added as an additional transport mechanism. By default, the check box
Convection is not selected. Select the check box to enable convective transport.
Note that this section is not applicable if the Single-ion conductor option is selected in the
Charge Balance Model section.
The Physics vs. Materials Reference Electrode Potential setting on the physics interface node can be used to combine material library data for current densities and equilibrium potentials with an arbitrary reference electrode scale in the physics. The setting affects the electrode potentials used for model input into the materials node, as well as all equilibrium potential values output from the materials node.
Note that the setting will only impact how potentials are interpreted in communication between the physics and the Materials node. If the From material option is not in use for equilibrium potentials or electrode kinetics, the setting has no impact.
This section is available when the Advanced Physics Options is selected in the
Show More Options dialog box shown when the
Show More Options button (

) is clicked.
To display these sections, click the Show More Options button (

) and select
Stabilization from the
Show More Options dialog box. These sections are applicable only if
Convection is selected in the
Transport Mechanisms section. There are two consistent stabilization methods available and selected by default —
Streamline diffusion and
Crosswind diffusion. There is one inconsistent stabilization method,
Isotropic diffusion, which is not selected by default.
This physics interface defines the following dependent variables (fields): the electrolyte potential, the
electrolyte salt concentration , and the
electric potential. The names can be changed but the names of fields and dependent variables must be unique within a model.