Ir para o conteúdo principal

Referência do wokwi-analog-joystick

Joystick analógico com dois eixos (horizontal/vertical) e um botão de pressão integrado.

Nome dos Pinos#

NomeDescrição
VCCFonte de alimentação positiva
VERTSaída do eixo vertical (analógica)
HORZSaída do eixo horizontal (analógica)
SELBotão de pressionar
GNDTerra

A tensão da posição ociosa é VCC/2. Movendo o joystick ao longo do eixo vertical altera a tensão do pino VERT de 0 volts (inferior) para VCC (superior). Movendo o joystick ao longo do eixo horizontal muda as tensões do pino HORZ de 0 volts (direita) para VCC (esquerda).

O pino SEL está normalmente aberto (flutuante). Clicando no centro do joystick conecta o pino SEL ao terra. O botão do joystick simula [bouncing] (wokwi-pushbutton # salto) por padrão. Você pode desativar o bouncing definindo o atributo "bounce" como "0".

Atributos#

NomeDescriçãoValor padrão
bounceDefina como "0" para desativar o bouncing""

Operando o Joystick#

Você pode operar o joystick com o mouse movendo o cursor sobre o joystick. Você irá ver quatro setas, correspondendo às quatro direções do movimento, e um círculo no meio. Clique em uma das setas para mover o eixo do joystick nessa direção e no círculo no meio para pressionar o botão do joystick (conectado ao pino SEL).

Para operar o joystick com o teclado, primeiro foque nele (usando a tecla tab ou clicando nele com o mouse), a seguir use as teclas de seta para mover o eixo do joystick e a tecla de espaço para pressionar o botão do joystick (conectado ao pino SEL). É possível combinar várias chaves de uma vez, por exemplo seta para a esquerda e seta para cima, para mover o eixo na direção diagonal. Você também pode pressionar a tecla de espaço enquanto mantém pressionadas as setas para pressionar o joystick enquanto move o eixo.

Movimento parcial e controle por touch não são suportados no momento. No entanto, adoraríamos vê-los suportados - então, se você estiver à altura da tarefa, há uma solicitação aberta esperando pelo seu carinho.

Usando o joystick no Arduino#

Pino do joystickPinos ArduinoPin de código de exemplo
VCC5V
VERTqualquer pino analógico (A0...A5)A0
HORZqualquer pino analógico (A0...A5)A1
SELqualquer pino digital2
GNDGND

Para usar o Joystick no Arduino, conecte os pinos VERT e HORZ aos pinos analógicos (A0...A6) e configure esses pinos como entrada. Leia a posição do joystick usando analogRead().

#define VERT_PIN A0
#define HORZ_PIN A1
#define SEL_PIN 2
void setup() {
pinMode(VERT_PIN, INPUT);
pinMode(HORZ_PIN, INPUT);
pinMode(SEL_PIN, INPUT_PULLUP);
}
void loop() {
int vert = analogRead(VERT_PIN);
int horz = analogRead(HORZ_PIN);
bool selPressed = digitalRead(SEL_PIN) == LOW;
// horz vai de 0 (direita) a 1023 (esquerda)
// vert vai de 0 (parte inferior) a 1023 (parte superior)
// selPressed é true se o joystick estiver pressionado
}

Tabela de Posição do Joystick#

A tabela a seguir mostra as diferentes posições do joystick e os valores HORZ/VERT correspondentes, conforme retornado por analogRead():

PosiçãoHORZVERTJoystick
Superior-Esquerda10231023
Superior5121023
Superior-Direita01023
Esquerda1023512
Central512512
Direita0512
Inferior-Esquerda10230
Inferior5120
Inferior-Direita00

Usando o map()#

Você pode usar a função map() para mapear novamente os valores para um intervalo diferente. Por exemplo, map(analogRead(HORZ_PIN), 0, 1023, -100, 100) retornará -100 quando o joystick estiver totalmente para a direita, 0 quando o joystick estiver centralizado e 100 quando o joystick estiver totalmente à esquerda.

Exemplos no Simulador#

  • Etch-a-sketch - Um jogo de desenho simples usando uma Matriz de LED MAX7219