Teknisyen Kılavuzu

Bu kılavuz, SB Solar WiFi BMS İnverter Monitor cihazının kurulumu, teşhisi ve saha desteği için hazırlanmıştır. Son kullanıcıya yönelik sade kılavuz için Kullanıcı Kılavuzu sayfasına bakın.

Sistem Özeti

Cihaz bir ESP32 üzerinde çalışır, iki bağımsız veri kaynağını okur:

• BMS (Batarya Yönetim Sistemi) — Bluetooth (BLE) üzerinden. Desteklenen markalar: JBD (Jiabaida), JK BMS, Daly.
• İnverter — RS232/UART üzerinden (MAX3232 seviye çeviricisi ile). Desteklenen protokol: PI30/Voltronic (Exelon marka inverterlerde doğrulandı).

Veriler WiFi üzerinden monitor.sbsolar.com.tr adresindeki sunucuya gönderilir, orada saklanır ve web arayüzünden görüntülenir.

Kurulum Adımları (Teknisyen Perspektifi)

1. Cihazı güç kaynağına bağlayın.
2. Cihaz WiFi bilgisi yoksa otomatik olarak sbsolar-bms-01 Kurulum adında bir erişim noktası (AP) açar (şifre: 12345678).
3. Bu ağa bağlanıp 192.168.4.1 adresinden WiFi bilgilerini girin.
4. Cihaz yeniden başlayıp girilen ağa bağlanır, sbsolar-bms-01.local/kurulum (mDNS) adresinden erişilebilir hale gelir — bu, cihazın kendi sunduğu özel kurulum/yönetim sayfasıdır (2026-08-24'te yeniden tasarlandı: üstte WiFi/Batarya/İnverter özet kartları, kayıtlı batarya yoksa sihirbaz otomatik açık, varsa "Değiştir" butonunun arkasında). Eski ESPHome otomatik arayüzü (/) hâlâ var, "Gelişmiş / Teknik Ayarlar" olarak /kurulum sayfasının altından erişilir.
5. /kurulum sayfasında batarya markasını seçin (JBD/Daly), ardından MAC adresini ya da seri numarasını girerek bataryaya eşleştirin.

Batarya markası seçimi neden önemli?

JBD ve Daly BMS'ler farklı BLE GATT protokolleri konuşur. Cihaz her ikisini de destekler ama aynı anda sadece biri aktif olarak kullanılır — kurulum panelinden doğru markayı seçmezseniz cihaz yanlış protokolle bağlanmaya çalışıp veri alamaz. /kurulum sayfasının Batarya özet kartı gerçek kayıtlı değeri gösterir (ekrandaki dropdown'ın görsel varsayılanına değil).

Fabrika Sıfırlaması

Cihaz üzerindeki BOOT butonuna basılı tutarak:

Süre	Etki
10 saniye	Sadece batarya eşleştirmesi silinir, WiFi bilgisi kalır
20 saniyeye kadar	Tüm ayarlar silinir (WiFi dahil) — cihaz sıfırdan kurulmuş gibi olur

Uzaktan Teşhis Araçları

Web arayüzündeki /logs sayfası iki sekme sunar:

• Worker Logları — sunucu tarafındaki olayları gösterir (istek hataları, bildirimler).
• ESP32 Cihaz Logları — cihazın kendi log çıktısını (30 saniyede bir toplu gönderilir) gösterir. Log seviyesi (ERROR — VERBOSE) buradan uzaktan değiştirilebilir.

⚠️ Log seviyesini DEBUG/VERBOSE/VERY_VERBOSE'a çekmek yalnızca aktif bir sorunu teşhis ederken, kısa süreliğine yapılmalıdır. Bu seviyeler yoğun log trafiği ürettiği için cihazın belleğini zorlayabilir. İşiniz bitince mutlaka WARN'a geri döndürün.

Diğer teşhis endpoint'leri

Adres	Açıklama
/api/latest	Son BMS kaydı (ham JSON)
/api/latest-inverter	Son inverter kaydı (ham JSON)
/history	Geçmiş veriler — grafik + tablo + CSV indirme
/inverter	Panel/batarya/AC/yük akış diyagramı
/firmware-history	Yüklenen firmware sürüm geçmişi

Uzaktan Firmware Güncelleme (OTA)

Cihaz periyodik olarak sunucuya sürüm bilgisini bildirir; sunucuda daha yeni bir sürüm varsa cihaz bunu kendisi indirip kendisi flaşlar — teknisyenin sahada bulunması gerekmez. Güncelleme genelde birkaç dakika içinde tamamlanır, cihaz otomatik yeniden başlar.

Kurulum modundaki (henüz batarya seçilmemiş) cihazlarda OTA kontrolü bilinçli olarak atlanır — doğrulanmamış bir firmware ile provisioning ortasındaki bir cihazı tuğla haline getirme riskini önlemek için.

Bilinen Sınırlamalar

• Sabit 8 hücreli batarya şeması — sistem her bataryadan ilk 8 hücre voltajını okur. 8'den fazla hücreli bataryalarda (örn. 15-hücreli bir Daly BMS test edilmişti) fazladan hücreler ayrı ayrı gösterilmez, ancak min/max/fark değerleri yine de TÜM hücrelerden doğru hesaplanır.
• Tek batarya markası aktif — JBD ve Daly aynı cihazda birlikte çalışabilir ama aynı anda sadece kurulumda seçilen marka veri gönderir.
• PSRAM'siz donanım — cihaz standart ESP32 (PSRAM yok) üzerinde çalışır, bu nedenle çok sayıda eşzamanlı ağır işlem (BLE + WiFi/TLS + UART) altında bellek yönetimi hassastır. Sistem bunu tolere edecek şekilde tasarlanmıştır, ama teşhis sırasında log seviyesini yükseltirken dikkatli olun (yukarıya bakın).

Destek

Sahada çözülemeyen bir sorun için cihaz seri numarası, hata mesajı (varsa ekran görüntüsü) ve /logs sayfasından ilgili log kaydıyla birlikte SB Solar teknik ekibine ulaşın.