nl::Weave::Profiles::SoftwareUpdate

Ta przestrzeń nazw obejmuje wszystkie interfejsy Weave dla profilu Weave Software Update, w tym odpowiedni protokół o tej samej nazwie.

Podsumowanie

Wyliczenia

@309{
  kMsgType_ImageAnnounce = 0,
  kMsgType_ImageQuery = 1,
  kMsgType_ImageQueryResponse = 2,
  kMsgType_DownloadNotify = 3,
  kMsgType_NotifyResponse = 4,
  kMsgType_UpdateNotify = 5,
  kMsgType_ImageQueryStatus = 6
}
enum | typ wyliczeniowy
SoftwareUpdate Typy komunikatów.
@310{
  kStatus_NoUpdateAvailable = 0x0001,
  kStatus_UpdateFailed = 0x0010,
  kStatus_InvalidInstructions = 0x0050,
  kStatus_DownloadFailed = 0x0051,
  kStatus_IntegrityCheckFailed = 0x0052,
  kStatus_Abort = 0x0053,
  kStatus_Retry = 0x0091
}
enum | typ wyliczeniowy
@311{
  kFlag_PackageSpecPresent = 1,
  kFlag_LocaleSpecPresent = 2,
  kFlag_TargetNodeIdPresent = 4
}
enum | typ wyliczeniowy
Flagi kontrolne pola sterującego ramki ImageQuery.
@312 enum | typ wyliczeniowy
Maski bitowe dla opcjonalnego pola opcji aktualizacji w ImageQueryResponse.
@313 enum | typ wyliczeniowy
Przesunięcia przesunięcia dla opcjonalnego pola opcji aktualizacji w ImageQueryResponse.
@314{
  kIntegrityType_SHA160 = 0,
  kIntegrityType_SHA256 = 1,
  kIntegrityType_SHA512 = 2,
  kIntegrityType_Last = 3
}
enum | typ wyliczeniowy
@315 enum | typ wyliczeniowy
Długości ciągów bajtów według specyfikacji integralności.
@316{
  kUpdateScheme_HTTP = 0,
  kUpdateScheme_HTTPS = 1,
  kUpdateScheme_SFTP = 2,
  kUpdateScheme_BDX = 3,
  kUpdateScheme_Last = 4
}
enum | typ wyliczeniowy
@317 enum | typ wyliczeniowy
Tagi elementu danych w profilu SoftwareUpdate.
UpdateCondition{
  IfUnmatched,
  IfLater,
  Unconditionally,
  OnOptIn
}
enum | typ wyliczeniowy
Warunki regulujące zasady aktualizacji.
UpdatePriority{
  Normal,
  Critical
}
enum | typ wyliczeniowy
Zaktualizuj priorytety.

Funkcje

integrityLength(uint8_t aType)
int
Metoda pomocy z mapowaniem wartości IntegrityTypes na długości haszy danego typu.

Zajęcia

nl::Weave::Profiles::SoftwareUpdate::IWeaveImageAnnounceServerDelegate

Interfejs dla delegata WeaveImageAnnounceServer.

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

Klasa opisująca wiadomość ImageAnnounce.

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

Klasa obsługująca tworzenie i dekodowanie wiadomości z zapytaniami o obrazy.

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

Klasa do obsługi tworzenia i dekodowania wiadomości z odpowiedziami na zapytanie o obraz.

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

Klasa pomocnicza zawierająca typ integralności i rzeczywisty hasz obrazu aktualizacji oprogramowania.

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

Klasa pomocnicza do przechowywania listy typów integralności w ramach zapytania o obraz.

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

Klasa pomocnicza, która reprezentuje specyfikację produktu.

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

Klasa pomocnicza do przechowywania listy schematów aktualizacji w ramach zapytania o obraz.

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

Serwer nasłuchujący ogłoszeń dotyczących obrazów Weave.

Wyliczenia

@309

 @309

SoftwareUpdate Typy komunikatów.

Właściwości
kMsgType_DownloadNotify

Opcjonalna wiadomość od klienta do serwera używana do powiadamiania serwera o stanie pobierania.

Ładunek ma postać nl::Weave::Profiles::StatusReporting::StatusReport i zawiera dodatkowe informacje o stanie pobierane z tagu SoftwareUpdateStatusCodes.

kMsgType_ImageAnnounce

Opcjonalna, niezamawiana wiadomość używana przez serwer w celu poinformowania o dostępności aktualizacji oprogramowania.

Wiadomość nie zawiera ładunku.

kMsgType_ImageQuery

Komunikat z zapytaniem wysłany przez klienta do serwera.

Format jest określony za pomocą klasy ImageQuery.

kMsgType_ImageQueryResponse

Komunikat wygenerowany w odpowiedzi na przesłanie zapytania o obraz.

Jego format jest określany przez klasę ImageQueryResponse.

kMsgType_ImageQueryStatus

Komunikat wygenerowany w odpowiedzi na nieudane zapytanie dotyczące obrazu.

Ładunek ma postać nl::Weave::Profiles::StatusReporting::StatusReport i zawiera dodatkowe informacje o stanie pobierane z tagu SoftwareUpdateStatusCodes.

kMsgType_NotifyResponse

Komunikat generowany w odpowiedzi na powiadomienie o pobieraniu.

Ładunek ma postać nl::Weave::Profiles::StatusReporting::StatusReport i zawiera dodatkowe informacje o stanie pobierane z tagu SoftwareUpdateStatusCodes.

kMsgType_UpdateNotify

