Cihazlara komut gönderme

Komut (RPC olarak da anılır), bir cihazdan bir şey yapmasını ister: yeniden başlatma, bir çıkışı değiştirme, test çalıştırma. Her komut bir istek olarak saklanır ve cihaz yanıt verene kadar takip edilebilir. Komutlar yalnızca TLS oturumları üzerinden gönderilir (profil açık metne izin vermediği sürece), telemetriyi işleyen akışlardan asla geçmez ve her biri gönderenin yetkilerine karşı denetlenir.

Komut kataloğu

Her cihaz profilinin bir Komutlar sekmesi vardır: “Operatörlerin bu profildeki cihazlara gönderebileceği komutlar; her seviye kendi yetkisini gerektirir.” Bunu düzenlemek komutları yönetme yetkisini (yöneticiler) gerektirir.

Komut ekle seçeneğini seçin ve şunları doldurun:

Şablondan, platformun zaten gönderdiği bir komuttan (bir kart kontrolü gibi) formu başlatır. İçe aktar, tüm kataloğu bir dışa aktarımla değiştirir ({"commands": [ … ]}); Dışa aktar, kataloğu JSON olarak gösterir. Bir profil en fazla 200 komut içerir.

Seviyeler

Komut gönderme

1. Cihazı ve Komutlar sekmesini açın.
2. Komut seçin altında bir komut seçin (veya yalnızca sahipler için Diğer yöntem (ham)) ve Parametreler alanını doldurun.
3. Gerekirse seçenekleri ayarlayın:

1. Gönder seçeneğini seçin. Yüksek etkili bir komut {method} gönderilsin mi? diye sorar (“Bu komutun cihaz üzerinde etkisi vardır (yeniden başlayabilir veya oturumunu kaybedebilir).”) ve bir ifadesi varsa Onaylamak için {phrase} yazın ister.

Cihaz çevrimdışıysa sekme uyarır: “Cihaz çevrimdışı: “kalıcı” seçeneği olmadan komut hemen başarısız olur.”

Gösterge panelleri, SCADA sembolleri, kurallar ve akışlar da komut gönderebilir. Bir kart kontrolü yalnızca temel seviyedeki komutları gönderir. Bkz. Kontrol kartları.

Komut durumları

Uzun süren bir komut, sonucu gelene kadar Cihazda çalışıyor gösterir; zaman aşımına uğrayan bir komut Yanıt yok: sonuç bilinmiyor gösterir; süre bittikten sonra gelen bir yanıt Süre bittikten sonra yanıtlandı gösterir.

Geçmiş

Komutlar sekmesindeki Geçmiş, Yöntem, Durum, Gönderen (Konsol, API, Bir akış, Yazılım güncellemesi, Bir alarm eylemi, Bir gösterge paneli kontrolü), Oluşturulma, Tamamlanma ve Süre alanlarını listeler. Bir komutu açarak İstek, Yanıt ve İlerleme bilgisini görebilir, kuyrukta veya gönderilmişken Komutu iptal et seçeneğini kullanabilir ya da Yeniden gönder seçeneğini seçebilirsiniz. Gizli parametreler maskelenir.

Varsayılan sınırlar: cihaz başına dakikada 10 komut ve kuruluş başına dakikada 600; parametreler en fazla 16 KiB JSON; yanıt en fazla 64 KiB. Geçmiş 90 gün saklanır.

Cihazda

Cihaz v1/rpc/req/+ konusuna abone olur ve şunu alır:

PUBLISH v1/rpc/req/42
{"method": "sys.ping", "params": {"host": "8.8.8.8", "count": 3}}

Çift yönlü bir komut için aynı kimlik üzerinden yanıt verir:

PUBLISH v1/rpc/res/42
{"ok": true, "result": {"sent": 3, "received": 3, "avg_ms": 18.2}}

Cihaz için kurallar:

• Bir komut iki kez gelebilir. En az son 32 istek kimliğini 10 dakika boyunca hatırlayın ve aynı kimliği asla iki kez çalıştırmayın.
• İstek expirationTime içeriyorsa ve bu süre geçmişse, çalıştırmayın; {"ok": false, "error": "expired"} ile yanıt verin.
• İstek cihazın kaldırabileceğinden büyükse, çalıştırmayın; {"ok": false, "error": "payload_too_large"} ile yanıt verin.
• Komutlar, cihaz bu bağlantıda v1/rpc/req/+ konusuna abone olduktan sonra iletilir.

HTTP cihazları komutları GET /api/v1/rpc ile bekler ve POST /api/v1/rpc/{id} ile yanıt verir. Bkz. Cihaz HTTP API.

Uzun süren komutlar

PUBLISH v1/rpc/res/43
{"ok": true, "accepted": true, "job_id": "43"}

PUBLISH v1/attributes
{"rpc_result": {"job_id": "43", "method": "sys.traceroute", "ok": true, "result": {...}, "ts": 1759572042000}}

Cihazdan gelen istekler

Bir cihaz buluttan da isteyebilir: {"method": …, "params": …} ile v1/rpc/up/req/{id} konusuna yayımlar ve yanıtı v1/rpc/up/res/{id} üzerinden okur. Akışlarınız bu istekleri alır ve yanıtlar.

LoRaWAN ve ağ geçidi altındaki cihazlar

• LoRaWAN cihazları ham downlink’leri lora.downlink komutuyla alır. Bkz. Downlink gönderme.
• Ağ geçidinin arkasındaki cihazlara komutlar geliştirme aşamasındadır. Bkz. Ağ geçidinin arkasındaki cihazlara komutlar.

API ile

{
    "method": "sys.ping",
    "params": {
        "host": "8.8.8.8",
        "count": 3
    },
    "timeoutMs": 10000
}

curl -X POST 'https://<your-host>/tenant/{tenantId}/api/iot/devices/{deviceId}/rpc' \
  -H 'Content-Type: application/json' \
  -d '{"method":"sys.ping","params":{"host":"8.8.8.8","count":3},"timeoutMs":10000}'

{
    "rpc": {
        "rpcId": "…",
        "deviceId": "…",
        "method": "sys.ping",
        "status": "SUCCESSFUL",
        "outcome": null,
        "response": {
            "ok": true,
            "result": {
                "sent": 3,
                "received": 3,
                "avg_ms": 18.2
            }
        },
        "tier": "basic",
        "highImpact": false,
        "source": "api",
        "…": "…"
    }
}

{
    "rpc": {
        "rpcId": "…",
        "deviceId": "…",
        "method": "sys.reboot",
        "status": "QUEUED",
        "…": "…"
    }
}

{
    "message": "This command needs confirm: true.",
    "code": "VALIDATION_ERROR",
    "details": {
        "reason": "confirm_required"
    }
}

{
    "message": "Device not found.",
    "code": "NOT_FOUND"
}

Bir komutu GET /tenant/{tenantId}/api/iot/rpc/{rpcId} ile okuyun ve POST …/rpc/{rpcId}/cancel ile iptal edin (yalnızca QUEUED veya SENT iken; denetlenir). outcome alanı, yukarıda anlatıldığı gibi running, unknown veya late değerini taşır. Bkz. Komutlar API.

rpc.completed ve rpc.failed webhook olayları, sonucu diğer sistemlere bildirir. Yüksek etkili ve ham komutlar oluşturulduklarında ve sona erdiklerinde denetim günlüğüne yazılır.