1. Kuika platformuna giriş yapın ve Apps ekranından çalışacağınız projeyi açın.
2. Üst menüden Datasources modülünü açın. Burada mevcut veri kaynaklarınızı ve aksiyonlarınızı Recently modified ve Data sources sekmeleri altında görüntüleyebilir, Search by name alanı ile arama yapabilir veya yeni bir veri kaynağı ekleyebilirsiniz.
3. Ekranın üst kısmındaki kartlardan Create an API kartına tıklayın. Bu kart Swagger, REST, OData, SAP ve MQTT broker bağlantıları oluşturmanızı sağlar.
4. Açılan listede Communication başlığı altındaki MQTT (Message queuing protocol) seçeneğini belirleyin. Listede gezinmek için ↑/↓ tuşlarını, seçim yapmak için Enter tuşunu da kullanabilirsiniz.

5. Name alanına veri kaynağınız için bir isim girin (örn. userguidemqtt). İsim girilene kadar CREATE butonu pasif durumdadır.
6. CREATE butonuna tıklayarak işlemi tamamlayın. İşlemden vazgeçmek için CANCEL butonunu, bağlantı tipi seçimine geri dönmek için < MQTT bağlantısını kullanabilirsiniz.

Not: Sol paneldeki Sources başlığının yanında yer alan + ikonu ile de yeni veri kaynağı ekleme işlemini başlatabilirsiniz.

Bu adımların ardından MQTT bağlantı ayarları ekranı açılır. Bağlantı bilgilerini girmeden önce bir MQTT broker'ınız yoksa aşağıdaki HiveMQ Cloud adımlarını izleyebilirsiniz.

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 (örn. "MyFirstCluster").
3. Cluster'ın lokasyonunu seçin (örn. "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 şeklindedir).
   • 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 mesajları 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.

• QoS 0 (At Most Once): Mesaj onay beklemeden gönderilir. Veri kaybı tolere edilebiliyorsa kullanılabilir.
• QoS 1 (At Least Once): Mesaj en az bir kez iletilir ancak tekrarlanabilir.
• QoS 2 (Exactly Once): En güvenilir seviyedir; mesaj yalnızca bir kez teslim edilir.

Retain

Retain özelliği, mesajların broker'da saklanmasını ve yeni bağlanan istemcilere iletilmesini sağlar.

Örnek: Bir sıcaklık değeri retain ile gönderildiyse, bu topic'e yeni bağlanan tüm istemciler bu değeri görebilir.

Retain mesajını temizlemek için retain true ile boş bir mesaj gönderilmelidir.

MQTT veri kaynağını oluşturduktan sonra açılan ekranda bağlantı bilgilerini girin. Ekranın üst kısmında geri butonu (←), veri kaynağının adı (adı düzenlemek için kalem ikonu) ve ayarları kaydetmek için CREATE butonu yer alır.

01 Broker

Kuika'nın bağlanacağı broker bilgilerini içerir.

• Protocol (zorunlu): Bağlantı protokolüdür. Varsayılan olarak Websocket seçili gelir.
• Host: MQTT broker adresi (örn. mqtt.example.com).
• Port (zorunlu): Broker'ın bağlantı portu (örn. 1883 güvensiz, 8883 güvenli/TLS destekli).
• Base path: WebSocket bağlantıları için gereklidir (örn. /mqtt).

02 Credentials

Bağlantı sırasında broker'a gönderilen kimlik doğrulama bilgileridir.

• Username: MQTT sunucusu kullanıcı adı.
• Password: MQTT sunucusu şifresi. Göz ikonu ile şifreyi gösterebilir veya gizleyebilirsiniz.

03 Transport Security

Broker bölümünde tanımlanan bağlantı adresine uygulanan güvenlik ayarlarıdır.

• Use TLS: Bağlantıyı şifreleyerek güvenliği artırır.
• Validate certificate: Bağlantının TLS sertifikasını doğrular. Kapalı olduğunda kendinden imzalı (self-signed) sertifikalar da kabul edilir.

Bağlantıyı Test Etme ve Kaydetme

1. Sağ taraftaki Connection bölümünde yer alan Test connection butonuna tıklayarak bağlantıyı test edin.
2. Bağlantı başarılıysa sağ üstteki CREATE butonuna tıklayın.

CREATE butonu bağlantıyı kaydeder ve bu veri kaynağına ait Publish ve Subscribe aksiyonlarını otomatik olarak ekler. Bu aksiyonları sonraki adımlarda uygulamanızda kullanabilirsiniz.

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

1. UI Design modülüne gidin.
2. Sağ kenardaki Properties panelinden ADD ACTION butonuna tıklayın.
3. Subscribe aksiyonunu ekleyin.
4. Örnek topic: "kuika/test"

Kullanıcı, belirtilen topic'e gelen mesajları görebilir. Ekstra işlemler de ekleyebilirsiniz:

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

1. Sol paneldeki 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.
4. Ö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.