Operaciones de contexto aprovisionadas de MB

El aprovisionamiento es fundamental para los dispositivos que se pueden conectar mediante telefonía móvil, ya que cada operador de telefonía móvil tiene diferentes configuraciones de APN para su red. Por lo general, las configuraciones de APN se pueden dividir en dos categorías:

1. Configuraciones de APN conocidas para el sistema operativo porque hay aplicaciones o clientes por encima del sistema operativo que requiere esas conexiones.
2. Configuraciones de APN que no se conocen en el sistema operativo porque son consumidas internamente por el módem para las conexiones que el sistema operativo y sus clientes no aprovechan.

Idealmente, el módem solo debe almacenar las configuraciones de APN que el sistema operativo no tiene que saber. Sin embargo, los asociados de IHV y OEM han proporcionado tradicionalmente los APN de Internet y Compra, configuraciones conocidas para el sistema operativo, también en el módem. Antes del lanzamiento de Windows 10, versión 1703, Windows solo leía las configuraciones de APN de Internet y de compra del módem para establecer conexiones a Internet. A partir de Windows 10, versión 1703, puede haber casos adicionales en los que la configuración de APN del módem tendría que administrarse mediante Windows, especialmente si hay clientes en el sistema operativo, como la configuración de usuario o OMA-DM que quieran cambiar la configuración de telefonía móvil. Esto también podría afectar a la configuración de APN del módem. Por ejemplo, podría haber una pila IMS en el módem que usa el APN de IMS para SMS a través de IMS. Normalmente, esas conexiones no se exponen al sistema operativo, pero en determinados escenarios es posible que la configuración de APN de IMS tenga que cambiarse. Este cambio se puede realizar a través del sistema operativo. Para admitir esto, a partir de Windows 10, versión 1703, el sistema operativo puede configurar diferentes tipos de APN en el módem.

Los MBIM 1.0 y Microsoft NDIS del foro USB tienen cada uno un CID y un OID existentes, respectivamente, para permitir que el sistema operativo establezca y consulte las configuraciones de APN en el módem. Para MBIM 1.0, lo hace a través de MBIM_CID_PROVISIONED_CONTEXT, mientras que para NDIS lo hace a través de OID_WWAN_PROVISIONED_CONTEXTS. Sin embargo, el CID y el OID existentes no se diseñaron con instrucciones claras sobre cómo se espera que el módem se comporte en diversas situaciones, como un ciclo de alimentación o intercambio sim. Los dispositivos que quieran admitir la configuración y actualización del sistema operativo de los contextos aprovisionados por módems en adelante tendrán que implementar la versión más reciente del CID y el OID en Windows 10, versión 1703. Para garantizar la compatibilidad con versiones anteriores, para IHV/OEM que quieran admitir nuevo hardware en versiones del sistema operativo anteriores a 1703, tendrán que seguir admitiendo los MBIM_CID_PROVISIONED_CONTEXT y OID_WWAN_PROVISIONED_CONTEXTS existentes. A partir de Windows 10, versión 1703, si el dispositivo admite la nueva versión del CID y el OID, el sistema operativo solo usará la versión más reciente del comando para consultar y establecer la configuración de contexto de APN en el módem.

Actualización de la interfaz MB para las operaciones de contexto aprovisionadas

Aunque MBIM tiene un comando para recuperar y reemplazar contextos almacenados en el módem, no tiene un campo para "deshabilitar" o "habilitar" un perfil. Por lo tanto, el MBIM_CID_PROVISIONED_CONTEXT existente debe actualizarse para Windows 10, versión 1703, para incluir esta funcionalidad. Dado que MBIM no tiene un mecanismo de control de versiones, se define un nuevo CID propietario de MSFT como MBIM_CID_MS_PROVISIONED_CONTEXT_V2.

Nombre del servicio = Extensiones básicas de conexión

UUID = UUID_BASIC_CONNECT_EXTENSIONS

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

MBIM_CID_MS_PROVISIONED_CONTEXT_V2

Descripción