Opcjonalna wiadomość od klienta do serwera używana do przekazywania ostatecznego stanu aktualizacji.

Ładunek ma postać nl::Weave::Profiles::StatusReporting::StatusReport i zawiera dodatkowe informacje o stanie pobierane z tagu SoftwareUpdateStatusCodes. Wiadomość powinna zostać wygenerowana po rzeczywistej aktualizacji, więc jest wysyłana przy użyciu nowego kontekstu ExchangeContext i traktowana na serwerze jako niezamawiana wiadomość.

@310

 @310

Kody stanu profilu SoftwareUpdate.

Właściwości
kStatus_Abort

serwer => klienta, wskazuje, że klient powinien zrezygnować, ponieważ nie ma już opcji dla serwera.

kStatus_DownloadFailed

klient => serwer, oznacza, że próba pobrania nie powiodła się.

kStatus_IntegrityCheckFailed

klient => oznacza, że obraz został pobrany, ale nie przeszedł kontroli integralności.

kStatus_InvalidInstructions

klient => serwer, oznacza, że klient nie mógł pobrać obrazu, ponieważ instrukcje pobierania zawarte w ImageQueryResponse, czyli

Identyfikator URI, schemat aktualizacji lub warunek aktualizacji są nieprawidłowo sformułowane lub niespójne.

kStatus_NoUpdateAvailable

serwer => oznacza, że zapytanie dotyczące obrazu zostało odebrane i zrozumiane, a serwer nie ma w tej chwili aktualizacji dla klienta.

kStatus_Retry

serwer => klienta, wskazuje, że klient powinien przesłać inne zapytanie dotyczące obrazu i uruchomić ponownie/kontynuować aktualizację

kStatus_UpdateFailed

klient => server, oznacza, że próba zainstalowania obrazu określonego przez serwer zakończyła się niepowodzeniem.

@311

 @311

Flagi kontrolne pola sterującego ramki ImageQuery.

Właściwości
kFlag_LocaleSpecPresent

Specyfikacja Locale jest dostępna w obiekcie ImageQuery.

kFlag_PackageSpecPresent

Specyfikacja pakietu znajduje się w obiekcie ImageQuery.

kFlag_TargetNodeIdPresent

Identyfikator węzła docelowego znajduje się w obiekcie ImageQuery.

@312

 @312

Maski bitowe dla opcjonalnego pola opcji aktualizacji w ImageQueryResponse.

@313

 @313

Przesunięcia przesunięcia dla opcjonalnego pola opcji aktualizacji w ImageQueryResponse.

@314,

 @314

Typy integralności obsługiwane w profilu SoftwareUpdate.

Ramka zapytania o obraz zawiera informacje o tym, które sprawdzanie integralności obsługuje klient, a odpowiedź na zapytanie o obraz zawiera typ integralności i wartość obrazu, który klient ma pobrać i zainstalować. Obsługiwane typy to:

Właściwości
kIntegrityType_Last

Liczba prawidłowych elementów w wyliczeniu.

kIntegrityType_SHA160

Wymagany 160-bitowy bezpieczny hasz (SHA-1).

kIntegrityType_SHA256

256-bitowy bezpieczny hasz (SHA-2).

kIntegrityType_SHA512

512-bitowy, bezpieczny hasz (SHA-2).

@315,

 @315

Długości ciągów bajtów według specyfikacji integralności.

@316,

 @316

Aktualizuj schematy obsługiwane przez profil SofwareUpdate.

Podobnie jak w przypadku obsługiwanych typów integralności, zapytanie o obraz zawiera informacje o schematach aktualizacji, tj. protokołach pobierania obsługiwanych przez klienta, a odpowiedź zawiera wartość wskazującą schemat aktualizacji, który ma być używany przy pobieraniu obrazów. Obsługiwane schematy to:

Właściwości
kUpdateScheme_BDX

Jako protokół pobierania należy używać zbiorczego przesyłania danych Weave.

kUpdateScheme_HTTP

Jako protokołu pobierania należy używać HTTP.

kUpdateScheme_HTTPS

Jako protokół pobierania używany jest HTTPS.

kUpdateScheme_Last

Liczba prawidłowych elementów w wyliczeniu.

kUpdateScheme_SFTP

Jako protokołu pobierania będzie używany SFTP.

@317

 @317

Tagi elementu danych w profilu SoftwareUpdate.

UpdateCondition

 UpdateCondition

Warunki regulujące zasady aktualizacji.

Właściwości
IfLater

Pobierz i zainstaluj obraz, jeśli specyfikacja wersji w ramce odpowiedzi jest późniejsza niż wersja aktualnie zainstalowana.

IfUnmatched

Pobierz i zainstaluj obraz, jeśli specyfikacja wersji w ramce odpowiedzi nie odpowiada aktualnie zainstalowanej wersji oprogramowania.

OnOptIn

pobrać i zainstalować obraz za pomocą jakiegoś aktywatora dostarczonego przez użytkownika witryny.

Unconditionally

Pobierz i zainstaluj obraz niezależnie od używanej wersji oprogramowania.

UpdatePriority

 UpdatePriority

Zaktualizuj priorytety.

Właściwości
Critical

Aktualizacja musi być wykonywana natychmiast.

Normal

Klient może wprowadzić aktualizację według swojego uznania.

Funkcje

integrityLength

int integrityLength(
  uint8_t aType
)

Metoda pomocy z mapowaniem wartości IntegrityTypes na długości haszy danego typu.

Szczegóły
Parametry
[in] aType
Wartość IntegrityTypes
Zwroty
Długość wartości hash podanego typu skrótu.