nl::Weave::Profiles::SoftwareUpdate

Bu ad alanı, Weave Software Update profilinin Weave'deki tüm arayüzlerini ve aynı ada karşılık gelen protokolü içerir.

Özet

Numaralandırmalar
@309{
  kMsgType_ImageAnnounce = 0,
  kMsgType_ImageQuery = 1,
  kMsgType_ImageQueryResponse = 2,
  kMsgType_DownloadNotify = 3,
  kMsgType_NotifyResponse = 4,
  kMsgType_UpdateNotify = 5,
  kMsgType_ImageQueryStatus = 6
} 		enum
SoftwareUpdate Mesaj türleri.
@310{
  kStatus_NoUpdateAvailable = 0x0001,
  kStatus_UpdateFailed = 0x0010,
  kStatus_InvalidInstructions = 0x0050,
  kStatus_DownloadFailed = 0x0051,
  kStatus_IntegrityCheckFailed = 0x0052,
  kStatus_Abort = 0x0053,
  kStatus_Retry = 0x0091
} 		enum
@311{
  kFlag_PackageSpecPresent = 1,
  kFlag_LocaleSpecPresent = 2,
  kFlag_TargetNodeIdPresent = 4
} 		enum
ImageQuery çerçevesinin kontrol alanı için kontrol işaretleri.
@312 enum
ImageQueryResponse'un isteğe bağlı güncelleme seçenekleri alanı için bit maskeleri.
@313 enum
ImageQueryResponse'un isteğe bağlı güncelleme seçenekleri alanı için kaydırma ofsetleri.
@314{
  kIntegrityType_SHA160 = 0,
  kIntegrityType_SHA256 = 1,
  kIntegrityType_SHA512 = 2,
  kIntegrityType_Last = 3
} 		enum
@315 enum
Bütünlük spesifikasyonu bayt dizeleri için bayt cinsinden uzunluklar.
@316{
  kUpdateScheme_HTTP = 0,
  kUpdateScheme_HTTPS = 1,
  kUpdateScheme_SFTP = 2,
  kUpdateScheme_BDX = 3,
  kUpdateScheme_Last = 4
} 		enum
@317 enum
SoftwareUpdate Profili için Veri Öğesi Etiketleri.
UpdateCondition{
  IfUnmatched,
  IfLater,
  Unconditionally,
  OnOptIn
} 		enum
Güncelleme politikasının tabi olduğu koşullar.
UpdatePriority{
  Normal,
  Critical
} 		enum
Öncelikleri güncelleme.

İşlevler
integrityLength(uint8_t aType)
int
IntegrityTypes değerlerini, söz konusu türdeki karmaların uzunluklarıyla eşleyen bir destek yöntemi.

Sınıflar
nl::Weave::Profiles::SoftwareUpdate::IWeaveImageAnnounceServerDelegate

WeaveImageAnnounceServer temsilcisi için arayüz.

nl::Weave::Profiles::SoftwareUpdate::ImageAnnounce

ImageAnnounce mesajını açıklayan sınıf.

nl::Weave::Profiles::SoftwareUpdate::ImageQuery

Resim sorgu mesajlarının oluşturulmasını ve kodunun çözülmesini destekleyen bir sınıf.

nl::Weave::Profiles::SoftwareUpdate::ImageQueryResponse

Resim sorgusu yanıt mesajlarının oluşturulmasını ve kodunun çözülmesini destekleyen bir sınıf.

nl::Weave::Profiles::SoftwareUpdate::IntegritySpec

Bütünlük türünü ve yazılım güncelleme görüntüsünün gerçek karmasını içeren yardımcı sınıf.

nl::Weave::Profiles::SoftwareUpdate::IntegrityTypeList

Resim sorgusunun bir parçası olarak bütünlük türlerinin listesini tutmak için yardımcı sınıf.

nl::Weave::Profiles::SoftwareUpdate::ProductSpec

Bir ürün spesifikasyonunu temsil eden yardımcı sınıf.

