ESP8266 NodeMCU ile HomeKit entegrasyonu, IoT (Internet of Things – Nesnelerin İnterneti) kavramını ve akıllı ev otomasyonunu günlük hayatımıza düşük bütçeyle taşımanın en pratik yollarından biridir. Piyasadaki hazır satılan resmi HomeKit destekli akıllı prizler ve anahtarlar genellikle yüksek fiyat etiketlerine sahiptir ve bazı modeller sadece belirli ekosistemlerle sınırlı kalmaktadır. NodeMCU ve açık kaynaklı kütüphaneler sayesinde, kendi akıllı ev cihazlarımızı dakikalar içinde üretebiliriz.
GitHub üzerinde Mixiaoxiao isimli geliştiricinin yayınladığı Arduino-HomeKit-ESP8266 kütüphanesi, NodeMCU veya diğer ESP8266 tabanlı Wi-Fi geliştirme kartlarınızı doğrudan Apple HomeKit protokolüne entegre etmenizi sağlar. İnternetteki birçok alternatif çözüm aracı olarak bir “Homebridge” sunucusu (Raspberry Pi vb.) çalıştırmanızı gerektirirken, bu kütüphane herhangi bir aracı sunucuya ihtiyaç duymadan doğrudan yerel ağ üzerinden Apple cihazlarınızla haberleşir. Arada bir köprü (Homebridge) sunucusu olmadığı için, oluşturduğumuz bu IoT cihazı varsayılan olarak sadece yerel ağınızda (aynı Wi-Fi ağına bağlıyken) çalışacaktır.
Tamamen açık kaynak kodlu olan bu kütüphane ile birlikte gelen örnek şablonları kendi projelerinize göre kolayca özelleştirebilirsiniz. Biz bu rehberde en temel ve kararlı çalışan şablonlardan biri olan “Switch” (Anahtar/Röle) kodunu temel alacağız. Ancak kütüphanenin örnek klasöründe termometre, fan, lamba gibi farklı sensör ve aktüatör türlerine uygun hazır şablonlar da mevcuttur.
NodeMCU (ESP8266) geliştirme kartını programlamak için popüler yazılım geliştirme aracı olan Arduino IDE’yi kullanacağız. Bilgisayarınızdaki Arduino IDE üzerinde ESP8266 kart desteği yüklü değilse, yazılıma başlamadan önce NodeMCU Arduino IDE Desteği ve Kurulum Rehberi yazımızı inceleyerek gerekli tanımlamaları yapabilirsiniz.
Gerekli Kütüphane Kurulumu
Yukarıda bağlantısını verdiğimiz GitHub kütüphanesini ZIP formatında bilgisayarınıza indirin. Ardından Arduino IDE üzerinde Taslak > library Ekle > .ZIP Kütüphanesi Ekle adımlarını takip ederek kurun. Eğer kütüphane ekleme adımlarında sorun yaşıyorsanız Arduino Kütüphane Ekleme Rehberi yazımızdan yardım alabilirsiniz.

Kütüphane başarıyla kurulduktan sonra sırasıyla Dosya > Örnekler > Arduino-HomeKit-ESP8266 > Example02_Switch örneğini açın. Karşınıza eş zamanlı olarak düzenlenmesi gereken 3 adet sekme (dosya) gelecektir:
1. Example02_Switch.ino (Ana Kod Dosyası)
Bu ana kod dosyasında, donanımsal olarak kontrol etmek istediğiniz röle veya LED’in bağlı olduğu pini ve başlangıç durumlarını (ilk açılışta açık/kapalı) tanımlayabilirsiniz.
2. wifi_info.h (Kablosuz Ağ Bilgileri)
Bu sekmede, akıllı cihazınızın bağlanacağı yerel Wi-Fi ağınızın adını (SSID) ve şifresini eksiksiz olarak girmeniz gerekmektedir:
3. my_accessory.c (HomeKit Aksesuar Tanımlamaları)
Bu dosya, Apple HomeKit protokolüyle doğrudan haberleşmeyi sağlayan parametreleri barındırır. Aksesuarın eşleşme şifresi (setup code) varsayılan olarak 111-11-111 olarak tanımlanmıştır. Apple Ev (Home) uygulaması üzerinden cihaz eklerken bu şifreyi girmeniz istenir. Cihaz ekleme esnasında, ürünün resmi MFi sertifikalı bir Apple aksesuarı olmadığına dair bir uyarı alırsınız; bu uyarıyı onaylayarak kuruluma devam edebilirsiniz.
Donanım Bağlantısı ve Devre Şeması
Varsayılan Example02_Switch dosyasında tanımlanan kontrol pini 2 yani NodeMCU üzerindeki D4 pimidir (yerleşik mavi LED de bu pine bağlıdır). Bu pine bağlayacağınız bir röle kartı veya LED modülünü doğrudan iOS cihazınızdaki Ev uygulaması üzerinden uzaktan tetikleyebilirsiniz.

Yazılımın Yüklenmesi ve İlk Eşleştirme
Eğer görselde gösterilen standart NodeMCU v1.0 (ESP-12E tabanlı) kartını kullanıyorsanız, Arduino IDE üzerindeki Araçlar > Kart menüsünden doğru modeli ve bağlı olduğu Port’u seçtiğinizden emin olun:

Seçimleri tamamladıktan sonra “Yükle (Upload)” butonuna basarak kodu karta yükleyin. Yükleme tamamlandıktan sonra kart üzerindeki yerleşik RST (Reset) butonuna basarak mikrodenetleyiciyi yeniden başlatın.

Kritik Ağ ve Eşleşme Notları (Uzman Önerisi): NodeMCU ağa bağlandığında, iOS cihazınız ile ESP8266 kartının kesinlikle aynı Wi-Fi ağında (ve özellikle 2.4 GHz bandında, çünkü ESP8266 5 GHz bandını desteklemez) bağlı olduğundan emin olun. Ayrıca yerel modem/router ayarlarınızda mDNS (Multicast) protokolünün aktif olması gerekmektedir. Eğer mDNS kapalıysa veya cihazlar farklı frekans bantlarındaysa Apple Ev uygulaması cihazı bulamayacak ve “Aksesuar Bulunamadı” hatası verecektir. Her şey düzgün yapılandırıldığında Ev uygulamasından ‘+’ simgesine basıp “Aksesuar Ekle” dedikten sonra kamerayı kullanmadan elle giriş seçeneğini seçerek 111-11-111 şifresiyle kurulumu saniyeler içinde tamamlayabilirsiniz.
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.
