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.