Componentes

Bússola QMC5883L (GY-271)

O QMC5883L da QST lê o campo magnético em três eixos por I2C em 0x0D: o chip da maioria das placas de bússola GY-271 vendidas hoje.

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

Apelidos: GY-271, QMC5883, módulo de bússola digital, magnetômetro de três eixos. Deitado na bancada, ele lê o campo da Terra: cerca de 20 microtesla na direção do norte magnético e 45 para baixo, em latitudes médias do norte. O atan2 das duas leituras horizontais é a direção, que é tudo o que um sketch de bússola faz.

Qual chip está na minha GY-271?

Placas vendidas como "GY-271" ou "HMC5883L" usavam o HMC5883L da Honeywell até ele ser descontinuado; a maioria hoje usa o QMC5883L, que tem um endereço e um mapa de registradores diferentes. Rode um scanner I2C: 0x0D é um QMC5883L, 0x1E um HMC5883L. Um sketch escrito para o outro chip não encontra nada.

Pins

Pin O que faz
VCC, GND Alimentação de 3 a 5 V na placa, que tem seu próprio regulador de 3,3 V.
SCL, SDA I2C, até 400 kHz. A placa traz os pull-ups.
DRDY Alto enquanto uma nova amostra espera; ler os dados o leva para baixo.

Propriedades

heading, pitch e roll são como a placa está posicionada; os controles deslizantes a giram e a inclinam.

Lendo no Arduino

Com a biblioteca QMC5883LCompass (MPrograms), que o Mokxi inclui 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() vai de -180 a 180 graus, 0 quando a seta X da placa aponta para o norte. getDirection() preenche três caracteres, " N", "NNE" e assim por diante, sem terminador.

Como ele se comunica

O registrador de controle 1 (0x09) define o modo (standby ou contínuo), a taxa de dados (10, 50, 100 ou 200 Hz), a faixa (2 gauss a 12000 contas por gauss, ou 8 a 3000) e a sobreamostragem. A configuração do datasheet é 0x01 no registrador do período SET/RESET (0x0B) e depois 0x1D em 0x09. O registrador de status (0x06) tem DRDY (dados novos), OVL (um eixo além de -32768 ou 32767) e DOR (uma amostra foi perdida). O campo está em 0x00 a 0x05, byte baixo primeiro; o endereço do registrador avança sozinho, então uma leitura de seis bytes a partir de 0x00 pega os três eixos. O registrador de controle 2 (0x0A) tem o soft reset, o reinício do ponteiro e a chave que desliga o pino DRDY. O ID do chip (0x0D) lê 0xFF.

O que não é modelado

Ruído, offsets, o filtro de sobreamostragem e o efeito do período SET/RESET (ambos são guardados e lidos de volta), ímãs próximos e o ferro duro de um chassi de robô. O offset dos registradores de temperatura não é calibrado no chip real, apenas as 100 contas por grau, então o modelo lê 0 e fica parado.

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.