Failed uploading: no upload port provided? Как исправить ошибку загрузки Arduino

Код не загружается в Arduino, а в окне вывода красная ошибка avrdude? Не переживай: почти ни одна из этих проблем не означает, что плата сломана. Причины обычно такие: USB-кабель только для зарядки, не установлен драйвер CH340, выбрана не та плата или не тот порт, модуль подключён к пинам 0 и 1 или порт занят другой программой. Если проверять всё в правильном порядке, обычно проблема решается за несколько минут; а если плата действительно неисправна, это можно просто доказать.

В этом руководстве сначала разберём, что происходит за кулисами во время загрузки и как читать сообщение об ошибке. Затем шаг за шагом сузим круг поиска с помощью диагностической таблицы «симптом — причина — решение». Также поговорим о настройке ATmega328P (Old Bootloader) на Arduino Nano, о мониторе порта и других программах, которые занимают порт, об ошибке ESP32 Failed to connect и кнопке BOOT, а ещё о способе с BOOTSEL и UF2 на Raspberry Pi Pico. В каждом разделе есть короткий тестовый скетч, чтобы проверить плату, когда проблема решена.

Как устроена загрузка: ошибка компиляции или ошибка загрузки?

Когда нажимаешь «Загрузка» (Upload), происходят две отдельные вещи. Сначала IDE компилирует код; если это удалось, в окне вывода появляется строка о том, сколько байт занимает скетч (Sketch uses 924 bytes). Затем программа avrdude открывает выбранный порт, перезапускает плату сигналом DTR и устанавливает связь с маленькой программой-загрузчиком внутри платы — загрузчиком (bootloader). После сброса загрузчик слушает всего около секунды; если данные не пришли, на плате продолжает работать старая программа. Сообщение об ошибке показывает, какое звено этой цепочки порвалось. Если красный текст появляется во время компиляции, проблема в коде, и плата с кабелем тут ни при чём.

Самые частые ошибки avrdude и что они значат

Пошаговая диагностическая таблица: симптом, причина, решение

Читай таблицу сверху вниз: первые строки — самые частые и самые простые в решении проблемы. После каждого изменения пробуй загрузить код снова. Если менять сразу несколько вещей, так и не станет понятно, что именно помогло, и в следующий раз та же ошибка снова застанет врасплох.

Быстрый чек-лист и тестовый скетч для загрузки

1. Сними с платы всё: шилды, модули и провода на пинах 0 и 1. Оставь подключённым только USB-кабель.
2. Подключи плату прямо к USB-порту на задней панели компьютера; избегай хабов, удлинителей и разъёмов на передней панели.
3. Открой «Инструменты › Порт» и посмотри на список. Отключи и снова подключи плату и запомни, какой порт пропадает и появляется снова. Если список не меняется, проблема в кабеле или драйвере.
4. Выбери точную модель платы в «Инструменты › Плата»; на Nano ещё выбери правильный загрузчик в «Инструменты › Процессор».
5. Убедись, что порт не занят другой программой или вторым окном IDE; если сомневаешься, закрой их все.
6. Включи подробный вывод при загрузке и загрузи маленький тестовый скетч ниже. Проверка на коде, в котором точно нет ошибок, исключает проблемы компиляции.
7. Всё ещё не получается? Нажми кнопку сброса: если светодиод L быстро мигнёт один или несколько раз, загрузчик жив. Тогда переходи к тесту «петли» ниже.
8. Попробуй другой компьютер или другую плату. Если проблема переходит вместе с платой, дело в плате; если остаётся с компьютером — в драйвере или настройках операционной системы.

1// Yükleme testi: LED yanıp söner, sayaç yazılır / Upload test: blinks the LED, prints a counter
2unsigned long sayac = 0;   // çalışma sayacı / run counter
3
4void setup() {
5  pinMode(LED_BUILTIN, OUTPUT);   // Uno ve Nano'da pin 13 / pin 13 on Uno and Nano
6  Serial.begin(9600);
7  Serial.println("Yukleme basarili / Upload OK");
8}
9
10void loop() {
11  digitalWrite(LED_BUILTIN, HIGH);
12  delay(200);                     // yanma süresi: değiştirip tekrar yükle / on time: change it and re-upload
13  digitalWrite(LED_BUILTIN, LOW);
14  delay(800);
15  Serial.println(sayac++);        // Seri Monitör 9600 baud / Serial Monitor at 9600 baud
16}

