The square test is used to test the GCN3-GPU model.

Compiling square, compiling the GCN3_X86 gem5, and running square on gem5 is dependent on the gcn-gpu docker image, built from the util/dockerfiles/gcn-gpu/Dockerfile on the gem5 stable branch.

Compiling Square

By default, square will build for all supported GPU types (gfx801, gfx803)

cd src/gpu/square
docker run --rm -v ${PWD}:${PWD} -w ${PWD} -u $UID:$GID make

The compiled binary can be found in the bin directory.

A pre-built binary can be found at

Compiling GN3_X86/gem5.opt

The test is run with the GCN3_X86 gem5 variant, compiled using the gcn-gpu docker image:

git clone
cd gem5
docker run -u $UID:$GUID --volume $(pwd):$(pwd) -w $(pwd) scons build/GCN3_X86/gem5.opt -j <num cores>

Running Square on GCN3_X86/gem5.opt

docker run -u $UID:$GUID --volume $(pwd):$(pwd) -w $(pwd) gem5/build/GCN3_X86/gem5.opt gem5/configs/example/ -n 3 -c bin/square