Adım adım kurulum

Önce yedekleyin, sonra doğrulayın.

İlk kurulum; donanım hazırlığı, orijinal yazılım yedeği, kişisel erişim bilgilerinin tanımlanması, ilk flash ve kontrollü işlev testlerinden oluşur. Daha sonraki sürümler OTA ile yüklenebilir.

Başlamadan önce

Bu referans donanım şebeke gerilimiyle çalışır. Kasa açıldığında cihaz şebekeden tamamen ayrılmış olmalıdır. UART adaptörü yalnız 3.3V lojik kullanmalı; cihaz aynı anda şebeke ve UART üzerinden beslenmemelidir.
  • ESPHome 2026.8.1 veya hedeflediğiniz doğrulanmış sürüm
  • 3.3V uyumlu USB–UART adaptörü
  • Orijinal firmware'in tam yedeği için uygun flash aracı
  • RefleX v2.0.1 kaynak paketi ve iki özel header dosyası
  • İlk kabul için gözlemlenebilir, düşük riskli bir test yükü

Donanım revizyonu, bağlantı yönü ve toprak hattı fiziksel olarak doğrulanmadan yalnız internet üzerindeki pin şemalarına güvenmeyin. Bu aşama deneyiminiz dışındaysa donanım bölümünü yetkin bir uygulayıcıyla tamamlayın.

İlk fiziksel flash sırası

  1. Şebekeden tamamen ayırın.
    Cihazın enerjisiz olduğunu doğrulayın ve kasayı yalnız uygun çalışma koşullarında açın.
  2. Stock firmware'i yedekleyin.
    Flash boyutunu doğrulayarak tam içerik yedeği alın; yedeği cihaz kimliği ve tarih ile saklayın.
  3. 3.3V UART bağlantısını kurun.
    GND, TX ve RX yönlerini doğrulayın; 5V lojik kullanmayın. Bootloader moduna kart revizyonuna uygun yöntemle girin.
  4. Kaynağı kendiniz derleyin.
    Wi-Fi bilgilerini düzenleyin; recovery erişim noktasının varsayılan parolasını değiştirin. Derleme başarılı olmadan upload aşamasına geçmeyin.
  5. İlk flash ve yeniden başlatma.
    Yazma tamamlandıktan sonra UART bağlantısını kaldırın, kasayı güvenli biçimde kapatın ve normal beslemeyi yalnız bundan sonra verin.

v2.0.1 derleme

Paketi örneğin C:\ESP_HOME\THR320D klasörüne çıkarın. YAML, iki özel header ve secrets.yaml aynı klasörde bulunmalıdır.

  1. secrets.example.yaml dosyasını secrets.yaml adıyla kopyalayın.
  2. Wi-Fi, API, OTA ve recovery alanlarını size özel güçlü değerlerle doldurun.
  3. secrets.yaml dosyasını paylaşmayın veya herkese açık depoya göndermeyin.
cd C:\ESP_HOME\THR320D
py -m esphome clean .\thr320d-reflex_v2_0_1_FINAL.yaml
py -m esphome compile .\thr320d-reflex_v2_0_1_FINAL.yaml
Kamusal dağıtım paketinde gerçek Wi-Fi adı, parola, cihaz IP'si veya kişisel bilgisayar yolu bulunmaz. Örnek alanlar derlemeden önce kullanıcı tarafından doldurulmalıdır.

İlk açılış kabul kontrolü

  1. Home Assistant'ta cihazın RefleX 2.0.1 ve doğru Build ID ile göründüğünü doğrulayın.
  2. Yerel sıcaklık ve MS01 ham gerilim değerlerini kontrol edin.
  3. LCD sayfalarını ve fiziksel düğmenin kısa/uzun basışlarını yük bağlamadan deneyin.
  4. 20A ON/OFF yönünü düşük riskli gözlemlenebilir yükle doğrulayın.
  5. Power-On State için önce OFF davranışını sınayın.
  6. Kuru kontak darbesini enerjisiz süreklilik ölçümüyle veya uygun düşük gerilim girişinde doğrulayın.
  7. Termal kilit, Safe Mode ve HA kesintisinde yerel otomasyon davranışını planlı test edin.

Sonraki güncellemeler: OTA

ZIP içindeki PowerShell betiği kendi klasöründen çalışır ve cihaz adresini sizden ister. Elle yükleme yapacaksanız aşağıdaki yer tutucuyu kendi cihazınızın IP adresi veya yerel adıyla değiştirin.

py -m esphome upload .\thr320d-reflex_v2_0_1_FINAL.yaml --device CIHAZ_IP_ADRESI

Home Assistant'ın sunduğu genel ESPHome firmware-update entity'si RefleX'in sürümlü özel build zincirinin sahibi değildir. RefleX için bu entity'yi devre dışı bırakın; framework güncellemesini kontrollü derleme ve OTA ile yapın.