Cihaz şablonunu düzenleme

Cihaz şablonu, bir cihazın IoT Central ile nasıl etkileşim kurduğunu açıklayan bir model içerir. Bu model, cihazın özelliklerini ve IoT Central'ın bunlarla nasıl etkileşim kuracaklarını tanımlar. Cihazlar IoT Central'a telemetri ve özellik değerleri gönderebilir, IoT Central bir cihaza özellik güncelleştirmeleri ve komutlar gönderebilir. IoT Central ayrıca işler, kurallar ve dışarı aktarmalar gibi IoT Central özellikleriyle etkileşimleri tanımlamak için modeli kullanır.

Cihaz şablonundaki modelde yapılan değişiklikler, bağlı cihazlar da dahil olmak üzere uygulamanızın tamamını etkileyebilir. Kurallar, dışarı aktarmalar, cihaz grupları veya işler tarafından kullanılan bir özellikte yapılan değişiklikler beklenmedik şekilde davranmalarına veya hiç çalışmamalarına neden olabilir. Örneğin, bir telemetri tanımını bir şablondan kaldırırsanız:

• IoT Central artık bu değeri yorumlayamaz. IoT Central, cihazın Ham veri sayfasında modellenmemiş veriler olarak yorumlayamayan cihaz verilerini gösterir.
• IoT Central artık veri dışarı aktarma işlemlerindeki değeri içermez.

Bir cihaz şablonunu düzenlemenin istenmeyen sonuçlarından kaçınmanıza yardımcı olmak için bu makale, geçerli geliştirme yaşam döngüsü aşamanıza göre öneriler içerir. Genel olarak, geliştirme yaşam döngüsünde ne kadar erken iseniz, cihaz şablonu değişikliklerine o kadar dayanıklı olabilirsiniz.

Cihaz şablonları ve nasıl oluşturulacağı hakkında daha fazla bilgi edinmek için bkz . Cihaz şablonları nedir? ve Cihaz şablonu ayarlama.

IoT Central REST API'sini kullanarak cihaz şablonlarını yönetmeyi öğrenmek için bkz . Cihaz şablonlarını yönetmek için IoT Central REST API'sini kullanma.

Cihaz şablonunu değiştirme

Modele özellik veya arabirim ekleme gibi ek değişiklikler bölünemez değişikliklerdir. Geliştirme yaşam döngüsünün herhangi bir aşamasında bir modelde ek değişiklikler yapabilirsiniz.

Hataya neden olan değişiklikler arasında modelin bölümlerini kaldırma veya yetenek adını veya şema türünü değiştirme sayılabilir. Bu değişiklikler kurallar, dışarı aktarmalar veya panolar gibi uygulama özelliklerinin hata iletilerini görüntülemesine ve çalışmayı durdurmasına neden olabilir.

Erken cihaz geliştirme aşamalarında, modeli tasarlamaya ve test etmeye devam ederken, doğrudan cihaz modelinizde değişiklik yapmaya daha fazla tolerans vardır. Üretim cihazlarını bir cihaz şablonuna bağlamadan önce, cihaz şablonunu doğrudan düzenleyebilirsiniz. IoT Central, cihaz şablonunu yayımladığınızda bu değişiklikleri cihazlara otomatik olarak uygular.

Üretim cihazlarını bir cihaz şablonuna ekledikten sonra, bir cihaz şablonunu düzenlemeden önce değişikliklerin etkisini değerlendirin. Üretimdeki bir cihaz şablonunda hataya neden olan değişiklikler yapmamalısınız. Bu tür değişiklikler yapmak için cihaz şablonunun yeni bir sürümünü oluşturun. Yeni cihaz şablonunu test edin ve üretim cihazlarınızı zamanlanmış kapalı kalma süresiyle yeni şablona geçirin.

IoT Edge cihaz şablonunu güncelleştirme

Bir IoT Edge cihazı için model, özellikleri cihazda çalışan IoT Edge modüllerine karşılık gelen modüllere göre gruplandırıyor. Dağıtım bildirimi, IoT Edge cihazına hangi modüllerin yükleneceğini, bunların nasıl yapılandırıldığını ve modülün hangi özelliklerine sahip olduğunu bildiren ayrı bir JSON belgesidir. Dağıtım bildirimini değiştirirseniz, cihaz şablonunu bildirimde tanımlanan modülleri ve özellikleri içerecek şekilde güncelleştirebilirsiniz:

1. Cihaz şablonunda Modüller düğümüne gidin.
2. Modüller özet sayfasında Bildirimden modülleri içeri aktar'ı seçin.
3. Uygun dağıtım bildirimini seçin ve İçeri Aktar'ı seçin.

Daha fazla bilgi edinmek için bkz . IoT Edge cihazları ve IoT Central.

Eylemleri düzenleme ve yayımlama

Bir cihaz şablonunu düzenlerken aşağıdaki eylemler yararlıdır:

