Bir cihaz profili, bir cihaz türünün nasıl davrandığını tanımlar. Her cihaz tam olarak bir profil kullanır. Profili değiştirirseniz, ona bağlı her cihaz bunu izler. Cihaz türü başına bir profil oluşturun: sensör modeli başına, firmware ailesi başına veya güvenlik ihtiyacı başına bir profil (örneğin bir TLS profili ve TLS yapamayan eski cihazlar için bir profil).
Profillere IoT menüsündeki Device Profiles bölümünden erişin. Görüntüleme için User rolü gerekir; değiştirme için Admin gerekir. Provisioning stratejisi ve anahtarlar için provisioning yönetme yetkisi (yöneticiler) ayrıca gerekir.
Profil listesi
Listede Name, Transport, Online rule, Devices (sayı her 30 sn’de güncellenir) ve Updated sütunları görünür; Default, Built-in ve Platform template rozetleri de gösterilir. Ada göre arama yapabilir, transport ve online rule’a göre filtreleyebilirsiniz.
Yeni bir profil oluşturmak için New profile seçeneğini seçin, bir Name, bir Description ve Transport girin ve Create profile seçeneğini seçin. Limitler, topic’ler ve girişler protokolün varsayılan değerlerinden başlar; bunları profil sayfasında değiştirirsiniz. Profili kaydetmeden önce bir online rule seçmeniz gerekir.
Varsayılan profil
Her kuruluşun tam olarak bir varsayılan profili vardır. Hermetry, ilk ihtiyaç duyduğunda Default adlı bir profil oluşturur. Bu profil şunları kullanır:
- Live connection online rule’u,
- varsayılan topic şeması,
- yalnızca access-token girişi,
- protokolün standart limitleri,
- provisioning Disabled,
- TLS only (port 8883).
Oluşturduğunuz ilk profil de varsayılan olur. Başka bir profili varsayılan yapmak için onu açın ve Make default seçeneğini seçin. Profil adı belirtmeyen yeni cihazlar varsayılan profili alır.
Yerleşik profiller
Bazı protokollerle birlikte, Built-in profile olarak işaretlenmiş yerleşik bir profil gelir. Hermetry, ihtiyaç duyulduğunda ilk kez oluşturur:
| Yerleşik profil | Kullanan |
|---|---|
| LoRaWAN EU868 Class A OTAA (1.0.3) | New device > LoRaWAN device ile eklenen LoRaWAN sensörleri |
| LoRaWAN gateway | Basics Station gateway’leri |
| Kamera protokolünün profili | Bu protokoldeki kameralar ve kayıt cihazları |
Yerleşik bir profil transport’unu korur (“A built-in profile keeps its transport: devices of its protocol are registered with it.”) ve silinemez. Üzerindeki diğer her şey düzenlenebilir ve adını değiştirebilirsiniz.
Şablondan oluşturulan profiller
Sahiplendiğiniz bir lisanslı cihaz, modelinin profilinin bir kopyasını alır; bu kopya bir platform şablonundan oluşturulur. Profil başlığı hangi şablondan ve sürümden geldiğini belirtir ve bazı alanlarda from template yazar. Böyle bir profil yalnızca X.509 sertifikalarını kabul eder (“This profile accepts X.509 certificates only”). Kopyada provisioning Disabled olarak kalır.
Profil bölümleri
| Sekme | Ayarladığınız |
|---|---|
| General | Name (1 ile 128 karakter, kuruluşunuz içinde benzersiz), Description (en fazla 2.000 karakter). Profilin ne zaman oluşturulduğunu ve son ne zaman değiştirildiğini, kimliğini ve neyin kullandığını (In use) gösterir. |
| Transport & auth | Transport, izin verilen girişler, düz MQTT, URL’deki token, izin verilen ağlar, TLS olmadan izin verilen komutlar, topic şemaları, özel topic’ler. |
| Online status | Hermetry’nin bir cihazın çevrimiçi olduğuna nasıl karar verdiği. |
| Limits | Hız limitleri, payload boyutları, in-flight penceresi, hareketsizlik, gateway alt cihazları, varsayılan komut zaman aşımı. |
| Telemetry keys | Cihazların gönderdiği anahtarlar; etiketler, birimler, ondalık basamaklar ve aralıklarla birlikte. |
| Configuration keys | Cihazlarda ayarlayabileceğiniz cfg.* anahtarları. |
| Provisioning | Kimlik bilgisi olmayan cihazların kendilerini nasıl kaydettiği. |
Diğer modüller sekme ekler: Alarm rules, Commands, Firmware, LoRaWAN (LoRaWAN profilleri) ve SNMP (SNMP profilleri).
Transport & auth
Transport
| Transport | Cihazlar |
|---|---|
| MQTT | MQTT üzerinden bağlanın. |
| HTTP | Yalnızca HTTPS üzerinden gönderin. |
| MQTT and HTTP | İkisi de. |
| LoRaWAN | Hermetry LoRaWAN ağ sunucusu üzerinden katılın. Kendileri giriş yapmazlar. |
| Yoklamalı bir protokol | Platform tarafından bir uç nokta üzerinden yoklanır (SNMP ajanları, kameralar, kayıt cihazları). MQTT, token ve ağ ayarları uygulanmaz. |
Transport’u değiştirmek online rule’u asla değiştirmez; transport’un kullanamayacağı bir kural kaydetmeyi engeller.
Allowed authentication (en az biri): Access token, MQTT basic (username and password), X.509 certificate. Bkz. Device credentials.
Transport security
| Ayar | Varsayılan | Etki |
|---|---|---|
| Plain MQTT | TLS only (port 8883) | Düz 1883 portundan giriş yapan bir cihaz reddedilir. Bir profili yalnızca TLS’e çevirmek, cihazlarının düz oturumlarını hemen sonlandırır. Plain MQTT allowed (port 1883), TLS yapamayan cihazlar içindir. |
| Token in the URL (devices that cannot send headers) | Kapalı | POST /api/v1/{token}/telemetry ve /attributes isteklerine izin verir. Böyle bir profil yalnızca HTTP olur: cihazlarının tüm MQTT girişleri reddedilir. |
| Allowed networks | Boş (herhangi bir ağ) | En fazla 64 IPv4 veya IPv6 ağı (203.0.113.0/24) ya da tek adres. Bunların dışındaki cihazlar reddedilir (MQTT CONNACK 5, HTTP 403). |
| Commands allowed without TLS | Boş | Bir cihazın düz bir oturumda alabileceği en fazla 32 tam komut adı. Diğer her komut bir TLS oturumu bekler. |
Uyarı
Yalnızca yanlış kullanımı zararsız olan komutları listeleyin, örneğin sys.info veya sys.ping. sys.reboot, ota.check veya cert.renew komutlarını asla listelemeyin. Firmware güncellemeleri ve cihaz ayarları asla düz gönderilmez, fabrika ayarlarına sıfırlama ise hiç gönderilmez.
Topic schemes (en az biri):
| Şema | Topic’ler |
|---|---|
| Varsayılan şema | v1/telemetry, v1/attributes, v1/rpc/… ve varsayılan kümenin geri kalanı. Bilinmeyen v1/… topic’leri reddedilir. |
| Legacy compatible | Yalnızca v1/devices/me/telemetry ve v1/devices/me/attributes, mevcut firmware için: komut, sahiplenme, provisioning veya gateway topic’i yok. |
İkisi de açıkken eski ve yeni firmware aynı profili paylaşır; alt yönlü mesajlar her cihazın abone olduğu topic’i izler.
Custom topics (Accept topics outside v1/ as telemetry): v1/ dışındaki her topic telemetri olarak kabul edilir. JSON nesnesi anahtarlara dönüşür; diğer her şey boyutu sınırlı tek bir raw anahtarı olur.
| Alan | Varsayılan | Aralık |
|---|---|---|
| Prefix keys with the topic | Kapalı: aynı anahtar iki topic’te gelirse, son yazılan geçerli olur | — |
| Max topic depth (levels) | 8 | 1 ile 16 |
| Max topic length (characters) | 128 | 16 ile 256 |
| Distinct topics per device | 50 | 1 ile 1.000 |
| Max raw payload (bytes) | 4,096 | 256 ile 65.536, payload üst sınırını asla aşmaz |
Online status
| Kural | Bir cihaz şu durumda çevrimiçi sayılır |
|---|---|
| Live connection | MQTT bağlantısını canlı tutar. MQTT bağlantısını açık tutan cihazlar için önerilir. |
| Recent message | Son mesajı, Expected interval (seconds) × Factor süresinden daha yenidir. Sayfada “Shown offline after … without a message.” yazar. |
| Last seen only | Asla çevrimiçi ya da çevrimdışı olarak gösterilmez. Listelerde en son ne zaman görüldüğü gösterilir. |
Beklenen aralık 60 ila 604.800 saniyedir ve Son mesaj için gereklidir. Çarpan 1,5 ila 10 arasındadır (bir ondalık basamak), varsayılan 3’tür. HTTP ve LoRaWAN cihazları bağlantı tutmaz, bu nedenle bunlar için Canlı bağlantı sunulmaz; yoklanan cihazlar Yalnızca son görülme kullanır. Bkz. Bağlantı durumu ve etkinlik.
Sınırlar
Hız sınırları sayı:saniye biçimini kullanır; birden fazla pencere birlikte uygulanır ve her biri bir öncekinden daha uzun olmalıdır (aile başına en fazla 4, 1 ila 1.000.000 adet, 1 saniye ila 1 gün üzerinden). Protokol varsayılanı bir aileyi eski haline döndürür.
| Aile | Varsayılan |
|---|---|
| Telemetri mesajları | 10:1,300:60 |
| Telemetri noktaları | 200:1,6000:60 |
| Öznitelik güncellemeleri | 5:1,60:60 |
| Öznitelik istekleri | 5:1,60:60 |
| RPC mesajları | 5:1,60:60 |
| Sertifika istekleri | 1:3600 |
| Bağlantılar | 6:60 |
Hermetry, telemetri mesajları, telemetri noktaları ve öznitelik güncellemeleri sınırlarını her cihaza ayrı ayrı uygular. Sınır aşıldığında mesaj onaylanır ve atılır. Sahipler ve yöneticiler cihaz başına saatte bir bildirim alır. Her cihaz, etkin sınırlarını session_limits paylaşımlı özniteliğinde alır.
| Alan | Varsayılan | Aralık |
|---|---|---|
| Saniyedeki yeniden oynatma mesajları | Boş: saniyedeki telemetri sayısının yarısı | 1 ila 10.000 |
| En büyük mesaj yükü (bayt) | 65,536 | 1.024 ila 65.536 |
| En büyük aşağı yönlü yük (bayt) | 65,536 | 1.024 ila 65.536 |
| En fazla onaylanmamış mesaj (MQTT) | 20 | 1 ila 1.000 |
| Hareketsizlik zaman aşımı (saniye) | 600 | 10 ila 604.800. Bu süre boyunca hiçbir şey göndermeyen cihaz hareketsizdir (çevrimdışı ile aynı değildir). |
| Bir ağ geçidinin en fazla alt cihazı | 500 | 0 ila 10.000 |
| Yeni alt cihazların profili | Genel alt cihaz profili | Herhangi bir profil; ağ geçidi tür belirtmediğinde kullanılır |
| Varsayılan RPC zaman aşımı (saniye) | 10 | 1 ila 300 |
Telemetri anahtarları
Cihazların gönderdiği anahtarları listeleyin (en fazla 500). Her anahtarın bir Tür (Sayı, Tam sayı, Evet / hayır, Metin, JSON) ve isteğe bağlı olarak bir Birim (en fazla 32 karakter), Etiket (en fazla 128), Min, Max ve Ondalık (0 ila 10) vardır. Gösterge paneller bunları kullanır: bir gösterge, aralığı varsayılan ölçek olarak alır. Anahtarlar anahtar kurallarına uyar: en fazla 64 karakter, A–Z a–z 0–9 _ . - karakterlerinden oluşur ve _, fw_, current_fw_ veya cfg. ile başlayamaz.
Listelenmeyen anahtarlar yine de saklanır. Listelenmeyen anahtarları reddet ayarı kaydedilir ancak henüz uygulanmaz; sayfa bunu belirtir.
Anahtarları kaldırdığınızda veya yeniden adlandırdığınızda profil, bunları okuyan alarm kuralları ve diğer okuyucularla birlikte Kaldırılan anahtarlar hâlâ kullanımda uyarısını gösterir ve Yeni adlara güncelle veya Koru seçeneklerini sunar.
Yapılandırma anahtarları
Bir cihazın paylaşımlı öznitelik olarak kabul ettiği cfg.* anahtarları; her biri tür, etiket ve sınırlarla birlikte: Min, Max, İzin verilen değerler (en fazla 100), Min uzunluk ve Max uzunluk ile Gizli (yalnızca yazma). Yapılandırma sapması (Farkları bildir veya Zorla uygula) kaydedilir ancak henüz uygulanmaz. Bkz. Öznitelikler.
Sağlama
Strateji (Devre dışı, Yeni cihaz oluşturmaya izin ver, Yalnızca önceden sağlanmış cihazlar) ve sağlama anahtarları. Bkz. Cihaz ekleme ve sahiplenme.
Değişiklikleri kaydetme
- Değişiklikleri kaydet yalnızca değiştirdiğiniz alanları gönderir; Vazgeç bunları atar. Sekmeler arasında geçiş yaparken değişiklikleriniz formda kalır.
- Kullanımdaki bir profilin aktarım, oturum açma, ağ, konu şeması veya sınırlarındaki değişiklikleri kaydetmek, … cihazları nasıl bağlansın? sorusunu sorar: artık uygun olmayan canlı oturumlar hemen sonlanır. Kaydet ve uygula seçeneğini seçin.
- Profili açtıktan sonra başkası profili kaydettiyse kaydetme işleminiz reddedilir: “Profili açtıktan sonra başka biri bu profili kaydetti.” Profili yeniden yükle seçeneğini kullanın.
Çoğaltma ve silme
- Profili çoğalt, bu profilin her ayarını içeren “sağlamanın kapalı başladığı ve hiçbir anahtarın kopyalanmadığı yeni bir profil” oluşturur ve adını
<name> (copy)yapar. - Profili sil, varsayılan profil için (“önce başka bir profili varsayılan yapın”), yerleşik profil, platform şablonu ve hâlâ cihazlar, alarm kuralları veya komutlar tarafından kullanılan profil için reddedilir (“Hâlâ şunlar tarafından kullanılıyor …: önce taşıyın veya kaldırın.”).