Referência do wokwi-logic-analyzer
Analisador lógico digital de 8 canais
Nome dos Pinos
Os pinos D0 a D7 são conectados aos canais de entrada do analisador lógico. Há também um pino GND, que deve ser conectado ao aterramento digital.
Atributos
Nome | Descrição | Valor padrão |
---|---|---|
bufferSize | Número máximo de amostras para coletar | "1000000" |
channelNames | Lista separada por vírgulas de nomes de canais para o arquivo VCD | "D0,D1,D2,D3,D4,D5,D6,D7" |
filename | Nome do arquivo de gravação, sem a extensão | "wokwi-logic" |
triggerMode | Modo de acionamento: "off", "level" ou "edge" | "off" |
triggerLevel | "high" ou "low" | "high" |
triggerPin | "D0" … "D7" | "D7" |
Buffer de Amostras
O analisador lógico usa um buffer para armazenar os dados dos pinos gravados. Cada mudança de nível de pino (por exemplo, baixo para alto) ocupa um slot no buffer. O simulador aloca a memória para o buffer com antecedência, para garantir uma simulação rápida.
Você pode escolher o tamanho do buffer definindo o atributo bufferSize
. Cada slot no buffer usa 9 bytes de RAM. Assim, o tamanho do buffer padrão de 1 milhão de amostras usará cerca de 9 MB de RAM. Alocar um buffer grande pode sobrecarregar seu navegador.
O analisador lógico exibe o número de amostras capturadas durante a execução da simulação. Você pode usar esse número para estimar o tamanho do buffer necessário.
Acionamento
O acionamento controla quando o analisador lógico começa a registrar os dados. Por padrão, o acionamento está desligado, então o analisador lógico captura todos os dados. Você pode configurar o acionamento usando três atributos triggerMode
, triggerPin
e triggerEdge
.
A tabela a seguir resume os modos de acionamento disponíveis:
triggerMode | Descrição | Comportamento |
---|---|---|
"off" | Acionamento desativado | Todos os dados são gravados |
"edge" | Acionamento por borda | Começa a gravar quando triggerPin for igual a triggerLevel |
"level" | Acionamento por nível | Grava apenas enquanto triggerPin for igual a triggerLevel |
O modo "edge" começa a gravar quando triggerPin
muda para triggerLevel
, e continua gravando até que a simulação termine. Por exemplo, se você definir triggerPin
para "D7" e triggerLevel
para "alto" (seus valores por padrão), o analisador lógico começará a gravar quando o pino D7 mudar para nível alto.
O modo "level" é mais versátil: assim como o modo "edge", ele começa a gravar quando triggerPin
mudar para triggerLevel
, mas irá pausar a gravação assim que triggerPin
mudar novamente.
Para exemplos de uso, verifique a seção Usando o Acionamento no Guia do analisador lógico.
Visualizando os Dados
Quando a simulação é interrompida, o analisador lógico baixa um arquivo com as amostras registradas para o seu computador. O arquivo de gravação usa o formato padrão Value Change Dump (VCD). O arquivo é denominado "wokwi-logic.vcd" por padrão, mas você pode configurar o nome usando o atributo filename
.
Para saber como visualizar os dados, visite o nosso Guia do Analisador Lógico.