Panduan · 11 mnt baca

Instalasi PlatformIO: Panduan Arduino, ESP32, dan Pico di VS Code

Instalasi PlatformIO di VS Code: atur Uno, ESP32, dan Pico lewat platformio.ini, tambahkan library dengan lib_deps, upload kode, dan pindah dari Arduino IDE.

Instalasi PlatformIO cukup menambahkan satu ekstensi ke VS Code, lalu kamu bisa memprogram board seperti Arduino Uno, ESP32, dan Raspberry Pi Pico dari satu lingkungan kerja yang profesional. Singkatnya: instal VS Code, cari PlatformIO IDE di tab Extensions lalu instal, tunggu alat-alat yang dibutuhkan selesai diunduh ketika pertama kali dibuka, lalu buat proyek baru dari layar PIO Home dengan memilih board-mu. Sisanya diatur di sebuah file pengaturan kecil bernama platformio.ini: board apa, framework apa, library apa, dan kecepatan port serial berapa yang dipakai, semuanya ditulis di sana.

Arduino IDE adalah alat yang hebat untuk belajar, tapi begitu proyek makin besar kamu akan merasakan batasannya: pelengkapan kode masih dasar, library dipakai bersama oleh semua proyek, pembaruan library bisa merusak proyek lama, dan pengaturan board tidak tersimpan bersama proyek. PlatformIO menyelesaikan masalah-masalah ini. Di panduan ini kamu akan menginstalnya langkah demi langkah, membuat proyek pertamamu, mendefinisikan tiga board berbeda dalam satu proyek lewat platformio.ini, menambahkan library, meng-upload kode, membuka Serial Monitor, dan mempelajari cara memindahkan proyek Arduino IDE yang sudah ada. Di bagian terakhir kita akan membandingkan kedua alat secara adil supaya kamu bisa memutuskan mana yang cocok untukmu.

Board Arduino Uno yang diprogram dengan PlatformIO
Dengan PlatformIO, kamu bisa memprogram board seperti Arduino Uno, ESP32, dan Raspberry Pi Pico dari editor yang sama dengan satu file pengaturan.

Apa itu PlatformIO dan bagaimana cara kerjanya?

PlatformIO adalah ekosistem pengembangan open source untuk sistem embedded. Intinya adalah alat command-line yang ditulis dengan Python bernama PlatformIO Core; ekstensi VS Code membuatnya praktis dengan tombol, menu, dan layar PIO Home. Ketika kamu mem-build sebuah proyek, PlatformIO pertama-tama membaca platformio.ini, lalu mengunduh compiler yang dibutuhkan (avr-gcc untuk Uno, toolchain Xtensa untuk ESP32, arm-none-eabi-gcc untuk Pico), framework, dan library dari registry miliknya sendiri, kemudian mengompilasi kodemu. Paket-paket ini hanya diunduh sekali dan disimpan di folder .platformio di direktori penggunamu; proyek berikutnya memakai ulang paket yang sama. Memahami konsep di bawah ini akan membuat file tersebut jauh lebih mudah dibaca:

KonsepArtiContoh
PlatformPaket compiler dan alat upload untuk satu keluarga mikrokontroleratmelavr, espressif32, raspberrypi
BoardBoard tertentu di dalam sebuah platform; info peta pin, kecepatan clock, dan memoriuno, nanoatmega328, esp32dev, pico
FrameworkFondasi perangkat lunak tempat kodemu ditulisarduino, espidf
Environment (env)Bagian yang mendefinisikan platform, board, framework, dan pengaturan tambahan sekaligus[env:uno]
LibraryPaket kode siap pakai yang ditambahkan ke proyek dengan lib_depsadafruit/DHT sensor library (nama library)
PIO HomeLayar untuk membuka proyek serta mencari board dan libraryIkon rumah di status bar

