397 lines
11 KiB
C++
397 lines
11 KiB
C++
// Copyright 2014 Citra Emulator Project
|
|
// Licensed under GPLv2 or any later version
|
|
// Refer to the license.txt file included.
|
|
|
|
#pragma once
|
|
|
|
#include <cstddef>
|
|
#include <memory>
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
#include "common/common_types.h"
|
|
#include "core/file_sys/vfs_types.h"
|
|
#include "core/hle/kernel/object.h"
|
|
|
|
namespace Core::Frontend {
|
|
class EmuWindow;
|
|
} // namespace Core::Frontend
|
|
|
|
namespace FileSys {
|
|
class ContentProvider;
|
|
class ContentProviderUnion;
|
|
enum class ContentProviderUnionSlot;
|
|
class VfsFilesystem;
|
|
} // namespace FileSys
|
|
|
|
namespace Kernel {
|
|
class GlobalScheduler;
|
|
class KernelCore;
|
|
class PhysicalCore;
|
|
class Process;
|
|
class Scheduler;
|
|
} // namespace Kernel
|
|
|
|
namespace Loader {
|
|
class AppLoader;
|
|
enum class ResultStatus : u16;
|
|
} // namespace Loader
|
|
|
|
namespace Core::Memory {
|
|
struct CheatEntry;
|
|
class Memory;
|
|
} // namespace Core::Memory
|
|
|
|
namespace Service {
|
|
|
|
namespace AM::Applets {
|
|
struct AppletFrontendSet;
|
|
class AppletManager;
|
|
} // namespace AM::Applets
|
|
|
|
namespace APM {
|
|
class Controller;
|
|
}
|
|
|
|
namespace FileSystem {
|
|
class FileSystemController;
|
|
} // namespace FileSystem
|
|
|
|
namespace Glue {
|
|
class ARPManager;
|
|
}
|
|
|
|
namespace LM {
|
|
class Manager;
|
|
} // namespace LM
|
|
|
|
namespace SM {
|
|
class ServiceManager;
|
|
} // namespace SM
|
|
|
|
} // namespace Service
|
|
|
|
namespace Tegra {
|
|
class DebugContext;
|
|
class GPU;
|
|
} // namespace Tegra
|
|
|
|
namespace VideoCore {
|
|
class RendererBase;
|
|
} // namespace VideoCore
|
|
|
|
namespace Core::Timing {
|
|
class CoreTiming;
|
|
}
|
|
|
|
namespace Core::Hardware {
|
|
class InterruptManager;
|
|
}
|
|
|
|
namespace Core {
|
|
|
|
class ARM_Interface;
|
|
class CpuManager;
|
|
class DeviceMemory;
|
|
class ExclusiveMonitor;
|
|
class FrameLimiter;
|
|
class PerfStats;
|
|
class Reporter;
|
|
class TelemetrySession;
|
|
|
|
struct PerfStatsResults;
|
|
|
|
FileSys::VirtualFile GetGameFileFromPath(const FileSys::VirtualFilesystem& vfs,
|
|
const std::string& path);
|
|
|
|
class System {
|
|
public:
|
|
using CurrentBuildProcessID = std::array<u8, 0x20>;
|
|
|
|
System(const System&) = delete;
|
|
System& operator=(const System&) = delete;
|
|
|
|
System(System&&) = delete;
|
|
System& operator=(System&&) = delete;
|
|
|
|
~System();
|
|
|
|
/**
|
|
* Gets the instance of the System singleton class.
|
|
* @returns Reference to the instance of the System singleton class.
|
|
*/
|
|
static System& GetInstance() {
|
|
return s_instance;
|
|
}
|
|
|
|
/// Enumeration representing the return values of the System Initialize and Load process.
|
|
enum class ResultStatus : u32 {
|
|
Success, ///< Succeeded
|
|
ErrorNotInitialized, ///< Error trying to use core prior to initialization
|
|
ErrorGetLoader, ///< Error finding the correct application loader
|
|
ErrorSystemFiles, ///< Error in finding system files
|
|
ErrorSharedFont, ///< Error in finding shared font
|
|
ErrorVideoCore, ///< Error in the video core
|
|
ErrorUnknown, ///< Any other error
|
|
ErrorLoader, ///< The base for loader errors (too many to repeat)
|
|
};
|
|
|
|
/**
|
|
* Run the OS and Application
|
|
* This function will start emulation and run the competent devices
|
|
*/
|
|
ResultStatus Run();
|
|
|
|
/**
|
|
* Pause the OS and Application
|
|
* This function will pause emulation and stop the competent devices
|
|
*/
|
|
ResultStatus Pause();
|
|
|
|
|
|
|
|
/**
|
|
* Step the CPU one instruction
|
|
* @return Result status, indicating whether or not the operation succeeded.
|
|
*/
|
|
ResultStatus SingleStep();
|
|
|
|
/**
|
|
* Invalidate the CPU instruction caches
|
|
* This function should only be used by GDB Stub to support breakpoints, memory updates and
|
|
* step/continue commands.
|
|
*/
|
|
void InvalidateCpuInstructionCaches();
|
|
|
|
/// Shutdown the emulated system.
|
|
void Shutdown();
|
|
|
|
/**
|
|
* Load an executable application.
|
|
* @param emu_window Reference to the host-system window used for video output and keyboard
|
|
* input.
|
|
* @param filepath String path to the executable application to load on the host file system.
|
|
* @returns ResultStatus code, indicating if the operation succeeded.
|
|
*/
|
|
ResultStatus Load(Frontend::EmuWindow& emu_window, const std::string& filepath);
|
|
|
|
/**
|
|
* Indicates if the emulated system is powered on (all subsystems initialized and able to run an
|
|
* application).
|
|
* @returns True if the emulated system is powered on, otherwise false.
|
|
*/
|
|
bool IsPoweredOn() const;
|
|
|
|
/// Gets a reference to the telemetry session for this emulation session.
|
|
Core::TelemetrySession& TelemetrySession();
|
|
|
|
/// Gets a reference to the telemetry session for this emulation session.
|
|
const Core::TelemetrySession& TelemetrySession() const;
|
|
|
|
/// Prepare the core emulation for a reschedule
|
|
void PrepareReschedule();
|
|
|
|
/// Prepare the core emulation for a reschedule
|
|
void PrepareReschedule(u32 core_index);
|
|
|
|
/// Gets and resets core performance statistics
|
|
PerfStatsResults GetAndResetPerfStats();
|
|
|
|
/// Gets an ARM interface to the CPU core that is currently running
|
|
ARM_Interface& CurrentArmInterface();
|
|
|
|
/// Gets an ARM interface to the CPU core that is currently running
|
|
const ARM_Interface& CurrentArmInterface() const;
|
|
|
|
/// Gets the index of the currently running CPU core
|
|
std::size_t CurrentCoreIndex() const;
|
|
|
|
/// Gets the scheduler for the CPU core that is currently running
|
|
Kernel::Scheduler& CurrentScheduler();
|
|
|
|
/// Gets the scheduler for the CPU core that is currently running
|
|
const Kernel::Scheduler& CurrentScheduler() const;
|
|
|
|
/// Gets the physical core for the CPU core that is currently running
|
|
Kernel::PhysicalCore& CurrentPhysicalCore();
|
|
|
|
/// Gets the physical core for the CPU core that is currently running
|
|
const Kernel::PhysicalCore& CurrentPhysicalCore() const;
|
|
|
|
/// Gets a reference to an ARM interface for the CPU core with the specified index
|
|
ARM_Interface& ArmInterface(std::size_t core_index);
|
|
|
|
/// Gets a const reference to an ARM interface from the CPU core with the specified index
|
|
const ARM_Interface& ArmInterface(std::size_t core_index) const;
|
|
|
|
CpuManager& GetCpuManager();
|
|
|
|
const CpuManager& GetCpuManager() const;
|
|
|
|
/// Gets a reference to the exclusive monitor
|
|
ExclusiveMonitor& Monitor();
|
|
|
|
/// Gets a constant reference to the exclusive monitor
|
|
const ExclusiveMonitor& Monitor() const;
|
|
|
|
/// Gets a mutable reference to the system memory instance.
|
|
Core::Memory::Memory& Memory();
|
|
|
|
/// Gets a constant reference to the system memory instance.
|
|
const Core::Memory::Memory& Memory() const;
|
|
|
|
/// Gets a mutable reference to the GPU interface
|
|
Tegra::GPU& GPU();
|
|
|
|
/// Gets an immutable reference to the GPU interface.
|
|
const Tegra::GPU& GPU() const;
|
|
|
|
/// Gets a mutable reference to the renderer.
|
|
VideoCore::RendererBase& Renderer();
|
|
|
|
/// Gets an immutable reference to the renderer.
|
|
const VideoCore::RendererBase& Renderer() const;
|
|
|
|
/// Gets the scheduler for the CPU core with the specified index
|
|
Kernel::Scheduler& Scheduler(std::size_t core_index);
|
|
|
|
/// Gets the scheduler for the CPU core with the specified index
|
|
const Kernel::Scheduler& Scheduler(std::size_t core_index) const;
|
|
|
|
/// Gets the global scheduler
|
|
Kernel::GlobalScheduler& GlobalScheduler();
|
|
|
|
/// Gets the global scheduler
|
|
const Kernel::GlobalScheduler& GlobalScheduler() const;
|
|
|
|
/// Gets the manager for the guest device memory
|
|
Core::DeviceMemory& DeviceMemory();
|
|
|
|
/// Gets the manager for the guest device memory
|
|
const Core::DeviceMemory& DeviceMemory() const;
|
|
|
|
/// Provides a pointer to the current process
|
|
Kernel::Process* CurrentProcess();
|
|
|
|
/// Provides a constant pointer to the current process.
|
|
const Kernel::Process* CurrentProcess() const;
|
|
|
|
/// Provides a reference to the core timing instance.
|
|
Timing::CoreTiming& CoreTiming();
|
|
|
|
/// Provides a constant reference to the core timing instance.
|
|
const Timing::CoreTiming& CoreTiming() const;
|
|
|
|
/// Provides a reference to the interrupt manager instance.
|
|
Core::Hardware::InterruptManager& InterruptManager();
|
|
|
|
/// Provides a constant reference to the interrupt manager instance.
|
|
const Core::Hardware::InterruptManager& InterruptManager() const;
|
|
|
|
/// Provides a reference to the kernel instance.
|
|
Kernel::KernelCore& Kernel();
|
|
|
|
/// Provides a constant reference to the kernel instance.
|
|
const Kernel::KernelCore& Kernel() const;
|
|
|
|
/// Provides a reference to the internal PerfStats instance.
|
|
Core::PerfStats& GetPerfStats();
|
|
|
|
/// Provides a constant reference to the internal PerfStats instance.
|
|
const Core::PerfStats& GetPerfStats() const;
|
|
|
|
/// Provides a reference to the frame limiter;
|
|
Core::FrameLimiter& FrameLimiter();
|
|
|
|
/// Provides a constant referent to the frame limiter
|
|
const Core::FrameLimiter& FrameLimiter() const;
|
|
|
|
/// Gets the name of the current game
|
|
Loader::ResultStatus GetGameName(std::string& out) const;
|
|
|
|
void SetStatus(ResultStatus new_status, const char* details);
|
|
|
|
const std::string& GetStatusDetails() const;
|
|
|
|
Loader::AppLoader& GetAppLoader() const;
|
|
|
|
Service::SM::ServiceManager& ServiceManager();
|
|
const Service::SM::ServiceManager& ServiceManager() const;
|
|
|
|
void SetFilesystem(std::shared_ptr<FileSys::VfsFilesystem> vfs);
|
|
|
|
std::shared_ptr<FileSys::VfsFilesystem> GetFilesystem() const;
|
|
|
|
void RegisterCheatList(const std::vector<Memory::CheatEntry>& list,
|
|
const std::array<u8, 0x20>& build_id, VAddr main_region_begin,
|
|
u64 main_region_size);
|
|
|
|
void SetAppletFrontendSet(Service::AM::Applets::AppletFrontendSet&& set);
|
|
|
|
void SetDefaultAppletFrontendSet();
|
|
|
|
Service::AM::Applets::AppletManager& GetAppletManager();
|
|
|
|
const Service::AM::Applets::AppletManager& GetAppletManager() const;
|
|
|
|
void SetContentProvider(std::unique_ptr<FileSys::ContentProviderUnion> provider);
|
|
|
|
FileSys::ContentProvider& GetContentProvider();
|
|
|
|
const FileSys::ContentProvider& GetContentProvider() const;
|
|
|
|
Service::FileSystem::FileSystemController& GetFileSystemController();
|
|
|
|
const Service::FileSystem::FileSystemController& GetFileSystemController() const;
|
|
|
|
void RegisterContentProvider(FileSys::ContentProviderUnionSlot slot,
|
|
FileSys::ContentProvider* provider);
|
|
|
|
void ClearContentProvider(FileSys::ContentProviderUnionSlot slot);
|
|
|
|
const Reporter& GetReporter() const;
|
|
|
|
Service::Glue::ARPManager& GetARPManager();
|
|
|
|
const Service::Glue::ARPManager& GetARPManager() const;
|
|
|
|
Service::APM::Controller& GetAPMController();
|
|
|
|
const Service::APM::Controller& GetAPMController() const;
|
|
|
|
Service::LM::Manager& GetLogManager();
|
|
|
|
const Service::LM::Manager& GetLogManager() const;
|
|
|
|
void SetExitLock(bool locked);
|
|
|
|
bool GetExitLock() const;
|
|
|
|
void SetCurrentProcessBuildID(const CurrentBuildProcessID& id);
|
|
|
|
const CurrentBuildProcessID& GetCurrentProcessBuildID() const;
|
|
|
|
/// Register a host thread as an emulated CPU Core.
|
|
void RegisterCoreThread(std::size_t id);
|
|
|
|
/// Register a host thread as an auxiliary thread.
|
|
void RegisterHostThread();
|
|
|
|
private:
|
|
System();
|
|
|
|
/**
|
|
* Initialize the emulated system.
|
|
* @param emu_window Reference to the host-system window used for video output and keyboard
|
|
* input.
|
|
* @return ResultStatus code, indicating if the operation succeeded.
|
|
*/
|
|
ResultStatus Init(Frontend::EmuWindow& emu_window);
|
|
|
|
struct Impl;
|
|
std::unique_ptr<Impl> impl;
|
|
|
|
static System s_instance;
|
|
};
|
|
|
|
} // namespace Core
|