Lire en anglais

Partager via

Structure de message WiFiCx

  • Article

Les messages de commande WiFiCx sont basés sur les commandes précédentes du modèle WDI.

Tous les messages de commande Wi-Fi doivent commencer par une structure WDI_MESSAGE_HEADER . L’en-tête de commande est suivi de zéro ou plusieurs structures type-longueur-valeur (TLV).

Les ID de message de commande définis pour les messages envoyés à partir de l’hôte à l’appareil Wi-Fi sont documentés dans les OID de tâche WiFiCx, les OID de propriété WiFiCx et les indications de status WiFiCx.

TTLVs

La structure des TTLVs est définie dans le tableau suivant. Les données dans les TTLV sont dans l’ordre d’octets little-endian.

Champ Type Description
Type UINT16 Type de la structure TLV. Les types TLV non reconnus doivent être ignorés sans déclencher d’erreurs.
Longueur de la mémoire tampon value UINT16 Taille de la mémoire tampon Valeur en octets.
Valeur BYTE[*] Mémoire tampon de charge utile, qui peut contenir une structure, une liste de structures ou d’autres TTL. S’il y a plus de données que prévu dans une TLV, les données supplémentaires doivent être ignorées sans déclencher d’erreurs.

Il existe deux types de regroupements TLV : les listes TLV de taille statique et les groupes multi-TLV.

Listes TLV de taille statique

Les listes TLV de taille statique contiennent plusieurs membres de taille statique. Ils sont analogues aux tableaux de style C standard.

Dans cet exemple, WDI_TLV_UNICAST_ALGORITHM_LIST est défini comme une liste de WDI_ALGO_PAIRS.

Type : WDI_TLV_UNICAST_ALGORITHM_LIST

Longueur : N * sizeof(WDI_ALGO_PAIRS)

Valeur : WDI_ALGO_PAIRS[N]

Cette utilisation est spécifiée dans les rubriques de référence TLV avec notation matricielle.

Groupes multi-TLV

Lorsque la taille d’un objet donné n’est pas connue à l’avance, des groupes multi-TLV sont utilisés. Ce modèle d’utilisation spécifie que N TLV de taille variable différentes sont attendus dans une mémoire tampon donnée. Le nombre d’entrées (N) n’est pas connu à l’avance et est déduit par le nombre de VTL correspondants dans la mémoire tampon donnée.

Dans cet exemple, la mémoire tampon parente est un WDI_MESSAGE_HEADER, qui définit la fin de la mémoire tampon TLV. Notez que WDI_TLV_BSS_ENTRY peuvent être entrelacés entre d’autres types TLV différents dans la mémoire tampon parente.

Offset Champ Type
0 WDI_MESSAGE_HEADER En-tête du message
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) Un autre type TLV
TLV₃ + L₃ + sizeof(TLV Header) TLV₄ (WDI_TLV_BSS_ENTRY) WDI_BSS_ENTRY

Pour les TLV qui contiennent d’autres TLV, les rubriques de référence TLV ont une colonne Plusieurs instances TLV autorisées . Si cette colonne est cochée, la valeur TLV spécifiée est autorisée à apparaître plusieurs fois. Pour obtenir un exemple de ceci, consultez WDI_TLV_CONNECT_PARAMETERS.