Operações de anexação do MB LTE
LTE Anexar configuração de APN para modems MBIM
Tradicionalmente, a anexação LTE tem sido considerada parte do registro e o Windows não esteve diretamente envolvido em procedimentos de anexação LTE. No entanto, ao contrário dos registros de rede típicos do comutador de circuito, o LTE é uma rede somente comutador de pacotes e requer que um portador EPS padrão seja habilitado para que o dispositivo mantenha o registro na rede LTE.
Para estabelecer um portador EPS padrão com a rede, o dispositivo deve solicitar uma ativação de contexto PDP durante o procedimento de anexação LTE, que requer a especificação de NOME do Ponto de Acesso (APN). De acordo com o padrão 3GPP, há quatro cenários em que um dispositivo pode especificar APN ao tentar anexar LTE:
- O dispositivo especifica um APN de anexação LTE específico.
- O dispositivo especifica um APN de anexação LTE específico, mas a rede decide permitir que o dispositivo seja anexado em outro APN durante o roaming.
- O dispositivo não especifica um APN de anexação LTE e permite que a rede atribua um de volta ao dispositivo.
- O dispositivo registrado de uma rede 2G/3G para LTE e já havia, no mínimo, um contexto PDP ativo. A rede a usa como APN de anexação LTE.
Hoje, todas as informações de APN de anexação LTE são fornecidas por IHVs e OEMs diretamente no modem para cada provedor para o qual ela tem configuração. No entanto, não é um modelo totalmente escalonável para IHVs e OEMs ter todas as configurações de APN de anexação LTE possíveis para todos os operadores em todo o mundo. A partir de Windows 10, versão 1703, novas interfaces são definidas para OIDs NDIS e CIDs proprietários da Microsoft do MBIM para dar suporte à configuração de APN de anexação LTE do sistema operacional.
A partir do Windows 10, versão 1703, se o hardware subjacente der suporte à configuração de APN de anexação LTE do sistema operacional, o usuário poderá configurar o APN de anexação LTE a partir de Configurações. O hardware que tem configurações de APN de anexação LTE padrão também deve disponibilizar sua configuração pelo sistema operacional.
Esse recurso é compatível com a adição de dois novos OIDs e CIDs. Para parceiros IHV que implementam o MBIM, somente a versão cid precisa ter suporte.
Atualização da interface MB para operações de anexação LTE
Dois novos CIDs do MBIM foram criados para permitir a configuração de APN de anexação LTE e para que o sistema operacional recupere o status de anexação LTE mais recente do dispositivo. Se os parceiros IHV decidirem dar suporte ao gerenciamento APN de anexação LTE padrão do sistema operacional, ambos os comandos deverão ter suporte.
Nome do Serviço = Extensões básicas de conexão
UUID = UUID_BASIC_CONNECT_EXTENSIONS
Valor UUID = 3d01dcc5-fef5-4d05-0d3abef7058e9aaf
| CID | Código de comando | Versão mínima do sistema operacional |
|---|---|---|
| MBIM_CID_MS_LTE_ATTACH_CONFIG | 3 | Windows 10, versão 1703 |
| MBIM_CID_MS_LTE_ATTACH_STATUS | 4 | Windows 10, versão 1703 |
MBIM_CID_MS_LTE_ATTACH_CONFIG
Descrição
Os contextos de anexação LTE podem ser diferentes, dependendo de como a rede interage com o dispositivo durante o runtime. Para o restante desta documentação, o contexto de anexação do LTE será chamado de contexto PDP atual que está sendo usado para anexação LTE e o contexto de anexação LTE padrão será conhecido como o que está configurado no dispositivo executando a anexação LTE com quando não houver outro contexto PDP habilitado existente. MBIM_CID_MS_LTE_ATTACH_CONFIG permite que o sistema operacional consulte e defina o contexto de anexação LTE padrão do provedor do SIM inserido (par MCC/MNC).
Embora o APN de anexação LTE possa ser tecnicamente considerado como um contexto, ele difere de todos os outros contextos armazenados no modem. Para todos os outros contextos, a ativação ocorre após o registro e, com base em várias condições, o sistema operacional pode decidir qual contexto é o melhor ajuste para conexão. No entanto, o contexto de anexação LTE está habilitado como parte do registro de dispositivo na rede LTE. O sistema operacional não pode recuperar nenhuma status relacionada à rede antes da conclusão do registro; devido a essa limitação, o sistema operacional deve ser capaz de configurar o contexto de anexação LTE para todas as diferentes condições de roaming do dispositivo para garantir que o dispositivo possa se registrar na rede LTE, independentemente do que é o roaming status.
A ativação de contexto de anexação LTE com a rede não requer uma solicitação de conexão explícita do sistema operacional, pois o sistema operacional não está ciente de nenhuma ativação de contexto auto-iniciada pelo modem. O contexto de anexação LTE padrão se enquadra nessa categoria. Quando o sistema operacional emite uma solicitação MBIM_CID_CONNECT para habilitar um contexto PDP e o contexto PDP fornecido corresponde a todos os seguintes, o modem deve concluir a solicitação de ativação cid com êxito sem trazer um novo portador over-the-air com a rede:
- Há um contexto PDP habilitado existente iniciado pelo modem e não disponibilizado para o sistema operacional.
- O contexto PDP corresponde ao APN especificado na solicitação CID.
- O tipo IP do contexto PDP habilitado é compatível com o tipo de IP solicitado no CID.
Isso é importante, pois o sistema operacional não está ciente de todos os contextos PDP que foram iniciados pelo modem. Isso reduzirá o ruído e a carga da rede. Caso contrário, o modem deverá trazer uma nova especificação de APN do sistema operacional correspondente ao portador over-the-air de acordo com uma solicitação de ativação de contexto normal. A compatibilidade do tipo IP é especificada aqui:
| Tipo de IP do contexto PDP habilitado dentro do modem | Compatível com tipos de IP solicitados | Incompatível com o tipo de IP solicitado |
|---|---|---|
| IPv4 | Padrão; IPv4; IPv4v6; IPv4 e v6 | IPv6 |
| IPv6 | Padrão; IPv6; IPv4v6; IPv4 e v6 | IPv4 |
| IPv4v6 | Padrão; IPv4; IPv6; IPv4v6; IPv4 e v6 | Nenhum |
Observação
O modem não deverá exibir um segundo contexto PDP se apenas um dos tipos de IP estiver habilitado no ar. Por exemplo, se o IPv4 estiver habilitado e o host solicitar IPv4 e IPv6, o modem deverá concluir a solicitação de ativação sem criar um portador IPv6.
Quando o sistema operacional emite uma solicitação MBIM_CID_CONNECT para desativar um contexto PDP, o modem deve marcar o seguinte:
- Se o dispositivo está anexado ao LTE e o contexto a ser desativado é o único contexto PDP habilitado para manter o registro LTE
- Se o contexto a ser desativado também é usado pelo modem internamente para quaisquer serviços que não estão expostos ao sistema operacional
Se uma delas for verdadeira, o modem deverá concluir a solicitação de desativação do CID, mas continuar a manter o portador over-the-air com a rede. Caso contrário, o modem deverá desativar o contexto de acordo com as solicitações de desativação normais.
Toda a configuração de APN de anexação LTE padrão fornecida pelo sistema operacional é por provedor e corresponde à ID inicial do provedor do SIM cartão inserido (par MCC/MNC). O modem só deve fornecer o contexto de anexação LTE configurado para a ID do Provedor do SIM inserida atualmente quando consultada. O modem sempre deve retornar três contextos de anexação LTE padrão que correspondem à ID do Provedor do SIM inserida, um para cada condição de roaming (home/partner/non-partner).
Espera-se que, entre as trocas sim, o modem desmarque seu contexto de anexação LTE padrão antes de aplicar a configuração para o próximo sim cartão. Se o SIM recém-inserido cartão não tiver nenhuma configuração de contexto de anexação LTE padrão, o dispositivo deverá retornar cadeias de caracteres vazias NULL para o APN do contexto de anexação LTE para todas as condições de roaming, mantendo o contexto habilitado. Se o contexto estiver desabilitado, espera-se que o dispositivo não seja anexado ao LTE porque não há configuração utilizável para anexação LTE. Quando o usuário alterna de volta para um sim cartão que foi configurado anteriormente no dispositivo, o modem deve restaurar sua configuração de anexação LTE padrão de fábrica para a cartão sim. Não se espera que a configuração de tempo de execução persista entre as trocas de SIM. A qualquer momento, deve haver apenas um APN de anexação LTE padrão no modem por condição de roaming (home/partner/non-partner).
O sistema operacional sempre definirá todos os três contextos de anexação LTE padrão quando um comando Set for emitido, um para cada condição de roaming. Se a lista fornecida pelo sistema operacional não tiver exatamente três, o comando Set deverá ser rejeitado. Se um dos contextos de anexação LTE padrão fornecidos for configurado pelo sistema operacional em que a condição de roaming corresponde ao registro atual status, o modem deverá desanexar da rede e executar novamente a anexação LTE com o contexto de anexação LTE especificado recentemente. Caso contrário, espera-se que o dispositivo use o contexto de anexação LTE padrão especificado na próxima vez em que as condições de roaming corresponderem. Se o contexto de anexação LTE padrão especificado pelo dispositivo não for registrado na rede LTE, o dispositivo deverá voltar para 3G/2G conforme apropriado. Quando o modem não pode diferenciar entre redes de parceiros e não parceiros, o modem deve usar o contexto de anexação LTE padrão não parceiro para todos os cenários de roaming. Se o sistema operacional configurar o contexto de anexação LTE padrão como tipo IP = padrão, espera-se que o modem atribua o tipo de IP mais apropriado para o contexto de anexação LTE. No entanto, o sistema operacional espera que o modem ainda retorne condições de roaming de parceiro e o tipo ip do contexto de anexação LTE que reflete a configuração com precisão.
IHVs e OEMs podem pré-configurar o contexto de anexação LTE como a configuração padrão no modem, mas esses contextos devem ser marcados como MBIM_MS_CONTEXT_SOURCE = MbimMsContextSourceModemProvisioned.
De acordo com o padrão 3GPP, o contexto de anexação LTE padrão pode ser dividido em duas categorias: iniciada pela UE e iniciada pela rede. Se o dispositivo estiver configurado com uma cadeia de caracteres de acesso NULL vazia, espera-se que o dispositivo não forneça nenhum contexto de anexação LTE à rede e aguarde até que a rede atribua uma de volta ao dispositivo. Assim como prescrito pelo MBIM 1.0, se o tipo IP do contexto de anexação LTE estiver configurado como padrão, o modem deverá selecionar o melhor tipo de IP com base em seu algoritmo interno.
O diagrama a seguir ilustra um fluxo de exemplo de configuração de anexação LTE.
Consulta
MBIM_MS_LTE_ATTACH_CONFIG_INFO é retornado da Consulta concluída e Definir mensagens no InformationBuffer. Para Consulta, o InformationBuffer é NULL.
Set
Para Set, o InformationBuffer contém um MBIM_MS_SET_LTE_ATTACH_CONFIG.
Eventos não solicitados
O InformationBuffer do Evento contém uma estrutura MBIM_MS_LTE_ATTACH_CONFIG_INFO. Em alguns casos, o contexto de anexação LTE padrão é atualizado pela rede OTA (Over-The-Air) ou por SMS (Serviço de Mensagem Curta) que não passa pelo comando MBIM_CID_MS_LTE_ATTACH_CONFIG do sistema operacional. A função deve atualizar contextos de anexação LTE padrão e marcar MBIM_MS_CONTEXT_SOURCE = MbimMsContextSourceOperatorProvisionado adequadamente. Depois disso, as funções devem notificar o Host sobre as atualizações que usam esse evento com a lista atualizada.
Parâmetros
| Operação | Set | Consulta | Notification |
|---|---|---|---|
| Comando | MBIM_SET_MS_LTE_ATTACH_CONFIG | Não aplicável | Não aplicável |
| Resposta | MBIM_MS_LTE_ATTACH_CONFIG_INFO | MBIM_MS_LTE_ATTACH_CONFIG_INFO | MBIM_MS_LTE_ATTACH_CONFIG_INFO |
estruturas de dados
Consulta
O InformationBuffer será NULL e InformationBufferLength será zero.
Set
A estrutura de MBIM_MS_SET_LTE_ATTACH_CONFIG a seguir deve ser usada no InformationBuffer. O comando Set só será válido se a lista contiver uma contagem de elementos de três, uma para cada condição de roaming (home/partner/non-partner).
| Deslocamento | Tamanho | Campo | Tipo | Descrição |
|---|---|---|---|---|
| 0 | 4 | Operação | MBIM_MS_LTE_CONTEXT_OPERATIONS | Especifica o tipo de operação para o qual o comando Set é usado. Se definido como MbimMsLteAttachContextOperationRestoreFactory, todos os outros campos deverão ser ignorados. Os contextos de anexação LTE padrão criados pelo sistema operacional ou modificados devem ser removidos e os contextos de anexação LTE padrão pré-configurados de fábrica padrão devem ser carregados. Se o modem não tiver uma configuração padrão, todos os contextos de anexação LTE padrão da condição de roaming deverão ser definidos como uma cadeia de caracteres APN vazia e um tipo de IP = padrão. |
| 4 | 4 | ElementCount (EC) | UINT32 | Contagem de estruturas MBIM_MS_LTE_ATTACH_CONTEXT que seguem no DataBuffer. Atualmente, esse componente é especificado como três, um para cada condição de roaming (home/partner/non-partner). |
| 8 | 8 * EC | MsLteAttachContextRefList | OL_PAIR_LIST | O primeiro elemento do par é um deslocamento de 4 bytes, calculado desde o início (deslocamento 0) dessa estrutura MBIM_MS_LTE_ATTACH_CONFIG_INFO até uma estrutura MBIM_MS_LTE_ATTACH_CONTEXT (para obter mais informações, consulte a tabela MBIM_MS_LTE_ATTACH_CONTEXT). O segundo elemento do par é um tamanho de 4 bytes de um ponteiro para a estrutura de MBIM_MS_LTE_ATTACH_CONTEXT correspondente. |
| 8 + (8 * EC) | DataBuffer | DATABUFFER | Matriz de estruturas MBIM_MS_LTE_ATTACH_CONTEXT. |
As estruturas a seguir são usadas na tabela anterior.
MBIM_MS_LTE_ATTACH_CONTEXT_OPERATIONS descreve os tipos de operações que podem ser usados no comando Set.
| Tipo | Valor | Descrição |
|---|---|---|
| MbimMsLteAttachContextOperationDefault | 0 | Operação padrão para substituir contextos de anexação LTE padrão existentes no modem. O sistema operacional sempre substituirá todos os três contextos de anexação LTE padrão para condições de roaming. |
| MbimMsLteAttachContextOperationRestoreFactory | 1 | Restaurar o contexto de anexação LTE padrão pré-configurado de fábrica para a ID do Provedor do SIM inserido no momento. Todos os contextos de anexação LTE padrão substituídos ou criados pelo sistema operacional devem ser removidos e substituídos. Se não houver nenhum contexto de anexação LTE padrão pré-configurado padrão para a ID do Provedor sim inserida atual com uma ou mais condições de roaming, a anexação LTE padrão deverá retornar uma cadeia de caracteres APN vazia e um tipo de IP = padrão. |
MBIM_MS_LTE_ATTACH_CONTEXT especifica o contexto a ser usado para a configuração de anexação LTE.
| Deslocamento | Tamanho | Campo | Tipo | Descrição |
|---|---|---|---|---|
| 0 | 4 | IPType | MBIM_CONTEXT_IP_TYPE | Para obter mais informações, consulte a tabela MBIM_CONTEXT_IP_TYPE. |
| 4 | 4 | Roaming | MBIM_MS_LTE_ATTACH_CONTEXT_ROAMING_CONTROL | Indica qual condição de roaming se aplica a esse contexto de anexação LTE padrão. Para obter mais informações, consulte a tabela MBIM_MS_LTE_ATTACH_CONTEXT_ROAMING_CONTROL. |
| 8 | 4 | Source | MBIM_MS_CONTEXT_SOURCE | Especifica a origem de criação do contexto. Para obter mais informações, consulte a tabela MBIM_MS_CONTEXT_SOURCE. |
| 12 | 4 | AccessStringOffset | OFFSET | Deslocamento no buffer de dados para uma cadeia de caracteres, AccessString, para acessar a rede. Para redes baseadas em GSM, essa seria uma cadeia de caracteres APN (Nome do Ponto de Acesso), como "data.thephone-company.com". O tamanho da cadeia de caracteres não deve exceder 100 caracteres. Se AccessString estiver vazio, o dispositivo espera que a rede atribua uma cadeia de caracteres de acesso de volta ao dispositivo. O tipo de IP ainda precisa ser especificado nesse caso. |
| 16 | 4 | AccessStringSize | SIZE(0..200) | Tamanho usado para AccessString. Esse valor deverá ser 0 se o dispositivo espera que a rede atribua uma cadeia de caracteres de acesso de volta ao dispositivo para anexação LTE. |
| 20 | 4 | UserNameOffset | OFFSET | Deslocamento em bytes, calculado desde o início dessa estrutura, para uma cadeia de caracteres, UserName, que representa o nome de usuário a ser autenticado. Esse membro pode ser NULL. |
| 24 | 4 | UserNameSize | SIZE(0..510) | Tamanho usado para UserName. |
| 28 | 4 | PasswordOffset | OFFSET | Deslocamento em bytes, calculado desde o início dessa estrutura, para uma cadeia de caracteres, Senha, que representa a senha do nome de usuário. Esse membro pode ser NULL. |
| 32 | 4 | PasswordSize | SIZE(0..510) | Tamanho usado para Senha. |
| 36 | 4 | Compactação | MBIM_COMPRESSION | Especifica a compactação a ser usada na conexão de dados para cabeçalho e dados. Esse membro se aplica somente a dispositivos baseados em GSM. O Host define esse membro como MBIMCompressionNone para dispositivos baseados em CDMA. Para obter mais informações, consulte a tabela MBIM_COMPRESSION. |
| 40 | 4 | AuthProtocol | MBIM_AUTH_PROTOCOL | Tipo de autenticação a ser usado para a ativação do PDP. Para obter mais informações, consulte a tabela MBIM_AUTH_PROTOCOL. |
| 44 | DataBuffer | DATABUFFER | O buffer de dados que contém AccessString, UserName e Password. |
MBIM_MS_LTE_ATTACH_CONTEXT_ROAMING_CONTROL indica qual condição de roaming se aplica a esse contexto de anexação LTE padrão.
| Tipo | Valor | Descrição |
|---|---|---|
| MbimMsLteAttachContextRoamingControlHome | 0 | Indica se o contexto de anexação LTE padrão tem permissão para ser usado na rede inicial ou não. |
| MbimMsLteAttachContextRoamingControlPartner | 1 | Indica se o contexto tem permissão para ser usado em redes móveis de parceiros ou não. |
| MbimMsLteAttachContextRoamingControlNonPartner | 2 | Indica se o contexto tem permissão para ser usado em redes móveis não parceiras ou não. |
MBIM_MS_CONTEXT_SOURCE especifica a fonte de criação do contexto.
| Tipo | Valor | Descrição |
|---|---|---|
| MbimMsContextSourceAdmin | 0 | O contexto foi criado por um administrador de TI enterprise do sistema operacional. |
| MbimMsContextSourceUser | 1 | O contexto foi criado pelo usuário por meio das configurações do sistema operacional. |
| MbimMsContextSourceOperator | 2 | O contexto foi criado pelo operador por meio do OMA-DM ou de outros canais. |
| MbimMsContextSourceModem | 3 | O contexto foi criado pelo IHV ou OEM. |
| MbimMsContextSourceDevice | 4 | O contexto foi criado pelo banco de dados APN do sistema operacional. |
Resposta
A estrutura de MBIM_MS_LTE_ATTACH_CONFIG_INFO a seguir deve ser usada no InformationBuffer.
| Deslocamento | Tamanho | Campo | Tipo | Descrição |
|---|---|---|---|---|
| 0 | 4 | ElementCount (EC) | UINT32 | Contagem de estruturas MBIM_MS_LTE_ATTACH_CONTEXT que seguem no DataBuffer. Atualmente, esse componente é especificado como três, um para cada condição de roaming (home/partner/non-partner). |
| 4 | 8 * EC | MsLteAttachContextRefList | OL_PAIR_LIST | O primeiro elemento do par é um deslocamento de 4 bytes, calculado desde o início (deslocamento 0) dessa estrutura MBIM_MS_LTE_ATTACH_CONFIG_INFO até uma estrutura de MBIM_MS_LTE_ATTACH_CONTEXT (para obter mais informações, consulte a tabela MBIM_MS_LTE_ATTACH_CONTEXT). O segundo elemento do par é um tamanho de 4 bytes de um ponteiro para a estrutura de MBIM_MS_LTE_ATTACH_CONTEXT correspondente. |
| 4 + (8 * EC) | DataBuffer | DATABUFFER | Matriz de estruturas MBIM_MS_LTE_ATTACH_CONTEXT. |
Notification
Para obter mais informações, consulte a tabela MBIM_MS_LTE_ATTACH_CONFIG_INFO.
Códigos de status
Para operações de consulta e definição:
| Código de status | Descrição |
|---|---|
| MBIM_STATUS_READ_FAILURE | A operação falhou porque o dispositivo não pôde recuperar contextos provisionados. |
| MBIM_STATUS_NO_DEVICE_SUPPORT | A operação falhou porque o dispositivo não dá suporte à operação. |
Somente para Definir operações:
| Código de status | Descrição |
|---|---|
| MBIM_STATUS_INVALID_PARAMETERS | A operação falhou devido a parâmetros inválidos. |
| MBIM_STATUS_WRITE_FAILURE | A operação falhou porque a solicitação de atualização não foi bem-sucedida. |
MBIM_CID_MS_LTE_ATTACH_STATUS
Descrição
De acordo com o requisito de 3GPP, embora um dispositivo possa especificar o contexto de anexação LTE padrão a ser usado ao anexar LTE à rede sem qualquer contexto PDP habilitado, pode haver situações em que o dispositivo será anexado ao LTE em um contexto PDP que difere do contexto de anexação LTE padrão configurado no dispositivo. Veja a seguir uma lista de todos os cenários possíveis:
- A UE especifica um APN de anexação LTE específico.
- A UE especifica um APN de anexação LTE específico, mas a rede decide permitir que o dispositivo seja anexado em outro APN durante o roaming.
- A UE não especifica um APN de anexação LTE e permite que a rede atribua um de volta ao dispositivo.
- A UE registrou de rede 2G/3G para LTE e já havia, no mínimo, um contexto de PDP ativo. A rede a usa como o APN de anexação LTE.
Quando o LTE padrão do dispositivo é anexado, ele deve enviar uma notificação de MBIM_CID_MS_LTE_ATTACH_STATUS ao sistema operacional para fornecer detalhes do contexto PDP no anexo LTE mais recente. A anexação LTE padrão ocorre quando um dos seguintes cenários é atendido:
- O dispositivo é inicialmente anexado à rede LTE.
- O dispositivo entrega de 2G/3G para LTE sem nenhum contexto PDP habilitado anteriormente.
O contexto de anexação LTE retornado de MBIM_CID_LTE_ATTACH_STATUS pode ser um dos seguintes:
- Contexto de anexação LTE padrão armazenado no modem.
- Contexto de anexação LTE padrão que foi atribuído de volta da rede.
Durante o runtime, o sistema operacional também deve ser capaz de consultar quais foram as últimas informações de anexação usadas para anexação LTE padrão. Espera-se que o modem retorne o último contexto de anexação LTE padrão conhecido. Se o dispositivo tiver sido entregue da rede LTE para 2G/3G, espera-se que o modem retorne o contexto usado para a anexação LTE anterior. Sempre que o dispositivo desregistra da rede, espera-se que o APN fique vazio.
O diagrama abaixo ilustra um exemplo de fluxo de mensagens para status de anexação LTE.
Consulta
MBIM_MS_LTE_ATTACH_STATUS é retornado de Consultar mensagens completas no InformationBuffer. Para Consulta, o InformationBuffer é NULL.
Set
Não há suporte para operações de definição.
Eventos não solicitados
O InformationBuffer do Evento contém uma estrutura MBIM_MS_LTE_ATTACH_STATUS.
Parâmetros
| Operação | Set | Consulta | Notification |
|---|---|---|---|
| Comando | Não aplicável | Não aplicável | Não aplicável |
| Resposta | Não aplicável | MBIM_MS_LTE_ATTACH_STATUS | MBIM_MS_LTE_ATTACH_STATUS |
estruturas de dados
Consulta
O InformationBuffer será NULL e InformationBufferLength será zero.
Set
Não há suporte para operações de definição.
Resposta
A estrutura de MBIM_MS_LTE_ATTACH_STATUS a seguir deve ser usada no InformationBuffer.
| Deslocamento | Tamanho | Campo | Tipo | Descrição |
|---|---|---|---|---|
| 0 | 4 | LteAttachState | MBIM_MS_LTE_ATTACH_STATE | Indica se o dispositivo está conectado a uma rede LTE ou não. Para obter mais informações, consulte a tabela MBIM_MS_LTE_ATTACH_STATE. |
| 4 | 4 | IPType | MBIM_CONTEXT_IP_TYPES | Para obter mais informações, consulte a tabela MBIM_CONTEXT_IP_TYPE. |
| 8 | 4 | AccessStringOffset | OFFSET | Deslocamento no buffer de dados para uma cadeia de caracteres, AccessString, para acessar a rede. Para redes baseadas em GSM, essa seria uma cadeia de caracteres APN (Nome do Ponto de Acesso), como "data.thephone-company.com". Para redes baseadas em CDMA, esse pode ser um código de discagem especial, como "#777" ou um NAI (Identificador de Acesso à Rede), como "foo@thephone-company.com". Esse membro pode ser NULL para solicitar que a rede atribua o APN padrão. Observação: nem todas as redes dão suporte a essa convenção DE APN NULL. Portanto, uma falha de conexão causada por um APN inválido é um resultado possível. O tamanho da cadeia de caracteres não deve exceder 100 caracteres. |
| 12 | 4 | AccessStringSize | SIZE(0..200) | Tamanho em bytes usados para AccessString. |
| 16 | 4 | UserNameOffset | OFFSET | Deslocamento em bytes, calculado desde o início dessa estrutura, para uma cadeia de caracteres, UserName, que representa o nome de usuário a ser autenticado. Esse membro pode ser NULL. |
| 20 | 4 | UserNameSize | SIZE(0..510) | Tamanho em bytes usados para UserName. |
| 24 | 4 | PasswordOffset | OFFSET | Deslocamento em bytes, calculado desde o início dessa estrutura, para uma cadeia de caracteres, Senha, que representa a senha do nome de usuário. Esse membro pode ser NULL. |
| 28 | 4 | PasswordSize | SIZE(0..510) | Tamanho em bytes usados para Senha. |
| 32 | 4 | Compactação | MBIM_COMPRESSION | Especifica a compactação a ser usada na conexão de dados para cabeçalho e dados. Esse membro se aplica somente a dispositivos baseados em GSM. O Host define esse membro como MBIMCompressionNone para dispositivos baseados em CDMA. Para obter mais informações, consulte a tabela MBIM_COMPRESSION. |
| 36 | 4 | AuthProtocol | MBIM_AUTH_PROTOCOL | Tipo de autenticação a ser usado para a ativação PDP. Para obter mais informações, consulte a tabela MBIM_AUTH_PROTOCOL. |
| 40 | 4 | DataBuffer | DATABUFFER |
A estrutura de dados a seguir é usada na tabela anterior.
MBIM_MS_LTE_ATTACH_STATE indica se o dispositivo está conectado a uma rede LTE ou não.
| Tipo | Valor | Descrição |
|---|---|---|
| MbimMsLteAttachStateDetached | 0 | Indica que o dispositivo não está anexado à rede LTE. |
| MbimMsLteAttachStateAttached | 1 | Indica que o dispositivo está anexado à rede LTE. |
Notification
Para obter mais informações, consulte a tabela MBIM_MS_LTE_ATTACH_STATUS.
Códigos de status
Para operações de consulta e definição:
| Código de status | Descrição |
|---|---|
| MBIM_STATUS_READ_FAILURE | A operação falhou porque o dispositivo não pôde recuperar contextos provisionados. |
| MBIM_STATUS_NO_DEVICE_SUPPORT | A operação falhou porque o dispositivo não dá suporte à operação. |
Testes do HLK (Hardware Lab Kit)
Consulte Etapas para instalar o HLK.
No HLK Studio, conecte-se ao driver de modem celular do dispositivo e execute o teste: Win6_4.MB. GSM. Data.TestLteAttach.
Como alternativa, execute a lista de testes do TestLteAttach HLK por netsh-mbn e netsh-mbn-test-installation.
netsh mbn test feature=lte testpath="C:\\data\\test\\bin" taefpath="C:\\data\\test\\bin"
Esse arquivo mostrando que os resultados do teste HLK deveriam ter sido gerados no diretório do qual o comando 'netsh mbn test' foi executado em: TestLteAttach.htm.
Teste manuais
- Requisito: um sim com a configuração de APN correta e mais uma informação de APN para uso manual.
- Abrir Configurações-Rede> & Internet -> Celular
- Clique em Opções avançadas
Usando configurações da rede celular:
- Deve haver pelo menos um apn que é a configuração das informações sim. Você pode obter as informações detalhadas do APN clicando no APN e clicando no botão "exibir".
Usando configurações manuais:
- Siga a seção "Adicionar um APN" em Configurações da rede celular para definir o APN manualmente.
- Anexe o APN e marcar o status anexado.
Guia de solução de problemas de anexação do MB LTE
- Obter todos os perfis anexar APN em %ProgramData%\Microsoft\WwanSvc\DMProfiles
- Entender qual perfil específico será aplicado com base nas prioridades de tipo de criação
- Investigue os logs para marcar por que o APN de anexação LTE foi configurado incorretamente
- Coletar e decodificar os logs usando as instruções em Coletando logs
- Abra o arquivo .txt gerado no TextAnalysisTool
- Carregar o filtro anexar LTE
Log de exemplo da anexação 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