nl::Weave::Profiles::SoftwareUpdate::UpdateSchemeList

Resim sorgusunun bir parçası olarak güncelleme şemalarının listesini tutmak için yardımcı sınıf.

nl::Weave::Profiles::SoftwareUpdate::WeaveImageAnnounceServer

Weave resim duyurularını dinleyen sunucu.

Numaralandırmalar

@309

 @309

SoftwareUpdate Mesaj türleri.

Özellikler
kMsgType_DownloadNotify

İstemciden sunucuya indirme durumu hakkında bilgi vermek için kullanılan isteğe bağlı bir ileti.

Yükü, SoftwareUpdateStatusCodes'dan alınan ek durum bilgilerini içeren bir nl::Weave::Profiles::StatusReporting::StatusReport.

kMsgType_ImageAnnounce

Bir yazılım güncellemesinin kullanılabilirliğini duyurmak için sunucu tarafından kullanılan isteğe bağlı istenmeyen bir mesaj.

İletide yük yok.

kMsgType_ImageQuery

İstemci tarafından sunucuya gönderilen bir sorgu iletisi.

Biçimi, ImageQuery sınıfıyla tanımlanır.

kMsgType_ImageQueryResponse

Başarılı bir resim sorgu mesajına yanıt olarak oluşturulan mesajdır.

Biçimi, ImageQueryResponse sınıfı tarafından tanımlanır.

kMsgType_ImageQueryStatus

Başarısız bir resim sorgusu mesajına yanıt olarak oluşturulan mesajdır.

Yükü, SoftwareUpdateStatusCodes'dan alınan ek durum bilgilerini içeren bir nl::Weave::Profiles::StatusReporting::StatusReport.

kMsgType_NotifyResponse

İndirme bildirimi mesajına yanıt olarak oluşturulan mesajdır.

Yükü, SoftwareUpdateStatusCodes'dan alınan ek durum bilgilerini içeren bir nl::Weave::Profiles::StatusReporting::StatusReport.

kMsgType_UpdateNotify

İstemciden sunucuya güncellemenin son durumunu bildirmek için kullanılan isteğe bağlı bir mesaj.

Yükü, SoftwareUpdateStatusCodes'dan alınan ek durum bilgilerini içeren bir nl::Weave::Profiles::StatusReporting::StatusReport. İletinin gerçek güncelleme sonrasında oluşturulması beklendiği için yeni bir ExchangeContext üzerinden gönderilir ve sunucuda istenmeyen bir ileti olarak kabul edilir.

@310

 @310

SoftwareUpdate profiline özel durum kodları.

Özellikler
kStatus_Abort

sunucu => istemcisi, sunucuda seçenek kalmadığı için istemcinin vazgeçmesi gerektiğini belirtir.

kStatus_DownloadFailed

istemci => sunucusu, bir indirme girişiminin başarısız olduğunu gösterir.

kStatus_IntegrityCheckFailed

istemci => sunucusu, bir resmin indirildiğini, ancak sonraki bütünlük denetiminde başarısız olduğunu gösterir.

kStatus_InvalidInstructions