Instalasi PlatformIO langkah demi langkah

  1. Unduh Visual Studio Code dari situs resminya lalu instal. Di Windows, mencentang Add to PATH selama instalasi membuat pemakaian terminal lebih mudah.
  2. Buka VS Code lalu klik tab Extensions di sebelah kiri, atau pakai shortcut Ctrl+Shift+X (Cmd+Shift+X di macOS).
  3. Ketik PlatformIO IDE di kotak pencarian, lalu instal ekstensi yang diterbitkan oleh PlatformIO dengan tombol Install. Ekstensi C/C++ yang dibutuhkan ikut terpasang otomatis.
  4. Notifikasi “Installing PlatformIO Core” muncul di kanan bawah. Tergantung kecepatan internetmu, langkah ini makan waktu beberapa menit; jangan tutup VS Code selama proses ini.
  5. Begitu instalasi selesai, VS Code memintamu untuk restart. Setelah restart, ikon PlatformIO muncul di tepi kiri dan ikon rumah muncul di status bar bawah.
  6. Klik ikon rumah untuk membuka layar PIO Home. Kalau layar ini tampil normal, instalasi sudah selesai.
Kalau nama pengguna Windows-mu mengandung karakter non-Inggris (misalnya é, ñ, ü, atau huruf beraksen lain) atau spasi, toolchain PlatformIO bisa bermasalah dengan path C:\Users\<name>\.platformio, dan build bisa berhenti dengan error path yang tidak jelas. Solusinya, tambahkan PLATFORMIO_CORE_DIR ke environment variable sistem dan isi nilainya dengan folder yang hanya berisi huruf Inggris, misalnya C:\platformio. Kalau instalasi gagal di Linux, pastikan dulu paket python3-venv sudah terinstal.

Membuat proyek pertama dan struktur foldernya

Klik tombol New Project di PIO Home. Di jendela yang terbuka, beri nama proyek (misalnya blink-uno), ketik Arduino Uno di kotak Board lalu pilih dari daftar, biarkan framework tetap Arduino, dan tentukan lokasinya. Ketika kamu klik Finish, PlatformIO mengunduh paket platform yang dibutuhkan board pilihanmu untuk pertama kali; karena itu proyek pertama bisa makan waktu beberapa menit, sedangkan proyek berikutnya terbuka dalam hitungan detik. Setelah proyek dibuat, VS Code membuka foldernya dan kamu akan melihat struktur ini:

Folder / fileFungsinya
platformio.iniJantung proyek: pengaturan board, framework, library, dan port
src/Kode sumbermu; program dimulai dari main.cpp
include/File header (.h) buatanmu sendiri
lib/Library lokal khusus proyek yang kamu tambahkan manual (masing-masing di subfolder sendiri)
test/Folder yang disediakan untuk unit test
.pio/Hasil build dan library yang diunduh; dibuat ulang kalau dihapus
.vscode/Pengaturan VS Code dan IntelliSense; dibuat otomatis

Apa itu file platformio.ini?

platformio.ini adalah file teks biasa berformat INI. Setiap bagian [env:nama] yang diawali kurung siku mendefinisikan satu environment build. Board dan kecepatan port yang di Arduino IDE kamu pilih dari menu Tools ditulis di sini dalam bentuk teks; jadi ketika kamu memindahkan proyek ke komputer lain atau memberikannya ke teman, pengaturannya ikut terbawa bersama kode. Baris yang diawali titik koma adalah komentar. Kalau kita menambahkan kecepatan Serial Monitor ke file yang dibuat untuk Uno, isinya jadi seperti ini:

C++ (Arduino IDE)
1; PlatformIO proje ayarları / PlatformIO project settings
2[env:uno]
3platform = atmelavr
4board = uno
5framework = arduino
6; Seri monitör hızı, Serial.begin ile aynı olmalı / Monitor speed, must match Serial.begin
7monitor_speed = 115200
PengaturanFungsinyaContoh nilai
platformPaket platform yang dipakai; versinya juga bisa dikunciatmelavr, [email protected]
boardID boarduno, megaatmega2560, esp32dev, pico
frameworkFramework perangkat lunakarduino
monitor_speedKecepatan Serial Monitor (default 9600)115200
upload_portPort upload (dicari otomatis kalau dikosongkan)COM5, /dev/ttyUSB0
upload_speedBaud rate upload (terutama di board ESP)921600
lib_depsLibrary yang diunduh otomatisadafruit/DHT sensor library@^1.4.4 (nama dan versi library)
build_flagsFlag dan makro tambahan untuk compiler-D LED_PIN=2
monitor_filtersFilter yang diterapkan ke output Serial Monitortime, esp32_exception_decoder

