O editor

Rodar e o monitor serial

O que Rodar faz de verdade, o que o painel de leitura significa e como conversar com uma placa.

Apertando Rodar

Há dois botões Rodar e são o mesmo botão: um no cabeçalho, um na barra de ferramentas do canvas. Os dois viram Parar enquanto um circuito está rodando.

Rodar faz três coisas em ordem. Ele monta uma netlist a partir do diagrama, que é quando a protoboard deixa de existir (trilhas e fios são achatados em nós). Ele compila o firmware de qualquer placa que precise compilar, como o editor de código e a compilação descreve. Então inicia o motor.

O motor roda em um Web Worker, não na própria thread da página, e devolve um instantâneo por quadro de animação. É por isso que o canvas continua fluido enquanto uma placa executa cento e sessenta milhões de instruções por segundo.

Editando enquanto roda

Você pode. O circuito se reconstrói um momento depois que você para de editar, então uma sequência de mudanças é uma reinicialização em vez de vinte. Segurar um botão, girar um potenciômetro e digitar no monitor serial funcionam no circuito rodando.

A leitura

O cabeçalho mostra dois números, por exemplo 12.480 s 1.00x.

A primeira é o tempo simulado: há quanto tempo o circuito está rodando no próprio mundo dele. A segunda é a velocidade em relação ao relógio de parede. 1.00x significa que a simulação está no ritmo do tempo real, que é o que você quer. Abaixo disso, o circuito está rodando mais devagar do que o real rodaria; a simulação está lenta diz o que causa isso.

Ao lado da leitura está o selo do motor, que diz se o motor WebAssembly está funcionando.

Mostrar níveis

Para ler o que um circuito está fazendo em vez de só assistir, ative Mostrar níveis, no menu de mais da barra de ferramentas do canvas, ou aperte Shift+L. Todo nó que tem um fio ligado passa a carregar uma pequena leitura ao vivo: H para um nó em nível alto, L para um em nível baixo, X onde dois drivers de força igual discordam e Z para um nó que nada está dirigindo, cada um com a tensão do nó com duas casas decimais ao lado. Um nó que você nomeou mostra a leitura embaixo do nome e os demais mostram a deles no trecho livre dos fios, nunca sobre um componente. Os números são redesenhados a cada quadro, então um divisor de clock ou um registrador de deslocamento pode ser lido um nó por vez na frente de uma turma.

Ele fica desligado até você ligar, e este navegador lembra sua resposta. Pare a simulação e o último quadro fica na tela, em cinza, que normalmente é o que vale a pena comentar. Dê zoom suficiente para afastar e as leituras somem, então uma placa inteira continua sendo uma placa, e uma imagem exportada nunca as carrega: uma exportação é do circuito, não de um momento dele rodando.

O monitor serial

A faixa na parte de baixo da janela. Tudo que uma placa escreve na UART dela chega aqui como texto: UTF-8 decodificado conforme chega, retornos de carro descartados, \n encerrando uma linha. Uma linha escrita pela metade é mostrada conforme chega, em vez de ficar retida até o caractere de nova linha.

  • Limpar esvazia o log. Ele guarda as últimas duas mil linhas de todas as placas e descarta as mais antigas depois disso.
  • Pausar leitura impede que um leitor de tela leia cada linha nova em voz alta. O log continua enchendo, e você ainda pode lê-lo linha por linha.
  • A linha de entrada no pé envia bytes de volta para uma placa. Digite e aperte Enter, ou aperte Enviar.
  • Com mais de uma placa falando, cada linha vem prefixada com a placa de origem, e um seletor escolhe com qual placa a linha de entrada está falando.

Cada placa tem seu próprio decodificador, então duas placas escrevendo ao mesmo tempo nunca intercalam bytes dentro de uma linha.

As outras abas

A barra do monitor serial tem botões que trocam o painel de baixo por outra visualização, cada um com Voltar para retornar. No celular, eles ficam em Mais na folha inferior. Um botão aparece só onde se aplica.

Button O que abre
Checkup a ligação e o código verificados juntos (Checkup)
Gráfico o plotter serial
Osciloscópio o osciloscópio com cursores, medições, XY e espectro
Lógica a aba do analisador lógico
Notas o caderno de laboratório com as leituras que você fixou (instrumentos da bancada)
Web a página servida pela placa (WiFi, simulado)
Nuvem todas as requisições na rede simulada (WiFi, simulado)
Bluetooth o telefone (Bluetooth, simulado)
Mokxi AI Mokxi AI
Depurar o depurador

Quais pinos carregam serial

O monitor serial é ligado direto à UART da placa, não a pinos na protoboard. No Uno é a USART0, no ESP32-C3 é a UART0, no Pico a UART0 e no STM32F411 a USART1. No hardware real esses sinais dividem pinos com GPIO; aqui os pinos continuam GPIO e os bytes vão para o monitor.

Se não funcionar

Nada aparecendo? O monitor serial não mostra nada. Rodando devagar? A simulação roda lenta.