Message Queuing Telemetry Transport (MQTT) Veri Kaynağı Ekleme Kullanıcı Kılavuzu

1. Kuika platformuna giriş yapın ve Apps ekranından çalışacağınız projeyi açın.
2. Data Sources modülüne gidin. Burada mevcut veri kaynaklarını, aksiyonları ve tabloları görüntüleyebilir veya yeni bir veri kaynağı ekleyebilirsiniz.

3. Yeni bir veri kaynağı eklemek için:
   
   • Sources başlığı yanındaki + ikonuna tıklayın.
   • Datasource tipi olarak MQTT seçin ve bir isim girin.
   • CREATE butonuna tıklayarak işlemi tamamlayın.

HiveMQ Cloud, MQTT protokolünü destekleyen bir IoT platformudur. HiveMQ Console'u kullanarak bir MQTT broker oluşturabilir ve cihazlarınızı bağlayabilirsiniz.

HiveMQ Cloud Kullanıcı Oluşturma

1. HiveMQ Cloud Console adresine gidin.
2. Hesabınız yoksa Sign Up butonuna tıklayarak kayıt olun.
3. Hesabınız varsa Login butonuna tıklayarak giriş yapın.

Yeni Bir Cluster Oluşturma

1. Clusters bölümüne gidin ve Create Cluster seçeneğine tıklayın.
2. Cluster için bir ad belirleyin (örneğin, "MyFirstCluster").
3. Cluster’ın lokasyonunu seçin (örneğin, "Europe" veya "North America").
4. Ücretsiz veya ücretli planlardan birini seçin.
5. CREATE butonuna tıklayarak cluster’ı oluşturun.

Web Client ile Bağlanma

1. Sol menüde Web Client sekmesine tıklayın.
2. Açılan ekranda bağlantı bilgilerini girin:
   
   • Host: Cluster oluşturduğunuzda verilen bağlantı URL'si. (genellikle *.hivemq.cloud şeklinde olur).
   • Port: 1883 (güvenli olmayan) veya 8883 (SSL).
   • Client ID: Rastgele bir kimlik belirleyin.
   • Username & Password: HiveMQ Console'da oluşturduğunuz bilgiler.
3. Connect butonuna tıklayın.

Bu adımları tamamladıktan sonra belirli bir topic üzerinden mesaj gönderebilir (publish) veya dinleyebilirsiniz (subscribe).

Topic

MQTT’de topic, mesajların filtrelenmesini sağlar. Eğik çizgi (/) ile ayrılmış hiyerarşik bir yapı kullanılır.

Örnekler:

• ev/oturma_odasi/sicaklik → Oturma odasının sıcaklık verileri.
• araclar/araba/hiz → Araç hız verileri.

Quality of Service (QoS)

MQTT’de QoS seviyesi, mesaj teslim güvenilirliğini belirler.

1. QoS 0 (At Most Once) → Mesaj onay beklemeden gönderilir. Veri kaybı tolere edilebiliyorsa kullanılabilir.

Yalnızca alıcı ve verici kablo ile bağlıysa kullanılabilir. 

2. QoS 1 (At Least Once) → Mesaj en az bir kez iletilir ancak tekrarlanabilir.
3. QoS 2 (Exactly Once) → En güvenilir seviye, mesaj yalnızca bir kez teslim edilir.

Retain

Retain özelliği, mesajların kaydedilmesini ve yeni bağlanan istemcilere iletilmesini sağlar.

• Örnek: Eğer bir sıcaklık değeri retain ile gönderildiyse, yeni bağlanan tüm istemciler bu değeri görebilir.
• Retain mesajı temizlemek için: Retain true ile boş bir mesaj gönderilmelidir.

MQTT veri kaynağını oluşturduktan sonra bağlantı bilgilerini girin:

• Use TLS: Bağlantıyı şifreleyerek güvenliği artırır.
• Protocol: Varsayılan olarak WebSocket kullanılır.
• Port: 1883 (güvensiz) veya 8883 (güvenli/TLS destekli).
• Host: MQTT broker adresi.  (örneğin, mqtt.example.com)
• Basepath: WebSocket bağlantıları için gereklidir.(örneğin, /mqtt).
• Username & Password: MQTT sunucusu için kimlik doğrulama bilgileri.

Bağlantıyı test etmek için Test butonuna tıklayın ve ardından CREATE butonu ile ayarları kaydedin.

Subscribe işlemi ile belirli bir topic'e otomatik abone olabilirsiniz.

1. UI Design modülüne gidin.
2. Sağ kenardaki Properties panelinden ADD ACTION butonuna tıklayın.

3. Subscribe aksiyonu ekleyin.
   
   • Örnek Topic: "kuika/test"
   • Kullanıcı, belirtilen topic’e gelen mesajları görebilir.

Ekstra işlemler ekleyebilirsiniz:

• Gelen mesajları göstermek için: Notify aksiyonu kullanın.
• Mesajları bir text input alanında göstermek için: Set Value Of aksiyonunu ekleyin.

1. Sol panelde Elements bölümünden bir Button ekleyin.
2. Bu butona Publish aksiyonunu bağlayın.
3. Mesaj göndermek için ilgili topic'i belirleyin.
   
   • Örnek Topic: "user/guide"
   • Bu topic’e abone olan tüm kullanıcılar mesajı alacaktır.

Bu eğitim içeriği, Kuika platformunda MQTT bağlantısını kurma, mesaj alışverişi yapma ve uygulamalarınızı MQTT ile entegre etme sürecinizi hızlandıracaktır. 🚀