ONDERSTEUNING VOOR MB SAR-platform

Overzicht

Specifieke absorptiesnelheid (SAR) is de mogelijkheid om het MBB radiozendervermogen te wijzigen in reactie op de nabijheid van de MBB-antenne aan de gebruiker. Oem's hebben traditioneel eigen oplossingen geïmplementeerd voor SAR. Hiervoor moet de OEM een apparaatserviceopdracht implementeren die alleen wordt geïdentificeerd tussen het stuurprogramma voor de gebruikersmodus (UMDF) en de modem, of vereist kernelmodusonderdelen om rechtstreeks met de modem te communiceren. Sommige OEM's hebben zelfs mogelijk een hybride oplossing waarbij ze zowel UMDF-modem- als kernelmodusmodemonderdelen hebben. Naarmate radiostralingsbewustzijn is toegenomen, introduceert het standaardiseren van de interface voor OEM-softwareonderdelen om de SAR-opdracht door te geven aan de modem de volgende voordelen:

1. OEM's kunnen zich verplaatsen naar onderdelen van de gebruikersmodus en het systeem stabieler maken, omdat fouten in de gebruikersmodus niet dodelijk zijn voor het systeem in vergelijking met de kernelmodus.
2. Windows biedt een platformstandaardinterface en vermindert de eigen implementatie van OEM's.
3. Services in het platform die willen profiteren van SAR, kunnen de informatie van de modem ophalen.

Vanaf Windows 10 versie 1703 biedt Windows ondersteuning voor het doorgeven van de SAR-configuratie en modemtransmissiestatus. Windows blijft de SAR-bedrijfslogica overlaten aan IHV's en OEM's om deze als een zelfonderscheidende factor te gebruiken, maar biedt een interface om het platform te stroomlijnen. Er zijn twee nieuwe NDIS-OID's en twee nieuwe MBIM-CID's gedefinieerd om deze interface te ondersteunen. Apparaten die willen profiteren van besturingssysteemondersteuning, moeten beide opdrachten implementeren.

Deze functie wordt ondersteund door twee nieuwe OID's en CID's toe te voegen. Voor IHV-partners die MBIM implementeren, hoeft alleen de CID-versie te worden ondersteund.

Notitie

In dit onderwerp wordt de interface voor IHV-partners gedefinieerd voor het implementeren van SAR-platformondersteuning in hun modemapparaatstuurprogramma's. Zie Een sar-toewijzingstabel aanpassenals u informatie zoekt over het aanpassen van de SAR-toewijzingstabel voor een apparaat.

Stroom

MB Interface Update voor SAR Platform-ondersteuning

Een MBIM-compatibel apparaat implementeert en rapporteert de volgende apparaatservice wanneer een query wordt uitgevoerd door CID_MBIM_DEVICE_SERVICES. De bestaande bekende services worden gedefinieerd in sectie 10.1 van de USB NCM MBIM 1.0-specificatie. Microsoft breidt dit uit om de volgende service te definiëren.

Servicenaam = Microsoft SAR Control

UUID = UUID_MS_SARControl

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

CID	Minimale versie van het besturingssysteem
MBIM_CID_MS_SAR_CONFIG	Windows 10, versie 1703
MBIM_CID_MS_TRANSMISSION_STATUS	Windows 10, versie 1703

MBIM_CID_MS_SAR_CONFIG

Beschrijving

Met deze opdracht stelt u informatie in of retourneert u gegevens over de SAR-back-off modus en het niveau van een MB-apparaat. Het MB-apparaat moet onmiddellijk op de SAR-terugopdracht reageren door de huidige zendkrachtlimieten te overschrijven en deze toe te passen op de zendende antennes. Als de SAR-configuratie van een antenne niet is gewijzigd door het besturingssysteem, moet deze de huidige instelling behouden. Als het besturingssysteem bijvoorbeeld antenne 1 instelt op SAR-back-off index 1, moet de configuratie van antenne 2 hetzelfde blijven zonder wijzigingen.

Het wordt verwacht voor apparaten die deze opdracht ondersteunen om Query te implementeren, zodat ze apparaatgegevens verstrekken aan het besturingssysteem en de bijbehorende clients. Voor de opdracht Set is het tussen de IHV en de OEM om te definiëren welke waarde van elk veld acceptabel is. De typische verwachting is dat de SAR-back-off index kan worden geconfigureerd voor alle antennes als een minimumbasislijn. Als een set-aanvraag wordt verzonden met velden die niet worden ondersteund door het apparaat, moet MBIM_STATUS_INVALID_PARAMETERS worden geretourneerd als de statuscode.

