1. Giriş
HA'nın iHost üzerinde artık resmi olarak kullanılabilir olduğunu duyurmaktan heyecan duyuyoruz! Bu proje, tam Home Assistant Operating System sunuyor SONOFF iHost platform, kullanıcılara iHost donanımında Home Assistant'ı yerel olarak çalıştırmak için güçlü yeni bir yol sunuyor.
Gerçek topluluk ihtiyaçları ve kullanıcı odaklı teknik keşiflerden doğan bu girişim, Home Assistant ve SONOFF kullanıcı topluluklarının yaratıcılığını ve tutkusunu yansıtıyor. Birçok iHost kullanıcısı, donanım avantajlarından yararlanmak için Home Assistant Core'u Docker'da yerel sistemde çalıştırıyor. Bazı ileri düzey kullanıcılar ise daha da ileri giderek kendi derlemelerini değiştirip derleyerek tam Home Assistant OS'u iHost üzerinde yerel olarak çalıştırıyor.
Bu rehberde, Home Assistant'ı kolayca nasıl çalıştıracağınızı göstereceğim SONOFF iHostİki flaşlama yöntemini göstereceğiz: kullanarak Balena Etcher veya Raspberry Pi ImagerHadi başlayalım!
Detaylı video eğitimini burada izleyin:
2. Önkoşullar
- Bir SONOFF iHost gereklidir.
- Emin olunr iHost sistem sürümü 2.5.1 veya daha yenisi olmalıdır.
- Bir Uygulama Sınıfı 2 (A2) kart, minimum 32GB kapasite ile, özellikle küçük okuma ve yazma işlemlerinde daha iyi performans için önerilir.
- iHost 32-bit işlemciye dayandığı için, bazı Home Assistant özellikleri uyumlu olmayabilir.


3. Micro SD Kartın Hazırlanması
Gerekli Donanım
- Daha iyi performans için, özellikle küçük okuma ve yazma işlemlerinde, minimum 32GB kapasiteli bir (Uygulama Sınıfı 2) (A2) kart önerilir. SanDisk, Kingston veya Samsung markalarından bir TF kart kullanmanızı öneririz. Testlerimizde dahili olarak bu marka kartları kullandık.
- Bir SD kart okuyucu: Dizüstü bilgisayarınızda yerleşik bir SD kart okuyucu yoksa, herhangi bir standart USB kart okuyucu işinizi görecektir.
Gerekli Yazılım
- Micro SD kart yazma aracı: Balena Etcher veya Raspberry Pi Imagervb.
- HA over iHost için ilgili görüntüye GitHub projesinden ulaşın: iHost-Open-Source-Project.

4. HA Over iHost Görüntüsünü Micro SD Karta Yazma
-
ile flaşla Balena Etcher
- Micro SD kartı kart okuyucuya takın ve bilgisayarınıza bağlayın.
- İndir ve çalıştır Etcher.

- Tıklayın Dosyadan flaşla, sonra th seçine HA over iHost görüntü bilgisayarınıza indirilen dosya.

2. Tıklayın Hedef seç, ardından takmış olduğunuz Micro SD kartı seçin.
*Not: Lütfen doğru sürücüyü seçtiğinizden emin olun!

3. Tıklayın Flaşla! flaşlamaya başlamak için the HA over iHost görüntü Micro SD karta.
*Not: Flaşlama işlemi sırasında SD kartı çıkarmayın veya kullanmayın.
-
ile flaşla Raspberry Pi Imager
- SD kartı kart okuyucuya takın ve bilgisayarınıza bağlayın.
- Raspberry Pi Imager'ı indirin ve çalıştırın.

- Tıklayın CIHAZ SEÇİN > Filtre yok.

- Tıklayın İŞLETİM SİSTEMİ SEÇİN > Özel kullan, ardından bilgisayarınıza indirdiğiniz iHost üzerinden HA imaj dosyasını seçin.


-
Tıklayın DEPOLAMA SEÇİN, ardından takmış olduğunuz Micro SD kartı seçin.
*Not: Lütfen doğru Micro SD kartı seçtiğinizden emin olun!

- Tıklayın İLERİ > HAYIR, AYARLARI TEMİZLE, ve SD karttaki tüm ayarları silmeyi onaylayın.



-
iHost üzerinden HA imajını takılı SD karta yazdırmaya başlayın.
*Not: Yazdırma işlemi sırasında SD kartla (örneğin, çıkarma veya dosya değiştirme) etkileşimde bulunmayın.