Aunque MBIM 1.0 ha definido MBIM_CID_PROVISIONED_CONTEXT para el sistema operativo y sus clientes superiores para administrar contextos aprovisionados en el módem, Windows tradicionalmente solo consultaba el contexto en el módem, pero no lo estableció desde el sistema operativo. A partir de Windows 10, versión 1703, hay creciente necesidad de que el sistema operativo pueda configurar los contextos en el módem. Por ejemplo, si hay una pila IMS en el módem que es opaca para el sistema operativo, el sistema operativo debe poder especificar el APN de IMS que debe usar el módem. Dado que cada IHV de módem puede tener su propia manera de almacenar contextos en el módem, es imposible que el sistema operativo administre perfiles en el nivel ContextId de la manera que MBIM_CID_PROVISIONED_CONTEXT podría sugerir. En su lugar, desde la perspectiva del sistema operativo es más importante recetar qué contexto usar para cada tipo de contexto. Volviendo al ejemplo de IMS, independientemente del número de contextos aprovisionados existentes en el módem, si el sistema operativo establece un contexto que tiene MBIM_CONTEXT_TYPE = IMS, todo el tráfico de IMS iniciado por el módem solo debe intentarse en ese contexto.

MBIM 1.0 especifica que MBIM_CID_PROVISIONED_CONTEXT solo puede llamar a Query en contextos que coincidan con el id. de proveedor (par MCC/MNC) de la tarjeta SIM insertada. Para solicitudes Set, MBIM_CID_PROVISIONED_CONTEXT puede especificar el identificador de proveedor del contexto que quiere almacenar. MBIM_CID_MS_PROVISIONED_CONTEXT_V2 especifica un comportamiento similar pero diferente de MBIM 1.0. Para cada consulta, el sistema operativo sigue esperando que el módem devuelva solo contextos que coincidan con el identificador de proveedor de la tarjeta SIM insertada. Para Set, el comando ya no habilitará el sistema operativo en contextos Set que no coincidan con el identificador de proveedor actual en la tarjeta SIM. Se espera que la solicitud Set sea crear un contexto para el identificador de proveedor actual de la tarjeta SIM presentada. Por ejemplo, el usuario intercambia de SIM 1 a SIM 2 y, a continuación, vuelve a SIM 1. Se espera que durante el primer intercambio de SIM, el módem debe resolver todos sus contextos antes de cargar el contexto para SIM 2. Cuando el usuario vuelve a cambiar a SIM 1, se debe restaurar la configuración predeterminada de fábrica de SIM 1. No se espera que el módem guarde la configuración durante el tiempo de ejecución en los intercambios de SIM.

En el diagrama siguiente se muestra un flujo de ejemplo para cuando un usuario intercambia de una SIM a otra y, a continuación, vuelve a la primera.

Los OEM e IHD que han preconfigurado el módem deben mantener la configuración de fábrica original en caso de que el sistema operativo o el usuario quiera restaurar la configuración de contexto en el módem a la configuración original. Solo se deben restaurar los contextos de fábrica originales para el identificador de proveedor de la SIM insertada actualmente. La configuración del sistema operativo nunca debe sobrescribir los contextos preconfigurados originales de fábrica. El diagrama siguiente es un flujo de ejemplo para cuando un usuario decide restaurar la configuración de fábrica:

Se espera que el módem falle en las solicitudes de consulta o configuración cuando falte la SIM, esté bloqueada, o el identificador del proveedor no sea accesible. El módem debe tener solo un contexto por CONTEXT_TYPE por identificador de proveedor. Si el IHV o OEM decide preconfigurar los contextos del módem en el módem, es importante asegurarse de que los contextos están configurados correctamente para cada proveedor para el que elija hacerlo. En caso de que la tarjeta SIM insertada no tenga ningún contexto preconfigurado de IHV, el módem no debe tener ningún contexto sin la configuración del sistema operativo. Los IHV y OEM tienen que asegurarse de que MBIM_MS_CONTEXT_SOURCE = MbimMsContextSourceModemProvisioned para que el sistema operativo use el contexto del módem para la conexión, si existe, y no sobrescribirlo desde la base de datos de APN de Windows.

El modo en que los mapeos del módem manejan el contexto y lo presentan de nuevo a través del MBIM_CID_PROVISIONED_CONTEXT existente es responsabilidad de cada IHV y está fuera del alcance de esta documentación.

El nuevo comando MBIM_CID_MS_PROVISONED_CONTEXT_V2 es casi idéntico al comando MBIM_CID_PROVISIONED_CONTEXT existente de MBIM 1.0, pero con varias adiciones. La primera proporciona al sistema operativo la capacidad de habilitar o deshabilitar el contexto asociado a un tipo de contexto en el módem. Cuando el contexto está deshabilitado en el módem, se espera que el módem no utilice el contexto almacenado para ninguna conexión con la red, incluso aquellas que no son gestionadas por el sistema operativo. Si el sistema operativo solicita una conexión que coincida con un contexto deshabilitado en el módem, el módem debe producir un error en la solicitud inmediatamente sin señalizar a la red. El proceso de emparejamiento debe hacer coincidir todos los campos de la estructura MBIM_MS_CONTEXT_V2.

