From 5d0738ddeacee6dd3aa9dcb0226c7265ab0a444f Mon Sep 17 00:00:00 2001
From: KV <kvid@users.noreply.github.com>
Date: Thu, 8 Sep 2022 18:30:54 +0200
Subject: [PATCH] Add LoadProfile example for Site1

---
 XInTheLoop/Examples/Site1.mo               |  75 ++++++++++++++++++++-
 XInTheLoop/Resources/Data/DriveProfile.mat | Bin 0 -> 10068 bytes
 2 files changed, 73 insertions(+), 2 deletions(-)
 create mode 100644 XInTheLoop/Resources/Data/DriveProfile.mat

diff --git a/XInTheLoop/Examples/Site1.mo b/XInTheLoop/Examples/Site1.mo
index ab1db63..f64446d 100644
--- a/XInTheLoop/Examples/Site1.mo
+++ b/XInTheLoop/Examples/Site1.mo
@@ -45,6 +45,79 @@ package Site1 "Example Site 1 for Hardware-in-the-loop (HIL) simulation"
       experiment(StartTime = 0, StopTime = 60, Tolerance = 1e-06, Interval = 0.1));
   end Test;
 
+  model LoadProfile "Example model demonstrating exchanging values with this site for half an hour using a load profile from a data file"
+    extends Modelica.Icons.Example;
+    XInTheLoop.Examples.Site1.Blocks.Sync sync annotation(
+      Placement(visible = true, transformation(origin = {10, 0}, extent = {{-10, -10}, {10, 10}}, rotation = 0)));
+    Modelica.Blocks.Sources.CombiTimeTable loadSP(fileName = Modelica.Utilities.Files.loadResource("modelica://XInTheLoop/Resources/Data/DriveProfile.mat"), tableName = "X", tableOnFile = true) annotation(
+      Placement(visible = true, transformation(origin = {-30, -30}, extent = {{-10, -10}, {10, 10}}, rotation = 0)));
+    Modelica.Blocks.Sources.RealExpression dcdcSP annotation(
+      Placement(visible = true, transformation(origin = {-30, 0}, extent = {{-10, -10}, {10, 10}}, rotation = 0)));
+    XInTheLoop.Examples.Site1.Blocks.PackControlBits packControlBits annotation(
+      Placement(visible = true, transformation(origin = {-30, 36}, extent = {{-10, -10}, {10, 10}}, rotation = 0)));
+    XInTheLoop.Examples.Site1.Blocks.UnpackStatusBits unpackStatusBits annotation(
+      Placement(visible = true, transformation(origin = {50, 70}, extent = {{-10, -10}, {10, 10}}, rotation = 0)));
+    XInTheLoop.Blocks.Customized.IntegerTable keyOn(table = [0, 0; 100, 1; 1700, 0]) annotation(
+      Placement(visible = true, transformation(origin = {-80, 40}, extent = {{-10, -10}, {10, 10}}, rotation = 0)));
+    Modelica.Blocks.Sources.IntegerExpression loadSequence annotation(
+      Placement(visible = true, transformation(origin = {-80, -40}, extent = {{-10, -10}, {10, 10}}, rotation = 0)));
+    Modelica.Blocks.Sources.IntegerExpression remoteControl(y = 1) annotation(
+      Placement(visible = true, transformation(origin = {-80, 80}, extent = {{-10, -10}, {10, 10}}, rotation = 0)));
+    XInTheLoop.Blocks.Customized.IntegerTable start(table = [0, 0; 200, 1; 1695, 0]) annotation(
+      Placement(visible = true, transformation(origin = {-80, 0}, extent = {{-10, -10}, {10, 10}}, rotation = 0)));
+    Modelica.Blocks.Math.MultiProduct powerStack(nu = 2) annotation(
+      Placement(visible = true, transformation(origin = {50, 36}, extent = {{-10, -10}, {10, 10}}, rotation = 0)));
+    Modelica.Blocks.Math.MultiProduct powerBatt(nu = 2) annotation(
+      Placement(visible = true, transformation(origin = {50, 6}, extent = {{-10, -10}, {10, 10}}, rotation = 0)));
+    Modelica.Blocks.Math.MultiProduct powerDcDcIn(nu = 2) annotation(
+      Placement(visible = true, transformation(origin = {50, -20}, extent = {{-10, -10}, {10, 10}}, rotation = 0)));
+    Modelica.Blocks.Math.MultiProduct powerDcDcOut(nu = 2) annotation(
+      Placement(visible = true, transformation(origin = {50, -50}, extent = {{-10, -10}, {10, 10}}, rotation = 0)));
+    Modelica.Blocks.Math.MultiProduct powerLoad(nu = 2) annotation(
+      Placement(visible = true, transformation(origin = {50, -80}, extent = {{-10, -10}, {10, 10}}, rotation = 0)));
+  equation
+    connect(keyOn.y, packControlBits.uKeyOn) annotation(
+      Line(points = {{-69, 40}, {-42, 40}, {-42, 39}}, color = {255, 127, 0}));
+    connect(loadSequence.y, packControlBits.uLoadSequence) annotation(
+      Line(points = {{-68, -40}, {-52, -40}, {-52, 27}, {-42, 27}}, color = {255, 127, 0}));
+    connect(dcdcSP.y, sync.uDcDc_SP_req) annotation(
+      Line(points = {{-19, 0}, {-2, 0}}, color = {0, 0, 127}));
+    connect(sync.yStatusBits, unpackStatusBits.u) annotation(
+      Line(points = {{14, 11}, {14, 70}, {38, 70}}, color = {255, 127, 0}));
+    connect(packControlBits.y, sync.uControlBits) annotation(
+      Line(points = {{-19, 36}, {-10, 36}, {-10, 6}, {-2, 6}}, color = {255, 127, 0}));
+    connect(start.y, packControlBits.uStartButton) annotation(
+      Line(points = {{-68, 0}, {-60, 0}, {-60, 32}, {-42, 32}, {-42, 33}}, color = {255, 127, 0}));
+    connect(remoteControl.y, packControlBits.uRemoteControl) annotation(
+      Line(points = {{-69, 80}, {-60, 80}, {-60, 44}, {-42, 44}, {-42, 45}}, color = {255, 127, 0}));
+    connect(loadSP.y[1], sync.uLoad_SP_req) annotation(
+      Line(points = {{-18, -30}, {-10, -30}, {-10, -6}, {-2, -6}}, color = {0, 0, 127}));
+    connect(sync.yV_Stack, powerStack.u[1]) annotation(
+      Line(points = {{22, 10}, {28, 10}, {28, 36}, {40, 36}}, color = {0, 0, 127}));
+    connect(sync.yI_Stack, powerStack.u[2]) annotation(
+      Line(points = {{22, 8}, {30, 8}, {30, 34}, {40, 34}, {40, 36}}, color = {0, 0, 127}));
+    connect(sync.yI_Batt, powerBatt.u[1]) annotation(
+      Line(points = {{22, 2}, {40, 2}, {40, 6}}, color = {0, 0, 127}));
+    connect(sync.yV_Batt, powerBatt.u[2]) annotation(
+      Line(points = {{22, 4}, {40, 4}, {40, 6}, {40, 6}}, color = {0, 0, 127}));
+    connect(sync.yV_In_DcDc, powerDcDcIn.u[1]) annotation(
+      Line(points = {{22, -2}, {34, -2}, {34, -18}, {40, -18}, {40, -20}}, color = {0, 0, 127}));
+    connect(sync.yI_In_DcDc, powerDcDcIn.u[2]) annotation(
+      Line(points = {{22, -4}, {32, -4}, {32, -20}, {40, -20}}, color = {0, 0, 127}));
+    connect(sync.yV_Out_DcDc, powerDcDcOut.u[1]) annotation(
+      Line(points = {{22, -4}, {30, -4}, {30, -48}, {40, -48}, {40, -50}}, color = {0, 0, 127}));
+    connect(sync.yI_Out_DcDc, powerDcDcOut.u[2]) annotation(
+      Line(points = {{22, -6}, {28, -6}, {28, -50}, {40, -50}, {40, -50}}, color = {0, 0, 127}));
+    connect(sync.yV_Load, powerLoad.u[1]) annotation(
+      Line(points = {{22, -8}, {26, -8}, {26, -78}, {40, -78}, {40, -80}}, color = {0, 0, 127}));
+    connect(sync.yI_Load, powerLoad.u[2]) annotation(
+      Line(points = {{22, -10}, {24, -10}, {24, -80}, {40, -80}, {40, -80}}, color = {0, 0, 127}));
+    annotation(
+      experiment(StartTime = 0, StopTime = 1750, Tolerance = 1e-06, Interval = 1),
+      __OpenModelica_commandLineOptions = "--matchingAlgorithm=PFPlusExt --indexReductionMethod=dynamicStateSelection -d=initialization,NLSanalyticJacobian,newInst",
+      __OpenModelica_simulationFlags(lv = "LOG_STATS", outputFormat = "mat", s = "dassl"));
+  end LoadProfile;
+
   package Blocks "Site1-Specific Blocks"
     extends Icons.BlocksPackage;
 
@@ -257,9 +330,7 @@ package Site1 "Example Site 1 for Hardware-in-the-loop (HIL) simulation"
       connect(unpackInt2Bools.y[13], yModelicaHeartbeat) annotation(
         Line(points = {{62, 0}, {80, 0}, {80, -94}, {110, -94}}, color = {255, 0, 255}));
     end UnpackStatusBits;
-
   end Blocks;
-
   annotation(
     Documentation(info = "<html><head></head><body>
 This example implements a protocol to exchange values with an external system running a fuel cell, DC-DC-converter, battery, and a variable load - to enable&nbsp;Hardware-in-the-loop (HIL) simulations.
diff --git a/XInTheLoop/Resources/Data/DriveProfile.mat b/XInTheLoop/Resources/Data/DriveProfile.mat
new file mode 100644
index 0000000000000000000000000000000000000000..4ef4ff17d842b543cb58b06c5f69aaed3c1e7493
GIT binary patch
literal 10068
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
UGXM6)Z;oj|>Rn?1<Wt%I0q*>$b^rhX

literal 0
HcmV?d00001