Home Assistant entegrasyonu

Car 2 Home, aracınızı akıllı evinizde yalnızca bir veri kaynağı değil, gerçek bir katılımcı hâline getiren tam donanımlı bir Home Assistant entegrasyonuyla gelir. İster HACS'tan kurulan ve uygulamayla doğrudan WebSocket üzerinden konuşan yerel bir Home Assistant bileşeni olarak, ister standart bir MQTT istemcisi olarak çalışır. İki yol da destekleniyor; kurulumunuza hangisi uyuyorsa onu seçin.

Yerel yolu özel kılan, sensör yayınlamakla yetinmemesi. Aracınız Home Assistant olay yoluna olaylar yayınlar: yolculuk başladı, yolculuk bitti, arıza kodu bulundu, sert hızlanma, ECU çevrim içi. Yani eşiği geçen sayılara değil, anlara tepki veren otomasyonlar yazabilirsiniz.

İki yol, aynı sonuç

Home Assistant entegrasyonu

HACS üzerinden kurulan özel bir Home Assistant entegrasyonu. Home Assistant altı haneli bir eşleştirme kodu üretir, siz de bunu uygulamaya girersiniz. Yönetilecek belirteç yok, kurulacak aracı yok. İletişim WebSocket üzerinden çift yönlüdür: Home Assistant, uygulama aracılığıyla araçtan gelen her sensörü ve her olayı alır; uygulama bağlı olduğu sürece eşitleme kipi gibi ayarları değiştirebilir ve başka işlemleri tetikleyebilir.

MQTT (herhangi bir aracı)

Zaten Mosquitto, EMQX, HiveMQ ya da başka bir aracı çalıştırıyorsanız, ya da verilerin Home Assistant'a veya Node-RED, openHAB, ioBroker gibi araçlara akmasını istiyorsanız, Car 2 Home aynı sensörleri Home Assistant için tam MQTT otomatik keşfiyle yayınlar. Fark şu: MQTT yolu olayları değil, sürekli durumu taşır. trip_started ya da dtc_found gibi şeyler yalnızca yerel entegrasyonda vardır.

Nasıl kurulur

1. 1. HACS ile kurun

   Home Assistant'ta HACS'ı açın, entegrasyon listesinden Car 2 Home'u ekleyin ve Home Assistant'ı yeniden başlatın. (HACS'ınız yoksa önce hacs.xyz üzerinden kurun.)

2. 2. Entegrasyonu ekleyin

   Home Assistant'ta Ayarlar → Cihazlar ve Servisler → Entegrasyon Ekle yolunu izleyin ve "Car 2 Home" araması yapın. Home Assistant bir eşleştirme kodu üretecek.

3. 3. Altı haneli kodla eşleştirin

   Uygulamada Ayarlar → Home Assistant → Entegrasyon bölümüne herkese açık Home Assistant adresinizi ve eşleştirme kodunu girin, işte bu kadar.

4. 4. Bir eşitleme kipi seçin

   "Çevrim içi" kipi, siz araç kullanırken telemetriyi gerçek zamanlı aktarır. "Yalnızca Wi-Fi" kipi ise siz dışarıdayken verileri uygulamada biriktirir ve telefonunuz bir Wi-Fi ağına bağlandığı anda gönderir: Home Assistant için herkese açık bir adresiniz yoksa ya da mobil veriden tasarruf etmek istiyorsanız işinize yarar.

Neler elde edersiniz

Garajınızdaki her araç, Home Assistant'ta kendi varlık kümesine sahip bir cihaz olur. Adlar car2home_{brand}_{model}_{sensor} kalıbını izler ve araca bir takma ad verdiyseniz o da araya girer; böylece birden fazla araç asla karışmaz. Varlıklar Home Assistant'ın RestoreSensor davranışını kullanır: yeniden başlatmalar boyunca bilinen son değerlerini korurlar ve yalnızca motor kapandı diye kullanılamaz duruma düşmezler.

• Standart OBD-II sensörleri: hız, devir, soğutma suyu, yakıt seviyesi, gaz kelebeği konumu, lambda ve aracınızın desteklediği SAE J1979 kataloğunun geri kalanı.
• Üreticiye ve modele özel sensörler: markaya ve modele göre değişen genişletilmiş PID'ler, otomatik olarak keşfedilir.
• Hesaplanan sensörler: anlık yakıt debisi, hareketli ortalama tüketim (10, 50 ve 100 km pencereleri), tekerlekteki güç, tahmini menzil, yolculuk mesafesi.
• Konum: yükseklik, doğruluk ve araç için bir device_tracker varlığı.
• TPMS: tekerlek başına basınç, sıcaklık, sensör kimliği.
• Teşhis durumu: motor arıza lambası açık ya da kapalı, arıza kodu sayısı, donmuş kare, adaptör gerilimi, ECU çevrim içi ya da çevrim dışı, Home Assistant veya MQTT bağlantısının durumu.
• Sürüş davranışı: canlı güvenlik ve ekonomi puanı, sert olay sayaçları, aylık geçmiş.

Home Assistant olay yolundaki olaylar

Yerel entegrasyonu ayıran şey bunlar. Otomasyonlarınız durum sorgulamak yerine ayrık anları dinleyebilir.

• car2home_trip_started: yolculuk başladığı anda tetiklenir (motor çalıştı artı hareket). Yük, araç kimliğini ve başlangıç konumunu içerir.
• car2home_trip_ended: yolculuk bittiğinde, tam bir özetle tetiklenir: mesafe, süre, ortalama ve azami hız, harcanan yakıt, park adresi.
• car2home_dtc_found: bir teşhis taraması bitti ve kod buldu. Yük, tarama kipini ve onaylanmış, bekleyen, kalıcı kod listelerini taşır.
• car2home_harsh_event: sert hızlanma, sert frenleme ya da sert viraj saptandı. Güvenli sürüş bildirimleri için, özellikle yeni sürücülerde işe yarar.
• car2home_ecu_online / car2home_ecu_offline: ECU bağlantısı kurulduğunda ya da koptuğunda tetiklenir; böylece "araç şu anda kullanılıyor" ile "araç park hâlinde" durumlarını ayırt edebilirsiniz.

Örnek otomasyonlar

Aklınıza kıvılcım çaksın diye birkaç fikir. Kurulum bloklarının tamamı Rehberler bölümünde.

• Sokağınıza girdiğinizde garaj kapısını açın ve giriş ışıklarını yakın (coğrafi sınır artı trip_started).
• Yolculuk bittiği anda aileye haber verin: park adresi ve harita bağlantısıyla.
• Bir tarama kod bulduğunda Telegram'dan uyarı gönderin; kaçının onaylanmış, kaçının bekleyen ve kaçının kalıcı olduğunu listeleyin.
• Ofisten çıktığınız anda evi önceden serinletin (iş yeri coğrafi sınırı artı trip_started).

Uyumluluk ve gereksinimler

• Home Assistant 2024.12 veya üzeri.
• Nabu Casa Cloud, Cloudflare Tunnel, Tailscale ya da hâlihazırda güvendiğiniz herhangi bir ters vekil sunucuyla çalışır.
• Çok araçlı kullanım: garajınızdaki her araç kendi Home Assistant cihazı olarak görünür, kendi varlıkları ve kendi geçmişiyle.
• Belirteçler iOS Keychain ya da Android Keystore içinde saklanır, uygulama tercihlerinde asla tutulmaz.