Kode pertama: main.cpp dan perbedaan Arduino.h

File main.cpp di folder src adalah padanan file .ino di Arduino IDE, tapi ada dua perbedaan penting. Pertama, file harus diawali baris #include yang menambahkan header Arduino.h; Arduino IDE menambahkannya diam-diam di belakang layar, PlatformIO tidak. Kedua, file .cpp mengikuti aturan C++ yang sebenarnya: compiler harus sudah mengenal sebuah fungsi sebelum kamu memanggilnya. Arduino IDE membuatkan prototipe fungsi untukmu; di PlatformIO kamu harus mendefinisikan fungsi sebelum memakainya atau menulis prototipe satu baris di bagian atas file. Contoh di bawah adalah program blink yang jalan di Uno, ESP32, dan Pico sekaligus:

C++ (Arduino IDE)
1#include <Arduino.h>
2
3// LED_PIN platformio.ini'den gelebilir / LED_PIN may come from platformio.ini
4#ifndef LED_PIN
5#define LED_PIN LED_BUILTIN   // Uno: 13, Pico: GP25
6#endif
7
8void blinkLed(int count);     // prototip / prototype
9
10void setup() {
11  Serial.begin(115200);
12  pinMode(LED_PIN, OUTPUT);
13  Serial.println("PlatformIO hazir / ready");
14}
15
16void loop() {
17  blinkLed(3);
18  delay(1000);
19}
20
21void blinkLed(int count) {
22  for (int i = 0; i < count; i++) {
23    digitalWrite(LED_PIN, HIGH);
24    delay(150);
25    digitalWrite(LED_PIN, LOW);
26    delay(150);
27  }
28  Serial.print("Yanip sondu / Blinked: ");
29  Serial.println(count);
30}
Kalau kamu melihat error 'blinkLed' was not declared in this scope ketika kompilasi, yang kurang hampir selalu prototipenya. Cukup salin baris pertama fungsi tersebut ke atas setup(), tanpa isi fungsinya dan dengan titik koma di akhir. Kalau fungsimu banyak, mengumpulkannya di file .h di folder include akan lebih rapi.

Build, upload, dan Serial Monitor

AksiStatus bar / menuPerintah terminal
BuildTanda centangJalankan pio run
UploadPanah ke kananJalankan pio run -t upload
Upload lalu buka monitorMenu PlatformIO > Upload and MonitorJalankan pio run -t upload -t monitor
Serial MonitorIkon colokanJalankan pio device monitor
Clean (bersihkan)Tempat sampahJalankan pio run -t clean
Daftar portPIO Home > DevicesJalankan pio device list
Build environment tertentuPemilih environment (env:...)Jalankan pio run -e esp32dev
Instal libraryPIO Home > LibrariesJalankan pio pkg install -l "adafruit/DHT sensor library"

Supaya Serial Monitor bekerja dengan benar, nilai monitor_speed di platformio.ini harus sama dengan kecepatan Serial.begin() di kodemu; kalau tidak, kamu akan melihat karakter sampah di layar. PlatformIO biasanya menemukan board yang terhubung dengan sendirinya, tapi kalau komputer punya lebih dari satu perangkat serial, ia bisa mencoba meng-upload ke port yang salah. Dalam kasus itu, tampilkan daftar port dengan pio device list lalu tulis port yang benar di baris upload_port dan monitor_port. Kalau Serial Monitor Arduino IDE atau program terminal lain sedang membuka port tersebut, upload berhenti dengan error “Access is denied” atau “Resource busy”; cukup tutup program itu. Untuk mengenal Serial Monitor lebih dalam, kamu juga bisa membaca artikel Serial Monitor Arduino. Perintah pio selalu bisa dijalankan di terminal PlatformIO Core CLI yang dibuka dari menu PlatformIO.

