Main Content

Pack

Custom Simscape model of battery pack

Description

The Pack block is a custom generated subsystem model of a battery pack. You can create this Simscape subsystem by using the buildBattery function with a Pack object as an input argument. The Pack subsystem block is inside the Simulink library that you specify in the LibraryName argument of the buildBattery function.

The Pack subsystem model comprises four major sections.

  • The Battery Module Assemblies section displays all the ModuleAssembly subsystems defined in the Pack object. This section contains all the series and parallel electrical circuit connections between the module assemblies, as well as the additional connections to the main electrical terminals and the ModuleAssembly-to-thermal boundary conditions. If you require additional non-ModuleAssembly resistances, then the function adds and connects two additional electrical resistors here.

  • The Output signals section groups the output of each ModuleAssembly subsystem into a single multiplexed output signal for the Pack subsystem.

  • The Thermal Boundary Conditions section contains the thermal boundary conditions for each ModuleAssembly subsystem. The buildBattery function adds a connector port from the thermal domain and routes it to every ModuleAssembly subsystem according to the specified thermal boundary conditions. This section is optional and only appears if you define an ambient or coolant thermal path in the Pack object.

  • The Balancing Signals section contains the routing of the cell balancing control signal from the battery management system to every ModuleAssembly subsystem. Selector blocks route the correct elements of the control signal to their corresponding ParallelAssembly blocks.

Battery Module Assemblies

This figure shows the Battery Module Assemblies section for a Pack subsystem made of four battery module assemblies.

Output Signals

This figure shows the Output Signals section for a Pack subsystem made of four battery module assemblies.

Thermal Boundary Conditions

This figure shows the Thermal Boundary Conditions section for a Pack subsystem made of four battery module assemblies.

Balancing Signals

This figure shows the Balancing Signals section for a Pack subsystem made of four battery module assemblies.

Ports

Input

expand all

Switch control port for the balancing strategy, specified as a scalar.

Output

expand all

Current at the cell level. The original signal units from the Module block are Amperes. The size of this signal is equal to the total number of cells in the pack.

Cell-level number of cycles related to battery aging. The original signal units from the Module block are unitless. The size of this signal is equal to the total number of cells in the pack.

State of charge at the cell level. The original signal units from the Module block are unitless and the value typically varies between 0 and 1. The size of this signal is equal to the total number of cells in the pack.

State of charge at the parallel assembly level. The original signal units from the Module block are unitless and the value typically varies between 0 and 1. The size of this signal is equal to the total number of parallel assemblies in the module assembly.

Temperature at the cell level. The original signal units from the Module block are kelvin. The size of this signal is equal to the total number of cells in the pack.

Dependencies

To enable this port, enable the thermal port of the cells that comprise the pack. To model the thermal port of the cells, in the CellModelBlock property of the cells, set the thermal_port parameter of the BlockParameters property to "Model".

Voltages at the cell level. The original signal units from the Module block are volts. The size of this signal is equal to the total number of cells in the pack.

Voltages at the parallel assembly level. The original signal units from the Module block are volts. The size of this signal is equal to the total number of parallel assemblies in the pack. Use this signal as an input to the battery management system (BMS) blocks of Simscape Battery.

Conserving

expand all

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

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

Thermal conserving port associated with the ambient thermal path.

Dependencies

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

Thermal conserving port associated with the coolant thermal path.

Dependencies

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

Version History

Introduced in R2022b