Paket board ESP32 gagal diinstal: cara mengatasi error Arduino IDE
Paket board ESP32 gagal diinstal di Arduino IDE? Pakai URL yang benar dan atasi Error downloading, timeout, antivirus, proxy, dan sisa paket lama, atau instal offline.
Ketika paket board ESP32 gagal diinstal di Arduino IDE, kamu sedang berhadapan dengan rintangan paling umum bagi yang baru mulai memakai ESP32: esp32 tidak pernah muncul di Boards Manager, instalasi berhenti di tengah jalan dengan “Error downloading”, atau timeout setelah menunggu bermenit-menit. Masalahnya hampir selalu berasal dari salah satu dari lima sumber: URL Board Manager yang salah atau usang, koneksi internet yang lambat atau dibatasi, antivirus yang mengunci file, unduhan lama yang setengah jadi, dan sisa paket lama di disk.
Di panduan ini kamu akan melakukan instalasi bersih langkah demi langkah terlebih dahulu, lalu mencari solusi yang cocok dengan pesan error di layarmu. Kamu juga akan melihat cara menginstal secara offline untuk jaringan sekolah dan kantor yang dibatasi, cara mendapatkan output terperinci dengan Arduino CLI, dan cara memilih antara core 2.x dan 3.x. Terakhir, sebuah sketch uji kecil akan memastikan bahwa instalasinya benar-benar berfungsi.

