Operações de contexto provisionadas de MB

O provisionamento é vital para dispositivos conectáveis por celular porque cada operadora móvel tem configurações de APN diferentes para sua rede. As configurações de APN geralmente podem ser divididas em duas categorias:

1. Configurações de APN conhecidas pelo sistema operacional porque há aplicativos ou clientes acima do sistema operacional que exigem essas conexões.
2. Configurações de APN que não são conhecidas pelo sistema operacional porque são consumidas internamente pelo modem para conexões que não são aproveitadas pelo sistema operacional e seus clientes.

O ideal é que o modem armazene apenas as configurações de APN que o sistema operacional não precisa saber. No entanto, os parceiros IHV e OEM tradicionalmente fornecem as APNs de Internet e Compra, que são configurações conhecidas pelo sistema operacional e também estão presentes no modem. Antes do Windows 10, versão 1703, o Windows só leu as configurações de APN de Compra e Internet do modem para estabelecer conexões com a Internet. A partir do Windows 10, versão 1703, pode haver casos adicionais em que a configuração de APN do modem teria que ser gerenciada pelo Windows, especialmente se houver clientes no sistema operacional, como configurações de usuário ou OMA-DM que desejam alterar a configuração do celular. Isso, por sua vez, também pode afetar a configuração de APN do modem. Por exemplo, pode haver uma pilha IMS no modem que está usando o APN IMS para SMS via IMS. Normalmente, essas conexões não são expostas ao sistema operacional, mas em determinados cenários a configuração de APN do IMS pode ter que ser alterada. Essa alteração pode ser feita por meio do sistema operacional. Para dar suporte a isso, a partir do Windows 10, versão 1703, o sistema operacional pode configurar diferentes tipos de APNs no modem.

O MBIM 1.0 do fórum USB e o Microsoft NDIS têm um CID e OID existentes, respectivamente, para permitir que o sistema operacional defina e consulte as configurações de APN no modem. Para o MBIM 1.0, ele faz isso por meio de MBIM_CID_PROVISIONED_CONTEXT enquanto, para o NDIS, ele faz isso por meio de OID_WWAN_PROVISIONED_CONTEXTS. No entanto, o CID e o OID existentes não foram projetados com orientação clara sobre como o modem deve se comportar em várias situações, como um ciclo de energia ou uma troca de SIM. Os dispositivos que desejam dar suporte à configuração do sistema operacional e à atualização de contextos provisionados por modem no futuro terão que implementar a versão mais recente do CID e do OID no Windows 10, versão 1703. Para garantir a compatibilidade com versões anteriores, para IHVs/OEMs que desejam dar suporte a novos hardwares em versões do sistema operacional anteriores a 1703, eles terão que continuar a dar suporte aos MBIM_CID_PROVISIONED_CONTEXT e OID_WWAN_PROVISIONED_CONTEXTS existentes. A partir do Windows 10, versão 1703, se o dispositivo der suporte à nova versão do CID e do OID, o sistema operacional usará apenas a versão mais recente do comando para consultar e definir a configuração de contexto APN no modem.

Atualização da interface MB para operações de contexto provisionadas

Embora o MBIM tenha um comando para recuperar e substituir contextos armazenados no modem, ele não tem um campo para "desabilitar" ou "habilitar" um perfil. Portanto, o MBIM_CID_PROVISIONED_CONTEXT existente deve ser atualizado para o Windows 10, versão 1703 para incluir essa funcionalidade. Como o MBIM não tem um mecanismo de controle de versão, um novo CID proprietário do MSFT é definido como MBIM_CID_MS_PROVISIONED_CONTEXT_V2.

Nome do Serviço = Extensões básicas de conexão

UUID = UUID_BASIC_CONNECT_EXTENSIONS

Valor UUID = 3d01dcc5-fef5-4d05-0d3abef7058e9aaf

MBIM_CID_MS_PROVISIONED_CONTEXT_V2

Descrição

