تحلیل و بررسی کتابخانه APDS9960

در سلسله آموزش های تحلیل و بررسی کتابخانه های آردوینو، این قسمت به بررسی کتابخانه APDS9960 می پردازیم. این کتابخانه که برای سنسوری با همین نام توسعه یافته، راه اندازی و کار با آن را بسیار تسریع می بخشد. سنسور ADPS9960 یک سنسور فوق العاده کاربردی است. این سنسور دارای ویژگی های فراوانی نظیر تشخیص مجاورت، رنگ و حرکت است. از طرفی دیگر این سنسور در برد تازه توسعه یافته NANO BLE نیز به کار رفته است. در این آموزش به تحلیل و بررسی کتابخانه این سنسور پرکاربرد می پردازیم.  در ادامه این آموزش با مرجع تخصصی آردوینو به زبان فارسی، دیجی اسپارک، همراه باشید.

نصب کتابخانه ADPS9960

 به منظور استفاده از کتابخانه ADPS9960، ابتدا می بایست آن را نصب کنیم. در این قسمت به نصب کتابخانه سنسور شتاب سنج با جستجو در مخازن آردوینو می پردازیم. به همین منظور، ابتدا در نرم افزار آردوینو بر روی گزینه Tools و سپس Manage Libraries را کلیک کنید. پس از کلیک بر روی این گزینه، با تصویر زیر رو به می شوید. این منو کتابخانه های در دسترس را به شما نشان می دهد. شما نیز می توانید با جستجوی نام کتابخانه مورد نظر خود، آن را در مخازن آردوینو یافته و سپس نصب کنید.

مطابق فلش مشخص شده در تصویر فوق، در کادر جستجو عبارت APDS9960 را تایپ کنید. پس از چند لحظه با تصویر زیر رو به رو می شوید. در این مرحله، کتابخانه مشخص شده با کادر قرمز رنگ را با کلیک بر روی گزینه install، نصب کنید.

الزامات و نکات فنی استفاده از کتابخانه APDS9960

 همانطور که گفته شد از این سنسور در طراحی برد NANO BLE استفاده شده است. این سنسور دارای ارتباط I2C بوده که به صورت سخت افزاری با بردها و میکروکنترلرها قابلیت راه اندازی دارد. از این رو دقت نظر لازم را در نظر داشته باشید. از طرفی دیگر، با توجه به پشتیبانی کتابخانه از I2C سخت افزاری، انتظار می رود این کتابخانه علاوه بر بردهای آردوینو، روی بردهای ESP نیز قابل استفاده باشد.

توابع کلیدی کتابخانه APDS9960

  پس از بررسی نحوه نصب و الزامات فنی، نوبت به تحلیل و بررسی توابع کلیدی می رسد. توابع کلیدی و کاربردی کتابخانه در جدول زیر لیست شده اند.

پس از بررسی توابع کلیدی و کاربردی، نوبت به اجرای یک نمونه برنامه ساده می رسد. این موضوع را در قسمت بعدی مورد بررسی قرار خواهیم داد.

اجرای یک نمونه برنامه

 پس از بررسی توابع کلیدی، در این قسمت به اجرای یک نمونه برنامه می پردازیم. در این برنامه رنگ خوانده شده و در خروجی به کاربر نمایش داده می شود.

#include <Arduino_APDS9960.h>  //اضافه کردن کتابخانه به برنامه
//توجه: می توان شی از کلاس تعریف نکرد و با اسم تعریف شده در کتابخانه، آن را راه اندازی نمود. این اسم APDS است.
void setup() {
  Serial.begin(9600);
  while (!Serial);

  if (!APDS.begin()) {
    Serial.println("Error initializing APDS-9960 sensor.");
  }
}

void loop() {

  while (! APDS.colorAvailable()) {    //انتظار  برای آماده شدن برای راه اندازی واحد تشخیص رنگ سنسور
    delay(5);
  }
  int r, g, b;   //تعریف متغیر برای ذخیره رنگ

  APDS.readColor(r, g, b);   //خواندن رنگ و قرار دادن در ورودی ها

  // چاپ مقادیر در خروجی
  Serial.print("r = ");
  Serial.println(r);
  Serial.print("g = ");
  Serial.println(g);
  Serial.print("b = ");
  Serial.println(b);
  Serial.println();

  // برای خواندن مجدد یک ثاینه صبر می کنیم.
  delay(1000);
}

لوازم مورد نیاز

برد آردوینو NANO 33 BLE

جمع بندی

 در این آموزش به تحلیل و بررسی کتابخانه APDS9960 پرداختیم. مطابق رویه معمول در تحلیل و بررسی کتابخانه ها، ابتدا به نصب کتابخانه و سپس الزامات فنی آن پرداختیم. سپس در ادامه توابع کلیدی و کاربردی کتابخانه مورد تحلیل و بررسی قرار گرفت. در نهایت با ارائه یک مثال، نحوه استفاده از توابع در یک برنامه عمل را شرح دادیم. سنسور APDS9960 یک سنسور فوق العاده کاربردی بوده که توانایی تشخیص رنگ، حرکت و مجاورت را در خود جای داده است. از این سنسور در برد NANO BLE نیز بهره گرفته شده است.

چنانچه در مراحل راه اندازی و انجام این پروژه با مشکل مواجه شدید، بدون هیچ نگرانی در انتهای همین پست، به صورت ثبت نظر سوالتان را مطرح کنید. من در سریع‌ترین زمان ممکن پاسخ رفع مشکل شما را خواهم داد. همچنین اگر ایرادی در کدها و یا مراحل اجرایی وجود دارند می‌توانید از همین طریق اطلاع رسانی کنید.