القطع

بوصلة QMC5883L (GY-271)

يقرأ QST QMC5883L المجال المغناطيسي على ثلاثة محاور عبر I2C على العنوان 0x0D: إنها الشريحة الموجودة على معظم لوحات البوصلة GY-271 المباعة اليوم.

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

أسماء أخرى: GY-271، QMC5883، وحدة بوصلة رقمية، مقياس مغناطيسية ثلاثي المحاور. عند وضعها مسطّحة على المنضدة تقرأ مجال الأرض: نحو 20 ميكروتسلا باتجاه الشمال المغناطيسي و45 نحو الأسفل، في خطوط العرض الشمالية المتوسطة. دالة atan2 للقراءتين الأفقيتين تعطي زاوية الاتجاه، وهذا كل ما يفعله كود البوصلة.

أي شريحة على لوحة GY-271 الخاصة بي؟

حملت اللوحات المباعة باسم "GY-271" أو "HMC5883L" شريحة HMC5883L من Honeywell حتى أوقفت؛ والآن تحمل معظمها QMC5883L، التي لها عنوان مختلف وخريطة سجلات مختلفة. شغّل ماسح I2C: 0x0D يعني QMC5883L، و0x1E يعني HMC5883L. الكود المكتوب للشريحة الأخرى لا يجد شيئًا.

Pins

Pin ماذا تفعل
VCC، GND التغذية، من 3 إلى 5 V على اللوحة، وفيها منظّم 3.3 V خاص بها.
SCL، SDA I2C، حتى 400 kHz. تحمل اللوحة مقاومات الرفع.
DRDY يبقى مرتفعًا أثناء انتظار عيّنة جديدة؛ وقراءة البيانات تخفضه.

الخصائص

heading وpitch وroll هي وضعية اللوحة؛ والمنزلقات تدوّرها وتميلها.

قراءته على Arduino

بمكتبة QMC5883LCompass (MPrograms)، التي يوفرها Mokxi باسم 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() تعطي من -180 إلى 180 درجة، وتكون 0 عندما يشير سهم X على اللوحة إلى الشمال. الدالة getDirection() تملأ ثلاثة أحرف، " N" و"NNE" وهكذا، دون حرف ختامي.

كيف يتحدث

سجل التحكم 1 (0x09) يضبط الوضع (استعداد أو متصل)، ومعدل البيانات (10 أو 50 أو 100 أو 200 Hz)، والمدى (2 غاوس بمعدل 12000 عدة لكل غاوس، أو 8 غاوس بمعدل 3000)، والإفراط في المعاينة. إعداد ورقة البيانات هو كتابة 0x01 في سجل فترة SET/RESET‏ (0x0B)، ثم 0x1D في 0x09. سجل الحالة (0x06) فيه DRDY (بيانات جديدة) وOVL (محور تجاوز -32768 أو 32767) وDOR (تخطّي عيّنة). المجال عند 0x00 إلى 0x05، البايت المنخفض أولًا؛ وعنوان السجل يتقدّم تلقائيًا، فقراءة واحدة لستة بايتات من 0x00 تجلب المحاور الثلاثة. سجل التحكم 2 (0x0A) فيه إعادة الضبط البرمجية، وتدوير المؤشر، والمفتاح الذي يطفئ طرف DRDY. معرّف الشريحة (0x0D) يُقرأ 0xFF.

ما لا يحاكيه

الضوضاء، والإزاحات، ومرشّح الإفراط في المعاينة، وتأثير فترة SET/RESET (كلاهما يُخزَّن ويُقرأ ثانية)، والمغناطيسات القريبة، والحديد الصلب في هيكل روبوت. إزاحة سجلات الحرارة غير معايرة في الشريحة الحقيقية، فقط 100 عدة لكل درجة، لذا يقرأ النموذج 0 ويبقى ثابتًا.

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.