La estructura MBIM_CONTEXT_IP_TYPE de MBIM 1.0 solo se usa para MBIM_CID_CONNECT. En MBIM_CID_MS_PROVISIONED_CONTEXT_V2, Microsoft ha agregado el tipo ip como uno de los parámetros de cada contexto. El módem debe notificar MBIMContextIPTypeDefault si no está configurado para el contexto especificado.

En Windows 10, versión 1703, con nuevo hardware compatible con MBIM_CID_MS_PROVISIONED_CONTEXT_V2, la MBIM_CID_PROVISIONED_CONTEXT heredada no se usará desde componentes de primera entidad. Si hay otros componentes de cliente o sistema operativo heredados que envían MBIM_CID_PROVISIONED_CONTEXT, se espera que el módem devuelva resultados como lo hizo en versiones de Windows anteriores a Windows 10, versión 1703.

Consultar

MBIM_MS_PROVISIONED_CONTEXTS_INFO se devuelve desde los mensajes completos Query y Set en InformationBuffer.

Para Query, InformationBuffer es NULL.

Set

Para Set, el InformationBuffer contiene una estructura MBIM_MS_SET_PROVISIONED_CONTEXT_V2. En la operación Set, dado que cada IHV de módem puede tener formas propietarias de administrar el almacenamiento de contexto, el sistema operativo ya no especifica el campo ContextId y espera que el módem asigne los contextos a la ranura adecuada. Cuando el sistema operativo establece contextos, espera que el módem lo use para todas las conexiones que coincidan con el MBIM_CONTEXT_TYPE del contexto especificado. Si el módem no reconoce el MBIM_CONTEXT_TYPE, debe almacenarlo aunque no se conecte con él.

Evento no solicitado

Event InformationBuffer contiene una estructura MBIM_MS_PROVISIONED_CONTEXTS_INFO_V2. En algunos casos, la red actualiza la lista de contextos aprovisionados, ya sea por vía inalámbrica (OTA) o por el servicio de mensajes cortos (SMS) que no pasa por el comando MBIM_CID_MS_PROVISIONED_CONTEXT_V2 desde el sistema operativo. La función debe actualizar la lista de contextos aprovisionados y etiquetar MBIM_MS_CONTEXT_SOURCE = MbimMsContextSourceOperatorProvisioned en consecuencia. Después, las funciones deben notificar al host sobre las actualizaciones utilizando este evento con la lista actualizada.

Parámetros

Estructuras de datos

Consultar

InformationBuffer será NULL y InformationBufferLength será cero.

Set

La siguiente estructura de datos MBIM_SET_MS_PROVISIONED_CONTEXT_V2 se utilizará en el InformationBuffer.

Las siguientes estructuras de datos se usan en la tabla anterior.

MBIM_MS_CONTEXT_ROAMING_CONTROL especifica la directiva de itinerancia por contexto. El sistema operativo puede especificar si el contexto especificado se puede habilitar durante la itinerancia o no. El módem no debe activar automáticamente el contexto sin intervención del sistema operativo si el estado de itinerancia no cumple las condiciones especificadas. En los casos en los que el módem no admite socios, todas las configuraciones de socios deben ser tratadas como equivalentes al hogar.

MBIM_MS_CONTEXT_MEDIA_TYPE se ha agregado para poder especificar si el contexto se usa para la telefonía móvil o iWLAN cuando la descarga Wi-Fi se admite en plataformas futuras. Por ejemplo, si un contexto se establece como móvil y el módem está descargando actualmente Wi-Fi, no debe iniciar una conexión mediante ese contexto.

MBIM_MS_CONTEXT_ENABLE especifica si un contexto está habilitado o deshabilitado.

MBIM_MS_CONTEXT_SOURCE se ha agregado para que el sistema operativo tenga visibilidad sobre cómo se creó el contexto del módem. Esto ayuda al sistema operativo a comportarse correctamente después de varias situaciones como el restablecimiento de fábrica, por lo que puede saber qué debe persistir y qué se debe devolver al estado predeterminado en función de los distintos requisitos del operador.

