Failed Uploading: No Upload Port Provided? Cara Mengatasi Kode Arduino yang Gagal Di-upload

Kode Arduino tidak mau ter-upload dan muncul error avrdude berwarna merah di jendela output? Tenang: hampir tidak ada masalah seperti ini yang berarti board-mu rusak. Penyebabnya adalah kabel USB yang hanya untuk mengecas, driver CH340 yang belum terinstal, board atau port yang salah, modul yang terhubung ke pin 0 dan 1, atau program lain yang sedang memakai port. Periksa semuanya dengan urutan yang benar dan biasanya masalahnya beres dalam beberapa menit; bahkan kalau board-nya memang rusak, ada cara sederhana untuk membuktikannya.

Di panduan ini kamu akan melihat dulu apa yang terjadi di balik layar ketika upload dan cara membaca pesan error-nya. Setelah itu kita persempit masalahnya langkah demi langkah dengan tabel diagnosis berisi gejala, penyebab, dan solusi. Kami juga membahas pengaturan ATmega328P (Old Bootloader) di Arduino Nano, Serial Monitor dan program lain yang mengunci port, error Failed to connect di ESP32 dan tombol BOOT, serta metode BOOTSEL dan UF2 di Raspberry Pi Pico. Setiap bagian dilengkapi sketch uji singkat supaya kamu bisa mengecek board-mu setelah masalahnya selesai.

Cara kerja upload: error kompilasi atau error upload?

Ketika kamu menekan Upload, ada dua hal terpisah yang terjadi. Pertama, IDE mengompilasi kodemu; kalau berhasil, jendela output menampilkan baris yang memberi tahu berapa byte yang dipakai sketch (Sketch uses 924 bytes). Lalu program bernama avrdude membuka port yang kamu pilih, me-restart board dengan sinyal DTR, dan berjabat tangan dengan program pemuat kecil di dalam board, yaitu bootloader. Setelah reset, bootloader hanya mendengarkan selama kira-kira satu detik; kalau tidak ada data yang datang, program lama di board terus berjalan. Pesan error memberi tahu mata rantai mana yang putus. Kalau tulisan merah muncul ketika kompilasi, masalahnya ada di kodemu dan tidak ada hubungannya dengan board atau kabel.

Error avrdude yang paling umum dan artinya

Tabel diagnosis langkah demi langkah: gejala, penyebab, solusi

Baca tabel dari atas ke bawah; baris-baris pertama adalah masalah yang paling umum dan paling mudah diatasi. Coba upload lagi setelah setiap perubahan. Kalau kamu mengubah beberapa hal sekaligus, kamu tidak akan pernah tahu mana yang menyelesaikannya, dan error yang sama akan menjebakmu lagi lain kali.

Daftar periksa cepat dan sketch uji upload

1. Lepas semuanya dari board: shield, modul, dan kabel di pin 0 dan 1. Sisakan hanya kabel USB yang terhubung.
2. Colokkan board langsung ke port USB di bagian belakang komputer; hindari hub, kabel perpanjangan, dan soket di panel depan.
3. Buka Tools > Port dan lihat daftarnya. Cabut lalu colokkan lagi board-nya dan catat port mana yang hilang lalu muncul kembali. Kalau daftarnya tidak pernah berubah, masalahnya ada di kabel atau driver.
4. Pilih model board-mu yang tepat di Tools > Board; untuk Nano, pilih juga bootloader yang benar di Tools > Processor.
5. Pastikan tidak ada program lain atau jendela IDE kedua yang memakai port; kalau ragu, tutup semuanya.
6. Aktifkan verbose output untuk upload lalu upload sketch uji kecil di bawah ini. Menguji dengan kode yang kamu tahu bebas error menyingkirkan kemungkinan masalah kompilasi.
7. Masih gagal? Tekan tombol reset: kalau LED L berkedip cepat sekali atau beberapa kali, bootloader-nya masih hidup. Setelah itu lanjut ke loopback test di bawah.
8. Coba komputer lain atau board lain. Kalau masalahnya ikut board, berarti ada di board; kalau tetap di komputer, berarti ada di driver atau pengaturan sistem operasi.

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}

