This part has a page of its own, with a note on using it and a circuit to try: the part page.
Tên gọi khác: GY-271, QMC5883, module la bàn số, từ kế ba trục. Đặt phẳng trên bàn nó đọc được từ trường Trái Đất: khoảng 20 microtesla hướng về bắc từ và chúc xuống 45 độ, ở vĩ độ bắc trung bình. Giá trị atan2 của hai số đo phương ngang là góc phương vị, đó cũng là tất cả những gì một sketch la bàn làm.
Chip nào đang có trên bo GY-271 của mình?
Các bo mạch bán với tên "GY-271" hoặc "HMC5883L" trước đây dùng chip HMC5883L của Honeywell cho đến khi ngừng sản xuất; giờ hầu hết dùng QMC5883L, chip có địa chỉ và sơ đồ thanh ghi khác nhau. Chạy trình quét I2C: 0x0D là QMC5883L, 0x1E là HMC5883L. Sketch viết cho chip còn lại sẽ không tìm thấy gì.
Pins
| Pin | Công dụng |
|---|---|
VCC, GND |
Nguồn cấp, từ 3 đến 5 V vào bo mạch, bo có sẵn ổn áp 3.3 V riêng. |
SCL, SDA |
I2C, tối đa 400 kHz. Bo mạch có sẵn điện trở kéo lên. |
DRDY |
Mức cao khi có mẫu mới đang chờ; đọc dữ liệu sẽ đưa về mức thấp. |
Thuộc tính
heading, pitch và roll là tư thế của bo mạch; các thanh trượt xoay và nghiêng bo.
Đọc nó trên Arduino
Với thư viện QMC5883LCompass (MPrograms), Mokxi kèm sẵn dưới tên 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() trả về từ -180 đến 180 độ, bằng 0 khi mũi tên X của bo chỉ về bắc. getDirection() điền ba ký tự, " N", "NNE" v.v., không có ký tự kết thúc.
Cách nó giao tiếp
Thanh ghi điều khiển 1 (0x09) đặt chế độ (chờ hay liên tục), tốc độ dữ liệu (10, 50, 100 hoặc 200 Hz), dải đo (2 gauss với 12000 count một gauss, hoặc 8 gauss với 3000) và mức lấy mẫu vượt (oversampling). Thiết lập theo datasheet là ghi 0x01 vào thanh ghi chu kỳ SET/RESET (0x0B), rồi 0x1D vào 0x09. Thanh ghi trạng thái (0x06) có DRDY (dữ liệu mới), OVL (một trục vượt -32768 hoặc 32767) và DOR (một mẫu bị bỏ qua). Từ trường nằm ở 0x00 đến 0x05, byte thấp trước; địa chỉ thanh ghi tự tăng, nên một lần đọc sáu byte từ 0x00 lấy được cả ba trục. Thanh ghi điều khiển 2 (0x0A) có soft reset, vòng lặp con trỏ và công tắc tắt chân DRDY. ID của chip (0x0D) đọc được 0xFF.
Những gì nó không mô phỏng
Nhiễu, độ lệch, bộ lọc oversampling và ảnh hưởng của chu kỳ SET/RESET (cả hai đều được lưu và đọc lại), nam châm gần đó và từ tính cứng của khung robot. Độ lệch của các thanh ghi nhiệt độ không được hiệu chuẩn trên chip thật, chỉ có hệ số 100 count một độ, nên mô hình đọc 0 và giữ nguyên.
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.