Ağ geçidinin arkasındaki cihazlar

Bir ağ geçidi (gateway), Hermetry’ye kendisi bağlanamayan saha cihazlarından (Modbus sayaçları, RS485 denetleyicileri, BLE sensörleri ve diğerleri) veri toplar ve bunu kendi bağlantısı üzerinden gönderir. Hermetry her saha cihazını bir alt cihaza dönüştürür: okumaları, öznitelikleri, alarmları ve panoları olan kendi başına bir cihaz. Bu sayfa, ağ geçidi tarafı için tam başvuru kaynağıdır. Kısa bir özet için bkz. Ağ geçidi ve ağ geçidinin arkasındaki cihazlar.

Hermetry Edge çalıştıran lisanslı bir ağ geçidi tüm bunları sizin yerinize yapar; bkz. Lisanslı ağ geçitleri ve Hermetry Edge. Ağ geçidi yazılımını kendiniz yazıyorsanız veya verilerin ne olduğunu öğrenmek istiyorsanız okumaya devam edin.

Ağ geçidi cihazını kurun

Ağ geçidi için bir cihaz profili oluşturun veya seçin. Varsayılan v1/ konu düzenini kullanmalıdır. Legacy compatible düzeni hiçbir ağ geçidi API’si taşımaz.
Devices > New device altında ağ geçidini ekleyin ve This device is a gateway seçeneğini açın. Bu seçenek olmayan bir cihaz her v1/gw/* konusunda reddedilir (forbidden_topic).
Ağ geçidine, diğer her MQTT cihazı gibi kimlik bilgilerini (erişim belirteci, MQTT temel kimlik doğrulaması veya X.509 sertifikası) verin. Bkz. Cihaz kimlik bilgileri.
İsteğe bağlı: ağ geçidinin profilinde Profile of new children ve Max children of a gateway değerlerini ayarlayın (aşağıya bakın).

Ağ geçidi kendi adıyla oturum açar. Alt cihazlar kendi kimlik bilgilerini hiçbir zaman almaz ve hiçbir zaman oturum açmaz.

Konular ve yükler

Tüm ağ geçidi konuları QoS 1 kullanır.

Konu (ağ geçidinden Hermetry’ye)	Yük	Anlamı
`v1/gw/connect`	`{"device": "Meter A", "type": "lorawan-meter"}`	Alt cihaz mevcut. `type` isteğe bağlıdır ve alt cihazın profilini seçer.
`v1/gw/disconnect`	`{"device": "Meter A"}`	Alt cihaz artık yok.
`v1/gw/telemetry`	Aşağıya bakın	Bir veya daha fazla alt cihazın okumaları.
`v1/gw/attributes`	`{"Meter A": {"lora.rssi": -97}}`	Bir veya daha fazla alt cihazın istemci öznitelikleri.

Telemetri, alt cihaz adıyla anahtarlanmış bir nesnedir. Her alt cihaz tek bir kayıt veya kayıt listesi taşır:

{
  "Meter A": [
    {"ts": 1759572000000, "values": {"kwh": 1203.4, "voltage": 229.8}},
    {"ts": 1759572060000, "values": {"kwh": 1203.6, "voltage": 230.1}}
  ],
  "Meter B": {"values": {"flow_m3h": 12.7}}
}

ts, değerin elde edildiği zamanı milisaniye cinsinden verir. Ağ geçidinin saati ayarlanmamışsa bunu çıkarın; Hermetry bu durumda geliş zamanını kullanır. Bkz. Zaman damgaları, geç ve yinelenen okumalar.
values, herhangi bir cihazın telemetrisiyle aynı anahtar ve değer kurallarını izler. Bkz. Telemetri anahtarları.
Bir kayıt, okuma hakkında bilgi içeren isteğe bağlı bir meta nesnesi taşıyabilir; örneğin "meta": {"lora": {"rssi": -97, "snr": 7.5}}. meta en fazla 256 bayttır. Hiçbir zaman okuma olarak saklanmaz. Yalnızca lora ve snmp üyeleri (her biri en fazla 8 düz değer) akışlarınıza mesaj üst verisi olarak iletilir; diğer her şey yok sayılır.
values içermeyen veya ts değeri pozitif bir sayı olmayan bir kayıt atlanır. Mesajın geri kalanı korunur.

Bir alt cihazdaki isteğe bağlı time_quality istemci özniteliği, {"source": true, "arrival": false, "synced": true}, zaman damgalarının alt cihazın kendi saatinden mi, ağ geçidinin geliş zamanından mı geldiğini ve ağ geçidinin saatinin senkronize edilip edilmediğini belirtir. Bilgi amaçlıdır.

Alt cihazlar nasıl oluşturulur

Ağ geçidi bir alt cihazı ilk kez connect, telemetri veya öznitelikler yoluyla bildirdiğinde Hermetry onu oluşturur. connect olmadan telemetride görülen bir alt cihaz bağlı sayılır.

Alt cihaz ağ geçidinin kuruluşuna aittir. Ayrıca talep edilmez.
Profil, şu sırayla belirlenir: connect ile gönderilen type ile tam olarak aynı adlı, kuruluşunuzdaki bir profil; yoksa ağ geçidi profilinin Profile of new children değeri; yoksa Hermetry’nin gerektiğinde ilk kez oluşturduğu yerleşik Generic child profile. type olmadan bildirilen bir alt cihaz ilk adımı atlar.
Cihaz adı: alt cihazın tel üzerindeki adı. Bu adla bir cihaz kuruluşunuzda zaten varsa ad <tel adı> · <ağ geçidi adı> olur, ardından bu ad 2, 3 ve benzeri eklerle devam eder.
Alt cihazı Hermetry’de yeniden adlandırmak, tel üzerindeki adını değiştirmez. Ağ geçidi onu gönderdiği adla adreslemeye devam eder.
Yeni oluşturulan bir alt cihazın ilk kayıtları, o oluşturulurken düşürülebilir. Hermetry alt cihazı bir kez ister ve sonraki mesaj onu bulur.

Alt cihaz adları

Kural	Değer
Uzunluk	1 ila 128 karakter
İzin verilmez	Denetim karakterleri, baştaki veya sondaki boşluk
Büyük/küçük harf	Büyük/küçük harfe duyarlı: `abc` ve `ABC`, bir ağ geçidinin iki ayrı alt cihazıdır
Benzersizlik	Ağ geçidi başına

Bir kuralı bozan ad atlanır ve sayılır; mesajın diğer alt cihazları korunur.

Doğrudan bağlanan cihaz kazanır. Alt cihaz adı, kuruluşunuzda kendi kimlik bilgilerine sahip bir cihazın seri numarasıyla aynıysa (büyük/küçük harf duyarsız karşılaştırılır), alt cihaz reddedilir (child_conflict_direct) ve hiçbir alt cihaz oluşturulmaz. Bu, kendi bulut oturumunu çalıştıran bir cihazın iki kez görünmesini önler.

Sınırlar

Sınır	Değer
Ağ geçidi başına alt cihaz	Profilin Max children of a gateway değeri (varsayılan 500), planınızın değerini (plan belirtmiyorsa 500) veya 1.000 olan platform üst sınırını asla aşmaz
Cihaz sınırı	Her alt cihaz planınızın cihaz sınırına dahil edilir
Bir ağ geçidi mesajı	En fazla 64 KiB; ağ geçidi profilinin Max message payload (bytes) değeri daha düşükse o
Bir mesajdaki alt cihazlar	500; fazlası atlanır
Bir mesajda alt cihaz başına kayıt	1.000; fazlası atlanır
Kayıt başına `meta`	256 bayt

Alt cihaz sınırını veya cihaz sınırını aşacak bir alt cihaz reddedilir (child_limit veya device_limit) ve kayıtları düşürülür.

Hız sınırları iki kez uygulanır. Önce ağ geçidinin kendi profil sınırları, her alt cihazın veri noktaları dahil tüm mesajı sayar. Ardından her alt cihazın kendi profil sınırları kendi payına uygulanır: sınırını aşan bir alt cihaz yalnızca kendi kayıtlarını kaybeder (child_rate_limited). Sınır alanları için bkz. Cihaz profilleri; kota ve kullanım için bkz. Mesaj kotası ve kullanım.

Bağlantı durumu

connect ve disconnect, alt cihazın bağlantı durumunu ayarlar.
Ağ geçidi çevrimdışı olduğunda, tüm alt cihazları da onunla birlikte çevrimdışı olur.
Devre dışı bırakılan bir alt cihaz yaklaşık bir dakika içinde düşürülür: kayıtları artık kabul edilmez.

Alt cihazlara komutlar

Bir ağ geçidi üzerinden bir alt cihaza komut ve paylaşımlı öznitelik değişiklikleri göndermek geliştirme aşamasındadır. Henüz buna dayanarak bir şey geliştirmeyin. Bkz. Ağ geçidinin arkasındaki cihazlara komutlar.

Sorun giderme

Belirti	Neden ve çözüm
Birkaç `v1/gw/*` mesajından sonra ağ geçidinin bağlantısı kesiliyor	Cihaz ağ geçidi olarak işaretlenmemiş. Bir dakikada üç reddedilen konu oturumu kapatır. This device is a gateway seçeneğini açın.
Hiçbir alt cihaz görünmüyor	Alt cihaz adı bir kuralı bozuyor, alt cihaz veya cihaz sınırına ulaşıldı ya da doğrudan bir cihaz bu seri numarasını kullanıyor. Kullanım bölümünden cihaz sayınızı kontrol edin.
Bir alt cihazın profili yanlış	`type` bir profil adıyla tam olarak eşleşmiyor. Profili yeniden adlandırın veya ağ geçidinin profilinde Profile of new children değerini ayarlayın. Var olan bir alt cihazın profilini değiştirmek, alt cihazın cihaz sayfasından yapılır.
Bir alt cihazın iki adı var	Tel adına sahip bir cihaz zaten vardı, bu yüzden alt cihaz `<tel adı> · <ağ geçidi adı>` olarak adlandırıldı.