Acesso UICC de baixo nível mb
Visão geral
A Revisão do Modelo de Interface de Banda Larga Móvel 1.0 ou MBIM1 define uma interface independente de OEM e IHV entre um dispositivo host e um modem de dados da rede celular.
Uma função MBIM1 inclui uma cartão inteligente UICC e fornece acesso a alguns de seus dados e estado interno. No entanto, a cartão inteligente pode ter funcionalidades adicionais além daquelas definidas pela interface MBIM. Esses recursos adicionais incluem suporte para um elemento seguro para soluções de pagamento móvel com base na comunicação de campo próximo ou para provisionamento remoto de um perfil UICC inteiro.
Em um dispositivo Windows habilitado para banda larga móvel, a interface MBIM é usada além da interface RIL (Radio Interface Layer). Um dos recursos que o RIL fornece é uma interface para acesso de baixo nível à UICC. Este tópico descreve um conjunto de extensões da Microsoft para MBIM que descrevem essa funcionalidade adicional na interface MBIM.
As extensões da Microsoft compõem um conjunto de comandos de serviço de dispositivo (definir e consultar) e notificações. Essas extensões não incluem novos usos de fluxos de serviço de dispositivo.
Valores de SERVIÇO e CID do MBIM
| Nome do serviço | UUID | Valor UUID |
|---|---|---|
| Microsoft Low-Level UICC Access | UUID_MS_UICC_LOW_LEVEL | C2F6588E-F037-4BC9-8665-F4D44BD09367 |
A tabela a seguir especifica o código de comando para cada CID, bem como se o CID dá suporte a solicitações Set, Query ou Event (notificação). Consulte a seção individual de cada CID neste tópico para obter mais informações sobre seus parâmetros, estruturas de dados e notificações.
| CID | Código de comando | Definir | Consulta | Notificar |
|---|---|---|---|---|
| MBIM_CID_MS_UICC_ATR | 1 | N | S | N |
| MBIM_CID_MS_UICC_OPEN_CHANNEL | 2 | S | N | N |
| MBIM_CID_MS_UICC_CLOSE_CHANNEL | 3 | S | N | N |
| MBIM_CID_MS_UICC_APDU) | 4 | S | N | N |
| MBIM_CID_MS_UICC_TERMINAL_CAPABILITY | 5 | S | S | N |
| MBIM_CID_MS_UICC_RESET | 6 | S | S | N |
Códigos de status
Os códigos de status do MBIM são definidos na Seção 9.4.5 do padrão MBIM. Além disso, os seguintes códigos de status de falha adicionais são definidos:
| Código de status | Valor (hex) | Descrição |
|---|---|---|
| MBIM_STATUS_MS_NO_LOGICAL_CHANNELS | 87430001 | O canal lógico aberto não foi bem-sucedido porque nenhum canais lógicos está disponível na UICC (ele não dá suporte a eles ou todos eles estão em uso). |
| MBIM_STATUS_MS_SELECT_FAILED | 87430002 | O canal lógico aberto não foi bem-sucedido porque SELECT falhou. |
| MBIM_STATUS_MS_INVALID_LOGICAL_CHANNEL | 87430003 | O número do canal lógico é inválido (não foi aberto por MBIM_CID_MS_UICC_OPEN_CHANNEL). |
MBIM_SUBSCRIBER_READY_STATE
| Tipo | Valor | Descrição |
|---|---|---|
| MBIMSubscriberReadyStateNoEsimProfile | 7 | O cartão está pronto, mas não tem nenhum perfil habilitado. |
Respostas e status UICC
A UICC pode implementar uma interface baseada em caracteres ou de registro ou ambas. Embora o mecanismo específico seja diferente, o resultado é que a UICC responde a cada comando com dois bytes status (chamados SW1 e SW2) e uma resposta (que pode estar vazia). Uma status de sucesso normal é indicada por 90 00. No entanto, se a UICC der suporte ao kit de ferramentas de aplicativo cartão e a UICC quiser enviar um comando proativo para o terminal, um retorno bem-sucedido será indicado por um status de 91 XX (em que XX varia). A função MBIM, ou terminal, é responsável por lidar com esse comando proativo, assim como lidaria com um comando proativo recebido durante qualquer outra operação UICC (enviar um FETCH para a UICC, manipular o comando proativo ou enviá-lo para o host com MBIM_CID_STK_PAC). Quando o host MBIM envia MBIM_CID_MS_UICC_OPEN_CHANNEL ou MBIM_CID_MS_UICC_APDU ele deve considerar 90 00 e 91 XX como uma status normal.
Os comandos devem ser capazes de retornar respostas maiores que 256 bytes. Esse mecanismo é descrito na Seção 5.1.3 do padrão ISO/IEC 7816-4:2013. Nesse caso, o cartão retornará SW1 SW2 status palavras de 61 XX, em vez de 90 00, em que XX será o número de bytes restantes ou 00 se houver 256 bytes ou mais restantes. O modem deve emitir um GET RESPONSE com o mesmo byte de classe repetidamente até que todos os dados sejam recebidos. Isso será indicado pelas palavras finais status 90 00. A sequência deve ser ininterrupta em um canal lógico específico. APDUs adicionais devem ser tratadas no modem e devem ser transparentes para o host. Se tratado no host, não há garantia de que alguma outra APDU possa referenciar assíncronamente o cartão durante a sequência de APDUs.
Comparação com IHVRIL
As seções 5.2.3.3.10 a 5.2.3.3.14 da especificação IHVRIL definem uma interface semelhante na qual essa especificação se baseia. Algumas diferenças incluem:
- A interface RIL não fornece uma maneira de especificar mensagens seguras. O comando MBIM para trocar APDUs especifica isso como um parâmetro explícito.
- A interface RIL não define claramente a interpretação do byte de classe dentro da APDU. A especificação do MBIM afirma que o byte de classe enviado do host deve estar presente, mas não é usado (e, em vez disso, a função MBIM constrói esse byte).
- A interface RIL usa uma função separada para fechar todos os canais UICC em um grupo, enquanto a interface MBIM faz isso com argumentos variantes para um único CID.
- A relação entre o status de erro do MBIM e a status UICC (SW1 SW2) é mais claramente definida do que a relação entre erros RIL e status UICC.
- A interface do MBIM distingue a falha ao alocar um novo canal lógico de falha para SELECIONAR um aplicativo especificado.
- A interface do MBIM permite enviar os objetos de funcionalidade do terminal do modem para enviar para o cartão.
MBIM_CID_MS_UICC_ATR
A ATR (Resposta à Redefinição) é a primeira cadeia de caracteres de bytes enviada pelo UICC após a execução de uma redefinição. Ele descreve os recursos do cartão, como o número de canais lógicos aos quais ele dá suporte. A função MBIM deve salvar o ATR quando ele é recebido do UICC. Posteriormente, o host pode usar o comando MBIM_CID_MS_UICC_ATR para recuperar o ATR.
Parâmetros
| Tipo | Definir | Consulta | Notificação |
|---|---|---|---|
| Comando | Não aplicável | Vazio | Não aplicável |
| Resposta | Não aplicável | MBIM_MS_ATR_INFO | Não aplicável |
Consulta
O InformationBuffer de uma mensagem de consulta está vazio.
Definir
Não aplicável.
Resposta
O InformationBuffer do MBIM_COMMAND_DONE contém a seguinte estrutura MBIM_MS_ATR_INFO que descreve a resposta para redefinir para o UICC anexado a essa função.
MBIM_MS_ATR_INFO
| Deslocamento | Tamanho | Campo | Tipo | Descrição |
|---|---|---|---|---|
| 0 | 4 | AtrSize | SIZE(0..33) | O comprimento de AtrData. |
| 4 | 4 | AtrOffset | OFFSET | O deslocamento em bytes, calculado desde o início dessa estrutura, para uma matriz de bytes chamada AtrData que contém os dados atr. |
| 8 | AtrSize | DataBuffer | DATABUFFER | A matriz de bytes AtrData . |
Eventos não solicitados
Não aplicável.
Códigos de status
Os seguintes códigos de status são aplicáveis.
| Código de status | Descrição |
|---|---|
| MBIM_STATUS_SUCCESS | O MBIM básico status conforme definido para todos os comandos. |
| MBIM_STATUS_BUSY | O MBIM básico status conforme definido para todos os comandos. |
| MBIM_STATUS_FAILURE | O MBIM básico status conforme definido para todos os comandos. |
| MBIM_STATUS_NO_DEVICE_SUPPORT | O MBIM básico status conforme definido para todos os comandos. |
| MBIM_STATUS_SIM_NOT_INSERTED | Não é possível executar a operação UICC porque o UICC está ausente. |
| MBIM_STATUS_BAD_SIM | Não é possível executar a operação UICC porque o UICC está em um estado de erro. |
| MBIM_STATUS_NOT_INITIALIZED | Não é possível executar a operação UICC porque o UICC ainda não foi totalmente inicializado. |
MBIM_CID_MS_UICC_OPEN_CHANNEL
O host usa o comando MBIM_CID_MS_UICC_OPEN_CHANNEL para solicitar que a função abra um novo canal lógico no cartão UICC e selecione um aplicativo UICC especificado (especificado pela ID do aplicativo).
A função implementa esse comando MBIM usando uma sequência de comandos UICC:
- A função envia um comando MANAGE CHANNEL para o UICC, conforme descrito pela seção 11.1.17 da especificação técnica ETSI TS 102 221, para criar um novo canal lógico. Se esse comando falhar, a função retornará o MBIM_STATUS_MS_NO_LOGICAL_CHANNELS status com SW1 SW2 e não executará nenhuma ação adicional.
- Se o comando MANAGE CHANNEL for bem-sucedido, o UICC relatará o número do canal do novo canal lógico para a função. A função envia um comando SELECT [por nome] em que P1 = 04, conforme descrito pela seção 11.1.1 da especificação técnica ETSI TS 102 221. Se essa operação falhar, a função enviará um comando MANAGE CHANNEL para o UICC para fechar o canal lógico e retornará o MBIM_STATUS_MS_SELECT_FAILED status com SW1 SW2 do SELECT.
- Se o comando SELECT for bem-sucedido, a função registrará o número do canal lógico e o grupo de canais especificado pelo host para referência futura. Em seguida, ele retornará o número do canal lógico, SW1 SW2 do SELECT e a resposta de SELECT para o host.
Parâmetros
| Operação | Definir | Consulta | Notificação |
|---|---|---|---|
| Comando | MBIM_MS_SET_UICC_OPEN_CHANNEL | Não aplicável | Não aplicável |
| Resposta | MBIM_MS_UICC_OPEN_CHANNEL_INFO | Não aplicável | Não aplicável |
Consulta
Não aplicável.
Definir
O InformationBuffer do MBIM_COMMAND_MSG contém a estrutura de MBIM_MS_SET_UICC_OPEN_CHANNEL a seguir.
MBIM_MS_SET_UICC_OPEN_CHANNEL
| Deslocamento | Tamanho | Campo | Tipo | Descrição |
|---|---|---|---|---|
| 0 | 4 | AppIdSize | SIZE(0..32) | O tamanho da ID do aplicativo (AppId). |
| 4 | 4 | AppIdOffset | OFFSET | O deslocamento em bytes, calculado desde o início dessa estrutura, para uma matriz de bytes chamada AppId que define o AppId a ser SELECTed. |
| 8 | 4 | SelectP2Arg | UINT32(0..255) | O argumento P2 para o comando SELECT. |
| 12 | 4 | ChannelGroup | UINT32 | Um valor de marca que identifica o grupo de canais para este canal. |
| 16 | AppIdSize | DataBuffer | DATABUFFER | A matriz de bytes AppId . |
Resposta
O InformationBuffer de MBIM_COMMAND_DONE contém a estrutura de MBIM_MS_UICC_OPEN_CHANNEL_INFO a seguir.
MBIM_MS_UICC_OPEN_CHANNEL_INFO
| Deslocamento | Tamanho | Campo | Tipo | Descrição |
|---|---|---|---|---|
| 0 | 4 | Status | BYTE[2] | SW1 e SW2, nessa ordem de bytes. Para obter mais informações, consulte as anotações que seguem esta tabela. |
| 4 | 4 | Canal | UINT32(0..19) | O identificador de canal lógico. Se esse membro for 0, a operação falhará. |
| 8 | 4 | ResponseLength | SIZE(0..256) | O comprimento da resposta em bytes. |
| 12 | 4 | ResponseOffset | OFFSET | O deslocamento em bytes, calculado desde o início dessa estrutura, para uma matriz de bytes chamada Response que contém a resposta do SELECT. |
| 16 | - | DataBuffer | DATABUFFER | Os dados da matriz de bytes de resposta . |
Se o comando retornar MBIM_STATUS_MS_NO_LOGICAL_CHANNELS, o campo Status conterá as palavras UICC status SW1 e SW2 do comando MANAGE CHANNEL e os campos restantes serão zero. Se o comando retornar MBIM_STATUS_MS_SELECT_FAILED, o campo Status conterá as palavras UICC status SW1 e SW2 do comando SELECT e os campos restantes serão zero. Para qualquer outro status, o InformationBuffer estará vazio.
Eventos não solicitados
Não aplicável.
Códigos de status
Os seguintes códigos de status são aplicáveis:
| Código de status | Descrição |
|---|---|
| MBIM_STATUS_SUCCESS | O MBIM básico status conforme definido para todos os comandos. |
| MBIM_STATUS_BUSY | O MBIM básico status conforme definido para todos os comandos. |
| MBIM_STATUS_FAILURE | O MBIM básico status conforme definido para todos os comandos. |
| MBIM_STATUS_NO_DEVICE_SUPPORT | O MBIM básico status conforme definido para todos os comandos. |
| MBIM_STATUS_SIM_NOT_INSERTED | Não é possível executar a operação UICC porque a UICC está ausente. |
| MBIM_STATUS_BAD_SIM | Não é possível executar a operação UICC porque o UICC está em um estado de erro. |
| MBIM_STATUS_NOT_INITIALIZED | Não é possível executar a operação UICC porque o UICC ainda não foi totalmente inicializado. |
| MBIM_STATUS_MS_NO_LOGICAL_CHANNELS | Falha na abertura do canal lógico porque não há canais lógicos disponíveis na UICC (ele não dá suporte a eles ou todos eles estão em uso). |
| MBIM_STATUS_MS_SELECT_FAILED | O canal lógico aberto não foi bem-sucedido porque SELECT falhou. |
MBIM_CID_MS_UICC_CLOSE_CHANNEL
O host envia MBIM_CID_MS_UICC_CLOSE_CHANNEL para a função para fechar um canal lógico na UICC. O host pode especificar um número de canal ou pode especificar um grupo de canais.
Se o host especificar um número de canal, a função deverá marcar se esse canal foi aberto por um MBIM_CID_MS_UICC_OPEN_CHANNEL anterior. Nesse caso, ele deve enviar um comando MANAGE CHANNEL para o UICC para fechar o canal, retornar uma status de MBIM_STATUS_SUCCESS e retornar o SW1 SW2 do MANAGE CHANNEL. Caso contrário, ele não deve tomar nenhuma ação e retornar o status de falha MBIM_STATUS_MS_INVALID_LOGICAL_CHANNEL.
Se o host especificar um grupo de canais, a função determinará quais (se houver) canais lógicos foram abertos com esse grupo de canais e enviará um comando MANAGE CHANNEL para a UICC para cada canal desse tipo. Ele retorna uma status de MBIM_STATUS_SUCCESS com o SW1 SW2 do último MANAGE CHANNEL. Se nenhum canal tiver sido fechado, retornará 90 00.
Parâmetros
| Operação | Definir | Consulta | Notificação |
|---|---|---|---|
| Comando | MBIM_MS_SET_UICC_CLOSE_CHANNEL | Não aplicável | Não aplicável |
| Resposta | MBIM_MS_UICC_CLOSE_CHANNEL_INFO | Não aplicável | Não aplicável |
Consulta
Não aplicável.
Definir
O InformationBuffer de MBIM_COMMAND_MSG contém a estrutura de MBIM_MS_SET_UICC_CLOSE_CHANNEL a seguir.
MBIM_MS_SET_UICC_CLOSE_CHANNEL
| Deslocamento | Tamanho | Campo | Tipo | Descrição |
|---|---|---|---|---|
| 0 | 4 | Canal | UINT32(0..19) | Se diferente de zero, especifica o canal a ser fechado. Se zero, especifica que os canais associados ao ChannelGroup devem ser fechados. |
| 4 | 4 | ChannelGroup | UINT32 | Se Channel for zero, isso especificará um valor de marca e todos os canais com essa marca serão fechados. Se Channel não for zero, esse campo será ignorado. |
Resposta
O InformationBuffer de MBIM_COMMAND_DONE contém a estrutura de MBIM_MS_UICC_CLOSE_CHANNEL_INFO a seguir.
MBIM_MS_UICC_CLOSE_CHANNEL_INFO
| Deslocamento | Tamanho | Campo | Tipo | Descrição |
|---|---|---|---|---|
| 0 | 4 | Status | BYTE[2] | SW1 e SW2 do último MANAGE CHANNEL executado pela função em nome desse comando. |
Eventos não solicitados
Não aplicável.
Códigos de status
| Código de status | Descrição |
|---|---|
| MBIM_STATUS_SUCCESS | O MBIM básico status conforme definido para todos os comandos. |
| MBIM_STATUS_BUSY | O MBIM básico status conforme definido para todos os comandos. |
| MBIM_STATUS_FAILURE | O MBIM básico status conforme definido para todos os comandos. |
| MBIM_STATUS_NO_DEVICE_SUPPORT | O MBIM básico status conforme definido para todos os comandos. |
| MBIM_STATUS_SIM_NOT_INSERTED | Não é possível executar a operação UICC porque a UICC está ausente. |
| MBIM_STATUS_BAD_SIM | Não é possível executar a operação UICC porque o UICC está em um estado de erro. |
| MBIM_STATUS_NOT_INITIALIZED | Não é possível executar a operação UICC porque o UICC ainda não foi totalmente inicializado. |
| MBIM_STATUS_MS_INVALID_LOGICAL_CHANNEL | O número do canal lógico não é válido (em outras palavras, ele não foi aberto com MBIM_CID_MS_UICC_OPEN_CHANNEL). |
MBIM_CID_MS_UICC_APDU
O host usa MBIM_CID_MS_UICC_APDU para enviar uma APDU de comando para um canal lógico especificado na UICC e receber a resposta. A função MBIM deve garantir que o canal lógico foi aberto anteriormente com MBIM_CID_MS_UICC_OPEN_CHANNEL e falhar com status MBIM_STATUS_MS_INVALID_LOGICAL_CHANNEL se não fosse.
O host deve enviar uma APDU completa para a função. A APDU pode ser enviada com um valor de byte de classe definido na primeira definição de interindustry na seção 4 do padrão ISO/IEC 7816-4:2013 ou na definição estendida na Seção 10.1.1 da especificação técnica ETSI TS 102 221. A APDU pode ser enviada sem mensagens seguras ou com mensagens seguras. O cabeçalho de comando não autenticado. O host especifica o tipo de byte de classe, número de canal lógico e mensagens seguras junto com a APDU.
O primeiro byte do comando APDU é o byte de classe, codificado conforme definido pela seção 4 da especificação técnica ISO/IEC 7816-4:2013 ou da seção 10.1.1 da especificação técnica ETSI TS 102 221. O host pode enviar bytes de classe 0X, 4X, 6X, 8X, CX ou EX. No entanto, a função não passa esse byte diretamente para a UICC. Em vez disso, antes de enviar a APDU para o UICC, a função substituirá o primeiro byte do host por um novo byte de classe (codificado conforme definido pela seção 4 da especificação técnica ISO/IEC 7816-4:2013 ou da seção 10.1.1 da especificação técnica ETSI TS 102 221) com base no Tipo, Valores de canal e SecureMessaging especificados pelo host:
| Classe Byte | Descrição |
|---|---|
| 0X | 7816-4 interindustry, 1 <= channel <= 3, codifica a segurança em nibble baixo, se relevante |
| 4X | Interindustry 7816-4, 4 <= channel <= 19, sem mensagens seguras |
| 6X | 7816-4 interindustry, 4 <= channel <= 19, secure (cabeçalho não autenticado) |
| 8X | 102 221 estendido, 1<= canal <= 3, codifica a segurança em nibble baixo, se relevante |
| CX | 102 221 estendido, 4 <= canal <= 19, sem mensagens seguras |
| EX | 102 221 estendido, 4 <= canal <= 19, seguro (cabeçalho não autenticado) |
A função deve retornar o status, SW1 SW2 e resposta do UICC para o host.
Parâmetros
| Operação | Definir | Consulta | Notificação |
|---|---|---|---|
| Comando | MBIM_MS_SET_UICC_APDU | Não aplicável | Não aplicável |
| Resposta | MBIM_MS_UICC_APDU_INFO | Não aplicável | Não aplicável |
Consulta
Não aplicável.
Definir
O InformationBuffer do MBIM_COMMAND_MSG contém a seguinte estrutura de MBIM_MS_SET_UICC_APDU.
MBIM_MS_SET_UICC_APDU
| Deslocamento | Tamanho | Campo | Tipo | Descrição |
|---|---|---|---|---|
| 0 | 4 | Canal | UINT32(1..19) | Especifica o canal no qual a APDU será enviada. |
| 4 | 4 | SecureMessaging | MBIM_MS_UICC_SECURE_MESSAGING | Especifica se a APDU é trocada usando mensagens seguras. |
| 8 | 4 | Tipo | MBIM_MS_UICC_CLASS_BYTE_TYPE | Especifica o tipo de definição de bytes de classe. |
| 12 | 4 | CommandSize | UINT32(0..261) | O comprimento do comando em bytes. |
| 16 | 4 | CommandOffset | OFFSET | O deslocamento em bytes, calculado desde o início dessa estrutura, para uma matriz de bytes chamada Command que contém a APDU. |
| 20 | - | DataBuffer | DATABUFFER | A matriz de bytes command . |
A estrutura MBIM_MS_SET_UICC_APDU usa as estruturas de dados MBIM_MS_UICC_SECURE_MESSAGING e MBIM_MS_UICC_CLASS_BYTE_TYPE a seguir.
MBIM_MS_UICC_SECURE_MESSAGING
| Tipo | Valor | Descrição |
|---|---|---|
| MBIMMsUiccSecureMessagingNone | 0 | Sem mensagens seguras. |
| MBIMMsUiccSecureMessagingNoHdrAuth | 1 | Mensagens seguras, cabeçalho de comando não autenticado. |
MBIM_MS_UICC_CLASS_BYTE_TYPE
| Tipo | Valor | Descrição |
|---|---|---|
| MBIMMsUiccInterindustry | 0 | Definido de acordo com a primeira definição de interindustry na ISO 7816-4. |
| MBIMMsUiccExtended | 1 | Definido de acordo com a definição estendida no ETSI 102 221. |
Resposta
O InformationBuffer de MBIM_COMMAND_DONE contém a estrutura de MBIM_MS_UICC_APDU_INFO a seguir.
MBIM_MS_UICC_APDU_INFO
| Deslocamento | Tamanho | Campo | Tipo | Descrição |
|---|---|---|---|---|
| 0 | 4 | Status | BYTE[2] | As palavras SW1 e SW2 status resultantes do comando . |
| 4 | 4 | ResponseLength | SIZE | O comprimento da resposta em bytes. |
| 8 | 4 | ResponseOffset | OFFSET | O deslocamento em bytes, calculado desde o início dessa estrutura, para uma matriz de bytes chamada Resposta que contém a resposta do SELECT. |
| 12 | - | DataBuffer | DATABUFFER | A matriz de bytes de resposta . |
Eventos não solicitados
Não aplicável.
Códigos de status
Os seguintes códigos de status são aplicáveis:
| Código de status | Descrição |
|---|---|
| MBIM_STATUS_SUCCESS | O MBIM básico status conforme definido para todos os comandos. |
| MBIM_STATUS_BUSY | O MBIM básico status conforme definido para todos os comandos. |
| MBIM_STATUS_FAILURE | O MBIM básico status conforme definido para todos os comandos. |
| MBIM_STATUS_NO_DEVICE_SUPPORT | O MBIM básico status conforme definido para todos os comandos. |
| MBIM_STATUS_SIM_NOT_INSERTED | Não é possível executar a operação UICC porque o UICC está ausente. |
| MBIM_STATUS_BAD_SIM | Não é possível executar a operação UICC porque o UICC está em um estado de erro. |
| MBIM_STATUS_NOT_INITIALIZED | Não é possível executar a operação UICC porque o UICC ainda não foi totalmente inicializado. |
| MBIM_STATUS_MS_INVALID_LOGICAL_CHANNEL | O número do canal lógico não é válido (em outras palavras, ele não foi aberto com MBIM_CID_MS_UICC_OPEN_CHANNEL). |
Se a função puder enviar a APDU para a UICC, ela retornará MBIM_STATUS_SUCCESS juntamente com as palavras status SW1 SW2 e a resposta do UICC (se houver). O host deve examinar o status (SW1 SW2) para determinar se o comando APDU foi bem-sucedido na UICC ou o motivo pelo qual ele falhou.
MBIM_CID_MS_UICC_TERMINAL_CAPABILITY
O host envia MBIM_CID_MS_UICC_TERMINAL_CAPABILITY para informar o modem sobre os recursos do host. A APDU DE CAPACIDADE DE TERMINAL, especificada na Seção 11.1.19 da especificação técnica ETSI TS 102 221, deve ser enviada ao cartão antes que o primeiro aplicativo seja selecionado (se houver suporte). Portanto, o host não pode enviar diretamente a APDU DE CAPACIDADE DO TERMINAL, mas envia o comando MBIM_CID_MS_UICC_TERMINAL_CAPABILITY que contém um ou mais objetos de funcionalidade de terminal que seriam armazenados persistentemente pelo modem. No próximo cartão inserção ou redefinição, após o ATR, o modem selecionaria o MF e marcar se o TERMINAL CAPABILITY tem suporte. Nesse caso, o modem enviaria a APDU DE CAPACIDADE DE TERMINAL com as informações especificadas pelo comando MBIM_CID_MS_UICC_TERMINAL_CAPABILITY, bem como quaisquer informações geradas pelo modem.
Parâmetros
| Operação | Definir | Consulta | Notificação |
|---|---|---|---|
| Comando | MBIM_MS_SET_UICC_TERMINAL_CAPABILITY | Vazio | Não aplicável |
| Resposta | Não aplicável | MBIM_MS_TERMINAL_CAPABILITY_INFO | Não aplicável |
Consulta
O InformationBuffer será nulo e InformationBufferLength será zero.
Definir
O InformationBuffer de MBIM_COMMAND_MSG contém a estrutura de MBIM_MS_SET_UICC_TERMINAL_CAPABILITY a seguir.
MBIM_MS_SET_UICC_TERMINAL_CAPABILITY
| Deslocamento | Tamanho | Campo | Tipo | Descrição |
|---|---|---|---|---|
| 0 | 4 | ElementCount | UINT32 | A contagem de elementos de objetos de funcionalidade de terminal. |
| 4 | 8*EC | CapabilityList OL_PAIR_LIST | Uma lista de pares de comprimento de deslocamento para cada objeto de funcionalidade de terminal TLV. | |
| 4+8*EC | - | DataBuffer | DATABUFFER | Uma matriz de bytes das TLVs reais do objeto de funcionalidade do terminal. |
Resposta
As respostas conterão o comando SET exato com os últimos objetos de funcionalidade de terminal enviados para o modem. Portanto, MBIM_MS_TERMINAL_CAPABILITY_INFO é idêntica à MBIM_MS_SET_UICC_TERMINAL_CAPABILITY.
MBIM_MS_TERMINAL_CAPABILITY_INFO
| Deslocamento | Tamanho | Campo | Tipo | Descrição |
|---|---|---|---|---|
| 0 | 4 | ElementCount | UINT32 | A contagem de elementos de objetos de funcionalidade de terminal. |
| 4 | 8*EC | CapabilityList OL_PAIR_LIST | Uma lista de pares de comprimento de deslocamento para cada objeto de funcionalidade de terminal TLV. | |
| 4+8*EC | - | DataBuffer | DATABUFFER | Uma matriz de bytes das TLVs reais do objeto de funcionalidade do terminal. |
Eventos não solicitados
Não aplicável.
Códigos de status
| Código de status | Descrição |
|---|---|
| MBIM_STATUS_SUCCESS | O MBIM básico status conforme definido para todos os comandos. |
| MBIM_STATUS_BUSY | O MBIM básico status conforme definido para todos os comandos. |
| MBIM_STATUS_FAILURE | O MBIM básico status conforme definido para todos os comandos. |
| MBIM_STATUS_NO_DEVICE_SUPPORT | O MBIM básico status conforme definido para todos os comandos. |
| MBIM_STATUS_SIM_NOT_INSERTED | Não é possível executar a operação UICC porque o UICC está ausente. |
| MBIM_STATUS_BAD_SIM | Não é possível executar a operação UICC porque o UICC está em um estado de erro. |
| MBIM_STATUS_NOT_INITIALIZED | Não é possível executar a operação UICC porque o UICC ainda não foi totalmente inicializado. |
| MBIM_STATUS_MS_INVALID_LOGICAL_CHANNEL | O número do canal lógico não é válido (em outras palavras, ele não foi aberto com MBIM_CID_MS_UICC_OPEN_CHANNEL). |
MBIM_CID_MS_UICC_RESET
O host envia MBIM_CID_MS_UICC_RESET para a função MBIM para redefinir o UICC ou para consultar o estado de passagem da função.
Quando o host solicita que a função redefina o UICC, ele especifica uma ação de passagem.
Se o host especificar a ação de passagem MBIMMsUICCPassThroughEnable , a função redefinirá o UICC e, após a ativação da UICC, tratará o UICC como se estivesse em um modo de passagem que permite a comunicação entre o host e o UICC (mesmo que a UICC não tenha nenhum sistema de arquivos UICC de Telecomunicações). A função não envia APDUs para o cartão e não interfere em nenhum momento com a comunicação entre o host e a UICC.
Se o host especificar a ação de passagem MBIMMsUICCPassThroughDisable , a função redefinirá o UICC e, após a ativação da UICC, tratará a UICC como uma UICC de telecomunicações regular e espera que um sistema de arquivos UICC de telecomunicações esteja presente na UICC.
Quando o host consulta a função para determinar a passagem status, se a função responder com o status MBIMMsUICCPassThroughEnabled, isso significa que o modo de passagem está habilitado. Se a função responder com a status MBIMMsUICCPassThroughDisabled, isso significa que o modo de passagem está desabilitado.
Parâmetros
| Tipo | Definir | Consulta | Notificação |
|---|---|---|---|
| Comando | MBIM_MS_SET_UICC_RESET | Vazio | Não aplicável |
| Resposta | MBIM_MS_UICC_RESET_INFO | MBIM_MS_UICC_RESET_INFO | Não aplicável |
Consulta
O InformationBuffer será nulo e InformationBufferLength será zero.
Definir
MBIM_SET_MS_UICC_RESET
A estrutura MBIM_SET_MS_UICC_RESET contém a ação de passagem especificada pelo host.
| Deslocamento | Tamanho | Campo | Tipo | Descrição |
|---|---|---|---|---|
| 0 | 4 | PassThroughAction | MBIM_MS_UICC_PASSTHROUGH_ACTION | Para obter mais informações, consulte MBIM_MS_UICC_PASSTHROUGH_ACTION. |
MBIM_MS_UICC_PASSTHROUGH_ACTION
A enumeração MBIM_MS_UICC_PASSTHROUGH_ACTION define os tipos de ações de passagem que o host pode especificar para a função MBIM.
| Tipos | Valor |
|---|---|
| MBIMMsUiccPassThroughDisable | 0 |
| MBIMMsUiccPassThroughEnable | 1 |
Resposta
MBIM_MS_UICC_RESET_INFO
A estrutura MBIM_MS_UICC_RESET_INFO contém a status de passagem da função MBIM.
| Deslocamento | Tamanho | Campo | Tipo | Descrição |
|---|---|---|---|---|
| 0 | 4 | PassThroughStatus | MBIM_MS_UICC_PASSTHROUGH_STATUS | Para obter mais informações, consulte MBIM_MS_UICC_PASSTHROUGH_STATUS. |
MBIM_MS_UICC_PASSTHROUGH_STATUS
A enumeração MBIM_MS_UICC_PASSTHROUGH_STATUS define os tipos de passagem status a função MBIM especifica ao host.
| Tipos | Valor |
|---|---|
| MBIMMsUiccPassThroughDisabled | 0 |
| MBIMMsUiccPassThroughEnabled | 1 |
Eventos não solicitados
Não aplicável.
Códigos de status
| Código de status | Descrição |
|---|---|
| MBIM_STATUS_SUCCESS | O MBIM básico status conforme definido para todos os comandos. |
| MBIM_STATUS_BUSY | O dispositivo está ocupado. |
| MBIM_STATUS_FAILURE | Falha na operação. |
| MBIM_STATUS_NO_DEVICE_SUPPORT | O dispositivo não dá suporte a essa operação. |
OID_WWAN_UICC_RESET
O equivalente de NDIS para MBIM_CID_MS_UICC_RESET é OID_WWAN_UICC_RESET.