Если загрузка прошла, светодиод L коротко мигает и дольше остаётся выключенным, а в мониторе порта на 9600 бод растёт счётчик. Чтобы убедиться, что новый код действительно попал в плату, замени delay(200) на delay(50) и загрузи снова: если ритм мигания не изменился, работает ещё старая программа. Если в мониторе порта видны кракозябры, скорость в мониторе порта не совпадает с кодом; это не ошибка загрузки.

COM-порт не появляется: USB-кабель и драйверы CH340, CP2102

Если меню портов серое или пустое, первым под подозрением оказывается кабель. Во многих тонких кабелях из комплекта зарядок есть только два провода питания, а провода данных D+ и D- отсутствуют совсем. С таким кабелем светодиод питания на плате загорается, что сбивает с толку, но компьютер не видит устройства и даже не издаёт звук подключения. Проверь кабель, передав по нему файлы на телефон, или с другой платой, про которую точно известно, что она рабочая. У толстого кабеля типа B для Uno такой проблемы почти не бывает; она очень часта с mini USB у Nano и с кабелями micro USB или USB-C у плат ESP32 и Pico.

Если кабель в порядке, второй подозреваемый — драйвер. Прочитай надпись на микросхеме рядом с USB-разъёмом: на оригинальных Arduino Uno и Mega стоит ATmega16U2, на клонах Uno и Nano — чаще всего CH340G или CH340C, а на отладочных платах ESP32 обычно CP2102 или CH340. В Windows открой «Диспетчер устройств»: если плата распознана, она появится в разделе «Порты (COM и LPT)» (Ports (COM & LPT)). Если в разделе «Другие устройства» (Other devices) видно USB2.0-Serial с жёлтым восклицательным знаком, не хватает драйвера CH340.

Windows 10 и 11 обычно сами ставят драйверы CH340 и CP2102 через Центр обновления Windows. Если этого не произошло, скачай с сайта производителя микросхемы драйвер CH341SER для CH340 или CP210x VCP для CP2102, установи его, затем отключи и снова подключи плату. В актуальных версиях macOS драйверы для обеих микросхем уже есть; если наставить поверх старые драйверы из разных источников, обычно становится только хуже. В Linux драйверы уже в ядре, но чтобы пользоваться портом, нужно добавить своего пользователя в группу dialout (sudo usermod -a -G dialout $USER) и заново войти в систему; иначе будет ошибка Permission denied. Если на Ubuntu 22.04 и новее порт пропадает сразу после подключения платы на CH340, виноват обычно пакет экранного чтеца brltty; если он не нужен, удали его командой sudo apt remove brltty.

Выбраны не та плата, процессор или порт

В Arduino IDE 2 плата и порт выбираются в выпадающем списке на верхней панели или в меню «Инструменты › Плата» и «Инструменты › Порт». В Windows в списке могут быть COM1 или несколько виртуальных портов Bluetooth; проще всего найти нужный, отключив плату и посмотрев, какой порт пропал. Если в меню плат выбрана не та модель, например Mega вместо Uno или Leonardo вместо Nano, avrdude либо вообще не получает ответа, либо видит неожиданный идентификатор микросхемы в строке Device signature. И ещё: для обычной загрузки используй Ctrl+U. «Скетч › Загрузить через программатор» (Sketch › Upload Using Programmer) рассчитан на внешний ISP-программатор и, если загрузка удалась, стирает загрузчик на плате; после этого плата больше не принимает загрузку по USB.

Arduino Nano не загружается: ATmega328P (Old Bootloader)

Большинство недорогих Nano в продаже — клоны на CH340, и многие из них до сих пор несут старый загрузчик. В начале 2018 года Arduino заменила загрузчик Nano на более компактный и быстрый Optiboot, как у Uno, и с тех пор вариант ATmega328P по умолчанию в IDE работает на скорости 115200 бод. Старый загрузчик ждёт 57600 бод. Когда скорости не совпадают, кажется, что плата вообще не отвечает, а ошибка not in sync: resp=0x00 повторяется десять попыток подряд. Решение — одна настройка в меню: «Инструменты › Процессор › ATmega328P (Old Bootloader)». Если неясно, какой вариант правильный, пробуй варианты по очереди; неправильный выбор плате ничем не вредит.