Mendefinisikan Uno, ESP32, dan Pico dalam satu proyek

Salah satu fitur terkuat PlatformIO adalah kemampuannya mem-build kode yang sama untuk beberapa board. Kamu menulis bagian [env:...] terpisah untuk setiap board; kalau pengaturan bersama ditaruh di bagian [env] tanpa nama, semua environment akan mewarisinya. Tabel di bawah merangkum nilai dasar tiga board populer:

NilaiArduino UnoESP32 DevKitRaspberry Pi Pico
platformatmelavrespressif32raspberrypi
boardunoesp32devpico
frameworkarduinoarduinoarduino (core Arduino Mbed)
LED bawaanD13GPIO 2 (di kebanyakan board DevKit)GP25
Metode uploadUSB-serial dan bootloaderUSB-serial dan esptoolUSB dan mode BOOTSEL
monitor_speed umum9600 atau 115200115200115200
C++ (Arduino IDE)
1[platformio]
2; Varsayılan ortam / Default environment
3default_envs = uno
4
5; Tüm ortamlarda ortak ayarlar / Settings shared by all environments
6[env]
7framework = arduino
8monitor_speed = 115200
9
10[env:uno]
11platform = atmelavr
12board = uno
13
14[env:esp32dev]
15platform = espressif32
16board = esp32dev
17upload_speed = 921600
18monitor_filters = esp32_exception_decoder
19; Dahili LED GPIO 2 / Onboard LED on GPIO 2
20build_flags = -D LED_PIN=2
21
22[env:pico]
23platform = raspberrypi
24board = pico

Baris default_envs menentukan environment mana yang dipakai tombol build dan upload di status bar; kalau baris ini tidak ditulis, PlatformIO mem-build semua environment di file secara berurutan. Kamu bisa langsung pindah ke board lain dari pemilih environment di status bar, atau meng-upload langsung ke ESP32 dengan mengetik pio run -e esp32dev -t upload di terminal. Flag -D LED_PIN=2 di environment ESP32 mendefinisikan makro LED_PIN di kode; karena Uno dan Pico tidak punya flag ini, kode memakai nilai LED_BUILTIN (13 dan 25). Dengan begitu satu main.cpp jalan di ketiga board tanpa perubahan apa pun. Untuk melihat tata letak pin board dengan cepat, kamu bisa memakai alat pinout.

Pengaturan PlatformIO untuk ESP32

Board ESP32 di-upload dengan esptool di PlatformIO, sama seperti di Arduino IDE. upload_speed = 921600 mempersingkat waktu upload secara nyata; kalau kabelmu panjang atau kualitasnya jelek dan muncul error, turunkan ke 460800 atau 115200. Filter esp32_exception_decoder mengubah tumpukan alamat tak bermakna yang muncul di Serial Monitor ketika board crash menjadi nama fungsi dan nomor baris; ini sangat berharga untuk melacak error Guru Meditation. Kalau upload macet di tahap “Connecting...”, tahan tombol BOOT di board lalu lepaskan begitu upload dimulai; solusi lengkapnya ada di artikel ESP32 Failed to Connect. Satu detail lagi yang perlu kamu tahu adalah versi core: platform resmi espressif32 milik PlatformIO lama memakai versi 2.x dari core Arduino-ESP32; kalau kamu butuh API khusus 3.x, kamu bisa pindah ke platform pioarduino yang dikelola komunitas. Core mana yang dipakai bisa kamu lihat dari versi framework-arduinoespressif32 di baris PACKAGES di bagian atas output build. Kalau kamu ingin kodemu bisa dikompilasi di kedua versi, bedakan dengan makro ESP_ARDUINO_VERSION_MAJOR.

Raspberry Pi Pico dan PlatformIO

