Yeni: Yapay zekâ güvenlik duvarı tüm platformu izliyor ve her olayı sade bir dille açıklıyor. Nasıl çalıştığını görün

Ayrılmış key’ler ve attribute’lar

Hermetry'nin sahip olduğu veya okuduğu key adları – ayrılmış önekler, firmware ve yapılandırma attribute'ları, kayıt tutma key'leri, durum, raw, kamera, eSIM ve çözüm key'leri.

Bazı telemetri anahtarlarının ve niteliklerin (attribute) Hermetry içinde sabit bir anlamı vardır. Bazılarını siz hiç yazamazsınız; bazıları platform veya cihaz tarafından yazılır ve ürün yazılımı güncellemeleri, saha durumu veya kameralar gibi özellikler tarafından okunur. Bu sayfa onları listeler; böylece çakışmalardan kaçınabilir ve ihtiyacınız olanları kullanabilirsiniz.

Kurallara kısa bakış

KuralTelemetriNitelikler
KarakterlerA–Z a–z 0–9 _ . -Aynı
Uzunluk1 ile 64 arası1 ile 128 arası (cfg.* dışındaki shared anahtarlar: 57)
Asla anahtar olamazdeleted
Ayrılmış önek_, fw_, current_fw_, cfg._ (platform); fw_, current_fw_ (ürün yazılımı)
Büyük/küçük harfBüyük/küçük harfe duyarlıBüyük/küçük harfe duyarlı

Ayrılmış önekli bir telemetri anahtarı key_reserved ile düşürülür; mesajın geri kalanı saklanır. Ayrılmış anahtarla yapılan bir öznitelik yazımı keys_invalid ve anahtarın nedeni reserved ile reddedilir. Bkz. Telemetry keys ve Attributes.

Asla yazamayacağınız anahtarlar

Kişiler, API ve akışlar bunları server veya shared nitelik olarak yazamaz:

Anahtar veya desenSahibiAmaç
_*PlatformDahili anahtarlar
fw_*Ürün yazılımı güncellemeleriCihaza sunulan güncelleme (shared) ve cihazın ilerlemesi (client)
current_fw_*CihazCihazın çalıştırdığı sürüm
*.state, *.reasonCihaz veya ağ geçidiİstenen bir değerin sonucu: bir ağ geçidi, alt cihaza uyguladığı shared nitelik için <key>.state ve <key>.reason ile yanıt verir
cfg_rejected, cfg_applied_ts, cfg_hashCihazYapılandırma kayıtları
attr_errorCihazUygulayamadığı bir nitelik
rpc_resultCihazUzun süren bir komutun sonucu
cert_not_afterCihazSertifikasının sona erme zamanı
time_qualityCihaz veya ağ geçidiZaman damgalarının senkronize bir saatten gelip gelmediği
session_limitsPlatformCihazın etkin hız sınırları; gönderildikleri anda hesaplanır ve asla saklanmaz
deletedHat üzerinde kaldırılan anahtarların işareti

Ürün yazılımı anahtarları

Bir güncelleme sunulduğunda Hermetry tarafından shared nitelikler olarak yazılır:

Anahtarİçerik
fw_title, fw_versionPaketin adı ve sürümü
fw_sizeBayt cinsinden boyut
fw_checksum, fw_checksum_algorithmKüçük harfli hex ve SHA256
fw_url15 dakika geçerli, kısa ömürlü bir HTTPS indirme adresi
fw_sigVarsa ayrık imza
fw_allow_meteredCihazın kotalı bir bağlantı üzerinden indirme yapıp yapamayacağı

Cihaz tarafından client nitelikleri olarak bildirilir:

Anahtarİçerik
fw_stateDOWNLOADING, DOWNLOADED, VERIFIED, UPDATING, UPDATED, FAILED
fw_errorFAILED ile birlikte bir hata kodu
fw_progressİndirme sırasında 0 ile 100 arası
fw_waitCihaz güncellemeyi beklemede tutarken metered, quota_exhausted veya approval
current_fw_title, current_fw_versionŞu anda çalışan sürüm; her bağlantıdan sonra gönderilir

Bkz. Ürün yazılımı güncellemeleri (OTA).

Yapılandırma anahtarları

AnahtarKapsamAnlam
cfg.*Yalnızca sharedİstenen yapılandırma, anahtar başına en fazla 128 karakter. Cihaz uyguladığını geri bildirir. Ayarları Ayarlar sekmesinden yönetilen lisanslı bir cihazda yazma isteği 409 yanıtı verir: değişikliği orada yapın.
cfg_rejected, cfg_applied_ts, cfg_hashClientCihazın yapılandırması hakkındaki yanıtı

