Suporte à plataforma MB SAR

Visão geral

A Taxa de Absorção Específica (SAR) é a capacidade de alterar a potência do transmissor de rádio MBB em reação à proximidade da antena MBB do usuário. Tradicionalmente, os OEMs implementaram soluções proprietárias para SAR. Isso requer que o OEM implemente um comando de serviço de dispositivo que seja identificado apenas entre seu driver de modo de usuário (UMDF) e o modem ou requer que os componentes do modo kernel interajam diretamente com o modem. Alguns OEMs podem até ter uma solução híbrida, na qual possuem tanto componentes modem UMDF quanto modem de kernel-mode. À medida que a consciência da radiação de rádio aumentou, padronizar a interface para componentes de software OEM passarem pelo comando SAR para o modem introduz os seguintes benefícios:

1. Os OEMs podem se mover em direção aos componentes do modo de usuário e torna 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.
2. O Windows fornece uma interface padrão de plataforma e reduz a implementação proprietária de OEMs.
3. Os serviços na plataforma que desejam tirar proveito do SAR podem recuperar as informações do modem.

A partir do Windows 10, versão 1703, o Windows suporta a passagem pela configuração SAR e pelo estado de transmissão do modem. O Windows continuará a deixar a lógica de negócios SAR para IHVs e OEMs usarem como um fator de autodiferenciação, mas fornecerá uma interface para simplificar a plataforma. Dois novos NDIS OIDs e dois novos CIDs MBIM foram definidos para suportar esta interface. Os dispositivos que desejam aproveitar o suporte ao sistema operacional devem implementar ambos os comandos.

Este recurso é suportado pela adição de dois novos OIDs e CIDs. Para parceiros IHV que implementam o MBIM, apenas a versão CID precisa ser suportada.

Flow

Atualização da 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 bem conhecidos existentes são definidos na secção 10.1 da especificação USB NCM MBIM 1.0. A Microsoft estende isso para definir o seguinte serviço.

Nome do Serviço = Controle SAR Microsoft

UUID = UUID_MS_SARControl

Valor UUID = 68223D04-9F6C-4E0F-822D-28441FB72340

MBIM_CID_MS_SAR_CONFIG

Descrição

Este comando define ou retorna informações sobre o modo e o nível de redução SAR de um dispositivo MB. O dispositivo MB deve agir sobre o comando SAR back off imediatamente, substituindo os limites de potência de transmissão atuais e aplicando-os às antenas de transmissão. Se a configuração SAR de uma antena não foi alterada pelo sistema operacional, ele deve manter sua configuração atual. Por exemplo, se o sistema operacional define a antena 1 para ser SAR back off index 1, então a configuração da antena 2 deve ser mantida a mesma sem alterações.

Espera-se que os dispositivos que suportam este comando implementem o Query para que forneçam informações do dispositivo ao SO e aos seus clientes. Para o comando set, cabe ao IHV e ao OEM definir qual valor de cada campo é aceitável. A expectativa típica é que o índice de redução 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 suportados pelo dispositivo, MBIM_STATUS_INVALID_PARAMETERS deverá ser retornada como o código de status.

Após cada resposta a uma consulta ou configuração, o modem deve retornar uma estrutura MBIM_MS_SAR_CONFIG que contém informações para todas as antenas do dispositivo associado à Banda Larga Móvel.

Consulta

O InformationBuffer em MBIM_COMMAND_MSG não é usado. MBIM_MS_SAR_CONFIG é retornado no InformationBuffer de MBIM_COMMAND_DONE.

Conjunto

O InformationBuffer em 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

Estruturas de Dados

Consulta

O InformationBuffer deve ser NULL e InformationBufferLength deve ser zero.

Conjunto

A seguinte estrutura MBIM_MS_SET_SAR_CONFIG deve ser utilizada no InformationBuffer.

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

MBIM_MS_SAR_CONTROL_MODE especifica como o mecanismo de redução de SAR é controlado.

MBIM_MS_SAR_BACKOFF_STATE descreve o estado de recuo da SAR.

MBIM_MS_SAR_CONFIG_STATE descreve os estados possíveis para o recuo SAR das antenas.

Resposta

Deve ser utilizada a seguinte estrutura MBIM_MS_SAR_CONFIG no InformationBuffer. MBIM_MS_SAR_CONFIG especifica a configuração para SAR.

A seguinte estrutura MBIM_MS_SAR_HARDWARE_WIFI_INTEGRATION é usada na tabela anterior. Ele especifica se Wi-Fi e Cellular estão integrados no nível de hardware.

Notificação