Dengan board = pico, platform resmi raspberrypi memakai core RP2040 resmi Arduino yang berbasis Mbed OS. Banyak pengguna lebih memilih core arduino-pico buatan Earle Philhower yang menawarkan lebih banyak fitur dan kompatibilitas library yang lebih baik; di PlatformIO core ini dipakai lewat paket platform terpisah yang dikelola komunitas dan pengaturan board_build.core = earlephilhower. Core mana pun yang kamu pilih, untuk upload pertama kamu mungkin perlu mencolokkan Pico ke USB sambil menahan tombol BOOTSEL; board akan muncul di komputer sebagai drive bernama RPI-RP2, dan setelah PlatformIO meng-upload program, board restart dengan sendirinya. Untuk upload berikutnya biasanya tombol itu tidak diperlukan lagi. Catatan penting: PlatformIO tidak mendukung MicroPython. Kalau kamu ingin memprogram Pico dengan MicroPython, pakai editor seperti Thonny; untuk detailnya, baca artikel dasar-dasar MicroPython dan Apa Itu Raspberry Pi Pico?.

Menambahkan library: lib_deps

Di PlatformIO, library diinstal terpisah untuk setiap proyek, bukan untuk seluruh komputer. Cara paling rapi adalah menambahkan baris lib_deps ke platformio.ini: pada build pertama PlatformIO mengunduh library dari registry dan menaruhnya di folder .pio/libdeps/. Kamu juga bisa mencari nama persis library di tab Libraries di PIO Home lalu menambahkannya dengan tombol Add to Project; tombol ini menuliskan baris lib_deps untukmu. Di bawah ini ada contoh yang menghubungkan sensor DHT11 ke pin D2 Uno; untuk pengkabelan sensornya, lihat artikel Sensor Suhu dan Kelembapan DHT11.

C++ (Arduino IDE)
1[env:uno]
2platform = atmelavr
3board = uno
4framework = arduino
5monitor_speed = 115200
6; Kütüphaneler ilk derlemede otomatik iner / Libraries download on first build
7lib_deps =
8    adafruit/DHT sensor library@^1.4.4
9    adafruit/Adafruit Unified Sensor@^1.1.9
C++ (Arduino IDE)
1#include <Arduino.h>
2#include <DHT.h>
3
4#define DHT_PIN 2        // Uno D2 pini / Uno pin D2
5#define DHT_TYPE DHT11
6
7DHT dht(DHT_PIN, DHT_TYPE);
8
9void setup() {
10  Serial.begin(115200);
11  dht.begin();
12}
13
14void loop() {
15  delay(2000);                        // DHT11 en fazla 1 Hz / DHT11 max 1 Hz
16  float h = dht.readHumidity();
17  float t = dht.readTemperature();
18  if (isnan(h) || isnan(t)) {
19    Serial.println("Sensor okunamadi / Read failed");
20    return;
21  }
22  Serial.print("Sicaklik / Temp: ");
23  Serial.print(t, 1);
24  Serial.print(" C  Nem / Hum: ");
25  Serial.print(h, 0);
26  Serial.println(" %");
27}

Dalam penulisan versi, ^1.4.4 mengizinkan versi 1.4.4 ke atas tapi di bawah 2.0.0; ~1.4.4 hanya menerima patch 1.4.x; kalau kamu menulis 1.4.4 saja, versinya dikunci sepenuhnya. Mengunci versi menjamin bahwa ketika kamu membuka proyek setahun lagi, kode yang sama dikompilasi dengan cara yang sama. Kalau kamu menaruh library yang tidak ada di registry, atau library buatanmu sendiri, di folder lib proyek sebagai subfolder dengan namanya sendiri, PlatformIO akan menemukannya otomatis. Kalau ingin membandingkannya dengan cara kerja library di Arduino IDE, kamu bisa membaca artikel Cara Instal Library Arduino.

Memindahkan proyek dari Arduino IDE ke PlatformIO

  1. Buat proyek baru di PIO Home dan pilih board yang sama dengan yang kamu pakai di Arduino IDE.
  2. Tempel isi file .ino ke src/main.cpp; tambahkan tab .ino lain di folder yang sama ke akhir main.cpp, lalu salin file .h dan .cpp ke folder src.
  3. Tambahkan baris #include untuk Arduino.h di paling atas file.
  4. Tulis prototipe di bagian atas file untuk setiap fungsi buatanmu selain setup() dan loop().
  5. Cari library yang kamu pakai lewat PIO Home > Libraries lalu tambahkan ke lib_deps; kalau kamu menulis nomor versi yang sama dengan di Arduino IDE, perilakunya juga akan sama.
  6. Tulis kecepatan Serial.begin() di baris monitor_speed lalu build proyeknya. Perbaiki sisa warning di daftar error satu per satu.