Apa itu paket board ESP32 dan kenapa ukurannya begitu besar?
Begitu selesai diinstal, Arduino IDE hanya mengenal board buatan Arduino sendiri. Untuk ESP32 kamu membutuhkan paket arduino-esp32 (core) dari Espressif. Isinya jauh lebih dari sekadar beberapa file: di dalamnya ada toolchain compiler Xtensa dan RISC-V, library ESP-IDF, alat upload esptool, dan alat sistem file. Versi 3.x terbaru mengunduh ratusan megabyte dan memakan beberapa gigabyte setelah diekstrak. Makin besar unduhannya, makin besar kemungkinan terputus di tengah jalan, dan dari situlah sebagian besar error berasal.
Instalasi bersih, langkah demi langkah
- Pakai Arduino IDE 2.x versi terbaru; fondasi Java lama di 1.8.x kadang tidak bisa membuka koneksi aman ke beberapa server.
- Buka File › Preferences (di macOS, Arduino IDE › Settings).
- Tempelkan alamat ini ke kolom Additional boards manager URLs: https://espressif.github.io/arduino-esp32/package_esp32_index.json. Kalau sudah ada URL lain, tulis masing-masing di barisnya sendiri.
- Klik OK dan tunggu selagi IDE mengunduh indeks paket di bagian bawah jendela.
- Buka Boards Manager dari bilah sisi kiri, ketik esp32, lalu klik Install pada esp32 by Espressif Systems. Paket “Arduino ESP32 Boards” buatan Arduino sendiri hanya untuk Nano ESP32, jadi jangan sampai tertukar.
- Setelah selesai, pilih ESP32 Dev Module atau model board-mu di Tools › Board.
Tabel solusi berdasarkan pesan error
Ketika instalasi gagal, panel Output di bagian bawah IDE menampilkan pesan panjang. Kamu tidak perlu memahami semuanya: cari frasa kuncinya di tabel berikut dan terapkan solusi di sebelahnya. Kalau kamu melihat beberapa frasa sekaligus, baris terakhir biasanya adalah penyebab sebenarnya.
| Pesan memuat | Artinya | Solusi |
|---|---|---|
| Error downloading ... package_esp32_index.json | Indeks paket tidak bisa dijangkau | Periksa URL huruf demi huruf dan buka di browser; kalau tidak terbuka, masalahnya ada di jaringan atau proxy-mu |
| context deadline exceeded, Client.Timeout exceeded, DEADLINE_EXCEEDED | Unduhan melewati batas waktu | Perpanjang timeout, coba jaringan kabel atau hotspot ponsel |
| TLS handshake timeout, x509: certificate signed by unknown authority | Koneksi aman tidak bisa dibuat | Betulkan tanggal dan jam komputermu; di jaringan perusahaan, masukkan pengaturan proxy |
| checksum mismatch, archive hash differs, CRC doesn't match | File yang diunduh rusak atau tidak lengkap | Hapus file ESP32 di folder staging lalu instal ulang |
| Access is denied, moving extracted archive, rename | Antivirus atau program lain mengunci sebuah file | Tambahkan folder Arduino15 ke pengecualian antivirus, lalu tutup dan buka lagi IDE |
| no space left on device | Disk penuh | Kosongkan setidaknya 5 GB ruang disk dan hapus versi core lama |
| 403 Forbidden, 404 Not Found (github.com) | GitHub diblokir atau alamatnya sudah usang | Coba jaringan lain dan perbarui IDE serta URL-nya |
| esp32 tidak muncul di Boards Manager | URL belum ditambahkan atau indeks belum diperbarui | Tambahkan URL dan mulai ulang IDE |
Timeout dan koneksi lambat
Kasus paling umum adalah koneksi terputus selagi salah satu file toolchain yang besar sedang diunduh. Arduino IDE 2.x memakai Arduino CLI di balik layar, dan timeout jaringan bawaannya bisa terlalu pendek untuk koneksi lambat. Coba dulu solusi yang sederhana: koneksi kabel atau hotspot seluler ponselmu sebagai pengganti Wi-Fi, mematikan atau menyalakan VPN, atau mencoba lagi ketika jaringan sedang sepi. Kalau instalasi terputus, IDE tidak mengunduh ulang file yang sudah selesai begitu kamu memulainya lagi, jadi beberapa kali percobaan bisa membawamu sampai tuntas.
Kalau masalahnya berlanjut, perpanjang timeout. Dengan IDE dalam keadaan tertutup, buka .arduinoIDE/arduino-cli.yaml di folder penggunamu dengan editor teks, tambahkan bagian network: dan, menjorok di bawahnya, baris connection_timeout: 600s. Pengaturan ini menaikkan waktu tunggu menjadi 10 menit dan berlaku di versi IDE terbaru yang menyertakan Arduino CLI 1.x; kalau IDE-mu lebih lama, perbarui dulu. Di jaringan perusahaan, masukkan alamat proxy yang diperlukan di Preferences › Network pada IDE.
Antivirus, firewall, dan proxy
Di Windows, instalasi yang berhenti menjelang akhir dengan “Access is denied” atau “moving extracted archive” biasanya disebabkan oleh antivirus. Proses ekstraksi paket menghasilkan ribuan file kecil; Windows Defender atau perangkat keamanan lain mengunci file-file itu untuk dipindai, dan IDE tidak bisa memindahkannya ke tempatnya. Solusinya adalah menambahkan folder Arduino15 ke pengecualian antivirus selama instalasi; mengecualikan folder ini saja lebih aman daripada mematikan perlindungan sepenuhnya. Di jaringan sekolah dan perusahaan, firewall juga bisa memblokir server unduhan GitHub. Kalau indeks paket terbuka di browser tetapi instalasi tetap gagal, minta alamat proxy ke admin jaringan, atau instal paketnya di rumah lalu pindahkan dengan metode offline di bawah.
| Sistem operasi | Folder Arduino15 | Unduhan setengah jadi (staging) |
|---|---|---|
| Windows | %LOCALAPPDATA%\Arduino15 | %LOCALAPPDATA%\Arduino15\staging\packages |
| macOS | ~/Library/Arduino15 | ~/Library/Arduino15/staging/packages |
| Linux | ~/.arduino15 | ~/.arduino15/staging/packages |
Membersihkan sisa paket lama
Kalau sebelumnya kamu pernah menginstal ESP32 dengan cara lain (misalnya manual dari GitHub) atau menambahkan versi lama bertahun-tahun lalu, instalasi baru bisa bentrok dengan file lama. Tanda-tandanya: instalasi selesai tanpa error tetapi ESP32 muncul dua kali di daftar board, proses kompilasi menampilkan peringatan “multiple libraries were found”, atau IDE terus memakai versi lama. Langkah-langkah berikut memberimu awal yang benar-benar bersih.
- Tutup Arduino IDE sepenuhnya.
- Hapus folder packages/esp32 dan file package_esp32_index.json di dalam Arduino15.
- Hapus file ESP32 yang setengah jadi di staging/packages (yang namanya diawali esp32-, xtensa-, riscv32-, dan esptool).
- Kalau folder sketchbook-mu (biasanya Documents/Arduino) berisi folder hardware/espressif, hapus juga; folder itu sisa instalasi manual lama dan bentrok dengan instalasi lewat Boards Manager.
- Buka IDE, pastikan hanya URL ESP32 terbaru yang tersisa di Preferences, lalu instal ulang paketnya.
Instalasi offline dan manual
Di lab sekolah dengan internet yang dibatasi atau pada koneksi yang sangat lambat, cara paling andal adalah menginstal paket di komputer dengan internet yang bagus lalu menyalinnya. Cara ini berjalan mulus di antara dua komputer dengan sistem operasi yang sama, karena compiler-nya khusus untuk tiap sistem operasi: paket yang diinstal di Windows tidak akan berjalan di macOS.
- Instal Arduino IDE dan paket ESP32 dengan cara biasa di komputer yang internetnya bagus.
- Salin folder packages/esp32 dan file package_esp32_index.json dari folder Arduino15 di komputer itu ke flashdisk.
- Di komputer tujuan, buka lalu tutup Arduino IDE sekali supaya folder Arduino15 terbentuk.
- Tempelkan yang tadi kamu salin ke lokasi yang sama di folder Arduino15 komputer tujuan dan tambahkan URL ESP32 yang sama di Preferences.
- Buka IDE; Boards Manager akan menampilkan esp32 sebagai sudah terinstal, dan board-board ESP32 akan muncul di Tools › Board.
Cara kedua adalah mengunduh file yang sulit diunduh IDE lewat browser lalu menaruhnya di folder staging/packages. Sebelum menginstal, IDE memeriksa folder itu; kalau nama file dan checksum-nya persis sama dengan yang ada di indeks paket (package_esp32_index.json), IDE melewati unduhan dan langsung mengekstrak file tersebut. Baris “Downloading” di panel Output memberi tahu file mana yang dibutuhkan. Cara ketiga, untuk developer, adalah meng-clone repositori GitHub ke hardware/espressif di sketchbook-mu, tetapi metode ini tidak boleh dipakai bersamaan dengan instalasi lewat Boards Manager.
Instalasi terperinci dengan Arduino CLI
IDE hanya menampilkan pesan error yang singkat. Kalau kamu ingin melihat persisnya file mana dan langkah mana yang gagal, pekerjaan yang sama bisa dilakukan dari command line dengan Arduino CLI. Karena IDE 2.x memang sudah memakai alat ini di balik layar, paket yang kamu instal dengan CLI juga muncul di IDE selama keduanya memakai folder data yang sama.
| Perintah | Fungsinya |
|---|---|
| arduino-cli config init | Membuat file konfigurasi |
| arduino-cli config add board_manager.additional_urls https://espressif.github.io/arduino-esp32/package_esp32_index.json | Menambahkan URL paket ESP32 |
| arduino-cli core update-index | Mengunduh indeks paket |
| arduino-cli core install esp32:esp32 -v | Menginstal paket ESP32 dengan output terperinci |
| arduino-cli core install esp32:[email protected] | Menginstal versi tertentu |
| arduino-cli core list | Menampilkan daftar core yang terinstal beserta versinya |
Memilih versi core yang tepat
Boards Manager selalu menyarankan versi terbaru, tetapi yang terbaru belum tentu cocok untuk setiap proyek. Sejak versi 3.0, arduino-esp32 beralih ke ESP-IDF 5 dan beberapa fungsi berubah: PWM sekarang memakai ledcAttach sebagai pengganti ledcSetup dan ledcAttachPin, dan timer memakai timerBegin(frequency) sebagai pengganti timerBegin(0, 80, true). Itu sebabnya library atau tutorial lama yang ditulis untuk 2.x bisa saja tidak terkompilasi di 3.x. Di Boards Manager kamu bisa memilih versi mana pun dari daftar drop-down di bawah paket lalu menginstalnya; hanya satu versi yang terinstal pada satu waktu.
| Versi | Basis ESP-IDF | Chip yang didukung | Kapan memilihnya |
|---|---|---|---|
| 1.0.6 | 3.3 | Hanya ESP32 | Hanya untuk mengompilasi ulang proyek yang sangat lama apa adanya |
| 2.0.17 | 4.4 | ESP32, S2, S3, C3 | Library yang belum diperbarui untuk 3.x dan tutorial lama |
| 3.x (terbaru) | 5.x | ESP32, S2, S3, C3, C6, H2, dan yang lebih baru | Pilihan bawaan untuk proyek baru dan chip baru |
Kalau kamu ingin kodemu sendiri bisa dikompilasi di kedua versi, pakai makro versi. Contoh di bawah menyalakan dan meredupkan LED bawaan secara halus; kalau ESP_ARDUINO_VERSION_MAJOR bernilai 3 atau lebih, yang dikompilasi adalah fungsi PWM baru, kalau tidak, fungsi yang lama. Trik yang sama bisa kamu pakai untuk kode timer dan pin sentuh.
1// Hem 2.x hem 3.x çekirdekte derlenen PWM örneği / PWM example that builds on both 2.x and 3.x cores
2const int LED_PIN = 2;
3const int PWM_FREQ = 5000; // 5 kHz
4const int PWM_RES = 8; // 8 bit: 0-255
5
6void setup() {
7#if ESP_ARDUINO_VERSION_MAJOR >= 3
8 ledcAttach(LED_PIN, PWM_FREQ, PWM_RES); // 3.x: pin tabanlı API / pin-based API
9#else
10 ledcSetup(0, PWM_FREQ, PWM_RES); // 2.x: önce kanal kurulur / set up the channel first
11 ledcAttachPin(LED_PIN, 0);
12#endif
13}
14
15void loop() {
16 for (int duty = 0; duty <= 255; duty++) {
17#if ESP_ARDUINO_VERSION_MAJOR >= 3
18 ledcWrite(LED_PIN, duty); // 3.x: pin numarası / pin number
19#else
20 ledcWrite(0, duty); // 2.x: kanal numarası / channel number
21#endif
22 delay(5);
23 }
24}Menguji instalasi
Jangan menganggap semuanya beres hanya karena instalasi sudah selesai. Upload sketch di bawah dan buka Serial Monitor pada 115200 baud; kamu akan melihat versi core yang terinstal, versi ESP-IDF, model chip, dan ukuran flash, dan LED bawaan akan berkedip. Kalau muncul error ketika mengompilasi, masalahnya masih di instalasi; kalau proses upload berakhir dengan “Failed to connect”, masalahnya sekarang ada di board, kabel, atau driver.
1// ESP32 kart paketi kurulum testi / ESP32 board package install test
2// Seri Monitör: 115200 baud / Serial Monitor: 115200 baud
3
4const int LED_PIN = 2; // çoğu DevKit'te dahili LED / onboard LED on most DevKits
5
6void setup() {
7 Serial.begin(115200);
8 delay(1000);
9 Serial.printf("Arduino-ESP32 core: %d.%d.%d\n",
10 ESP_ARDUINO_VERSION_MAJOR, ESP_ARDUINO_VERSION_MINOR, ESP_ARDUINO_VERSION_PATCH);
11 Serial.printf("ESP-IDF: %s\n", ESP.getSdkVersion());
12 Serial.printf("Yonga / Chip: %s rev %d, %d cekirdek / cores\n",
13 ESP.getChipModel(), ESP.getChipRevision(), ESP.getChipCores());
14 Serial.printf("Flash: %u MB, CPU: %u MHz\n",
15 (unsigned)(ESP.getFlashChipSize() / (1024 * 1024)), (unsigned)ESP.getCpuFreqMHz());
16 pinMode(LED_PIN, OUTPUT);
17}
18
19void loop() {
20 digitalWrite(LED_PIN, !digitalRead(LED_PIN)); // LED yanıp söner / LED blinks
21 delay(500);
22}Masih belum terinstal? Daftar periksa terakhir
- Apakah tanggal dan jam sudah benar? Jam yang salah membuat sertifikat koneksi aman tidak valid, dan setiap unduhan gagal.
- Apakah nama penggunamu mengandung huruf beraksen atau spasi? Beberapa alat gagal pada path yang memuat karakter beraksen atau non-Latin; dengan pengaturan directories.data di arduino-cli.yaml, kamu bisa memindahkan folder paket ke path pendek seperti C:\Arduino15.
- Batas path panjang di Windows: path yang lebih panjang dari 260 karakter bisa menghalangi ekstraksi paket; mengaktifkan dukungan path panjang di Windows atau menjaga path folder tetap pendek akan membantu.
- Ruang disk: arsip yang diunduh dan file hasil ekstraksi berada berdampingan untuk sementara selama instalasi, jadi sediakan setidaknya 5 GB ruang kosong.
- Coba alat lain: kalau IDE gagal, coba Arduino CLI, dan kalau itu juga gagal, coba PlatformIO, yang mengunduh paket dari servernya sendiri.
- Uji kodemu sambil menunggu: sampai urusan instalasi beres, kamu bisa menjalankan rangkaian dan kodemu di browser dengan simulator Wokwi.
Begitu paket board ESP32 terinstal dengan benar, beralih ke proyek Wi-Fi, Bluetooth, dan sensor hanya butuh beberapa menit. Kalau ESP32 masih baru bagimu, mulailah dari Apa itu ESP32?; setelah itu, di aplikasi BlueGrays, kamu bisa mencoba proyek LED ESP32, LED bawaan, dan koneksi Wi-Fi langkah demi langkah lengkap dengan skema rangkaian dan kode siap pakai.
Pertanyaan umum
Kenapa paket board ESP32 tidak mau terinstal?
Penyebab paling umum adalah URL Board Manager yang salah atau usang, koneksi lambat yang terkena timeout, antivirus yang mengunci file, dan unduhan lama yang setengah jadi. Pertama, pastikan URL-nya https://espressif.github.io/arduino-esp32/package_esp32_index.json, lalu terapkan solusi yang cocok dengan pesan error di panel Output.
Apa URL Board Manager ESP32 yang benar?
Untuk rilis stabil terbaru, pakai https://espressif.github.io/arduino-esp32/package_esp32_index.json. Alamat lama dl.espressif.com hanya memuat versi yang sangat lama; kalau masih ada di daftarmu, hapus, karena dua URL ESP32 sekaligus bisa menimbulkan masalah.
Bagaimana cara mengatasi “Error downloading” di Arduino IDE?
Pertama, coba buka URL paket di browser; kalau tidak terbuka, masalahnya ada di jaringan, proxy, atau firewall-mu. Kalau terbuka, hapus file setengah jadi di folder staging, periksa jam komputermu, lalu mulai ulang instalasi lewat koneksi kabel atau hotspot ponsel.
Sebaiknya instal core ESP32 2.x atau 3.x?
Pilih 3.x untuk proyek baru dan chip yang lebih baru seperti ESP32-C6. Kalau library atau tutorial yang kamu andalkan ditulis untuk 2.x dan gagal dikompilasi di 3.x, instal 2.0.17, rilis 2.x yang terakhir. Kamu bisa berganti versi kapan saja dari daftar drop-down di Boards Manager.
Bisakah paket ESP32 diinstal tanpa internet?
Bisa. Instal paketnya di komputer berinternet yang memakai sistem operasi yang sama, lalu salin folder packages/esp32 dan file package_esp32_index.json dari folder Arduino15-nya ke lokasi yang sama di komputer tujuan. Begitu IDE dibuka, paketnya muncul sebagai sudah terinstal.
Berapa ruang disk yang dibutuhkan paket ESP32?
Tergantung versinya; rilis 3.x terbaru memakan beberapa gigabyte bersama toolchain dan library-nya. Arsip dan file hasil ekstraksi berada berdampingan selama instalasi, jadi menyediakan setidaknya 5 GB ruang kosong adalah batas yang aman.
Proyek untuk dibuat setelah membaca ini
Lihat semua proyek
Kedipan LED Bawaan ESP32
Mengedipkan LED biru bawaan di ESP32 DevKit V1. Tidak perlu komponen eksternal! Proyek pertama yang sebaiknya kamu coba ketika membeli ESP32. GPIO 2 tersambung ke LED bawaan.