Na elke Query- of Set-respons moet de modem een MBIM_MS_SAR_CONFIG structuur retourneren die informatie bevat voor alle antennes op het apparaat dat is gekoppeld aan Mobile Broadband.

Vraag

De InformationBuffer op MBIM_COMMAND_MSG wordt niet gebruikt. MBIM_MS_SAR_CONFIG wordt geretourneerd in de InformationBuffer van MBIM_COMMAND_DONE.

Set

De InformationBuffer op MBIM_COMMAND_MSG bevat een MBIM_MS_SAR_CONFIG. MBIM_MS_SAR_CONFIG wordt geretourneerd in de InformationBuffer van MBIM_COMMAND_DONE.

Ongevraagde gebeurtenissen

Niet van toepassing.

Parameters

Operatie	Set	Vraag	Melding
Bevelen	MBIM_MS_SET_SAR_CONFIG	Niet van toepassing	Niet van toepassing
Antwoord	MBIM_MS_SAR_CONFIG	MBIM_MS_SAR_CONFIG	Niet van toepassing

Gegevensstructuren

Vraag

De informatiebuffer dient NULL te zijn en de informatiebufferlengte dient nul te zijn.

Set

De volgende MBIM_MS_SET_SAR_CONFIG structuur wordt gebruikt in de InformationBuffer.

Compensatie	Grootte	Veld	Type	Beschrijving
0	4	SARMode	MBIM_MS_SAR_CONTROL_MODE	Zie de tabel MBIM_MS_SAR_CONTROL_MODE voor meer informatie.
4	4	SARBackOffStatus	MBIM_MS_SAR_BACKOFF_STATE	Zie de tabel MBIM_MS_SAR_BACKOFF_STATE voor meer informatie. Als MBIM_MS_SAR_CONTROL_MODE is ingesteld op apparaatbeheer, kan het besturingssysteem dit veld niet instellen.
8	4	ElementCount (EC)	UINT32	Het aantal MBIM_MS_SAR_CONFIG structuren die volgen in de DataBuffer.
12	8 * EG	SARConfigStatusRefList	OL_PAIR_LIST	Het eerste element van het paar is een 4-byte offset, berekend vanaf het beginpunt (offset 0) van deze MBIM_MS_SET_SAR_CONFIG structuur, naar een MBIM_MS_SAR_CONFIG_STATE structuur. Zie de tabel MBIM_MS_SAR_CONFIG_STATE voor meer informatie. Het tweede element van het paar is een 4-bytegrootte van een aanwijzer naar de bijbehorende MBIM_MS_SAR_CONFIG_STATE structuur.
12 + (8 * EG)		DataBuffer	gegevensbuffer	Matrix van MBIM_MS_SAR_CONFIG_STATE structuren.

De volgende structuren worden gebruikt in de voorgaande tabel.

MBIM_MS_SAR_CONTROL_MODE geeft aan hoe de SAR-back-off mechanisme wordt beheerd.

Type	Waarde	Beschrijving
MBIMMsSARControlModeDevice	0	De sar-back-off mechanisme wordt rechtstreeks beheerd door het modemapparaat.
MBIMMsSARControlModeOS	1	Het SAR-back-off mechanisme wordt gecontroleerd en beheerd door het besturingssysteem.

MBIM_MS_SAR_BACKOFF_STATE beschrijft de status van SAR-vermindering.

Type	Waarde	Beschrijving
MBIMMsSARBackOffStatusDisabled	0	SAR back off is uitgeschakeld in het modem.
MBIMMsSARBackOffStatusEnabled	1	SAR-backoff is ingeschakeld in het modem.

MBIM_MS_SAR_CONFIG_STATE beschrijft de mogelijke configuratiestatussen voor SAR-uitstel voor antennes.