Kalau upload berhasil, LED L berkedip sebentar lalu mati lebih lama, dan penghitungnya naik ketika kamu membuka Serial Monitor di 9600 baud. Untuk memastikan kode baru benar-benar sampai ke board, ubah delay(200) menjadi delay(50) lalu upload lagi: kalau ritme kedipannya tidak berubah, program lama masih berjalan. Kalau kamu melihat karakter acak di Serial Monitor, pengaturan baud rate Serial Monitor tidak cocok dengan kodenya; itu bukan error upload.

Port COM tidak muncul: kabel USB dan driver CH340, CP2102

Kalau menu port abu-abu atau kosong, kabel adalah tersangka pertama. Banyak kabel tipis bawaan charger ponsel hanya punya dua kabel daya; kabel data D+ dan D- sama sekali tidak ada. Dengan kabel seperti itu, LED power board tetap menyala, yang bisa menyesatkan, tetapi komputer tidak melihat perangkat apa pun dan bahkan tidak memutar suara koneksi. Uji kabelmu dengan mentransfer file ke ponsel atau dengan board lain yang kamu tahu berfungsi. Kabel tipe B yang tebal milik Uno jarang bermasalah seperti ini; masalah ini sangat umum di kabel mini USB Nano serta kabel micro USB atau USB-C board ESP32 dan Pico.

Kalau kabelnya baik, driver adalah tersangka kedua. Baca tulisan di chip sebelah soket USB: board Arduino Uno dan Mega original memakai ATmega16U2, board Uno dan Nano klon kebanyakan memakai CH340G atau CH340C, dan board pengembangan ESP32 biasanya memakai CP2102 atau CH340. Di Windows, buka Device Manager: kalau board dikenali, board akan muncul di bawah Ports (COM & LPT). Kalau kamu melihat USB2.0-Serial dengan tanda seru kuning di bawah Other devices, driver CH340 belum terinstal.

Windows 10 dan 11 biasanya menginstal driver CH340 dan CP2102 sendiri lewat Windows Update. Kalau tidak, unduh driver CH341SER untuk CH340 atau driver CP210x VCP untuk CP2102 dari situs pembuat chip-nya, instal, lalu cabut dan colokkan lagi board-nya. Versi macOS terbaru sudah menyertakan driver untuk kedua chip; menumpuk driver lama dari berbagai sumber biasanya malah memperburuk keadaan. Di Linux, driver-nya sudah ada di kernel, tetapi untuk memakai port kamu harus menambahkan user-mu ke grup dialout (sudo usermod -a -G dialout $USER) lalu log out dan masuk lagi; kalau tidak, kamu akan mendapat error Permission denied. Kalau port langsung hilang setelah board CH340 dicolokkan di Ubuntu 22.04 atau yang lebih baru, biang keladinya biasanya paket pembaca layar brltty; kalau kamu tidak memakainya, hapus dengan sudo apt remove brltty.

Board, processor, atau port yang dipilih salah

Di Arduino IDE 2, board dan port dipilih dari drop-down di bilah atas atau dari menu Tools > Board dan Tools > Port. Di Windows kamu mungkin melihat COM1 atau beberapa port Bluetooth virtual di daftar; cara termudah menemukan yang benar adalah mencabut board dan melihat port mana yang hilang. Kalau model yang salah dipilih di menu board, misalnya Mega dan bukan Uno atau Leonardo dan bukan Nano, avrdude tidak mendapat jawaban sama sekali atau melihat ID chip yang tak terduga di baris Device signature. Satu hal lagi: pakai Ctrl+U untuk upload biasa. Sketch > Upload Using Programmer mengharapkan programmer ISP eksternal dan, kalau berhasil, menghapus bootloader di board; setelah itu board tidak lagi menerima upload lewat USB.

Arduino Nano tidak mau di-upload: ATmega328P (Old Bootloader)