MBIM_MS_CONTEXT_OPERATIONS especifica las operaciones que el sistema operativo puede realizar para configurar contextos en el módem.

El MBIM_CONTEXT_TYPES original de MBIM 1.0 sigue siendo válido. Microsoft agrega tipos de contexto adicionales a medida que se introdujeron más tipos de contextos desde que se definió MBIM 1.0. En la tabla siguiente se definen los nuevos tipos que se están introduciendo. Los IHVs y los OEM pueden definir otros tipos de contexto propietarios con otros valores UUID únicos que no serán reconocibles por el sistema operativo para sus propios propósitos.

Respuesta

La siguiente estructura MBIM_MS_PROVISIONED_CONTEXT_INFO_V2 se usará en informationBuffer.

MBIM_MS_CONTEXT_V2, que se usa en la tabla anterior, proporciona información sobre un contexto determinado.

Notificación

Para obtener más información, consulte la tabla MBIM_MS_PROVISIONED_CONTEXT_V2.

Códigos de estado

Para las operaciones de consulta y configuración:

Solo para operaciones Set:

Inicialización de dispositivos con un contexto aprovisionado

Inicialización de un dispositivo GPRS no bloqueado por SIM con un contexto aprovisionado

El siguiente diagrama representa la experiencia de usuario óptima para dispositivos MB basados en GSM. La experiencia integrada no requiere ninguna configuración por parte del usuario. Se supone que el dispositivo está configurado para seleccionar automáticamente la red con la que registrarse. Las etiquetas en negrita representan identificadores OID o control de flujo transaccional. Las etiquetas del texto normal representan las marcas importantes dentro de la estructura OID.

Para inicializar un dispositivo basado en GSM que no esté bloqueado por SIM, siga los pasos siguientes:

1. El servicio MB envía una solicitud de consulta asincrónica (sin bloqueo OID_WWAN_READY_INFO) al controlador de miniport para identificar el estado listo del dispositivo. El controlador de miniporte responde con una confirmación provisional (NDIS_STATUS_INDICATION_REQUIRED) que ha recibido la solicitud y enviará una notificación con la información solicitada en el futuro.

2. El controlador de minipuerto envía una notificación NDIS_STATUS_WWAN_READY_INFO al servicio MB que indica al servicio MB que el estado del dispositivo MB es WwanReadyStateInitialized.

3. El servicio MB envía una solicitud de consulta asincrónica (sin bloqueo OID_WWAN_REGISTER_STATE) al controlador de miniport para identificar el estado de registro del dispositivo. El controlador de miniporte responde con una confirmación provisional (NDIS_STATUS_INDICATION_REQUIRED) que ha recibido la solicitud y enviará una notificación con la información solicitada en el futuro.

4. El controlador de miniport envía una notificación NDIS_STATUS_WWAN_REGISTER_STATE al servicio MB que indica que el modo de registro del dispositivo es wwanRegistraterModeAutomatic y su estado de registro actual es WwanRegisterStateSearching.

5. Más adelante, cuando el dispositivo está registrado en un proveedor de red, el controlador de miniporte envía una notificación NDIS_STATUS_WWAN_REGISTER_STATE no solicitada al servicio MB que indica que el estado de registro actual del dispositivo es WwanRegisterStateHome.

6. El dispositivo intenta conectar el servicio de paquetes. Cuando el estado del servicio de paquetes cambia a asociado, el controlador de miniporta envía una notificación NDIS_STATUS_WWAN_PACKET_SERVICE no solicitada al servicio MB que indica que el servicio de paquetes está asociado y la clase de datos actual es WWAN_DATA_CLASS_GPRS.

7. El servicio MB envía una solicitud de consulta asincrónica (sin bloqueo OID_WWAN_HOME_PROVIDER) al controlador de miniport para recuperar la información del proveedor principal. El controlador de miniporte responde con una confirmación provisional (NDIS_STATUS_INDICATION_REQUIRED) que ha recibido la solicitud y enviará una notificación con la información solicitada en el futuro.

8. El controlador de miniporte envía una notificación NDIS_STATUS_WWAN_HOME_PROVIDER al servicio MB que indica los detalles del proveedor principal.

9. El servicio MB envía una solicitud de consulta asincrónica (sin bloqueo OID_WWAN_PROVISIONED_CONTEXTS) al controlador de miniport para recuperar la lista de contextos aprovisionados. El controlador de miniporte responde con una confirmación provisional (NDIS_STATUS_INDICATION_REQUIRED) que ha recibido la solicitud y enviará una notificación con la información solicitada en el futuro.