Embora o MBIM 1.0 tenha definido MBIM_CID_PROVISIONED_CONTEXT para o sistema operacional e seus clientes superiores gerenciarem contextos provisionados no modem, o Windows tradicionalmente consultava apenas o contexto no modem, mas não o definia do sistema operacional. A partir do Windows 10, versão 1703, há uma necessidade crescente de que o sistema operacional possa configurar os contextos no modem. Por exemplo, se houver uma pilha IMS no modem que seja opaca para o sistema operacional, o sistema operacional deverá ser capaz de especificar a APN IMS que o modem deve usar. Como cada IHV de modem pode ter sua própria maneira proprietária de armazenar contextos no modem, é impossível para o sistema operacional gerenciar perfis no nível ContextId da maneira que MBIM_CID_PROVISIONED_CONTEXT pode sugerir. Em vez disso, da perspectiva do sistema operacional, é mais importante prescrever qual contexto usar para cada tipo de contexto. Retornando ao exemplo do IMS, independentemente de quantos contextos provisionados existentes estão no modem, se o sistema operacional definir um contexto que tenha MBIM_CONTEXT_TYPE = IMS, todo o tráfego IMS iniciado pelo modem só deverá ser tentado nesse contexto.

O MBIM 1.0 especifica que MBIM_CID_PROVISIONED_CONTEXT só pode realizar uma consulta em contextos que correspondam à ID do Provedor (par MCC/MNC) do cartão SIM inserido. Para definir solicitações, MBIM_CID_PROVISIONED_CONTEXT pode especificar a ID do Provedor do contexto que ele deseja armazenar. MBIM_CID_MS_PROVISIONED_CONTEXT_V2 especifica um comportamento semelhante, mas diferente do MBIM 1.0. Para cada consulta, o sistema operacional continua esperando que o modem retorne apenas contextos que correspondam à ID do Provedor do cartão SIM inserido. Para Set, o comando não habilitará mais o sistema operacional para definir contextos que não correspondem à ID do Provedor atual no cartão SIM. Espera-se que a solicitação Set crie um contexto para a ID do Provedor atual do cartão SIM apresentado. Por exemplo, o usuário troca de SIM 1 para SIM 2 e, em seguida, volta para SIM 1. Espera-se que, durante a primeira troca de SIM, o modem resolva todos os seus contextos antes de carregar o contexto para SIM 2. Quando o usuário alterna de volta para o SIM 1, a configuração padrão de fábrica do SIM 1 deve ser restaurada. Não é esperado que o modem salve a configuração de runtime em trocas de SIM.

O diagrama a seguir ilustra um fluxo de exemplo para quando um usuário troca de um SIM para outro e, em seguida, volta para o primeiro.

OEMs e IHVs que pré-configuraram o modem devem manter a configuração de fábrica original caso o sistema operacional ou o usuário queira restaurar as configurações de contexto no modem para as configurações originais. Somente os contextos originais de fábrica para a ID do Provedor do SIM atualmente inserido devem ser restaurados. Os contextos pré-configurados da configuração de fábrica original nunca devem ser substituídos pela configuração do sistema operacional. O diagrama a seguir é um exemplo de fluxo para quando um usuário opta por restaurar as configurações de fábrica:

Espera-se que o modem falhe em consultas ou no estabelecimento de solicitações quando o SIM estiver ausente, bloqueado ou a ID do Provedor estiver inacessível. O modem deve ter apenas um contexto por CONTEXT_TYPE por ID do fornecedor. Se o IHV ou o OEM decidir pré-configurar contextos de modem no modem, é importante que ele verifique se os contextos estão configurados corretamente para cada provedor para o qual ele opta por fazê-lo. Caso o cartão SIM inserido não tenha contextos pré-configurados de IHV, o modem não deve ter contextos sem a configuração do sistema operacional. IHVs e OEMs precisam garantir que MBIM_MS_CONTEXT_SOURCE = MbimMsContextSourceModemProvisioned para que o sistema operacional use o contexto do modem para conexão, se existir, e não o substitua pelo banco de dados APN do Windows.

Como os mapas de modem lidam com o contexto e o apresentam novamente por meio do MBIM_CID_PROVISIONED_CONTEXT existente cabe a cada IHV e está fora do escopo desta documentação.

O novo comando MBIM_CID_MS_PROVISONED_CONTEXT_V2 é quase idêntico ao comando de MBIM_CID_PROVISIONED_CONTEXT existente do MBIM 1.0, mas com várias adições. O primeiro fornece ao sistema operacional a capacidade de habilitar ou desabilitar o contexto associado a um tipo de contexto no modem. Quando o contexto é desativado no modem, espera-se que ele não utilize o contexto armazenado para qualquer conexão com a rede, mesmo aquelas que não são conhecidas pelo sistema operacional. Se o sistema operacional solicitar uma conexão que corresponda a um contexto desabilitado no modem, o modem deverá falhar na solicitação imediatamente sem sinalizar para a rede. O processo de correspondência deve corresponder a todos os campos na estrutura MBIM_MS_CONTEXT_V2.