Sebagian besar board Nano murah di pasaran adalah klon berbasis CH340, dan banyak di antaranya masih memakai bootloader lama. Di awal 2018, Arduino mengganti bootloader Nano dengan Optiboot yang lebih kecil dan lebih cepat seperti di Uno, dan sejak itu opsi bawaan ATmega328P di IDE berkomunikasi di 115200 baud. Bootloader lama mengharapkan 57600 baud. Ketika kecepatannya tidak cocok, board seolah tidak menjawab sama sekali dan error not in sync: resp=0x00 berulang sampai sepuluh percobaan. Solusinya cukup satu pengaturan menu: Tools > Processor > ATmega328P (Old Bootloader). Kalau kamu tidak yakin mana yang benar, coba opsinya satu per satu; pilihan yang salah tidak merusak board.

Modul di pin 0 dan 1 menghalangi upload

Di Uno dan Nano, chip USB ke serial terhubung ke ATmega328P melalui resistor 1 kΩ di pin D0 (RX) dan D1 (TX). Selama upload, jalur ini milik komputer. Kalau modul serial seperti modul Bluetooth HC-05, GPS, ESP-01, atau sensor sidik jari terhubung ke pin-pin ini, modul itu akan mengirim datanya sendiri ke jalur atau menahan jalur di level tetap, sehingga merusak jabat tangan bootloader. Hasilnya lagi-lagi programmer is not responding atau not in sync. Solusi tercepat adalah mencabut kabel D0 dan D1 ketika upload; solusi permanennya adalah memindahkan modul ke pin lain dengan 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}

Di sketch ini, TX HC-05 masuk ke D10 dan RX-nya ke D11. Input RX HC-05 bekerja di 3,3 V, jadi pasang pembagi tegangan dari resistor 1 kΩ dan 2 kΩ di antara input itu dan D11. Sekarang kamu bisa upload dengan modul tetap terhubung dan mengirim apa pun yang kamu ketik di Serial Monitor ke ponselmu. Untuk pengkabelan lengkap dan mode perintah AT, lihat panduan Modul Bluetooth HC-05. Di Mega kamu tidak butuh SoftwareSerial: board ini punya port serial hardware tambahan seperti Serial1 (TX1 = D18, RX1 = D19).

Serial Monitor dan program yang membuat port tetap sibuk

Port serial hanya bisa dibuka oleh satu program dalam satu waktu. Itulah sebabnya Windows menampilkan Access is denied, sedangkan macOS dan Linux menampilkan Resource busy. Arduino IDE biasanya menjeda Serial Monitor-nya sendiri selama upload, tetapi ini tidak selalu sempurna di setiap versi dan setiap board, terutama ESP32; kalau kamu mendapat error ini, tutup dulu tab Serial Monitor. Lebih sering lagi, port ditahan oleh program lain: jendela IDE kedua, Serial Plotter yang terbuka, PuTTY, software printer 3D seperti Cura, monitor PlatformIO di VS Code, atau skrip Python yang berjalan di latar belakang. Tutup semuanya, cabut dan colokkan lagi board-nya, lalu coba lagi. Di Linux kamu bisa melihat program mana yang menahan port dengan sudo lsof /dev/ttyUSB0.

Apakah board-nya rusak? Loopback test dan burn bootloader

Kalau kamu sudah mencoba semua cara di atas dan tetap tidak bisa upload, kamu perlu mencari tahu apakah masalahnya di sisi USB atau di prosesor utama. Metode klasik untuk Uno dan Nano adalah loopback test: prosesor utama ditahan dalam kondisi reset, lalu chip USB ke serial dibiarkan berbicara dengan dirinya sendiri. Kamu tidak perlu meng-upload kode apa pun untuk tes ini.

1. Lepas semua kabel dari board dan sisakan hanya kabel USB yang terhubung.
2. Pakai kabel jumper untuk menghubungkan pin RESET ke GND; ini menahan ATmega328P dalam kondisi reset sehingga tidak ikut di jalur.
3. Pakai kabel kedua untuk menghubungkan pin D0 dan D1.
4. Pilih port board di IDE lalu buka Serial Monitor; baud rate tidak berpengaruh untuk tes ini.
5. Ketik beberapa karakter di kotak lalu kirim. Kalau teksmu langsung kembali, kabel, driver, dan chip USB ke serial dalam keadaan baik, dan masalahnya ada di prosesor utama atau bootloader. Kalau tidak ada yang kembali, masalahnya ada di sisi USB.
6. Jangan lupa melepas kedua kabel itu setelah selesai.

