Aprender

Limpeza SOCD explicada

Intermediário

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Pro Micro: limpeza SOCD ao vivoao vivo0.000 s 0.00x
Aperte Rodar, depois segure esquerda e direita juntos
Segure duas setas opostas e leia o Monitor Serial. Clique na chave gangorra para mudar a regra.

SOCD significa Simultaneous Opposing Cardinal Directions, ou seja, direções cardeais opostas ao mesmo tempo: esquerda e direita pressionadas juntas, ou cima e baixo. Na alavanca de um joystick isso não pode acontecer, porque o guia impede a alavanca de ir para dois lados de uma vez. Em um teclado ou em um controle só de botões isso acontece o tempo todo, porque as direções são teclas separadas.

Um jogo não tem um sentido razoável para esquerda e direita ao mesmo tempo, então o firmware do controle decide antes de reportar qualquer coisa. Essa decisão é a limpeza de SOCD. Existem apenas algumas regras em uso comum, cada uma tem poucas linhas de código, e o circuito acima deixa você experimentar duas delas e observar o resultado.

Aperte Rodar e segure duas teclas de seta opostas. O monitor serial mostra o que foi segurado e a direção que saiu, na notação de teclado numérico, onde 5 é neutro, 4 é esquerda e 6 é direita. Os quatro LEDs mostram a mesma direção já limpa. A chave deslizante muda a regra.

As regras comuns

Neutro: duas direções opostas juntas não resultam em nenhuma. Esquerda mais direita é neutro, e cima mais baixo é neutro. É a regra mais simples e nunca produz uma direção que você não quis, mas é preciso soltar um lado antes de o outro registrar de novo.

Última entrada vence: a direção pressionada mais recentemente assume, e soltá-la traz de volta a que ainda está segurada. Segure esquerda, adicione direita, e você tem direita; solte direita e volta para esquerda sem apertar nada. Isso torna possíveis mudanças de direção muito rápidas.

Primeira entrada vence: a direção pressionada primeiro mantém a prioridade, e a segunda é ignorada enquanto as duas estão seguradas. Em código, é o espelho da última entrada vence: uma direção segurada mantém o lugar não importa o que seja adicionado do outro lado, até ser solta.

Prioridade para cima: esquerda mais direita é neutro, mas cima mais baixo resulta em cima. Jogadores usam isso para segurar baixo e tocar cima para pular sem soltar baixo.

Desligado: as duas direções são reportadas e o jogo decide. O GP2040-CE, um firmware de controle de código aberto muito usado, oferece todas essas opções, e sua documentação descreve exatamente o que cada uma faz em cada eixo.

Neutro em código

Trate cada eixo como um número: menos um, zero ou mais um. No eixo horizontal, direita é mais um e esquerda é menos um, então o valor bruto é direita menos esquerda. Quando os dois estão segurados, essa soma já é zero, então a limpeza neutra é o que você ganha de graça com a subtração. O exemplo do fight stick depende exatamente disso.

A direção na notação de teclado numérico é então 5 mais o eixo horizontal mais três vezes o vertical, com cima como mais um. Neutro é 5, cima-direita é 9, baixo-esquerda é 1.

Neutro e última entrada vence
// last is -1 or +1: whichever of the pair went down most recently
int clean(bool negative, bool positive, int last, bool lastWin) {
  if (negative && positive) {
    return lastWin ? last : 0;
  }
  return (positive ? 1 : 0) - (negative ? 1 : 0);
}

Última entrada vence em código

A última entrada vence precisa de um pedaço de memória por eixo: qual lado foi pressionado mais recentemente. O sketch guarda a leitura anterior de cada direção e, quando uma passa de solta para pressionada, registra seu lado. Quando os dois lados estão segurados, o lado registrado vence. Quando um é solto, a subtração simples assume de novo e o outro lado volta sozinho.

Registre a pressão na borda, não no nível. Se o código simplesmente verificasse primeiro "a direita está segurada", a direita venceria sempre e a regra seria na verdade uma prioridade fixa, não a última entrada.

A primeira entrada vence é a imagem espelhada: registre um lado apenas quando o outro lado não estiver já segurado. A prioridade para cima é um caso especial no eixo vertical: se os dois estão segurados, retorne cima.

Por que a limpeza acontece no controle

Se o controle reporta as duas direções, cada jogo lida com isso do seu jeito, e alguns lidam mal. Fazer a limpeza no firmware significa que o jogo só vê estados que uma alavanca poderia produzir, ou uma regra definida, o que é previsível para o jogador e para o jogo.

Isso também significa que a regra faz parte do comportamento do seu controle, e alguns conjuntos de regras de torneios e alguns jogos dizem quais regras um controle pode usar. Se você constrói para competição, confira as regras do evento e do jogo, e deixe o modo fácil de trocar, como a chave deslizante do exemplo faz.

O que o simulador mostra, e o que ele não mostra

Tudo acima roda no Pro Micro simulado como um sketch de verdade: as bordas, a memória da última pressão, a matemática dos eixos e os LEDs. O direcional do gamepad do console está desligado, então seus quatro botões são chaves independentes, como os de um controle sem alavanca.

O que o Mokxi não simula é um console ou PC na outra ponta do cabo. Um sketch que usa Joystick.h ou Keyboard.h imprime no monitor serial cada relatório que enviaria, então você pode ler exatamente o que o host receberia. Em uma placa real esses relatórios vão pela USB, ou você usa um firmware de gamepad que já faz a limpeza.

Abra este circuito no editor. Pro Micro: limpeza de SOCD, ao vivo, ligado como aparece no topo desta página. Mude um componente ou um valor e rode de novo.

Abrir o circuito

Perguntas

O que significa SOCD?

Simultaneous Opposing Cardinal Directions (direções cardeais opostas simultâneas): esquerda e direita, ou cima e baixo, seguradas ao mesmo tempo.

Qual é a diferença entre neutro e última entrada vence?

Com neutro, esquerda mais direita não dá nenhuma direção. Com a última entrada vence, a direção pressionada mais recentemente vence, e soltá-la traz de volta a outra, se ainda estiver segurada.

A alavanca de um joystick precisa de limpeza de SOCD?

O guia de uma alavanca não consegue pressionar direções opostas ao mesmo tempo, então raramente importa. Ainda assim, é barato adicionar, e a limpeza neutra sai de graça da matemática dos eixos.

Qual modo de SOCD devo usar?

Depende do jogo e das regras dos eventos em que você participa. Deixe o modo comutável e confira as regras do evento antes de competir.

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.