Files
BloomPatched/src/DebugServer/Gdb/TargetDescriptor.hpp
Nav 6cdbfbe950 Massive refactor to accommodate RISC-V targets
- Refactored entire codebase (excluding the Insight component) to accommodate multiple target architectures (no longer specific to AVR)
- Deleted 'generate SVD' GDB monitor command - I will eventually move this functionality to the Bloom website
- Added unit size property to address spaces
- Many other changes which I couldn't be bothered to describe here
2024-07-23 21:14:22 +01:00

70 lines
2.2 KiB
C++

#pragma once
#include <cstdint>
#include <optional>
#include <vector>
#include <set>
#include <map>
#include "src/Helpers/BiMap.hpp"
#include "src/Targets/TargetDescriptor.hpp"
#include "src/Targets/TargetRegisterDescriptor.hpp"
#include "src/Targets/TargetMemory.hpp"
#include "RegisterDescriptor.hpp"
namespace DebugServer::Gdb
{
using GdbMemoryAddress = std::uint32_t;
/**
* GDB target descriptor.
*/
class TargetDescriptor
{
public:
std::map<GdbRegisterId, RegisterDescriptor> gdbRegisterDescriptorsById;
std::map<GdbRegisterId, const Targets::TargetRegisterDescriptor*> targetRegisterDescriptorsByGdbId;
virtual ~TargetDescriptor() = default;
/**
* For targets with multiple address spaces (e.g. AVR), GDB encodes address space information into memory
* addresses, by applying a mask.
*
* This function should identify the encoded address space within a GDB memory address, and return the
* relevant address space descriptor.
*
* @param address
* @return
*/
virtual const Targets::TargetAddressSpaceDescriptor& addressSpaceDescriptorFromGdbAddress(
GdbMemoryAddress address
) const = 0;
/**
* This function should translate a GDB memory address to a target memory address. This should strip any
* GDB-specific masks and return an address that can be used within Bloom.
*
* @param address
* @return
*/
virtual Targets::TargetMemoryAddress translateGdbAddress(GdbMemoryAddress address) const = 0;
/**
* This function should translate a target memory address to a GDB memory address. It should encode any
* additional data expected by GDB.
*
* @param address
* @param addressSpaceDescriptor
* @param memorySegmentDescriptor
* @return
*/
virtual GdbMemoryAddress translateTargetMemoryAddress(
Targets::TargetMemoryAddress address,
const Targets::TargetAddressSpaceDescriptor& addressSpaceDescriptor,
const Targets::TargetMemorySegmentDescriptor& memorySegmentDescriptor
) const = 0;
};
}