Kalau loopback test lolos tetapi upload tetap gagal, dan LED L tidak berkedip sebentar ketika reset ditekan, mungkin bootloader-nya terhapus atau chip-nya sudah diganti. Kamu bisa burn bootloader lagi dengan Uno kedua. Upload File > Examples > 11.ArduinoISP > ArduinoISP ke Uno yang akan berperan sebagai programmer. Lalu hubungkan D10 programmer ke pin RESET target, D11, D12, dan D13 ke pin target dengan nomor yang sama, serta 5V dan GND ke pasangannya. Pasang kapasitor 10 µF di antara RESET dan GND di Uno programmer; ini mencegahnya me-reset dirinya sendiri. Terakhir, pilih Tools > Programmer > Arduino as ISP, pilih board target di menu board, dan jalankan Tools > Burn Bootloader. Metode ini juga bisa kamu pakai untuk memberi Nano klon Optiboot yang baru.

ESP32 tidak mau di-upload: Failed to connect dan tombol BOOT

Di ESP32, upload dilakukan oleh esptool, bukan avrdude. Output pertama-tama menampilkan baris Connecting........_____..... ketika esptool mencoba memasukkan board ke mode download. Kalau gagal, kamu mendapat error yang diawali A fatal error occurred: Failed to connect to ESP32. Di versi esptool terbaru, kalau board ternyata boot secara normal, pesannya berlanjut dengan Wrong boot mode detected (0x13)! The chip needs to be in download mode.; 0x13 berarti board mulai di mode boot normal, bukan di mode download. Kalau board sama sekali tidak menjawab, pesannya berakhir dengan No serial data received; versi lama melaporkannya sebagai Timed out waiting for packet header. Kalau board tidak bisa masuk ke mode download sendiri, kamu yang melakukannya secara manual.

1. Klik Upload di IDE dan perhatikan jendela output.
2. Begitu Connecting... muncul, tekan dan tahan tombol BOOT di board.
3. Kalau masih tidak terhubung, tekan dan lepas EN sekali sebentar sambil tetap menahan BOOT.
4. Lepas BOOT ketika baris yang diawali Writing at dan persentase upload mulai bergulir di output.
5. Upload berakhir dengan Hard resetting via RTS pin.... Kalau program tidak mulai, tekan EN sekali.

Kenapa ini terjadi? Untuk masuk ke mode download, pin GPIO0 ESP32 harus LOW pada momen board boot. Rangkaian auto-reset dua transistor di board pengembangan melakukannya secara otomatis dengan sinyal DTR dan RTS dari chip USB; di board murah, rangkaian ini bisa meleset pewaktuannya. Kalau kamu bosan menekan BOOT setiap kali, ada solusi permanen: pasang kapasitor elektrolit 10 µF di antara pin EN dan GND board (kaki negatif ke GND). Kapasitor ini memperlambat naiknya jalur EN dan memberi rangkaian auto-reset waktu untuk menahan GPIO0 tetap 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: upload dengan BOOTSEL dan UF2

Pico tidak punya chip USB ke serial terpisah; RP2040 punya pengendali USB sendiri, dan bootloader-nya berada di ROM chip yang tidak bisa dihapus. Itu membuat Pico hampir mustahil dirusak lewat software. Kalau kamu menahan tombol BOOTSEL sambil mencolokkan kabel USB, Pico muncul di komputermu sebagai flash drive bernama RPI-RP2 (di Pico 2, drive-nya bernama RP2350). File .uf2 apa pun yang kamu seret ke drive ini akan ditulis ke board, lalu board me-restart sendiri; dengan cara ini juga kamu menginstal MicroPython.

