Make all existing unit tests pass.

Author: Isaac-Ito-MW

ChangeLog.md

@@ -1,6 +1,28 @@
 # Change Log
 
-## Version 1.3 (2022)
+## Version 1.4 - In Development
+
+*This version is in development and maybe broken* ;)
+
+Features
+
+- Simulink Connection Bus for Simscape,
+  which was newly introduced in R2021b,
+  is used to define high-voltage line connection for Simscape Bus.
+  Connection Bus definition makes the use of Simscape Bus more robust.
+
+Models
+
+- High-voltage battery component has two new referenced subsystems,
+  and now there are 3 models.
+  First one is a simple iosthermal model as included from the first release.
+  Second one (new in this version) uses System-Level Battery block
+  from Simscape Driveline, and it can simulate battery temeprature.
+  Third one (new in this version) uses Battery block
+  from Simscape Electrical, and it can simulate more
+  battery characteristics such as fade.
+
+## Version 1.3 (April, 2022)
 
 MATLAB Release
 
@@ -24,7 +46,7 @@ GitHub Repository
 - GitHub Pages is enabled:
   https://mathworks.github.io/Simscape-Hybrid-Electric-Vehicle-Model/
 
-## Version 1.2 (2022)
+## Version 1.2 (April, 2022)
 
 MATLAB Release
 
@@ -102,7 +124,7 @@ Other updates
 
 - Refactored many folders, models, and scripts.
 
-## Version 1.1 (2021)
+## Version 1.1 (November, 2021)
 
 MATLAB Release
 
@@ -120,3 +142,7 @@ Highlights
     showing the workflow as well as real-time application.
     - Real-Time application presented in the video will be added
       to this project in future updates.
+
+## Version 1.0 (May, 2021)
+
+Initial release.

Components/BatteryHighVoltage/BatteryHV_main_script.mlx

@@ -0,0 +1,35 @@
+# Component / High Voltage Battery
+
+Component to simulate the electrical
+(and optionally thermal) dynamics
+of a high voltage battery pack.
+
+The most basic version `BatteryHV_refsub_Basic` computes
+the voltage and current of the battery
+with no temperature dependence.
+
+To consider the battery temperature,
+`BatteryHV_refsub_Driveline` uses
+the [Battery block from Simscape Driveline][url-drv-batt].
+
+[url-drv-batt]: https://www.mathworks.com/help/physmod/sdl/ref/batterysystemlevel.html
+
+For more battery behaviors such aging,
+`BatteryHV_refsub_Electrical` uses
+the [Battery block from Simscape Electrical][url-elec-batt]
+
+[url-elec-batt]: https://www.mathworks.com/help/physmod/sps/ref/battery.html
+
+## Harness Model
+
+<img src="images/image_BatteryHV_harness_model.png"
+ width="700" alt="Harness Model for High Voltage Battery Component">
+
+## Main Component Subsystem
+
+Basic version
+
+<img src="images/image_BatteryHV_refsub_Basic.png"
+ width="700" alt="Vehicle 1D Component">
+
+*Copyright 2022 The MathWorks, Inc.*

Components/BatteryHighVoltage/BatteryHVBasic_refsub.mdl renamed to Components/BatteryHighVoltage/BatteryHV_refsub_Basic.mdl

@@ -0,0 +1,84 @@
+%% Model Parameters for High Voltage Battery Harness Model
+% This script is run automatically when harness model opens.
+% If you edit this file, make sure to run this to update variables
+% before running harness model for simulation.
+
+% Copyright 2022 The MathWorks, Inc.
+
+%% Load bus defition
+
+defineBus_HighVoltage
+
+%% Input signals and related parameters
+
+battSigBuilder = BatteryHV_InputSignalBuilder;
+
+batteryHV_InputData = Discharge(battSigBuilder);
+
+% For the From Workspace block
+batteryHV_InputSignals = batteryHV_InputData.Signals;
+batteryHV_InputBus = batteryHV_InputData.Bus;
+
+% Simulation stop time
+t_end = batteryHV_InputData.Options.StopTime_s;
+
+% Initial conditions
+initial.hvBattery_SOC_pct = batteryHV_InputData.Options.InitialSOC_pct;
+initial.hvBattery_Charge_Ahr =  batteryHV_InputData.Options.InitialCharge_Ahr;
+
+%% High Voltage Battery - Essential
+
+batteryHV.nominalVoltage_V = 350;
+
+batteryHV.internalResistance_Ohm = 0.01;
+
+batteryHV.nominalCapacity_kWh = 4;
+
+batteryHV.voltagePerCell_V = 3.7;  % Open Circuit Voltage. 3.5V to 3.7V assuming Lithium-ion
+
+batteryHV.nominalCharge_Ahr = ...
+  batteryHV.nominalCapacity_kWh / batteryHV.nominalVoltage_V * 1000;
+
+% Initial conditions
+
+initial.hvBattery_SOC_pct = 70;
+
+initial.hvBattery_Charge_Ahr = batteryHV.nominalCharge_Ahr * initial.hvBattery_SOC_pct/100;
+
+%% With Finite Capacity
+
+% At SOC 50%, voltage is 90% of the nominal.
+batteryHV.measuredCharge_Ahr = batteryHV.nominalCharge_Ahr * 0.5;
+batteryHV.measuredVoltage_V = batteryHV.nominalVoltage_V * 0.9;
+
+%% Thermal model parameters
+% These parameters are used when thermal model is enabled
+% in the Battery block from Simscape Driveline
+% or the one from Simscape Electrical.
+% These are not used by the Basic referenced subsystem.
+
+ambient.mass_t = 10000;
+ambient.SpecificHeat_J_per_Kkg = 1000;
+ambient.temp_K = 273.15 + 20;
+
+initial.ambientTemp_K = ambient.temp_K;
+
+batteryHV.RadiationArea_m2 = 1;
+batteryHV.RadiationCoeff_W_per_K4m2 = 5e-10;
+
+batteryHV.thermalMass_kJ_per_K = 0.1;
+
+initial.hvBattery_Temperature_K = ...
+  273.15 + batteryHV_InputData.Options.InitialTemperature_degC;
+
+%% More Thermal model parameters
+% These parameters are used when thermal model is enabled
+% in the Battery block from Simscape Electrical.
+
+batteryHV.measurementTemperature_K = 273.15 + 25;
+
+batteryHV.secondMeasurementTemperature_K = 273.15 + 0;
+
+batteryHV.secondNominalVoltage_V = batteryHV.nominalVoltage_V * 0.95;
+batteryHV.secondInternalResistance_Ohm = batteryHV.internalResistance_Ohm * 2;
+batteryHV.secondMeasuredVoltage_V = batteryHV.nominalVoltage_V * 0.9;