• Save. Cihaz şablonunuzun bir bölümünü değiştirdiğinizde, değişiklikleri kaydetmek geri dönebileceğiniz bir taslak oluşturur. Bu değişiklikler henüz bağlı cihazları etkilemez. Bu şablondan oluşturulan tüm cihazlarda, siz yayımlayana kadar kaydedilen değişiklikler yoktur.
• Yayımla. Cihaz şablonunu yayımladığınızda, kaydedilen tüm değişiklikler mevcut cihaz örneklerine uygulanır. Yeni oluşturulan cihaz örnekleri her zaman en son yayımlanan şablonu kullanır.
• Şablon sürümü oluşturma. Bir cihaz şablonunu sürüm oluşturduğunuzda, en son kaydedilen değişiklikleri içeren yeni bir şablon oluşturur. Yeni bir sürümde yapılan değişiklikler mevcut cihaz örneklerini etkilemez. Daha fazla bilgi için bkz . Cihaz şablonu sürüm oluşturma.
• Arabirim sürümü. Bir arabirim sürümü oluşturduğunuzda, en son kaydedilen özellikleri içeren yeni bir arabirim oluşturur. Bir şablonun içindeki katlar konumundaki bir arabirimi yeniden kullanabilirsiniz. Bu nedenle, bir arabirim başvurusunda yapılan bir değişiklik, şablonda arabirimi kullanan tüm yerleri değiştirir. Bir arabirim sürümü oluşturduğunuzda, yeni sürüm artık ayrı bir arabirim olduğundan bu davranış değişir. Daha fazla bilgi edinmek için bkz . Arabirim sürüm oluşturma.
• Cihazı geçirme. Bir cihazı geçirdiğinizde, cihaz örneği bir cihaz şablonundan diğerine geçiş yapılır. Cihaz geçişi, IoT Central değişiklikleri işlerken kısa bir süreye neden olabilir. Daha fazla bilgi edinmek için bkz . Bir cihazı sürümler arasında geçirme.

Sürüm numaraları

Hem cihaz modellerinin hem de arabirimlerin sürüm numaraları vardır. Farklı sürüm numaraları, güncelleştirme geçmişini sağlarken modellerin veya arabirimlerin bir @id değeri paylaşmasına olanak tanır. Sürüm numaraları yalnızca şablonun veya arabirimin sürümünü seçmeyi seçerseniz veya sürüm numarasını kasıtlı olarak değiştirirseniz artar. Şablon veya arabirimde önemli bir değişiklik yaptığınızda sürüm numarasını değiştirmeniz gerekir.

Aşağıdaki kod parçacığında termostat cihazının cihaz modeli gösterilmektedir. Cihaz modelinin tek bir arabirimi vardır. Sürüm numarasını 1alanın sonunda@id görebilirsiniz.

{
  "@context": "dtmi:dtdl:context;2",
  "@id": "dtmi:com:example:Thermostat;1",
  "@type": "Interface",
  "displayName": "Thermostat",
  "description": "Reports current temperature and provides desired temperature control.",
  "contents": [
    // ...
  ]
}

Bu bilgileri IoT Central kullanıcı arabiriminde görüntülemek için cihaz şablonu düzenleyicisinde Kimliği görüntüle'yi seçin:

Cihaz şablonunu sürüm oluşturma

Cihaz şablonunun sürümünü oluşturmak için:

1. Cihaz şablonları sayfasına gidin.
2. Sürüm oluşturmak istediğiniz cihaz şablonunu seçin.
3. Sayfanın üst kısmındaki Sürüm'e tıklayın ve şablona yeni bir ad verin. IoT Central, düzenleyebileceğiniz yeni bir ad önerir.
4. Oluştur'u belirleyin.

Artık mevcut cihazlara bağlı olmayan benzersiz bir kimliğe sahip yeni bir şablon oluşturdunuz.

Arabirim sürümü oluşturma

Bir arabirimi sürüm olarak kullanmak için:

1. Cihaz şablonları sayfasına gidin.
2. Taslak modunda sahip olduğunuz cihaz şablonunu seçin.
3. Sürüm ve düzenleme yapmak istediğiniz yayımlanmış arabirimi seçin.
4. Arabirim sayfasının üst kısmındaki Sürüm'e tıklayın.
5. Oluştur'u belirleyin.

Şimdi benzersiz bir kimliğe sahip yeni bir arabirim oluşturdunuz, önceki arabirim sürümüyle eşitlenmedi.

Bir cihazı sürümler arasında geçirme

Cihaz şablonunun birden çok sürümünü oluşturabilirsiniz. Zaman içinde, bu cihaz şablonlarını kullanan birden çok bağlı cihazınız olur. Cihazları cihaz şablonunuzun bir sürümünden diğerine geçirebilirsiniz. Aşağıdaki adımlarda bir cihazın nasıl geçirıldığı açıklanmaktadır:

1. Cihazlar sayfasına gidin.

2. Başka bir sürüme geçirmek için ihtiyacınız olan cihazı seçin.

3. Geçir'i seçin:

   

4. Cihazı geçirmek istediğiniz sürüme sahip cihaz şablonunu seçin ve Ardından Geçir'i seçin.

İpucu

Bir iş kullanarak bir cihaz grubundaki tüm cihazları aynı anda yeni bir cihaz şablonuna geçirebilirsiniz.