双轴摇杆模块

Overview

基础概况

摇杆模块通常由两个电位器和一个按压开关组成，ESP32 可用两个 ADC 读取方向，再用 GPIO 读取按下状态。它很适合青少年创客理解模拟输入、死区校准和人机交互。

Engineering

工程要点

难度: 入门
数据状态: 待核实
接口: AOGPIO
常用主控: ESP32ArduinoSTM32Raspberry Pi Pico

供电与采购

供电: 3.3V - 5V
购买关键词: 双轴摇杆模块PS2 摇杆模块XY Joystick Module

典型搭配

摇杆小车

把摇杆方向映射为小车运动控制。

双轴摇杆模块 + ESP32 + L298N 电机驱动模块

交互菜单

用摇杆控制页面选择和确认。

双轴摇杆模块 + OLED 显示屏

Specifications

基础参数

参数	值	分组	备注
工作电压	3.3 - 5 V	电气参数	-
输出	X/Y 两路模拟量 + 1 路按键	接口	-
中位读数	约 ADC 量程一半	数据处理	实际值需要现场校准

Pinout

引脚与接线

引脚	说明	连接建议	注意
VCC	电源正极	ESP32 3.3V	-
GND	地线	GND	-
VRx	X 轴模拟输出	ESP32 GPIO 34	-
VRy	Y 轴模拟输出	ESP32 GPIO 35	-
SW	按压开关输出	ESP32 GPIO 14	-

Examples

代码示例

读取摇杆 X/Y 和按键

python

from machine import ADC, Pin
import time

x = ADC(Pin(34)); x.atten(ADC.ATTN_11DB)
y = ADC(Pin(35)); y.atten(ADC.ATTN_11DB)
sw = Pin(14, Pin.IN, Pin.PULL_UP)

while True:
    print("x:", x.read(), "y:", y.read(), "pressed:", sw.value() == 0)
    time.sleep(0.2)

读取摇杆 X/Y 和按键

cpp

const int xPin = 34;
const int yPin = 35;
const int swPin = 14;

void setup() {
  Serial.begin(115200);
  pinMode(swPin, INPUT_PULLUP);
}

void loop() {
  Serial.print("x=");
  Serial.print(analogRead(xPin));
  Serial.print(" y=");
  Serial.print(analogRead(yPin));
  Serial.print(" pressed=");
  Serial.println(digitalRead(swPin) == LOW);
  delay(200);
}

Applications

应用场景

APP

遥控小车手柄

用 X/Y 值控制小车速度和方向，按压开关切换模式。

双轴摇杆模块ESP32L298N 电机驱动模块

APP

菜单选择器

左右移动选项、按下确认，适合小屏幕项目的人机交互。

双轴摇杆模块OLED 显示屏ESP32

Warnings

注意事项

摇杆中位值会有偏差，控制小车或云台前应设置死区并做中位校准。

Relations

编辑图片

基础概况

工程要点

工程要点

供电与采购

典型搭配

基础参数

引脚与接线

代码示例

应用场景

遥控小车手柄

菜单选择器

注意事项

相关模块

ESP32-WROOM-32 开发板

L298N H桥电机驱动模块