5. Başlatma iHos üzerinde Home Assistant İşletim Sistemit
Zigbee Cihazlarını Aktar (İsteğe Bağlı)
Zigbee cihaz aktarımı gerekli değilse, bir sonraki bölüme geçin.
iHost, yedekleme dosyasını indirerek iHost’un Zigbee cihaz verilerini Home Assistant’a aktarmanıza ve dışa aktarmanıza olanak tanırZHA/Zigbee2MQTT ile entegre edilmiş Home Assistant'ta geri yükleme. Sadece Zigbee ağı ve cihaz durumu taşınır. Zamanlayıcılar, gruplar, sahneler ve cihaz adları dahil değildir. Öğrenmek için buraya tıklayın: Nasıl geri yüklenir?
Başlati üzerinde Home Assistant İşletim Sistemi çalıştırıyorAna Bilgisayar
- Önceden flaşlanmış Micro SD kartı iHost SD Kart yuvasına takın.
- iHost'u bir ağ kablosuna bağlayın ve açın.
- Güç verildikten sonra 5 saniye içinde, iHost'un üstündeki Sessiz düğmesine (♪) tekrar tekrar basın, ta ki LED Yan Şerit MAVI nefes alan ışık desenine girene kadar. Bu, sistemin SD karta flaşlanmış Home Assistant OS'ye geçiş yaptığını gösterir.

-
LED göstergesi MAVI nefes alan ışık deseni, yeni Home Assistant web arayüzünü önümüzdeki 10 dakika içinde kullanabilirsiniz. İlk başlatma daha uzun sürebilir.
Bir masaüstü tarayıcıda, şunu girin homeassistant.local:8123.
*Not: Daha eski bir Windows sürümü kullanıyorsanız veya daha katı ağ yapılandırmalarınız varsa, Home Assistant'a aşağıdaki URL'lerden biriyle erişmeniz gerekebilir:
http://homeassistant:8123 veya http://X.X.X.X:8123 (X.X.X.X yerine Raspberry Pi'nizin IP adresini yazın)
Başlatma Hatalarını Giderme
- EğerLED Yan Şerit yapmazgöstermez MAVI nefes alan ışık desenirn ama KIRMIZI nefes alan ışık deseni sonrası5 saniye boyunca güç verildikten sonra veya düğmeye birkaç kez basıldıktan sonra, başlatma başarısız oldu. Yeniden başlatmayı deneyinHome Assistant İşletim Sistemi şu şekildews:
- iHost'u güç döngüsüne alın;
- Düğmeye basmaya gerek yok.
- iHost yeniden başlatmaya çalışıyorHome Assistant İşletim Sistemi değil frSD kartından.

- Yukarıdaki işlemlerden sonra 10 dakika içinde Home Assistant web arayüzüne erişemiyorsanız, bu yanlış flaşlanmış bir imajdan kaynaklanıyor olabilir. SD kartı yeniden flaşlamayı veya yenisini kullanmayı deneyin.
6. Geri DönüşeWeLink CUBE'ye
- Geri dönmek içineWeLink CUBE'ye, faşağıdaki adımları izleyin:
- iHost'u güç döngüsüne alın.
- Sessize alma düğmesine (♪) 3 saniye içinde tekrar tekrar tek dokunun.
- LED Yan Şerit wbir KIRMIZI sistemin eWeLink CUBE'ye geri geçtiğini doğrulayan akan ışık deseni.

*Notlar:
- Birden fazla cihaz çalışıyorsaHome Assistant İşletim Sistemi çalıştırılıyor ağınızda, [homeassistant.local] ana bilgisayar adı doğru çözümlenmeyebilir. Doğru IP adresini yönlendiricinizin yönetim arayüzü üzerinden veya mDNS servisi [_home-assistant._tcp.] yayınlayarak keşfedebilirsiniz.
- Son başlatma SD Karttan yapıldıysa ve kart eWeLink CUBE’a geçiş yapılmadan çıkarılırsa,LED Yan Şerit bir göster KIRMIZI nefes alma ışık deseni, iHost’ta Home Assistant İşletim Sistemi’nin başlatılamadığını gösterir.
7. Donanım Kaynakları
AçıkHome Assistant İşletim Sistemi başarıylaiHost üzerinde başarıyla çalışıyorsa, aşağıdaki desteklenen yerleşik donanımları kullanabilirsiniz:
Düğme & LED gösterge
iHost Donanım Kontrol eklentisi, Home Assistant’ta iHost’un düğmelerini ve LED göstergelerini kontrol etmeyi sağlar. Bunları cihazlar ve ayrı varlıklar olarak kaydeder, böylece kullanıcılar daha esnek donanım etkileşimleri için otomasyonlarda kullanabilir.(örneğin, iHost’u kapatmak için güç düğmesi varlığını tetiklemek). Detaylar için, bakınız iHost Donanım Kontrol eklentisi kılavuz.
Bluetooth
- Çipset Modeli: RTL8723DS
- Yol: Ayarlar > Cihazlar & Hizmetler > Entegrasyonlar > Bluetooth
- Keşif: Otomatik

Wi-Fi
- Çipset Modeli: RTL8723DS
- Yol: Ayarlar > Sistem > Ağ > Ağ Arayüzlerini Yapılandır > WLAN0
- Keşif: Otomatik

