Rehberler · 9 dk okuma

PlatformIO Kurulumu: VS Code ile Arduino, ESP32 ve Pico Rehberi

PlatformIO kurulumu: VS Code eklentisi, platformio.ini ile Uno, ESP32 ve Pico tanımlama, lib_deps ile kütüphane, yükleme, seri monitör ve IDE'den taşıma.

PlatformIO kurulumu, VS Code editörüne tek bir eklenti ekleyerek Arduino Uno, ESP32 ve Raspberry Pi Pico gibi kartları aynı profesyonel ortamdan programlamanı sağlar. Kısaca: VS Code'u kur, Eklentiler sekmesinde PlatformIO IDE'yi aratıp yükle, ilk açılışta gerekli araçların inmesini bekle, ardından PIO Home ekranından kartını seçerek yeni bir proje oluştur. Gerisi platformio.ini adlı küçük bir ayar dosyasında döner: hangi kartın, hangi çatının (framework), hangi kütüphanelerin ve hangi seri port hızının kullanılacağı bu dosyada yazar.

Arduino IDE öğrenmek için harika bir araçtır ama proje büyüdükçe sınırlarını hissedersin: kod tamamlama temel düzeydedir, kütüphaneler bütün projeler için ortaktır ve bir kütüphane güncellemesi eski projeni bozabilir, kart ayarı da projeyle birlikte saklanmaz. PlatformIO bu sorunları çözer. Bu rehberde kurulumu adım adım yapacak, ilk projeni oluşturacak, platformio.ini ile üç farklı kartı tek projede tanımlayacak, kütüphane ekleyecek, kod yükleyip seri monitörü açacak ve mevcut Arduino IDE projelerini nasıl taşıyacağını öğreneceksin. Son bölümde iki aracı tarafsız biçimde karşılaştırıp hangisinin sana uygun olduğuna karar vermene yardım edeceğiz.

PlatformIO ile programlanan Arduino Uno kartı
Arduino Uno, ESP32 ve Raspberry Pi Pico gibi kartları PlatformIO ile aynı editörden, tek bir ayar dosyasıyla programlayabilirsin.

PlatformIO nedir, nasıl çalışır?

PlatformIO, gömülü sistemler için açık kaynaklı bir geliştirme ekosistemidir. Kalbinde Python ile yazılmış PlatformIO Core adlı komut satırı aracı vardır; VS Code eklentisi bu aracı düğmeler, menüler ve PIO Home ekranıyla kullanışlı hale getirir. Bir projeyi derlediğinde PlatformIO önce platformio.ini dosyasını okur, ardından gereken derleyiciyi (Uno için avr-gcc, ESP32 için Xtensa araç zinciri, Pico için arm-none-eabi-gcc), çatıyı ve kütüphaneleri kendi deposundan indirip kodunu derler. Bu paketler yalnızca bir kez indirilir ve kullanıcı klasöründeki .platformio dizininde saklanır; sonraki projeler aynı paketleri tekrar kullanır. Aşağıdaki kavramları bilmek, dosyayı okumanı çok kolaylaştırır:

KavramAnlamıÖrnek
PlatformBir mikrodenetleyici ailesinin derleyici ve yükleme araçları paketiatmelavr, espressif32, raspberrypi
Board (kart)Platform içindeki belirli kart; pin haritası, saat hızı ve bellek bilgisiuno, nanoatmega328, esp32dev, pico
Framework (çatı)Kodu üzerine yazdığın yazılım altyapısıarduino, espidf
Ortam (env)Platform, kart, çatı ve ek ayarların bir arada tanımlandığı bölüm[env:uno]
Kütüphanelib_deps ile projeye eklenen hazır kod paketiadafruit/DHT sensor library
PIO HomeProje açma, kart ve kütüphane arama ekranıDurum çubuğundaki ev simgesi

