Module

Custom Simscape model of battery module

Description

The Module block represents a custom generated system model of a battery module. You can create this Simscape block by using the buildBattery function with a Module object as an input argument.

Variables

To set the priority and initial target values for the block variables prior to simulation, use the Initial Targets section in the block dialog box or Property Inspector. For more information, see Set Priority and Initial Target for Block Variables.

Nominal values provide a way to specify the expected magnitude of a variable in a model. Using system scaling based on nominal values increases the simulation robustness. Nominal values can come from different sources, one of which is the Nominal Values section in the block dialog box or Property Inspector. For more information, see System Scaling by Nominal Values.

Ports

Input

CB — Cell balancing, unitless

physical signal

Cell balancing port, specified as a physical signal.

Conserving

+ — Positive terminal

electrical

Electrical conserving port associated with the positive terminal of the battery module.

- — Negative terminal

electrical

Electrical conserving port associated with the negative terminal of the battery module.

AH — Ambient thermal port

thermal

Thermal conserving port associated with the ambient thermal path.

Dependencies

To enable this port, set the AmbientThermalPort property of the Module object to "CellBasedThermalResistance".

CH — Coolant thermal port

thermal

Thermal conserving port associated with the coolant thermal path.

Dependencies

To enable this port, set the CoolantThermalPort property of the Module object to "CellBasedThermalResistance".

CPT — Cooling plate top port

thermal array-of-nodes

Thermal conserving port used to connect the top side of the module with a cooling plate. The size of this port depends on the number of models in the system. If you set the ModelResolution property to “Lumped”, this port outputs a scalar. If you set the ModelResolution property to “Detailed”, this port outputs a vector of size equal to the number of cells in the system. If you set the ModelResolution property to “Grouped”, this port outputs a vector of size depending on the grouping strategy.

Dependencies

To enable this port, set the CoolingPlate property of the Module object to "Top".

CPB — Cooling plate bottom port

thermal array-of-nodes

Thermal conserving port used to connect the bottom side of the module with a cooling plate. The size of this port depends on the number of models in the system. If you set the ModelResolution property to “Lumped”, this port outputs a scalar. If you set the ModelResolution property to “Detailed”, this port outputs a vector of size equal to the number of cells in the system. If you set the ModelResolution property to “Grouped”, this port outputs a vector of size depending on the grouping strategy.

Dependencies

To enable this port, set the CoolingPlate property of the Module object to "Bottom".

Parameters

The parameters of this block depend on how you define the Module object that you use to generate this custom model. The block parameters are divided into these sections:

• Main

• Dynamics

• Fade

• Calendar Aging

• Thermal

• Cell Balancing

The visibility of each section also depends on the generating Module object.

For a full list of the parameters in the Main, Dynamics, Fade, and Calender Aging sections, see the Battery (Table-Based) block.

Thermal

Thermal mass — Thermal mass

100 J/K (default) | positive scalar

Energy required to raise the temperature of the thermal port by one degree.

Cell level coolant thermal path resistance — Coolant thermal path resistance at cell level

1.2 K/W (default) | positive scalar

Resistance of the coolant thermal path at cell level.

Ambient thermal path resistance — Ambient thermal path resistance at cell level

25 K/W (default) | positive scalar

Resistance of the ambient thermal path at cell level.

Parallel Assembly

Non-cell electrical resistance — Parallel assembly non-cell resistance

1 / 1000 Ohm (default) | positive scalar

Non-cell electrical resistance of each parallel assembly in the module.

Dependencies

To enable this parameter, set the NonCellResistance property of the Module object to "Yes".

Module

Non-cell electrical resistance — Module non-cell resistance

1 / 1000 Ohm (default) | positive scalar

Non-cell electrical resistance of the module.

Dependencies

To enable this parameter, set the NonCellResistance property of the Module object to "Yes".

Cell Balancing

Cell balancing switch closed resistance — Closed resistance of cell balancing switch

0.01 Ohm (default) | positive scalar

Closed resistance of the cell balancing switch.

Cell balancing switch open conductance — Open conductance of cell balancing switch

1e-8 1/Ohm (default) | positive scalar

Open conductance of the cell balancing switch.

Cell balancing switch operation threshold — Threshold for cell balancing switch operation

0.5 (default) | positive scalar

Threshold to activate the cell balancing switch operation.

Cell balancing shunt resistance — Resistance of cell balancing shunt

50 Ohm (default) | positive scalar

Resistance of the cell balancing shunt.

Version History

Introduced in R2022b