Kalau kamu memprogram Pico dengan Arduino IDE, belum ada port COM untuk upload pertama; colokkan board sambil menahan BOOTSEL lalu klik Upload. Setelah sketch pertama, board membuka port serial dan upload berikutnya tidak butuh BOOTSEL. Kalau kodemu crash atau mematikan USB, port-nya hilang lagi dan kamu mendapat error No drive to deploy; kembali saja ke metode BOOTSEL. Kalau kamu memakai MicroPython, MicroPython (Raspberry Pi Pico) harus dipilih sebagai interpreter di pojok kanan bawah Thonny. Untuk pin dan pengaturan Pico, lihat panduan Apa Itu 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)

Penyebab kecil tapi licik yang mudah terlewat

• Leonardo, Micro, dan Uno R4: Di board dengan USB native ini, port bisa berubah sebentar selama upload. Kalau upload macet, klik Upload lalu tekan tombol reset sekali begitu kompilasi selesai dan tahap upload dimulai (dua kali cepat di Uno R4); board akan menunggu di bootloader beberapa waktu dan kode ter-upload ketika itu.
• Auto-reset rusak: Kalau auto-reset tidak berfungsi di Uno atau Nano, tahan tombol reset, klik Upload, lalu lepas begitu baris berisi ukuran sketch muncul di output.
• Shield dan rangkaian eksternal: Shield driver motor atau rangkaian yang membebani jalur 5V bisa membuat tegangan catu daya turun selama upload dan memutus penulisan di tengah jalan.
• Port yang salah di macOS: /dev/cu.Bluetooth-Incoming-Port dan /dev/cu.debug-console di daftar port bukan board-mu, melainkan port sistem. Nama port board-mu mengandung usbmodem, usbserial, atau wchusbserial; kalau tidak yakin, cabut dan colokkan lagi board-nya lalu lihat mana yang hilang.
• Karakter non-ASCII di nama user: Kalau folder user Windows-mu berisi huruf beraksen atau huruf non-Latin, alat kompilasi dan upload di beberapa paket board, terutama paket ESP32, bisa gagal menemukan file. Pindahkan sketchbook-mu ke path tanpa karakter seperti itu di Preferences; kalau masalahnya tetap ada, buat user Windows baru.
• Sketch terlalu besar: Peringatan Sketch too big bukan error upload; peringatan ini mengatakan kodemu tidak muat di flash Uno yang tersisa sekitar 31,5 KB setelah bootloader. Pangkas library dan string panjang, atau pindah ke board yang lebih besar.
• Port macet setelah sleep: Setelah komputer bangun dari sleep, port bisa macet; me-restart IDE atau mencolokkan board ke port USB lain biasanya menyelesaikannya.

Upload berhasil: lalu apa?

• Rangkaian pertama: Buat rangkaian Blink sendiri dengan LED dan resistor, lalu tambahkan tombol untuk proyek interaktif pertamamu.
• Komunikasi serial: Sekarang setelah kamu tahu bagaimana pin 0 dan 1 memengaruhi upload, coba nyalakan LED dari ponselmu dengan modul Bluetooth HC-05.
• Membaca sensor: Pakai Panduan Sensor Arduino untuk memilih proyek pertamamu yang mengukur suhu, jarak, dan cahaya.
• Beralih ke nirkabel: Buat proyek dengan ESP32 yang terhubung ke Wi-Fi dan dikendalikan dari ponselmu; berkat OTA, nanti kamu juga bisa meng-upload kode secara nirkabel.
• Memilih board yang tepat: Kalau kamu tidak bisa memutuskan antara Uno, Nano, dan Mega, baca Arduino Mana yang Sebaiknya Kubeli?.

Error upload memang menyebalkan ketika pertama kali kamu temui, tetapi masing-masing punya penyebab yang logis, dan hampir semuanya ditemukan dengan urutan yang sama: kabel, driver, port, pengaturan board, jalur serial, dan terakhir bootloader. Ingat urutan itu dan kamu akan menyelesaikan error berikutnya dalam hitungan menit. Begitu board-mu menerima kode, aplikasi BlueGrays punya banyak proyek untuk Arduino, ESP32, dan Raspberry Pi Pico, dari mengedipkan LED sampai Wi-Fi dan update OTA nirkabel, masing-masing dengan skema rangkaian langkah demi langkah dan kode siap pakai, jadi board-mu bisa langsung kamu pakai.