PlatformIO kurulumu adım adım

  1. Visual Studio Code'u resmi sitesinden indirip kur. Windows'ta kurulum sırasında Add to PATH seçeneğini işaretlemek, terminal kullanımını kolaylaştırır.
  2. VS Code'u aç ve soldaki Eklentiler (Extensions) sekmesine tıkla ya da Ctrl+Shift+X (macOS'ta Cmd+Shift+X) kısayolunu kullan.
  3. Arama kutusuna PlatformIO IDE yaz ve PlatformIO tarafından yayımlanan eklentiyi Install düğmesiyle kur. Gerekli C/C++ eklentisi de otomatik olarak gelir.
  4. Sağ altta "Installing PlatformIO Core" bildirimi görünür. İnternet hızına göre bu adım birkaç dakika sürer; bu sırada VS Code'u kapatma.
  5. Kurulum bitince VS Code yeniden başlatmanı ister. Yeniden başlattıktan sonra sol kenarda PlatformIO simgesi, alt durum çubuğunda da ev simgesi belirir.
  6. Ev simgesine tıklayarak PIO Home ekranını aç. Bu ekran sorunsuz göründüyse kurulum tamamlanmıştır.
Windows kullanıcı adında Türkçe karakter (ş, ğ, ı, ü gibi) ya da boşluk varsa PlatformIO'nun araç zinciri C:\Users\<ad>\.platformio yolunda sorun çıkarabilir ve derleme anlamsız yol hatalarıyla durabilir. Çözüm, sistem ortam değişkenlerine PLATFORMIO_CORE_DIR ekleyip değerini C:\platformio gibi yalnızca İngilizce harflerden oluşan bir klasör yapmaktır. Linux'ta kurulum hata veriyorsa önce python3-venv paketinin kurulu olduğundan emin ol.

İlk proje oluşturma ve klasör yapısı

PIO Home'da New Project düğmesine bas. Açılan pencerede projeye bir ad ver (örneğin blink-uno), Board kutusuna Arduino Uno yazıp listeden seç, Framework olarak Arduino'yu bırak ve konumu belirle. Finish'e bastığında PlatformIO, seçtiğin kart için gereken platform paketini ilk kez indirir; bu yüzden ilk proje birkaç dakika sürebilir, sonrakiler ise saniyeler içinde açılır. Proje oluşunca VS Code klasörü açar ve şu yapıyı görürsün:

Klasör / dosyaNe işe yarar?
platformio.iniProjenin kalbi: kart, çatı, kütüphane ve port ayarları
src/Kaynak kodların; program main.cpp dosyasından başlar
include/Kendi başlık (.h) dosyaların
lib/Projeye özel, elle eklediğin yerel kütüphaneler (her biri ayrı alt klasörde)
test/Birim testleri (unit test) için ayrılmış klasör
.pio/Derleme çıktıları ve indirilen kütüphaneler; silinirse yeniden oluşturulur
.vscode/VS Code ve IntelliSense ayarları; otomatik üretilir

platformio.ini dosyası nedir?

platformio.ini, INI biçiminde düz bir metin dosyasıdır. Köşeli parantezle başlayan her [env:ad] bölümü bir derleme ortamını tanımlar. Arduino IDE'de Araçlar menüsünden seçtiğin kartı ve port hızını burada yazıyla belirtirsin; böylece projeyi başka bir bilgisayara taşıdığında ya da bir arkadaşına verdiğinde ayarlar da kodla birlikte gider. Noktalı virgül ile başlayan satırlar yorumdur. Uno için oluşturulan dosyaya seri monitör hızını eklediğimizde dosya şöyle görünür:

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
AyarGöreviÖrnek değer
platformKullanılacak platform paketi; sürüm de sabitlenebiliratmelavr, [email protected]
boardKart kimliğiuno, megaatmega2560, esp32dev, pico
frameworkYazılım çatısıarduino
monitor_speedSeri monitör hızı (varsayılan 9600)115200
upload_portYükleme portu (boş bırakılırsa otomatik bulunur)COM5, /dev/ttyUSB0
upload_speedYükleme baud hızı (özellikle ESP kartlarda)921600
lib_depsOtomatik indirilecek kütüphaneleradafruit/DHT sensor library@^1.4.4
build_flagsDerleyiciye ek bayraklar ve makrolar-D LED_PIN=2
monitor_filtersSeri monitör çıktısına uygulanan filtrelertime, esp32_exception_decoder

