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 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:
| Kavram | Anlamı | Örnek |
|---|---|---|
| Platform | Bir mikrodenetleyici ailesinin derleyici ve yükleme araçları paketi | atmelavr, espressif32, raspberrypi |
| Board (kart) | Platform içindeki belirli kart; pin haritası, saat hızı ve bellek bilgisi | uno, 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üphane | lib_deps ile projeye eklenen hazır kod paketi | adafruit/DHT sensor library |
| PIO Home | Proje açma, kart ve kütüphane arama ekranı | Durum çubuğundaki ev simgesi |
PlatformIO kurulumu adım adım
- 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.
- VS Code'u aç ve soldaki Eklentiler (Extensions) sekmesine tıkla ya da Ctrl+Shift+X (macOS'ta Cmd+Shift+X) kısayolunu kullan.
- Arama kutusuna PlatformIO IDE yaz ve PlatformIO tarafından yayımlanan eklentiyi Install düğmesiyle kur. Gerekli C/C++ eklentisi de otomatik olarak gelir.
- 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.
- 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.
- Ev simgesine tıklayarak PIO Home ekranını aç. Bu ekran sorunsuz göründüyse kurulum tamamlanmıştır.
İ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 / dosya | Ne işe yarar? |
|---|---|
| platformio.ini | Projenin 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:
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| Ayar | Görevi | Örnek değer |
|---|---|---|
| platform | Kullanılacak platform paketi; sürüm de sabitlenebilir | atmelavr, [email protected] |
| board | Kart kimliği | uno, megaatmega2560, esp32dev, pico |
| framework | Yazılım çatısı | arduino |
| monitor_speed | Seri monitör hızı (varsayılan 9600) | 115200 |
| upload_port | Yükleme portu (boş bırakılırsa otomatik bulunur) | COM5, /dev/ttyUSB0 |
| upload_speed | Yükleme baud hızı (özellikle ESP kartlarda) | 921600 |
| lib_deps | Otomatik indirilecek kütüphaneler | adafruit/DHT sensor library@^1.4.4 |
| build_flags | Derleyiciye ek bayraklar ve makrolar | -D LED_PIN=2 |
| monitor_filters | Seri monitör çıktısına uygulanan filtreler | time, 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:
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}Derleme, yükleme ve seri monitör
| İşlem | Durum çubuğu / menü | Terminal komutu |
|---|---|---|
| Derle (Build) | Onay işareti | pio run |
| Yükle (Upload) | Sağa ok | pio run -t upload |
| Yükle ve monitörü aç | PlatformIO menüsü > Upload and Monitor | pio run -t upload -t monitor |
| Seri monitör | Fiş simgesi | pio device monitor |
| Temizle | Çöp kutusu | pio run -t clean |
| Portları listele | PIO Home > Devices | pio device list |
| Belirli ortamı derle | Ortam seçici (env:...) | pio run -e esp32dev |
| Kütüphane kur | PIO Home > Libraries | pio 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ğer | Arduino Uno | ESP32 DevKit | Raspberry Pi Pico |
|---|---|---|---|
| platform | atmelavr | espressif32 | raspberrypi |
| board | uno | esp32dev | pico |
| framework | arduino | arduino | arduino (Arduino Mbed çekirdeği) |
| Dahili LED | D13 | GPIO 2 (çoğu DevKit kartında) | GP25 |
| Yükleme yöntemi | USB-seri ve bootloader | USB-seri ve esptool | USB ve BOOTSEL modu |
| Tipik monitor_speed | 9600 ya da 115200 | 115200 | 115200 |
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 = picodefault_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.
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.91#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
- PIO Home'da yeni bir proje oluştur ve Arduino IDE'de kullandığın kartın aynısını seç.
- .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.
- Dosyanın en üstüne Arduino.h için #include satırını ekle.
- setup() ve loop() dışında yazdığın her fonksiyon için dosyanın üst kısmına bir prototip yaz.
- 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.
- 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?
| Özellik | Arduino IDE 2.x | PlatformIO (VS Code) |
|---|---|---|
| Kurulum | Tek paket, birkaç dakika | VS Code ve eklenti; ilk kurulumda araçlar iner |
| Kod tamamlama | Temel düzeyde | Gelişmiş IntelliSense, tanıma gitme, toplu yeniden adlandırma |
| Kart ayarı | Araçlar menüsünde, projeyle saklanmaz | platformio.ini içinde, projeyle birlikte taşınır |
| Kütüphaneler | Bilgisayar genelinde ortak | Proje başına ayrı, sürüm sabitlenebilir |
| Birden fazla kart | Her seferinde menüden değiştirilir | Tek projede birden çok ortam |
| Dosya yapısı | .ino; klasör adı dosya adıyla aynı olmalı | src, include, lib; standart .cpp ve .h |
| Fonksiyon prototipleri | Otomatik üretilir | Elle yazılır (.ino içe aktarmada otomatik) |
| Git ile sürüm takibi | Mümkün ama kart ayarları dışarıda kalır | Kolay; .pio klasörü dışında her şey takip edilir |
| Hata ayıklama ve test | Bazı kartlarda hata ayıklayıcı | Hata ayıklayıcı (debug probe) ve birim test desteği |
| Yeni başlayana uygunluk | Çok yüksek | Orta; 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
| Belirti | Olası sebep | Çözüm |
|---|---|---|
| 'xyz' was not declared in this scope | Fonksiyon prototipi yok | Prototipi setup()'tan önce yaz ya da fonksiyonu yukarı taşı |
| fatal error: DHT.h: No such file or directory | Kü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 karakterler | monitor_speed ile Serial.begin() hızı farklı | İki değeri eşitle (ör. 115200) |
| Kart görünmüyor, port yok | Yalnızca şarj kablosu ya da CH340/CP2102 sürücüsü eksik | Veri kablosu kullan, sürücüyü kur, pio device list ile kontrol et |
| Access is denied / Resource busy | Port başka bir programda açık | Arduino IDE seri monitörünü ve diğer terminalleri kapat |
| ESP32'de Failed to connect, Wrong boot mode | Kart indirme moduna geçmedi | BOOT tuşuna basılı tutarak yüklemeyi başlat |
| Pico'ya yükleme başlamıyor | Kart BOOTSEL modunda değil | BOOTSEL'e basılı tutarak tak, RPI-RP2 sürücüsünün göründüğünü kontrol et |
| Linux'ta Permission denied: /dev/ttyUSB0 | udev kuralı ya da kullanıcı izni yok | 99-platformio-udev.rules dosyasını kur, kullanıcını dialout grubuna ekle |
| Windows'ta derleme anlamsız yol hatalarıyla duruyor | Kullanıcı adında Türkçe karakter ya da boşluk | PLATFORMIO_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 sorunu | VS Code'u yeniden başlat, Output > PlatformIO günlüğünü incele |
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.
Bu yazıdan sonra yapabileceğin projeler
Tüm projeleri gör
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.

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.

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).

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.

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.

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.

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.

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.
Diğer yazılar
BlueGrays uygulaması
Bu devreyi telefonunda adım adım kur
Devre şeması, kod ve parça listesi tek ekranda. 500'den fazla Arduino, ESP32 ve Pico projesi seni bekliyor.
Telefonunla tara
Kamerayı koda tut; telefonunun uygulama mağazası açılır.
ya da mağazada aç

