Connector cihazları

Cihaz Profili Nedir?

Cihaz profili, bir cihazın SolarTools platformuyla nasıl iletişim kuracağını tanımlayan şablondur. Her cihaz, platforma bağlanırken hangi transport protokolünü (MQTT, HTTP vb.) ve hangi payload formatını (JSON, Binary vb.) kullanacağını bir profil aracılığıyla bildirir. Aynı profil birden fazla cihaza atanabilir; böylece onlarca cihazı tek bir yapılandırmayla yönetirsiniz.

Profil aynı zamanda cihazın yayınlayacağı telemetri anahtarlarını (örn. voltage, current, temperature), attribute anahtarlarını ve MQTT topic yapılandırmasını da kapsar. Doğru yapılandırılmış bir profil sayesinde platform, gelen veriyi otomatik olarak doğru alanlara eşler.

Cihaz Profili Oluşturma

Platformda yeni bir cihaz profili oluşturmak için Altyapı → Cihazlar → Cihaz Profilleri menüsüne gidin. Ekranın sağ üst köşesindeki + Cihaz Profili Ekle butonuna tıklayın. Açılan modal üç sekmeye ayrılmıştır: Normal Profil Oluşturma, Hazır Şablonlar ve Şablonları Yönet.

Cihaz Profilleri — Ekran Görüntüleri

📋Profil Listesi

Şekil 1 — Cihaz Profilleri listesi; sağ üstteki butonla yeni profil eklenir

⚙️Normal Profil

Şekil 2 — Normal Profil formu: ad, protokol, telemetry/attribute anahtarları ve telemetri satırları

📡Topics & Kaydet

Şekil 3 — Formun devamı: Topics yapılandırması, Açıklama ve "Profil Ekle" butonu

📄Hazır Şablon

Şekil 4 — Hazır Şablonlar: önceden kayıtlı bir şablon seçilerek profil oluşturulur

🔗Şablon Detayı

Şekil 5 — Seçilen şablondan gelen Topics ve telemetri yapılandırması otomatik dolar

🛠️Şablon Yönetimi

Şekil 6 — Şablonları Yönet: kayıtlı şablonları düzenleyebilir veya silebilirsiniz

Normal Profil Oluşturma

Normal Profil Oluşturma sekmesi, profili sıfırdan yapılandırmanızı sağlar. Alanları sırasıyla doldurun:

Profil Adı — Cihazı tanımlayan benzersiz bir isim girin (örn. MQTT Inverter v1).
Transport Protokolü — MQTT, HTTP vb. seçeneklerden cihazınızın desteklediğini seçin.
Payload Formatı — Cihazın gönderdiği veri formatını seçin; çoğu modern cihaz için JSON önerilir.
Telemetry Keys — Cihazın yayınlayacağı ölçüm anahtarlarını ekleyin (örn. voltage, current, temperature).
Attributes Keys — Cihazın meta verilerini tanımlayan statik anahtarları girin (örn. device_type, firmware_version).
Telemetri (anahtar–değer) — Satır satır sabit anahtar/değer çiftleri ekleyin; cihazın varsayılan telemetrisini önceden tanımlamak için kullanılır.
Topics Yapılandırması — MQTT kullanıyorsanız, platforma ait hazır topic şablonlarından ihtiyacınıza uygun olanları seçin (telemetry_pub ve attributes_pub zorunludur).
Tüm alanları doldurduktan sonra Profil Ekle butonuna tıklayın.

İpucu — Aynı protokol ve payload yapısını kullanan birden fazla cihazınız varsa, tek bir profil oluşturup tüm cihazlara atayabilirsiniz. Her cihaz için ayrı profil oluşturmanıza gerek yoktur.

Hazır Şablonlardan Profil Oluşturma

Hazır Şablonlar sekmesi, önceden tanımlanmış profil yapılandırmalarını tek seçimle kullanmanıza imkân tanır. Açılır listeden bir şablon seçtiğinizde transport protokolü, payload formatı, telemetry/attribute anahtarları ve topic yapılandırması otomatik olarak dolar. Gerekirse Profil Adı alanını düzenleyerek Profil Ekle ile kaydedin.

Şablonları Yönetme

Şablonları Yönet sekmesinde daha önce kaydedilmiş tüm şablonlar listelenir. Her şablonun yanındaki düzenle (kalem) ikonu ile şablonu güncelleyebilir, sil (çöp kutusu) ikonu ile kalıcı olarak kaldırabilirsiniz. Silme işlemi geri alınamaz; bu şablona bağlı mevcut profiller etkilenmez.

Dikkat — Bir şablonu silmeden önce, o şablondan oluşturulmuş mevcut profillerin bağımsız çalışmaya devam edeceğini unutmayın. Ancak silinen şablonu bir daha Hazır Şablonlar sekmesinden seçemezsiniz.