İlk kod: main.cpp ve Arduino.h farkı

src klasöründeki main.cpp dosyası, Arduino IDE'deki .ino dosyasının karşılığıdır, ancak iki önemli fark vardır. Birincisi, dosyanın en başında Arduino.h başlık dosyasını ekleyen #include satırı bulunmalıdır; Arduino IDE bunu arka planda kendisi ekler, PlatformIO eklemez. İkincisi, .cpp dosyası gerçek C++ kurallarına uyar: bir fonksiyonu çağırmadan önce derleyicinin onu tanıması gerekir. Arduino IDE fonksiyon prototiplerini senin yerine üretir; PlatformIO'da ise ya fonksiyonu kullanmadan önce tanımlarsın ya da dosyanın üstüne tek satırlık bir prototip yazarsın. Aşağıdaki örnek, Uno, ESP32 ve Pico'nun üçünde de çalışan bir blink programıdır:

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}
Derlemede 'blinkLed' was not declared in this scope hatası görürsen eksik olan şey neredeyse her zaman prototiptir. Fonksiyonun ilk satırını gövdesi olmadan, sonuna noktalı virgül koyarak setup()'ın üstüne kopyalaman yeterlidir. Çok sayıda fonksiyonun varsa bunları include klasöründeki bir .h dosyasında toplamak daha düzenli olur.

Derleme, yükleme ve seri monitör

İşlemDurum çubuğu / menüTerminal komutu
Derle (Build)Onay işaretipio run
Yükle (Upload)Sağa okpio run -t upload
Yükle ve monitörü açPlatformIO menüsü > Upload and Monitorpio run -t upload -t monitor
Seri monitörFiş simgesipio device monitor
TemizleÇöp kutusupio run -t clean
Portları listelePIO Home > Devicespio device list
Belirli ortamı derleOrtam seçici (env:...)pio run -e esp32dev
Kütüphane kurPIO Home > Librariespio pkg install -l "adafruit/DHT sensor library"

Seri monitörün doğru çalışması için platformio.ini'deki monitor_speed değeri, koddaki Serial.begin() hızıyla aynı olmalıdır; aksi halde ekranda anlamsız karakterler görürsün. PlatformIO bağlı kartı genellikle kendisi bulur, ancak bilgisayarda birden fazla seri cihaz varsa yanlış porta yükleme yapmaya çalışabilir. Bu durumda pio device list komutuyla portları listele ve doğru olanı upload_port ile monitor_port satırlarına yaz. Arduino IDE'nin seri monitörü ya da başka bir terminal programı portu açık tutuyorsa yükleme "Access is denied" ya da "Resource busy" hatasıyla durur; o programı kapatman yeterlidir. Seri monitörün kendisini daha iyi tanımak için Arduino Serial Monitor yazısına da göz atabilirsin. pio komutu, PlatformIO menüsünden açılan PlatformIO Core CLI terminalinde her zaman çalışır.

Uno, ESP32 ve Pico'yu tek projede tanımlamak

PlatformIO'nun en güçlü yanlarından biri, aynı kodu birden fazla kart için derleyebilmesidir. Her kart için ayrı bir [env:...] bölümü yazarsın; ortak ayarları adı olmayan [env] bölümüne koyarsan bütün ortamlar onları miras alır. Aşağıdaki tablo üç popüler kartın temel değerlerini özetliyor:

DeğerArduino UnoESP32 DevKitRaspberry Pi Pico
platformatmelavrespressif32raspberrypi
boardunoesp32devpico
frameworkarduinoarduinoarduino (Arduino Mbed çekirdeği)
Dahili LEDD13GPIO 2 (çoğu DevKit kartında)GP25
Yükleme yöntemiUSB-seri ve bootloaderUSB-seri ve esptoolUSB ve BOOTSEL modu
Tipik monitor_speed9600 ya da 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

default_envs satırı, durum çubuğundaki derle ve yükle düğmelerinin hangi ortamı kullanacağını belirler; bu satırı yazmazsan PlatformIO dosyadaki bütün ortamları sırayla derler. Durum çubuğundaki ortam seçiciden anlık olarak başka bir karta geçebilir ya da terminalde pio run -e esp32dev -t upload yazarak doğrudan ESP32'ye yükleme yapabilirsin. ESP32 ortamındaki -D LED_PIN=2 bayrağı, koddaki LED_PIN makrosunu tanımlar; Uno ve Pico'da bu bayrak olmadığı için kod LED_BUILTIN değerine (13 ve 25) düşer. Böylece tek bir main.cpp, üç kartta da hiçbir değişiklik yapmadan çalışır. Kartların pin yerleşimini hızlıca görmek için pinout aracını kullanabilirsin.

ESP32 için PlatformIO ayarları

ESP32 kartlar, Arduino IDE'de olduğu gibi PlatformIO'da da esptool ile yüklenir. upload_speed = 921600 yükleme süresini belirgin biçimde kısaltır; kablon uzun ya da kalitesizse ve hata alırsan 460800 ya da 115200 değerine düş. esp32_exception_decoder filtresi, kart çöktüğünde seri monitörde çıkan anlamsız adres yığınını fonksiyon adlarına ve satır numaralarına çevirir; Guru Meditation hatalarını bulmak için çok değerlidir. Yükleme "Connecting..." aşamasında takılırsa karttaki BOOT tuşuna basılı tut, yükleme başlayınca bırak; ayrıntılı çözümler ESP32 Failed to Connect yazısında. Bilmen gereken bir ayrıntı da çekirdek sürümüdür: PlatformIO'nun resmi espressif32 platformu uzun süre Arduino-ESP32 çekirdeğinin 2.x sürümünü kullandı; 3.x'e özgü API'lere ihtiyacın varsa topluluğun sürdürdüğü pioarduino platformuna geçebilirsin. Hangi çekirdeğin kullanıldığını, derleme çıktısının başındaki PACKAGES satırında framework-arduinoespressif32 sürümünden görürsün. Kodunun iki sürümde de derlenmesini istiyorsan ESP_ARDUINO_VERSION_MAJOR makrosuyla ayrım yapabilirsin.

Raspberry Pi Pico ve PlatformIO

Resmi raspberrypi platformu, board = pico ayarıyla Arduino'nun resmi Mbed OS tabanlı RP2040 çekirdeğini kullanır. Pek çok kullanıcı ise daha fazla özellik ve kütüphane uyumluluğu sunan Earle Philhower'ın arduino-pico çekirdeğini tercih eder; bu çekirdek PlatformIO'da topluluk tarafından sürdürülen ayrı bir platform paketi ve board_build.core = earlephilhower ayarıyla kullanılır. Hangi çekirdeği seçersen seç, ilk yüklemede Pico'yu BOOTSEL düğmesine basılı tutarak USB'ye takman gerekebilir; kart bilgisayarda RPI-RP2 adlı bir sürücü olarak görünür, PlatformIO programı yükledikten sonra da kendiliğinden yeniden başlar. Sonraki yüklemelerde çoğu zaman düğmeye gerek kalmaz. Önemli bir not: PlatformIO MicroPython desteklemez. Pico'yu MicroPython ile programlamak istiyorsan Thonny gibi bir editör kullanmalısın; ayrıntılar için MicroPython Temelleri ve Raspberry Pi Pico Nedir? yazılarına göz at.

