Máquinas de estado no Arduino, com um jogo para você jogar
- 526componentes na bancada
- 46placas rodando agora
- 1.00xtempo real, em todas as placas
Cedo ou tarde todo sketch precisa fazer as coisas em ordem e ainda reagir ao mundo: esperar um botão, depois esperar um tempo aleatório, depois acender uma lâmpada, depois medir quanto tempo você leva para apertar de novo. Escrito com delay() e ifs aninhados, isso vira um programa difícil de acompanhar e surdo à entrada metade do tempo. Uma máquina de estados é a saída padrão, e ela não precisa de nada além de um enum e uma variável.
O circuito acima é um jogo de reação em um Uno com um botão no pino 2 e três lâmpadas. O programa tem quatro estados: READY (a lâmpada vermelha no pino 13 está acesa, esperando você apertar), ARMED (tudo apagado, esperando de 0,7 a 2 segundos aleatórios), RUNNING (a lâmpada amarela no pino 12 está acesa, o relógio está correndo) e DONE (a lâmpada verde no pino 11 indica que a rodada acabou). Aperte Rodar, aperte o botão uma vez e espere o amarelo.
Quer a versão passo a passo? A aula "Uma variável que diz onde você está" percorre isso com checkpoints.
Abrir a aulaO que o monitor serial diz a você
O sketch imprime cada mudança de estado, então o monitor serial é um log da máquina. Uma rodada que jogamos mostrou: "state: READY", "state: ARMED", "state: RUNNING", "reaction: 861 ms", "state: READY". Aperte durante o ARMED e você recebe "too early", direto para DONE, e de volta ao READY 1,2 segundos depois.
Esse log é o primeiro motivo para escrever código assim. Quando algo dá errado, você sabe exatamente em qual estado o programa estava e o que o moveu adiante, em vez de adivinhar qual de cinco ifs aninhados era verdadeiro.
O formato do código
Dê nomes aos estados com um enum, guarde o atual em uma variável e dê a cada estado um bloco que diz o que ele faz e o que o move adiante. Um auxiliar, enter(), muda o estado e anota o tempo, então todo estado sabe há quanto tempo está ativo sem manter seu próprio timer.
Repare no que não está lá. Não há delay() em lugar nenhum. Cada passagem pelo loop() lê o botão, verifica o estado e retorna em microssegundos, então o botão é lido milhares de vezes por segundo em todos os estados. A espera é feita comparando millis() com o momento em que o estado foi entrado, o mesmo padrão que a página blink sem delay usa para dois LEDs.
enum State { READY, ARMED, RUNNING, DONE };
State state = READY;
unsigned long enteredAt = 0;
static void enter(State next) {
state = next;
enteredAt = millis();
}
// in loop(), after reading the button into justPressed:
if (state == READY) {
if (justPressed) {
waitMs = random(700, 2000);
enter(ARMED);
}
} else if (state == ARMED) {
if (justPressed) {
enter(DONE); // too early
} else if (now - enteredAt >= waitMs) {
enter(RUNNING);
}
} else if (state == RUNNING) {
if (justPressed) {
Serial.println(now - enteredAt); // the reaction time
enter(DONE);
}
} else { // DONE
if (now - enteredAt >= 1200) enter(READY);
}Eventos, não níveis
A máquina reage a justPressed, que é verdadeiro por exatamente uma passagem do loop() quando o botão vai de solto para pressionado. Se ela reagisse a "o botão está pressionado", um único aperto segurado por um quarto de segundo seria visto centenas de vezes e atravessaria a máquina direto de READY e ARMED até uma largada falsa. Detectar a borda, com um debounce de 25 milissegundos para que o bounce de contato não conte como apertos extras, é o que faz um aperto ser um evento.
Esse é o bug de máquina de estados mais comum numa bancada de verdade: uma transição dirigida por um nível onde era preciso uma borda. Se um estado parece ser pulado, verifique o que move a máquina adiante.
Desenhe antes de escrever
Antes de escrever uma máquina de estados, desenhe-a: um círculo por estado e uma seta por transição, com o evento que a causa escrito na seta. Para este jogo, são quatro círculos e cinco setas: READY para ARMED com um aperto, ARMED para RUNNING quando a espera aleatória acaba, ARMED para DONE com um aperto (cedo demais), RUNNING para DONE com um aperto e DONE para READY após 1,2 segundos. Se você não consegue desenhar uma seta para algo que o programa precisa fazer, falta um estado ou um evento no design, e é muito mais barato descobrir isso no papel.
O desenho também vira sua lista de testes. Cada seta é um caso para experimentar uma vez. No simulador você percorre as cinco em menos de um minuto: aperte uma vez e espere, aperte duas vezes rápido, aperte uma vez e de novo quando o amarelo acender. Ver o log serial imprimir cada transição enquanto você faz isso é o teste inteiro. Dois erros que aparecem assim são esquecer de chamar enter() (então enteredAt fica velho e um estado temporizado termina de imediato) e um estado sem saída.
Compare com um sketch que bloqueia
O exemplo Semáforo na galeria roda uma faixa de pedestres do outro jeito: uma sequência direta de luzes com delay() entre elas. Funciona, mas só porque o botão de pedido está numa interrupção; sem isso, um aperto durante um delay() seria perdido. Abra com o botão abaixo e leia os dois sketches lado a lado.
Reescrever a faixa como uma máquina de estados (GREEN, AMBER, WALK, FLASHING) elimina a necessidade da interrupção, e adicionar uma nova regra, como "manter o verde por pelo menos três segundos", vira uma condição extra em um bloco, em vez de uma reestruturação do loop inteiro.
Abra este circuito no editor. Arduino Uno: um jogo de reação com quatro estados, ligado como roda no topo desta página. Troque um componente ou um valor e rode de novo.
Perguntas
Devo usar switch ou if e else if?
Qualquer um funciona. Um switch na variável de estado é comum e faz o compilador avisar sobre um valor do enum que você esqueceu de tratar, desde que você lembre de um break no fim de cada case. O exemplo usa if e else if porque fica legível em um sketch curto.
Como adiciono um novo estado?
Adicione um nome ao enum, adicione um bloco para ele e adicione as transições de entrada e de saída. Nada mais no programa precisa mudar, e é essa a graça do padrão.
Uma máquina de estados pode rodar junto com outro código?
Sim, desde que nada em loop() bloqueie. Várias máquinas podem rodar lado a lado, cada uma com sua própria variável de estado, porque cada uma faz só um pouquinho de trabalho por passagem.
Onde faço algo uma única vez quando um estado começa?
Na transição, logo antes ou depois de chamar enter(). O exemplo sorteia a espera no momento em que entra em ARMED, então a espera é escolhida uma vez por rodada, e não a cada passagem.
Continuar
Monte isto de verdade
Abra o editor, mude um valor e veja o número mudar junto. Nada para instalar, e não precisa de conta.