LED Berkedip dengan ESP32
Mengajarkan penggunaan output GPIO dasar dengan ESP32. Kita membuat efek berkedip dengan menyalakan dan mematikan LED dari pin digital. Versi ESP32 dari proyek blink klasik di Arduino UNO; perintah blink dasar di lingkungan Arduino sama, tetapi susunan pin ESP32 dan level GPIO 3,3 V-nya berbeda dengan Arduino UNO.

Kendali LED dengan Tombol Tekan ESP32 (Tekan)
LED menyala ketika tombol ditekan dan mati ketika dilepas. Menunjukkan cara memakai pin input digital ESP32 dan resistor pull-up internalnya. Mode INPUT_PULLUP membuat resistor eksternal tidak diperlukan.

Lampu Lalu Lintas ESP32
Simulasi lampu lalu lintas sungguhan dengan 3 LED merah-kuning-hijau. Pengaturan waktunya mendekati logika lalu lintas sungguhan: merah lama, kuning singkat, hijau lama. Contoh klasik kendali GPIO berurutan.

Membaca Intensitas Cahaya dengan Modul LDR ESP32
Memantau secara real-time di Serial Monitor nilai ADC mentah modul LDR dan persentase cahaya relatif yang dihitung dari nilai acuan gelap dan terang. Persentase ini bukan pengukuran lux. Mengajarkan logika kalibrasi modul. Ideal dikerjakan sebelum Proyek 10, karena dipakai untuk menentukan nilai ambang.

