ESP-IDF Linux Ubuntu Üzerinde VS Code ile Kurulum Rehberi

ESP32 mikroişlemcilerinin ESP IDF ile programlanması için gerekli kurulum aşamalarını detaylı bir şekilde anlatamaya çalıştım.

9/19/20252 min read

ESP-IDF Linux Ubuntu Üzerinde VS Code ile Kurulum Rehberi

ESP32 geliştirme serüvenine başlamanın en verimli yollarından biri ESP-IDF (Espressif IoT Development Framework) kullanmaktır. Ben Linux Ubuntu üzerinde çalışmayı tercih ediyorum ve geliştirmeyi VS Code üzerinden yapıyorum. Linux kurulum aşaması şu şekilde ilerliyor:

1. Ön Gereksinimler

Kuruluma başlamadan önce sisteminizin güncel olduğundan emin olun:

sudo apt update && sudo apt upgrade -y

Ardından gerekli paketleri yükleyelim:

sudo apt install git wget flex bison gperf python3 python3-pip \

python3-venv cmake ninja-build ccache libffi-dev libssl-dev dfu-util -y

Bu paketler ESP-IDF’in derleme sürecinde ihtiyaç duyduğu bağımlılıkları sağlar.

2. ESP-IDF İndirme ve Kurulum

ESP-IDF’i Espressif’in resmi GitHub deposundan klonlayabilirsiniz. Genellikle ~/esp dizini tercih edilir:

mkdir -p ~/esp

cd ~/esp

git clone -b v5.2 --recursive https://github.com/espressif/esp-idf.git

Burada v5.2 örnek olarak verilmiştir. En güncel kararlı sürümü tercih etmenizi öneririm.

ESP-IDF kurulum betiğini çalıştırın:

cd ~/esp/esp-idf

./install.sh all

Bu işlem, ESP32 ve türevleri için gerekli araçları indirip kuracaktır.

3. Ortam Değişkenlerini Ayarlama

ESP-IDF ile çalışırken her terminal açılışında ortam değişkenlerini yüklemek gerekir. Bunun için:

. $HOME/esp/esp-idf/export.sh

Bunu kalıcı hale getirmek için ~/.bashrc veya ~/.zshrc dosyanıza ekleyebilirsiniz:

echo '. $HOME/esp/esp-idf/export.sh' >> ~/.bashrc

4. VS Code Kurulumu

Ubuntu üzerinde VS Code’u kolayca yükleyebilirsiniz:

sudo snap install --classic code

Alternatif olarak .deb paketi indirip manuel kurulum da yapabilirsiniz.

5. VS Code Eklentileri

ESP32 geliştirmeyi kolaylaştırmak için şu eklentileri yüklemenizi tavsiye ederim:

  • Espressif IDF → Resmi ESP-IDF uzantısı

  • C/C++ → Kod tamamlama ve hata ayıklama için

  • Python → Betikler için destek

  • CMake Tools → Projelerin yapılandırılması için

VS Code içinde sol taraftaki Extensions bölümünden bu eklentileri aratıp yükleyebilirsiniz.

6. ESP-IDF’i VS Code ile Entegre Etme

  1. VS Code içinde Ctrl+Shift+P tuşlarına basın.

  2. "ESP-IDF: Configure ESP-IDF extension" komutunu aratıp çalıştırın.

  3. Daha önce klonladığınız ESP-IDF yolunu (~/esp/esp-idf) seçin.

  4. Python ortamını otomatik seçmesine izin verin.

Bu adımlar tamamlandıktan sonra VS Code içinde ESP32 projelerinizi oluşturabilir ve çalıştırabilirsiniz.

7. Test Projesi Çalıştırma

Kurulumun doğru çalıştığını test etmek için örnek bir proje açalım:

cd ~/esp

cp -r esp-idf/examples/get-started/hello_world .

cd hello_world

idf.py set-target esp32

idf.py build

idf.py -p /dev/ttyUSB0 flash monitor

Eğer her şey yolundaysa, seri monitörde şu çıktıyı görmelisiniz:

Hello world!

This is ESP32 chip with ...

Artık Ubuntu üzerinde ESP-IDF ve VS Code ile tam donanımlı bir geliştirme ortamına sahipsiniz. Buradan sonra yapabilecekleriniz sınırsız: Wi-Fi projeleri, Bluetooth uygulamaları, IoT cihazları ve daha fazlası…