Kütüphane ekleme: lib_deps

PlatformIO'da kütüphaneler bütün bilgisayar için değil, her proje için ayrı kurulur. En temiz yöntem platformio.ini'ye lib_deps satırı eklemektir: ilk derlemede PlatformIO kütüphaneyi kayıt defterinden (registry) indirir ve .pio/libdeps/ klasörüne koyar. Kütüphanenin tam adını PIO Home'daki Libraries sekmesinde arayıp Add to Project düğmesiyle de ekleyebilirsin; bu düğme lib_deps satırını senin yerine yazar. Aşağıda DHT11 sensörünü Uno'nun D2 pinine bağlayan bir örnek var; sensörün kablolaması için DHT11 Sıcaklık ve Nem Sensörü yazısına bakabilirsin.

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}

Sürüm yazımında ^1.4.4, 1.4.4 ve üzerindeki ama 2.0.0'dan küçük sürümlere izin verir; ~1.4.4 yalnızca 1.4.x yamalarını kabul eder; sadece 1.4.4 yazarsan sürüm tamamen sabitlenir. Sürüm sabitlemek, bir yıl sonra projeyi açtığında aynı kodun aynı şekilde derlenmesini garanti eder. Kayıt defterinde olmayan ya da kendi yazdığın bir kütüphaneyi projenin lib klasörüne kendi adıyla bir alt klasör olarak koyarsan PlatformIO onu otomatik bulur. Arduino IDE'deki kütüphane mantığıyla karşılaştırmak istersen Arduino Kütüphane Ekleme yazısını okuyabilirsin.

Arduino IDE'den PlatformIO'ya proje taşıma

  1. PIO Home'da yeni bir proje oluştur ve Arduino IDE'de kullandığın kartın aynısını seç.
  2. .ino dosyasının içeriğini src/main.cpp dosyasına yapıştır; aynı klasördeki diğer .ino sekmelerini main.cpp'nin sonuna ekle, .h ve .cpp dosyalarını ise src klasörüne kopyala.
  3. Dosyanın en üstüne Arduino.h için #include satırını ekle.
  4. setup() ve loop() dışında yazdığın her fonksiyon için dosyanın üst kısmına bir prototip yaz.
  5. Kullandığın kütüphaneleri PIO Home > Libraries üzerinden bulup lib_deps'e ekle; Arduino IDE'deki sürüm numarasını yazarsan aynı davranışı elde edersin.
  6. Serial.begin() hızını monitor_speed satırına yaz ve projeyi derle. Hata listesinde kalan uyarıları tek tek düzelt.

Alternatif olarak PIO Home'daki Import Arduino Project düğmesiyle mevcut klasörü doğrudan içe aktarabilirsin. PlatformIO, src klasöründeki .ino dosyalarını derleme sırasında kendisi .cpp'ye çevirir ve prototipleri üretmeye çalışır. Ancak bu dönüşüm karmaşık kodlarda yanılabildiği ve IntelliSense .ino dosyalarında tam verimli çalışmadığı için uzun vadede main.cpp'ye geçmek daha sağlıklıdır. Derleme mesajlarını yorumlamakta zorlanırsan Arduino derleme hataları yazısındaki açıklamalar PlatformIO için de geçerlidir.

Arduino IDE mi PlatformIO mu?

