تحلیل کتابخانه

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

lightEffect-arduino-library-digispark
نوشته شده توسط معین صابری

در مجموعه آموزش های تحلیل و بررسی کتابخانه های آردوینو، این آموزش را به تحلیل و بررسی یک کتابخانه بسیار کلیدی و کاربردی خواهیم پرداخت. همانطور که اطلاع دارید، ال ای دی ها ابزارهای بسیار کاربردی در ساخت تجهیزات نورپردازی به شمار می روند. به کمک این قطعات می توان به ساخت تابلو روان ها، سیستم های نور پردازی تبلیغاتی و…. پرداخت.  در کنار این، می توان با ایجاد افکت های مختلف، ال ای دی ها را روشن و خاموش کرده و به نورپردازی اقدام نمود. در این آموزش به تحلیل و بررسی کتابخانه LightEffect می پردازیم. به کمک این کتابخانه می توان افکت های مختلف و آماده ای را برای کنترل LED ایجاد کرد. در ادامه با مرجع تخصصی رزبری پای و آردوینو به زبان فارسی، دیجی اسپارک همراه باشید.

 


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


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

روش نصب کتابخانه PCF8574.h - دیجی اسپارک

 

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

روند نصب کتابخانه lightEffect آردوینو - دیجی اسپارک

 


الزامات و نکات فنی کتابخانه LightEffect


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

 


تحلیل توابع کلیدی و کاربردی


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

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

ورودی دوم تعداد LED ها

ورودی سوم وضعیت پیشفرض LED

LightEffect(int led1, int nbrLed, int valON)
این تابع تمام LED ها را روشن می کند. بدون ورودی onAll()

 

این تابع تمام LED ها را خاموش می کند. بدون ورودی offAll()

 

این تابع LED ها را از سمت راست به چپ روشن می کند. بدون ورودی onLeft()

 

این تابع ال ای ها را از راست به چپ خاموش می کند. بدون ورودی offLeft()

 

این تابع LED ها را از چپ به راست روشن می کند. بدون ورودی onRight()

 

این تابع LED ها را از چپ به راست خاموش می کند. بدون ورودی offRight()

 

این تابع کلیه LED ها را به حالت چشمک زن در می آورد. در ورودی این تابع می توانید تعداد LED مد نظر برای حالت چشمک زن را تعیین کنید. بدون ورودی blinkAll(N)

 

این تابع به صورت چشمک زن LED ها را از سمت چپ به راست خاموش و روشن می کند. بدون ورودی movingFlashLeft()

 

این تابع به صورت چشمک زن LED ها را از سمت راست به چپ خاموش و روشن می کند. بدون ورودی movingFlashRight()

 

این تابع ابتدا LED ها را به سمت جلو روشن کرده و سپس رو به عقب آن ها را خاموش می کند. بدون ورودی roundTrip()

 

این تابع به صورت رندوم LED ها را روشن می کند. بدون ورودی randomLightOn()

 

این تابع LED های روشن را به صورت رندوم خاموش می کند. بدون ورودی randomLightOff()

 

این تابع چراغ راهنمایی را برای دو تقاطع شبیه سازی می کند. برای استفاده از این تابع باید حداقل ۶ LED داشته باشید. توجه کنید که این تابع زمانبر است. بدون ورودی trafficLight()

 

 


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


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

#include <LightEffect.h>  //درج کلاس کتابخانه 
LightEffect sign_10Lights(4, 10, HIGH);  //ایجاد شی از کلاس کتابخانه 
void setup() {
}
void loop() {
  sign_10Lights.onAll();  //روشن کردن تمام ۱۰ LED
  delay(500);
  sign_10Lights.offAll();  //خاموش کردن تمام LED ها
  delay(500);
}

 


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


لینک خرید انواع برد آردوینو، کلیک کنید

لینک خرید انواع برد ESP، کلیک کنید

لینک خرید LED، کلیک کنید

لینک خرید مقاومت، کلیک کنید

 


جمع بندی


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

 

درباره نویسنده

معین صابری

کارشناسی ارشد رشته معماری سیستم های کامپیوتری

مالي که ز تو کس نستاند، علم است
حرزي که تو را به حق رساند، علم است
جز علم طلب مکن تو اندر عالم
چيزي که تو را ز غم رهاند، علم است
(شیخ بهایی)

تبادل نظر و رفع عیب با ثبت دیدگاه

۴ دیدگاه