Same-day dispatch before 2 PM · Free delivery over ₹999 · GST invoices Get the appPrices incl. GST
Geekobot
Snap & SendNEWGeeko AIWhere's myOrder
Log in
Products
  • Projects
    • Component guidesHow parts work, with code you can run
    • Learning pathsFrom your first LED to your first robot
    • Workshops & eventsOnline sessions for makers and classes
    • ElectrolarkFree guided builds, simulator and certificates
    • Students & teachersStudent discount and classroom help
    • CommunityShare builds and ask other makers
    • CalculatorsOhm's law, LED resistor, 555 and 100+ more
    • Circuit builderWire parts and run the circuit, powered by Electrolark
    • Geeko AIAsk what to buy or how to wire it
    • Snap & SendPhotograph a part or list, we find it
    • Part finderAnswer a few questions, get the right part
    • Compatibility checkWill these two parts work together?
    • Compare partsSpecs side by side
    • Business & bulk ordersGST invoices, credit and volume prices
    • Request a quotationSend your list, get a quote
    • Classroom kitsPer-student kits and lab bundles
    • Gift cardsFor students, teams and events
  • Atal Tinkering Lab
BOM to cart
Geekobot

Components, kits and know-how for makers, students, engineers, labs and businesses across India.

Ask Geeko AIOrders, parts and projects, any timeEmail supportReply within 1 working dayGet the Geekobot appAdd it to your home screen, free

Follow us

Shop

  • Boards & SBCs
  • Sensors & Modules
  • IoT & Wireless
  • Drone & FPV
  • 3D Printing
  • Filaments & Resins
  • Motors & Drivers
  • Power & Batteries
  • Semiconductors
  • Passive
  • Displays & LEDs
  • Switches & Relays
  • Wires & Cables
  • Prototyping
  • Tools & Test
  • Robotics
  • STEM Kits
  • Atal Tinkering Lab
  • Mechanical Parts
  • Audio

Orders

  • Track your order
  • Help & support
  • Shipping and delivery
  • Refunds and cancellation
  • Contact us

Learn

  • Projects
  • Geeko AI project assistant
  • Learning paths
  • Guides
  • Calculators
  • Electrolark: free guided builds

Part tools

  • Part finder
  • Compare parts
  • Will it work with my board?

Institutions

  • Classroom kits
  • Atal Tinkering Lab
  • Students & teachers
  • Workshops & Events

Business

  • Business & education
  • Request a quotation
  • BOM bulk upload
  • Quick order by SKU

Company

  • About Geekobot
  • Community
  • Gift cards
  • Terms & conditions
  • Privacy policy
  • Product directory
  • Sitemap

© 2026 Geekobot, a trade name of OLatus Systems Private Limited. All rights reserved.

20, 1st Floor, Neeladri Complex, 10th Cross, Sampige Rd, 2nd Main, Malleshwaram, Bengaluru, Karnataka 560003 · GSTIN 29AACCO0462F1ZM

+91 91810 15607 · connect@geekobot.in · Monday to Saturday, 10 AM to 2 PM IST

UPI · CARDS · NETBANKING · GST INVOICES

ShopProjectsGeeko AIGuides
Compare 0 parts →
Log in

Shop by category

Shop all components
  • Boards & SBCs1,910 products
    • Alternative Single Board Computers
    • Arduino Ecosystem
    • FPGA & Logic Boards
    • Microcontroller & Wireless Boards
    View all
  • Sensors & Modules4,701 products
    • Biomedical & Heart Rate
    • Current, Voltage & Power
    • Force, Weight & Pressure
    • Gas, Weather & Environmental
    View all
  • IoT & Wireless2,314 products
    • RF Modules
    • RFID & NFC
    • Antennas & RF Accessories
    • Cameras & Smart Vision
    View all
  • Drone & FPV3,558 products
    • Flight Control & Navigation
    • FPV Video & Optics
    • Frames & Structural Parts
    • Motors & Propulsion
    View all
  • 3D Printing2,204 products
    • 3D Printers
    • 3D Scanners & Digitizers
    • Laser Engravers & Cutters
    • Material Management & Upgrades
    View all
  • Filaments & Resins1,472 products
    • Filaments
    • Photopolymer Resins
    View all
  • Motors & Drivers463 products
    • BLDC Motor Drivers
    • DC & Geared Motors
    • DC Motor Drivers
    • Linear Actuators & Solenoids
    View all
  • Power & Batteries557 products
    • Battery Holders & Connectors
    • Breadboard Power
    • Chargers & BMS
    • DC-DC Converters
    View all
  • Semiconductors295 products
    • Diodes & Rectifiers
    • Interface & RF Encoder ICs
    • Logic ICs (74xx)
    • Logic ICs (CD4000)
    View all
  • Passive67 products
    • Capacitors
    • Circuit Protection
    • Crystals & Oscillators
    • Inductors
    View all
  • Displays & LEDs572 products
    • 7-Segment & Dot Matrix
    • Addressable LEDs
    • Character LCDs
    • Graphic LCDs
    View all
  • Switches & Relays184 products
    • Keypads & Touch
    • Push Buttons & Tactile
    • Relay Modules
    • Relays
    View all
  • Wires & Cables233 products
    • Board-to-Wire Connectors
    • Crimp & Splice
    • Headers & Dupont
    • Heat Shrink & Sleeving
    View all
  • Prototyping101 products
    • Breadboards
    • Interface Modules
    • PCBs & Perfboards
    View all
  • Tools & Test717 products
    • Bench Power Supplies
    • Hand Tools
    • Measuring Tools
    • Meters & Testers
    View all
  • Robotics180 products
    • Humanoid & Legged Robots
    • Robot Chassis & Platforms
    • Robotic Arms & Grippers
    • Wheels & Casters
    View all
  • STEM Kits268 products
    • Arduino Learning Kits
    • Coding & IoT Kits
    • Early Coding (Ages 3-8)
    • Invention Kits
    View all
  • Atal Tinkering Lab196 products
    • Package 1: Electronics, Robotics, IoT and Sensors
    • Package 2: Rapid Prototyping Tools
    • Package 3: Mechanical, Electrical and Measurement Tools
    • Package 4: Power Supply, Accessories and Safety Equipment
    View all
  • Mechanical Parts212 products
    • Bearings
    • Brackets & Mounts
    • Couplers
    • Fasteners & Standoffs
    View all
  • Audio109 products
    • Amplifier Modules
    • Buzzers & Sirens
    • Speakers
    View all
  1. Home
  2. ›Guides
  3. ›Sensors
  4. ›QMC5883L Compass Module (GY-271)

