# MPMC gem5 Module

This repository contains the MPMC hardware module implemented in the gem5 simulator.
The MPMC (Metagraph Pattern Matching Chip) is a near-memory accelerator designed to
execute node-level metagraph operations efficiently. This implementation models the
architectural behavior of the Fetch, Dispatch, Reservation Station, and Processor Unit
pipeline within the gem5 simulation framework.

## Repository Structure

gem5/
└── src/
    └── MPMC/
        └── MPMC_device/
            ├── *.hh   # Header files for MPMC modules
            ├── *.cc   # Implementation files
            └── SConscript

All gem5-related source code for the MPMC device is located in:

gem5/src/MPMC/MPMC_device

## About gem5

gem5 is an open-source, modular platform for computer-system architecture research.
It supports detailed simulation of CPUs, memory systems, SoCs, and accelerators—making
it suitable for evaluating new hardware concepts such as MPMC.

Official Website: https://www.gem5.org
GitHub: https://github.com/gem5/gem5

## Download and Install gem5

Clone gem5 from GitHub:

    git clone https://github.com/gem5/gem5.git
    cd gem5

Build gem5 (example for X86):

    scons build/X86/gem5.opt -j$(nproc)

Run gem5:

    build/X86/gem5.opt configs/example/se.py --cmd=/bin/ls

## Using the MPMC Module in gem5

After adding the MPMC code into gem5/src/MPMC/MPMC_device, rebuild gem5:

    scons build/X86/gem5.opt -j$(nproc)

Instantiate the MPMC device through your gem5 Python configuration script.

## License

This project follows the licensing terms of the gem5 simulator.