Bu kapsamlı rehberimizde, gömülü yazılım geliştiricileri arasında oldukça popüler olan Thonny IDE yazılımını tanıyacak, kurulum ve yapılandırma adımlarını adım adım öğreneceğiz. Rehberin sonunda, MicroPython ve Thonny IDE kullanarak kart üzerindeki dahili LED’i nasıl yanıp söndüreceğinizi (blink) öğrenmiş olacaksınız.
ESP32 ve ESP8266 mikrodenetleyici kartlarınızı hafif ve kararlı MicroPython bellenimi (firmware) ile programlamak istiyorsanız, zengin hata ayıklama özellikleri sunan bir entegre geliştirme ortamı (IDE) kullanmak sürecinizi son derece hızlandırır.
ESP32 ve ESP8266 geliştirme süreçlerinde farklı editörleri test ettik ve Thonny IDE’nin yeni başlayanlar ile orta seviye geliştiriciler için en kararlı araçlardan biri olduğunu saptadık. Ara sıra arayüz kilitlenmeleri yaşansa da, yazılım arkasındaki aktif topluluk desteği sayesinde düzenli olarak güncellenmekte ve yeni donanım destekleri kazanmaktadır.
Thonny; Windows, macOS ve Linux gibi tüm popüler masaüstü işletim sistemleriyle tam uyumludur. Hatta tek kart bilgisayar ekosisteminin lideri olan Raspberry Pi OS (Raspbian) içerisinde varsayılan editör olarak kurulu gelir. Son derece minimalist bir yapıya sahip olduğundan kurulum süreci de oldukça zahmetsizdir.
Alternatif MicroPython editörleri ve kütüphane kullanımları hakkında hazırladığımız diğer içerikleri de incelemek isteyebilirsiniz:
- MicroPython Geliştiricileri İçin En İyi 5 Editör Seçimi
- uPyCraft IDE ile ESP32/ESP8266 OLED Ekran Kontrolü
Teknik Arka Plan: MicroPython, kısıtlı kaynaklara sahip mikrodenetleyiciler için optimize edilmiş bir Python 3 yorumlayıcısıdır. Temel dil özellikleri standart Python ile birebir uyuşurken aralarındaki tek temel fark, MicroPython’un megabaytlarca yer kaplayan standart masaüstü Python kütüphaneleri yerine sadece donanımsal yönetim ve veri haberleşmesi (Wi-Fi, Bluetooth) için özelleştirilmiş mikro kütüphaneler barındırmasıdır.
Thonny IDE Kurulum Adımları
Bu başlık altında Thonny IDE’nin Windows, macOS ve Linux işletim sistemlerindeki standart kurulum adımlarını paylaşıyoruz:
1. Windows İşletim Sistemine Kurulum
Thonny yazılımını Windows PC’nize kurmak için aşağıdaki adımları sırasıyla takip edin:
Adım 1: Resmi Thonny indirme sayfasına https://thonny.org adresinden erişin.
Adım 2: Sağ üst köşedeki indirme menüsünden güncel Windows sürümünü (.exe) bilgisayarınıza indirin:
Adım 3: İndirdiğiniz kurulum executable dosyasını çift tıklayarak çalıştırın:
Adım 4: Kurulum sihirbazındaki adımları “Next” butonuna basarak hızlıca geçin ve kurulumu tamamlayın:
Adım 5: Kurulum bittiğinde masaüstündeki veya başlat menüsündeki Thonny simgesine tıklayarak programı başlatın:
2. macOS İşletim Sistemine Kurulum
Thonny açık kaynaklı bir yazılımdır ve Apple App Store dışındaki sunuculardan indirildiği için macOS işletim sisteminin güvenlik duvarı (bilinmeyen geliştirici) uyarısıyla karşılaşabilirsiniz. macOS sisteminde üçüncü parti yazılımların çalışabilmesi için öncelikle şu güvenlik izinlerini yapılandırmalısınız:
Adım 1: Mac bilgisayarınızdan Sistem Tercihleri (System Preferences…) menüsünü açın:
Adım 2: Güvenlik ve Gizlilik (Security & Privacy) sekmesine gidin:
Adım 3: Ayarları değiştirebilmek için sol alt köşede yer alan kilit simgesine tıklayın:
Adım 4: Mac şifrenizi girerek kilidi açın (Unlock):
Adım 5: “Şuradan indirilen uygulamalara izin ver (Allow apps downloaded from)” seçeneğini Her Yerde (Anywhere) olarak işaretleyip pencereyi kapatın:
Güvenlik ayarlarını tamamladıktan sonra kuruluma geçebiliriz:
- https://thonny.org adresinden macOS uyumlu .dmg kurulum imajını indirin.
- İndirilen .dmg dosyasını çift tıklayarak açın.
- Açılan penceredeki Thonny logosunu sürükleyerek Uygulamalar (Applications) veya Masaüstü dizinine bırakın:
Uygulamalar klasörüne eklenen Thonny simgesine çift tıklayarak programı başlatabilirsiniz:
3. Linux Dağıtımlarına Kurulum
Linux sistemlerde kurulum adımları kullandığınız dağıtım paket yöneticisine göre değişiklik gösterir. Kuruluma başlamadan önce sistemde grafik arayüz çizim kütüphanelerinin (Tkinter) ve Python pip3 paket yöneticisinin kurulu olduğundan emin olmalısınız.
Debian/Ubuntu/Mint Sistemlerde Bağımlılıkların Kurulması:
sudo apt update && sudo apt install python3 python3-pip python3-tk -y
Bağımlılıklar kurulduktan sonra işletim sisteminize göre şu kurulum komutlarını çalıştırabilirsiniz:
- Ubuntu ve Debian Sistemlerde Kolay Kurulum Scripti:
bash <(wget -O - https://thonny.org/installer-for-linux)
- Evrensel Python Pip Yöneticisi ile Kurulum:
sudo pip3 install thonny
- Fedora Dağıtımlarında Dnf ile Kurulum:
sudo dnf install thonny
- Raspberry Pi OS (Raspbian) Sistemlerde Kurulum:
sudo apt install python3-thonny
Kurulum bittikten sonra arama satırına “Thonny” yazarak veya doğrudan terminale thonny komutunu girerek yazılım arayüzüne erişebilirsiniz:
MicroPython Bellenimini Flaşlama Aşamaları
ESP32 ve ESP8266 geliştirme kartları fabrikadan MicroPython bellenimi yüklü olarak gelmez. Karta yazdığımız Python kodlarını yorumlatabilmek için öncelikle MicroPython .bin dosyasını karta flaşlamamız gerekir. Thonny IDE, bu flaşlama işlemini harici programlara gerek kalmadan kendi içerisinde çözebilen yerleşik bir araca sahiptir.
1. Güncel MicroPython .BIN Dosyasının İndirilmesi
Resmi indirme portalı olan https://micropython.org/download/ adresine gidin. Kart modelinize göre ilgili indirme sayfasına yönlenin:
Açılan sayfanın alt kısmındaki “Releases” (Sürümler) listesinden en son kararlı derlemeyi (stable) bilgisayarınıza indirin. Kararsız çalışan ve hata barındıran “Nightly” (gecelik) derlemeleri indirmekten kaçının:
2. Thonny Arayüzü ile Bellenimi Karta Yazdırmak
Bellenimi karta yazmak için sırasıyla şu adımları uygulayın:
Adım 1: Kartınızı kaliteli bir USB veri kablosuyla bilgisayara bağlayın.
Adım 2: Thonny programında üst menüden Tools > Options adımlarını izleyin ve açılan pencereden Interpreter (Yorumlayıcı) sekmesini seçin.
Adım 3: Kullandığınız kart tipini (Örn: MicroPython (ESP32)) ve kartın bilgisayara bağlı olduğu aktif COM portunu belirleyin. Ardından sağ alt köşedeki Install or update firmware bağlantısına tıklayın:
Adım 4: COM portunu tekrar seçip Browse butonu yardımıyla indirdiğiniz .bin uzantılı MicroPython dosyasını gösterin. Gerekli ayarları görseldeki gibi yapılandırdıktan sonra Install butonuna basarak flaşlama işlemini başlatın:
Flaşlama ilerleme çubuğu %100 seviyesine ulaştığında kartınız Python komutlarını yürütmeye hazır hale gelecektir.
Kurulumun REPL Üzerinden Test Edilmesi
Bağlantıyı doğrulamak için Thonny arayüzünde Tools > Options > Interpreter sekmesine gidin. Doğru donanım ve COM portunun seçili olduğundan emin olun:
Seçim yapıldıktan sonra alt kısımdaki Shell (Terminal) ekranında MicroPython sürüm bilgisi ve komut istemi olan >>> sembolü belirecektir. Buraya anlık durum sorgulaması yapmak için help() yazıp Enter tuşuna basın:
Karttan anlamlı bir yardım çıktısı aldıysanız bağlantı kusursuz demektir. Şimdi REPL üzerinden anlık Python komutları göndererek kartın yerleşik LED’ini kontrol edelim. Shell ekranına şu komutları sırasıyla yazın:
>>> from machine import Pin >>> Pin(2, Pin.OUT).value(1)
Önemli Teknik Kısıt: ESP8266 geliştirme kartlarındaki yerleşik LED ters mantık (active-low) prensibiyle çalışır. Yani LED’i yakmak için value(1) yerine value(0) komutunu göndermeniz gerekir:
>>> Pin(2, Pin.OUT).value(0)
Komuttan hemen sonra kart üzerindeki mavi durum LED’inin aktif hale geldiğini doğrulayabilirsiniz:
Thonny IDE Arayüz Yapısı ve Alanlar
Thonny IDE penceresi temelde iki fonksiyonel çalışma alanına ayrılmıştır: Editör Panel ve Terminal (Shell) Panel:
- Editör Paneli: Çok sekmeli yapısıyla Python script kodlarımızı yazdığımız ana çalışma alanıdır.
- Shell Paneli: Karta anlık komut gönderdiğimiz ve karttan gelen seri veri loglarını (hatalar, sensör çıktıları vb.) izlediğimiz terminal alanıdır.
Gelişmiş hata ayıklama işlemlerini yürütebilmek için üst menüdeki View seçeneği altından “Variables” (Değişkenler) veya “Files” (Dosyalar) gibi yan sekmeleri de arayüze ekleyebilirsiniz:
İlk Python Dosyasının Oluşturulması ve Yüklenmesi
Kartın bağımsız olarak çalışabilmesi için asenkron LED blink uygulamasını bir Python dosyası olarak kartın belleğine kaydedeceğiz.
1. main.py Dosyasının Oluşturulması
Thonny editörünü açtığınızda adsız (untitled) boş bir sekme gelir. Kaydet (Save) butonuna tıklayıp hedef konum olarak “This Computer” (Bu Bilgisayar) seçeneğini seçin. Dosya adını harfi harfine küçük harflerle main.py olarak adlandırıp bilgisayarınızdaki proje klasörünüze kaydedin. Kodun otomatik başlayabilmesi için dosya adının main.py olması donanımsal bir zorunluluktur:
Kaydettikten sonra aşağıdaki asenkron LED kontrol kodunu editöre kopyalayıp yapıştırın:
from machine import Pin
from time import sleep
led = Pin(2, Pin.OUT)
while True:
led.value(not led.value())
sleep(0.5)
2. Dosyanın Kart Belleğine Yazılması
Adım 1: Thonny arayüzünden File > Save as… menüsüne tıklayın:
Adım 2: Açılan seçenek penceresinden MicroPython device (MicroPython Cihazı) seçimini yapın:
Adım 3: Dosya adını main.py olarak yazıp onaylayın. Cihaz dosya sisteminde flaşlama esnasında varsayılan olarak oluşturulan boot.py dosyasının da yer aldığını göreceksiniz:
Adım 4: Kaydetme bittikten sonra kart üzerindeki fiziksel RST / EN reset butonuna bir kez basın. Kart yeniden başladığı andan itibaren yerleşik mavi LED saniyede iki kez asenkron olarak yanıp sönmeye başlayacaktır:
Thonny IDE Sorun Giderme Kılavuzu
Geliştirme süreçlerinde karşılaşılan olası hataları ve yazılımsal çözümlerini sizler için bir araya getirdik:
Hata 1: COM Portu Açma ve Bağlantı Hataları
Unable to connect to COM4
Error: could not open port 'COM4': FileNotFoundErrorÇözüm: USB kablosunu çekip farklı bir fiziksel porta takın. COM port adının başka bir yazılım (Örn: Arduino IDE Seri Monitörü, 3D Yazıcı Arayüzü vb.) tarafından meşgul edilmediğinden emin olun. Gerekirse tüm arka plan uygulamalarını kapatıp Thonny’yi yeniden başlatın.
Hata 2: “Stop/Restart backend” Butonuna Basıldığında Kilitlenme
Çözüm: Kırmızı renkli stop butonuna arka arkaya çok hızlı basmak kartın REPL bağlantısını koparır ve yazılımı çökertebilir. Butona bastıktan sonra arka planda kartın reset sinyalini yakalayabilmesi için en az 2-3 saniye beklemelisiniz.
Hata 3: Donanımsal Brownout Korumasının Tetiklenmesi
Brownout detector was triggeredÇözüm: Kart işlemcisine gelen voltaj seviyesinin koruma eşiğinin altına düştüğünü gösterir. Çözüm için kalitesiz ve çok uzun kablolardan kaçının, bilgisayarın USB portu yerine harici beslemeli USB hubları kullanın veya kartın lehim petlerindeki temassızlıkları kontrol edin.
Hata 4: Debug (Hata Ayıklama) Araçlarının Aktif Olmaması (Gri Görünmesi)
Açıklama: Thonny IDE üzerindeki satır bazlı grafik hata ayıklama (debug) araçları MicroPython donanım yorumlayıcıları için teknik olarak desteklenmemektedir. Bu araçlar sadece yerel masaüstü Python projelerinde aktif olur, donanım programlarken gri (pasif) görünmesi beklenen standart bir durumdur.
Genel Özet
Bu rehberimizde, gömülü yazılım dünyasının en popüler ve esnek editörlerinden biri olan Thonny IDE’nin kurulumunu, MicroPython bellenim flaşlama adımlarını ve ilk dosya yazma protokollerini pratik bir LED kontrol devresiyle birlikte inceledik. Thonny’nin sunduğu temiz REPL arayüzü ve entegre dosya sistemi, MicroPython projeleriniz boyunca en kararlı yardımcınız olacaktır.
Yorum yapma özelliği, forum tarafından gelen istek sebebiyle kapatılmıştır. Lütfen tartışmalar ve sorularınız için topluluk forumumuza katılın.