Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

nl::Weave::Profile::SoftwareUpdate

Dieser Namespace enthält alle Schnittstellen in Weave für das Weave-Software-Update-Profil, die das entsprechende Protokoll desselben Namens enthalten.

Fazit

Aufzählungen

@309{
  kMsgType_ImageAnnounce = 0,
  kMsgType_ImageQuery = 1,
  kMsgType_ImageQueryResponse = 2,
  kMsgType_DownloadNotify = 3,
  kMsgType_NotifyResponse = 4,
  kMsgType_UpdateNotify = 5,
  kMsgType_ImageQueryStatus = 6
}
enum
SoftwareUpdate-Nachrichtentypen
@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
Steuerungs-Flags für das Steuerfeld des ImageQuery-Frames
@312 enum
Bitmasken für das optionale Feld mit den Aktualisierungsoptionen von ImageQueryResponse.
@313 enum
Offsets für das optionale Feld für die Updateoptionen der ImageQueryResponse.
@314{
  kIntegrityType_SHA160 = 0,
  kIntegrityType_SHA256 = 1,
  kIntegrityType_SHA512 = 2,
  kIntegrityType_Last = 3
}
enum
@315 enum
Längen in Byte für die Integritätsspezifikation „Byte-Strings“.
@316{
  kUpdateScheme_HTTP = 0,
  kUpdateScheme_HTTPS = 1,
  kUpdateScheme_SFTP = 2,
  kUpdateScheme_BDX = 3,
  kUpdateScheme_Last = 4
}
enum
@317 enum
Datenelement-Tags für das SoftwareUpdate-Profil
UpdateCondition{
  IfUnmatched,
  IfLater,
  Unconditionally,
  OnOptIn
}
enum
Bedingungen für Updaterichtlinien.
UpdatePriority{
  Normal,
  Critical
}
enum
Prioritäten aktualisieren

Funktionen

integrityLength(uint8_t aType)
int
Eine Supportmethode, die die Werte von IntegrityTypes auf die Länge der Hashes dieses Typs zuordnet.

Klassen

nl::Weave::Profile::SoftwareUpdate::IWeaveImageAnnounceServerDelegate

Schnittstelle für den Bevollmächtigten WeaveImageAnnounceServer.

nl::Weave::Profile::SoftwareUpdate::ImageAnnounce

Klasse, die die ImageAnnounce-Nachricht beschreibt.

nl::Weave::Profile::SoftwareUpdate::ImageQuery

Eine Klasse, die das Erstellen und Decodieren von Bildabfragenachrichten unterstützt.

nl::Weave::Profile::SoftwareUpdate::ImageQueryResponse

Eine Klasse, die das Erstellen und Decodieren der Bildabfrage-Antwortnachrichten unterstützt.

nl::Weave::Profile::SoftwareUpdate::IntegritySpec

Eine Hilfsklasse, die den Integritätstyp und den tatsächlichen Hash des Software-Update-Images enthält.

nl::Weave::Profile::SoftwareUpdate::IntegrityTypeList

Eine Hilfsklasse, die eine Liste von Integritätstypen als Teil der Bildabfrage enthält.

nl::Weave::Profile::SoftwareUpdate::ProductSpec

Eine Hilfsklasse, die eine Produktspezifikation darstellt.

nl::Weave::Profile::SoftwareUpdate::UpdateSchemeList

Eine Hilfsklasse, die eine Liste mit Aktualisierungsschemas als Teil der Bildabfrage enthält.

nl::Weave::Profile::SoftwareUpdate::WeaveImageAnnounceServer

Server, der Weave-Bildankündigungen überwacht.

Aufzählungen

@309

 @309

SoftwareUpdate-Nachrichtentypen

Attribute
kMsgType_DownloadNotify

Eine optionale Nachricht des Clients an den Server, der den Server über den Downloadstatus informiert.

Die Nutzlast lautet nl::Weave::Profiles::StatusReporting::StatusReport, mit den zusätzlichen Statusinformationen aus SoftwareUpdateStatusCodes.

kMsgType_ImageAnnounce

Optionale Nachricht, die vom Server verwendet wird, um die Verfügbarkeit eines Softwareupdates zu melden.

Die Nachricht hat keine Nutzlast.

kMsgType_ImageQuery

Eine vom Client an den Server gesendete Abfragenachricht.

Das Format wird mit der Klasse ImageQuery definiert.

kMsgType_ImageQueryResponse

Eine Nachricht, die als Antwort auf eine erfolgreiche Bildabfragenachricht generiert wird.

Das Format wird von der Klasse ImageQueryResponse definiert.

kMsgType_ImageQueryStatus

Eine Nachricht, die als Antwort auf eine fehlgeschlagene Bildabfragenachricht generiert wird.

Die Nutzlast lautet nl::Weave::Profiles::StatusReporting::StatusReport, mit den zusätzlichen Statusinformationen aus SoftwareUpdateStatusCodes.

kMsgType_NotifyResponse

Diese Nachricht wurde als Antwort auf die Download-Benachrichtigung generiert.

Die Nutzlast lautet nl::Weave::Profiles::StatusReporting::StatusReport, mit den zusätzlichen Statusinformationen aus SoftwareUpdateStatusCodes.

kMsgType_UpdateNotify

Eine optionale Nachricht vom Client an den Server, über den der endgültige Status der Aktualisierung kommuniziert wird.