Compensatie	Grootte	Veld	Type	Beschrijving
0	4	SARAntennaIndex	UINT32	Een antenne-index die overeenkomt met het veld SARBackOffIndex in deze tabel. Het komt overeen met het antennenummer en wordt overgelaten aan OEM-implementatie om elke antenne op het apparaat te indexeren. Een index is geldig voor deze waarde. Als deze waarde is ingesteld op 0xFFFFFFFF in een opdracht instellen, moet de SARBackOffIndex- worden toegepast op alle antennes. Als deze waarde is ingesteld op 0xFFFFFFFF als antwoord, geeft dit aan dat SARBackOffIndex- wordt toegepast op alle antennes.
4	4	SARBAckOffIndex	UINT32	Een back-off-index die overeenkomt met de back-off-tabel die is gedefinieerd door de OEM- of modemleverancier. De tabel heeft afzonderlijke frequentiebanden en bijbehorende afbouwparameters.

Antwoord

De volgende MBIM_MS_SAR_CONFIG structuur wordt gebruikt in de InformationBuffer. MBIM_MS_SAR_CONFIG geeft de configuratie voor SAR op.

Compensatie	Grootte	Veld	Type	Beschrijving
0	4	SARMode	MBIM_MS_SAR_MODE	Zie de tabel MBIM_MS_SAR_CONTROL_MODE voor meer informatie.
4	4	SARBackOffStatus	MBIM_MS_SAR_BACKOFF_STATE	Zie de tabel MBIM_MS_SAR_BACKOFF_STATE voor meer informatie.
8	4	SARWifiIntegration	MBIM_MS_SAR_ WIFI_HARDWARE_INTEGRATION	Raadpleeg de tabel MBIM_MS_SAR_HARDWARE_WIFI_INTEGRATION voor meer informatie. Dit impliceert dat de Wi-Fi van het apparaat en Cellular SAR op de hardwarelaag is geïntegreerd en dat het apparaat automatisch SAR-controle voor beide radio's aanpast.
12	4	ElementCount (EC)	UINT32	Het aantal MBIM_MS_SAR_CONFIG_STATE-structuren die volgen in de DataBuffer.
16	8 * EG	SARConfigStatusRefList	OL_PAIR_LIST	Het eerste element van het paar is een 4-byte offset, berekend vanaf het begin (offset 0) van deze MBIM_MS_SAR_CONFIG-structuur, naar een MBIM_MS_SAR_CONFIG_STATE-structuur. Zie de tabel MBIM_MS_SAR_CONFIG_STATE voor meer informatie. Het tweede element van het paar is een grootte van 4 -byte van een aanwijzer naar de bijbehorende MBIM_MS_SAR_CONFIG_STATE-structuur.
16 + (8 * EG)		DataBuffer	gegevensbuffer	Matrix van MBIM_MS_SAR_CONFIG_STATE structuren.

De volgende structuur MBIM_MS_SAR_HARDWARE_WIFI_INTEGRATION wordt gebruikt in de voorgaande tabel. Hiermee wordt aangegeven of Wi-Fi en Cellular zijn geïntegreerd op hardwareniveau.

Type	Waarde	Beschrijving
MBIMMsSARWifiHardwareIntegrated	0	Wi-Fi en de SAR van de cellulaire modem zijn geïntegreerd in het apparaat.
MBIMMsSARWifiHardwareNotIntegrated	1	Wi-Fi en de mobiele netwerkmodem SAR is niet geïntegreerd in het apparaat.

Melding

Niet van toepassing.

Status codes

Foutcode	Beschrijving
MBIM_STATUS_SUCCESS	De aanvraag is verwerkt.
MBIM_STATUS_BUSY	Het apparaat is momenteel bezet.
MBIM_STATUS_FAILURE	De aanvraag is mislukt.
MBIM_STATUS_GEEN_APPARAATONDERSTEUNING	Het apparaat biedt geen ondersteuning voor deze opdracht.
MBIM_STATUS_ONGELDIGE_PARAMETERS	De bewerking is mislukt vanwege ongeldige parameters.
MBIM_STATUS_OPERATION_NOT_ALLOWED (bewerking niet toegestaan)	De bewerking is mislukt omdat de bewerking niet is toegestaan.

MBIM_CID_MS_TRANSMISSION_STATUS

Beschrijving

