Opérations d’attachement MB LTE
Configuration APN d’attachement LTE pour les modems MBIM
Traditionnellement, l’attachement LTE est considéré comme faisant partie de l’inscription et Windows n’a pas été directement impliqué dans les procédures d’attachement LTE. Toutefois, contrairement aux inscriptions réseau de commutateur de circuit classiques, LTE est un réseau à commutateur de paquets uniquement et nécessite qu’un porteur EPS par défaut soit activé pour que l’appareil conserve l’inscription sur le réseau LTE.
Pour établir un porteur EPS par défaut avec le réseau, l’appareil doit demander une activation du contexte PDP pendant la procédure d’attachement LTE, qui nécessite la spécification APN (Access Point Name). Selon la norme 3GPP, il existe quatre scénarios où un appareil peut spécifier APN lorsqu’il tente d’attacher LTE :
- L’appareil spécifie un APN d’attachement LTE spécifique.
- L’appareil spécifie un APN d’attachement LTE spécifique, mais le réseau décide de laisser l’appareil attacher sur un autre APN à la place pendant l’itinérance.
- L’appareil ne spécifie pas d’APN d’attachement LTE et permet au réseau d’en attribuer un à l’appareil.
- L’appareil inscrit à partir d’un réseau 2G/3G vers LTE et il y avait déjà au moins un contexte PDP actif. Le réseau l’utilise comme APN d’attachement LTE.
Aujourd’hui, toutes les informations APN d’attachement LTE sont fournies par les IVS et les OEM directement dans le modem pour chaque fournisseur pour lequel il a la configuration. Toutefois, il ne s’agit pas d’un modèle entièrement évolutif pour les IHVs et les OEM d’avoir tous les paramètres APN d’attachement LTE possibles pour tous les opérateurs du monde entier. À compter de Windows 10 version 1703, de nouvelles interfaces sont définies pour les OID NDIS et les CID propriétaires MICROSOFT MBIM pour prendre en charge la configuration APN d’attachement LTE à partir du système d’exploitation.
À compter de Windows 10, version 1703, si le matériel sous-jacent prend en charge la configuration APN d’attachement LTE à partir du système d’exploitation, l’utilisateur peut configurer l’APN d’attachement LTE à partir de Paramètres. Le matériel qui a des configurations APN d’attachement LTE par défaut doit également rendre sa configuration disponible par le système d’exploitation.
Cette fonctionnalité est prise en charge en ajoutant deux nouveaux OID et CID. Pour les partenaires IHV qui implémentent MBIM, seule la version CID doit être prise en charge.
Mise à jour de l’interface Mo pour les opérations d’attachement LTE
Deux nouveaux CID MBIM ont été créés pour permettre la configuration APN d’attachement LTE et pour que le système d’exploitation récupère la dernière status d’attachement LTE de l’appareil. Si les partenaires IHV décident de prendre en charge la gestion APN d’attachement LTE par défaut du système d’exploitation, les deux commandes doivent être prises en charge.
Nom du service = Extensions de connexion de base
UUID = UUID_BASIC_CONNECT_EXTENSIONS
Valeur UUID = 3d01dcc5-fef5-4d05-0d3abef7058e9aaf
| CID | Code de commande | Version minimale du système d’exploitation |
|---|---|---|
| MBIM_CID_MS_LTE_ATTACH_CONFIG | 3 | Windows 10 version 1703 |
| MBIM_CID_MS_LTE_ATTACH_STATUS | 4 | Windows 10 version 1703 |
MBIM_CID_MS_LTE_ATTACH_CONFIG
Description
Les contextes d’attachement LTE peuvent être différents, selon la façon dont le réseau interagit avec l’appareil pendant l’exécution. Pour le reste de cette documentation, le contexte d’attachement LTE sera appelé contexte PDP actuel utilisé pour l’attachement LTE et le contexte d’attachement LTE par défaut sera appelé ce qui est configuré sur l’appareil effectuant l’attachement LTE avec quand il n’existe aucun autre contexte PDP activé. MBIM_CID_MS_LTE_ATTACH_CONFIG permet au système d’exploitation d’interroger et de définir le contexte d’attachement LTE par défaut du fournisseur de la carte SIM insérée (paire MCC/MNC).
Bien que l’APN d’attachement LTE puisse être techniquement considéré comme un contexte, il diffère de tous les autres contextes stockés dans le modem. Pour tous les autres contextes, l’activation se produit après l’inscription et, en fonction de différentes conditions, le système d’exploitation peut décider du contexte le mieux adapté à la connexion. Toutefois, le contexte d’attachement LTE est activé dans le cadre de l’inscription de l’appareil sur le réseau LTE. Le système d’exploitation ne peut pas récupérer les status liées au réseau avant la fin de l’inscription ; en raison de cette limitation, le système d’exploitation doit être en mesure de configurer le contexte d’attachement LTE pour toutes les différentes conditions d’itinérance de l’appareil afin de s’assurer que l’appareil peut s’inscrire sur le réseau LTE, quel que soit le status d’itinérance.
L’activation du contexte d’attachement LTE avec le réseau ne nécessite pas de demande de connexion explicite du système d’exploitation, car le système d’exploitation n’a pas connaissance de l’activation du contexte auto-initié par un modem. Le contexte d’attachement LTE par défaut appartient à cette catégorie. Lorsque le système d’exploitation émet une demande de MBIM_CID_CONNECT pour activer un contexte PDP et que le contexte PDP donné correspond à tous les éléments suivants, le modem doit terminer la demande d’activation CID avec succès sans afficher de nouveau porteur en direct avec le réseau :
- Il existe un contexte PDP activé qui est initié par le modem et qui n’est pas mis à la disposition du système d’exploitation.
- Le contexte PDP correspond à l’APN spécifié dans la requête CID.
- Le type d’adresse IP du contexte PDP activé est compatible avec le type d’adresse IP demandé dans le CID.
Cela est important, car le système d’exploitation ne connaît pas tous les contextes PDP qui ont été initiés par le modem. Cela réduit le bruit et la charge du réseau. Sinon, le modem doit afficher un nouveau porteur en direct correspondant à la spécification APN du système d’exploitation conformément à une demande d’activation de contexte normal. La compatibilité du type IP est spécifiée ici :
| Type IP du contexte PDP activé dans le modem | Compatible avec le ou les types d’adresses IP demandés | Incompatible avec le type d’adresse IP demandée |
|---|---|---|
| IPv4 | Par défaut; IPv4 ; IPv4v6 ; IPv4 et v6 | IPv6 |
| IPv6 | Par défaut; IPv6 ; IPv4v6 ; IPv4 et v6 | IPv4 |
| IPv4v6 | Par défaut; IPv4 ; IPv6 ; IPv4v6 ; IPv4 et v6 | None |
Notes
Le modem ne doit pas afficher un second contexte PDP si un seul type d’adresse IP est activé en direct. Par exemple, si IPv4 est activé et que l’hôte demande IPv4 et IPv6, le modem doit terminer la demande d’activation sans générer de porteur IPv6.
Lorsque le système d’exploitation émet une demande MBIM_CID_CONNECT de désactivation d’un contexte PDP, le modem doit case activée les éléments suivants :
- Indique si l’appareil est attaché à LTE et le contexte à désactiver est le seul contexte PDP activé pour maintenir l’inscription LTE
- Si le contexte à désactiver est également utilisé par le modem en interne pour tous les services qui ne sont pas exposés au système d’exploitation
Si l’une ou l’autre de ces valeurs est vraie, le modem doit terminer la demande de désactivation du CID, mais continuer à gérer le porteur en direct avec le réseau. Sinon, le modem doit désactiver le contexte en fonction des demandes de désactivation normales.
Toute la configuration APN d’attachement LTE par défaut fournie par le système d’exploitation est par fournisseur et correspond à l’ID du fournisseur d’accueil de l’carte SIM inséré (paire MCC/MNC). Le modem doit uniquement fournir le contexte d’attachement LTE configuré pour l’ID de fournisseur de la carte SIM insérée en cours lorsqu’il est interrogé. Le modem doit toujours retourner trois contextes d’attachement LTE par défaut qui correspondent à l’ID de fournisseur de la carte SIM insérée, un pour chaque condition d’itinérance (home/partner/non-partner).
On s’attend à ce que le modem efface son contexte d’attachement LTE par défaut avant d’appliquer la configuration pour le prochain carte SIM. Si le carte SIM nouvellement inséré n’a pas de configuration de contexte d’attachement LTE par défaut, l’appareil doit retourner des chaînes vides NULL pour l’APN du contexte d’attachement LTE pour toutes les conditions d’itinérance tout en conservant le contexte activé. Si le contexte est désactivé, il est attendu que l’appareil ne s’attache pas sur LTE, car il n’existe aucune configuration utilisable pour l’attachement LTE. Lorsque l’utilisateur revient à un carte SIM qui a été configuré précédemment sur l’appareil, le modem doit restaurer sa configuration d’attachement LTE d’usine par défaut pour le carte SIM. Il n’est pas prévu que la configuration du temps d’exécution persiste entre les échanges SIM. À tout moment, il ne doit y avoir qu’un seul APN d’attachement LTE par défaut dans le modem par condition d’itinérance (home/partner/non-partner).
Le système d’exploitation définit toujours les trois contextes d’attachement LTE par défaut lorsqu’une commande Set est émise, une pour chaque condition d’itinérance. Si la liste fournie par le système d’exploitation n’en a pas exactement trois, la commande Set doit être rejetée. Si l’un des contextes d’attachement LTE par défaut fournis est configuré par le système d’exploitation où la condition d’itinérance correspond à la status d’inscription actuelle, le modem doit se détacher du réseau et effectuer à nouveau l’attachement LTE avec le contexte d’attachement LTE nouvellement spécifié. Sinon, l’appareil doit utiliser le contexte d’attachement LTE par défaut spécifié la prochaine fois que les conditions d’itinérance correspondent. Si le contexte d’attachement LTE par défaut spécifié par l’appareil ne parvient pas à s’inscrire sur le réseau LTE, l’appareil doit revenir à la 3G/2G le cas échéant. Lorsque le modem ne peut pas faire la différence entre les réseaux partenaires et non partenaires, le modem doit utiliser le contexte d’attachement LTE par défaut non partenaire pour tous les scénarios d’itinérance. Si le système d’exploitation configure le contexte d’attachement LTE par défaut comme type IP = valeur par défaut, le modem devrait affecter le type d’adresse IP le plus approprié pour le contexte d’attachement LTE. Toutefois, le système d’exploitation s’attend à ce que le modem retourne toujours les conditions d’itinérance du partenaire et le type IP du contexte d’attachement LTE qui reflète la configuration avec précision.
Les IVS et les oem peuvent préconfigurer le contexte d’attachement LTE comme configuration par défaut dans le modem, mais ces contextes doivent être étiquetés comme MBIM_MS_CONTEXT_SOURCE = MbimMsContextSourceModemProvisioned.
Selon la norme 3GPP, le contexte d’attachement LTE par défaut peut être divisé en deux catégories : initié par l’UE et initié par le réseau. Si l’appareil est configuré avec une chaîne d’accès vide NULL, l’appareil est censé ne pas fournir de contexte d’attachement LTE au réseau et attendre que le réseau lui en assigne un à nouveau. Comme le prévoit MBIM 1.0, si le type IP du contexte d’attachement LTE est configuré pour être par défaut, le modem doit sélectionner le meilleur type d’adresse IP en fonction de son algorithme interne.
Le diagramme suivant illustre un exemple de flux de configuration d’attachement LTE.
Requête
MBIM_MS_LTE_ATTACH_CONFIG_INFO est retourné à partir des messages Requête et Définition terminés dans InformationBuffer. Pour Query, informationBuffer a la valeur NULL.
Set
Pour Set, informationBuffer contient un MBIM_MS_SET_LTE_ATTACH_CONFIG.
Événements non sollicités
Event InformationBuffer contient une structure MBIM_MS_LTE_ATTACH_CONFIG_INFO. Dans certains cas, le contexte d’attachement LTE par défaut est mis à jour par le réseau OTA (Over-The-Air) ou par le service sms (Short Message Service) qui ne passe pas par la commande MBIM_CID_MS_LTE_ATTACH_CONFIG du système d’exploitation. La fonction doit mettre à jour les contextes d’attachement LTE par défaut et baliser MBIM_MS_CONTEXT_SOURCE = MbimMsContextSourceOperatorProvisioned en conséquence. Après cela, les fonctions doivent informer l’hôte des mises à jour qui utilisent cet événement avec la liste mise à jour.
Paramètres
| Opération | Set | Requête | Notification |
|---|---|---|---|
| Commande | MBIM_SET_MS_LTE_ATTACH_CONFIG | Non applicable | Non applicable |
| response | MBIM_MS_LTE_ATTACH_CONFIG_INFO | MBIM_MS_LTE_ATTACH_CONFIG_INFO | MBIM_MS_LTE_ATTACH_CONFIG_INFO |
Structures de données
Requête
InformationBuffer doit être NULL et InformationBufferLength doit être égal à zéro.
Set
La structure de MBIM_MS_SET_LTE_ATTACH_CONFIG suivante doit être utilisée dans InformationBuffer. La commande Set n’est valide que si la liste contient un nombre d’éléments de trois, un pour chaque condition d’itinérance (home/partner/non-partner).
| Offset | Taille | Champ | Type | Description |
|---|---|---|---|---|
| 0 | 4 | Opération | MBIM_MS_LTE_CONTEXT_OPERATIONS | Spécifie le type d’opération pour lequel la commande Set est utilisée. Si la valeur est MbimMsLteAttachContextOperationRestoreFactory, tous les autres champs doivent être ignorés. Les contextes d’attachement LTE par défaut créés ou modifiés par le système d’exploitation doivent être supprimés et les contextes d’attachement LTE préconfigurés par défaut préconfigurés par défaut doivent être chargés. Si le modem n’a pas de configuration par défaut, tous les contextes d’attachement LTE par défaut de condition d’itinérance doivent être définis sur une chaîne APN vide et le type IP = par défaut. |
| 4 | 4 | ElementCount (EC) | UINT32 | Nombre de structures MBIM_MS_LTE_ATTACH_CONTEXT qui suivent dans DataBuffer. Ce composant est actuellement spécifié à trois, un pour chaque condition d’itinérance (domicile/partenaire/non partenaire). |
| 8 | 8 * EC | MsLteAttachContextRefList | OL_PAIR_LIST | Le premier élément de la paire est un décalage de 4 octets, calculé à partir du début (décalage 0) de cette structure MBIM_MS_LTE_ATTACH_CONFIG_INFO, vers une structure MBIM_MS_LTE_ATTACH_CONTEXT (pour plus d’informations, voir le tableau MBIM_MS_LTE_ATTACH_CONTEXT). Le deuxième élément de la paire est une taille de 4 octets d’un pointeur vers la structure MBIM_MS_LTE_ATTACH_CONTEXT correspondante. |
| 8 + (8 * EC) | DataBuffer | DATABUFFER | Tableau de structures MBIM_MS_LTE_ATTACH_CONTEXT. |
Les structures suivantes sont utilisées dans le tableau précédent.
MBIM_MS_LTE_ATTACH_CONTEXT_OPERATIONS décrit les types d’opérations qui peuvent être utilisés dans la commande Set.
| Type | Valeur | Description |
|---|---|---|
| MbimMsLteAttachContextOperationDefault | 0 | Opération par défaut pour remplacer les contextes d’attachement LTE par défaut existants dans le modem. Le système d’exploitation remplacera toujours les trois contextes d’attachement LTE par défaut pour les conditions d’itinérance. |
| MbimMsLteAttachContextOperationRestoreFactory | 1 | Restaurez le contexte d’attachement LTE par défaut préconfiguré d’usine pour l’ID de fournisseur de la carte SIM actuellement insérée. Tous les contextes d’attachement LTE par défaut remplacés ou créés par le système d’exploitation doivent être supprimés et remplacés. S’il n’existe aucun contexte d’attachement LTE par défaut préconfiguré pour l’ID du fournisseur SIM inséré actuel avec une ou plusieurs conditions d’itinérance, l’attachement LTE par défaut doit retourner une chaîne APN vide et un type IP = par défaut. |
MBIM_MS_LTE_ATTACH_CONTEXT spécifie le contexte à utiliser pour la configuration de l’attachement LTE.
| Offset | Taille | Champ | Type | Description |
|---|---|---|---|---|
| 0 | 4 | IPType | MBIM_CONTEXT_IP_TYPE | Pour plus d’informations, consultez la table MBIM_CONTEXT_IP_TYPE. |
| 4 | 4 | Itinérance | MBIM_MS_LTE_ATTACH_CONTEXT_ROAMING_CONTROL | Indique quelle condition d’itinérance s’applique à ce contexte d’attachement LTE par défaut. Pour plus d’informations, consultez la table MBIM_MS_LTE_ATTACH_CONTEXT_ROAMING_CONTROL. |
| 8 | 4 | Source | MBIM_MS_CONTEXT_SOURCE | Spécifie la source de création du contexte. Pour plus d’informations, consultez le tableau MBIM_MS_CONTEXT_SOURCE. |
| 12 | 4 | AccessStringOffset | OFFSET | Décalage dans la mémoire tampon de données vers une chaîne, AccessString, pour accéder au réseau. Pour les réseaux gsm, il s’agit d’une chaîne de nom de point d’accès (APN) telle que « data.thephone-company.com ». La taille de la chaîne ne doit pas dépasser 100 caractères. Si AccessString est vide, l’appareil s’attend à ce que le réseau lui attribue une chaîne d’accès. Le type IP doit toujours être spécifié dans ce cas. |
| 16 | 4 | AccessStringSize | SIZE(0..200) | Taille utilisée pour AccessString. Cette valeur doit être 0 si l’appareil s’attend à ce que le réseau attribue une chaîne d’accès à l’appareil pour l’attachement LTE. |
| 20 | 4 | UserNameOffset | OFFSET | Décalage en octets, calculé à partir du début de cette structure, vers une chaîne, UserName, qui représente le nom d’utilisateur à authentifier. Ce membre peut avoir la valeur NULL. |
| 24 | 4 | UserNameSize | SIZE(0..510) | Taille utilisée pour UserName. |
| 28 | 4 | PasswordOffset | OFFSET | Décalage en octets, calculé à partir du début de cette structure, vers une chaîne, Password, qui représente le mot de passe du nom d’utilisateur. Ce membre peut avoir la valeur NULL. |
| 32 | 4 | PasswordSize | SIZE(0..510) | Taille utilisée pour le mot de passe. |
| 36 | 4 | Compression | MBIM_COMPRESSION | Spécifie la compression à utiliser dans la connexion de données pour l’en-tête et les données. Ce membre s’applique uniquement aux appareils GSM. L’hôte définit ce membre sur MBIMCompressionNone pour les appareils CDMA. Pour plus d’informations, consultez la table MBIM_COMPRESSION. |
| 40 | 4 | AuthProtocol | MBIM_AUTH_PROTOCOL | Type d’authentification à utiliser pour l’activation PDP. Pour plus d’informations, consultez la table MBIM_AUTH_PROTOCOL. |
| 44 | DataBuffer | DATABUFFER | Mémoire tampon de données qui contient AccessString, UserName et Password. |
MBIM_MS_LTE_ATTACH_CONTEXT_ROAMING_CONTROL indique quelle condition d’itinérance s’applique à ce contexte d’attachement LTE par défaut.
| Type | Valeur | Description |
|---|---|---|
| MbimMsLteAttachContextRoamingControlHome | 0 | Indique si le contexte d’attachement LTE par défaut est autorisé à être utilisé sur le réseau domestique ou non. |
| MbimMsLteAttachContextRoamingControlPartner | 1 | Indique si le contexte est autorisé à être utilisé sur les réseaux d’itinérance partenaires ou non. |
| MbimMsLteAttachContextRoamingControlNonPartner | 2 | Indique si le contexte est autorisé à être utilisé sur des réseaux itinérants non partenaires ou non. |
MBIM_MS_CONTEXT_SOURCE spécifie la source de création du contexte.
| Type | Valeur | Description |
|---|---|---|
| MbimMsContextSourceAdmin | 0 | Le contexte a été créé par un administrateur informatique d’entreprise à partir du système d’exploitation. |
| MbimMsContextSourceUser | 1 | Le contexte a été créé par l’utilisateur via les paramètres du système d’exploitation. |
| MbimMsContextSourceOperator | 2 | Le contexte a été créé par l’opérateur via OMA-DM ou d’autres canaux. |
| MbimMsContextSourceModem | 3 | Le contexte a été créé par iHV ou OEM. |
| MbimMsContextSourceDevice | 4 | Le contexte a été créé par la base de données APN du système d’exploitation. |
response
La structure MBIM_MS_LTE_ATTACH_CONFIG_INFO suivante doit être utilisée dans InformationBuffer.
| Offset | Taille | Champ | Type | Description |
|---|---|---|---|---|
| 0 | 4 | ElementCount (EC) | UINT32 | Nombre de structures MBIM_MS_LTE_ATTACH_CONTEXT qui suivent dans DataBuffer. Ce composant est actuellement spécifié à trois, un pour chaque condition d’itinérance (home/partner/non-partner). |
| 4 | 8 * EC | MsLteAttachContextRefList | OL_PAIR_LIST | Le premier élément de la paire est un décalage de 4 octets, calculé entre le début (décalage 0) de cette structure MBIM_MS_LTE_ATTACH_CONFIG_INFO, et une structure MBIM_MS_LTE_ATTACH_CONTEXT (pour plus d’informations, voir le tableau MBIM_MS_LTE_ATTACH_CONTEXT). Le deuxième élément de la paire est une taille de 4 octets d’un pointeur vers la structure MBIM_MS_LTE_ATTACH_CONTEXT correspondante. |
| 4 + (8 * CE) | DataBuffer | DATABUFFER | Tableau de structures MBIM_MS_LTE_ATTACH_CONTEXT. |
Notification
Pour plus d’informations, consultez le tableau MBIM_MS_LTE_ATTACH_CONFIG_INFO.
Codes d’état
Pour les opérations de requête et d’ensemble :
| Code d’état | Description |
|---|---|
| MBIM_STATUS_READ_FAILURE | L’opération a échoué, car l’appareil n’a pas pu récupérer les contextes provisionnés. |
| MBIM_STATUS_NO_DEVICE_SUPPORT | L’opération a échoué, car l’appareil ne prend pas en charge l’opération. |
Pour Définir uniquement les opérations :
| Code d’état | Description |
|---|---|
| MBIM_STATUS_INVALID_PARAMETERS | L’opération a échoué en raison de paramètres non valides. |
| MBIM_STATUS_WRITE_FAILURE | L’opération a échoué, car la demande de mise à jour a échoué. |
MBIM_CID_MS_LTE_ATTACH_STATUS
Description
Par exigence 3GPP, bien qu’un appareil puisse spécifier le contexte d’attachement LTE par défaut à utiliser lors de l’attachement LTE au réseau sans contexte PDP activé, il peut arriver que l’appareil s’attache LTE sur un contexte PDP différent du contexte d’attachement LTE par défaut configuré sur l’appareil. Voici une liste de tous les scénarios possibles :
- L’UE spécifie un APN d’attachement LTE spécifique.
- L’UE spécifie un APN d’attachement LTE spécifique, mais le réseau décide de laisser l’appareil attacher sur un autre APN à la place pendant l’itinérance.
- L’UE ne spécifie pas d’APN d’attachement LTE et permet au réseau d’en attribuer un à l’appareil.
- L’UE inscrite à partir du réseau 2G/3G vers LTE et il y avait déjà au moins un contexte PDP actif. Le réseau l’utilise comme APN d’attachement LTE.
Lorsque l’appareil est attaché par défaut à LTE, il doit envoyer une notification de MBIM_CID_MS_LTE_ATTACH_STATUS au système d’exploitation pour fournir des détails sur le contexte PDP sur la dernière pièce jointe LTE. L’attachement LTE par défaut se produit lorsque l’un des scénarios suivants est respecté :
- L’appareil est initialement attaché au réseau LTE.
- L’appareil passe de 2G/3G à LTE sans contexte PDP activé au préalable.
Le contexte d’attachement LTE retourné par MBIM_CID_LTE_ATTACH_STATUS peut être l’un des éléments suivants :
- Contexte d’attachement LTE par défaut stocké dans le modem.
- Contexte d’attachement LTE par défaut qui a été affecté à partir du réseau.
Pendant l’exécution, le système d’exploitation doit également être en mesure d’interroger les dernières informations d’attachement utilisées pour l’attachement LTE par défaut. Le modem est censé retourner le dernier contexte d’attachement LTE par défaut connu. Si l’appareil a été transféré de LTE au réseau 2G/3G, il est attendu que le modem retourne le contexte utilisé pour l’attachement LTE précédent. Chaque fois que l’appareil se désinsère du réseau, il est attendu que l’APN devienne vide.
Le diagramme ci-dessous illustre un exemple de flux de messages pour l’attachement LTE status.
Requête
MBIM_MS_LTE_ATTACH_STATUS est retourné à partir des messages complets de requête dans InformationBuffer. Pour Query, informationBuffer a la valeur NULL.
Set
Les opérations d’ensemble ne sont pas prises en charge.
Événements non sollicités
Event InformationBuffer contient une structure MBIM_MS_LTE_ATTACH_STATUS.
Paramètres
| Opération | Set | Requête | Notification |
|---|---|---|---|
| Commande | Non applicable | Non applicable | Non applicable |
| response | Non applicable | MBIM_MS_LTE_ATTACH_STATUS | MBIM_MS_LTE_ATTACH_STATUS |
Structures de données
Requête
InformationBuffer doit avoir la valeur NULL et InformationBufferLength doit être égal à zéro.
Set
Les opérations d’ensemble ne sont pas prises en charge.
response
La structure MBIM_MS_LTE_ATTACH_STATUS suivante doit être utilisée dans InformationBuffer.
| Offset | Taille | Champ | Type | Description |
|---|---|---|---|---|
| 0 | 4 | LteAttachState | MBIM_MS_LTE_ATTACH_STATE | Indique si l’appareil est actuellement attaché à un réseau LTE ou non. Pour plus d’informations, consultez le tableau MBIM_MS_LTE_ATTACH_STATE. |
| 4 | 4 | IPType | MBIM_CONTEXT_IP_TYPES | Pour plus d’informations, consultez la table MBIM_CONTEXT_IP_TYPE. |
| 8 | 4 | AccessStringOffset | OFFSET | Décalage dans la mémoire tampon de données vers une chaîne, AccessString, pour accéder au réseau. Pour les réseaux gsm, il s’agit d’une chaîne APN (Access Point Name) telle que « data.thephone-company.com ». Pour les réseaux basés sur CDMA, il peut s’agir d’un code de numérotation spécial tel que « #777 » ou d’un identificateur d’accès réseau (NAI) tel que «foo@thephone-company.com ». Ce membre peut avoir la valeur NULL pour demander au réseau d’affecter l’APN par défaut. Remarque : Tous les réseaux ne prennent pas en charge cette convention APN NULL. Par conséquent, une défaillance de connexion provoquée par un APN non valide est un résultat possible. La taille de la chaîne ne doit pas dépasser 100 caractères. |
| 12 | 4 | AccessStringSize | SIZE(0..200) | Taille en octets utilisée pour AccessString. |
| 16 | 4 | UserNameOffset | OFFSET | Décalage en octets, calculé à partir du début de cette structure, vers une chaîne, UserName, qui représente le nom d’utilisateur à authentifier. Ce membre peut être NULL. |
| 20 | 4 | UserNameSize | SIZE(0..510) | Taille en octets utilisée pour UserName. |
| 24 | 4 | PasswordOffset | OFFSET | Décalage en octets, calculé à partir du début de cette structure, vers une chaîne, Password, qui représente le mot de passe du nom d’utilisateur. Ce membre peut être NULL. |
| 28 | 4 | PasswordSize | SIZE(0..510) | Taille en octets utilisée pour le mot de passe. |
| 32 | 4 | Compression | MBIM_COMPRESSION | Spécifie la compression à utiliser dans la connexion de données pour l’en-tête et les données. Ce membre s’applique uniquement aux appareils GSM. L’hôte définit ce membre sur MBIMCompressionNone pour les appareils CDMA. Pour plus d’informations, consultez la table MBIM_COMPRESSION. |
| 36 | 4 | AuthProtocol | MBIM_AUTH_PROTOCOL | Type d’authentification à utiliser pour l’activation PDP. Pour plus d’informations, consultez le tableau MBIM_AUTH_PROTOCOL. |
| 40 | 4 | DataBuffer | DATABUFFER |
La structure de données suivante est utilisée dans le tableau précédent.
MBIM_MS_LTE_ATTACH_STATE indique si l’appareil est actuellement attaché à un réseau LTE ou non.
| Type | Valeur | Description |
|---|---|---|
| MbimMsLteAttachStateDetached | 0 | Indique que l’appareil n’est pas attaché au réseau LTE. |
| MbimMsLteAttachStateAttached | 1 | Indique que l’appareil est attaché au réseau LTE. |
Notification
Pour plus d’informations, consultez le tableau MBIM_MS_LTE_ATTACH_STATUS.
Codes d’état
Pour les opérations de requête et de définition :
| Code d’état | Description |
|---|---|
| MBIM_STATUS_READ_FAILURE | L’opération a échoué, car l’appareil n’a pas pu récupérer les contextes provisionnés. |
| MBIM_STATUS_NO_DEVICE_SUPPORT | L’opération a échoué, car l’appareil ne prend pas en charge l’opération. |
Tests HLK (Hardware Lab Kit)
Consultez Étapes d’installation de HLK.
Dans HLK Studio, connectez-vous au pilote de modem cellulaire de l’appareil et exécutez le test : Win6_4.MB. GSM. Data.TestLteAttach.
Vous pouvez également exécuter la liste de test TestLteAttach HLK par netsh-mbn et netsh-mbn-test-installation.
netsh mbn test feature=lte testpath="C:\\data\\test\\bin" taefpath="C:\\data\\test\\bin"
Ce fichier montre que les résultats des tests HLK doivent avoir été générés dans le répertoire à partir duquel la commande « netsh mbn test » a été exécutée : TestLteAttach.htm.
Tests manuels
- Condition requise : une sim avec le paramètre APN correct et une autre information APN pour une utilisation manuelle.
- Ouvrez Paramètres-Réseau> & Internet -> Cellulaire
- Cliquez sur Options avancées
Utilisation des paramètres cellulaires :
- Il doit y avoir au moins un apn qui est le paramètre des informations sim. Vous pouvez obtenir les informations détaillées de l’APN en cliquant sur l’APN et en cliquant sur le bouton « afficher ».
Utilisation des paramètres manuels :
- Suivez la section « Ajouter un APN » dans Paramètres cellulaires pour définir l’APN manuellement.
- Attachez l’APN et case activée le status attaché.
Guide de résolution des problèmes d’attachement MB LTE
- Obtenir tous les profils APN d’attachement sous %ProgramData%\Microsoft\WwanSvc\DMProfiles
- Comprendre quel profil particulier sera appliqué en fonction des priorités de type de création
- Examiner les journaux pour case activée pourquoi l’APN d’attachement LTE a été configuré de manière incorrecte
- Collecter et décoder les journaux à l’aide des instructions fournies dans Collecte des journaux
- Ouvrez le fichier .txt généré dans TextAnalysisTool
- Charger le filtre LTE Attach
Exemple de journal d’attachement LTE
10409 [0]0370.0434::2020-03-06 01:16:13.118424000 [WwanDimCommon] ReadyState : WwanReadyStateInitialized (0x1)
14137 [0]0370.0684::2020-03-06 01:16:13.146883200 [WwanProfileManager]INFO: SaveModemConfiguredLteAttachConfig: added modem configured LTE attach profile
14362 [0]0370.0684::2020-03-06 01:16:13.149255900 [WwanProfileManager]INFO: SaveModemConfiguredLteAttachConfig: added modem configured LTE attach profile
14476 [1]0370.0434::2020-03-06 01:16:13.149677900 [WwanDimCommon] ReadyState : WwanReadyStateInitialized (0x1)
14503 [0]0370.0684::2020-03-06 01:16:13.151412000 [WwanProfileManager]INFO: SaveModemConfiguredLteAttachConfig: added modem configured LTE attach profile
14962 [0]0370.0684::2020-03-06 01:16:13.156860700 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanDataExecutor::OnLteAttachProfileUpdate: WwanPmGetLteAttachProfileInEffect() didn't find anything, using Network Assigned.
14963 [0]0370.0684::2020-03-06 01:16:13.156862600 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanDataExecutor::OnLteAttachProfileUpdate: LTEAttachConfig has same config as modem has, skip