Aprender

Um joystick para Arduino, lido e desenhado em oito LEDs

Intermediário

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Arduino Uno: gráfico de barras com joystickao vivo0.000 s 0.00x
Arraste o joystick ou aperte-o para trocar os eixos
O exemplo do gráfico de barras em um ATmega328P simulado. Arraste o joystick para mover a barra e aperte-o para ler o outro eixo.

O módulo de joystick que vem em todo kit inicial, o KY-023 e seus clones, parece uma peça de controle de videogame e na verdade são dois potenciômetros e um botão de apertar sob uma única tampa. Isso o torna um dos melhores componentes para aprender entrada analógica, porque você sente o número mudar ao movê-lo. O circuito acima é um Arduino Uno lendo um eixo de um joystick e desenhando-o como uma barra em oito LEDs, rodando agora no seu navegador com o mesmo sketch que você pode ler abaixo.

Arraste a tampa preta no canvas e a barra a acompanha. Solte e ela volta à posição central, com quatro lâmpadas acesas. Aperte o joystick para baixo e a barra muda para o outro eixo, e o monitor serial diz qual deles você está vendo.

O que você precisa

  • Um Arduino Uno
  • Um módulo de joystick de dois eixos (KY-023 ou similar)
  • Oito LEDs: três verdes, três amarelos e dois vermelhos
  • Oito resistores de 220 ohms, um por LED
  • Uma protoboard e jumpers

Ligação

Componente e pinoVai paraNota
VCC do joystick5 VAlimenta as duas trilhas do potenciômetro
GND do joystickGNDA outra ponta das duas trilhas
VRX do joystickA0O cursor do eixo X
VRY do joystickA1O cursor do eixo Y
SW do joystickPino 12Liga ao GND quando pressionado; o pull-up interno mantém o nível alto
Oito LEDs, cada um com 220 ohmsPinos 2 a 9Da esquerda para a direita, catodos no GND

O que há dentro de um módulo joystick

Cada eixo é um potenciômetro de 10 k com uma ponta no VCC, a outra no GND e o cursor no VRX ou VRY. Inclinar o joystick move o cursor, então o pino vê uma tensão em algum ponto entre 0 e 5 volts: cerca de 2,5 volts em repouso, perto de 0 em uma extremidade do curso e perto de 5 na outra. É exatamente o divisor de tensão que você montaria com um botão, só que com uma mola que devolve o cursor ao centro.

O botão é mais simples ainda. Pressionar a tampa fecha uma chave de SW para o terra, e nada mais. Não há resistor na maioria dos módulos, então o pino precisa de um pull-up para ler HIGH quando o botão não está pressionado, e o Uno já tem um embutido que o sketch ativa com INPUT_PULLUP. Pressionado lê LOW.

Como os eixos são apenas tensões, o módulo funciona também em uma placa de 3,3 volts. Alimente-o com 3,3 V e o mesmo joystick lê de 0 a 3,3 volts. Em um ESP32 o conversor tem doze bits, então a escala completa vai de 0 a 4095 em vez de 0 a 1023.

A leitura: analogRead e map

analogRead(A0) turns the voltage on the pin into a number from 0 to 1023, where 0 is 0 volts and 1023 is the 5 volt reference. A centered stick reads somewhere near 512. The sketch then uses map() to turn that 0 to 1023 range into a number of lamps from 0 to 8, and lights that many LEDs from the left. That really is the whole bar graph: the meter is one line of arithmetic, and the LEDs are only where the answer is written down.

map() pode retornar 8 para uma leitura de exatamente 1023, que é um além do último índice do vetor, então o sketch limita o valor a 8 lâmpadas. Ele também só imprime no monitor serial quando o número de lâmpadas muda, o que mantém o monitor legível em vez de rolar centenas de linhas idênticas por segundo.

