Suporte à plataforma MB SAR
Visão geral
A SAR (taxa de absorção) específica é a capacidade de alterar a potência do transmissor de rádio MBB em reação à proximidade da antena MBB com o usuário. Tradicionalmente, os OEMs implementam soluções proprietárias para SAR. Isso exige que o OEM implemente um comando de serviço de dispositivo que seja identificado apenas entre o UMDF (Driver de Modo de Usuário) e o modem ou exija que os componentes do modo kernel interajam diretamente com o modem. Alguns OEMs podem até ter uma solução híbrida em que têm componentes modem umDF e modem de kernel. À medida que a conscientização da radiação de rádio aumentou, padronizar a interface para componentes de software OEM passarem pelo comando SAR para o modem apresenta os seguintes benefícios:
- Os OEMs podem se mover em direção aos componentes do modo de usuário e tornam o sistema mais estável, pois os erros no modo de usuário não são fatais para o sistema em comparação com o modo kernel.
- O Windows fornece uma interface padrão de plataforma e reduz a implementação proprietária de OEMs.
- Os serviços na plataforma que desejam aproveitar o SAR podem recuperar as informações do modem.
A partir do Windows 10, versão 1703, o Windows dá suporte à passagem pela configuração sar e transmissão de modem status. O Windows continuará deixando a lógica de negócios sar para IHVs e OEMs para usar como um fator auto-diferencial, mas fornecerá uma interface para simplificar a plataforma. Dois novos OIDs do NDIS e dois novos CIDs do MBIM foram definidos para dar suporte a essa interface. Os dispositivos que desejam aproveitar o suporte ao sistema operacional devem implementar ambos os comandos.
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.
Observação
Este tópico define a interface para parceiros IHV implementarem o suporte à plataforma SAR em seus drivers de dispositivo de modem. Se você estiver procurando informações sobre como personalizar a tabela de mapeamento SAR de um dispositivo, consulte Personalizar uma tabela de mapeamento sar (taxa de absorção) específica.
Flow
Atualização de interface MB para suporte à plataforma SAR
Um dispositivo compatível com MBIM implementa e relata o seguinte serviço de dispositivo quando consultado por CID_MBIM_DEVICE_SERVICES. Os serviços conhecidos existentes são definidos na seção 10.1 da especificação USB NCM MBIM 1.0. A Microsoft estende isso para definir o serviço a seguir.
Nome do Serviço = Controle de SAR da Microsoft
UUID = UUID_MS_SARControl
Valor UUID = 68223D04-9F6C-4E0F-822D-28441FB72340
| CID | Versão mínima do sistema operacional |
|---|---|
| MBIM_CID_MS_SAR_CONFIG | Windows 10, versão 1703 |
| MBIM_CID_MS_TRANSMISSION_STATUS | Windows 10, versão 1703 |
MBIM_CID_MS_SAR_CONFIG
Description
Esse comando define ou retorna informações sobre o modo e o nível de retirada do SAR de um dispositivo MB. O dispositivo MB deve agir no comando de retirada sar imediatamente substituindo os limites de energia de transmissão atuais e aplicando-os às antenas emissoras. Se a configuração de SAR de uma antena não tiver sido alterada pelo sistema operacional, ela deverá manter sua configuração atual. Por exemplo, se o sistema operacional definir que a antena 1 seja SAR de volta do índice 1, a configuração da antena 2 deverá ser mantida da mesma forma sem nenhuma alteração.
Espera-se que os dispositivos que dão suporte a esse comando implementem a Consulta para que forneçam informações do dispositivo para o sistema operacional e seus clientes. Para o comando Set, é entre o IHV e o OEM para definir qual valor de cada campo é aceitável. A expectativa típica é que o índice de retirada do SAR seja configurável para todas as antenas como uma linha de base mínima. Se uma solicitação Set for enviada com campos que não são compatíveis com o dispositivo, MBIM_STATUS_INVALID_PARAMETERS deverá ser retornado como o código status.
Após cada consulta ou definir resposta, o modem deve retornar uma estrutura MBIM_MS_SAR_CONFIG que contém informações para todas as antenas no dispositivo associado à Banda Larga Móvel.
Consulta
O InformationBuffer no MBIM_COMMAND_MSG não é usado. MBIM_MS_SAR_CONFIG é retornado no InformationBuffer de MBIM_COMMAND_DONE.
Definir
O InformationBuffer no MBIM_COMMAND_MSG contém um MBIM_MS_SAR_CONFIG. MBIM_MS_SAR_CONFIG é retornado no InformationBuffer de MBIM_COMMAND_DONE.
Eventos não solicitados
Não aplicável.
Parâmetros
| Operação | Definir | Consulta | Notificação |
|---|---|---|---|
| Comando | MBIM_MS_SET_SAR_CONFIG | Não aplicável | Não aplicável |
| Resposta | MBIM_MS_SAR_CONFIG | MBIM_MS_SAR_CONFIG | Não aplicável |
estruturas de dados
Consulta
O InformationBuffer será NULL e InformationBufferLength será zero.
Definir
A estrutura de MBIM_MS_SET_SAR_CONFIG a seguir deve ser usada no InformationBuffer.
| Deslocamento | Tamanho | Campo | Type | Descrição |
|---|---|---|---|---|
| 0 | 4 | SARMode | MBIM_MS_SAR_CONTROL_MODE | Para obter mais informações, consulte a tabela MBIM_MS_SAR_CONTROL_MODE. |
| 4 | 4 | SARBackOffStatus | MBIM_MS_SAR_BACKOFF_STATE | Para obter mais informações, consulte a tabela MBIM_MS_SAR_BACKOFF_STATE. Se MBIM_MS_SAR_CONTROL_MODE estiver definido como controlado pelo dispositivo, o sistema operacional não poderá definir esse campo. |
| 8 | 4 | ElementCount (EC) | UINT32 | Contagem de estruturas de MBIM_MS_SAR_CONFIG que seguem no DataBuffer. |
| 12 | 8 * EC | SARConfigStatusRefList | OL_PAIR_LIST | O primeiro elemento do par é um deslocamento de 4 bytes, calculado desde o início (deslocamento 0) dessa estrutura MBIM_MS_SET_SAR_CONFIG até uma estrutura MBIM_MS_SAR_CONFIG_STATE. Para obter mais informações, consulte a tabela MBIM_MS_SAR_CONFIG_STATE. O segundo elemento do par é um tamanho de 4 bytes de um ponteiro para a estrutura de MBIM_MS_SAR_CONFIG_STATE correspondente. |
| 12 + (8 * EC) | DataBuffer | DATABUFFER | Matriz de estruturas de MBIM_MS_SAR_CONFIG_STATE. |
As estruturas a seguir são usadas na tabela anterior.
MBIM_MS_SAR_CONTROL_MODE especifica como o mecanismo de retirada sar é controlado.
| Type | Valor | Descrição |
|---|---|---|
| MBIMMsSARControlModeDevice | 0 | O mecanismo de retirada sar é controlado diretamente pelo dispositivo modem. |
| MBIMMsSARControlModeOS | 1 | O mecanismo de retirada de SAR é controlado e gerenciado pelo sistema operacional. |
MBIM_MS_SAR_BACKOFF_STATE descreve o estado de desativação do SAR.
| Type | Valor | Descrição |
|---|---|---|
| MBIMMsSARBackOffStatusDisabled | 0 | A retirada do SAR está desabilitada no modem. |
| MBIMMsSARBackOffStatusEnabled | 1 | A desativação do SAR está habilitada no modem. |
MBIM_MS_SAR_CONFIG_STATE descreve os estados possíveis para retirada sar para as antenas.
| Deslocamento | Tamanho | Campo | Type | Descrição |
|---|---|---|---|---|
| 0 | 4 | SARAntennaIndex | UINT32 | Um índice de antena que corresponde ao campo SARBackOffIndex nesta tabela. Ele corresponde ao número da antena e é deixado para a implementação do OEM para indexar cada antena no dispositivo. Qualquer índice é válido para esse valor. Se esse valor for definido como 0xFFFFFFFF em um comando Set , o SARBackOffIndex deverá ser aplicado a todas as antenas. Se esse valor for definido como 0xFFFFFFFF em resposta, ele indicará que SARBackOffIndex é aplicado a todas as antenas. |
| 4 | 4 | SARBAckOffIndex | UINT32 | Um índice de retirada que corresponde à tabela de retirada definida pelo fornecedor OEM ou modem. A tabela tem faixas individuais e parâmetros de retirada associados. |
Resposta
A estrutura de MBIM_MS_SAR_CONFIG a seguir deve ser usada no InformationBuffer. MBIM_MS_SAR_CONFIG especifica a configuração para SAR.
| Deslocamento | Tamanho | Campo | Type | Descrição |
|---|---|---|---|---|
| 0 | 4 | SARMode | MBIM_MS_SAR_MODE | Para obter mais informações, consulte a tabela MBIM_MS_SAR_CONTROL_MODE. |
| 4 | 4 | SARBackOffStatus | MBIM_MS_SAR_BACKOFF_STATE | Para obter mais informações, consulte a tabela MBIM_MS_SAR_BACKOFF_STATE. |
| 8 | 4 | SARWifiIntegration | MBIM_MS_SAR_ WIFI_HARDWARE_INTEGRATION | Para obter mais informações, consulte a tabela MBIM_MS_SAR_HARDWARE_WIFI_INTEGRATION. Isso implica que o Wi-Fi do dispositivo e o SAR da rede celular são integrados na camada de hardware e o dispositivo ajustará automaticamente o controle SAR para ambos os rádios. |
| 12 | 4 | ElementCount (EC) | UINT32 | Contagem de estruturas MBIM_MS_SAR_CONFIG_STATE que seguem no DataBuffer. |
| 16 | 8 * EC | SARConfigStatusRefList | OL_PAIR_LIST | O primeiro elemento do par é um deslocamento de 4 bytes, calculado desde o início (deslocamento 0) dessa estrutura MBIM_MS_SAR_CONFIG até uma estrutura MBIM_MS_SAR_CONFIG_STATE. Para obter mais informações, consulte a tabela MBIM_MS_SAR_CONFIG_STATE. O segundo elemento do par é um tamanho de 4 bytes de um ponteiro para a estrutura de MBIM_MS_SAR_CONFIG_STATE correspondente. |
| 16 + (8 * EC) | DataBuffer | DATABUFFER | Matriz de estruturas de MBIM_MS_SAR_CONFIG_STATE. |
A estrutura de MBIM_MS_SAR_HARDWARE_WIFI_INTEGRATION a seguir é usada na tabela anterior. Ele especifica se Wi-Fi e Celular estão integrados no nível do hardware.
| Type | Valor | Descrição |
|---|---|---|
| MBIMMsSARWifiHardwareIntegrated | 0 | Wi-Fi e o SAR do modem celular são integrados ao dispositivo. |
| MBIMMsSARWifiHardwareNotIntegrated | 1 | Wi-Fi e o SAR do modem celular não estão integrados ao dispositivo. |
Notificação
Não aplicável.
Códigos de status
| Código do Erro | Descrição |
|---|---|
| MBIM_STATUS_SUCCESS | A solicitação foi processada com êxito. |
| MBIM_STATUS_BUSY | No momento, o dispositivo está ocupado. |
| MBIM_STATUS_FAILURE | A solicitação falhou. |
| MBIM_STATUS_NO_DEVICE_SUPPORT | O dispositivo não dá suporte a esse comando. |
| MBIM_STATUS_INVALID_PARAMETERS | A operação falhou devido a parâmetros inválidos. |
| MBIM_STATUS_OPERATION_NOT_ALLOWED | A operação falhou porque a operação não é permitida. |
MBIM_CID_MS_TRANSMISSION_STATUS
Description
Esse comando é usado para habilitar ou desabilitar a notificação do modem no estado de transmissão. É um comando por executor, pois cada executor pode ter um estado de transmissão de canal diferente. Por exemplo, um modem de SIM duplo pode ter um no LTE e outro no GSM. Ao mesmo tempo, ele pode ser usado para fornecer o status de transmissão do modem. Essa notificação pode ser usada para clientes interessados em saber se o modem está transmitindo dados ou não. O modem deve fornecer notificação sempre que houver um início ou fim do tráfego TX. Se o ciclo de serviço for muito pequeno e não puder ser fornecido em tempo real para o host, o estado TX poderá ser mantido como ativo por um tempo definido com um temporizador de histerese antes de enviar uma atualização do estado. Por exemplo, pode ser que houve uma pequena intermitência de TX e o modem não pôde fornecer a notificação de início e término a tempo. O modem deve enviar notificação quando o tráfego TX é iniciado e deve continuar monitorando seu tráfego TX durante o temporizador de histerese. Se não houver mais tráfego TX gerado dentro do período de temporizador, ele deverá informar que o tráfego TX terminou.
Isso é muito útil em cenários em que Wi-Fi e LTE estão conectados. Se LTE e Wi-Fi estiverem em um estado de transmissão e a proximidade tiver sido detectada, Wi-Fi desativar poderá ser necessário. Se o LTE não estiver em estado de transmissão, mas Wi-Fi estiver, Wi-Fi desativar poderá não ser necessário. Isso se aplica a cenários gerais de conexão Wi-Fi/LTE e hot spot móvel.
O Wi-Fi mecanismo e o comando de desativação estão fora do escopo dessa especificação.
Os OEMs que usam esse comando devem estar cientes do possível impacto de energia, pois o modem pode estar enviando notificações relacionadas à transmissão o tempo todo, incluindo estados de energia reduzidos. O sistema operacional, por padrão, não permitirá que essa notificação ative a AP durante o Modo de Espera Moderno para melhorar o desempenho de energia.
Consulta
O InformationBuffer no MBIM_COMMAND_MSG não é usado. MBIM_MS_TRANSMISSION_STATUS_INFO é retornado no InformationBuffer de MBIM_COMMAND_DONE.
Definir
O InformationBuffer no MBIM_COMMAND_MSG contém MBIM_MS_SET_TRANSMISSION_STATUS. MBIM_MS_TRANSMISSION_STATUS_INFO é retornado no InformationBuffer de MBIM_COMMAND_DONE.
Eventos não solicitados
Os eventos não solicitados contêm MBIM_MS_TRANSMISSION_STATUS_INFO e são enviados quando há uma alteração nos canais ativos over-the-air (OTA). Por exemplo, se um modem começou a carregar dados de pacote, seria necessário configurar canais de uplink quando ele usa o canal de dados de rede para que ele possa carregar cargas. Isso dispararia a notificação a ser fornecida ao sistema operacional.
Parâmetros
| Operação | Definir | Consulta | Notificação |
|---|---|---|---|
| Comando | MBIM_MS_SET_TRANSMISSION_STATUS | Não aplicável | Não aplicável |
| Resposta | MBIM_MS_TRANSMISSION_STATUS_INFO | MBIM_MS_TRANSMISSION_STATUS_INFO | MBIM_MS_TRANSMISSION_STATUS_INFO |
estruturas de dados
Consulta
O InformationBuffer no MBIM_COMMAND_MSG não é usado. MBIM_MS_TRANSMISSION_STATUS_INFO é retornado no InformationBuffer de MBIM_COMMAND_DONE.
Definir
A estrutura de MBIM_MS_SET_TRANSMISSION_STATUS a seguir deve ser usada no InformationBuffer.
| Deslocamento | Tamanho | Campo | Type | Descrição |
|---|---|---|---|---|
| 0 | 4 | ChannelNotification | MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION | Para obter mais informações, consulte a tabela MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION. |
| 4 | 4 | HysteresisTimer | UINT32 | Indicador de Hissterese usado pelo modem para determinar quando enviar o MBIMMsTransmissionStateInactive para o host. Esse valor é o temporizador que o modem vê como uma atividade contínua sem transmissão antes de enviar um indicador OFF para o host. Esse temporizador deve ser definido em segundos, variando de 1 segundo a 5 segundos. |
A estrutura de MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION a seguir é usada na tabela anterior. Ele especifica se a transmissão de canal modem está desabilitada ou habilitada.
| Type | Valor | Descrição |
|---|---|---|
| MBIMMsTransmissionNotificationDisabled | 0 | Transmissão de canal modem status notificação desabilitada. |
| MBIMMsTransmissionNotificationEnabled | 1 | Transmissão de canal modem status notificação habilitada. |
Resposta
A estrutura de MBIM_MS_TRANSMISSION_STATUS_INFO a seguir é usada para resposta.
| Deslocamento | Tamanho | Campo | Type | Descrição |
|---|---|---|---|---|
| 0 | 4 | ChannelNotification | MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION | Para obter mais informações, consulte a tabela MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION. |
| 4 | 4 | TransmissionStatus | MBIM_MS_TRANSMISSION_STATUS | Para obter mais informações, consulte a tabela MBIM_MS_TRANSMISSION_STATUS. Isso indica se o modem tem tráfego TX a cada 5 segundos. |
| 8 | 4 | HysteresisTimer | UINT32 | Indicador de Histerese usado pelo modem para determinar quando enviar o MBIMMsTransmissionStateInactive para o host. Esse valor é o temporizador que o modem vê como uma atividade contínua sem transmissão antes de enviar um indicador OFF para hospedar. Esse temporizador deve ser definido em segundos, variando de 1 segundo a 5 segundos. |
A estrutura de MBIM_MS_TRANSMISSION_STATUS a seguir é usada na tabela anterior. Indica se o modem está tendo tráfego TX a cada 5 segundos.
| Type | Valor | Descrição |
|---|---|---|
| MBIMMsTransmissionStateInactive | 0 | O modem não estava transmitindo dados ativamente sem nenhum lapso contínuo de transmissão para o último valor HysteresisTimer. |
| MBIMMsTransmissionStateActive | 1 | O modem estava transmitindo dados ativamente. |
Notificação
Para obter mais informações, consulte a tabela MBIM_MS_TRANSMISSION_STATUS_INFO.
Códigos de status
| Código do Erro | Descrição |
|---|---|
| MBIM_STATUS_SUCCESS | A solicitação foi processada com êxito. |
| MBIM_STATUS_BUSY | O dispositivo está ocupado no momento. |
| MBIM_STATUS_FAILURE | A solicitação falhou. |
| MBIM_STATUS_NO_DEVICE_SUPPORT | O dispositivo não dá suporte a este comando. |
| MBIM_STATUS_INVALID_PARAMETERS | A operação falhou devido a parâmetros inválidos. |
| MBIM_STATUS_OPERATION_NOT_ALLOWED | A operação falhou porque a operação não é permitida. |
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.TestSAR.
Este teste contém os seguintes testes:
| Nome do teste | Description |
|---|---|
| QuerySarConfig | Esse teste verifica se o teste pode consultar com êxito as configurações de SAR. |
| SetSarConfig | Esse teste verifica se o teste pode definir com êxito as configurações de SAR. |
| QuerySarTransmissionStatus | Esse teste verifica se o teste pode consultar com êxito status de transmissão sar. |
| SetSarTransmissionStatus | Esse teste verifica se o teste pode definir com êxito status de transmissão sar. |
API do WinRT
Análise de Log
Os logs podem ser coletados e decodificados usando estas instruções: MB Coletando logs.
Provedores importantes e palavras-chave correspondentes
Microsoft-Windows-WWAN-SVC-EVENTS (3cb40aaa-1145-4fb8-b27b-7e30f0454316)
Palavras-chave para filtragem:
- SarConfig
- CWwanSar::OnNdisNotification
- LoadSemiStaticOEMSARTable
- AttemptAutoConfigureSAR
- PreCheckSemiStaticOEMSARTable
- WwanIntfOpcodeSarConfig
- WwanIntfOpcodeSarTransmissionStatus
- WwanMsmEventTypeSarConfig
- WwanMsmEventTypeSarTransmissionStatus
MobileBroadband WinRT WPP (56dd9c57-06cc-48ba-b123-876a6495ba13)
Palavras-chave para filtragem: MobileBroadbandSarManager
WwanProtDIM (3a07e1ba-3a6b-49bf-8056-c105b54dd7fb)
Palavras-chave para filtragem:
- NDIS_WWAN_SAR_CONFIG_INFO
- SarMode
- NDIS_WWAN_SAR_TRANSMISSION_STATUS_INFO
- HysteresisTimer
Consulte Também
Personalizar uma tabela de mapeamento sar (taxa de absorção) específica