ExciterStatic.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 ExciterStaticParameters : public Base::ExciterParameters,
                                public SharedFactory<ExciterStaticParameters> {
 
public:
  Real Tr = 0;
  Real Ta = 0;
  Real Tb = 0;
  Real Te = 0;
  Real Ka = 0;

  Real MaxEfd = 0;
  Real MinEfd = 0;

  Real Kbc = 0;
};

class ExciterStatic : public Base::Exciter,
                      public SimSignalComp,
                      public SharedFactory<ExciterStatic> {
 
private:
  std::shared_ptr<ExciterStaticParameters> mParameters;
  Real mVref = 0;
  Real mVh = 0;
  Real mVr = 0;
  Real mVr_prev = 0;
  Real mXb = 0;
  Real mXb_prev = 0;
  Real mVin = 0;
  Real mVe;
  Real mEfd = 0;
  Real mEfdLim = 0;

  Real mCa;
  Real mCb;
 
public:
  ExciterStatic(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