Referans
Sözlük
Uygulamanın kullandığı sözcükler ve her birinin tam anlamı.
Uygulama ya da bu belgeler bu sözcükleri kullandığında kastedilen tam olarak şudur.
Sistemin yapısı
| Terim | Anlamı |
|---|---|
| Merkez | Bu uygulama — cihazlarınızın bağlı olduğu ağlar ile verilerini kullanan sistemler arasındaki nokta. |
| Sol taraf | Cihazların yaşadığı ve mesajların geldiği yer: bir Sigfox arka ucu, bir ChirpStack veya TTN sunucusu. |
| Sağ taraf | Veriyi kullanan sistem — bir faturalama platformu, bir HTTP uç noktası. |
| Kaynak (sol) | Yönü Kaynak (sol) olan entegrasyon. |
| Hedef (sağ) | Yönü Hedef (sağ) olan entegrasyon. |
| Sağlayıcı | Bir entegrasyonun ardındaki somut sistem türü: SIGFOX, CHIRPSTACK, TTN, UNA_SU, HTTP, GENERIC. |
| Adaptör | Merkez'in bir sağlayıcının dilini konuşan parçası — callback'lerini doğrular ya da onun biçiminde iletir. Bir ağ eklemenin geliştirme değil yapılandırma olmasının sebebi. |
| Entegrasyon | Başka bir sisteme yapılandırılmış bağlantı: sağlayıcı, yön, kimlik bilgileri ve ayarlar. |
Kaplar
| Terim | Anlamı |
|---|---|
| Kiracı | Bir kurum. Kiracılar iç içe geçer — operatör, bayi, son müşteri — ve her biri kendini ve altındaki her şeyi görür. |
| Aktif kiracı | O an içinde çalıştığınız, kenar çubuğundan seçilen kiracı. Ne göreceğinize ve yeni kayıtların nereye düşeceğine karar verir. |
| Proje | Bir kiracı içindeki dağıtım. Cihazlar, entegrasyonlar, yönlendirmeler ve kurallar tam olarak birine aittir. |
Cihazlar
| Terim | Anlamı |
|---|---|
| Cihaz | Tek bir fiziksel nesne; kaç ağda konuşursa konuşsun bir kez oluşturulur. |
| Teknoloji bağlaması | Bir ağın cihaz için kimliği — Sigfox cihaz ID ve PAC, LoRaWAN DevEUI ve anahtarlar. Bir cihazda birden çok olabilir. |
| Cihaz profili | Bir cihaz modeli: üretici, model, ünitelerinin ihtiyaç duyduğu alanlar ve konuştuğu her radyo için çözücü. O modeldeki her cihaz paylaşır. |
| Alan şeması | Bir profildeki cihazın hangi anahtarları doldurması gerektiği veya doldurabileceği ve her birinin düz öznitelik mi şifreli gizli bilgi mi olduğu. |
| Çözücü | Yük baytlarını adlandırılmış ölçümlere dönüştürür. Gramer (bildirimsel), JavaScript (sandbox'lı) veya yok. |
| Codec | Bir kodlayıcı da taşıyan çözücü: encodeDownlink, bir downlink kuralının komutlarını cihazın alacağı çerçeveye çevirir. Tek satır, iki yön. |
| Komut | Bir downlink'in baytları değil anlamı — { name, args }, örn. valveOpen { value: false }. Kural bunları listeler; codec'in kodlayıcısı yazar. |
| RX1 gecikmesi | LoRaWAN'da Sınıf A bir cihazın uplink'inden ne kadar sonra ilk alma penceresini açtığı (1–15 s). Center'ın downlink'i ancak push bunu geçerse aynı uplink'e biner; 5 s yeter, 1 s asla yetmez. |
| MAC ayarları | Bir LoRaWAN cihazının ağ sunucusundaki radyo parametreleri — alma pencereleri, uyarlanabilir veri hızı, görev döngüsü, sınıf zamanlaması. Center'dan dört katman olarak yönetilir: kiracı → proje → profil → cihaz, sonraki kazanır. |
| Downlink kuyruğu | Bir cihazın, bir sonraki dinleme fırsatını bekleyen komut listesi. Cihaz sayfasından ya da cihazlar listesinden kuyruğa alınır; kuyruktaki komutları dahil eden bir kodlayıcı kuralıyla boşaltılır; her satır Kuyrukta → Gönderildi olur, ağ bildirince Onaylandı ya da Başarısız'a geçer — ya da İptal edildi veya Süresi doldu olarak biter. |
| Onaylandı / Başarısız (downlink) | Gönderildi bir komutun akıbeti. Ağ çerçeveyi bildirir — LoRaWAN'da LNS'in onu adlandıran downlink_ack / downlink_nack / downlink_failed olayları, Sigfox'ta SERVICE_ACKNOWLEDGE callback'i — ve Merkez satırları sonuçlandırır: cihaz aldıysa Onaylandı, değilse ağın gerekçesiyle Başarısız. |
| telemetry / meta | Bir çözücünün döndürdüğü iki grup — cihazın ölçtüğü ve iletimle ilgili olan. Hedefinize kadar ayrı kalır. |
Yoldaki veri
| Terim | Anlamı |
|---|---|
| Mesaj | Normalleştirilmiş tek bir gelen yük. Geçicidir — iletilene kadar tutulur, sonra silinir. |
| İletim | Bir mesajı bir hedefe ulaştırma girişimi. Üç hedefe giden bir mesaj, üç iletimdir. |
| Idempotency anahtarı | Gelen mesaj başına sabit bir anahtar; tarafınızın tekrarı tanıması için. Merkez en az bir kez iletir. |
| Ölü mektup | Sekiz denemesini tüketmiş bir iletim. İncelenmek ve yeniden gönderilmek üzere park eder, kaybolmaz. |
| Yeniden gönderim | Ölü mektuptaki bir iletimi yeniden kuyruğa alma. Güncel yapılandırmayla yeniden kurulur; "düzelt, sonra yeniden gönder"in çalışmasının sebebi budur. |
Yönlendirme
| Terim | Anlamı |
|---|---|
| Yönlendirme | Bir kaynak ile bir hedef arasındaki kablo. Hiçbiri tanımlı değilse proje her aktif hedefe yayın yapar. |
| Kural | İletimden önce yukarıdan aşağıya değerlendirilen bir koşul ve bir eylem — ilet, at, downlink ile yanıtla veya bekle ve ilişkilendir. |
| Çıktı yapısı | Bir hedefe iletilen biçim; kaynak → hedef çifti başına ayarlanır. Tam mesaj, ham sağlayıcı çerçevesi, yalnızca çözülmüş telemetri, her şey çözülmüş veya özel. |
| Downlink | Cihaza geri giden yanıt — Sigfox'ta uplink'ini taşıyan callback'in cevabında, LoRaWAN'da cihazın bir sonraki alma penceresi için LNS'in kuyruğuna gönderilir. |
Uç noktalar
| Terim | Anlamı |
|---|---|
| Uç nokta | Bir ağın mesajları POST ettiği adres. Merkez belirteci yoktur — yükü kaynağın adaptörü doğrular. |
| Uç nokta anahtarı | Bir uç noktayı adresleyen anlamsız belirteç: proje için pk_, kaynak için sk_, cihaz için dk_. Tahmin edilemez ve döndürülebilir — ama kimlik doğrulaması değil, kapsam belirleyicidir. |
| Kısa ad (slug) | İsteğe bağlı okunabilir takma ad — proje için …/i/<ad>, kaynak için …/i/s/<ad>. Tasarım gereği tahmin edilebilir; yükü yine adaptör doğrular. |
Sağlama
| Terim | Anlamı |
|---|---|
| Sağlama | Merkez'in kaydına uyacak şekilde sağlayıcıda bir cihaz, cihaz tipi veya callback oluşturmak ya da güncellemek. |
| Plan / Uygula | Gönderilecek isteği tam olarak gösteren kuru çalışma ve gerçeği. Uygula kapatılabilir ve idempotenttir — yeniden çalıştırmak çoğaltmaz, uzlaştırır. |
| Sözleşme | Sigfox'ta bir cihaz tipinin neye izinli olduğu — downlink taşıyıp taşıyamayacağı dâhil. Cihaz tipi oluşturulurken sabitlenir. |
| Etkinleştirme (OTAA / ABP) | Bir LoRaWAN cihazının oturumunu nasıl edindiği. OTAA: LNS'in Join Server'ında tutulan kök anahtarlarla — JoinEUI, AppKey, 1.1'de NwkKey — havadan katılır; olağan durum. ABP: zaten bir oturum taşır — DevAddr, NwkSKey, AppSKey — bunlar doğrudan Network ve Application Server'a gider, katılım yoktur. |
| Sahiplenme | Ağda zaten var olan bir şeyle başlamak — bir Sigfox cihazı ya da cihaz tipi, bir LNS organizasyonu, uygulaması ya da uç cihazı: Merkez onu kendi kaydı olarak alır ve hiçbir şeyi yeniden kaydetmez. LNS’te zaten olan birini sahiplen, projenin uygulamasındaki bir uç cihazı seçer; anahtarları orada kalır. |
Yönetilen kimlik bilgisi (sigfox-auto / tts-auto) | Merkez'in bir kiracıyı sağlarken kendi ürettiği ve sakladığı kimlik bilgisi — Sigfox API kullanıcısı ya da The Things Stack'teki una-center organizasyon API anahtarı. Yönetilen olarak görünür. Kiracının kendi çağrıları onunla çıkar; kiracıyı yeniden uygulamak onu korur ya da döndürür. Elle düzenlemeyin, silmeyin. |