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

Kendi codec’inizi yazın

Bir kütüphane codec'ini kopyalayın veya yeni bir tablo codec'i yazın, test vektörlerine karşı kontrol edin, yayımlayın ve revizyonlarını yönetin.

Kütüphanede sensörünüz için codec yoksa ya da bir kütüphane codec’inden farklı çıktı istiyorsanız kendi codec’inizi yazarsınız. Codec’leriniz betik değil, JSON tablolarıdır: Hermetry bir codec’ten hiçbir zaman kod çalıştırmaz. Bunları kuruluşunuzda yayımlarsınız; cihazlarınız ve profilleriniz bunları kütüphane codec’leri gibi kullanabilir.

Codec yazmak, kendi LoRaWAN codec’lerinizi ekleme, değiştirme ve silme iznini gerektirir (varsayılan olarak yöneticilerde bulunur). Her yayımlama ve silme işlemi denetim kaydına alınır.

Başlamanın iki yolu

Bir kütüphane codec’inin kopyasını kaydedin

Bir kütüphane codec’i ihtiyacınıza yakınsa en uygun yoldur.

  1. Devices > ⋯ > LoRaWAN codecs yolunu açın ve kütüphane codec’ini açın.
  2. Save a copy seçeneğini seçin.
  3. Düzenleyici; kütüphane tablosu, t.<library id> kimliği (isterseniz değiştirin), tenant kaynağı ve kopyalanan codec ile revizyonu belirten bir kaynak satırıyla açılır.
  4. Tabloyu değiştirin, Check seçeneğini, ardından Publish seçeneğini seçin.

Yeni bir codec başlatın

  1. Codec çekmecesinde New codec seçeneğini seçin.
  2. Id alanını girin ve tabloyu Codec table (JSON) altına yapıştırın ya da yazın. Düzenleyici, başlangıç için bir taslak sunar.
  3. Check seçeneğini, ardından Publish seçeneğini seçin.

Kimlikler

Codec kimlikleriniz t. ile başlar, ardından 2 ila 62 küçük harf, rakam veya tire gelir; örneğin t.cold-room-probe. Kimlik sonradan asla değişmez. Kuruluşunuzda zaten kullanılan bir kimlik reddedilir: a codec with this id exists. Choose another id.

Codec tablosu

Codec bir JSON belgesidir. Ana alanları:

AlanZorunluAnlamı
idEvetCodec kimliği (t.…)
titleEvetOkunabilir bir ad, en fazla 160 karakter
vendorEvetCihaz üreticisi, en fazla 64 karakter
modelsHayırBu codec’in kapsadığı model adları (en fazla 64)
fportsHayırÇözdüğü FPort’lar (1–255, en fazla 64). Tüm portlar için boş bırakın.
ouiHayırÜretici kodları: DevEUI’nin ilk 6 onaltılık hanesi, büyük harf (en fazla 32). Otomatik seçimde kullanılır.
kindHayırlayout (sabit bayt konumlarındaki alanlar) veya tlv (kanal, tip, veri kayıtları)
frameslayout içinFrame’lerin nasıl ayırt edileceği (fport, length, min_length, bir işaret baytı byte veya maskelenmiş bits ile) ve her birinin fields alanları
channels, types, attributes, defaulttlv içinKayıt tanımları
testsEvet, en az bir taneTest vektörleri: fport, hex ve beklenen (expect) değerler (en fazla 200)

Bir layout frame’indeki alanda at (bayt ofseti), field (çıktı anahtarı), fmt (bayt formatı) ve isteğe bağlı olarak scale, digits, offset, unit ve enum bulunur. Formatlar arasında u8, i8, u16be, u16le, i16be, i16le, u24be, u24le, u32be, u32le, i32be, i32le, f32be, f32le, hex, ascii ve bir baytın bit split‘leri vardır.

Bilinmeyen üst düzey alanlar reddedilir. JavaScript çözücüler kabul edilmez: this is a JavaScript decoder. Only the table format is accepted.

Örnek

