Component guide · Intermediate · 3 min read
HMC5883L Compass Module

Pinout, Wiring and Code
By Geekobot Learning Team · Updated 29 Oct 2026
On this page
The HMC5883L is a 3-axis digital compass from Honeywell that reports the magnetic field over I2C at address 0x1E. Hold it level, take atan2 of the Y and X readings and you have a heading. Many modules sold under this name now carry the QMC5883L at 0x0D instead, so scan the bus before you write code.
Key specs at a glance
- Sensor
- 3-axis AMR magnetometer (Honeywell)
- Range
- ±0.88 to ±8.1 gauss (8 gain settings)
- Resolution
- 12-bit, down to about 2 milligauss
- Interface
- I2C, address 0x1E, up to 400 kHz
- Output rate
- 0.75 to 75 Hz continuous, up to 160 Hz single measurement
- Supply
- Modules 3.3 to 5 V (chip 2.16 to 3.6 V)
What the HMC5883L compass is
The HMC5883L measures the Earth's magnetic field on three axes. It was the standard hobby compass for years and is still found on drone GPS modules and IMU boards such as the GY-87.
The data registers are in the order X, Z, Y, high byte first, which is a common source of mistakes.
HMC5883L compass pinout
The pins on the HMC5883L 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 HMC5883L compass
If the scanner shows 0x0D instead of 0x1E, the board has a QMC5883L; follow the QMC5883L guide instead.
| HMC5883L 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
Calibrate before trusting the heading: subtract the centre of the X and Y minimum and maximum values recorded during a full turn.
#include <Wire.h>
const uint8_t HMC = 0x1E;
void writeReg(uint8_t reg, uint8_t val) {
Wire.beginTransmission(HMC); Wire.write(reg); Wire.write(val); Wire.endTransmission();
}
void setup() {
Serial.begin(115200);
Wire.begin();
writeReg(0x00, 0x70); // 8-sample average, 15 Hz
writeReg(0x01, 0x20); // gain ±1.3 Ga
writeReg(0x02, 0x00); // continuous measurement
}
void loop() {
Wire.beginTransmission(HMC); Wire.write(0x03); Wire.endTransmission(false);
Wire.requestFrom(HMC, (uint8_t)6);
int16_t x = Wire.read() << 8 | Wire.read(); // order is X, Z, Y
int16_t z = Wire.read() << 8 | Wire.read();
int16_t y = Wire.read() << 8 | Wire.read();
float heading = atan2((float)y, (float)x) * 180.0 / PI;
if (heading < 0) heading += 360;
Serial.print("heading "); Serial.println(heading);
delay(200);
}Setup and tuning
the chip has a self-test mode (register A bits) that applies a known field; useful to check a suspect module.
use the lowest range that does not saturate; a reading of -4096 means overflow.
keep it level or add tilt compensation with an accelerometer.
keep it away from motors and current-carrying wires.
What you need
Shop this list4 of 5 found in our store · ₹785
HMC5883L 3-axis compass module: the sensor this guide coversHMC5883L 3-Axis Compass Magnetic Sensor Module – I2C Interface₹279Closest match, check the specs- 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
Dupont jumper wires: for the connectionsDupont Jumper Wires (40 pcs)₹49Closest match, check the specs
Solderless breadboard: to build without solderingSolderless Breadboard₹68
Alternatives and when to choose them
- QMC5883L: the replacement chip found on most new GY-271 boards.
- BNO055: compass plus motion sensors and fusion in one chip.
- Magnetometers and 9-axis IMUs: calibration and tilt compensation.
Try it: I2c pullup calculator
Change the values and the diagram and results update as you type.
Common mistakes to avoid
- Reading the registers as X, Y, Z; the HMC5883L order is X, Z, Y.
- Using this code on a QMC5883L board (address 0x0D).
- Ignoring the -4096 overflow value when the gain is too high.
- Not calibrating after mounting.
Frequently asked questions
What is the HMC5883L's I2C address?
0x1E.
Is the HMC5883L still made?
Honeywell stopped making it; most new modules use the QMC5883L.
How accurate is it?
About 1 to 2 degrees of heading after calibration and with the module level.
Can I use it with a 3.3 V board?
Yes, the modules accept 3.3 to 5 V.
Why is my heading off by a fixed amount?
Add magnetic declination for true north and check the module's arrow points forward.
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.