Zigbee Koordinatörü
- Çipset Modeli: 00.21.05.0009 SOC EFR32MG21A020F768IM32-B SiliconLabs QFN32-4*4 (RAM 64kB,Flash 768kB)
- Yol: Ayarlar > Sistem > Donanım > Tüm Donanımlar > /dev/ttyS4
- Keşif: Zigbee Home Automation (ZHA) veya Zigbee2MQTT üzerinden

7. CoreBox İmajı Hakkında
CoreBox, hızlı kurulum için tasarlanmış yeni bir iHost üzerinde HA imajıdır ve en son HA Core sürümü (2025.05.03) önceden entegre edilmiştir.
CoreBox ile cihazın GitHub'dan HA Core indirmesini beklemenize artık gerek yok. Bunun yerine, yerleşik HA Core sürümünden doğrudan başlatabilir, 3 dakika veya daha kısa sürede açılış sağlayabilirsiniz. CoreBox, internet bağlantısına bağımlılığı ortadan kaldırır ve çevrimdışı ortamlarda bile kolay kurulum sağlar. Sistem çalışmaya başladıktan sonra yine de daha yeni HA Core sürümlerine güncelleme yapabilirsiniz.
Neden CoreBox?
Geri bildirimlerinizi yakından dinledik. Birçok kullanıcı, iHost üzerinden HA'nın orijinal kurulum sürecinin, özellikle ilk HA Core indirmesi sırasında kötü veya kararsız internet nedeniyle sık sık başarısız olduğunu bildirdi. Bu sadece hayal kırıklığı yaratmakla kalmadı, aynı zamanda birçok ilk kez kullanıcıyı devam etmekten caydırdı.
Çevrimiçi desteğimiz olmasına rağmen, ağ sorunlarını gidermek ve kurulum sürecinde ilerlemek genellikle hem kullanıcılar hem de ekibimiz için beklenenden daha uzun sürüyordu.
Bu yüzden CoreBox'u — kullanıcı perspektifinden tasarlanmış bir çözümü — geliştirdik.
CoreBox ile şunları elde edersiniz:
- Hızlı ve güvenilir bir kurulum deneyimi
- Ağ sorunları nedeniyle gecikme veya başarısız kurulumlar artık yok
- Home Assistant’ın sorunsuz çalışacağından emin olun — her zaman, her yerde
Dahili HA Core’u güncelleyebilir miyim?
Evet! Dahili sürüm (2025.5.3) ile HA başlatıldığında, Home Assistant daha yeni bir sürüm olup olmadığını algılar. Ayarlar > Sistem > Güncellemeler sayfasından HA Core’u her zamanki gibi güncelleyebilirsiniz — normal bir kurulum gibi.
9. Desteklenen Eklentiler
-
Şimdi mevcut:
-
iHost Donanım Kontrol Eklentisi
Fiziksel düğmeleri, RGB göstergeleri ve ışık şeritlerini doğrudan Home Assistant üzerinden kontrol edin.
Donanım girişlerini otomasyonlara eşleyerek fiziksel ve sanal ortamlar arasında sorunsuz etkileşim sağlayın.
Eğitim için buraya tıklayabilirsiniz. -
MG21 Flashing Eklentisi : MG21 yazılımını güncelleyin, Zigbee veya Thread yığınlarını flaşlama desteği isteğe bağlıdır.
Eğitim için buraya tıklayabilirsiniz. -
Node-Red : Bu eklenti, linux/arm/v7 mimarisini desteklemek için özel olarak tasarlanmış bağımsız paketlenmiş bir Node-RED sürümüdür. SONOFF tarafından paketlenmiş ve iHost kullanıcıları için özel olarak hazırlanmıştır.
Eğitim için buraya tıklayabilirsiniz. -
Matter Bridge Eklentisi : Yerel cihazları Matter ekosistemine köprüleyerek platformlar arası entegrasyon sağlar.
Eğitim için buraya tıklayabilirsiniz.
-
10. Teşekkür
Bu proje, Darkxst’in üzerine geliştirilmiş türev bir çalışmadır [ha-operating-system] GitHub projesi. Orijinal yazara temel katkıları için içtenlikle teşekkür ederiz.






3 yorum
Bertrand
Good project
Mia Ma
回复鄭先生: 会在,HAOS是装在新的SD卡上,不会影响原本的CUBE系统。
鄭先生
請問已安裝CUBE使用一段時間,後來安裝HAOS使用一陣子不習慣
如果切換回CUBE,原本的CUBE資料還會在嗎?
HAOS資料還回在嗎?
想切回CUBE試試看哪個適合我使用,但擔心要重新設定很麻煩很困擾
Yorum yazın
Tüm yorumlar yayınlanmadan önce incelenir.
Bu site hCaptcha ile korunuyor. Ayrıca bu site için hCaptcha Gizlilik Politikası ve Hizmet Şartları geçerlidir.