ExciterDC1.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 ExciterDC1Parameters : public Base::ExciterParameters,
                             public SharedFactory<ExciterDC1Parameters> {
 
public:
  Real Tr = 0;
  Real Ta = 0;
  Real Tb = 0;
  Real Tc = 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 ExciterDC1 : public Base::Exciter,
                   public SimSignalComp,
                   public SharedFactory<ExciterDC1> {
 
private:
  std::shared_ptr<ExciterDC1Parameters> mParameters;
 
  // ### Exciter Variables ####
  Real mVh = 0;
  Real mVr = 0;
  Real mVr_prev = 0;
  Real mVf = 0;
  Real mVf_prev = 0;
  Real mVb = 0;
  Real mVb_prev = 0;
  Real mVin = 0;
  Real mVin_prev = 0;
  Real mVa = 0;
  Real mVa_prev = 0;
  Real mEf = 0;
  Real mEf_prev = 0;
  Real mVsat = 0;
  Real mVref = 0;
 
public:
  ExciterDC1(const String &name, 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 Vd, Real Vq, Real dt, Real Vpss = 0) final;
};
} // namespace Signal
} // namespace CPS