> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/turkish/fonksiyon-bloklari/blocks-reference/input-output/communication/mqtt-subscribe-tls-beta.md).

# MQTT Subscribe (TLS-Beta)

Bu fonksiyon bloğu, bir MQTT broker'a bağlanır ve TLS (güvenli) bağlantı seçenekleri kullanarak seçilen bir konuda (topic) gelen mesajları dinler. Gelen metin yüklerini alır ve yeni veri geldiğinde bir sinyal üretir; böylece veriyi senaryonuzda işleyebilir veya iletebilirsiniz.

## 📥 Girdiler <a href="#inputs" id="inputs"></a>

`Enable` Bu boolean giriş soketi aboneliğin aktif olup olmadığını kontrol eder. Mesaj almayı etkinleştirmek için TRUE; işleme devre dışı bırakmak için FALSE gönderin.

## 📤 Çıktılar <a href="#outputs" id="outputs"></a>

`Data` En son alınan mesajın metin yükü.

`New Data` Yeni bir mesaj alındığında tek bir değerlendirme için TRUE olan boolean bayrak.

## 🕹️ Kontroller <a href="#controls" id="controls"></a>

`Server / Broker` MQTT broker adresini veya hostname'ini girin.

`Port` Broker portunu ayarlayın (TLS için yaygın port 8883'tür).

`Topic` Abone olunacak konuyu (topic) belirtin. Bu konuda gelen mesajlar `Data` çıktısında görünür.

`Client ID` İsteğe bağlı olarak broker üzerindeki bu istemci için tanımlayıcı.

`Username` Broker doğrulaması için isteğe bağlı kullanıcı adı.

`Password` Broker doğrulaması için isteğe bağlı parola.

`Use TLS` Güvenli (TLS) bağlantı modunu etkinleştirmek için açma/kapama anahtarı.

`CA Certificate` TLS sertifika doğrulaması için bir CA paketi sağlama veya referans verme seçeneği (blok sistem CA doğrulamasını destekler).

`Connect` Mevcut ayarlarla bağlantıyı başlatmak veya yeniden kurmak için kontrol.

`Auto Reconnect` Bağlantı kesildiğinde otomatik yeniden bağlanmayı açma/kapama anahtarı.

Not: Eğer blok kompakt bir UI sunuyorsa, bazı gelişmiş seçenekler "Advanced" bölümünde gruplanmış olabilir.

## 🎯 Özellikler <a href="#features" id="features"></a>

* TLS desteği ile şifrelenmiş iletişim sağlayan güvenli MQTT aboneliği.
* Yeni mesaj geldiğinde `New Data` çıktısında canlı işaretleme, böylece alt blokları yalnızca gerektiğinde tetikleyebilirsiniz.
* Herhangi geçerli MQTT topic'ine abone olma esnekliği.
* Çoğu broker konfigürasyonu için bağlantı parametreleri ve temel kimlik doğrulama kontrolleri.
* Geçici ağ aksaklıklarının manuel müdahale gerektirmemesi için düzgün yeniden bağlanma yönetimi.

## 📝 Kullanım Talimatları <a href="#usage" id="usage"></a>

1. `Server / Broker`, `Port` ve gerekliyse kimlik doğrulama kontrollerini kullanarak broker bilgilerinizi yapılandırın.
2. Dinlemek istediğiniz konuyu `Topic` kontrolüne girin.
3. Bloğu etkinleştirmek için `Enable` girişine TRUE gönderin veya bloğun UI bağlantı kontrolünü kullanın.
4. Gelen metin yüklerini `Data` çıktısından okuyun. Yalnızca taze bir mesaj geldiğinde işlem yapmak için `New Data` çıktısını kullanın.
5. Bağlantı parametrelerini değiştirdiğinizde, ayarların uygulanması için `Connect` kontrolünü kullanın (veya `Enable`i toggle edin).

## 📊 Değerlendirme <a href="#evaluation" id="evaluation"></a>

Blok aktif olduğunda, yapılandırılmış konuda aboneliği sürdürüyor. Her çalıştırmada en son alınan yükü `Data` üzerinde çıktı olarak verir ve son değerlendirmeden bu yana yeni bir mesaj geldiyse yalnızca o çalıştırma için `New Data` TRUE olur.

## 💡 İpuçları ve Püf Noktaları <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Gelen JSON metinlerini yapılandırılmış değerlere dönüştürmek için `MQTT Subscribe (TLS-Beta)` sonrasında `Parse Data Dictionary` veya `Data to JSON` kullanın.
* Gelen mesajları kaydetmek istiyorsanız, `Data`yı `CSV Export` veya önce `Data to JSON`'e bağlayıp ardından bir export bloğuna gönderin.
* Kurulum sırasında mesajları yazdırmak veya incelemek için `Debug Input` ile birleştirin.
* `New Data` TRUE olduğunda yalnızca eylem tetiklemek için `Logic Input` veya `Rising Edge` kullanın.
* Dağıtık senaryolarda, en son mesajı senaryonuzun ayrı dalları arasında paylaşmak için bu bloğu `Data Write Global` / `Data Read Global` ile eşleştirin.
* Mesaj içinde resim referansları veya kodlanmış resim verileri varsa, çözülen resmi görüntülemek için `Show Image`'e gönderin.
* Yanıtlar veya onaylar yayınlarken, broker'a mesaj göndermek için ilgili `MQTT Publish (TLS-Beta)` bloğunu kullanın.

## 🛠️ Sorun Giderme <a href="#troubleshooting" id="troubleshooting"></a>

* Bağlantı başarısız oluyor: `Server / Broker`, `Port` ve ağ erişimini doğrulayın. TLS portu ve firewall kurallarının doğru olduğundan emin olun.
* Kimlik doğrulama hataları: `Username` ve `Password` girişlerini tekrar kontrol edin ve broker ACL'lerini doğrulayın.
* Mesaj görünmüyor: Kesin `Topic` dizgesini doğrulayın (wildcard'ler ve hiyerarşi önemlidir) ve başka bir istemcinin gerçekten yayımladığından emin olun. Test için basit bir istemci kullanın.
* Beklenmeyen mesaj formatı: Yükleri incelemek ve normalize etmek için `Parse Data Dictionary` veya `String Operations` kullanın.
* TLS sorunları: Sertifika doğrulaması başarısız oluyorsa, CA sertifika paketinin mevcut olduğundan veya sistem CA seçeneğinin kullanıldığından emin olun. Yalnızca sorun gidermede izole etmek için broker izin veriyorsa TLS olmayan bir bağlantı deneyin.