ExciterDC1Simp.h

// SPDX-FileCopyrightText: 2025 Institute for Automation of Complex Power Systems, EONERC, RWTH Aachen University
// SPDX-License-Identifier: MPL-2.0
 
#pragma once
 
#include <dpsim-models/Base/Base_Exciter.h>
#include <dpsim-models/Logger.h>
#include <dpsim-models/SimSignalComp.h>
 
namespace CPS {
namespace Signal {
 
class ExciterDC1SimpParameters
    : public Base::ExciterParameters,
      public SharedFactory<ExciterDC1SimpParameters> {
 
public:
  Real Tr = 0;
  Real Ta = 0;
  Real Tef = 0;
  Real Tf = 0;
  Real Ka = 0;
  Real Kef = 0;
  Real Kf = 0;
  Real Aef = 0;
  Real Bef = 0;
  Real MaxVa = 0;
  Real MinVa = 0;
};

 
class ExciterDC1Simp : public Base::Exciter,
                       public SimSignalComp,
                       public SharedFactory<ExciterDC1Simp> {
 
private:
  std::shared_ptr<ExciterDC1SimpParameters> mParameters;
 
  // ### Exciter Variables ####
  Real mVref = 0;
  Real mVr_prev = 0;
  Real mVf_prev = 0;
  Real mVa_prev = 0;
  Real mEf_prev = 0;

  const Attribute<Real>::Ptr mVh;
  const Attribute<Real>::Ptr mVr;
  Real mVf;
  Real mVin;
  Real mVa;
  Real mVsat;
  const Attribute<Real>::Ptr mEf;
 
public:
  ExciterDC1Simp(const String &name,
                 CPS::Logger::Level logLevel = Logger::Level::info);
  void setParameters(std::shared_ptr<Base::ExciterParameters> parameters) final;
  void initializeStates(Real Vh_init, Real Vf_init) final;
  Real step(Real mVd, Real mVq, Real dt, Real Vpss = 0) final;
};
} // namespace Signal
} // namespace CPS