ÖzellikArduino IDE 2.xPlatformIO (VS Code)
KurulumTek paket, birkaç dakikaVS Code ve eklenti; ilk kurulumda araçlar iner
Kod tamamlamaTemel düzeydeGelişmiş IntelliSense, tanıma gitme, toplu yeniden adlandırma
Kart ayarıAraçlar menüsünde, projeyle saklanmazplatformio.ini içinde, projeyle birlikte taşınır
KütüphanelerBilgisayar genelinde ortakProje başına ayrı, sürüm sabitlenebilir
Birden fazla kartHer seferinde menüden değiştirilirTek projede birden çok ortam
Dosya yapısı.ino; klasör adı dosya adıyla aynı olmalısrc, include, lib; standart .cpp ve .h
Fonksiyon prototipleriOtomatik üretilirElle yazılır (.ino içe aktarmada otomatik)
Git ile sürüm takibiMümkün ama kart ayarları dışarıda kalırKolay; .pio klasörü dışında her şey takip edilir
Hata ayıklama ve testBazı kartlarda hata ayıklayıcıHata ayıklayıcı (debug probe) ve birim test desteği
Yeni başlayana uygunlukÇok yüksekOrta; kısa bir alışma süresi ister

Kısacası, ilk LED'ini yakıyorsan ya da birkaç dosyalık bir okul projesi yapıyorsan Arduino IDE yeterli ve daha az kafa karıştırıcıdır. Birden fazla kart, çok dosyalı kod, Git ile sürüm takibi ya da ekip çalışması söz konusuysa PlatformIO ciddi zaman kazandırır. İki araç birbirini dışlamaz; aynı bilgisayarda ikisini birlikte kullanabilirsin. Arduino IDE'yi henüz kurmadıysan Arduino IDE Kurulumu yazısından başlayabilirsin.

Sık yapılan hatalar ve çözümleri

BelirtiOlası sebepÇözüm
'xyz' was not declared in this scopeFonksiyon prototipi yokPrototipi setup()'tan önce yaz ya da fonksiyonu yukarı taşı
fatal error: DHT.h: No such file or directoryKütüphane lib_deps'te yok ya da başka bir ortama eklenmişKütüphaneyi doğru [env] bölümüne ekleyip yeniden derle
Seri monitörde anlamsız karakterlermonitor_speed ile Serial.begin() hızı farklıİki değeri eşitle (ör. 115200)
Kart görünmüyor, port yokYalnızca şarj kablosu ya da CH340/CP2102 sürücüsü eksikVeri kablosu kullan, sürücüyü kur, pio device list ile kontrol et
Access is denied / Resource busyPort başka bir programda açıkArduino IDE seri monitörünü ve diğer terminalleri kapat
ESP32'de Failed to connect, Wrong boot modeKart indirme moduna geçmediBOOT tuşuna basılı tutarak yüklemeyi başlat
Pico'ya yükleme başlamıyorKart BOOTSEL modunda değilBOOTSEL'e basılı tutarak tak, RPI-RP2 sürücüsünün göründüğünü kontrol et
Linux'ta Permission denied: /dev/ttyUSB0udev kuralı ya da kullanıcı izni yok99-platformio-udev.rules dosyasını kur, kullanıcını dialout grubuna ekle
Windows'ta derleme anlamsız yol hatalarıyla duruyorKullanıcı adında Türkçe karakter ya da boşlukPLATFORMIO_CORE_DIR ile çekirdek klasörünü C:\platformio'ya taşı
Kurulum Installing PlatformIO Core aşamasında takılıİnternet, antivirüs ya da Python sorunuVS Code'u yeniden başlat, Output > PlatformIO günlüğünü incele
IntelliSense bazen kodu kırmızı dalgalı çizgiyle işaretler ama derleme başarılı olur. Bu genellikle VS Code'da projenin bir alt klasörünü açtığın ya da indeksin güncellenmediği anlamına gelir. Her zaman platformio.ini dosyasının bulunduğu klasörü aç ve komut paletinden (Ctrl+Shift+P) PlatformIO: Rebuild IntelliSense Index komutunu çalıştır.

