Compass Sensor QMC5883L / HMC5883L GY-271 3-Axis Digital Magnetometer

The GY-271 QMC5883L / HMC5883L Compass Sensor is a small digital magnetic-field sensing module that measures magnetic field strength along three axes. A microcontroller can process these X, Y, and Z measurements to determine magnetic heading and orientation.

The module is commonly used with development boards such as Arduino and other microcontrollers through the I2C bus. Its compact design makes it convenient for small robotic platforms, autonomous vehicles, UAV projects, and educational electronics.

Features

• 3-axis digital magnetometer
• QMC5883L / HMC5883L sensor variants
• Measures magnetic field on X, Y, and Z axes
• I2C communication interface
• SDA and SCL interface pins
• Dedicated DRDY (Data Ready) output
• Onboard voltage regulation
• Onboard logic-level shifting
• Compatible with 3.3V and 5V microcontroller interfaces
• Compact PCB footprint
• Suitable for electronic compass and heading applications
• Unsoldered header pins included

Applications

• Arduino electronic compass projects
• UAV and drone heading systems
• Autonomous robots
• Line-following robots
• Mobile rover navigation
• Robot orientation detection
• Digital compass projects
• Pedometers and orientation devices
• STEM and educational projects
• Magnetic field measurement
• Embedded navigation systems

How It Works / Use Guide

The GY-271 measures the surrounding magnetic field along its X, Y, and Z axes. A microcontroller reads these measurements through the I2C interface and uses the data to calculate magnetic direction.

1. Identify the sensor IC installed on the module.
2. Connect VCC and GND to the appropriate power supply.
3. Connect SDA and SCL to the microcontroller's I2C pins.
4. Connect the DRDY pin if your application requires data-ready interrupt functionality.
5. Install a software library compatible with the actual sensor IC.
6. Confirm the I2C address using an I2C scanner if necessary.
7. Calibrate the magnetometer before using it for compass heading calculations.
8. Mount the module away from motors, power cables, magnets, and ferromagnetic materials.
9. For applications where the sensor is tilted, use appropriate tilt-compensation calculations for improved heading accuracy.

QMC5883L vs HMC5883L

Although QMC5883L and HMC5883L modules can look very similar and may use compatible physical pin arrangements, they should not be treated as identical from a software perspective.

• QMC5883L commonly uses I2C address 0x0D.
• HMC5883L commonly uses I2C address 0x1E.
• Their register maps and initialization procedures are different.
• A library written specifically for HMC5883L may not work correctly with QMC5883L.
• Always identify the actual IC fitted to the module and use the corresponding library.

Important Notes

• The exact sensor IC may vary between GY-271/HW-127 board variants.
• Check the actual IC and I2C address before programming.
• Sensor heading accuracy depends on calibration, mounting position, environmental magnetic fields, and software processing.
• Keep the sensor away from high-current motor wires, motors, speakers, permanent magnets, and steel/iron hardware.
• Do not place the module immediately beside Li-Po battery power leads or other high-current conductors when accurate compass readings are required.
• The stated magnetic-field range and electrical characteristics can vary depending on whether the module uses QMC5883L or HMC5883L.
• Avoid exposing the module to excessive heat during soldering.
• Do not apply voltage outside the module's specified supply range.
• Physical dimensions may have minor manufacturing or measurement variation.
• Product images are for illustrative purposes only and may differ from the actual product.

Package Includes

• 1 × HW-127 / GY-271 QMC5883L / HMC5883L 3-Axis Compass Module
• 2 × 5-Pin Male Header Connectors, Straight and Right-Angle, Unsoldered