O loop, do exemplo do gráfico de barras
void loop() {
  if (stick.clicked()) {
    useY = !useY;
    Serial.println(useY ? "reading the Y axis" : "reading the X axis");
  }

  int raw = useY ? stick.y() : stick.x();
  int lit = (int)map(raw, 0, 1023, 0, LEDS);
  if (lit > LEDS) {
    lit = LEDS;
  }
  bar(lit);
  delay(40);
}

A função auxiliar e a versão Arduino pura

O exemplo usa um pequeno header que acompanha o Mokxi, mokxi_joystick.h. Nada de mágica: x() e y() são analogRead nos dois pinos de eixo, pressed() é digitalRead em SW comparado com LOW, e clicked() é verdadeiro uma vez por pressionada, na borda, para que segurar o joystick pressionado não fique alternando o eixo sem parar.

Em um Uno de verdade sem esse header, escreva você mesmo as mesmas três coisas: pinMode(12, INPUT_PULLUP) no setup(), analogRead(A0) e analogRead(A1) para os eixos, e guarde o último estado do botão para agir só quando ele muda de HIGH para LOW. O restante do sketch é código Arduino padrão e roda sem alterações.

O header também tem dx() e dy(), que medem a partir de onde o joystick estava em repouso quando begin() rodou e ignoram uma pequena zona morta ao redor. Use-as para guiar um jogo ou um robô, onde um joystick que repousa em 519 em vez de 512 ainda deve contar como parado. O gráfico de barras usa a leitura bruta de propósito, porque deve ficar meio aceso quando o joystick está centralizado.

Experimente no editor

Abra o circuito e mude LEDS e a lista de pinos para usar só quatro lâmpadas. A barra agora se move em passos maiores, porque map() está dividindo a mesma faixa em menos partes.

Depois faça um indicador de direção em vez de uma barra: acenda só a lâmpada na posição lit em vez de todas as lâmpadas abaixo dela. É uma mudança de um caractere na função bar(), de i < lit para i == lit.

Por fim, adicione um servo no pino 10 e envie map(raw, 0, 1023, 0, 180). O joystick agora controla um servo, que é o começo de um suporte pan and tilt ou de um braço robótico.

Erros comuns

Esquecer o pull-up em SW. Sem INPUT_PULLUP o pino do botão fica flutuando e lê pressionadas aleatórias, muitas vezes só de encostar nos fios.

Esperar exatamente 512 em repouso. Joysticks reais ficam alguns passos para cada lado do centro, e cada eixo assenta de um jeito. Meça a posição de repouso na inicialização ou use uma zona morta.

Trocar VRX e VRY, ou descobrir que um eixo funciona invertido. Ambos são normais: os módulos vêm montados em orientações diferentes. Troque os pinos no código ou inverta a leitura com 1023 - raw.

Sem resistores nos LEDs. Cada LED precisa do seu próprio resistor de 220 ohms para manter a corrente em um nível seguro para o pino.

Abra este circuito no editor. Arduino Uno: gráfico de barras com joystick, ligado como aparece no topo desta página. Troque um componente ou um valor e rode de novo.

Abrir o circuito

Perguntas

Como conecto um joystick a um Arduino?

VCC no 5 V, GND no GND, VRX e VRY em dois pinos analógicos como A0 e A1, e SW em qualquer pino digital com o pull-up interno ativado. Leia os eixos com analogRead e o botão com digitalRead.

Quais valores um joystick de Arduino dá?

Em um Uno cada eixo lê de 0 a 1023, com o centro perto de 512. Em uma placa de 12 bits, como um ESP32, lê de 0 a 4095. O botão lê LOW quando pressionado e HIGH quando solto.

Posso usar um joystick com uma Raspberry Pi Pico?

Sim, nos pinos de ADC: GP26 e GP27 para os dois eixos, e qualquer outro pino para o botão. O conversor da Pico é simulado, então analogRead lê o joystick e o header do joystick compila para ela.

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.