FPort 2 üzerinde pili mV cinsinden (2 bayt), sıcaklığı °C’nin onda biri cinsinden (2 bayt, işaretli) ve nemi % cinsinden (1 bayt) gönderen bir sensör:

{
  "id": "t.room-sensor",
  "title": "Room sensor, temperature and humidity",
  "vendor": "Example maker",
  "models": ["RS-1"],
  "fports": [2],
  "kind": "layout",
  "frames": [
    {
      "fport": 2,
      "min_length": 5,
      "fields": [
        { "at": 0, "field": "battery", "fmt": "u16be", "unit": "mV" },
        { "at": 2, "field": "temperature", "fmt": "i16be", "scale": 0.1, "unit": "°C" },
        { "at": 4, "field": "humidity", "fmt": "u8", "unit": "%" }
      ]
    }
  ],
  "tests": [
    { "name": "normal reading", "fport": 2, "hex": "0BC4010A32",
      "expect": { "battery": 3012, "temperature": 26.6, "humidity": 50 } }
  ]
}

Ölçeklenen değerler, alan digits belirtmedikçe 2 ondalığa yuvarlanır.

Kontrol edin ve yayımlayın

Check her test vektörünü çalıştırır ve her birini Passes veya Fails olarak, What differs ile birlikte gösterir. Hepsi geçtiğinde: Every test vector passes. Publishing makes it available to your devices and routers.

Publish aynı kontrolleri yeniden çalıştırır ve codec’i Not published: ile nedenini belirterek reddeder:

Gösterilen nedenAnlamı
the text is not valid JSON.JSON sözdizimini düzeltin.
a field is missing or not allowed (…).Zorunlu bir alan eksik ya da bilinmeyen bir alan var.
the id must be t. followed by lower-case letters, digits and dashes.Kimliği düzeltin.
the codec is larger than 40960 bytes.Codec’leriniz 40 KB ile sınırlıdır.
the tables are not in the expected format (…).Bir frame veya alan tanımı hatalı.
a codec needs at least one test vector.Bir test vektörü ekleyin.
some test vectors fail (see below).Tabloyu veya beklenen değerleri düzeltin.
a published version decoded keys this one no longer does (…). Publish it under a new id instead.Aşağıdaki revizyonlara bakın.
another of your codecs already covers models.Codec’lerinizden ikisi aynı modeli üstlenemez.

Tablolar en fazla 32 seviye iç içe geçebilir.

Revizyonlar

Mevcut bir codec’in her yayımlanışı yeni bir revizyon oluşturur. Akışlarınızı ve panolarınızı korumak için yeni bir revizyon anahtar ekleyebilir, ancak hiçbirini kaldıramaz veya yeniden adlandıramaz ve bir anahtarın birimini değiştiremez. Anahtarları kaldırmanız ya da yeniden adlandırmanız gerekirse yeni bir kimlikle yayımlayın ve cihazlarınızı ona taşıyın.

Codec sayfasındaki Revisions, her revizyonu boyutu ve anahtar sayısıyla listeler.

Codec’iniz ve kütüphane

Otomatik seçimde önce sizin codec’leriniz, sonra kütüphanenin codec’leri denenir. Bir kopya, kütüphane codec’inin üretici kodlarını ve FPort’larını korur; bu yüzden o üreticinin Automatic seçili cihazları, kopyayı yayımlar yayımlamaz ona geçer. Codec’lerinizden biri bir kütüphane codec’iyle aynı modeli üstlenebilir; cihazlarınız için kütüphaneyi bu şekilde geçersiz kılarsınız.

Bir codec’i silin

Codec’inizi açın ve Delete seçeneğini seçin. Codec listenizden çıkar; onu seçmiş cihazlar ve profiller bundan sonra otomatik seçimle çözümleme yapar. Revizyonları saklanır ve kimliğin anlamı hiç değişmez: aynı kimliği yeniden oluşturursanız, silinen codec’in son revizyonuna göre revizyon kuralına uymalıdır.

İlgili