Componentes

Brújula QMC5883L (GY-271)

El QST QMC5883L lee el campo magnético en tres ejes por I2C en 0x0D: el chip de la mayoría de las placas de brújula GY-271 que se venden hoy.

This part has a page of its own, with a note on using it and a circuit to try: the part page.

Alias: GY-271, QMC5883, módulo de brújula digital, magnetómetro de tres ejes. Acostado en el banco de trabajo lee el campo de la Tierra: unos 20 microtesla hacia el norte magnético y 45 hacia abajo, en latitudes medias del hemisferio norte. El atan2 de las dos lecturas horizontales es el rumbo, que es todo lo que hace un sketch de brújula.

¿Qué chip tiene mi GY-271?

Las placas vendidas como "GY-271" o "HMC5883L" llevaban el HMC5883L de Honeywell hasta que se descontinuó; la mayoría ahora lleva el QMC5883L, que tiene otra dirección y otro mapa de registros. Ejecuta un escáner de I2C: 0x0D es un QMC5883L, 0x1E un HMC5883L. Un sketch escrito para el otro chip no encuentra nada.

Pins

Pin Qué hace
VCC, GND Alimentación, de 3 a 5 V en la placa, que tiene su propio regulador de 3.3 V.
SCL, SDA I2C, hasta 400 kHz. La placa lleva las resistencias pull-up.
DRDY Alto mientras espera una nueva muestra; leer los datos lo pone en bajo.

Propiedades

heading, pitch y roll indican cómo está colocada la placa; los deslizadores la giran y la inclinan.

Leerlo en un Arduino

Con la biblioteca QMC5883LCompass (MPrograms), que Mokxi incluye como QMC5883LCompass.h:

#include <QMC5883LCompass.h>
QMC5883LCompass compass;

void setup() {
  Serial.begin(9600);
  compass.init();
}

void loop() {
  compass.read();
  int azimuth = compass.getAzimuth();
  char dir[3];
  compass.getDirection(dir, azimuth);
  Serial.print(azimuth);
  Serial.print(" ");
  Serial.print(dir[0]);
  Serial.print(dir[1]);
  Serial.println(dir[2]);
  delay(250);
}

getAzimuth() va de -180 a 180 grados, 0 cuando la flecha X de la placa apunta al norte. getDirection() llena tres caracteres, " N", "NNE" y así sucesivamente, sin terminador.

Cómo se comunica

El registro de control 1 (0x09) fija el modo (espera o continuo), la tasa de datos (10, 50, 100 o 200 Hz), el rango (2 gauss a 12000 cuentas por gauss, u 8 a 3000) y el sobremuestreo. La configuración de la hoja de datos es 0x01 en el registro del periodo SET/RESET (0x0B), luego 0x1D en 0x09. El registro de estado (0x06) tiene DRDY (datos nuevos), OVL (un eje por debajo de -32768 o por encima de 32767) y DOR (se saltó una muestra). El campo está en 0x00 a 0x05, byte bajo primero; la dirección de registro avanza sola, así que una lectura de seis bytes desde 0x00 obtiene los tres ejes. El registro de control 2 (0x0A) tiene el reinicio por software, el retorno del puntero y el interruptor que apaga el pin DRDY. El ID del chip (0x0D) lee 0xFF.

Lo que no modela

Ruido, offsets, el filtro de sobremuestreo y el efecto del periodo SET/RESET (ambos se guardan y se leen de vuelta), imanes cercanos y el hierro duro de un chasis de robot. El offset de los registros de temperatura no está calibrado en el chip real, solo sus 100 cuentas por grado, así que el modelo lee 0 y se queda quieto.

Common mistakes

Reading zeros: the chip powers up in standby until continuous mode is written to 0x09. A heading that jumps or sits still: reading only some of the six data registers locks them until 0x05 is read. The heading is off by tens of degrees: magnetic north is not true north, so set the declination for your town, and calibrate away the board's own offsets.