A estrutura de MBIM_CONTEXT_IP_TYPE do MBIM 1.0 é usada apenas para MBIM_CID_CONNECT. Em MBIM_CID_MS_PROVISIONED_CONTEXT_V2, a Microsoft adicionou o tipo IP como um dos parâmetros para cada contexto. O modem deverá relatar MBIMContextIPTypeDefault se ele não estiver configurado para o contexto fornecido.

No Windows 10, versão 1703, com um novo hardware que dá suporte a MBIM_CID_MS_PROVISIONED_CONTEXT_V2, o MBIM_CID_PROVISIONED_CONTEXT herdado não será usado de componentes de primeira parte. Se houver outros componentes herdados do sistema operacional/cliente que enviam MBIM_CID_PROVISIONED_CONTEXT, espera-se que o modem retorne resultados como em versões do Windows anteriores ao Windows 10, versão 1703.

Consulta

MBIM_MS_PROVISIONED_CONTEXTS_INFO é retornado de Consulta e Definir mensagens completas no InformationBuffer.

Para Consulta, o InformationBuffer é nulo.

Conjunto

Para Set, o InformationBuffer contém uma estrutura MBIM_MS_SET_PROVISIONED_CONTEXT_V2. Na operação Set, como cada IHV de modem pode ter maneiras proprietárias de gerenciar o armazenamento de contexto, o sistema operacional não especifica mais o campo ContextId e espera que o modem mapeie os contextos para o slot apropriado. Quando o sistema operacional define contextos, ele espera que o modem o use para todas as conexões que correspondam à MBIM_CONTEXT_TYPE do contexto fornecido. Se o MBIM_CONTEXT_TYPE não for reconhecido pelo modem, ele ainda deverá armazená-lo mesmo que ele não possa se conectar a ele.

Evento não solicitado

O Event InformationBuffer contém uma estrutura MBIM_MS_PROVISIONED_CONTEXTS_INFO_V2. Em alguns casos, a lista de contextos provisionados é atualizada pela redeThe-Air (OTA) ou por SMS (Serviço de Mensagem Curta) que não passa pelo comando MBIM_CID_MS_PROVISIONED_CONTEXT_V2 do sistema operacional. A função deve atualizar a lista de contextos provisionados e marcar MBIM_MS_CONTEXT_SOURCE = MbimMsContextSourceOperatorProvisioned adequadamente. Depois disso, as funções devem notificar o host sobre atualizações usando esse evento com a lista atualizada.

Parâmetros

Estruturas de dados

Consulta

O InformationBuffer será NULL e InformationBufferLength será zero.

Conjunto

A estrutura de dados MBIM_SET_MS_PROVISIONED_CONTEXT_V2 a seguir deve ser usada no InformationBuffer.

As estruturas de dados a seguir são usadas na tabela anterior.

MBIM_MS_CONTEXT_ROAMING_CONTROL especifica a política de roaming por contexto. O sistema operacional pode especificar se o contexto fornecido pode ser habilitado durante o roaming ou não. O modem não deve ativar automaticamente o contexto sem intervenção do sistema operacional se o estado de roaming não atender às condições especificadas. Nos casos em que o modem não dá suporte a parceiros, todas as configurações de parceiro devem ser tratadas como equivalentes à casa.

MBIM_MS_CONTEXT_MEDIA_TYPE foi adicionado para especificar se o contexto é usado para celular ou iWLAN quando o offload Wi-Fi se tornar compatível em plataformas futuras. Por exemplo, se um contexto for definido como celular e o modem estiver no estado Wi-Fi de processamento, ele não deve iniciar uma conexão usando esse contexto.

MBIM_MS_CONTEXT_ENABLE especifica se um contexto está habilitado ou desabilitado.

MBIM_MS_CONTEXT_SOURCE foi adicionado para dar visibilidade ao sistema operacional sobre como o contexto do modem foi criado. Isso ajuda o sistema operacional a se comportar corretamente após várias situações, como redefinição de fábrica, para que ele possa saber o que deve persistir e o que deve ser retornado ao estado padrão com base em vários requisitos de operador.

MBIM_MS_CONTEXT_OPERATIONS especifica as operações que o sistema operacional pode executar para configurar contextos no modem.