Component guide · Intermediate · 3 min read

QMC5883L Compass Module (GY-271)

Pinout, Wiring and Code

By Geekobot Learning Team · Updated 29 Oct 2026

I'm using
Wiring, code and the Run it panels follow your board.
On this page
Short answerWhat the QMC5883L compass isQMC5883L compass pinoutWiring the QMC5883L compassExample codeSetup and tuningWhat you needAlternatives and when to choose themTry itCommon mistakesFAQsParts and next steps
Short answer

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.

  • Option 1GY-271 QMC5883L 3-Axis Electronic Compass Module – I2C Interface₹173
  • Option 2GY-273 QMC5883L 3-Axis Magnetic Field Sensor Module – I2C Interface₹147
01

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.

02

QMC5883L compass pinout

The pins on the QMC5883L compass and what each one does.

PinFunction
VCCSupply, 3.3 to 5 V
GNDGround
SCLI2C clock
SDAI2C data
DRDYData ready output (optional)
PinFunction
VCC
Supply, 3.3 to 5 V
GND
Ground
SCL
I2C clock
SDA
I2C data
DRDY
Data ready output (optional)
03

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 pinArduino UnoESP32
VCC5V (or 3.3V)3V3
GNDGNDGND
SDAA4GPIO 21
SCLA5GPIO 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
04

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°).

Read the field and print a heading (Arduino, no library) · Arduino C++Verify & upload in Electrolark
#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);
}
05

Setup and tuning

Hard-iron calibration

rotate the module through a full circle, note the minimum and maximum X and Y, and subtract the middle value from each reading.

Keep it level

tilt changes the heading. For a tilting robot, combine it with an accelerometer (tilt compensation).

Distance

keep it at least a few centimetres from motors, speakers and power wires.

Library

QMC5883LCompass by MPrograms is a simple option with calibration helpers.

06

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
07

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.
08

Try it: I2c pullup calculator

Change the values and the diagram and results update as you type.

09

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.
10

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

  • GY-271 QMC5883L 3-Axis Electronic Compass Module – I2C Interface
    ₹173View
  • GY-273 QMC5883L 3-Axis Magnetic Field Sensor Module – I2C Interface
    ₹147View
  • Uno R3 Development Board (No Cable)
    ₹359View
  • ESP32-WROOM-32 38-Pin Development Board
    ₹389View
  • 0.96" OLED Display 128x64
    ₹139View
  • Dupont Jumper Wires (40 pcs)
    ₹49View
Shop Accelerometers, Gyroscopes & IMUs

Calculators

I2c pullup calculator

Terms in this guide

I2CInter-Integrated Circuit: a two-wire bus (SDA and SCL) that connects many devices by address.

Keep learning

Component guideIntermediateMagnetometers and 9-Axis IMUsA 9-axis IMU adds a magnetometer to a gyroscope and accelerometer so it can give a stable heading as well as roll and pitch.3 min read · SensorsHow-toIntermediateDrone GPS, Compass and RTK ModulesA GPS and compass module lets a drone hold position and return home.3 min read · Drones & FPVConcept explainerIntermediateI2C ExplainedI2C is a two-wire bus that lets one microcontroller talk to many sensors and displays using a data line (SDA) and a clock line (SCL).4 min read · Electronics FundamentalsComponent guideIntermediateHMC5883L Compass ModuleThe HMC5883L is a 3-axis digital compass from Honeywell that reports the magnetic field over I2C at address 0x1E.3 min read · Sensors

Sources

  • QMC5883L 3-axis magnetic sensor datasheet (QST)

Written by the Geekobot team from manufacturer datasheets. Always check the datasheet for the exact part and variant you buy.

On this page
Short answerWhat the QMC5883L compass isQMC5883L compass pinoutWiring the QMC5883L compassExample codeSetup and tuningWhat you needAlternatives and when to choose themTry itCommon mistakesFAQsParts and next steps
Need a hand?Ask Geeko AI which part fits your project, or talk to the Geekobot team.Ask Geeko AIHelp & support

Parts for this guide (Arduino Uno)2 items · ₹377

GY-271 QMC5883L 3-Axis Electronic Compass Module – I2C Interface · Uno R3 CH340G ATmega328p Compatible Development Board

Run itChange the inputs and watch the output

Raw x, y, z counts and the heading. Real use needs hard-iron calibration.

Serial monitor115200 baud
645 1118 -1650  heading 60.02

A simulation of the sketch above, so you know what to expect. Real readings vary with your parts and wiring.

Ask the Community

Ask a question