istemci => sunucusu, istemcinin bir resmi ImageQueryResponse içinde bulunan indirme talimatları (ör.

URI, güncelleme şeması, güncelleme koşulu, kötü biçimlendirilmiş veya tutarsız.

kStatus_NoUpdateAvailable

sunucu => istemcisi, bir resim sorgusunun alınıp anlaşıldığını ve sunucuda şu anda istemci için güncelleme olmadığını gösterir.

kStatus_Retry

sunucu => Client, müşterinin başka bir resim sorgusu göndermesi ve güncellemeyi yeniden başlatması/devam etmesi gerektiğini belirtir.

kStatus_UpdateFailed

istemci => sunucu tarafından belirtilen bir görüntüyü yükleme denemesinin başarısız olduğunu gösterir.

@311

 @311

ImageQuery çerçevesinin kontrol alanı için kontrol işaretleri.

Özellikler
kFlag_LocaleSpecPresent

Locale (Yerel Ayar) spesifikasyonu, ImageQuery'de bulunur.

kFlag_PackageSpecPresent

Paket özellikleri, ImageQuery'de yer alır.

kFlag_TargetNodeIdPresent

ImageQuery'de hedef düğüm kimliği mevcuttur.

@312

 @312

ImageQueryResponse'un isteğe bağlı güncelleme seçenekleri alanı için bit maskeleri.

@313

 @313

ImageQueryResponse'un isteğe bağlı güncelleme seçenekleri alanı için kaydırma ofsetleri.

@314

 @314

SoftwareUpdate profili tarafından desteklenen bütünlük türleri.

Resim sorgu çerçevesi, istemcinin hangi bütünlük kontrolünü desteklediğini ve görüntü sorgusu yanıtının, istemciden indirmesi ve yüklemesi istenen görüntü için bütünlük türünü ve değerini içerdiğiyle ilgili bilgileri içerir. Desteklenen türler şunlardır:

Özellikler
kIntegrityType_Last

Numaralandırmadaki geçerli öğe sayısı.

kIntegrityType_SHA160

160 bit Güvenli Karma, (SHA-1), gerekli.

kIntegrityType_SHA256

256 bit Güvenli Karma (SHA-2).

kIntegrityType_SHA512

512 bit, Güvenli Karma (SHA-2).

@315

 @315

Bütünlük spesifikasyonu bayt dizeleri için bayt cinsinden uzunluklar.

@316

 @316

SofwareUpdate profili tarafından desteklenen şemaları güncelleyin.

Desteklenen bütünlük türlerine benzer şekilde resim sorgusu da hangi güncelleme şemalarını (ör. indirme protokolleri, istemcinin desteklediği) bilgi içerir ve yanıt, görüntülerin indirilmesinde kullanılacak güncelleme şemasını belirten bir değer içerir. Desteklenen şemalar şunlardır:

Özellikler
kUpdateScheme_BDX

İndirme protokolü olarak Weave Bulk veri aktarımı kullanılacaktır.

kUpdateScheme_HTTP

İndirme protokolü olarak HTTP kullanılmalıdır.

kUpdateScheme_HTTPS

İndirme protokolü olarak HTTPS kullanılmalıdır.

kUpdateScheme_Last

Numaralandırmadaki geçerli öğe sayısı.

kUpdateScheme_SFTP

İndirme protokolü olarak SFTP kullanılmalıdır.

@317

 @317

SoftwareUpdate Profili için Veri Öğesi Etiketleri.

UpdateCondition

 UpdateCondition

Güncelleme politikasının tabi olduğu koşullar.

Özellikler
IfLater

Yanıt çerçevesindeki sürüm spesifikasyonu, şu anda yüklü olan yazılım sürümünden sonraysa resmi indirin ve yükleyin.

IfUnmatched

Yanıt çerçevesindeki sürüm spesifikasyonu, şu anda yüklü olan yazılım sürümüyle eşleşmiyorsa resmi indirin ve yükleyin.

OnOptIn

resmi, sitedeki bir kullanıcı tarafından sağlanan bir tetikleyiciye indirip yükleyebilirsiniz.

Unconditionally

Şu anda çalışan yazılım sürümü ne olursa olsun görüntüyü indirip yükleyin.

UpdatePriority

 UpdatePriority

Öncelikleri güncelleme.

Özellikler
Critical

Güncelleme hemen yürütülmelidir.

Normal

Güncelleme, müşterinin şahsi karar verme yetkisiyle yürütülebilir.

İşlevler

integrityLength

int integrityLength(
  uint8_t aType
)

IntegrityTypes değerlerini, söz konusu türdeki karmaların uzunluklarıyla eşleyen bir destek yöntemi.

Ayrıntılar
Parametreler
[in] aType
İadeler
Sağlanan karma türünün karma uzunluğu.