O MBIM_CONTEXT_TYPES original do MBIM 1.0 ainda é válido. A Microsoft está adicionando tipos de contexto adicionais à medida que mais tipos de contextos foram introduzidos desde que o MBIM 1.0 foi definido. A tabela a seguir define os novos tipos que estão sendo introduzidos. IHVs e OEMs podem definir outros tipos de contexto proprietários com outros valores UUID exclusivos que não serão reconhecíveis pelo sistema operacional para suas próprias finalidades.

Resposta

A estrutura de MBIM_MS_PROVISIONED_CONTEXT_INFO_V2 a seguir deve ser usada no InformationBuffer.

MBIM_MS_CONTEXT_V2, usado na tabela anterior, fornece informações sobre um determinado contexto.

Notificação

Para obter mais informações, consulte a tabela MBIM_MS_PROVISIONED_CONTEXT_V2.

Códigos de status

Para operações de Consulta e Defina:

Somente para definir operações:

Inicialização de dispositivos com um contexto provisionado

Inicialização de um dispositivo GPRS não bloqueado por SIM com um contexto provisionado

O diagrama a seguir representa a experiência ideal do usuário para dispositivos MB baseados em GSM. A experiência pré-configurada não requer nenhuma configuração do usuário. Supõe-se que o dispositivo esteja configurado para selecionar automaticamente a rede com a qual se registrar. Os rótulos em negrito representam identificadores OID ou controle de fluxo transacional. Os rótulos em texto regular representam os sinalizadores importantes dentro da estrutura OID.

Para inicializar um dispositivo baseado em GSM não bloqueado por SIM, implemente as seguintes etapas:

1. O Serviço MB envia uma solicitação de consulta assíncrona (sem bloqueio) OID_WWAN_READY_INFO ao driver de miniporto para identificar o estado pronto do dispositivo. O driver de miniporto responde com uma confirmação provisória (NDIS_STATUS_INDICATION_REQUIRED) de que recebeu a solicitação e que enviará, futuramente, uma notificação com as informações solicitadas.

2. O driver de miniporto envia uma notificação NDIS_STATUS_WWAN_READY_INFO ao Serviço MB que indica ao Serviço MB que o estado do dispositivo MB é WwanReadyStateInitialized.

3. O Serviço MB envia uma solicitação de consulta assíncrona (sem bloqueio) OID_WWAN_REGISTER_STATE ao driver de miniporto para identificar o estado de registro do dispositivo. O driver de miniporto responde com uma confirmação provisória (NDIS_STATUS_INDICATION_REQUIRED) de que recebeu a solicitação e que enviará, futuramente, uma notificação com as informações solicitadas.

4. O driver de miniporto envia uma notificação NDIS_STATUS_WWAN_REGISTER_STATE ao Serviço MB que indica que o modo de registro do dispositivo é WwanRegistraterModeAutomatic e seu estado de registro atual é WwanRegisterStateSearching.

5. Posteriormente, quando o dispositivo é registrado em um provedor de rede, o driver de miniporto envia uma notificação de NDIS_STATUS_WWAN_REGISTER_STATE não solicitada ao Serviço MB que indica que o estado de registro atual do dispositivo é WwanRegisterStateHome.

6. O dispositivo tenta conectar-se ao serviço de pacote. Quando o estado do serviço de pacote muda para anexado, o driver de miniporto envia, sem solicitação, uma notificação NDIS_STATUS_WWAN_PACKET_SERVICE ao Serviço MB que indica que o serviço de pacote está anexado e que a classe de dados atual é WWAN_DATA_CLASS_GPRS.

7. O Serviço MB envia uma solicitação de consulta assíncrona (sem bloqueio) OID_WWAN_HOME_PROVIDER ao driver de miniporto para recuperar informações do provedor doméstico. O driver de miniport responde com uma confirmação provisória (NDIS_STATUS_INDICATION_REQUIRED) de que recebeu a solicitação e enviará uma notificação com as informações solicitadas no futuro.

8. O driver de miniporto envia uma notificação NDIS_STATUS_WWAN_HOME_PROVIDER para o Serviço MB que indica os detalhes do provedor doméstico.

9. O Serviço MB envia uma solicitação de consulta assíncrona (sem bloqueio) OID_WWAN_PROVISIONED_CONTEXTS ao driver de miniporto para recuperar a lista de contextos provisionados. O driver de miniporto responde com uma confirmação provisória (NDIS_STATUS_INDICATION_REQUIRED) de que recebeu a solicitação e que enviará, futuramente, uma notificação com as informações solicitadas.

