WiFiCx-Nachrichtenstruktur
WiFiCx-Befehlsmeldungen basieren auf den vorherigen WDI-Modellbefehlen.
Alle Wi-Fi Befehlsmeldungen müssen mit einer WDI_MESSAGE_HEADER-Struktur beginnen. Auf den Befehlsheader folgen null oder mehr TLV-Strukturen (Type-Length-Value).
Die Befehlsmeldungs-IDs, die für Nachrichten definiert sind, die vom Host an das Wi-Fi-Gerät gesendet werden, werden in WiFiCx-Task-OIDs, WiFiCx-Eigenschafts-OIDs und WiFiCx-status-Indikationen dokumentiert.
TLVs
Die Struktur der TLVs ist in der folgenden Tabelle definiert. Die Daten in TLVs befinden sich in Little-Endian-Bytereihenfolge.
| Feld | Typ | BESCHREIBUNG |
|---|---|---|
| Typ | UINT16 | Der Typ der TLV-Struktur. Nicht erkannte TLV-Typen müssen übersprungen werden, ohne Fehler auszulösen. |
| Länge des Wertpuffers | UINT16 | Die Größe des Wertpuffers in Bytes. |
| Wert | BYTE[*] | Der Nutzlastpuffer, der eine Struktur, eine Liste von Strukturen oder andere TLVs enthalten kann. Wenn mehr Daten als erwartet in einem TLV vorhanden sind, sollten die zusätzlichen Daten übersprungen werden, ohne Fehler auszulösen. |
Es gibt zwei Arten von TLV-Gruppierungen: statisch große TLV-Listen und Multi-TLV-Gruppen.
TLV-Listen mit statischer Größe
Statisch große TLV-Listen enthalten mehrere elemente in statischer Größe. Sie sind analog zu Standardarrays im C-Stil.
In diesem Beispiel wird WDI_TLV_UNICAST_ALGORITHM_LIST als Liste von WDI_ALGO_PAIRS definiert.
Typ: WDI_TLV_UNICAST_ALGORITHM_LIST
Länge: N * sizeof(WDI_ALGO_PAIRS)
Wert: WDI_ALGO_PAIRS[N]
Diese Verwendung wird in den TLV-Referenzthemen mit Arraynotation angegeben.
Mehrere TLV-Gruppen
Wenn die Größe eines bestimmten Objekts nicht im Voraus bekannt ist, werden mehrere TLV-Gruppen verwendet. Dieses Verwendungsmuster gibt an, dass N unterschiedliche, variabel große TLVs in einem bestimmten Puffer erwartet werden. Die Anzahl der Einträge (N) ist nicht im Voraus bekannt und wird durch die Anzahl der übereinstimmenden TLVs im angegebenen Puffer abgeleitet.
In diesem Beispiel ist der übergeordnete Puffer ein WDI_MESSAGE_HEADER, der das Ende des TLV-Puffers definiert. Beachten Sie, dass WDI_TLV_BSS_ENTRY möglicherweise zwischen anderen verschiedenen TLV-Typen im übergeordneten Puffer eingestreut sein kann.
| Offset | Feld | type |
|---|---|---|
| 0 | WDI_MESSAGE_HEADER | Nachrichtenheader |
| sizeof(WDI_MESSAGE_HEADER) | TLV₀ (WDI_TLV_BSS_ENTRY) | WDI_BSS_ENTRY |
| TLV₀ + L₀ + sizeof(TLV-Header) | TLV₁ (WDI_TLV_BSS_ENTRY) | WDI_BSS_ENTRY |
| TLV₁ + L₁ + sizeof(TLV-Header) | TLV₂ (WDI_TLV_BSS_ENTRY) | WDI_BSS_ENTRY |
| TLV₂ + L₂ + sizeof(TLV-Header) | TLV₃ (OTHER_TLV_TYPE) | Ein anderer TLV-Typ |
| TLV₃ + L₃ + sizeof(TLV-Header) | TLV₄ (WDI_TLV_BSS_ENTRY) | WDI_BSS_ENTRY |
Für TLVs, die andere TLVs enthalten, verfügen die TLV-Referenzthemen über eine Spalte Mit mehreren zulässigen TLV-Instanzen . Wenn diese Spalte aktiviert ist, darf der angegebene TLV mehrmals angezeigt werden. Ein Beispiel hierfür finden Sie unter WDI_TLV_CONNECT_PARAMETERS.