Bir gateway, Hermetry’ye kendileri ulaşamayan saha cihazlarından (Modbus sayaçlar, RS485 kontrolörler, BLE sensörler ve diğerleri) veri toplar ve bunu kendi bağlantısı üzerinden iletir. Hermetry her saha cihazını bir alt cihaza (child device) dönüştürür: ölçümleri, öznitelikleri, alarmları ve panoları olan kendi başına bir cihaz. Bu sayfa gateway tarafının tam başvuru kaynağıdır. Kısa bir özet için bkz. Gateway’ler ve gateway arkasındaki cihazlar.
Hermetry Edge çalıştıran lisanslı bir gateway bunların hepsini sizin için yapar; bkz. Lisanslı gateway’ler ve Hermetry Edge. Gateway yazılımını kendiniz yazıyorsanız veya verilere ne olduğunu merak ediyorsanız okumaya devam edin.
Hermetry bulutunda saha cihazları Hermetry Edge üzerinden okunur; kendi ağ geçidi yazılımınız şirket içi (on-premises) kurulumlar içindir.
Gateway cihazını kurma
- Gateway için bir cihaz profili oluşturun veya seçin. Varsayılan
v1/topic şemasını kullanmalıdır. Legacy compatible şeması gateway API’si içermez. - Devices > New device altında gateway’i ekleyin ve This device is a gateway seçeneğini açın. Bu seçeneği olmayan bir cihaz her
v1/gw/*topic’inde reddedilir (forbidden_topic). - Gateway’e, diğer MQTT cihazlarında olduğu gibi kimlik bilgilerini (erişim token’ı, MQTT basic veya X.509 sertifikası) verin. Bkz. Cihaz kimlik bilgileri.
- İsteğe bağlı: gateway’in profilinde Profile of new children ve Max children of a gateway ayarlarını yapın (aşağıya bakın).
Gateway kendi adıyla oturum açar. Alt cihazların kendi kimlik bilgileri yoktur ve hiçbir zaman oturum açmazlar.
Topic’ler ve payload’lar
Tüm gateway topic’leri QoS 1 kullanır.
| Topic (gateway’den Hermetry’ye) | Payload | 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 belirler. |
v1/gw/disconnect | {"device": "Meter A"} | Alt cihaz ayrıldı. |
v1/gw/telemetry | Aşağıya bakın | Bir veya daha fazla alt cihazın ölçümleri. |
v1/gw/attributes | {"Meter A": {"lora.rssi": -97}} | Bir veya daha fazla alt cihazın istemci öznitelikleri. |
Telemetri, alt cihaz adına göre anahtarlanmış bir nesnedir. Her alt cihaz bir kayıt veya bir kayıt listesi içerir:
{
"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 zamandır (milisaniye). Gateway’in saati ayarlı değilse bunu çıkarın; Hermetry bu durumda varış zamanını kullanır. Bkz. Zaman damgaları, geç ve yinelenen ölçümler.values, herhangi bir cihazın telemetrisiyle aynı anahtar ve değer kurallarını izler. Bkz. Telemetri anahtarları.- Bir kayıt, ölçüm hakkında bilgi içeren isteğe bağlı bir
metanesnesi taşıyabilir, örneğin"meta": {"lora": {"rssi": -97, "snr": 7.5}}.metaen fazla 256 bayttır. Hiçbir zaman ölçüm olarak saklanmaz. Yalnızca içindekiloravesnmpüyeleri (her biri en fazla 8 düz değer) mesaj metadata’sı olarak flow’larınıza aktarılır; geri kalan her şey yok sayılır. valuesiçermeyen veyatsdeğeri pozitif bir sayı olmayan 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 yoksa gateway’in varış zamanından mı geldiğini ve gateway saatinin senkronize edilip edilmediğini belirtir. Yalnızca bilgilendiricidir.
Alt cihazlar nasıl oluşturulur
Hermetry, gateway bir alt cihazı ilk kez bildirdiğinde (connect, telemetri veya öznitelikler ile) onu oluşturur. connect olmadan telemetride görülen bir alt cihaz bağlı sayılır.
- Alt cihaz, gateway’in organizasyonuna aittir. Ayrıca sahiplenilmez.
- Profil, şu sırayla: organizasyonunuzda
connectiçinde gönderilentypeile tam olarak aynı adı taşıyan bir profil; yoksa gateway profilinin Profile of new children ayarı; o da yoksa Hermetry’nin ilk gereken anda oluşturduğu yerleşik Generic child profile.typeolmadan duyurulan bir alt cihaz ilk adımı atlar. - Cihaz adı: alt cihazın hat üzerindeki (wire) adı. Organizasyonunuzda bu adda bir cihaz zaten varsa ad
<wire name> · <gateway name>olur, ardından bu ada2,3vb. eklenir. - Alt cihazı Hermetry’de yeniden adlandırmak wire adını değiştirmez. Gateway ona göndermiş olduğu adla seslenmeye devam eder.
- Yepyeni bir alt cihazın ilk kayıtları, cihaz oluşturulurken atılabilir. Hermetry alt cihazı bir kez ister ve sonraki mesaj onu bulur.
Alt cihaz adları
| Kural | Değer |
|---|---|
| Uzunluk | 1 ila 128 karakter |
| İzin verilmeyenler | Kontrol karakterleri, baştaki veya sondaki boşluk |
| Büyük/küçük harf | Büyük/küçük harfe duyarlı: abc ve ABC aynı gateway’in iki ayrı alt cihazıdır |
| Benzersizlik | Gateway başına |
Bir kuralı çiğneyen ad atlanır ve sayılır; mesajdaki diğer alt cihazlar korunur.
Doğrudan bağlanan cihaz önceliklidir. Alt cihaz adı, organizasyonunuzda kendi kimlik bilgileri olan bir cihazın seri numarasıyla aynıysa (büyük/küçük harf gözetilmeden karşılaştırılır), alt cihaz reddedilir (child_conflict_direct) ve alt cihaz oluşturulmaz. Bu, kendi bulut oturumunu çalıştıran bir cihazın iki kez görünmesini önler.
Limitler
| Limit | Değer |
|---|---|
| Gateway 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 platform üst sınırı olan 1.000’i asla aşamaz |
| Cihaz limiti | Her alt cihaz planınızın cihaz limitine dahil sayılır |
| Tek bir gateway mesajı | En fazla 64 KiB; gateway profilinin Max message payload (bytes) değeri daha düşükse o |
| Tek mesajdaki alt cihazlar | 500; fazlası atlanır |
| Tek mesajda alt cihaz başına kayıtlar | 1.000; fazlası atlanır |
Kayıt başına meta | 256 bayt |
Alt cihaz limitini veya cihaz limitini aşacak bir alt cihaz reddedilir (child_limit veya device_limit) ve kayıtları atılır.
Hız limitleri iki kez uygulanır. Önce gateway’in kendi profil limitleri, her alt cihazın veri noktaları dahil tüm mesajı sayar. Sonra her alt cihazın kendi profil limitleri kendi kısmına uygulanır: limitini aşan bir alt cihaz yalnızca kendi kayıtlarını kaybeder (child_rate_limited). Limit alanları için Cihaz profilleri ve Mesaj kotası ve kullanım sayfalarına bakın.
Bağlantı durumu
connectvedisconnectalt cihazın bağlantı durumunu belirler.- Gateway ç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 bırakılır: kayıtları artık kabul edilmez.
Sorun giderme
| Belirti | Neden ve çözüm |
|---|---|
Gateway birkaç v1/gw/* mesajından sonra bağlantısı kesiliyor | Cihaz gateway olarak işaretlenmemiş. Bir dakika içinde üç reddedilen topic 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ı çiğniyor, alt cihaz veya cihaz limitine ulaşılmış ya da doğrudan bağlanan 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 gateway’in profilinde Profile of new children ayarını yapın. Mevcut bir alt cihazın profilini değiştirme işlemi alt cihazın cihaz sayfasında yapılır. |
| Bir alt cihaz iki ad gösteriyor | Bu wire adıyla bir cihaz zaten vardı, bu nedenle alt cihaz <wire name> · <gateway name> olarak adlandırıldı. |