Sebagai alternatif, kamu bisa langsung mengimpor folder yang sudah ada dengan tombol Import Arduino Project di PIO Home. PlatformIO mengubah file .ino di folder src menjadi .cpp selama build dan mencoba membuat prototipenya. Namun, karena konversi ini bisa keliru pada kode yang rumit dan IntelliSense tidak bekerja maksimal di file .ino, pindah ke main.cpp lebih sehat dalam jangka panjang. Kalau kamu kesulitan memahami pesan build, penjelasan di artikel error kompilasi Arduino juga berlaku untuk PlatformIO.

Arduino IDE atau PlatformIO?

FiturArduino IDE 2.xPlatformIO (VS Code)
InstalasiSatu paket, beberapa menitVS Code plus ekstensi; alat-alat diunduh pada instalasi pertama
Pelengkapan kodeDasarIntelliSense canggih, lompat ke definisi, ganti nama massal
Pengaturan boardDi menu Tools, tidak tersimpan bersama proyekDi platformio.ini, ikut terbawa bersama proyek
LibraryDipakai bersama di seluruh komputerTerpisah per proyek, versi bisa dikunci
Banyak boardDiganti dari menu setiap kaliBeberapa environment dalam satu proyek
Struktur file.ino; nama folder harus sama dengan nama filesrc, include, lib; .cpp dan .h standar
Prototipe fungsiDibuat otomatisDitulis manual (otomatis ketika mengimpor .ino)
Version control dengan GitBisa, tapi pengaturan board tertinggalMudah; semuanya terlacak kecuali folder .pio
Debugging dan pengujianDebugger di beberapa boardDukungan debugger (debug probe) dan unit test
Ramah pemulaSangat tinggiSedang; butuh waktu adaptasi sebentar

Singkatnya, kalau kamu baru menyalakan LED pertamamu atau mengerjakan proyek sekolah dengan beberapa file, Arduino IDE sudah cukup dan tidak terlalu membingungkan. Kalau kamu berurusan dengan banyak board, kode multi-file, version control dengan Git, atau kerja tim, PlatformIO menghemat banyak waktu. Kedua alat ini tidak saling meniadakan; kamu bisa memakai keduanya di komputer yang sama. Kalau belum menginstal Arduino IDE, kamu bisa mulai dari artikel Cara Instal Arduino IDE 2.

Kesalahan umum dan cara mengatasinya

GejalaKemungkinan penyebabSolusi
“'xyz' was not declared in this scope” (fungsi belum dideklarasikan)Prototipe fungsi tidak adaTulis prototipe sebelum setup() atau pindahkan fungsinya ke atas
“fatal error: DHT.h: No such file or directory” (file header tidak ditemukan)Library tidak ada di lib_deps atau ditambahkan ke environment lainTambahkan library ke bagian [env] yang benar lalu build ulang
Karakter sampah di Serial Monitormonitor_speed berbeda dengan kecepatan Serial.begin()Samakan kedua nilai (misalnya 115200)
Board tidak terlihat, port tidak adaKabel khusus pengisian daya, atau driver CH340/CP2102 belum adaPakai kabel data, instal driver-nya, cek dengan pio device list
“Access is denied / Resource busy” (port sibuk)Port sedang dibuka program lainTutup Serial Monitor Arduino IDE dan terminal lainnya
“Failed to connect, Wrong boot mode” di ESP32Board tidak masuk ke mode downloadMulai upload sambil menahan tombol BOOT
Upload ke Pico tidak mau mulaiBoard tidak dalam mode BOOTSELColokkan sambil menahan BOOTSEL, cek apakah drive RPI-RP2 muncul
“Permission denied: /dev/ttyUSB0” di LinuxAturan udev atau izin pengguna belum adaInstal file 99-platformio-udev.rules, tambahkan penggunamu ke grup dialout
Di Windows build berhenti dengan error path yang tidak jelasKarakter non-Inggris atau spasi di nama penggunaPindahkan folder core ke C:\platformio dengan PLATFORMIO_CORE_DIR
Instalasi macet di tahap Installing PlatformIO CoreMasalah internet, antivirus, atau PythonRestart VS Code, periksa log Output > PlatformIO
Kadang IntelliSense menandai kode dengan garis bergelombang merah padahal build berhasil. Ini biasanya berarti kamu membuka subfolder proyek di VS Code atau indeksnya belum diperbarui. Selalu buka folder yang berisi platformio.ini dan jalankan perintah PlatformIO: Rebuild IntelliSense Index dari command palette (Ctrl+Shift+P).

