Source: https://mokxi.com/parts/hmc5883l
Updated: 2026-11-16

Part

# Compass, HMC5883L (GY-271)

The classic GY-271 compass at 0x1E: X, Z and Y in 230 to 1370 counts a gauss, the self test and DRDY, for Adafruit_HMC5883_U.h.

See every part

- 5 pins
- 3 settings
- In 1 project

Drawn live by the editor's own code, at the size you see it.

At a glance

## The Compass, HMC5883L (GY-271) in brief

What it is, and every setting the properties panel gives it.

The HMC5883L is Honeywell’s three-axis compass chip, read over I2C at 0x1E, on the blue GY-271 board. Flat on the bench it reads the Earth’s field, about 20 microtesla toward magnetic north and 45 down at mid-northern latitudes, and atan2 of the two horizontal readings is the heading. Configuration B sets the gain, 230 to 1370 counts a gauss, and the data comes out X, Z, Y, high byte first, from -2048 to 2047. VCC and GND take 3 V to 5 V on the board, SCL and SDA are I2C with the pull-ups on the board, and DRDY goes low for 250 microseconds when new data goes in. The part’s heading, pitch and roll are sliders. Most GY-271 boards sold today carry a QMC5883L at 0x0D instead.

Family

Sensors

Pins

5

pitch

0

roll

0

heading

0

Pins

## 5 pins

Named as the editor names them, so a wire lands where you expect it.

Pin

What it does

VCC

Supply, 3 to 5 V; the board's regulator gives the chip 3.3 V.

GND

Ground.

SCL

I2C at 0x1E (0x3C to write, 0x3D to read). The board carries 4.7 k pull-ups.

SDA

I2C at 0x1E (0x3C to write, 0x3D to read). The board carries 4.7 k pull-ups.

DRDY

Goes low for 250 microseconds each time new data goes in. Optional.

How to use it

## How to read an HMC5883L compass with an Arduino

The GY-271’s VCC goes to 5 V, GND to GND, SDA to A4 and SCL to A5, at address 0x1E. The sketch uses Adafruit’s HMC5883 Unified library: begin() puts the chip in continuous mode at 15 measurements a second, and getEvent() hands back the field in microtesla. The first sample lands two periods after begin(), so the sketch waits before its first read.

The heading is atan2 of Y over X, in degrees clockwise from magnetic north, and the sketch names the nearest of the eight points of the compass. Drag the heading slider to turn the board; tip it with pitch and roll and watch the flat-compass heading go wrong. The library divides by its own 1100 counts a gauss rather than the datasheet’s 1090, so the microtesla read about 1 percent low, as on a real board.

Part pin

Board pin

VCC

5 V

GND

GND

SDA

A4

SCL

A5

DRDY

Not wired

The board has its own 3.3 V regulator and takes 3 V to 5 V, so a 3.3 V board such as an ESP32 or a Pico drives it directly. Use that board’s I2C pins; the address is 0x1E.

Click to open it in the editor

This is the simulator itself, running here. Click anything to open it in the editor.

Open this project in the editor Read the full tutorial

Common errors

## Common Compass, HMC5883L (GY-271) errors and fixes

What goes wrong

The fix

Nothing answers at 0x1E on a real GY-271.

Most boards sold now carry a QMC5883L at 0x0D, a different chip with another register map. An I2C scanner tells which one you have.

The readings are all zero.

Read too soon: the first continuous sample takes two periods, 133 ms at 15 Hz. Wait, or poll the RDY bit in the status register.

X, Y and Z are mixed up.

The chip’s data registers come in the order X, Z, Y, each high byte first. Read six bytes from 0x03 and take them in that order.

The heading is off by a fixed amount.

It is relative to magnetic north, not true north, and anything magnetic nearby bends it. Add your local declination and keep the board flat and away from motors.

Questions

## Questions and answers

### What is the I2C address of the HMC5883L?

0x1E, or 0x3C to write and 0x3D to read as an 8-bit address. It cannot be changed.

### What is the difference between the HMC5883L and the QMC5883L?

They do the same job on the same GY-271 board, but the QMC5883L answers at 0x0D with another register map, so each needs its own library.

### How do I get a compass heading from the HMC5883L?

Take atan2 of the Y and X readings while the board is flat, turn radians into degrees and add 360 if it is negative.

How it is modeled

## What is true about the Compass, HMC5883L (GY-271), here

In its help article’s own words: what the simulation gets right, and where it stops.

### Not modeled

The averaging (there is no noise to average), the high-speed I2C bit, noise, offsets,
hard and soft iron, nearby magnets, and the 50 ms the chip's analog side takes to wake.

From HMC5883L compass (GY-271), in full.

Projects

## See the Compass, HMC5883L (GY-271) in a project

One built-in project uses it. It opens in the editor, already wired.

Boards

## The boards it is shown on

This board has a built-in project with the Compass, HMC5883L (GY-271) in it.

- Arduino Uno R3

Keep going

## Keep going

- I2C Scanner for Arduino and ESP32, and Fixes
- Arduino MPU6050: Accelerometer and Tilt
- Magnetometer, LIS3MDL
- Accelerometer and compass, LSM303AGR
- Nine-axis IMU, MPU-9250

More parts

## The rest of the bench

Every one of these is drawn and simulated the same way.

Full-size breadboard

A real 0.1 inch grid with the rails and the center channel, 63 columns wide.

Jumper wires

Drag from any pin or hole to any other. Corners snap, and you can drag them.

Power

A supply rail at the voltage you choose.

Ground

The other end of every circuit.

LED

Lights when current flows. Five colors, and the brightness is what your eye would see.

Filament lamp

A tungsten bulb in a holder: an inrush when it is switched on cold, tens of milliseconds to warm up, and dim on half its voltage.

Resistor

Any value you like, with the color bands drawn to match.

ESP32-C3-DevKitM-1

A RISC-V board that runs your firmware at 160 MHz on the real memory map.

Pushbutton

A 12 mm tactile switch. Hold it while the simulation runs.

Raspberry Pi Pico

The RP2040 board on our own Cortex-M0+ core. Pick a program and press Run.

Raspberry Pi Pico W

Raspberry Pi Pico W (RP2040). The same board and the same pinout as a Pico, with the CYW43439 on it. The WiFi is simulated (no radio; real internet through the Cloud panel’s switch), and the on-board LED, which hangs off that chip rather than off GP25, is driven through the same path. Everything else is the Pico.

Raspberry Pi 4 Model B

Raspberry Pi 4 Model B: the 40-pin header, driven by main.py with RPi.GPIO or gpiozero.

See every part

## Wire up the Compass, HMC5883L (GY-271)

Open the editor and push it into the breadboard. It is free, and it runs on your own machine.

Start building free Open the editor
