GY-271 QMC5883 Electronic Compass Module Three-Axis Magnetometer Field Sensor

Specifications

• Sensor Chip: QMC5883 
• Operating Voltage (VCC): 3.3V to 5.0V DC (Onboard LDO regulator)
• Communication Interface: Standard I2C (2-Wire)
• I2C Address: 0x0D
• ADC Resolution: 16-Bit Built-in ADC
• Measurement Range: ±2 Gauss / ±8 Gauss (Selectable)
• Field Resolution: 2 milli-Gauss
• Heading Accuracy: 1° to 2°
• Max Output Data Rate (ODR): Up to 200Hz
• Dimensions: 14mm x 13mm

Applications

• UAV & Drone Navigation: Maintain stable flight headings and correct yaw drift.
• Autonomous Robotics: Enable smart rovers and line-followers to turn precisely at 90 or 180 degrees.
• Weather Stations: Accurately measure wind vane direction automatically.

Unlock New Capabilities

• Past Projects: If you've mastered basic obstacle avoidance using ultrasonic sensors but found your robot wandering off a straight path...
• Feature Upgrade: adding this QMC5883L compass unlocks absolute orientation. Your robot will now know exactly which way "North" is, allowing for complex grid-based mapping and waypoint navigation.
• Effort Level: Intermediate. Requires basic understanding of I2C protocols and sensor calibration logic. 

Virtual Technician & Wiring Guide

• ⚠️ Warning - Probots Logic-Safe: While the VCC pin can safely accept 5V from an Arduino Uno due to the onboard regulator, the I2C logic lines (SDA/SCL) on the QMC5883 chip natively prefer 3.3V. While they are generally 5V tolerant on most modules, using a logic level converter when connecting to 5V microcontrollers is highly recommended for long-term stability.

Pin Mappings (To standard Arduino Uno):

• VCC ➔ 5V or 3.3V (3.3V recommended if available)
• GND ➔ GND
• SCL ➔ A5 (or dedicated SCL pin)
• SDA ➔ A4 (or dedicated SDA pin)
• DRDY ➔ (Data Ready) Unconnected for standard polling; connect to an Interrupt pin for advanced high-speed reading.

Package Includes:

• 1 x GY-271 QMC5883 Electronic Compass Module Three-Axis Magnetometer Field Sensor

Frequently Asked Questions (FAQ)

• What is the I2C address of the QMC5883L?
  The default 7-bit I2C address for the QMC5883L is 0x0D.
• Why is my GY-271 outputting only zeros?
  This usually happens if you are using an older HMC5883L library. The QMC5883L has a different register map and address. You must use a library specifically designed for the QMC5883L.
• What is the difference between QMC5883L and HMC5883L?
  The HMC5883L is an obsolete chip (Address 0x1E). The QMC5883L is its modern replacement found on most GY-271 modules today. They look identical but require completely different software libraries because their internal registers and I2C addresses (0x0D) differ.
• Can I use the HMC5883L library for this module?
  No. They are not software compatible. You must download a QMC5883L specific library.
• What voltage does the GY-271 module require?
  You can power it with 3.3V or 5V DC on the VCC pin, thanks to the module's onboard voltage regulator.
• Are the I2C logic lines on the GY-271 5V tolerant?
  While many users connect SDA and SCL directly to a 5V Arduino without immediate failure, the chip natively uses 3.3V logic. For long-term reliability, a logic level converter is recommended.
• What is the DRDY pin used for?
  DRDY stands for "Data Ready". It pulses to indicate that a new magnetic measurement is ready to be read. You can connect it to a microcontroller interrupt pin to optimize code execution speed, though it is not required for basic use.
• How do I calibrate the QMC5883L magnetometer?
  Upload a calibration sketch from your chosen library, open the serial monitor, and slowly rotate the sensor in all three dimensions (figure-eight motion) until it captures the minimum and maximum magnetic field limits of your specific environment.
• Why does my compass heading drift when I tilt the sensor?
  The QMC5883L is a magnetometer, not an IMU. It measures magnetic fields relative to its physical orientation. To get an accurate heading while tilted, you must pair it with an accelerometer to create a "tilt-compensated" compass.
• Do I need external pull-up resistors on the I2C lines?
  The GY-271 module typically includes built-in pull-up resistors on the SDA and SCL lines (usually 2.2kΩ or 4.7kΩ). External pull-ups are generally not required unless your I2C bus is very long.
• Which Arduino library is recommended for the QMC5883L?
  We recommend the QMC5883LCompass library by mprograms, which is available directly through the Arduino IDE Library Manager.
• What is the maximum Output Data Rate (ODR) of this sensor?
  The QMC5883L can be configured to output data at 10Hz, 50Hz, 100Hz, or 200Hz.
• How do I change the measurement range of the QMC5883L?
  The range can be set via software registers to either ±2 Gauss (higher resolution, lower range) or ±8 Gauss (lower resolution, higher range).
• What causes the "Could not find a valid QMC5883L sensor" error?
  This error indicates a wiring issue, incorrect voltage, or the wrong I2C address being polled. Double-check SDA/SCL connections and ensure you aren't using an HMC5883L library.