Proyek pertama yang bisa kamu coba dengan PlatformIO

  • Blink multi-board: Upload proyek tiga environment di atas ke Uno, ESP32, dan Pico secara bergantian untuk memahami cara kerja pemilih environment.
  • Log sensor dengan timestamp: Cetak data DHT11 ke Serial Monitor lengkap dengan timestamp memakai pengaturan monitor_filters = time.
  • Web server Wi-Fi: Di proyek web server ESP32, pecah kode menjadi beberapa file .cpp dan .h untuk membangun struktur yang rapi.
  • Pembaruan nirkabel: Dengan OTA ESP32, upload kode lewat Wi-Fi dengan mengatur upload_protocol = espota dan menulis alamat IP board di baris upload_port.
  • State machine: Tulis logika state machine Arduino di file class terpisah dan manfaatkan struktur folder PlatformIO.
  • Pengaturan waktu tanpa delay: Tulis program yang menjalankan beberapa tugas sekaligus dengan millis().

Meskipun instalasi PlatformIO di awal sedikit lebih lama daripada Arduino IDE, file platformio.ini menyimpan semua pengaturan proyek di satu tempat, jadi lama-kelamaan alat inilah yang paling banyak menghemat waktumu. Setelah instalasi selesai, hal pertama yang perlu dilakukan adalah mem-build dan meng-upload proyek LED sederhana, lalu lanjut ke proyek dengan library dan banyak board. Di aplikasi BlueGrays kamu akan menemukan proyek LED berkedip, proyek awal ESP32 dan Pico, serta proyek sensor seperti DHT11 dan HC-SR04 langkah demi langkah lengkap dengan skema rangkaian dan kodenya, dan kamu bisa mencobanya dengan memindahkan kodenya langsung ke proyek PlatformIO-mu sendiri.

Pertanyaan umum

Apakah PlatformIO gratis?

Ya. PlatformIO Core dan ekstensi PlatformIO IDE untuk VS Code bersifat open source dan gratis dipakai. Untuk proyek hobi, sekolah, maupun komersial, kamu tidak perlu membayar biaya lisensi apa pun untuk definisi board, library manager, serta fitur build dan upload.

Apakah kode Arduino IDE bisa jalan di PlatformIO?

Bisa, karena ketika kamu memilih framework = arduino, core Arduino dan fungsi-fungsi yang dipakai sama. Yang perlu kamu lakukan hanyalah memindahkan kode ke src/main.cpp, menambahkan include Arduino.h di paling atas, menulis prototipe fungsi, dan menambahkan library yang kamu pakai ke lib_deps.

Kenapa instalasi PlatformIO lama sekali?

Pada instalasi pertama, PlatformIO Core, environment Python, dan alat-alat dasar diunduh; di proyek pertamamu, compiler dan framework untuk board pilihanmu juga ikut diunduh. Karena paket ESP32 bisa berukuran ratusan megabyte, proses ini bisa makan waktu 5–15 menit tergantung koneksimu. Begitu paket-paketnya sudah terunduh, proyek berikutnya terbuka dengan cepat.

Apakah PlatformIO mendukung MicroPython?