Bkz. Uzaktan cihaz ayarları.

Anlamı olan telemetri anahtarları

AnahtarOkuyanAnlam
statusSaha durumu, saha görünümleri, 3D renk tonlarıcritical, alarm, error, fault, danger, 2, true Kritik anlamına gelir; warning, warn, 1 Uyarı anlamına gelir; diğer her şey Normal. Bir kart bunun yerine başka bir anahtarı okuyabilir. Bkz. Saha durumu ve status anahtarı.
rawÇözücüler, akışlarJSON nesnesi olmayan ve metin olarak saklanan bir gövde (varsayılan 4.096 bayt). Bkz. Telemetri anahtarları.
<topic>.<key>Profil anahtarlara topic önekini eklediğinde özel bir topic’in anahtarları
lat, lngHazır çözümlerin harita kartlarıKonum. Diğer panolar herhangi bir sütun adı kullanabilir.
<element>.<field>Proses çizimleriÇizilmiş bir elemanın okumaları, örneğin p1.running, pt.value

Not

status içinde true Kritik anlamına gelir. “Çalışıyor” demek için status: true göndermeyin.

Modüller tarafından yazılan nitelikler

AnahtarKapsamYazanAnlam
liveUrlServerKameralarCanlı görüntü açıkken kameranın canlı bağlantısı
liveUrlHighServerKameralarKameranın kullanılabilir ikinci bir H.264 akışı olduğunda daha yüksek kaliteli bağlantı
esim.capability, esim.profilesClientLisanslı yönlendiricilerYönlendiricinin eSIM çipi ve profilleri.

Bkz. Panolarda kameralar.

Komut yöntemi aileleri

Bazı komut yöntemleri bir modüle aittir ve yalnızca o modül gönderebilir: örneğin tunnel.* (uzaktan erişim) ve esim.*. Bunlar için yapılan istek 403 rpc_method_reserved yanıtı verir. Fabrika ayarlarına dönme, eşleştirme, Wi-Fi’yi unutma ve cloud.forget buluttan asla gönderilmez. Bkz. Cihazlara komut gönderme.

Hazır çözümlerin kullandığı adlar

Hazır çözümler bu anahtarları ve server niteliklerini okur. Ayrılmış değildirler; cihazlarınızı bir çözüme uydurmak için kullanın.

ÇözümTelemetri anahtarlarıServer nitelikleri
Su sahasılevel_cm, level_pct, rssi; p1.running, p2.running, pt.value, fm.value, *.status, manual, p1_run, p2_run, phase1–phase3, thermal1, thermal2, consumptionlowLevelThreshold, highLevelThreshold, capacityCm, minPressure
Uzak sahalarair_temp, air_hum, door_open, water_leak, smoke, battery_env, battery_water, battery_door, battery_smoke; ups_a_*, ups_b_*highTempThreshold, lowTempThreshold, highHumThreshold, lowHumThreshold
Hava istasyonlarıair_temp, air_hum, baro_pressure, rain_intensity, acc_rainfall, wind_speed_avg, wind_speed_min, wind_speed_max, wind_dir_avg, wind_dir_min, wind_dir_max, rain_reset
Sensör bölgeleriair_temp, air_hum, battery, plan_x, plan_y; istasyon: acc_rainfall, pressure, light, wind_dir, wind_speedmaxTempThreshold, minTempThreshold, warnTempThreshold, maxHumThreshold, minHumThreshold, warnHumThreshold; bölge varlığı: floorPlan
Personel takibilat, lng, zone, event, battery, air_temp, lightforbiddenZone; bölge varlığı: beacon

Bkz. Hazır çözümler.

Diğer ayrılmış adlar

AdNerede
provisionProvisioning oturumları için ayrılmış bir MQTT kullanıcı adı
v1/ altındaki topic’lerYalnızca belgelenmiş topic’ler; bilinmeyen bir topic unknown_reserved_topic olarak reddedilir
admin gibi organizasyon adresleriAyrılmış adlar bir organizasyonun adresi olamaz. Bkz. Hesabınızı oluşturun ve bir bölge seçin.
admin, support, owner gibi görünen adlarKişilerin görünen adları için ayrılmıştır; bir organizasyon daha fazlasını ayırabilir. Bkz. Profiliniz, dil ve saat dilimi.

İlgili