mirror of
https://github.com/pound-emu/pound.git
synced 2025-12-15 19:36:59 +00:00
2b5131e56c
Major architectural refactorbto focus exclusively on JIT development.
JIT & Decoder Architecture
- Implemented scripts/generate_jit_decoder_a32_table.py to parse
instruction definitions at build-time rather than runtime.
- Moves decoder lookup tables from RAM to ROM.
Scope Reduction:
- Removed frontend, GUI, and rendering dependencies.
- delete src/frontend, src/target, and associated design docs.
Most importantly, this commit starts the transition of this codebase
from C++ to C. I cant stand creating C++ code, and since no one else
is contributing to this project this change shouldnt matter.
Signed-off-by: Ronald Caesar <github43132@proton.me>
62 lines
1.7 KiB
C
62 lines
1.7 KiB
C
/**
|
|
* @file arm32.h
|
|
* @brief A32 Instruction Decoder Interface.
|
|
*
|
|
* @details
|
|
* This module provides the interface for decoding 32-bit ARM instructions
|
|
* into internal metadata structures.
|
|
*
|
|
*/
|
|
|
|
#ifndef POUND_JIT_DECODER_ARM32_H
|
|
#define POUND_JIT_DECODER_ARM32_H
|
|
|
|
#include <stdint.h>
|
|
|
|
/*! @brief Represents static metadata associated with a specific ARM32
|
|
* instruction. */
|
|
typedef struct
|
|
{
|
|
/*! @brief The instruction mnemonic (e.g., "ADD", "LDR"). */
|
|
const char *name;
|
|
|
|
/*!
|
|
* @brief The raw bitstring representation.
|
|
* @details Used during initialization to calculate mask and expected
|
|
* values.
|
|
*/
|
|
const char *bitstring;
|
|
|
|
/*!
|
|
* @brief The bitmask indicating which bits in the instruction word are
|
|
* significant.
|
|
* @details 1 = significant bit, 0 = variable field (register, immediate,
|
|
* etc.).
|
|
*/
|
|
uint32_t mask;
|
|
|
|
/*!
|
|
* @brief The expected value of the instruction after applying the mask.
|
|
* @details (instruction & mask) == expected.
|
|
*/
|
|
uint32_t expected;
|
|
} pvm_jit_decoder_arm32_instruction_info_t;
|
|
|
|
/*!
|
|
* @brief Decodes a raw 32-bit ARM instruction.
|
|
*
|
|
* @details
|
|
* Performs a hash lookup on the provided instruction word to find a matching
|
|
* definition.
|
|
*
|
|
* @param[in] instruction The raw 32-bit ARM machine code to decode.
|
|
*
|
|
* @return A pointer to the instruction metadata if a match is found.
|
|
* @return `nullptr` if the instruction is undefined or invalid.
|
|
*
|
|
* @post The returned pointer (if not null) points to static read-only memory.
|
|
*/
|
|
const pvm_jit_decoder_arm32_instruction_info_t *pvm_jit_decoder_arm32_decode(
|
|
const uint32_t instruction);
|
|
|
|
#endif // POUND_JIT_DECODER_ARM32_H
|