README.md

TFSim

Event-driven simulation of the Tomasulo Algorithm using the C++ interface SystemC, with a complete GUI.

The purpose of this project is to ease the teaching of this algorithm, deemed extremely important to the understanding of out-of-order execution on modern microprocessors.

Guia de Execução

1. Instale os pacotes necessários para uso da biblioteca Nana apt install -y unzip libx11-dev libxft-dev libasound2-dev libxcursor-dev
2. Execute o script na raíz do repositório para instalar as dependências do simulador sh get_dep.sh
3. Execute com ./tfsim

• Para maioria dos benchmarks, arquivos de memória e registradores são carregados juntamente com o conjunto de instruções.

• É possível inserir a lista de instruções e outros valores por linha de comando ou pela barra de opções da interface. Por linha de comando, utilize:

    -  '-q' para fila de instruções
    - '-i' para valores de registradores inteiros (32 valores)
    - '-f' para valores de registradores PF (32 valores)
    - '-m' para valores de memória (500 valores inteiros)
    - '-r' para número de unidades funcionais (3 inteiros, um para cada tipo (ADD,MULT,LOAD/STORE))
    - '-l' para tempo de latência para cada instrução (uma linha para cada instrução, do formato <INSTRUÇÃO> <tempo de latência em ciclos>)
    - '-s' indica que o programa execute em modo de especulação por hardware (com reorder buffer)
    * O repositório fornece arquivos de teste já preenchidos na pasta 'in'
    * Também são fornecidos benchmarks para testes básicos (ideais para validação da ferramenta), incluidos em in/benchmarks
  

• Observações:
  • Caso esteja obtendo erro na compilação do simulador devido a biblioteca stdc++fs, utilize a regra nofs: make nofs
  • Um vídeo de demonstração da execução do simulador pode ser visto aqui

Instruções suportadas:

Sem especulação	Com especulação
DADD	BEQ
DADDI	BNE
DSUB	BGTZ
DSUBI	BLTZ
DMUL	BGEZ
DDIV	BLEZ
LD	SGT
SD	SLT
--	J