معرفی Arduino CLI
Arduino CLI ابزار رسمی خط فرمان آردوینو است که امکانات اصلی محیط توسعه Arduino را بدون نیاز به رابط گرافیکی در اختیار کاربر قرار می‌دهد. با استفاده از این ابزار می‌توان هسته بردها و کتابخانه‌ها را نصب کرد، برد متصل‌شده را شناسایی کرد، برنامه‌ها را کامپایل کرد و فایل نهایی را روی برد بارگذاری نمود.
این ابزار برای کاربرانی مناسب است که می‌خواهند پروژه‌های Arduino، ESP8266 و ESP32 را از طریق خط فرمان مدیریت کنند یا مراحل کامپایل و پروگرام را در فایل‌های اجرایی و سامانه‌های خودکار به کار ببرند.
امکانات اصلی
- نصب و مدیریت هسته بردهای مختلف
- نصب، به‌روزرسانی و حذف کتابخانه‌ها
- شناسایی بردها و پورت‌های متصل
- کامپایل پروژه‌های Arduino
- بارگذاری برنامه روی برد
- نمایش اطلاعات بردها و پلتفرم‌های نصب‌شده
- استفاده در اسکریپت‌ها و فرایندهای خودکار
- مناسب برای سامانه‌های CI/CD و تولید انبوه
- امکان پروگرام برد بدون نصب محیط گرافیکی Arduino IDE
سیستم مورد نیاز
این فایل برای سیستم‌های زیر تهیه شده است:
- Windows 10 نسخه 64 بیتی
- Windows 11 نسخه 64 بیتی
- معماری x86-64
این نسخه برای ویندوز 32 بیتی، Linux یا macOS مناسب نیست و برای این سیستم‌ها باید نسخه اختصاصی آن‌ها دریافت شود.
روش نصب در ویندوز
- فایل ZIP را دانلود و از حالت فشرده خارج کنید.
- فایل
arduino-cli.exeرا در پوشه‌ای مانندC:\ArduinoCLIقرار دهید. - Command Prompt یا PowerShell را باز کنید.
- وارد پوشه برنامه شوید و دستور زیر را اجرا کنید:
[powershell] arduino-cli version
در صورت نمایش شماره نسخه، برنامه آماده استفاده است.
برای اجرای Arduino CLI از هر مسیر، می‌توانید پوشه برنامه را به متغیر PATH ویندوز اضافه کنید. راه‌اندازی اولیه برای ایجاد فایل تنظیمات Arduino CLI از دستور زیر استفاده کنید: arduino-cli config init
سپس فهرست بسته‌ها را به‌روزرسانی کنید: arduino-cli core update-index
برای نصب هسته بردهای معمول Arduino مانند Arduino Uno و Arduino Nano: arduino-cli core install arduino:avr
برای مشاهده بردهای متصل: arduino-cli board list
پشتیبانی از ESP32 و ESP8266 Arduino CLI به‌صورت پیش‌فرض فایل‌های هسته ESP32 و ESP8266 را همراه ندارد. برای استفاده از این بردها باید نشانی Board Manager مربوط به آن‌ها به تنظیمات اضافه و سپس هسته موردنظر نصب شود. نصب هسته ESP32 arduino-cli config add board_manager.additional_urls https://espressif.github.io/arduino-esp32/package_esp32_index.json arduino-cli core update-index arduino-cli core install esp32:esp32
نصب هسته ESP8266 arduino-cli config add board_manager.additional_urls https://arduino.esp8266.com/stable/package_esp8266com_index.json arduino-cli core update-index arduino-cli core install esp8266:esp8266
نکات مهم
- Arduino CLI دارای رابط گرافیکی نیست و از طریق Command Prompt، PowerShell یا اسکریپت‌ها اجرا می‌شود.
- برای دریافت فهرست بردها، هسته‌ها و کتابخانه‌ها به اینترنت دسترسی نیاز دارد.
- خطای no such host معمولا به مشکل DNS، اینترنت، فایروال یا دسترسی به سرورهای Arduino و GitHub مربوط است و به خود فایل Arduino CLI ارتباطی ندارد.
- برای پروگرام برد باید درایور USB مناسب برد روی ویندوز نصب شده باشد.
- قبل از استفاده، مقدار SHA-256 فایل را با مقدار اعلام‌شده در صفحه رسمی انتشار مقایسه کنید.
مجوز و منبع فایل Arduino CLI توسط مجموعه Arduino توسعه داده شده و با مجوز GPL-3.0 منتشر می‌شود. ARDUnia توسعه‌دهنده این نرم‌افزار نیست و فایل موجود در این صفحه صرفا به‌عنوان نسخه آینه برای دسترسی آسان‌تر کاربران ارائه شده است. برای مشاهده کد منبع، نسخه‌های جدید و مستندات رسمی به مخزن پروژه مراجعه کنید: https://github.com/arduino/arduino-cli