Component guide · Intermediate · 3 min read
QMC5883L Compass Module (GY-271)

Pinout, Wiring and Code
By Geekobot Learning Team · Updated 29 Oct 2026
On this page
The QMC5883L is a 3-axis magnetometer that measures the Earth's magnetic field to give a compass heading. It is the chip on most GY-271 modules today, at I2C address 0x0D. Code written for the older HMC5883L will not work with it, so use a QMC5883L library or the register code below, and calibrate it after mounting.
Key specs at a glance
- Sensor
- 3-axis anisotropic magnetoresistive (AMR) magnetometer, QST
- Range
- ±2 or ±8 gauss
- Resolution
- 16-bit
- Interface
- I2C, address 0x0D, up to 400 kHz
- Output rate
- 10, 50, 100 or 200 Hz
- Supply
- Modules 3.3 to 5 V (chip 2.16 to 3.6 V)
Models in this guide
These are alternatives. Pick the one that fits your project; you only need one.
What the QMC5883L compass is
A magnetometer measures the strength of the magnetic field on three axes. Held level, the X and Y readings point to magnetic north, and atan2(Y, X) gives the heading.
The GY-271 module first used Honeywell's HMC5883L. When that chip went out of production, makers switched to the QMC5883L from QST. It looks the same but uses a different address (0x0D instead of 0x1E) and different registers, which is why old sketches print zeros.
QMC5883L compass pinout
The pins on the QMC5883L compass and what each one does.
| Pin | Function |
|---|---|
| VCC | Supply, 3.3 to 5 V |
| GND | Ground |
| SCL | I2C clock |
| SDA | I2C data |
| DRDY | Data ready output (optional) |
- VCC
- Supply, 3.3 to 5 V
- GND
- Ground
- SCL
- I2C clock
- SDA
- I2C data
- DRDY
- Data ready output (optional)
Wiring the QMC5883L compass
Run an I2C scanner first: 0x0D means a QMC5883L, 0x1E means an HMC5883L. Mount the module flat and away from motors, batteries and steel.
| QMC5883L compass pin | Arduino Uno | ESP32 |
|---|---|---|
| VCC | 5V (or 3.3V) | 3V3 |
| GND | GND | GND |
| SDA | A4 | GPIO 21 |
| SCL | A5 | GPIO 22 |
- VCC
- Arduino Uno:
- 5V (or 3.3V)
- ESP32:
- 3V3
- GND
- Arduino Uno:
- GND
- ESP32:
- GND
- SDA
- Arduino Uno:
- A4
- ESP32:
- GPIO 21
- SCL
- Arduino Uno:
- A5
- ESP32:
- GPIO 22
Example code
The heading is magnetic, not true north. Add your local magnetic declination for true north; in most of India it is small (under about 2°).
#include <Wire.h>
const uint8_t QMC = 0x0D;
void writeReg(uint8_t reg, uint8_t val) {
Wire.beginTransmission(QMC); Wire.write(reg); Wire.write(val); Wire.endTransmission();
}
void setup() {
Serial.begin(115200);
Wire.begin();
writeReg(0x0B, 0x01); // SET/RESET period
writeReg(0x09, 0x1D); // continuous, 200 Hz, ±8 G, oversampling 512
}
void loop() {
Wire.beginTransmission(QMC); Wire.write(0x00); Wire.endTransmission(false);
Wire.requestFrom(QMC, (uint8_t)6);
int16_t x = Wire.read() | Wire.read() << 8; // low byte first
int16_t y = Wire.read() | Wire.read() << 8;
int16_t z = Wire.read() | Wire.read() << 8;
float heading = atan2((float)y, (float)x) * 180.0 / PI;
if (heading < 0) heading += 360;
Serial.print(x); Serial.print(" "); Serial.print(y); Serial.print(" "); Serial.print(z);
Serial.print(" heading "); Serial.println(heading);
delay(200);
}Setup and tuning
rotate the module through a full circle, note the minimum and maximum X and Y, and subtract the middle value from each reading.
tilt changes the heading. For a tilting robot, combine it with an accelerometer (tilt compensation).
keep it at least a few centimetres from motors, speakers and power wires.
QMC5883LCompass by MPrograms is a simple option with calibration helpers.
What you need
Shop this list5 of 6 found in our store · ₹897
GY-271 QMC5883L compass module: the sensor this guide coversGY-271 QMC5883L 3-Axis Electronic Compass Module – I2C Interface₹173Closest match, check the specs
Generic GY-273 QMC5883L 3-Axis Magnetic Field Sensor Module – I2C Interface: another version this guide coversGY-273 QMC5883L 3-Axis Magnetic Field Sensor Module – I2C Interface₹147- Uno R3 development board: the controller used in the wiring tableFind this part
ESP32-WROOM-32 38-pin development board: for Wi-Fi logging and dashboardsESP32-WROOM-32 38-Pin Development Board₹389
0.96 inch OLED display 128x64: to show readings without a computer0.96" OLED Display 128x64₹139Closest match, check the specs
Dupont jumper wires: for the connectionsDupont Jumper Wires (40 pcs)₹49Closest match, check the specs
Alternatives and when to choose them
- HMC5883L: the original chip, address 0x1E.
- MPU9250 and BNO055: compass plus motion sensors in one.
- Magnetometers and 9-axis IMUs: calibration in depth.
Try it: I2c pullup calculator
Change the values and the diagram and results update as you type.
Common mistakes to avoid
- Using HMC5883L code or address 0x1E with a QMC5883L.
- Skipping calibration, so north is tens of degrees off.
- Mounting it next to a motor, battery or steel screw.
- Reading the heading while the module is tilted.
Frequently asked questions
What is the QMC5883L's I2C address?
0x0D. The older HMC5883L uses 0x1E.
Why does my GY-271 read zeros?
Your code is for the HMC5883L but the board has a QMC5883L. Run an I2C scanner to check.
Does it give true north?
It gives magnetic north; add the local declination for true north.
Can I use it on a drone?
Yes, but mount it away from power wires and ESCs, usually on a GPS mast.
Does it work at 3.3 V?
Yes, GY-271 modules accept 3.3 to 5 V.
Parts for this guide
Calculators
Terms in 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.

