اگر Arduino IDE باز میشود اما هنگام دانلود، نصب برد، دریافت کتابخانه یا بارگذاری اولیه متوقف میماند، این وضعیت الزاماً به معنی «فیلتر شدن خود نرمافزار آردوینو» نیست. مشکل میتواند از دسترسی شبکه، DNS، پروکسی، فایروال، گواهی امنیتی، ساعت نادرست سیستم، قطعی موقت سرور یا حتی کابل USB باشد. در این راهنما، ابتدا نوع خطا را مشخص میکنیم و سپس راهحل متناسب با همان خطا را انتخاب میکنیم.
پاسخ کوتاه: Arduino IDE را فقط از وبسایت رسمی Arduino دریافت کنید. اگر دانلود یا نصب هستهٔ برد و کتابخانه انجام نمیشود، زمان سیستم، اتصال اینترنت، فایروال و تنظیمات پروکسی را بررسی کنید. در شبکههای دانشگاهی یا سازمانی، از مدیر شبکه بخواهید دسترسی HTTPS به دامنههای رسمی موردنیاز Arduino، از جمله downloads.arduino.cc، بررسی شود. اگر اتصال پیوسته در دسترس نیست، میتوان وابستگیهای لازم را روی یک رایانهٔ مجاز آماده و بهصورت کنترلشده به رایانهٔ آفلاین منتقل کرد. خاموشکردن آنتیویروس یا دریافت فایل از منابع ناشناس راهحل امنی نیست.
پیش از شروع: دقیقاً کدام بخش آردوینو کار نمیکند؟
عبارت «فیلتر شدن آردوینو» ممکن است به چند مشکل متفاوت اشاره کند. پیش از تغییر تنظیمات، نشانهٔ اصلی را مشخص کنید:
- وبسایت یا صفحهٔ دانلود باز نمیشود: مشکل میتواند از مرورگر، DNS، شبکه یا مسیر اینترنت باشد.
- فایل نصب دانلود نمیشود یا ناقص است: اتصال ناپایدار، محدودیت دانلود یا نرمافزار امنیتی را بررسی کنید.
- IDE در اجرای نخست متوقف میشود: ممکن است برنامه در حال دریافت اجزای ضروری باشد یا ارتباط آن با سرور برقرار نشده باشد.
- Boards Manager یا Library Manager خطا میدهد: ارتباط با فهرست بستهها یا سرور دانلود برقرار نشده است.
- برنامه کامپایل میشود اما برد شناسایی نمیشود: این مورد معمولاً به کابل USB، درایور، انتخاب برد یا پورت مربوط است، نه فیلتر اینترنت.
گام اول: دریافت امن و صحیح Arduino IDE
نسخهٔ مناسب سیستمعامل خود را از صفحهٔ رسمی Arduino Software دریافت کنید. سیستمعامل و معماری درست، مانند Windows، macOS یا Linux و نسخهٔ ۶۴ بیتی، را انتخاب کنید.
- از لینکهای بازنشرشده، فایلهای دستکاریشده و نسخههای ناشناس استفاده نکنید.
- برای نصب تازه، Arduino IDE 2 معمولاً انتخاب مناسبتری از نسخهٔ قدیمی 1.8.19 است؛ مگر اینکه پروژهٔ شما به نسخهٔ قدیمی وابسته باشد.
- در ویندوز، نام ناشر دیجیتال فایل نصب را بررسی کنید.
- اگر وبسایت رسمی مقدار هش فایل را ارائه کرد، هش فایل دانلودشده را با مقدار اعلامشده مقایسه کنید.
- پس از نصب، ابتدا خود IDE را اجرا کنید و سپس نصب هستهٔ برد و کتابخانهها را آزمایش کنید.
گام دوم: آزمایش اتصال پایه و زمان سیستم
صفحهٔ رسمی Arduino و لینک دانلود را جداگانه در مرورگر باز کنید. اگر امکان دارد، همان آزمایش را با شبکهای که استفاده از آن مجاز است، مانند اینترنت خانگی یا شبکهٔ دانشگاه، تکرار کنید. تفاوت نتیجه میان دو شبکه میتواند نشان دهد که محدودیت در سطح شبکهٔ محل کار یا دانشگاه قرار دارد.
- تاریخ و ساعت سیستم را اصلاح کنید؛ ساعت نادرست میتواند اعتبار گواهی HTTPS را مختل کند.
- اتصال اینترنت را با یک وبسایت معتبر دیگر آزمایش کنید.
- از تغییر تصادفی DNS یا نصب ابزارهای ناشناس خودداری کنید؛ این کارها علت مشکل را ثابت نمیکنند.
- اگر تنها دانلود فایل مشکل دارد، حجم فایل و کاملشدن دانلود را بررسی کنید.
گام سوم: بررسی فایروال و پروکسی
در شبکهٔ شخصی، پیام فایروال سیستمعامل را بررسی کنید و فقط اجازهٔ لازم برای برنامهٔ رسمی را صادر کنید. کل فایروال یا آنتیویروس را خاموش نکنید؛ این کار امنیت سیستم را کاهش میدهد و معمولاً علت اصلی را نیز مشخص نمیکند.
در شبکهٔ سازمانی یا دانشگاهی، از مسئول فناوری اطلاعات بخواهید دسترسی خروجی HTTPS به دامنههای رسمی موردنیاز Arduino را بررسی کند. مستندات Arduino برای دریافت هستهها و کتابخانهها به دامنههایی مانند downloads.arduino.cc نیاز دارد. اگر سازمان از پروکسی استفاده میکند، تنظیمات Arduino IDE را فقط بر اساس اطلاعات رسمی همان سازمان وارد کنید و آدرس یا اطلاعات ورود را حدس نزنید.
مجازکردن یک دامنه برای دریافت هسته و کتابخانه با دسترسی به Arduino Cloud یا قابلیتهای شبکهای برد یکسان نیست. برای سرویسهای Cloud ممکن است دامنهها و پورتهای دیگری لازم باشد؛ این موارد باید از راهنمای رسمی Arduino و مسئول شبکه بررسی شوند.
گام چهارم: نصب هستهٔ برد و کتابخانهها
پس از اطمینان از اتصال، از بخش Boards Manager هستهٔ سازگار با برد را نصب کنید و سپس کتابخانههای موردنیاز را از Library Manager دریافت کنید.
- مدل دقیق برد را از روی خود برد یا مستندات سازنده مشخص کنید.
- هستهٔ رسمی یا هستهٔ سازندهٔ معتبر را انتخاب کنید.
- اگر برد محصول شرکت دیگری است، نشانی Additional Boards Manager URLs را فقط از مستندات رسمی همان سازنده بگیرید.
- پس از نصب، یک مثال ساده مانند Blink را باز کنید.
- برد و پورت صحیح را انتخاب کنید و ابتدا فقط کامپایل را آزمایش کنید.
برای اطلاعات بیشتر، راهنمای رسمی افزودن پلتفرمهای شخص ثالث به Boards Manager را مطالعه کنید. نشانیهای ناشناس میتوانند بستهٔ نامعتبر، قدیمی یا ناسازگار ارائه کنند.
گام پنجم: استفاده از Arduino IDE در حالت آفلاین
نسخهٔ دسکتاپ Arduino IDE پس از نصب اجزای لازم میتواند برای ویرایش و کامپایل بسیاری از پروژهها بدون اتصال دائمی اینترنت کار کند. بااینحال، نصب اولیهٔ هستهٔ برد، ابزارهای کامپایل، کتابخانهها و بهروزرسانیها ممکن است به اینترنت نیاز داشته باشد.
برای یک کلاس یا آزمایشگاه، روش قابلاعتماد این است که مسئول فنی روی رایانهای با اتصال مجاز، همان نسخهٔ IDE، هستهٔ دقیق برد و نسخههای موردنیاز کتابخانهها را از منابع رسمی آماده کند. سپس فایلها با روش انتقال مورد تأیید سازمان به رایانهٔ آفلاین منتقل شوند و روی همان سیستم آزمایش شوند.
- نسخهٔ IDE و هستهٔ برد باید با یکدیگر سازگار باشند.
- ابزارهای کامپایل و وابستگیهای کتابخانه را نیز در نظر بگیرید.
- مسیر پوشههای sketchbook و Arduino15 در سیستمعاملهای مختلف یکسان نیست.
- انتقال یک پوشه بهتنهایی همیشه به معنی نصب کامل نیست.
- اصالت فایلها و بهروزرسانی امنیتی آنها را قبل از انتقال بررسی کنید.
راهنمای Arduino دربارهٔ دامنههای لازم برای مدارس و شبکههای آموزشی میتواند نقطهٔ شروع مناسبی برای هماهنگی با مدیر شبکه باشد.
گام ششم: اگر برد شناسایی نمیشود، USB را جداگانه بررسی کنید
اگر IDE باز میشود و کد کامپایل میشود اما برد در فهرست پورتها دیده نمیشود، ابتدا مشکل ارتباط سختافزاری را بررسی کنید:
- از کابل USB دارای قابلیت انتقال داده استفاده کنید؛ بعضی کابلها فقط برای شارژ هستند.
- پورت USB دیگری را امتحان کنید و در صورت امکان برد را مستقیماً به رایانه وصل کنید.
- در IDE، مدل برد و پورت درست را انتخاب کنید.
- درایور معتبر برد یا مبدل USB-to-Serial را از منبع رسمی سازنده نصب کنید.
- برد را روی یک رایانهٔ دیگر آزمایش کنید تا مشکل بین برد، کابل و رایانه تفکیک شود.
سناریوی عملی: نصب Arduino Uno در شبکهٔ محدود
فرض کنید Arduino IDE نصب شده است، اما در Boards Manager هستهٔ Arduino AVR نصب نمیشود. ابتدا صفحهٔ رسمی Arduino را در همان شبکه آزمایش کنید و ساعت سیستم را بررسی کنید. اگر وبسایت باز میشود اما دریافت بسته شکست میخورد، احتمالاً دسترسی برنامه به سرور دانلود یا تنظیمات پروکسی محدود شده است. در این حالت، از مسئول شبکه بخواهید دسترسی رسمی موردنیاز را بررسی کند. اگر دسترسی مستقیم امکانپذیر نیست، هسته و وابستگیهای آن را روی رایانهای با اتصال مجاز و با رعایت سیاست سازمان آماده کنید. سپس در رایانهٔ آفلاین، مثال Blink را کامپایل و روی Arduino Uno بارگذاری کنید. اگر کامپایل انجام شد ولی برد دیده نشد، مسئله دیگر شبکه نیست و باید کابل، درایور و پورت بررسی شود.
گام نهایی: آزمون صحت نصب
- Arduino IDE بدون خطا اجرا شود.
- هستهٔ برد در Boards Manager نصب و قابل مشاهده باشد.
- کتابخانهٔ موردنیاز در Library Manager نصب شود.
- مثال Blink بدون خطای کامپایل ساخته شود.
- برد و پورت درست شناسایی شوند.
- برنامه روی برد بارگذاری و خروجی آن مشاهده شود.
تفاوت مشکل نرمافزار، شبکه و سختافزار
برای جلوگیری از آزمونوخطای بینتیجه، سه لایه را جداگانه بررسی کنید. اگر وبسایت رسمی یا downloads.arduino.cc باز نمیشود، مسئله در لایهٔ شبکه یا سیاست دسترسی قرار دارد. اگر IDE باز نمیشود یا در اجرای نخست متوقف میماند، باید نصب اجزای ضروری، گزارش خطا و سازگاری سیستمعامل بررسی شود. اگر IDE کامپایل میکند اما برد دیده نمیشود، موضوع معمولاً به اتصال USB، درایور، بوتلودر، انتخاب برد یا پورت مربوط است.
| نشانه | محتملترین لایهٔ مشکل | آزمایش پیشنهادی |
|---|---|---|
| صفحهٔ دانلود باز نمیشود | شبکه، DNS یا سیاست دسترسی | آزمایش با شبکهٔ مجاز دیگر و بررسی دسترسی مدیر شبکه |
| Boards Manager خطا میدهد | اتصال IDE به مخزن بستهها | بررسی فایروال، پروکسی و دامنهٔ رسمی دانلود |
| IDE در شروع متوقف میشود | اجزای اولیه یا نصب ناقص | بستن همهٔ پنجرهها، اجرای دوباره و بررسی گزارش خطا |
| برد در Port دیده نمیشود | USB، درایور یا برد | کابل داده، پورت مستقیم، Device Manager و برد دیگر |
| کامپایل موفق اما Upload ناموفق | برد انتخابشده، پورت یا بوتلودر | انتخاب مدل صحیح، پورت صحیح و بررسی پیام خطا |
گام هفتم: تفسیر خطاهای رایج
- دارایی یا بسته دانلود نشد: اتصال، فایروال، پروکسی یا دسترسی به مخزن را بررسی کنید؛ چند بار نصبکردن بدون رفع علت معمولاً نتیجهای ندارد.
- Board not found: نصببودن هسته به معنی شناسایی فیزیکی برد نیست. مدل برد، کابل، پورت و درایور را جداگانه بررسی کنید.
- Port خاکستری یا ناپدید است: برد را جدا و وصل کنید، فهرست پورت را دوباره باز کنید و در ویندوز Device Manager را بررسی کنید.
- کتابخانه پیدا نمیشود: نام دقیق کتابخانه، نسخهٔ آن و مسیر Sketchbook را بررسی کنید. نصب یک نسخهٔ دستی در پوشهٔ libraries میتواند نسخهٔ قبلی را تحتتأثیر قرار دهد.
- کد کامپایل نمیشود: پیام خطا را از نخستین خطای واقعی بخوانید؛ خطاهای بعدی گاهی پیامد همان خطای اول هستند.
گام هشتم: ایمنی، اصالت فایل و حریم شبکه
فایل نصب، هستهٔ برد و کتابخانهها را از منبع رسمی یا مخزن معتبر سازنده دریافت کنید. آنتیویروس و فایروال را برای دورزدن خطا بهطور کامل غیرفعال نکنید. اگر شبکهٔ سازمانی است، تغییر تنظیمات دسترسی باید با مسئول شبکه هماهنگ شود. اطلاعات ورود پروکسی را در اختیار افراد یا ابزارهای ناشناس قرار ندهید و از اجرای اسکریپتهایی که منشأ آنها مشخص نیست خودداری کنید.
هنگام انتقال بستهها به رایانهٔ آفلاین، نسخه، معماری سیستم، وابستگیها و منبع هر فایل را ثبت کنید. یک پوشهٔ ساده و قابلردیابی برای پروژه ایجاد کنید و قبل از استفاده در کلاس یا آزمایشگاه، کامپایل و بارگذاری را روی یک برد آزمایشی انجام دهید.
چکلیست سریع عیبیابی
- نام دقیق خطا و مرحلهٔ وقوع آن را ثبت کنید.
- نسخهٔ Arduino IDE و سیستمعامل را یادداشت کنید.
- صفحهٔ رسمی Arduino و دامنهٔ دانلود را آزمایش کنید.
- تاریخ، ساعت، فایروال و پروکسی را بررسی کنید.
- هستهٔ برد را از Boards Manager نصب کنید.
- کتابخانه را از Library Manager یا فایل ZIP رسمی نصب کنید.
- برای شناسایی برد، کابل داده و پورت مستقیم را آزمایش کنید.
- یک پروژهٔ سادهٔ Blink را کامپایل و بارگذاری کنید.
- پیام خطای کامل را نگه دارید؛ فقط آخرین خط را کپی نکنید.
جمعبندی
بازنشدن وبسایت، شکست دانلود، خطای Boards Manager و شناسایینشدن برد، علتهای متفاوتی دارند و نباید همهٔ آنها را با عنوان «فیلتر شدن آردوینو» یکی دانست. تشخیص مرحلهٔ دقیق خطا، استفاده از منابع رسمی، بررسی زمان سیستم و پروکسی، هماهنگی با مسئول شبکه و آزمایش جداگانهٔ کابل و درایور، معمولاً سریعترین مسیر برای حل مسئله است. Arduino IDE پس از آمادهسازی صحیح اجزا میتواند برای بسیاری از پروژهها بهصورت آفلاین نیز استفاده شود.
سؤالات متداول دربارهٔ فیلتر شدن و کار آفلاین آردوینو
آیا خود Arduino IDE بدون اینترنت کار میکند؟
پس از نصب اجزای ضروری، IDE دسکتاپ برای ویرایش، کامپایل و بارگذاری بسیاری از اسکچها به اتصال دائمی اینترنت نیاز ندارد. قابلیتهایی مانند Library Manager، دریافت هستهٔ جدید و برخی سرویسهای آنلاین در حالت آفلاین در دسترس نخواهند بود.
برای دانلود کتابخانهها و هستههای برد کدام دامنه باید بررسی شود؟
طبق راهنمای رسمی Arduino، شبکهای که دریافت کتابخانه و هسته را مسدود میکند باید دسترسی به downloads.arduino.cc را با هماهنگی مدیر شبکه بررسی کند. دامنهها و الزامات Arduino Cloud ممکن است متفاوت باشند.
چرا Arduino IDE باز میشود اما Boards Manager کار نمیکند؟
بازشدن برنامه فقط نشان میدهد فایل اجرایی اجرا شده است؛ Boards Manager برای جستوجو و دریافت بستهها به ارتباط شبکه و دسترسی به مخزن نیاز دارد. فایروال، پروکسی، گواهی HTTPS یا محدودیت شبکه را بررسی کنید.
آیا کابل شارژ میتواند باعث دیدهنشدن برد شود؟
بله. بعضی کابلهای USB فقط برق منتقل میکنند و مسیر داده ندارند. از کابل دادهٔ سالم، پورت مستقیم رایانه و در صورت امکان کابل دیگری استفاده کنید.
چرا با وجود نصب هسته، پورت برد نمایش داده نمیشود؟
هستهٔ برد برای کامپایل و شناسایی نرمافزاری لازم است، اما نمایش پورت به ارتباط USB، درایور، شناسهٔ برد و گاهی بوتلودر وابسته است. اتصال فیزیکی و Device Manager یا ابزار مشابه سیستمعامل را بررسی کنید.
آیا میتوان فایل ZIP کتابخانه را دستی نصب کرد؟
بله، Arduino نصب کتابخانه از فایل ZIP را پشتیبانی میکند. فایل باید ساختار درست داشته باشد و پس از نصب، IDE را در صورت نیاز دوباره اجرا کنید. نصب دستی یک نسخه ممکن است نسخهٔ قبلی همان کتابخانه را تحتتأثیر قرار دهد.
آیا خاموشکردن آنتیویروس راهحل مناسبی است؟
خیر. ابتدا پیام مسدودشدن و گزارش امنیتی را بررسی کنید و فقط اجازهٔ محدود و مشخص برای نرمافزار رسمی بدهید. خاموشکردن کامل ابزار امنیتی علت مشکل را اثبات نمیکند و خطر دریافت فایل مخرب را افزایش میدهد.
منابع و مراجع
- Arduino Documentation: Software tools
- Arduino Help Center: Download and install Arduino IDE
- Arduino Documentation: Downloading and installing Arduino IDE 2
- Arduino Help Center: If Arduino IDE hangs on start-up
- Arduino Help Center: Add boards to Arduino IDE
- Arduino Help Center: Install libraries in the Arduino IDE
- Arduino Help Center: If your board is not detected by Arduino IDE
- Arduino Help Center: URLs required for schools and restricted networks

