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ış
| Kural | Telemetri | Nitelikler |
|---|---|---|
| Karakterler | A–Z a–z 0–9 _ . - | Aynı |
| Uzunluk | 1 ile 64 arası | 1 ile 128 arası (cfg.* dışındaki shared anahtarlar: 57) |
| Asla anahtar olamaz | deleted | |
| Ayrılmış önek | _, fw_, current_fw_, cfg. | _ (platform); fw_, current_fw_ (ürün yazılımı) |
| Büyük/küçük harf | Bü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 desen | Sahibi | Amaç |
|---|---|---|
_* | Platform | Dahili anahtarlar |
fw_* | Ürün yazılımı güncellemeleri | Cihaza sunulan güncelleme (shared) ve cihazın ilerlemesi (client) |
current_fw_* | Cihaz | Cihazın çalıştırdığı sürüm |
*.state, *.reason | Cihaz 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_hash | Cihaz | Yapılandırma kayıtları |
attr_error | Cihaz | Uygulayamadığı bir nitelik |
rpc_result | Cihaz | Uzun süren bir komutun sonucu |
cert_not_after | Cihaz | Sertifikasının sona erme zamanı |
time_quality | Cihaz veya ağ geçidi | Zaman damgalarının senkronize bir saatten gelip gelmediği |
session_limits | Platform | Cihazın etkin hız sınırları; gönderildikleri anda hesaplanır ve asla saklanmaz |
deleted | Hat ü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_version | Paketin adı ve sürümü |
fw_size | Bayt cinsinden boyut |
fw_checksum, fw_checksum_algorithm | Küçük harfli hex ve SHA256 |
fw_url | 15 dakika geçerli, kısa ömürlü bir HTTPS indirme adresi |
fw_sig | Varsa ayrık imza |
fw_allow_metered | Cihazın kotalı bir bağlantı üzerinden indirme yapıp yapamayacağı |
Cihaz tarafından client nitelikleri olarak bildirilir:
| Anahtar | İçerik |
|---|---|
fw_state | DOWNLOADING, DOWNLOADED, VERIFIED, UPDATING, UPDATED, FAILED |
fw_error | FAILED ile birlikte bir hata kodu |
fw_progress | İndirme sırasında 0 ile 100 arası |
fw_wait | Cihaz 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ı
| Anahtar | Kapsam | Anlam |
|---|---|---|
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_hash | Client | Cihazın yapılandırması hakkındaki yanıtı |
Bkz. Uzaktan cihaz ayarları.
Anlamı olan telemetri anahtarları
| Anahtar | Okuyan | Anlam |
|---|---|---|
status | Saha 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ışlar | JSON 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, lng | Hazı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
| Anahtar | Kapsam | Yazan | Anlam |
|---|---|---|---|
liveUrl | Server | Kameralar | Canlı görüntü açıkken kameranın canlı bağlantısı |
liveUrlHigh | Server | Kameralar | Kameranın kullanılabilir ikinci bir H.264 akışı olduğunda daha yüksek kaliteli bağlantı |
esim.capability, esim.profiles | Client | Lisanslı yönlendiriciler | Yö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üm | Telemetri 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, consumption | lowLevelThreshold, highLevelThreshold, capacityCm, minPressure |
| Uzak sahalar | air_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ölgeleri | air_temp, air_hum, battery, plan_x, plan_y; istasyon: acc_rainfall, pressure, light, wind_dir, wind_speed | maxTempThreshold, minTempThreshold, warnTempThreshold, maxHumThreshold, minHumThreshold, warnHumThreshold; bölge varlığı: floorPlan |
| Personel takibi | lat, lng, zone, event, battery, air_temp, light | forbiddenZone; bölge varlığı: beacon |
Bkz. Hazır çözümler.
Diğer ayrılmış adlar
| Ad | Nerede |
|---|---|
provision | Provisioning oturumları için ayrılmış bir MQTT kullanıcı adı |
v1/ altındaki topic’ler | Yalnızca belgelenmiş topic’ler; bilinmeyen bir topic unknown_reserved_topic olarak reddedilir |
admin gibi organizasyon adresleri | Ayrı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 adlar | Kişilerin görünen adları için ayrılmıştır; bir organizasyon daha fazlasını ayırabilir. Bkz. Profiliniz, dil ve saat dilimi. |

