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, modul kompas digital, magnetometer tiga sumbu. Diletakkan datar di meja kerja, ia membaca medan Bumi: sekitar 20 mikrotesla ke arah utara magnetik dan 45 ke bawah, di lintang utara tengah. atan2 dari dua pembacaan horizontal adalah heading, dan itu saja yang dilakukan sketch kompas.
Chip mana yang ada di GY-271-ku?
Board yang dijual sebagai "GY-271" atau "HMC5883L" dulu memakai HMC5883L buatan Honeywell sampai produksinya dihentikan; sekarang kebanyakan memakai QMC5883L, yang punya alamat dan peta register berbeda. Jalankan I2C scanner: 0x0D berarti QMC5883L, 0x1E berarti HMC5883L. Sketch yang ditulis untuk chip lain tidak akan menemukan apa pun.
Pins
| Pin | Fungsinya |
|---|---|
VCC, GND |
Catu daya, 3 sampai 5 V di board, yang punya regulator 3,3 V sendiri. |
SCL, SDA |
I2C, hingga 400 kHz. Board sudah membawa pull-up. |
DRDY |
Tinggi saat sampel baru menunggu; membaca data membuatnya rendah. |
Properti
heading, pitch dan roll menunjukkan posisi board; slider memutar dan memiringkannya.
Membacanya di Arduino
Dengan library QMC5883LCompass (MPrograms), yang Mokxi sediakan sebagai 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() bernilai -180 sampai 180 derajat, 0 saat panah X board menunjuk utara. getDirection() mengisi tiga karakter, " N", "NNE" dan seterusnya, tanpa terminator.
Cara komunikasinya
Register kontrol 1 (0x09) menyetel mode (standby atau kontinu), laju data (10, 50, 100 atau 200 Hz), rentang (2 gauss dengan 12000 counts per gauss, atau 8 dengan 3000) dan oversampling. Setup dari datasheet adalah 0x01 ke register periode SET/RESET (0x0B), lalu 0x1D ke 0x09. Register status (0x06) punya DRDY (data baru), OVL (sumbu melewati -32768 atau 32767) dan DOR (sampel terlewat). Medannya ada di 0x00 sampai 0x05, byte rendah dulu; alamat register maju sendiri, jadi satu pembacaan enam byte dari 0x00 mendapatkan ketiga sumbu. Register kontrol 2 (0x0A) punya soft reset, pointer roll-over dan saklar yang mematikan pin DRDY. ID chip (0x0D) terbaca 0xFF.
Apa yang tidak dimodelkannya
Noise, offset, filter oversampling dan pengaruh periode SET/RESET (keduanya disimpan dan dapat dibaca kembali), magnet di dekatnya dan hard iron dari sasis robot. Offset register suhu tidak dikalibrasi di chip sungguhan, hanya 100 counts per derajatnya, jadi modelnya membaca 0 dan tidak berubah.
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.