machine.h

Go to the documentation of this file.

#pragma once
 
#include "libmicroemu/cpu_states.h"
#include "libmicroemu/emu_context.h"
#include "libmicroemu/exec_result.h"
#include "libmicroemu/logger.h"
#include "libmicroemu/status_code.h"
#include "libmicroemu/types.h"
 
#include <array>
#include <functional>

namespace libmicroemu {

namespace internal {
// forward declarations
template <typename TCpuStates> class Emulator;
}; // namespace internal

using FPreExecStepCallback = std::function<void(EmuContext &ctx)>;

using FPostExecStepCallback = std::function<void(EmuContext &ctx)>;

using FStateCallback =
    std::function<void(IRegAccessor &reg_access, ISpecialRegAccessor &spec_reg_access)>;

class Machine {
public:
  Machine() noexcept;

  ~Machine() noexcept;

  StatusCode Load(const char *elf_file, bool set_entry_point = false) noexcept;
 
  StatusCode Reset() noexcept;

  ExecResult Exec(i64 max_instructions = -1, FPreExecStepCallback cb_pre_exec = nullptr,
                  FPostExecStepCallback cb_post_exec = nullptr) noexcept;

  void SetFlashSegment(u8 *seg_ptr, me_size_t seg_size, me_adr_t seg_vadr) noexcept;

  void SetRam1Segment(u8 *seg_ptr, me_size_t seg_size, me_adr_t seg_vadr) noexcept;

  void SetRam2Segment(u8 *seg_ptr, me_size_t seg_size, me_adr_t seg_vadr) noexcept;

  void EvaluateState(FStateCallback cb) noexcept;
 
  static void RegisterLoggerCallback(void (*callback)(libmicroemu::LogLevel level, const char *,
                                                      ...) noexcept) noexcept;

  std::string_view GetVersion() noexcept;
 
private:
  internal::Emulator<CpuStates> BuildEmulator();
  u8 *flash_{nullptr};
  me_size_t flash_size_{0U};
  me_adr_t flash_vadr_{0x0U};
 
  u8 *ram1_{nullptr};
  me_size_t ram1_size_{0U};
  me_adr_t ram1_vadr_{0x0U};
 
  u8 *ram2_{nullptr};
  me_size_t ram2_size_{0U};
  me_adr_t ram2_vadr_{0x0U};
 
  CpuStates cpu_states_{};
};
 
} // namespace libmicroemu