# Diagnóstico: sintomas e causas As falhas mais comuns de cada fluxo, com a causa e a correção. Regra geral que resolve metade dos casos: leia a primeira mensagem de erro, não a última, e clique no link de linha. ## Botões desabilitados | Botão cinza | Falta | |---|---| | {guilabel}`Compilar C±` | um fonte do processador ({file}`.cmm` ou {file}`.cpp`) aberto e em foco no editor | | {guilabel}`Sintetizar Verilog`, {guilabel}`Abrir PRISM` | um Top Level definido | | {guilabel}`Analisar Verilog`, {guilabel}`Configuração de ondas` | um Testbench Top definido | | {guilabel}`Execução rápida` | testbench definido, e Verilator selecionado ou testbench em Python | | {guilabel}`Teste do processador sintetizado` | um processador ativo (o {file}`.cmm` dele em foco) | | engrenagem de configuração | idem | Um caso à parte: se o clique abre o diálogo {guilabel}`Componente não instalado`, não falta pré-requisito de projeto — falta a ferramenta. {guilabel}`Baixar agora` resolve na hora, e o painel completo está em {doc}`../diaadia/apoio`. ## Projeto O nome foi recusado : Nomes de projeto aceitam letras, números, hífen e sublinhado, sem espaços e sem acentos. O nome do processador é mais estrito, porque vira módulo Verilog: só letras sem acento, dígitos e `_`, sem hífen, sem dígito nem `__` no começo, e nenhuma palavra reservada do Verilog. Aviso de arquivos ausentes na árvore : O {file}`.spf` lista arquivos que sumiram do disco (movidos ou apagados por fora). O botão do aviso remove as referências, com confirmação. ## Compilação C± Cada mensagem do compilador, com a causa e a correção, está no manual do YANC: [as mensagens mais comuns, explicadas](https://www.nipscern.com/library/yanc/messages.html) e [a lista completa](https://www.nipscern.com/library/yanc/reference/messages.html). Aqui ficam os casos em que a AURORA entra no meio. O compilador aponta uma linha : O link abre o editor no ponto. Erros em cascata quase sempre derivam do primeiro. `Constante aproximada` : A constante não cabe exata no formato de ponto flutuante escolhido. Informativo; se a precisão incomodar, aumente a mantissa ({doc}`../avancado/ponto-flutuante`). O total de bits foi recusado : `NUBITS` deve ser igual a `NBMANT + NBEXPO + 1`. Vale no Hub e nas diretivas. Arquivo na pasta de saída mas o terminal mostra erro : O arquivo é de uma compilação anterior. Vale o terminal. `#PRNAME não existe mais` : Desde o YANC 7.1 o nome do processador é o nome do arquivo. Apague a linha; para outro nome, renomeie o processador. O nome do arquivo não serve de processador : O nome vira módulo Verilog: só letras sem acento, dígitos e `_`, sem dígito nem `__` no começo, e nenhuma palavra reservada do Verilog. Renomeie o processador. O fonte não tem o nome do processador : Um {file}`outro.cmm` dentro da pasta do processador `filtro` geraria o módulo `outro`. Renomeie o arquivo para {file}`filtro.cmm`, ou mova-o para um processador com o nome dele. ## Validação Verilog `Unknown module type: X` : Um módulo instanciado não está em nenhum fonte do projeto. Se `X` é um processador, compile o C± dele antes; o {file}`.v` gerado precisa existir. Portas incompatíveis : A instância diverge da definição. O analisador semântico do editor aponta antes do botão. ## Simulação e ondas A simulação termina antes do resultado : Poucos ciclos. Engrenagem do processador, aumente o número de clocks. A onda abre sem os sinais internos do processador : Com o Verilator, os monitores de pilha e ULA entram por espelhos no testbench, mas o miolo mais profundo fica de fora; e um programa sem funções não tem pilha de instruções para monitorar. Para ver tudo, troque para o Icarus. A simulação aborta citando o arquivo de onda : O arquivo da rodada anterior está aberto em outro programa ou ficou somente-leitura, e a AURORA prefere abortar a mostrar uma onda velha como se fosse nova. Feche o visualizador (GTKWave/Surfer) e simule de novo. `$fopen devolveu 0` ou "invalid file descriptor" : O testbench abre um arquivo que não existe ou não pode ser escrito. A AURORA avisa antes de rodar quando o caminho de leitura não existe; confira os caminhos dos `$fopen` do testbench. Sinal selecionado não aparece : A seleção de ondas referencia um sinal que não existe mais (código mudou). Reabra a {guilabel}`Configuração de ondas` e salve de novo; a AURORA remove as referências mortas. O testbench não encontra os dados : {file}`input_N.txt` ausente ou com linha inválida. Um inteiro por linha, sem vazios. cocotb reprova os testes mas a onda abre : Comportamento intencional: a onda é a ferramenta de investigação da falha. O veredito de cada teste está no TWAVE. cocotb não acha o módulo alvo : Falta a linha `# aurora-toplevel: nome` no {file}`.py`, ou o nome não confere. ## PRISM Grande demais para simular ao vivo : O módulo passa do limite de células do modo {guilabel}`Simular`. Abra um submódulo menor no esquemático e simule aquele; o diagrama estático não tem limite prático. O relógio não bate na simulação do PRISM : O modo só cria relógio para uma entrada de um bit chamada `clk` ou `clock` no módulo simulado. Sem ela, avance com {guilabel}`Tick`. Diagrama desatualizado : {guilabel}`Recompile` na própria janela do PRISM. ## Quando nada explica - Ligue o modo verboso ({guilabel}`Configurações`, {guilabel}`Terminal`) e repita: os comandos completos de cada etapa aparecem no terminal. - O {guilabel}`Histórico de compilações` (relógio na barra dos terminais, {kbd}`Ctrl+Shift+H`) mostra o que cada clique fez e o estado do projeto na hora, o que ajuda a reconstruir o caminho até o erro. - Rode {guilabel}`Verificar e consertar` na aba {guilabel}`Componentes`: ele limpa os caches de compilação, confere os arquivos de cada componente e baixa de novo o que estiver incompleto ou quebrado — o conserto clássico para uma toolchain que o antivírus mordeu. - Use o {guilabel}`Relatar um problema` da barra lateral das Configurações: o relato já vai com o diagnóstico da instalação e o terminal recortado em volta dos erros, e a tela mostra tudo antes de enviar.