تعلّم

مسطرة ليزر بـ Arduino باستخدام الحساس VL53L0X

مبتدئ

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

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
Arduino Uno: مسطرة ليزر VL53L0Xمباشر0.000 s 0.00x
اضغط لفتحه في المحرر
حساس VL53L0X على I2C مع شريحة ATmega328P محاكاة. اسحب المنزلق على الحساس لتحريك الهدف.

الحساس VL53L0X هو حساس مسافة ليزري صغير على لوحة بحجم ظفر الإصبع. يطلق نبضة من ضوء الأشعة تحت الحمراء غير المرئي، ويقيس الزمن الذي يستغرقه الضوء ليرتد، ثم يبلّغ المسافة بالمليمترات. إنه أدق من الحساس فوق الصوتي في المدى القصير، ويعمل على الأهداف الناعمة والمائلة التي تمتص الصوت، وشعاعه ضيّق.

الدائرة أعلاه هي Arduino Uno مع حساس VL53L0X على I2C. اسحب المنزلق على الحساس لتحريك الهدف، وتطبع الشاشة التسلسلية المسافة خمس مرات في الثانية. تعمل في متصفحك على الكود أدناه، الذي يستخدم الاستدعاءات من مكتبة Pololu للحساس VL53L0X.

ما تحتاجه

  • Arduino Uno
  • لوحة VL53L0X breakout (لوحتا GY-530 وPololu هما الشائعتان)
  • لوحة تجارب نصف الحجم وأربعة أسلاك توصيل

التوصيل

القطعة والطرفيتصل بـملاحظة
VL53L0X VIN5 Vمعظم اللوحات فيها منظم جهد لـ 3.3 V أو 5 V
VL53L0X GNDGND
VL53L0X SDAA4بيانات I2C على Uno
VL53L0X SCLA5ساعة I2C على Uno
XSHUT وGPIO1غير موصوللا يلزم إلا مع عدة حساسات أو مقاطعات

كيف يستطيع الليزر قياس زمن بهذه السرعة؟

يقطع الضوء مترًا واحدًا في نحو 3.3 نانو ثانية، وهذا أسرع بكثير من قدرة ساعة عادية. يستخدم VL53L0X شبكة من كاشفات الفوتون المفرد التي تعدّ الضوء العائد وتستنتج التأخير منه. كل ما يراه كودك هو رقم بالمليمترات، عبر I2C في العنوان 0x29.

في وضعه الافتراضي يصل إلى نحو 1.2 متر على هدف أبيض في الداخل. بعد ذلك لا يعود شيء مفيد، وتبلّغ الشريحة بالقيمة 8190، التي يطبعها الكود كـ "out of range". كل قراءة تستغرق نحو 33 ميلي ثانية.

الكود، خطوة بخطوة

تبدأ setup() بتشغيل I2C، وتضبط مهلة 500 ميلي ثانية حتى لا يتجمّد الكود بسبب حساس مفقود، ثم تستدعي init(). إذا فشلت init()، يطبع الكود "Failed to detect and initialize sensor!" ويتوقف. وإلا فإنه يبدأ القياس المستمر ويطبع "Laser ruler ready".

تقرأ loop() آخر قياس بـ readRangeContinuousMillimeters(). مع الهدف في بداية المنزلق تطبع "distance 300 mm". حرّكه إلى 250 mm فتقول الأسطر التالية 250. حرّكه إلى 1.5 متر فتقول الأسطر "out of range".

كود مسطرة الليزر
#include <Wire.h>
#include <VL53L0X.h>

VL53L0X sensor;

void setup() {
  Serial.begin(9600);
  Wire.begin();
  sensor.setTimeout(500);
  if (!sensor.init()) {
    Serial.println("Failed to detect and initialize sensor!");
    while (1) {
    }
  }
  sensor.startContinuous();
  Serial.println("Laser ruler ready");
}

void loop() {
  uint16_t mm = sensor.readRangeContinuousMillimeters();
  if (sensor.timeoutOccurred()) {
    Serial.println("timeout");
  } else if (mm >= 8190) {
    Serial.println("out of range");
  } else {
    Serial.print("distance ");
    Serial.print(mm);
    Serial.println(" mm");
  }
  delay(200);
}

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

