The HSAIL Simulator

Note: this page is a work in progress...

The HSA Foundation has open sourced the following repositories on github

• libHSAIL (tools for parsing, assembling and disassembling HSAIL)
• an HSAIL Instruction Set Simulator
• OKRA interface to the HSAIL Simulator

The AMD Sumatra prototype (webrev under review) can run using the OKRA interface to the HSAIL simulator.  Similarly,  graal with the new HSAIL backend (webrev under review) can run using this OKRA interface.

The HSAIL simulator and associated OKRA interface are currently limited to Linux.  To build, the simulator with its OKRA interface, follow the directions at https://github.com/HSAFoundation/Okra-Interface-to-HSAIL-Simulator#okra-interface-to-hsail-simulator.  This procedure will build the assembler, simulator and okra interface.   Run the indicated sanity tests on that page to confirm a proper build.

As a perhaps more interesting sanity test, you can run junit tests in the graal hsail backend by doing the following:

• add okra/dist/bin (from the simulator build above) to $PATH and to $LD_LIBRARY_PATH
• hg clone http://hg.openjdk.java.net/graal/graal
• apply the patch from the hsail backend webrev to graal (link to be added)
• mx --vm server build product
• mx --vm server unittest @-G:-RemoveNeverExecutedCode  --J @-Dsun.boot.library.path=$LD_LIBRARY_PATH hsail.test
  • The -RemoveNeverExecutedCode directive is there because the current HSAIL backend cannot handle the deoptimization that would be required when a previously never executed path is then taken.

To be added: instructions for building and running Sumatra prototype thru Graal to the simulator.