PlatformIO ile denemen gereken ilk projeler

  • Çok kartlı blink: Yukarıdaki üç ortamlı projeyi Uno, ESP32 ve Pico'ya sırayla yükleyerek ortam seçicinin mantığını kavra.
  • Zaman damgalı sensör kaydı: DHT11 verisini monitor_filters = time ayarıyla saatli olarak seri monitöre yazdır.
  • Wi-Fi web sunucusu: ESP32 web sunucusu projesinde kodu birden çok .cpp ve .h dosyasına bölerek düzenli bir yapı kur.
  • Kablosuz güncelleme: ESP32 OTA ile upload_protocol = espota ve upload_port satırına kartın IP adresini yazarak kodu Wi-Fi üzerinden yükle.
  • Durum makinesi: Arduino durum makinesi mantığını ayrı bir sınıf dosyasında yazarak PlatformIO'nun klasör yapısından yararlan.
  • Delay'siz zamanlama: millis() ile birden fazla görevi aynı anda yürüten bir program yaz.

PlatformIO kurulumu ilk başta Arduino IDE'den biraz daha uzun sürse de, platformio.ini dosyası projenin bütün ayarlarını tek yerde tuttuğu için zamanla en çok zaman kazandıran araç olur. Kurulumu bitirdikten sonra ilk iş olarak basit bir LED projesini derleyip yükle, ardından kütüphaneli ve çok kartlı projelere geç. BlueGrays uygulamasında LED yakma, ESP32 ve Pico başlangıç projeleri ile DHT11 ve HC-SR04 gibi sensör projelerini adım adım devre şeması ve kodlarıyla bulabilir, bu kodları doğrudan kendi PlatformIO projene taşıyarak deneyebilirsin.

Sıkça sorulan sorular

PlatformIO ücretsiz mi?

Evet. PlatformIO Core ve VS Code için PlatformIO IDE eklentisi açık kaynaklıdır ve ücretsiz kullanılır. Hobi, okul ya da ticari projelerde kart tanımları, kütüphane yöneticisi, derleme ve yükleme özellikleri için herhangi bir lisans ücreti ödemen gerekmez.

Arduino IDE kodları PlatformIO'da çalışır mı?

Çalışır, çünkü framework = arduino seçtiğinde aynı Arduino çekirdeği ve aynı fonksiyonlar kullanılır. Yapman gereken, kodu src/main.cpp dosyasına taşıyıp en üste Arduino.h include satırını eklemek, fonksiyon prototiplerini yazmak ve kullandığın kütüphaneleri lib_deps'e eklemektir.

PlatformIO kurulumu neden bu kadar uzun sürüyor?

İlk kurulumda PlatformIO Core, Python ortamı ve temel araçlar indirilir; ilk projede de seçtiğin kartın derleyicisi ve çatısı iner. ESP32 paketleri yüzlerce megabayt tutabildiği için bu işlem bağlantı hızına göre 5–15 dakika sürebilir. Paketler bir kez indikten sonra sonraki projeler hızla açılır.

PlatformIO MicroPython destekliyor mu?

Hayır, PlatformIO Arduino ve ESP-IDF gibi C/C++ tabanlı çatılar için tasarlanmıştır. Raspberry Pi Pico ya da ESP32'yi MicroPython ile programlamak istiyorsan Thonny gibi bir editör kullanmalısın. Aynı kartı istersen PlatformIO ile Arduino çatısında da programlayabilirsin.

PlatformIO'da kütüphane nasıl eklenir?

En kolay yol PIO Home'da Libraries sekmesini açıp kütüphaneyi aramak ve Add to Project ile projeni seçmektir. Bu işlem platformio.ini'ye lib_deps satırını ekler ve kütüphane ilk derlemede otomatik iner. Kendi kütüphanelerini ise projenin lib klasörüne alt klasör olarak koyabilirsin.

PlatformIO'da COM port nasıl seçilir?

PlatformIO bağlı kartı çoğu zaman otomatik bulur. Birden fazla seri cihaz varsa durum çubuğundaki port seçiciden ya da platformio.ini'ye upload_port = COM5 ve monitor_port = COM5 satırlarını yazarak portu sabitleyebilirsin. Hangi portların bağlı olduğunu pio device list komutuyla görürsün.

