Main Content

ModuleAssembly (Generated Block)

Generated Simscape model of battery module assembly

Description

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

The ModuleAssembly subsystem model comprises four major sections.

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

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

  • The Thermal Boundary Conditions section contains the thermal boundary conditions for each Module block. The buildBattery function adds a connector port from the thermal domain and routes it to every Module 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 ModuleAssembly object.

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

Battery Modules

This figure shows the Battery Modules section for a ModuleAssembly subsystem made of two battery modules.

Output Signals

This figure shows the Output Signals section for a ModuleAssembly subsystem made of two battery modules.

Thermal Boundary Conditions

This figure shows the Thermal Boundary Conditions section for a ModuleAssembly subsystem made of two battery modules.

Balancing Signals

This figure shows the Balancing Signals section for a ModuleAssembly subsystem made of two battery modules.

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 module assembly.

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 module assembly.

State of charge at 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 module assembly.

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 module assembly.

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 module assembly.

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 module assembly. 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 module assembly.

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

Thermal conserving port associated with the ambient thermal path.

Dependencies

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

Thermal conserving port associated with the coolant thermal path.

Dependencies

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

Version History

Introduced in R2022b