1. Kuika platformuna giriş yaptıktan sonra “Apps” ekranından çalışacağınız projeyi açın.
2. “Data Sources” (1) modülüne gidin. Data Sources modülünde, geliştirdiğiniz uygulamada yer alan veri kaynaklarını, aksiyonları ve tabloları görüntüleyebilir, yeni bir veri kaynağı, yeni bir aksiyon ve yeni bir tablo ekleyebilirsiniz. 

3. Geliştirdiğiniz uygulamaya yeni bir veri kaynağı eklemek için Data Sources modülünün sol kenarındaki “Sources” başlığı yanında bulunan “+” (2) ikonuna tıklayın. 

4. Data Sources veri kaynağı tipi olarak “MQTT” (1) seçin ve bir isim (2) girin. 
5. Daha sonra “CREATE” (3) butonuna tıklayın. 

HiveMQ Cloud, MQTT protokolünü kullanan bir IoT platformudur. HiveMQ Console kullanarak bir cluster oluşturabilir ve web client ile bağlanabilirsiniz. 

Kuika platformunda MQTT protokolünü kullanabilmek için HiveMQ üzerinde bir kullanıcı oluşturup gerekli bağlantı bilgilerini elde etmeniz gerekir. Oluşturduğunuz kullanıcı adı ve şifreyi Kuika’da MQTT eklerken kullanacaksınız.  

Bu işlemi adım adım şu şekilde yapabilirsiniz:

1. HiveMQ Cloud Console’a Giriş Yapın

• Tarayıcınızda HiveMQ Cloud Console adresine gidin.
• Hesabınız yoksa “Sign Up” butonuna tıklayarak kayıt olun.
• Hesabınız varsa “Login” butonuna tıklayarak giriş yapın. Kullanıcı adı ve şifrenizi girerek HiveMQ Console’a erişin.

2. Yeni Bir Cluster Oluşturma

• Giriş yaptıktan sonra ana sayfada “Clusters” bölümüne gidin.
• “Create Cluster” seçeneğine tıklayın.
• Cluster için bir ad verin (örneğin “MyFirstCluster”).
• Cluster’ın lokasyonunu seçin. Örneğin, “Europe” veya “North America” gibi.
• Ücretsiz bir plan (Free Plan) seçebilir veya ihtiyaçlarınıza göre ücretli bir plan tercih edebilirsiniz.
• Ayarları onayladıktan sonra “Create” butonuna tıklayın. Cluster oluşturulacak ve bağlantı kurabilmeniz için gerekli bilgileri sağlayacaktır.

3. Web Client ile Bağlanma

• Cluster oluşturulduktan sonra, HiveMQ Cloud Console'da sol menüde “Web Client” sekmesini bulun ve tıklayın.
• Web Client açıldığında, bağlanmak için şu bilgileri doldurmanız gerekecek:some text
  • Host: Cluster oluştururken verilen bağlantı URL'si (genellikle *.hivemq.cloud şeklinde olur).
  • Port: 8883 (SSL) veya 1883 (güvenli olmayan bağlantılar için).
  • Client ID: Her bağlantı için benzersiz bir kimlik kullanılması gerekir; rastgele bir ID girilebilir.
  • Username ve Password: HiveMQ Cloud Console üzerinden oluşturduğunuz kullanıcı adı ve şifrenizi girin.
• Tüm bilgileri girdikten sonra “Connect” butonuna tıklayın.
• Bağlantı sağlandığında MQTT üzerinden mesaj göndermeye ve almaya başlayabilirsiniz. Bağlandıktan sonra, belirli bir topic üzerinden mesajlar yayınlayabilir (publish) veya dinleyebilirsiniz (subscribe).

Topic

• MQTT’de topic, bağlı bir istemci için mesajları filtreleyen bir UTF-8 dizesidir. Bir topic, eğik çizgi (/) ile ayrılmış bir veya daha fazla seviyeden oluşur ve bu seviyeler hiyerarşik bir yapıyı takip eder. Topic, istemcilerin ilgilendikleri verilere kolayca ulaşmasını sağlar.
  Örnek:
  • ev/oturma_odasi/sicaklik: Bu topic, evdeki oturma odasının sıcaklık verilerini ifade eder.
  • araclar/araba/hiz: Bu topic, araç hız verilerini gösterebilir.
• İstemciler, belirli bir Topic’e abone olarak o topic üzerinde yayınlanan mesajları alır veya bu Topic’e mesaj gönderebilir.

Quality of Service (QoS)

MQTT’de Quality of Service (QoS), mesajların teslim güvenilirlik seviyesini belirler. Üç farklı QoS seviyesi vardır:

1. QoS 0 (at most once):
   • Mesajların alıcıya en fazla bir defa gönderilmesini sağlar. Mesajlar kablo ile iletilirken herhangi bir onay beklenmez. Bu nedenle, bazı veri kayıpları sorun yaratmıyorsa kullanılabilir.

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

• Kullanım Alanı: Sıcaklık gibi sürekli güncellenen ve veri kaybının tolere edilebildiği durumlar.

