2015-05-24 06:32:32 +02:00
|
|
|
// Copyright 2008 Dolphin Emulator Project
|
2021-07-05 03:22:19 +02:00
|
|
|
// SPDX-License-Identifier: GPL-2.0-or-later
|
2015-05-24 06:32:32 +02:00
|
|
|
|
2014-02-10 19:54:46 +01:00
|
|
|
#pragma once
|
2008-12-08 05:46:09 +01:00
|
|
|
|
2017-03-03 02:07:24 +01:00
|
|
|
#include <cstddef>
|
2008-07-12 19:40:22 +02:00
|
|
|
#include <string>
|
2018-01-29 17:58:02 +01:00
|
|
|
#include <vector>
|
|
|
|
|
|
|
|
#include "Common/CommonTypes.h"
|
2020-03-21 08:48:49 +01:00
|
|
|
#include "Common/Debug/Threads.h"
|
2019-07-09 00:07:11 +02:00
|
|
|
|
|
|
|
namespace Common::Debug
|
|
|
|
{
|
|
|
|
struct MemoryPatch;
|
|
|
|
struct Watch;
|
|
|
|
} // namespace Common::Debug
|
2008-12-08 05:46:09 +01:00
|
|
|
|
2018-07-10 03:47:50 +02:00
|
|
|
namespace Common
|
|
|
|
{
|
2008-07-12 19:40:22 +02:00
|
|
|
class DebugInterface
|
2008-08-23 17:28:24 +02:00
|
|
|
{
|
|
|
|
protected:
|
2019-07-08 23:44:56 +02:00
|
|
|
virtual ~DebugInterface() = default;
|
2018-04-12 14:18:04 +02:00
|
|
|
|
2008-07-12 19:40:22 +02:00
|
|
|
public:
|
2018-01-29 17:58:02 +01:00
|
|
|
// Watches
|
2019-07-08 23:28:07 +02:00
|
|
|
virtual std::size_t SetWatch(u32 address, std::string name = "") = 0;
|
2019-07-09 00:07:11 +02:00
|
|
|
virtual const Debug::Watch& GetWatch(std::size_t index) const = 0;
|
|
|
|
virtual const std::vector<Debug::Watch>& GetWatches() const = 0;
|
2018-01-29 17:58:02 +01:00
|
|
|
virtual void UnsetWatch(u32 address) = 0;
|
2019-07-08 23:28:07 +02:00
|
|
|
virtual void UpdateWatch(std::size_t index, u32 address, std::string name) = 0;
|
2018-01-29 17:58:02 +01:00
|
|
|
virtual void UpdateWatchAddress(std::size_t index, u32 address) = 0;
|
2019-07-08 23:28:07 +02:00
|
|
|
virtual void UpdateWatchName(std::size_t index, std::string name) = 0;
|
2018-01-29 17:58:02 +01:00
|
|
|
virtual void EnableWatch(std::size_t index) = 0;
|
|
|
|
virtual void DisableWatch(std::size_t index) = 0;
|
|
|
|
virtual bool HasEnabledWatch(u32 address) const = 0;
|
|
|
|
virtual void RemoveWatch(std::size_t index) = 0;
|
|
|
|
virtual void LoadWatchesFromStrings(const std::vector<std::string>& watches) = 0;
|
|
|
|
virtual std::vector<std::string> SaveWatchesToStrings() const = 0;
|
|
|
|
virtual void ClearWatches() = 0;
|
|
|
|
|
2018-05-21 16:46:03 +02:00
|
|
|
// Memory Patches
|
|
|
|
virtual void SetPatch(u32 address, u32 value) = 0;
|
|
|
|
virtual void SetPatch(u32 address, std::vector<u8> value) = 0;
|
2019-07-09 00:07:11 +02:00
|
|
|
virtual const std::vector<Debug::MemoryPatch>& GetPatches() const = 0;
|
2018-05-21 16:46:03 +02:00
|
|
|
virtual void UnsetPatch(u32 address) = 0;
|
|
|
|
virtual void EnablePatch(std::size_t index) = 0;
|
|
|
|
virtual void DisablePatch(std::size_t index) = 0;
|
|
|
|
virtual bool HasEnabledPatch(u32 address) const = 0;
|
|
|
|
virtual void RemovePatch(std::size_t index) = 0;
|
|
|
|
virtual void ClearPatches() = 0;
|
|
|
|
|
2020-03-21 08:48:49 +01:00
|
|
|
// Threads
|
|
|
|
virtual Debug::Threads GetThreads() const = 0;
|
|
|
|
|
2019-07-09 00:25:14 +02:00
|
|
|
virtual std::string Disassemble(u32 /*address*/) const { return "NODEBUGGER"; }
|
|
|
|
virtual std::string GetRawMemoryString(int /*memory*/, u32 /*address*/) const
|
2016-01-21 20:46:25 +01:00
|
|
|
{
|
2016-10-07 15:56:02 +02:00
|
|
|
return "NODEBUGGER";
|
2016-01-21 20:46:25 +01:00
|
|
|
}
|
2019-07-09 00:25:14 +02:00
|
|
|
virtual bool IsAlive() const { return true; }
|
|
|
|
virtual bool IsBreakpoint(u32 /*address*/) const { return false; }
|
2019-07-08 23:53:47 +02:00
|
|
|
virtual void SetBreakpoint(u32 /*address*/) {}
|
|
|
|
virtual void ClearBreakpoint(u32 /*address*/) {}
|
2014-03-03 06:39:08 +01:00
|
|
|
virtual void ClearAllBreakpoints() {}
|
2019-07-08 23:53:47 +02:00
|
|
|
virtual void ToggleBreakpoint(u32 /*address*/) {}
|
2014-03-06 02:51:27 +01:00
|
|
|
virtual void ClearAllMemChecks() {}
|
2019-07-09 00:25:14 +02:00
|
|
|
virtual bool IsMemCheck(u32 /*address*/, size_t /*size*/) const { return false; }
|
2019-07-08 23:53:47 +02:00
|
|
|
virtual void ToggleMemCheck(u32 /*address*/, bool /*read*/, bool /*write*/, bool /*log*/) {}
|
2019-07-09 00:25:14 +02:00
|
|
|
virtual u32 ReadMemory(u32 /*address*/) const { return 0; }
|
2019-07-08 23:53:47 +02:00
|
|
|
virtual void WriteExtraMemory(int /*memory*/, u32 /*value*/, u32 /*address*/) {}
|
2019-07-09 00:25:14 +02:00
|
|
|
virtual u32 ReadExtraMemory(int /*memory*/, u32 /*address*/) const { return 0; }
|
|
|
|
virtual u32 ReadInstruction(u32 /*address*/) const { return 0; }
|
|
|
|
virtual u32 GetPC() const { return 0; }
|
2019-07-08 23:53:47 +02:00
|
|
|
virtual void SetPC(u32 /*address*/) {}
|
2014-03-03 06:39:08 +01:00
|
|
|
virtual void Step() {}
|
|
|
|
virtual void RunToBreakpoint() {}
|
2019-07-09 00:25:14 +02:00
|
|
|
virtual u32 GetColor(u32 /*address*/) const { return 0xFFFFFFFF; }
|
|
|
|
virtual std::string GetDescription(u32 /*address*/) const = 0;
|
2018-01-29 17:58:02 +01:00
|
|
|
virtual void Clear() = 0;
|
2008-07-12 19:40:22 +02:00
|
|
|
};
|
2018-07-10 03:47:50 +02:00
|
|
|
} // namespace Common
|