# Folha de consulta rápida Uma página para deixar na bancada. Imprima pelo navegador ou pelo PDF do manual. ## O fluxo ```{mermaid} flowchart LR CMM[".cmm"] -->|"Compilar C±"| HW[".v + .mif"] SEUS["seus .v"] --> FONTES["fontes do projeto"] HW --> FONTES FONTES -->|"Sintetizar Verilog"| VAL["validação e hierarquia"] FONTES -->|"Analisar Verilog"| ONDA["forma de onda"] FONTES -->|"Abrir PRISM"| PRISM["diagrama do circuito"] ``` ## Os botões e seus pré-requisitos | Botão | Faz | Exige | |---|---|---| | {guilabel}`Compilar C±` | C± ou C++ até Verilog e memórias | o fonte do processador em foco | | {guilabel}`Sintetizar Verilog` | valida a elaboração, gera a hierarquia | Top Level | | {guilabel}`Analisar Verilog` | simula e abre a onda | Testbench Top | | {guilabel}`Execução rápida` | simula sem onda | Testbench Top e Verilator (ou testbench .py) | | {guilabel}`Teste do processador sintetizado` | roda só a E/S, com arquivos | processador ativo | | {guilabel}`Abrir PRISM` | desenha o circuito | Top Level | | {guilabel}`Simular`, no PRISM | liga o módulo da tela, com relógio e chaves | módulo pequeno o bastante | | {guilabel}`Cancelar` | interrompe o que roda | nada | ## Os papéis | Termo | Significa | Onde se define | |---|---|---| | Top Level | módulo raiz do circuito | botão direito no {file}`.v`, visão Arquivos | | Testbench Top | quem comanda a simulação | botão direito no {file}`.v` ou {file}`.py` | | Processador ativo | o {file}`.cmm` em foco no editor | abrir o arquivo | A barra de status mostra os três o tempo todo. ## Arquivos de um processador ```text /.cmm voce escreve (o nome do arquivo e o do processador) /input_N.txt estimulo, um inteiro por linha //.v + .mif a compilacao gera (levar ao FPGA) //output_N.txt resultado da simulacao ``` ## A regra de ouro do Hub `Total de bits = mantissa + expoente + 1` ## Atalhos que mais valem | | | |---|---| | {kbd}`Ctrl+S` salvar | {kbd}`Ctrl+Shift+F` buscar nos arquivos | | {kbd}`F6` compilar C± | {kbd}`F7` sintetizar Verilog | | {kbd}`F8` simular com onda | {kbd}`F10` abrir o PRISM | | {kbd}`Ctrl+Shift+K` paleta de comandos | {kbd}`Ctrl+K` assistente de IA | | {kbd}`Shift+Alt+F` formatar | {kbd}`Ctrl+Shift+H` histórico de compilações | ## Quando algo der errado Leia a primeira mensagem de erro, não a última; clique no link de linha; e {doc}`diagnostico` tem os sintomas mais comuns. A linguagem, as diretivas e as mensagens do compilador estão no [manual do YANC](https://www.nipscern.com/library/yanc/).