Não aplicável.

Códigos de estado

MBIM_CID_MS_TRANSMISSION_STATUS

Descrição

Este comando é utilizado para ativar ou desativar 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 dual SIM pode ter um em LTE e outro em 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 trabalho for muito pequeno e não puder ser fornecido em tempo real ao host, o estado TX pode ser mantido ativo por um tempo definido com um temporizador de histerese antes de enviar uma atualização do estado. Como exemplo, pode ser que tenha havido uma pequena explosão de TX e o modem não possa fornecer a notificação de início e fim a tempo. O modem deve enviar uma notificação quando o tráfego TX for iniciado e deve continuar a monitorar seu tráfego TX durante o temporizador de histerese. Se não tiver sido gerado mais tráfego TX dentro do período de tempo do temporizador, ele deverá informar que o tráfego TX terminou.

Isso é muito útil em cenários onde Wi-Fi e LTE estão conectados. Se LTE e Wi-Fi estiverem num estado de transmissão e a proximidade for detetada, então poderá ser necessário um adiamento por parte de Wi-Fi. Se o LTE não estiver no estado de transmissão, mas o Wi-Fi estiver, o recuo de Wi-Fi pode não ser necessário. Isso se aplica a cenários gerais de conexão Wi-Fi/LTE e hot spot móvel.

O mecanismo e o comando "back off" Wi-Fi não estão incluídos no âmbito desta especificação.

Os OEMs que usam esse comando devem estar cientes do potencial impacto de energia, pois o modem pode estar enviando notificações relacionadas à transmissão o tempo todo, incluindo estados de energia reduzidos. O SO, por predefinição, não permitirá que esta notificação desperte o AP durante o Modo de Espera Moderno para melhorar o desempenho energético.

Consulta

O InformationBuffer em MBIM_COMMAND_MSG não é usado. MBIM_MS_TRANSMISSION_STATUS_INFO é retornado no InformationBuffer de MBIM_COMMAND_DONE.

Conjunto

O InformationBuffer em 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çasse a carregar dados de pacotes, seria necessário configurar canais de uplink quando ele usa o canal de dados de rede para que possa carregar cargas úteis. Isso acionaria a notificação a ser fornecida ao sistema operacional.

Parâmetros

Estruturas de Dados

Consulta

O InformationBuffer em MBIM_COMMAND_MSG não é usado. MBIM_MS_TRANSMISSION_STATUS_INFO é retornado no InformationBuffer de MBIM_COMMAND_DONE.

Conjunto

A seguinte estrutura MBIM_MS_SET_TRANSMISSION_STATUS deve ser utilizada no InformationBuffer.

A seguinte estrutura MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION é usada na tabela anterior. Ele especifica se a transmissão de canal de modem está desabilitada ou habilitada.

Resposta

A seguinte estrutura MBIM_MS_TRANSMISSION_STATUS_INFO é usada para resposta.

A seguinte estrutura MBIM_MS_TRANSMISSION_STATUS é usada na tabela anterior. Ele indica se o modem está tendo tráfego TX a cada 5 segundos.

Notificação

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

Códigos de estado

Testes do Hardware Lab Kit (HLK)

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:

WinRT API

MobileBroadbandSarManager

Análise de Log

Os registos podem ser recolhidos e decodificados usando estas Instruções: MB Recolha de Registos.

Fornecedores importantes e palavras-chave correspondentes

Microsoft-Windows-WWAN-SVC-EVENTS (3cb40aaa-1145-4fb8-b27b-7e30f0454316)

Palavras-chave para filtragem:

1. SarConfig
2. CWwanSar::OnNdisNotification
3. LoadSemiStaticOEMSARTable
4. AttemptAutoConfigureSAR
5. PreCheckSemiStaticOEMSARTable
6. WwanIntfOpcodeSarConfig
7. WwanIntfOpcodeSarTransmissionStatus
8. WwanMsmEventTypeSarConfig
9. WwanMsmEventTypeSarTransmissionStatus

Banda larga móvel WinRT WPP (56dd9c57-06cc-48ba-b123-876a6495ba13)

Palavras-chave para filtragem: MobileBroadbandSarManager

WwanProtDIM (3a07e1ba-3a6b-49bf-8056-c105b54dd7fb)

Palavras-chave para filtragem:

1. NDIS_WWAN_SAR_CONFIG_INFO
2. SarMode
3. NDIS_WWAN_SAR_TRANSMISSION_STATUS_INFO
4. HysteresisTimer

Ver também

Personalizar uma tabela de mapeamento de Taxa de Absorção Específica (SAR)