10. El controlador de minipuerto envía una notificación NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS al servicio MB que contiene una lista de estructuras WWAN_CONTEXT.

11. El servicio MB envía una solicitud Set asincrónica (sin bloqueo) OID_WWAN_CONNECT al controlador de minipuerto para activar el contexto del Protocolo de datos de paquetes (PDP). El controlador de miniporte responde con una confirmación provisional (NDIS_STATUS_INDICATION_REQUIRED) que ha recibido la solicitud y enviará una notificación con la información solicitada en el futuro.

12. El controlador de miniporte envía una notificación NDIS_STATUS_WWAN_CONTEXT_STATE al servicio MB que indica que el contexto PDP está activado.

13. El controlador de miniporte envía una notificación NDIS_STATUS_LINK_STATE para indicar que el estado de conexión multimedia es MediaConnectStateConnected.

Inicialización de un dispositivo de paquete CDMA con un contexto aprovisionado

En el diagrama siguiente se muestra la experiencia de usuario óptima para dispositivos basados en CDMA. La experiencia preconfigurada no requiere configuración por parte del usuario. En este escenario se supone que no se ha activado la cuenta basada en CDMA. A diferencia de los dispositivos basados en GSM, un dispositivo basado en CDMA inicia automáticamente el registro con la red una vez completada la activación. Las etiquetas en negrita son identificadores OID o control de flujo transaccional. Las etiquetas del texto normal son las marcas importantes dentro de la estructura OID.

Para inicializar un dispositivo de paquete basado en CDMA con un contexto aprovisionado, implemente los pasos siguientes:

1. El servicio MB envía un OID_WWAN_READY_INFO asincrónico (sin bloqueo) al controlador de miniport. El controlador de miniporte responde con una confirmación provisional (NDIS_STATUS_INDICATION_REQUIRED) que ha recibido la solicitud y que enviará una notificación con la información solicitada en el futuro.

2. El controlador de minipuerto envía NDIS_STATUS_WWAN_FAILURE al servicio MB.

3. El servicio MB envía un OID_WWAN_SERVICE_ACTIVATION asincrónico (sin bloqueo) al controlador de minipuerto. El controlador de miniporte responde con una confirmación provisional (NDIS_STATUS_INDICATION_REQUIRED) que ha recibido la solicitud y que enviará una notificación con la información solicitada en el futuro.

4. El controlador de miniporte envía NDIS_STATUS_WWAN_SUCCESS al MB Service.

5. El controlador de minipuerto envía NDIS_STATUS_WWAN_REGISTER_STATE al servicio MB.

6. El controlador de minipuerto envía NDIS_STATUS_WWAN_REGISTER_STATE al servicio MB.

7. El controlador de minipuerto envía NDIS_STATUS_WWAN_PACKET_SERVICE al servicio MB.

8. El servicio MB envía un OID_WWAN_HOME_PROVIDER asincrónico (sin bloqueo) al controlador de miniport. El controlador de miniporte responde con una confirmación provisional (NDIS_STATUS_INDICATION_REQUIRED) que ha recibido la solicitud y que enviará una notificación con la información solicitada en el futuro.

9. El controlador de miniporte envía NDIS_STATUS_WWAN_SUCCESS al MB Service.

10. El servicio MB envía un OID_WWAN_PROVISIONED_CONTEXTS asincrónico (sin bloqueo) al controlador de minipuerto. El controlador de miniporte responde con una confirmación provisional (NDIS_STATUS_INDICATION_REQUIRED) que ha recibido la solicitud y que enviará una notificación con la información solicitada en el futuro.

11. El controlador de miniporte envía NDIS_STATUS_WWAN_SUCCESS al MB Service.

12. El servicio MB envía un OID_WWAN_PROVISIONED_CONTEXTS asincrónico (sin bloqueo) al controlador de minipuerto. El controlador de miniporte responde con una confirmación provisional (NDIS_STATUS_INDICATION_REQUIRED) que ha recibido la solicitud y enviará una notificación con la información solicitada en el futuro.

13. El controlador de miniporte envía NDIS_STATUS_WWAN_SUCCESS al MB Service.

14. El controlador de miniporte envía NDIS_STATUS_LINK_STATE al servicio MB.

Consulte también

Preparación de dispositivo MB