تعلّم

ADXL345 على Arduino: X وY وZ وميزان استواء

متوسط

أو تصفّح كل الدروس.

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
Arduino Uno: حساس ADXL345 كميزان استواءمباشر0.000 s 0.00x
اضغط لفتحه في المحرر
حساس ADXL345 على A4 وA5، يُقرأ بمكتبة Adafruit، ويطبع X وY وZ ثلاث مرات في الثانية على ATmega328P محاكى.

ADXL345 هو مقياس تسارع صغير ثلاثي المحاور من Analog Devices. تجده على لوحة GY-291 في كثير من مجموعات الحساسات، ويتواصل مع Arduino عبر I2C، وهو في حالة السكون يقيس شيئًا واحدًا ببراعة: أي اتجاه هو الأسفل. هذا ما يجعله الشريحة التي تقف وراء إنذارات الميل وموازين الاستواء وحيلة "أي اتجاه يحمله هاتفي".

الدائرة أعلاه هي Uno يقرأ ADXL345 بمكتبة الحساسات الموحّدة من Adafruit. ثلاث مرات في الثانية يطبع المحاور الثلاثة بالمتر لكل ثانية مربعة، والعدد الخام على X، وكلمة نصيحة: مستوٍ، ارفع مقدّمته، أنزل مقدّمته، أو دحرجها إلى الاستواء. اضغط «تشغيل»، ثم اسحب اللوحة في مساحة العمل لتمييلها وراقب الأرقام وهي تتغير.

ما تحتاجه

  • Arduino Uno
  • لوحة ADXL345 (GY-291)
  • أربعة أسلاك توصيل
  • لوحة تجارب (اختيارية)

التوصيل

القطعة والطرفيتصل بـملاحظة
ADXL345 VCC5 Vتعمل GY-291 بجهد 3.3 V أو 5 V
ADXL345 GNDGND
ADXL345 SDAA4طرف بيانات I2C في Uno
ADXL345 SCLA5طرف ساعة I2C في Uno
CS وSDO وINT1 وINT2لا شيءتسحب اللوحة CS إلى المستوى العالي من أجل I2C وSDO إلى المنخفض للعنوان 0x53

ماذا يقرأ مقياس التسارع في حالة السكون

يقيس مقياس التسارع التسارع، والجاذبية تُحتسب. فهو مستوٍ على طاولة، يحس ADXL345 بقوة 1 g تسحب إلى الأسفل مباشرة عبر محور Z ولا شيء على X أو Y. أمِله، فينتقل جزء من قوة الـ 1 g تلك إلى X أو Y. مقدار ما ينتقل يخبرك بمقدار الميل: عند 30 درجة، نصفها يكون على المحور المائل، لأن جيب 30 درجة يساوي نصفًا.

يحوّل الشريحة كل محور إلى رقم. عند الدقة الكاملة، العد الواحد يساوي 3.9 من الألف من g، أي أن 1 g تساوي نحو 256 عدًّا. يجلس على عنوان I2C وهو 0x53 عندما يكون طرف SDO منخفضًا، وهكذا تأتي GY-291 من المصنع، وعلى 0x1D عندما يُرفع SDO.

تفصيل واحد يتعثر فيه من يكتب الكود بنفسه: تبدأ الشريحة عملها في وضع الاستعداد ولا تقيس شيئًا حتى يُطلب منها ذلك. حتى ذلك الحين يقرأ كل محور صفرًا. دالة begin() في المكتبة تفعل ذلك عنك.

مكتبة Adafruit ADXL345

معظم دروس ADXL345 تستخدم Adafruit_ADXL345_U.h، التي تحتاج إلى Adafruit_Sensor.h بجانبها. في Arduino IDE تثبّت "Adafruit ADXL345" من مدير المكتبات وهي تجلب معها مكتبة Unified Sensor. في Mokxi كلتاهما مدمجتان، فتعمل تعليمات التضمين دون إضافة شيء.

تتحقق begin() من أن الشريحة تجيب بهويتها وتوقظها. إذا لم يجب شيء، يطبع هذا الكود "No ADXL345 detected" ويتوقف. تختار setRange() المدى 2 أو 4 أو 8 أو 16 g؛ ولأجل الميل يصلح أي منها، ويستخدم الكود مدى 16 g بالدقة الكاملة.

تقرأ getEvent() المحاور الثلاثة دفعة واحدة وتعيدها بالمتر لكل ثانية مربعة. أما getX() وgetY() وgetZ() فتعطي العد الخام بدلًا من ذلك، وهو ما يقارنه الكود ليقرر اتجاه الميل.

كود ميزان الميل
#include <Wire.h>
#include <Adafruit_Sensor.h>
#include <Adafruit_ADXL345_U.h>

Adafruit_ADXL345_Unified accel = Adafruit_ADXL345_Unified(12345);

void setup() {
  Serial.begin(9600);
  if (!accel.begin()) {
    Serial.println("No ADXL345 detected");
    while (1) delay(10);
  }
  accel.setRange(ADXL345_RANGE_16_G);
  Serial.println("Tilt level: ADXL345 ready");
}

void loop() {
  sensors_event_t event;
  accel.getEvent(&event);
  int16_t rawX = accel.getX();

  Serial.print("X: ");
  Serial.print(event.acceleration.x);
  Serial.print("  Y: ");
  Serial.print(event.acceleration.y);
  Serial.print("  Z: ");
  Serial.print(event.acceleration.z);
  Serial.print(" m/s^2  raw X ");
  Serial.print(rawX);

  // Half a m/s^2 is 13 counts at 3.9 mg a count.
  int16_t rawY = accel.getY();
  if (rawX > 13) {
    Serial.println("  tip it nose up");
  } else if (rawX < -13) {
    Serial.println("  tip it nose down");
  } else if (rawY > 13 || rawY < -13) {
    Serial.println("  roll it level");
  } else {
    Serial.println("  level");
  }
  delay(300);
}

افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.

ماذا يطبع، ولماذا تقرأ القيمة عند الاستواء 10.04

اضغط «تشغيل» فيكون السطر الأول بعد "Tilt level: ADXL345 ready" كله أصفارًا: "X: 0.00 Y: 0.00 Z: 0.00 m/s^2 raw X 0 level". سأل الكود قبل أن تُكمل الشريحة عيّنتها الأولى. وبعد ثلث ثانية يقرأ "X: 0.00 Y: 0.00 Z: 10.04 m/s^2 raw X 0 level".

لماذا 10.04 وليس 9.81؟ المكتبة تحوّل كل عدّة إلى 4 آلاف من الجاذبية، وهو رقم مقرّب قريب من القيمة الحقيقية للشريحة وهي 3.9. لذلك تظهر 256 عدّة لكل 1 g كأنها 1.024 g، أي 10.04 m/s^2. اللوحات الحقيقية تُظهر الشيء نفسه، مع قليل من التشويش وانزياح خاص بها. بالنسبة للميل لا يهم الأمر، لأن المهم هو النسبة على كل محور.

Drag the board 30 degrees nose up and the line becomes "X: -5.02 Y: 0.00 Z: 8.71 m/s^2 raw X -128 tip it nose down": half of 256 counts, with a minus sign, and the sketch says how to fix it. Tip it 30 degrees the other way and you get "raw X 128 tip it nose up". Roll it 20 degrees sideways and Y takes 3.45 m/s^2, with "roll it level". At 2 degrees of roll Y reads 0.35, under the 13 count limit, and the sketch calls it level.

‏I2C أو SPI

يمكن للشريحة ADXL345 أيضًا التحدث عبر SPI: أبقِ CS منخفضًا فتتجاهل الشريحة I2C وتستمع على SDA وSDO وSCL كناقل SPI بأربعة أسلاك. بعض الدروس تستخدم ذلك لقراءات أسرع. بالنسبة لحساس ميل أو عدّاد خطوات يكفي I2C تمامًا، ولا يحتاج إلا إلى سلكين يمكن لحساسات أخرى أن تتشاركهما.

‏Mokxi يحاكي جانب I2C فقط. مع إبقاء CS منخفضًا تصمت الشريحة المحاكاة على I2C، كما تفعل الشريحة الحقيقية، لكنها لا ترد على SPI. إذا احتاج مشروعك إلى SPI، فجرّب هذا التوصيل على لوحة حقيقية.

هناك أيضًا مثال مدمج ثانٍ يتخطى المكتبة ويقرأ سجلات الشريحة عبر Wire، بايتًا بايت. يستحق أن تلقي نظرة عليه إذا أردت أن ترى ما يرسله فعليًا كل من begin() وgetEvent().

أخطاء شائعة

Reading zeros on every axis. A hand-written driver that never writes 0x08 to the POWER_CTL register leaves the chip in standby. Use begin(), or write that byte yourself.

العنوان الخطأ. عندما يُوصَّل SDO بـ 5 V تنتقل الشريحة إلى 0x1D، ولا يجد الكود الذي يبحث في 0x53 شيئًا. وصّل SDO عاليًا هنا فيطبع الكود "No ADXL345 detected"، وهو السطر نفسه الذي يظهر عند نزع SDA.

توقّع 9.81 والشريحة مستوية. مع هذه المكتبة تُقرأ القيمة المستوية نحو 10.04، واللوحة الحقيقية أيضًا فيها انزياح صغير على كل محور. عايِر القياس وفق قراءتك المستوية إذا احتجت أرقامًا دقيقة.

الخلط بين المحاور. الأسهم المطبوعة على GY-291 تُظهر X وY. املِ اللوحة وراقب أي رقم يتغيّر قبل أن تكتب الكود الذي يتفاعل معه.

افتح هذه الدائرة في المحرر. ‏Arduino Uno: شريحة ADXL345 كميزان ميل، موصّلة كما تعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة واضغط «تشغيل» مرة أخرى.

افتح الدائرة

الأسئلة

أي مكتبة أحتاج للشريحة ADXL345 على Arduino؟

مكتبة Adafruit ADXL345 (Adafruit_ADXL345_U.h) ومكتبة Adafruit Unified Sensor (Adafruit_Sensor.h)، كلتاهما من مدير المكتبات. في Mokxi مدمجتان بالفعل.

ما هو عنوان ADXL345 على I2C؟

0x53 عندما يكون SDO منخفضًا أو متروكًا مفتوحًا، وهو الوضع الافتراضي لوحدة GY-291، و0x1D عند ربط SDO بالمستوى العالي.

كيف أوصّل ADXL345 بلوحة Arduino Uno؟

VCC مع 5 V، وGND مع GND، وSDA مع A4 وSCL مع A5. اترك CS وSDO وطرفَي المقاطعة كما تجذبهما اللوحة.

لماذا يقرأ ADXL345 عندي القيمة 10 بدلًا من 9.8 m/s^2؟

The Adafruit library scales each count as 4 thousandths of a g, slightly more than the chip’s 3.9, so 1 g reads about 10.04. Real boards add their own small offsets on top.

هل يمكنني استخدام ADXL345 عبر SPI؟

الشريحة تدعم ذلك مع إبقاء CS منخفضًا. يحاكي Mokxi جانب I2C فقط، لذا جرّب توصيل SPI على عتاد حقيقي.

المصادر

من أين جاءت الحقائق في هذه الصفحة

ابنِ هذا على أرض الواقع

افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.