Модули на пинах 0 и 1 мешают загрузке

На Uno и Nano микросхема USB-UART соединена с ATmega328P через резисторы 1 kΩ на пинах D0 (RX) и D1 (TX). Во время загрузки эта линия принадлежит компьютеру. Если к этим пинам подключён модуль с последовательным интерфейсом, например Bluetooth-модуль HC-05, GPS, ESP-01 или сканер отпечатков пальцев, он либо отправляет на линию свои данные, либо держит её на постоянном уровне и срывает рукопожатие загрузчика. Результат — снова programmer is not responding или not in sync. Быстрое решение — отключать провода D0 и D1 на время загрузки; постоянное — перенести модуль на другие пины с SoftwareSerial:

1#include <SoftwareSerial.h>
2
3// HC-05 TX -> D10, HC-05 RX <- D11 (gerilim bölücüyle / through a voltage divider)
4SoftwareSerial bt(10, 11);   // RX, TX pinleri / RX, TX pins
5
6void setup() {
7  Serial.begin(9600);        // USB: Seri Monitör / USB: Serial Monitor
8  bt.begin(9600);            // HC-05 veri modu hızı / HC-05 data mode baud rate
9  Serial.println("Hazir / Ready");
10}
11
12void loop() {
13  if (bt.available()) Serial.write(bt.read());      // telefondan bilgisayara / phone to PC
14  if (Serial.available()) bt.write(Serial.read());  // bilgisayardan telefona / PC to phone
15}

В этом скетче TX модуля HC-05 подключён к D10, а RX — к D11. Вход RX у HC-05 работает на 3,3 V, поэтому между ним и D11 поставь делитель напряжения из резисторов 1 kΩ и 2 kΩ. Теперь можно загружать код с подключённым модулем и отправлять на телефон всё, что набираешь в мониторе порта. Полное подключение и режим AT-команд описаны в руководстве Bluetooth-модуль HC-05. На Mega SoftwareSerial не нужен: у платы есть дополнительные аппаратные последовательные порты, например Serial1 (TX1 = D18, RX1 = D19).

Монитор порта и программы, которые занимают порт

Последовательный порт одновременно может открыть только одна программа. Поэтому Windows показывает Access is denied, а macOS и Linux — Resource busy. Arduino IDE обычно приостанавливает свой монитор порта на время загрузки, но не во всех версиях и не со всеми платами это работает идеально, особенно с ESP32; если появилась ошибка, сначала закрой вкладку монитора порта. Чаще порт занят чем-то другим: вторым окном IDE, открытым плоттером, PuTTY, программой для 3D-принтера вроде Cura, монитором PlatformIO в VS Code или скриптом на Python, работающим в фоне. Закрой их, переподключи плату и попробуй снова. В Linux увидеть, какая программа держит порт, можно командой sudo lsof /dev/ttyUSB0.

Плата сломана? Тест «петли» и запись загрузчика

Если всё перечисленное выше уже испробовано, а код всё равно не загружается, нужно выяснить, где проблема — на стороне USB или в основном процессоре. Классический способ для Uno и Nano — тест «петли» (loopback): основной процессор удерживается в сбросе, а микросхема USB-UART разговаривает сама с собой. Загружать код для этого теста не нужно.

1. Сними с платы все провода, оставь подключённым только USB-кабель.
2. Перемычкой соедини пин RESET с GND; так ATmega328P остаётся в сбросе и не мешает на линии.
3. Вторым проводом соедини между собой пины D0 и D1.
4. Выбери порт платы в IDE и открой монитор порта; скорость для этого теста не важна.
5. Набери в поле несколько символов и отправь. Если текст сразу вернулся, кабель, драйвер и микросхема USB-UART в порядке, а проблема в основном процессоре или загрузчике. Если ничего не вернулось, проблема на стороне USB.
6. Не забудь снять оба провода после теста.

