118 lines
2.7 KiB
C++
118 lines
2.7 KiB
C++
/*
|
|
* This program source code file is part of KiCad, a free EDA CAD application.
|
|
*
|
|
* Copyright (C) 2022 Sylwester Kocjan <s.kocjan@o2.pl>
|
|
* Copyright (C) 2022 KiCad Developers, see AUTHORS.txt for contributors.
|
|
*
|
|
* This program is free software: you can redistribute it and/or modify it
|
|
* under the terms of the GNU General Public License as published by the
|
|
* Free Software Foundation, either version 3 of the License, or (at your
|
|
* option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful, but
|
|
* WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License along
|
|
* with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <mutex>
|
|
#include <memory>
|
|
|
|
class SPICE_SIMULATOR;
|
|
class REPORTER;
|
|
|
|
class SIMULATION_MODEL
|
|
{
|
|
public:
|
|
virtual ~SIMULATION_MODEL() {};
|
|
};
|
|
|
|
|
|
class SIMULATION_RESULTS
|
|
{
|
|
public:
|
|
virtual ~SIMULATION_RESULTS() {};
|
|
};
|
|
|
|
|
|
class SIMULATION
|
|
{
|
|
virtual ~SIMULATION(){};
|
|
};
|
|
|
|
|
|
class SIMULATOR
|
|
{
|
|
public:
|
|
SIMULATOR() :
|
|
m_simModel( nullptr )
|
|
{}
|
|
|
|
virtual ~SIMULATOR() {}
|
|
|
|
///< Create a simulator instance of particular type (currently only ngspice is handled)
|
|
static std::shared_ptr<SPICE_SIMULATOR> CreateInstance( const std::string& aName );
|
|
|
|
/*
|
|
* @return mutex for exclusive access to the simulator.
|
|
*/
|
|
std::mutex& GetMutex()
|
|
{
|
|
return m_mutex;
|
|
}
|
|
|
|
/**
|
|
* Point out the model that will be used in future simulations.
|
|
*
|
|
* @return True in case of success, false otherwise.
|
|
*/
|
|
virtual bool Attach( const std::shared_ptr<SIMULATION_MODEL>& aModel, REPORTER& aReporter )
|
|
{
|
|
m_simModel = aModel;
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Execute the simulation with currently loaded netlist.
|
|
*
|
|
* @return True in case of success, false otherwise.
|
|
*/
|
|
virtual bool Run() = 0;
|
|
// virtual bool Run( SIMULATION* aSim ) = 0;
|
|
// virtual SIM_RESULT Run( SPICE_SIMULATION* aSim ) = 0;
|
|
|
|
/**
|
|
* Halt the simulation.
|
|
*
|
|
* @return True in case of success, false otherwise.
|
|
*/
|
|
virtual bool Stop() = 0;
|
|
|
|
/**
|
|
* Check if simulation is running at the moment.
|
|
*
|
|
* @return True if simulation is currently executed.
|
|
*/
|
|
virtual bool IsRunning() = 0;
|
|
|
|
/**
|
|
* Cleans simulation data (i.e. all vectors)
|
|
*
|
|
*/
|
|
virtual void Clean() = 0;
|
|
|
|
protected:
|
|
///< Model that should be simulated.
|
|
std::shared_ptr<SIMULATION_MODEL> m_simModel;
|
|
|
|
private:
|
|
///< For interprocess synchronisation.
|
|
std::mutex m_mutex;
|
|
};
|
|
|