Tidak, PlatformIO dirancang untuk framework berbasis C/C++ seperti Arduino dan ESP-IDF. Kalau kamu ingin memprogram Raspberry Pi Pico atau ESP32 dengan MicroPython, pakai editor seperti Thonny. Kalau mau, kamu juga bisa memprogram board yang sama dengan framework Arduino di PlatformIO.

Bagaimana cara menambahkan library di PlatformIO?

Cara termudah adalah membuka tab Libraries di PIO Home, mencari library-nya, lalu memilih proyekmu lewat Add to Project. Ini menambahkan baris lib_deps ke platformio.ini dan library akan terunduh otomatis pada build pertama. Library buatanmu sendiri bisa ditaruh di folder lib proyek sebagai subfolder.

Bagaimana cara memilih port COM di PlatformIO?

Hampir selalu PlatformIO menemukan board yang terhubung secara otomatis. Kalau ada beberapa perangkat serial, kamu bisa mengunci port lewat pemilih port di status bar atau dengan menulis baris upload_port = COM5 dan monitor_port = COM5 di platformio.ini. Port mana saja yang terhubung bisa kamu lihat dengan perintah pio device list.

Lihat semua proyek
LED Berkedip
AR-1Pemula

LED Berkedip

"Halo" pertama di dunia elektronika: menyalakan dan mematikan satu LED. Arduino menyalakan dan mematikan LED dengan jeda singkat, sehingga cahayanya berkedip cepat.

4.6(200)
1246
LED Berkedip dengan ESP32
ES-1Pemula

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.

4.7(37)
108
Kedip LED Bawaan Raspberry Pi Pico (Pico dan Pico W)
PI-1Pemula

Kedip LED Bawaan Raspberry Pi Pico (Pico dan Pico W)

Proyek pembuka seri Raspberry Pi Pico! Kita mengedipkan LED hijau bawaan untuk memastikan board bekerja; percobaan "Hello World" klasik. TANPA komponen eksternal, hanya Pico dan kabel USB. Kodenya ditulis dalam MicroPython (bahasa resmi dari Raspberry Pi Foundation). Pelajari kelas machine.Pin, mode Pin.OUT, metode led.on()/off(), dan time.sleep() di Thonny IDE, dan ikuti setiap perubahan di output Serial (REPL). Juga pas untuk menguji firmware MicroPython.

5.0(1)
10
Suhu dan Kelembapan dengan DHT11
AR-55Menengah

Suhu dan Kelembapan dengan DHT11

Seberapa hangat kamarmu, dan apakah udaranya lembap atau kering? Sensor DHT11 mengukur suhu dan kelembapan, dan Arduino menulis nilainya di layar LCD dua baris, diperbarui setiap beberapa detik.

4.7(47)
83
Pengukuran Jarak HC-SR04 (Tampilan Serial)
AR-27Pemula

Pengukuran Jarak HC-SR04 (Tampilan Serial)

Sensor HC-SR04 bekerja persis seperti kelelawar yang mencari jalan dalam gelap: ia mengirim suara yang tidak bisa kamu dengar, mendengarkan pantulannya, dan mengukur seberapa jauh benda di depannya.

4.6(50)
82
Kedipan LED Bawaan ESP32
ES-4Pemula

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.

4.8(29)
54
Raspberry Pi Pico: Mengendalikan LED Eksternal (Breadboard)
PI-2Pemula

Raspberry Pi Pico: Mengendalikan LED Eksternal (Breadboard)

Langkah berikutnya setelah LED bawaan Pico: menyambungkan LED eksternal ke breadboard dan mengendalikannya lewat pin GP14. Di proyek ini, kamu belajar memakai pin GPIO serbaguna Pico mana pun sebagai output, polaritas LED (kaki panjang = anoda/+, kaki pendek = katoda/–), dan kenapa resistor pembatas arus (220Ω) diperlukan. Tanpa resistor, arus berlebih mengalir melalui LED dan LED bisa terbakar. Rangkaiannya sangat sederhana: Pico GP14 → resistor 220Ω → LED → GND.

4.5(2)
7
Kendali LED dengan Tombol Tekan ESP32 (Tekan)
ES-2Pemula

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.

4.6(36)
57