Die Nutzlast lautet nl::Weave::Profiles::StatusReporting::StatusReport, mit den zusätzlichen Statusinformationen aus SoftwareUpdateStatusCodes. Da die Nachricht nach der tatsächlichen Aktualisierung erwartet wird, wird sie an einen neuen ExchangeContext gesendet und als unerwünschte Nachricht auf dem Server behandelt.

@310

 @310

SoftwareUpdate-profilspezifische Statuscodes.

Attribute
kStatus_Abort

server => client, gibt an, dass der Client aufgeben soll, weil der Server keine Optionen hat

kStatus_DownloadFailed

server gagt; zeigt an, dass ein Versuch des Downloads fehlgeschlagen ist.

kStatus_IntegrityCheckFailed

client 5gt; zeigt an, dass ein Image heruntergeladen wurde, aber die nachfolgende Integritätsprüfung fehlgeschlagen ist.

kStatus_InvalidInstructions

server gagt; zeigt an, dass der Client kein Bild herunterladen konnte, weil die Downloadanleitung in der ImageQueryResponse enthalten ist, d.h.

URI, Update-Schema, Aktualisierungsbedingung, waren fehlerhaft formatiert oder inkonsistent.

kStatus_NoUpdateAvailable

server gagt; zeigt an, dass eine Bildabfrage empfangen und gelesen wurde und dass der Server derzeit nicht aktualisiert wurde.

kStatus_Retry

server gagt; Client, gibt an, dass der Client eine andere Bildabfrage senden und das Update neu starten/fortsetzen soll

kStatus_UpdateFailed

client => gibt an, dass der Versuch, ein vom Server angegebenes Bild zu installieren, fehlgeschlagen ist.

@311

 @311

Steuerungs-Flags für das Steuerfeld des ImageQuery-Frames

Attribute
kFlag_LocaleSpecPresent

Die Locale-Spezifikation ist in der ImageQuery vorhanden.

kFlag_PackageSpecPresent

Die Paketspezifikation ist in der ImageQuery enthalten.

kFlag_TargetNodeIdPresent

Die Zielknoten-ID ist in der ImageQuery vorhanden.

@312

 @312

Bitmasken für das optionale Feld mit den Aktualisierungsoptionen von ImageQueryResponse.

@313

 @313

Offsets für das optionale Feld für die Updateoptionen der ImageQueryResponse.

@314

 @314

Integritätstypen, die vom Profil SoftwareUpdate unterstützt werden.

Der Bildabfrageframe enthält Informationen darüber, welche Integritätsprüfung der Client unterstützt, und die Bildabfrageantwort enthält einen Integritätstyp und Wert für das Image, das der Client in Bezug auf das Herunterladen und Installieren erhält. Folgende Typen werden unterstützt:

Attribute
kIntegrityType_Last

Anzahl der gültigen Elemente in der Aufzählung.

kIntegrityType_SHA160

160-Bit-Secure Hash (SHA-1), erforderlich.

kIntegrityType_SHA256

256-Bit-Secure-Hash (SHA-2).

kIntegrityType_SHA512

512-Bit, Secure Hash (SHA-2).

@315

 @315

Längen in Byte für die Integritätsspezifikation „Byte-Strings“.

@316

 @316

Von SofwareUpdate-Profil unterstützte Schemas aktualisieren.

Ähnlich wie bei den unterstützten Integritätstypen enthält die Image-Abfrage Informationen darüber, welche Update-Schemas (z. B. Download-Protokolle) vom Client unterstützt werden. Die Antwort enthält einen Wert für die Angabe des Update-Schemas zum Herunterladen der Images. Unterstützte Schemas:

Attribute
kUpdateScheme_BDX

Für das Downloadprotokoll wird die Webübertragung von Weave verwendet.

kUpdateScheme_HTTP

Als Downloadprotokoll wird HTTP verwendet.

kUpdateScheme_HTTPS

HTTPS wird als Downloadprotokoll verwendet.

kUpdateScheme_Last

Anzahl der gültigen Elemente in der Aufzählung.

kUpdateScheme_SFTP

SFTP wird als Downloadprotokoll verwendet.

@317

 @317

Datenelement-Tags für das SoftwareUpdate-Profil

Update-Bedingung

 UpdateCondition

Bedingungen für Updaterichtlinien.

Attribute
IfLater

Laden Sie das Image herunter und installieren Sie es, wenn die Versionsspezifikation im Antwortframe nach der aktuell installierten Softwareversion liegt.

IfUnmatched

Laden Sie das Image herunter und installieren Sie es, wenn die Versionsspezifikation im Antwortframe nicht mit der aktuell installierten Softwareversion übereinstimmt.

OnOptIn

Image herunterladen und auf einem Trigger installieren, der vom Nutzer auf der Website bereitgestellt wird

Unconditionally

Laden Sie das Image herunter und installieren Sie es, unabhängig davon, welche Softwareversion Sie derzeit verwenden.

Priorität aktualisieren

 UpdatePriority

Prioritäten aktualisieren

Attribute
Critical

Die Aktualisierung muss sofort ausgeführt werden.

Normal

Die Aktualisierung kann nach Ermessen des Kunden erfolgen.

Funktionen

Integritätslänge

int integrityLength(
  uint8_t aType
)

Eine Supportmethode, die die Werte von IntegrityTypes auf die Länge der Hashes dieses Typs zuordnet.

Details
Parameter
[in] aType
Ein IntegrityTypes-Wert
Rückgabe
Länge des Hashs des angegebenen Hash-Typs.