Если тест «петли» пройден, но загрузка всё равно не работает, а светодиод L не мигает коротко при нажатии на сброс, возможно, загрузчик стёрт или микросхему заменили. Загрузчик можно записать заново с помощью второй Uno. Загрузи «Файл › Примеры › 11.ArduinoISP › ArduinoISP» в ту Uno, которая будет программатором. Затем соедини D10 программатора с пином RESET целевой платы, D11, D12 и D13 — с одноимёнными пинами целевой платы, а 5V и GND — между собой. Поставь конденсатор 10 µF между RESET и GND на Uno-программаторе; так она не будет сбрасывать сама себя. Наконец выбери «Инструменты › Программатор › Arduino as ISP», укажи целевую плату в меню плат и запусти «Инструменты › Записать загрузчик» (Burn Bootloader). Этим же способом можно поставить на клон Nano новый Optiboot.

ESP32 не загружается: Failed to connect и кнопка BOOT

На ESP32 загрузкой занимается esptool, а не avrdude. Сначала в выводе появляется строка Connecting........_____....., пока esptool пытается перевести плату в режим загрузки. Если не получилось, появится ошибка, начинающаяся с A fatal error occurred: Failed to connect to ESP32. В актуальных версиях esptool, если плата загрузилась в обычном режиме, сообщение продолжается строкой Wrong boot mode detected (0x13)! The chip needs to be in download mode (чип должен быть в режиме загрузки); 0x13 означает, что плата стартовала в обычном режиме, а не в режиме загрузки. Если плата не отвечает совсем, сообщение заканчивается на No serial data received; старые версии пишут в этом случае Timed out waiting for packet header. Если плата не может сама перейти в режим загрузки, это делается вручную.

1. Нажми «Загрузка» в IDE и следи за окном вывода.
2. Как только появится Connecting..., нажми и удерживай кнопку BOOT на плате.
3. Если связь всё равно не устанавливается, удерживая BOOT, коротко нажми и отпусти EN.
4. Отпусти BOOT, когда в выводе побегут строки, начинающиеся с Writing at, и проценты загрузки.
5. Загрузка заканчивается строкой Hard resetting via RTS pin.... Если программа не запустилась, один раз нажми EN.

Почему так происходит? Чтобы войти в режим загрузки, пин GPIO0 у ESP32 должен быть в LOW в момент старта. Схема автосброса на двух транзисторах на отладочных платах делает это автоматически сигналами DTR и RTS от USB-микросхемы; на дешёвых платах схема может не попасть в нужный момент. Если надоело каждый раз жать BOOT, есть постоянное решение: подключи электролитический конденсатор 10 µF между пином EN и GND (минусом к GND). Конденсатор замедляет нарастание напряжения на линии EN и даёт схеме автосброса время удержать GPIO0 в LOW.

1// ESP32 yükleme testi / ESP32 upload test
2const int LED_PIN = 2;   // birçok DevKit kartında dahili LED / onboard LED on many DevKit boards
3
4void setup() {
5  pinMode(LED_PIN, OUTPUT);
6  Serial.begin(115200);   // Seri Monitör 115200 baud / Serial Monitor at 115200 baud
7  delay(500);
8  Serial.print("Model: ");
9  Serial.println(ESP.getChipModel());                 // ör. ESP32-D0WD-V3 / e.g. ESP32-D0WD-V3
10  Serial.print("Flash (MB): ");
11  Serial.println(ESP.getFlashChipSize() / (1024 * 1024));
12  Serial.print("CPU (MHz): ");
13  Serial.println(getCpuFrequencyMhz());
14}
15
16void loop() {
17  digitalWrite(LED_PIN, !digitalRead(LED_PIN));   // LED'i tersle / toggle the LED
18  delay(500);
19}

Raspberry Pi Pico: загрузка через BOOTSEL и UF2

У Pico нет отдельной микросхемы USB-UART: у RP2040 свой USB-контроллер, а загрузчик живёт в ПЗУ микросхемы, которое нельзя стереть. Поэтому программно «окирпичить» Pico почти невозможно. Если удерживать кнопку BOOTSEL при подключении USB-кабеля, Pico появляется на компьютере как флешка с именем RPI-RP2 (у Pico 2 диск называется RP2350). Любой файл .uf2, перетащенный на этот диск, записывается в плату, и она сама перезапускается; так же устанавливается и MicroPython.

