| 1 | ============================================================================== |
| 2 | Instructions for OpenSPARC T2 Version 1.0 Architecture and Performance |
| 3 | Modeling |
| 4 | ============================================================================== |
| 5 | |
| 6 | 1. Download OpenSPARCT2_Arch_1.0.tar.bz2 file to your directory. e.g. you |
| 7 | downloaded this file to "/home/johndoe/OpenSPARCT2_SAM" directory. |
| 8 | |
| 9 | 2. Unzip downloaded file by using following command: |
| 10 | |
| 11 | bunzip2 OpenSPARCT2_Arch.1.0.tar.bz2 |
| 12 | |
| 13 | This step will create OpenSPARCT2_Arch.1.0.tar file. |
| 14 | |
| 15 | 3. Extract files from tar file by using following command: |
| 16 | |
| 17 | tar xvf OpenSPARCT2_Arch.1.0.tar |
| 18 | |
| 19 | 4. Setup environment variables by editing OpenSPARCT2_SAM.cshrc file. |
| 20 | |
| 21 | Please set the following variables in OpenSPARCT2_SAM.cshrc file |
| 22 | |
| 23 | SIM_ROOT Directory location where you Extracted |
| 24 | the OpenSPARCT2_SAM.tar file. e.g. |
| 25 | /home/johndoe/OpenSPARCT2_SAM |
| 26 | |
| 27 | SUN_STUDIO Directory location for Sun Studio installation |
| 28 | e.g. /usr/dist/pkgs/sunstudio_sparc/SUNWspro |
| 29 | |
| 30 | 5. Source the environment variable file above by using following command : |
| 31 | |
| 32 | source OpenSPARCT2_SAM.cshrc |
| 33 | |
| 34 | You may want to add the above command to your ~/.cshrc file, so that |
| 35 | every time you login, it will source the above file. |
| 36 | |
| 37 | 6. This pacakge includes : |
| 38 | |
| 39 | 1. sam-t2 directory : SPARC Architecture Model with SPARC |
| 40 | Architecture Simulator (SAS) |
| 41 | |
| 42 | See README.sam for more details on how run SAM, build SAS etc. |
| 43 | |
| 44 | 2. legion directory : Faster SPARC system simulator for Software developers |
| 45 | |
| 46 | See README.legion for more details on how setup/run Legion. |
| 47 | |
| 48 | 3. README files : |
| 49 | README, README.sam, |
| 50 | README.legion, README.hypervisor, |
| 51 | README.obp |
| 52 | |
| 53 | 4. S10image directory : Binary images suitable for simulation. This includes |
| 54 | Binary images of Solaris 10, Open Boot PROM, Hypervisor. All these |
| 55 | are used for simulations with SAM and Legion. |
| 56 | |
| 57 | 5. bin directory : Set of scripts to build OBP, Legion. |
| 58 | |
| 59 | 6. OpenSPARCT2_SAM.cshrc file : Setup for running SAM, Legion. |
| 60 | |
| 61 | 7. License files: |
| 62 | GPLv2_License_OpenSPARCT2.txt |
| 63 | THIRDPARTYLICENSEREADME.txt |
| 64 | BINARY_SLA.txt |
| 65 | BSD+_License.txt |
| 66 | |
| 67 | 8. rst directory : RST is a trace format for SPARC |
| 68 | instruction-level traces. The rst directory contains |
| 69 | source code for trace reader and compressor/decompressor |
| 70 | utility to compress/decompress the traces (rstzip). |
| 71 | rst/README for details on how to compile it. |
| 72 | |
| 73 | 9. hypervisor directory : Source code for Hypervisor. |
| 74 | |
| 75 | 10. obp directory : Source code for OBP. |
| 76 | |
| 77 | 11. t1_fpga directory: Source code for compiling prom.bin for the |
| 78 | FPGA mapped OpenSPARC T1 core. Look at README.t1_fpga for instructions |
| 79 | on how to compile the code. |
| 80 | |