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 şey, sensörleri paylaşmakla yetinmemesidir. Aracınız Home Assistant olay hattına olaylar yayımlar: seyahat başladı, seyahat bitti, araç park etti, arıza bulundu, sert hızlanma, beyin çevrimiçi. Böylece bir değeri sürekli sorgulayıp tahmin yürütmek yerine, bir şeyin olduğu ana 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

   "Çevrimiçi" kipi siz sürerken telemetriyi gerçek zamanlı aktarır. "Ev" kipi siz dışarıdayken verileri uygulamada biriktirir ve telefon ağınıza döner dönmez hepsini gönderir: Home Assistant yalnızca evden erişilebiliyorsa işe yarar. Uygulama adresi o anki bağlantıya göre seçer, yani evde yereli, yolda uzaktakini kullanır.

Neler elde edersiniz

Garajınızdaki her araç, Home Assistant'ta kendi varlık takımına sahip bir cihaza dönüşür. Adlar car2home_{brand}_{model}_{sensor} kalıbını izler ve araca verdiğiniz takma ad varsa ona da eklenir, böylece aynı modelden iki araç asla çakışmaz. Hangi sensörlerin dışa aktarılacağını siz seçersiniz, yani liste istediğiniz kadar kısa ya da istediğiniz kadar eksiksiz kalır. Seçim, uygulamadaki Araç Destekli Sensörler ekranında yapılır: bir sensör, etkin olduğu ve HA/MQTT anahtarı açık olduğu sürece dışa aktarılır.

• 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 aracın nerede park ettiğini adres ve varış saatiyle gösteren bir device_tracker. Telefonun GPS'i yalnızca seyahat sırasında veri gönderir.
• 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ş.
• Vehicle Hub: bir sonraki yakıt ikmali tahmini, sıradaki bakım, sıradaki hatırlatıcı, ayın toplamları ve tüketimi, ayrıca geciken ve yaklaşan işaretleri. Yalnızca gerçekten kullandığınız özellikler için görünürler.

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_parking_detected: araç park edince tetiklenir; yeri, seyahatin süresi ve mesafesi, kalan yakıt ve menzil ile birlikte. "Eve geldim" otomasyonları buna bağlanır.
• 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.

• 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.