Salas de aula

Verificações corrigidas automaticamente

Escreva as verificações uma vez; cada entrega é medida por elas.

O que é uma verificação

Uma verificação é uma coisa que você espera que o circuito de um aluno faça, escrita em uma frase: o pino 13 pisca a cada 1000 ms, com tolerância de 50 ms. Você adiciona algumas a uma atividade e, a partir daí, todo aluno que apertar Verificar meu trabalho recebe cada uma marcada como aprovada ou reprovada, com o número medido ao lado do número pedido.

A correção roda no motor real, no navegador em que o botão foi apertado. Nada é enviado para lugar nenhum para corrigir, nada entra em fila, e a mesma lista roda do mesmo jeito na sua máquina e na deles.

Adicionando verificações

Na página da turma, abaixo de uma atividade, aperte Verificações. Você vê o que já está lá e um menu Adicionar uma verificação com os tipos abaixo. Cada tipo é uma frase com lacunas: preencha as lacunas e a frase é a verificação.

Dois campos merecem mais explicação.

O que o aluno vê. O nome que você dá a uma verificação é tudo o que a turma lê quando ela falha, então escreva como a coisa que você pediu: "A lâmpada pisca uma vez por segundo", e não "check 1". Se deixar em branco, a frase é usada no lugar.

O pino. Um pino é escrito <part>:<pin>, então uno1:13 é o pino 13 da placa chamada uno1. As caixas oferecem os componentes e pinos que o seu próprio circuito inicial já tem, então normalmente você escolhe em vez de digitar.

Aperte Salvar as verificações quando a lista estiver certa. A lista é salva inteira, então remover uma verificação e salvar é como uma verificação sai da lista.

Testar no projeto inicial

Ao lado de Salvar está Testar no projeto inicial, e é o botão que importa. Ele roda a sua lista contra a sua própria solução, ali mesmo, e mostra cada verificação com o que ela mediu.

Rode antes de passar a tarefa. Uma verificação que falha na sua própria resposta vai falhar em trinta respostas, e é assim que você descobre isso em quatro segundos e não no meio de uma aula.

Os tipos

Tipo O que mede
Um pino está alto ou baixo O nível de um pino em um instante
Um pino pisca O período entre uma borda de subida e a próxima, com a média calculada na janela
Um pino carrega PWM A frequência de chaveamento, e o duty cycle se você informar um
Um pino faz fade O quanto o duty do PWM se move: a janela é cortada em dez fatias, o duty de cada fatia em que o pino estava chaveando é medido, e o maior menos o menor tem que alcançar a amplitude que você informar. Um piscar nunca é um fade
O monitor serial imprime algo Texto ou uma expressão regular, em qualquer lugar do que as placas imprimiram
O monitor serial imprime coisas em ordem Vários padrões, cada um depois do anterior
Um nó está em uma tensão A tensão calculada do nó em que um pino está
Um LED está aceso / apagado O brilho do próprio componente de LED, do jeito que o canvas desenha
Depois que um botão é apertado Aperta um botão e depois mantém um pino em um nível
A placa serve uma página Busca um caminho no servidor web simulado da própria placa e procura texto na página
O sketch compila Se o sketch do aluno compilou

Duas observações sobre os casos mais difíceis. Um check de PWM aceita qualquer valor para o duty cycle, que é a resposta certa para um sketch que faz varredura dele: os exemplos de fade têm uma frequência que vale a pena checar e nenhum duty cycle único. A placa serve uma página só significa algo onde o WiFi é simulado, o que hoje é o ESP32-C3, o ESP32-C6, o ESP32 DevKit, o NodeMCU e o Pico W; veja o artigo sobre WiFi para saber o que essa rede é e o que não é.

O que o aluno recebe

Na página da turma dele, sob a tarefa, Verificar meu trabalho. Isso roda a sua lista no que ele enviou e mostra cada check com a medição e a expectativa:

Falhou A lâmpada pisca uma vez por segundo Piscou a cada 1462 ms. Esperado: pino 13 de uno1 pisca a cada 1 s, com tolerância de 50 ms, observado por 4 s.

Esse é todo o ponto da forma de escrever: um aluno que só ouve "falhou" não aprende nada, e um aluno que descobre que piscou a cada 1462 ms quando você pediu 1000 sabe exatamente qual número mudar.

Nada do seu circuito chega até ele. Ele vê os nomes que você escreveu, o que o circuito dele mediu e o que o check pedia. A sua solução, a sua própria execução e o trabalho de todos os outros ficam onde estão.

O que você recebe de volta

Os resultados sobem junto com o envio. Do seu lado:

  • o mural da turma mostra a pontuação como uma pílula em cada cartão, então você dá uma olhada na sala inteira de uma vez;
  • O que voltou mostra cada envio com a pontuação e todos os checks;
  • todo check que falhou tem um botão Citar que coloca a frase direto na caixa de feedback.

Ainda há um botão, Corrigir, e ele existe por causa de uma limitação honesta. Os resultados de um aluno são o que o navegador dele mediu. O navegador pertence a ele, e um aluno determinado poderia enviar números que nunca foram produzidos. Corrigir roda a mesma lista no mesmo envio na sua máquina, e o painel sempre diz qual das duas está mostrando. Para trabalho que vale algo, aperte Corrigir.

O que um check pode e não pode ver

Um check mede a simulação. É uma medição real de firmware real em um modelo real do chip, e não é uma bancada:

  • O tempo é ideal. O relógio é o relógio do chip como o nosso contrato de placa descreve. Não há deriva de cristal, nem temperatura, nem jitter que não esteja no modelo.
  • Não há ruído analógico. Um nó mostra a tensão que o solver produziu. Um circuito que seria marginal numa protoboard aparece limpo aqui.
  • O brilho de um LED é o do modelo, uma passagem baixa da corrente que passa por ele, e é isso que faz "aceso" significar algo sob PWM. Não é um fotômetro.
  • Nada mecânico é medido. Sem bounce que um componente não modele, sem calor, sem fios caindo.
  • A rede é simulada. A página que uma placa serve vem do nosso próprio runtime e das três origens .mokxi; não há internet por trás.

Onde isso importa, diga à turma. A regra do Mokxi é que o que um aluno vê é preciso ou diz claramente que não é, e todo painel de resultados do produto carrega a linha: cada verificação aqui mede a simulação, não uma bancada: tempo ideal, sem ruído analógico.

Os limites

  • Vinte verificações em uma tarefa.
  • Uma verificação pode observar até sessenta segundos de tempo simulado, e uma execução inteira também é cortada bem antes disso no relógio. Um sketch que espera por algo que nunca acontece volta como tempo esgotado com o que foi medido até aquele ponto, em vez de travar a página.
  • Uma entrega cujo sketch foi editado é compilada antes de ser avaliada, com o mesmo compilador que o editor usa. A primeira compilação no navegador baixa a toolchain, que é um download grande; depois disso ela fica em cache. Um sketch que não compila nunca é avaliado contra o exemplo de que partiu. A execução se recusa, e os resultados dizem por quê.