Başlangıç

İşleme hattı

Bir mesaja, gelişiyle iletilişi arasında neler olur.

Her mesaj aynı yolu izler. Sırayı bilmek, uygulamayı öngörülebilir kılan şeydir — ve bir şey yanlış çıktığında nereye bakacağınızı söyler.

Akış sayfası bunu çizer: solda kaynaklar, ortada Merkez, sağda hedefler. Merkez düğümü kendi üç işleme adımını gösterir — Şifre çöz, Çöz (decode), Yapı oluştur — ve üzerindeki düğmeler tam olarak aşağıda anlatılan ayarları açar.

Aşamalar

1. Geliş

Ağ, uç noktalarınızdan birine POST eder. Kaynağın adaptörü yükün gerçek olup olmadığını denetler — paylaşılan bir gizli anahtar, bir imza, o sağlayıcı ne kullanıyorsa.

Anahtar, kimlik doğrulaması değildir

Adresteki pk_/sk_/dk_ belirteci isteği bir projeye, kaynağa veya cihaza sınırlar. Tahmin edilemez, ama kimlik kanıtı değildir — yükü yine adaptör doğrular.

Nereden yapılandırılır: Akış → Uç nokta ve şema, ya da entegrasyonun kendisi. Bkz. Bir kaynak bağlayın.

2. Normalleştirme

Bir Sigfox callback'i ile bir ChirpStack uplink'i telde birbirine hiç benzemez. Burada tek bir iç biçime dönüşürler; böylece sonraki her adım sağlayıcıdan bağımsız çalışır.

Yükteki cihaz tanımlayıcısının, sizin oluşturduğunuz bir cihaza bağlandığı yer de burasıdır. Merkez'in tanımadığı bir tanımlayıcı, bir profille veya çözücüyle eşleştirilemez.

Nereden yapılandırılır: yapılandırılacak bir şey yok — ama cihazın doğru tanımlayıcıyla var olması gerekir. Bkz. Cihazlarınızı ekleyin.

3. Şifre çözme ve çözme

Cihazın profili şifreleme tanımlıyorsa yük önce deşifre edilir. Ardından profilin çözücüsü baytları adlandırılmış ölçümlere dönüştürür.

Sonuç, yolun geri kalanında ayrı kalan iki gruba ayrılır: telemetry (ölçümler) ve meta (sinyal gücü, sıra numaraları). Bilerek ayrı tutulurlar — birleştirilseydi, ikisinde birden geçen bir anahtar sessizce kaybolurdu.

Çözme, elinden geleni yapar

Çözücü yoksa, çözücü hata verdiyse ya da callback hiç yük taşımıyorsa mesaj yine de yoluna devam eder, elindekiyle. İşleme hattını durdurmaz. İletilen bir mesaj yanlış görünüyorsa payload.decodeError alanına bakın.

Nereden yapılandırılır: Akış → Çözücüler, ya da Profiller. Bkz. Yükü çözün.

4. Kurallar

Sıralı kurallarınız yukarıdan aşağıya çalışır. Koşulu eşleşen ilk kural ne olacağına karar verir: iletmek (isteğe bağlı olarak belirli hedeflere), atmak, cihaza downlink ile yanıt vermek veya henüz gelmemiş bir mesajla birleştirilmek üzere tutmak.

Kural yoksa her mesaj doğrudan geçer.

Nereden yapılandırılır: Akış → Kurallar. Bkz. Kurallarla süzün.

5. Dağıtım

Mesaj hedefleriyle eşleştirilir. Açık yönlendirmeler tanımladıysanız, o kaynağın bağlı olduğu hedeflere gider. Tanımlamadıysanız projedeki tüm aktif hedeflere gider.

Nereden yapılandırılır: Akış → Yönlendirme. Bkz. Bir hedefe yönlendirin.

6. Yapı oluşturma

Her hedef kendi biçimini alır; bu, kaynak → hedef çifti başına uygulanır — tam zarf, ham sağlayıcı çerçevesi, yalnızca çözülmüş ölçümler veya alan alan sizin kurduğunuz bir gövde.

Nereden yapılandırılır: Akış → Yönlendirme, çiftin üzerinde. Bkz. Hedefin ne alacağını seçin.

7. İletim

Şekillendirilmiş gövde hedefe POST edilir. Başarısızlıklar artan beklemelerle yeniden denenir. Sekiz başarısız denemeden sonra iletim ölü mektuba düşer ve sebebi düzeltip yeniden göndermenizi bekler.

Nereye bakılır: Ölü mektuplar ve sayaçlar için Analitik. Bkz. İletim başarısız olduğunda.

En az bir kez, tam olarak bir kez değil

Merkez bir mesajın en az bir kez iletileceğini garanti eder. Mesajı kabul eden ama onayı kaybolan bir hedef, o mesajı tekrar görür.

İletilen her mesaj bir idempotencyKey taşır — gelen mesaj başına sabittir — ve tekrarı sizin tarafınızın böyle tanıması beklenir. Saklayın ve daha önce işlediğiniz anahtarları yok sayın.

Bunu hazır alamadığınız tek biçim, tanımı gereği yalnızca sağlayıcının kendi alanlarını taşıyan ham sağlayıcı çerçevesidir. Böyle bir hedef, tekrarı sağlayıcının alanlarından ayırt etmelidir — Sigfox için cihaz artı sıra numarası.

İşleme hattını tersten okumak

Çıktı yanlışsa bu sıra nereye bakacağınızı söyler:

Belirti	Bakılacak aşama
Analitik hiçbir şey almadığını gösteriyor	1 — uç nokta, gizli anahtar veya ağın callback ayarı
Alınıyor ama mesajda cihaz yok	2 — cihazdaki tanımlayıcı uyuşmuyor
Yük hâlâ hex	3 — çözücü yok, yanlış profil veya `payload.decodeError`
Mesajlar sessizce kayboluyor	4 — bir kural onları atıyor
Yanlış hedef veri alıyor	5 — yönlendirme, ya da hiç yönlendirme olmadığı için yayın
Doğru veri, yanlış biçim	6 — çiftin çıktı yapısı
Aşağıya hiçbir şey ulaşmıyor	7 — Ölü mektuplar

Bu sayfayı düzenle

Hızlı başlangıç

Bir cihazdan bir hedefe, uçtan uca.

Kiracılar ve projeler

Diğer her şeyin içinde yaşadığı iki kap.