Deze opdracht wordt gebruikt om de melding van de modem in of uit te schakelen op de overdrachtsstatus. Het is een opdracht per uitvoerder, omdat elke uitvoerder een andere status van kanaalzender kan hebben. Een dual SIM-modem kan bijvoorbeeld een modem hebben op LTE en de andere op GSM. Tegelijkertijd kan het worden gebruikt om de overdrachtsstatus van de modem te bieden. Deze melding kan worden gebruikt voor clients die geïnteresseerd zijn in of de modem gegevens verzendt of niet. De modem moet op elk gewenst moment een melding geven wanneer er een begin- of eind van HET TX-verkeer is. Als de duty cycle te klein is en niet in real-time aan de host kan worden geleverd, kan de TX state gedurende de door een hysteresis-timer ingestelde tijd actief worden gehouden voordat deze een update van de status verzendt. Het kan bijvoorbeeld zijn dat er een korte burst van TX was en dat de modem de begin- en eindmelding niet op tijd kon leveren. Het modem moet een melding sturen wanneer het TX-verkeer begint en het TX-verkeer blijven bewaken tijdens de hysteresetimer. Als er binnen de periode van de timer geen TX-verkeer meer is gegenereerd, moet worden aangegeven dat TX-verkeer is beëindigd.

Dit is erg handig in scenario's waarbij zowel Wi-Fi als LTE zijn verbonden. Als zowel LTE als Wi-Fi zich in een uitzendstatus bevinden en nabijheid wordt gedetecteerd, kan het nodig zijn dat Wi-Fi terugtreedt. Als LTE niet in de transmissiestaat is, maar Wi-Fi wel, dan kan Wi-Fi mogelijk niet nodig zijn. Dit geldt voor algemene Wi-Fi/LTE-verbinding en scenario's voor mobiele hot spot.

Het Wi-Fi terugtrekmechanisme en de opdracht vallen buiten het bereik van deze specificatie.

OEM's die deze opdracht gebruiken, moeten op de hoogte zijn van de mogelijke invloed op de stroom, omdat de modem mogelijk altijd meldingen over verzendingen verzendt, inclusief verminderde energiestatussen. Het besturingssysteem staat standaard niet toe dat deze melding de AP wakker maakt tijdens modern stand-by om de energieprestaties te verbeteren.

Vraag

De InformationBuffer op MBIM_COMMAND_MSG wordt niet gebruikt. MBIM_MS_TRANSMISSION_STATUS_INFO wordt geretourneerd in de informatiebuffer van MBIM_COMMAND_DONE.

Set

De InformationBuffer op MBIM_COMMAND_MSG bevat MBIM_MS_SET_TRANSMISSION_STATUS. MBIM_MS_TRANSMISSION_STATUS_INFO wordt geretourneerd in de informatiebuffer van MBIM_COMMAND_DONE.

Ongevraagde gebeurtenissen

Ongevraagde gebeurtenissen bevatten MBIM_MS_TRANSMISSION_STATUS_INFO en worden verzonden wanneer er een wijziging is in de actieve over-the-air (OTA) kanalen. Als een modem bijvoorbeeld begon met het uploaden van pakketgegevens, zou het nodig zijn om uploadkanalen in te stellen bij gebruik van het datakanaal van het netwerk, zodat de gegevens kunnen worden geüpload. Hiermee wordt de melding geactiveerd die aan het besturingssysteem moet worden verstrekt.

Parameters

Operatie	Set	Vraag	Melding
Bevelen	MBIM_MS_SET_TRANSMISSION_STATUS	Niet van toepassing	Niet van toepassing
Antwoord	MBIM_MS_TRANSMISSION_STATUS_INFO	MBIM_MS_TRANSMISSION_STATUS_INFO	MBIM_MS_TRANSMISSION_STATUS_INFO

Gegevensstructuren

Vraag

De InformationBuffer op MBIM_COMMAND_MSG wordt niet gebruikt. MBIM_MS_TRANSMISSION_STATUS_INFO wordt geretourneerd in de informatiebuffer van MBIM_COMMAND_DONE.

Set

De volgende MBIM_MS_SET_TRANSMISSION_STATUS structuur wordt gebruikt in de InformationBuffer.

Compensatie	Grootte	Veld	Type	Beschrijving
0	4	Kanaalmelding	MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION	Zie de tabel MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION voor meer informatie.
4	4	HysteresisTimer	UINT32	De hysteresis-indicator die door de modem wordt gebruikt om te bepalen wanneer de MBIMMsTransmissionStateInactive naar de host verzonden moet worden. Deze waarde is de timer die de modem ziet als een continue no-transmit-activiteit voordat er een OFF-indicator naar de host wordt verzonden. Deze timer moet in seconden worden ingesteld, variërend van 1 seconde tot 5 seconden.