10. O driver de miniporto envia uma notificação NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS ao Serviço MB, que contém uma lista de estruturas WWAN_CONTEXT.

11. O Serviço MB envia uma solicitação assíncrona (sem bloqueio) OID_WWAN_CONNECT definida para o driver de miniporto para ativar o contexto PDP (Packet Data Protocol). O driver de miniporto responde com uma confirmação provisória (NDIS_STATUS_INDICATION_REQUIRED) de que recebeu a solicitação e que enviará, futuramente, uma notificação com as informações solicitadas.

12. O driver de miniporto envia uma notificação NDIS_STATUS_WWAN_CONTEXT_STATE para o Serviço MB que indica que o contexto PDP está ativado.

13. O driver de miniporto envia uma notificação NDIS_STATUS_LINK_STATE para indicar que o estado de conexão de mídia é MediaConnectStateConnected.

Inicialização de um dispositivo de pacote CDMA com um contexto provisionado

O diagrama a seguir ilustra a experiência ideal do usuário para dispositivos baseados em CDMA. A experiência pronta para uso não requer configuração pelo usuário. Esse cenário pressupõe que a conta baseada em CDMA não tenha sido ativada. Ao contrário dos dispositivos baseados em GSM, um dispositivo baseado em CDMA inicia automaticamente o registro com a rede após a conclusão da ativação. Os rótulos em negrito são identificadores OID ou controle de fluxo transacional. Os rótulos em texto regular são os sinalizadores importantes dentro da estrutura OID.

Para inicializar um dispositivo de pacote baseado em CDMA com um contexto provisionado, implemente as seguintes etapas:

1. O Serviço MB envia uma OID_WWAN_READY_INFO de forma assíncrona (sem bloqueio) para o miniport driver. O driver de miniporto responde com uma confirmação provisória (NDIS_STATUS_INDICATION_REQUIRED) de que recebeu a solicitação e que enviará uma notificação com as informações solicitadas no futuro.

2. O driver de miniporto envia NDIS_STATUS_WWAN_FAILURE para o MB Service.

3. O Serviço MB envia uma OID_WWAN_SERVICE_ACTIVATION assíncrona (sem bloqueio) para o driver de miniporto. O driver de miniporto responde com uma confirmação provisória (NDIS_STATUS_INDICATION_REQUIRED) de que recebeu a solicitação e que enviará uma notificação com as informações solicitadas no futuro.

4. O driver de miniporto envia NDIS_STATUS_WWAN_SUCCESS para o Serviço MB.

5. O driver de miniporta envia NDIS_STATUS_WWAN_REGISTER_STATE para o Serviço MB.

6. O miniport driver envia NDIS_STATUS_WWAN_REGISTER_STATE para o Serviço MB.

7. O driver de miniport envia NDIS_STATUS_WWAN_PACKET_SERVICE para o Serviço MB.

8. O Serviço MB envia uma OID_WWAN_HOME_PROVIDER assíncrona (sem bloqueio) para o driver de miniporto. O driver de miniporto responde com uma confirmação provisória (NDIS_STATUS_INDICATION_REQUIRED) de que recebeu a solicitação e que enviará uma notificação com as informações solicitadas no futuro.

9. O driver de miniporto envia NDIS_STATUS_WWAN_SUCCESS para o Serviço MB.

10. O Serviço MB envia uma OID_WWAN_PROVISIONED_CONTEXTS assíncrona (sem bloqueio) para o driver de miniporto. O driver de miniporto responde com uma confirmação provisória (NDIS_STATUS_INDICATION_REQUIRED) de que recebeu a solicitação e que enviará uma notificação com as informações solicitadas no futuro.

11. O driver de miniporto envia NDIS_STATUS_WWAN_SUCCESS para o Serviço MB.

12. O Serviço MB envia um OID_WWAN_PROVISIONED_CONTEXTS assíncrono (sem bloqueio) para o driver de miniporto. O driver de miniporto responde com uma confirmação provisória (NDIS_STATUS_INDICATION_REQUIRED) de que recebeu a solicitação e que enviará, futuramente, uma notificação com as informações solicitadas.

13. O driver de miniporto envia NDIS_STATUS_WWAN_SUCCESS para o Serviço MB.

14. O driver de miniporto envia NDIS_STATUS_LINK_STATE para o Serviço MB.

Consulte Também

Preparação do dispositivo MB