2. QoS 1 (at least once):
   • Göndericinin mesajı en az bir kez iletmesini garanti eder. Alıcıdan onay alınana kadar mesaj tekrar gönderilebilir. Aynı verinin birden fazla kez gönderilmesine neden olabilir.
   • Kullanım Alanı: Verinin kaybolmamasının kritik olduğu, ancak bazı tekrarların kabul edilebilir olduğu durumlar (örneğin, alarm bildirimleri).
3. QoS 2 (exactly once):
   • Güvenilir seviyedir ve mesajın yalnızca bir kez teslim edilmesini sağlar. Gönderilen mesaj, onaylanan paketlerle kesinleştirilir. Bu nedenle veri kaybı veya tekrar gönderim yaşanmaz, ancak daha uzun sürer.
   • Kullanım Alanı: Hassas veri aktarımı gereken ve veri tekrarı istenmeyen durumlar (örneğin, finansal işlemler).

Retain

• Retain özelliği, bir mesajın kaydedilmesi ve daha sonra yeni bağlanan istemcilere iletilmesi anlamına gelir. Eğer bir mesaj retain (sakla) bayrağı ile gönderilirse, bu mesaj MQTT Broker’ında kaydedilir ve o Topic’e bağlanan her yeni istemciye ilk olarak bu retain edilen mesaj iletilir.
  • Örnek: “User” şeklinde bir mesaj retain true iken gönderildiğinde, broker bu mesajı saklar. Sonrasında retain false iken birkaç farklı mesaj gönderilmiş olabilir. Tekrar login olduğunuzda, retained olan “User” mesajını ilk olarak göreceksiniz. Bu retained mesajı silmek için, retain true ile boş (sıfır byte) bir mesaj gönderilmelidir. Böylece “User” mesajının kaydı silinmiş olur ve bir daha login olduğunuzda herhangi bir retained mesaj görmezsiniz.

Retain özelliği, belirli verilerin yeni bağlanan istemcilere hızlıca iletilmesini sağlar ve en son durum bilgisinin saklanması gerektiğinde kullanışlıdır.

1. “CREATE” butonuna tıkladıktan sonra açılan ekranda yer alan bağlantı bilgilerini yapılandırın: 

• Use TLS: MQTT bağlantısının şifreli ve güvenli bir şekilde yapılmasını sağlayarak, iletilen verilerin güvenliğini ve gizliliğini korur. 
• Protocol:  MQTT, veri iletimi için TCP/IP üzerinde çalışan ve güvenli bağlantılar için TLS desteği sunan bir mesajlaşma protokolüdür. Varsayılan olarak “WebSocket” gelir. 
• Port: MQTT için varsayılan portlar şunlardır: 1883 (güvenli olmayan bağlantılar için) ve 8883 (güvenli bağlantılar için, TLS kullanıldığında).
• Host: Host, MQTT sunucusunun adresini belirtir. Bir IP adresi veya bir alan adı olabilir (örneğin, mqtt.example.com).
• Basepath: MQTT, genellikle port üzerinden çalıştığı için basepath gerektirmez, ancak WebSocket üzerinden bağlantı kurarken bazı MQTT sunucuları basepath kullanabilir (örneğin, /mqtt).
• Username: MQTT sunucusuna bağlantı sağlamak için kullanılan kullanıcı adı bilgisidir. Kimlik doğrulama gerektiren bir sunucuda, bu kullanıcı adı bağlantıyı doğrulamak için kullanılır.
• Password: MQTT sunucusuna erişim sağlamak için kullanıcı adıyla birlikte kullanılan şifredir ve kimlik doğrulama için gereklidir.

2. Bağlantı ayarlarını yaptıktan sonra sağ üst köşedeki “Test” butonuna tıklayarak bağlantının doğru çalışıp çalışmadığını kontrol edin.

      3. Ardından “CREATE” butonuna tıklayarak bağlantı ayarlarınızı yapılandırabilirsiniz. Projede kullanılacak olan actionlar ve parametreleri, Create işleminde otomatik olarak oluşur.

• UI Design modülündeki sağ kenardaki “Properties” paneline gidin.

• Subscribe aksiyonu ekleyin, böylece kullanıcı sayfaya girdiğinde belirli bir topic’e otomatik olarak abone olur. Bu örnekte topic olarak "kuika/test" kullanılmıştır.
• Bu subscribe eylemi sayesinde kullanıcı, belirtilen Topic’e gelen mesajları görme yetkisine sahip olur.
• Action bölümüne eklemeler yapabilirsiniz. Örneğin:some text
  • Sağ kenardaki “ADD ACTİON” butonundan gelen mesajı göstermek için bir Notify aksiyonu ekleyin.
  • Mesajın bir Text Input bileşeninde görünmesi için Set Value Of aksiyonunu kullanarak mesajı Text Input içine yazdırın.

Publish Eylemini Bir Butona Ekleyin‍

• Sol kenardaki Elements panelinden bir “Button” ekleyin ve bu butona Publish aksiyonunu bağlayın.

Publish aksiyonu ile belirlediğiniz Topic’e mesaj gönderebilirsiniz. Örneğin, user/guide Topic’ine bir mesaj gönderdiğinizde, bu Topic’e abone olan tüm kullanıcılar mesajı görecektir.