VL53L0X أم HC-SR04؟

حساس الموجات فوق الصوتية HC-SR04 يصل إلى مدى أبعد، عدة أمتار، وثمنه أقل. أما VL53L0X فأصغر وأسرع وأدق عن قرب، وشعاعه أضيق بكثير، لذا يرى الشيء الذي أمامه بدلًا من الجدار بجانبه. كما يحتاج فقط إلى سلكَي I2C، ويمكنك مشاركتهما مع حساسات أخرى.

للمسافات التي تتجاوز 1.2 متر، يصل شقيقه الأكبر VL53L1X إلى نحو 4 أمتار بنفس التوصيلات. كلاهما متوفر على منضدة Mokxi.

حساسان أو أكثر على ناقل واحد

كل وحدة VL53L0X تبدأ العمل بنفس عنوان I2C وهو 0x29، لذا فإن وحدتين منهما على الأسلاك نفسها تجيبان معًا فلا تعمل أي منهما. الحل يستخدم طرف XSHUT الذي يُبقي الحساس مطفأ. وصّل طرف XSHUT لكل حساس بطرف رقمي خاص به. في setup()، أبقِها جميعًا منخفضة، ثم ارفع الأول وأعطِه عنوانًا جديدًا باستخدام setAddress(0x30)، ثم ارفع التالي.

يستمر العنوان الجديد حتى ينقطع التيار أو يعود XSHUT منخفضًا، لذلك يقوم الكود بهذه العملية في كل مرة يبدأ فيها. والحساس المُحاكى يحفظ العنوان الجديد بالطريقة نفسها.

جرّبه في المحرر

أضف LED على الطرف 9 يزداد سطوعه كلما اقترب الهدف، باستخدام analogWrite() و map(). أو أضف طنانًا يصدر صفيرًا أسرع كلما صغرت المسافة، مثل حساس ركن السيارات.

ثم اسحب سلك SDA واضغط «تشغيل». سيطبع الكود "Failed to detect and initialize sensor!"، وهذا بالضبط ما يفعله السلك غير المثبّت جيدًا على الطاولة.

أخطاء شائعة

تبديل SDA و SCL. على لوحة Uno، الطرف SDA هو A4 والطرف SCL هو A5. وعلى Mega هما الطرفان 20 و21.

حساسان على ناقل واحد. كلاهما يجيب على 0x29. أبقِ أحدهما في وضع إعادة الضبط عبر XSHUT، وأعطِ الآخر عنوانًا جديدًا باستخدام setAddress()، ثم ارفع الأول.

ترك غلاف الحماية. كثير من اللوحات يُشحن مع طبقة بلاستيكية رقيقة فوق الحساس. انزعها وإلا عادت القراءات أقصر من الحقيقة.

توقّع أن يرى عبر الزجاج أو تحت ضوء الشمس القوي. الزجاج يعكس الشعاع، وضوء الشمس القوي يغمره، فيقل المدى.

افتح هذه الدائرة في المحرر. Arduino Uno: مسطرة ليزر VL53L0X، موصولة كما تعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّلها مرة أخرى.

افتح الدائرة

الأسئلة

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

VIN إلى 5V، وGND إلى GND، وSDA إلى A4، وSCL إلى A5. ثم استخدم مكتبة Pololu VL53L0X: init() و startContinuous() و readRangeContinuousMillimeters().

ما هو مدى VL53L0X؟

نحو 1.2 متر في الوضع الافتراضي على هدف أبيض في الداخل. الهدف الداكن أو الضوء الساطع يقصّره. وإذا تجاوز الهدف المدى قرأ الكود 8190.

هل تعمل مكتبة Adafruit VL53L0X أيضًا؟

المثال هنا يستخدم نداءات مكتبة Pololu، وتتم ترجمتها في Mokxi. راجع قائمة المكتبات في المحرر بكتابة #include < لتعرف ما يمكن للوحتك بناؤه أيضًا.

ما الذي لا تحاكيه Mokxi في VL53L0X؟

الملّيمترات القليلة من التشويش الموجودة في القراءة الحقيقية، وكيف يغيّر لون الهدف وضوء الغرفة المدى، ووضعا المدى الطويل والدقة العالية. المسافة هي بالضبط ما يقوله المنزلق.

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

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