LED Fade dengan PWM ESP32
Mengubah kecerahan LED secara halus dari 0 ke maksimum, dan dari maksimum ke 0. Kita mengendalikan PWM dengan analogWrite() seperti di Arduino; sintaks yang sama bekerja tanpa masalah di ESP32 Arduino Core 3.0+. Definisi pin + pinMode + analogWrite sudah cukup.

Koneksi Wi-Fi STA ESP32 (dengan Layar LCD)
Di proyek ini, kita menyambungkan ESP32 ke jaringan Wi-Fi rumah dalam mode Station (STA) dengan cara yang aman dan tahan gangguan. Kita menyimpan SSID dan kata sandi di file secrets.h terpisah agar tidak bocor ke Git, menyiapkan mekanisme sambung ulang otomatis, dan menampilkan tingkat sinyal RSSI dan alamat IP di layar LCD I2C. LED bawaan bekerja sebagai indikator status. Ini adalah pengelola koneksi kelas produksi.

Web Server Asinkron ESP32 (dengan Tampilan IP di LCD)
Di proyek ini, kita mengubah ESP32 menjadi web server asinkron yang bisa kamu kendalikan dari ponsel atau komputer di jaringan Wi-Fi yang sama. Berkat library ESPAsyncWebServer, server bisa memproses beberapa permintaan bersamaan (berbeda dengan WebServer.h klasik, yang memblokir pada satu permintaan). Kamu bisa membuka alamat IP ESP32 di browser dan mengklik tombol ON/OFF (rute /on dan /off) untuk menyalakan dan mematikan LED yang tersambung ke GPIO 5.
Artikel lainnya
Aplikasi BlueGrays
Rakit rangkaian ini langkah demi langkah di ponselmu
Skema pengkabelan, kode, dan daftar komponen dalam satu layar. 500+ proyek Arduino, ESP32, dan Pico siap dibuat.
Pindai dengan ponselmu
Arahkan kamera ke kode ini dan toko aplikasi di ponselmu akan terbuka.
atau buka toko aplikasi

