Component guide · Intermediate · 3 min read
Waveshare General Driver Board for Robots (ESP32)

Motors, Bus Servos and IMU
By Geekobot Learning Team · Updated 29 Oct 2026
On this page
The Waveshare general driver board is an ESP32-based robot controller. It has dual DC motor drivers with encoder inputs, a serial bus servo port, a 9-axis IMU, an OLED header, battery monitoring and Wi-Fi. It accepts JSON commands over serial or Wi-Fi, so a Raspberry Pi or Jetson can act as the brain while the board handles motors.
Key specs at a glance
- MCU
- ESP32-WROOM-32
- DC motors
- 2 channels with encoder inputs
- Servos
- Serial bus servo port (ST/SC)
- IMU
- 9-axis (accel, gyro, magnetometer)
- Power
- 3S Li-ion input (about 9 to 12.6 V), INA219 monitor
- Control
- JSON over UART, USB or Wi-Fi
What the Waveshare general driver board for robots is
The Waveshare General Driver for Robots is an ESP32-based board that drives DC motors with encoders, serial bus servos, an IMU and an OLED, used in Waveshare robot kits and custom rovers.
It is the base board of Waveshare's UGV and robot arm kits, so the open firmware already understands commands like move, set speed and servo position. You can also flash your own Arduino code.
Keep the motor battery within range and add a fuse; stalled motors can draw several amps.
Waveshare general driver board for robots pinout
The pins on the Waveshare general driver board for robots and what each one does.
| Pin | Function |
|---|---|
| Battery in | 3S pack |
| Motor A / B | DC motor outputs with encoder headers |
| Bus servo port | ST/SC servos |
| 40-pin / UART | Link to Raspberry Pi or Jetson |
| I2C | OLED and sensors |
- Battery in
- 3S pack
- Motor A / B
- DC motor outputs with encoder headers
- Bus servo port
- ST/SC servos
- 40-pin / UART
- Link to Raspberry Pi or Jetson
- I2C
- OLED and sensors
Wiring the Waveshare general driver board for robots
Connect the Waveshare general driver board for robots like this.
| Waveshare general driver board for robots pin | With Raspberry Pi | Standalone |
|---|---|---|
| UART | Pi GPIO 14/15 to board RX/TX | USB to PC |
| Motors | Motor A and B terminals | Same |
| Battery | 3S pack | Same |
- UART
- With Raspberry Pi:
- Pi GPIO 14/15 to board RX/TX
- Standalone:
- USB to PC
- Motors
- With Raspberry Pi:
- Motor A and B terminals
- Standalone:
- Same
- Battery
- With Raspberry Pi:
- 3S pack
- Standalone:
- Same
Example code
Command numbers depend on the firmware version; see the Waveshare wiki JSON command list.
import serial, json, time
s = serial.Serial('/dev/serial0', 115200, timeout=1)
def send(cmd):
s.write((json.dumps(cmd) + '\n').encode())
send({"T": 1, "L": 0.2, "R": 0.2}) # left and right speed
time.sleep(2)
send({"T": 1, "L": 0, "R": 0})Setup and tuning
feed 7 to 12.6 V from a 2S or 3S battery pack.
flash Waveshare's open-source firmware or your own ESP32 code.
send JSON commands over USB, UART or Wi-Fi from a Raspberry Pi or Jetson.
connect encoder motors to the motor ports with correct polarity.
connect ST-series bus servos to the servo port.
What you need
Shop this list3 of 3 found in our store · ₹4,170
Waveshare General Driver Board for Robots (ESP32): the part this guide coversWaveshare General Driver Board for Robots (ESP32)₹3,300
Waveshare serial bus servo driver board: to drive bus servos from USB or an ESP32Waveshare Serial Bus Servo Driver Board₹481
ESP32-WROOM-32 38-pin development board: for Wi-Fi logging and dashboardsESP32-WROOM-32 38-Pin Development Board₹389
Alternatives and when to choose them
Common mistakes to avoid
- Wrong battery voltage.
- Reversed motor polarity.
- Weak battery for servos.
- Overwriting firmware without backup.
Frequently asked questions
How do I control the driver board from a Raspberry Pi?
Send JSON commands to it over USB serial or the UART pins.
Can I use it with ROS?
Yes. Write a ROS node that sends serial commands and reads feedback.
Why do the motors turn the wrong way?
Swap motor wires or change direction in the firmware.
What battery should I use?
A 2S or 3S Li-ion pack within the input range.
Can it drive bus servos?
Yes. It drives Waveshare ST-series serial bus servos on its servo port.
Parts for this guide
Projects that use it
Put this into practice: 1 step-by-step build in our project library uses parts from this guide.
Keep learning
Sources
Written by the Geekobot team from manufacturer datasheets. Always check the datasheet for the exact part and variant you buy.
