The utility scripts provided in this directly can be used to recreate the
files needed to run Full System amdgpu. Golden versions of these files are
provided in the gem5-resources repository.

These scripts are intended to be run on a Linux system with a discrete AMD
GPU card running the same kernel version as the disk image which will be used
for Full System simulations. To ensure the kernel versions match, it is
recommended that the user uses the `dd` utility to make a copy of the disk
image to a secondary physical disk and then boot from that disk image.

# MMIO Trace collection

The script `collect_mmio_trace.sh` collects an MMIO trace. For this to work,
MMIO tracing must be enabled in the kernel. Using the disk image approach
above and/or using recent kernel versions based on Ubuntu, this is enabled
by default.

Before collecting the trace, the amdgpu module must be blacklisted such that
we can enable tracing before the modprobe occurs and disabled once modprobe
is complete.

This can be done using either:
    `echo 'blacklist amdgpu' >> /etc/modprobe.d/blacklist.conf`
or
    add `modprobe.blacklist=amdgpu` to kernel boot command (e.g., in grub)
And then reboot.

The script will take care of the proper options and run the mmiotrace
commands. The output trace will likely contain unrelated from other MMIOs
and therefore will be around 500MB in size. You will want to reboot again
as mmiotrace disables SMP.

# GPU ROM Dump

The script `dump_gpu_rom.sh` dumps the GPU ROM. The GPU ROM on x86 resides
in the memory range 0xC0000 - 0xDFFFF. The script simply uses the `dd`
command to copy this range from /dev/mem. The amdgpu driver must be loaded
in order for the ROM to be written to this region, so run `modprobe` first.