Если программировать Pico в Arduino IDE, при первой загрузке COM-порта ещё нет; подключи плату с зажатой BOOTSEL и нажми «Загрузка». После первого скетча плата открывает последовательный порт, и для следующих загрузок BOOTSEL уже не нужна. Если код зависает или отключает USB, порт снова пропадает и появляется ошибка No drive to deploy; тогда вернись к способу с BOOTSEL. Если пользуешься MicroPython, в правом нижнем углу Thonny интерпретатором должен быть выбран MicroPython (Raspberry Pi Pico). Про пины и настройку Pico читай в руководстве Что такое Raspberry Pi Pico?

1import time
2from machine import Pin
3
4time.sleep(3)   # açılışta 3 sn bekle, Thonny durdurabilsin / wait 3 s so Thonny can stop the script
5
6led = Pin("LED", Pin.OUT)   # Pico ve Pico W dahili LED / onboard LED on Pico and Pico W
7sayac = 0
8while True:
9    led.toggle()
10    print("Calisiyor / running", sayac)
11    sayac += 1
12    time.sleep(0.5)

Мелкие, но коварные причины, которые легко упустить

• Leonardo, Micro и Uno R4: на этих платах со встроенным USB порт во время загрузки может ненадолго смениться. Если загрузка зависает, нажми «Загрузка» и один раз нажми кнопку сброса, как только закончится компиляция и начнётся этап загрузки (на Uno R4 — дважды быстро); плата какое-то время ждёт в загрузчике, и код загрузится.
• Сломан автосброс: если на Uno или Nano не работает автосброс, удерживай кнопку сброса, нажми «Загрузка» и отпусти кнопку, как только в выводе появится строка с размером скетча.
• Шилды и внешние схемы: шилд с драйвером мотора или схема, нагружающая линию 5V, могут вызвать просадку напряжения во время загрузки и оборвать запись на середине.
• Не тот порт в macOS: /dev/cu.Bluetooth-Incoming-Port и /dev/cu.debug-console в списке портов — это не твоя плата, а системные порты. В имени порта платы есть usbmodem, usbserial или wchusbserial; если есть сомнения, переподключи плату и посмотри, какой порт пропадёт.
• Не-ASCII символы в имени пользователя: если в имени папки пользователя Windows есть кириллица или буквы с диакритикой, инструменты компиляции и загрузки некоторых пакетов плат, особенно пакета ESP32, могут не находить файлы. Перенеси папку скетчей в «Настройках» на путь без таких символов; если проблема осталась, создай нового пользователя Windows.
• Скетч слишком большой: предупреждение Sketch too big — не ошибка загрузки; оно значит, что код не помещается в примерно 31,5 КБ flash-памяти, которые остаются у Uno после загрузчика. Сократи библиотеки и длинные строки или перейди на более мощную плату.
• Порт завис после сна: после выхода компьютера из спящего режима порт может зависнуть; обычно помогает перезапуск IDE или подключение платы к другому USB-порту.

Загрузка работает: что дальше?

• Первая схема: собери свою схему Blink со светодиодом и резистором, а потом добавь кнопку для первого интерактивного проекта.
• Последовательная связь: теперь, когда понятно, как пины 0 и 1 влияют на загрузку, попробуй включать светодиод с телефона через Bluetooth-модуль HC-05.
• Чтение датчиков: с помощью руководства по датчикам Arduino выбери первые проекты, которые измеряют температуру, расстояние и свет.
• Без проводов: собери на ESP32 проект, который подключается к Wi-Fi и управляется с телефона; благодаря OTA потом можно будет загружать код и по воздуху.
• Выбор подходящей платы: если не можешь выбрать между Uno, Nano и Mega, прочитай статью Какую Arduino купить?.

Ошибки загрузки раздражают при первой встрече, но у каждой есть логичная причина, и почти все находятся в одном и том же порядке: кабель, драйвер, порт, настройки платы, последовательная линия и, наконец, загрузчик. Держи этот порядок в голове — и следующую ошибку решишь за минуты. Когда плата начнёт принимать код, в приложении BlueGrays тебя ждёт множество проектов для Arduino, ESP32 и Raspberry Pi Pico — от мигания светодиодом до Wi-Fi и беспроводного обновления по OTA, каждый с пошаговой схемой подключения и готовым кодом, так что плату можно сразу пустить в дело.