PLL.h

/* Copyright 2017-2021 Institute for Automation of Complex Power Systems,
 *                     EONERC, RWTH Aachen University
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at https://mozilla.org/MPL/2.0/.
 *********************************************************************************/
 
#pragma once
 
#include <vector>
 
#include <dpsim-models/SimPowerComp.h>
#include <dpsim-models/SimSignalComp.h>
#include <dpsim-models/Task.h>
 
namespace CPS {
namespace Signal {
class PLL : public SimSignalComp, public SharedFactory<PLL> {
 
protected:
  Real mKp;
  Real mKi;

  Real mOmegaNom;
  Real mTimeStep;

  Matrix mA = Matrix::Zero(2, 2);
  Matrix mB = Matrix::Zero(2, 2);
  Matrix mC = Matrix::Zero(2, 2);
  Matrix mD = Matrix::Zero(2, 2);
 
public:
  const Attribute<Real>::Ptr mInputRef;

  const Attribute<Matrix>::Ptr mInputPrev;
  const Attribute<Matrix>::Ptr mInputCurr;
  const Attribute<Matrix>::Ptr mStatePrev;
  const Attribute<Matrix>::Ptr mStateCurr;
  const Attribute<Matrix>::Ptr mOutputPrev;
  const Attribute<Matrix>::Ptr mOutputCurr;
 
  PLL(String name, Logger::Level logLevel = Logger::Level::off);
  void setParameters(Real kpPLL, Real kiPLL, Real omegaNom);
  void setSimulationParameters(Real timestep);
  void setInitialValues(Real input_init, Matrix state_init, Matrix output_init);
  void composeStateSpaceMatrices();
  void signalPreStep(Real time, Int timeStepCount);
  void signalStep(Real time, Int timeStepCount);
  void signalAddPreStepDependencies(AttributeBase::List &prevStepDependencies,
                                    AttributeBase::List &attributeDependencies,
                                    AttributeBase::List &modifiedAttributes);
  void signalAddStepDependencies(AttributeBase::List &prevStepDependencies,
                                 AttributeBase::List &attributeDependencies,
                                 AttributeBase::List &modifiedAttributes);
 
  Task::List getTasks();
 
  class PreStep : public Task {
  public:
    PreStep(PLL &pll) : Task(**pll.mName + ".PreStep"), mPLL(pll) {
      mPLL.signalAddPreStepDependencies(
          mPrevStepDependencies, mAttributeDependencies, mModifiedAttributes);
    }
    void execute(Real time, Int timeStepCount) {
      mPLL.signalPreStep(time, timeStepCount);
    };
 
  private:
    PLL &mPLL;
  };
 
  class Step : public Task {
  public:
    Step(PLL &pll) : Task(**pll.mName + ".Step"), mPLL(pll) {
      mPLL.signalAddStepDependencies(
          mPrevStepDependencies, mAttributeDependencies, mModifiedAttributes);
    }
    void execute(Real time, Int timeStepCount) {
      mPLL.signalStep(time, timeStepCount);
    };
 
  private:
    PLL &mPLL;
  };
};
} // namespace Signal
} // namespace CPS