آردوینو ایران | آموزش تخصصی آردوینو به فارسی

ثابت LED_BUILTIN در آردوینو — کنترل LED داخلی بدون نیاز به شماره پین

LED_BUILTIN چیست؟

در آردوینو، LED_BUILTIN یک ثابت پیش‌تعریف‌شده است که به‌طور خودکار شماره پین متصل به LED داخلی برد را مشخص می‌کند.
این ثابت به شما اجازه می‌دهد بدون نیاز به دانستن شماره دقیق پین، LED داخلی را کنترل کنید — چه روی Arduino Uno، Nano، Mega یا هر برد دیگری.

توضیح برای مبتدی‌ها: بیشتر برد‌های آردوینو یک LED کوچک روی خودشان دارند که معمولاً به یکی از پین‌ها متصل است (مثلاً پین ۱۳ در Uno). به جای اینکه همیشه عدد ۱۳ را به یاد داشته باشید، می‌توانید از LED_BUILTIN استفاده کنید. آردوینو خودش می‌داند که روی برد شما این LED به کدام پین وصل است!

چرا از LED_BUILTIN استفاده کنیم؟

استفاده از این ثابت چند مزیت مهم دارد: — قابلیت انتقال کد: کد شما روی هر برد آردوینو بدون تغییر کار می‌کند.
— خوانایی بهتر: هر کس کد شما را بخواند، متوجه می‌شود که منظور شما LED داخلی برد است.
— کاهش خطا: دیگر نیازی نیست شماره پین را برای هر برد جداگانه بررسی کنید.

مقادیر LED_BUILTIN در برد‌های رایج

• Arduino Uno, Nano, Mini: پین ۱۳
• Arduino Mega: پین ۱۳
• Arduino Leonardo: پین ۱۳
• Arduino Due: پین ۱۳
• ESP32 DevKit: معمولاً پین ۲ (اما بسته به مدل متفاوت است)
• Arduino MKR: پین LED_BUILTIN مستقیماً تعریف شده و ممکن است به پین خاصی متصل نباشد

نکته مهم: شما نیازی به حفظ این اعداد ندارید! کافی است همیشه از LED_BUILTIN استفاده کنید.

نحوه استفاده در کد

استفاده از LED_BUILTIN دقیقاً مثل استفاده از یک شماره پین است:

void setup() {
  pinMode(LED_BUILTIN, OUTPUT);  // تنظیم LED داخلی به عنوان خروجی
}

void loop() {
  digitalWrite(LED_BUILTIN, HIGH);  // LED روشن
  delay(1000);
  digitalWrite(LED_BUILTIN, LOW);   // LED خاموش
  delay(1000);
}

مثال کاربردی: تست سریع سلامت برد

اولین برنامه‌ای که بسیاری از مبتدی‌ها می‌نویسند، چشمک زدن LED داخلی است. با LED_BUILTIN، این کد روی هر بردی کار می‌کند:

// این کد روی هر برد آردوینو بدون تغییر کار می‌کند!
void setup() {
  pinMode(LED_BUILTIN, OUTPUT);
}

void loop() {
  digitalWrite(LED_BUILTIN, !digitalRead(LED_BUILTIN)); // تغییر وضعیت
  delay(500);
}

توضیح برای مبتدی‌ها: تابع digitalRead(LED_BUILTIN) وضعیت فعلی LED را می‌خواند. علامت ! آن را معکوس می‌کند (اگر روشن بود، خاموش می‌شود و بالعکس). این روش هوشمندانه‌تر از نوشتن دو خط جداگانه برای روشن و خاموش کردن است.

نکته طلایی ۱: LED_BUILTIN همیشه وجود ندارد — اما کد شما باز هم کامپایل می‌شود!

برخی برد‌های آردوینو (مثل بردهای کوچک یا ماژول‌های خاص) LED داخلی ندارند. در این موارد، LED_BUILTIN معمولاً به یک پین مجازی یا پین -۱ تعریف می‌شود.
کد شما بدون خطا کامپایل می‌شود، اما LED چشمک نمی‌زند — چون فیزیکی وجود ندارد. این رفتار کاملاً طبیعی است و نشان‌دهنده‌ی خطا نیست.

نکته طلایی ۲: برای پروژه‌های نهایی، از LED خارجی استفاده کنید

LED داخلی برد فقط برای تست و آموزش مناسب است. چون: — روشنایی آن کم است.
— ممکن است در برد شما به‌صورت معکوس متصل باشد (روشن = LOW).
— در پروژه‌های واقعی، نیاز به LED در جای خاصی دارید — نه روی برد.
پس برای پروژه‌های نهایی، حتماً از LED خارجی با مقاومت مناسب استفاده کنید.

جمع‌بندی

• LED_BUILTIN = ثابتی برای دسترسی به LED داخلی برد
• کد شما را قابل انتقال بین برد‌های مختلف می‌کند
• در pinMode() و digitalWrite() استفاده می‌شود
• اولین اسکچ هر مبتدی باید از این ثابت استفاده کند!

منبع رسمی

این مطلب بر اساس مستندات رسمی Arduino از بخش LED_BUILTIN – Language Reference تهیه شده است، با توضیحات ساده‌شده، مثال‌های کاربردی و نکات طلایی منحصربه‌فرد برای جامعه فارسی‌زبان.