Tüm projeleri gör
Led Yakma
AR-1Başlangıç

Led Yakma

Elektroniğin ilk merhabası: tek bir LED'i yakıp söndürmek. Arduino LED'i çok kısa aralıklarla yakıp söndürür, ışık hızlı hızlı göz kırpar.

4.6(200)
1246
ESP32 ile LED Yakma
ES-1Başlangıç

ESP32 ile LED Yakma

ESP32 ile temel GPIO çıkışı kullanımını öğretir. Bir LED'i dijital pinden açıp kapatarak yanıp sönme efekti elde ederiz. Arduino UNO'daki klasik blink projesinin ESP32 versiyonu; Arduino ortamındaki temel blink komutları aynıdır, ancak ESP32'nin pin yerleşimi ve 3,3 V GPIO seviyeleri Arduino UNO'dan farklıdır.

4.7(37)
108
Raspberry Pi Pico Dahili LED Yakma (Pico ve Pico W)
PI-1Başlangıç

Raspberry Pi Pico Dahili LED Yakma (Pico ve Pico W)

Raspberry Pi Pico serisinin açılış projesi! Pico'nun üzerindeki yeşil dahili LED'i yakıp söndürerek kartın çalıştığını doğruluyoruz; klasik "Hello World" tarzı ilk deney. Harici bileşene gerek yok, Pico ve USB kablosu yeterli. Kod MicroPython ile yazıldı (Raspberry Pi Vakfı'nın resmî olarak desteklediği dil).

5.0(1)
10
DHT11 İle Sıcaklık Ve Nem
AR-55Orta

DHT11 İle Sıcaklık Ve Nem

Odan kaç derece, hava nemli mi, kuru mu? DHT11 sensörü sıcaklığı ve nemi ölçer, Arduino da bu değerleri iki satırlık LCD ekrana yazar ve birkaç saniyede bir yeniler.

4.7(47)
83
HC-SR04 Mesafe Ölçme (Serial Ekran)
AR-27Başlangıç

HC-SR04 Mesafe Ölçme (Serial Ekran)

Yarasalar karanlıkta yollarını nasıl buluyorsa HC-SR04 sensörü de öyle çalışır: duyamadığın bir ses gönderir, yankısını dinler ve önündeki cismin ne kadar uzakta olduğunu ölçer.

4.6(50)
82
ESP32 Dahili LED Yakma
ES-4Başlangıç

ESP32 Dahili LED Yakma

ESP32 DevKit V1'in üzerindeki dahili (built-in) mavi LED'i yanıp söndürmek. Hiçbir harici bileşen gerekmez! ESP32 satın aldığında ilk denemen gereken proje. GPIO 2 dahili LED'e bağlıdır.

4.8(29)
54
Raspberry Pi Pico Harici LED Yakma (Breadboard)
PI-2Başlangıç

Raspberry Pi Pico Harici LED Yakma (Breadboard)

Pico'nun dahili LED'inden sonraki adım: breadboard'a harici bir LED bağlayıp GP14 pini üzerinden kontrol etmek. Bu projede Pico'nun herhangi bir GPIO pinini çıkış olarak kullanmayı, LED'in kutuplarını (uzun bacak = anot/+, kısa bacak = katot/–) ve akım sınırlama direncinin (220Ω) neden şart olduğunu öğreniyorsun. Direnci koymazsan LED'e aşırı akım gider ve yanabilir.

4.5(2)
7
ESP32 Buton ile LED Kontrol (Push)
ES-2Başlangıç

ESP32 Buton ile LED Kontrol (Push)

Butona basılı tutulduğunda LED yanar, bırakıldığında söner. ESP32'nin dijital input pin'i ve dahili pull-up direncinin nasıl kullanıldığını gösterir. INPUT_PULLUP modu sayesinde harici direnç gerekmez.

4.6(36)
57