De volgende MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION structuur wordt gebruikt in de voorgaande tabel. Hiermee wordt aangegeven of modemkanaaltransmissie is uitgeschakeld of ingeschakeld.

Type	Waarde	Beschrijving
[Assuming it's a setting being disabled] MBIMMsTransmissieMeldingUitgeschakeld	0	Melding over de overdrachtsstatus van het modemkanaal is uitgeschakeld.
MBIMMsTransmissionNotificationEnabled	1	Melding over de overdrachtsstatus van het modemkanaal ingeschakeld.

Antwoord

De volgende MBIM_MS_TRANSMISSION_STATUS_INFO structuur wordt gebruikt voor het antwoord.

Compensatie	Grootte	Veld	Type	Beschrijving
0	4	Kanaalmelding	MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION	Zie de tabel MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION voor meer informatie.
4	4	Transmissiestatus	MBIM_MS_TRANSMISSION_STATUS	Zie de tabel MBIM_MS_TRANSMISSION_STATUS voor meer informatie. Dit geeft aan of de modem elke 5 seconden TX-verkeer heeft.
8	4	HysteresisTimer	UINT32	De hysteresis-indicator die door de modem wordt gebruikt om te bepalen wanneer de MBIMMsTransmissionStateInactive naar de host verzonden moet worden. Deze waarde is de timer die de modem ziet als een continue no-transmit-activiteit voordat er een OFF-indicator naar de host wordt verzonden. Deze timer moet in seconden worden ingesteld, variërend van 1 seconde tot 5 seconden.

De volgende MBIM_MS_TRANSMISSION_STATUS structuur wordt gebruikt in de voorgaande tabel. Het geeft aan of de modem elke 5 seconden TX-verkeer heeft.

Type	Waarde	Beschrijving
MBIMMsTransmissionStateInactive	0	De modem heeft zonder enige onderbreking van de overdracht continu geen gegevens verzonden gedurende de laatste HysteresisTimer-waarde.
MBIMMsTransmissionStateActive	1	De modem verzendt actief gegevens.

Melding

Zie de tabel MBIM_MS_TRANSMISSION_STATUS_INFO voor meer informatie.

Status codes

Foutcode	Beschrijving
MBIM_STATUS_SUCCESS	De aanvraag is verwerkt.
MBIM_STATUS_BUSY	Het apparaat is momenteel bezet.
MBIM_STATUS_FAILURE	De aanvraag is mislukt.
MBIM_STATUS_GEEN_APPARAATONDERSTEUNING	Het apparaat biedt geen ondersteuning voor deze opdracht.
MBIM_STATUS_ONGELDIGE_PARAMETERS	De bewerking is mislukt vanwege ongeldige parameters.
MBIM_STATUS_OPERATION_NOT_ALLOWED (bewerking niet toegestaan)	De bewerking is mislukt omdat de bewerking niet is toegestaan.

HLK-tests (Hardware Lab Kit)

Zie stappen voor het installeren van HLK-.

Maak in HLK Studio verbinding met het cellulaire modemstuurprogramma van het apparaat en voer de test uit: Win6_4.MB.GSM.Data.TestSAR.

Deze test bevat de volgende tests:

Testnaam	Beschrijving
QuerySarConfig	Met deze test wordt gecontroleerd of de test een query kan uitvoeren op SAR-configuraties.
SetSarConfig	Met deze test wordt gecontroleerd of de test SAR-configuraties kan instellen.
Status van Sar-transmissie opvragen	Deze test controleert of de SAR-overdrachtsstatus succesvol kan worden opgevraagd.
SetSarTransmissionStatus	Met deze test wordt gecontroleerd of de test de SAR-overdrachtsstatus kan instellen.

WinRT-API

MobileBroadbandSarManager

Logboekanalyse

Logboeken kunnen worden verzameld en gedecodeerd met behulp van deze instructies: MB logboeken verzamelen.

Belangrijke providers en bijbehorende trefwoorden

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

Trefwoorden voor filteren:

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

MobileBroadband WinRT WPP (56dd9c57-06cc-48ba-b123-876a6495ba13)

Trefwoorden voor filteren: MobileBroadbandSarManager

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

Trefwoorden voor filteren:

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

Zie ook

Een koppeltabel voor de specifieke absorptieverhouding (SAR) aanpassen