Freigeben über


MB SAR-Plattformunterstützung

Überblick

Spezifische Absorptionsrate (SAR) ist die Fähigkeit, die MBB-Funksenderleistung als Reaktion auf die Nähe der MBB-Antenne an den Benutzer zu ändern. Traditionell haben OEMs proprietäre Lösungen für SAR implementiert. Dies erfordert, dass der OEM einen Gerätedienstbefehl implementiert, der entweder nur zwischen dem Benutzermodustreiber (UMDF) und dem Modem identifiziert wird, oder die Kernelmoduskomponenten müssen direkt mit dem Modem interagieren. Einige OEMs verfügen möglicherweise sogar über eine Hybridlösung, bei der sowohl UMDF-Modem als auch Kernelmodusmodemkomponenten vorhanden sind. Da das Bewusstsein für Funkstrahlung zugenommen hat, bringt die Standardisierung der Schnittstelle für OEM-Softwarekomponenten zur Weitergabe des SAR-Befehls an das Modem folgende Vorteile:

  1. OEMs können zu Komponenten des Benutzermodus wechseln und das System stabiler machen, da Fehler im Benutzermodus im Vergleich zum Kernelmodus nicht schwerwiegend für das System sind.
  2. Windows bietet eine Plattformstandardschnittstelle und reduziert die proprietäre Implementierung von OEMs.
  3. Dienste in der Plattform, die SAR nutzen möchten, können die Informationen aus dem Modem abrufen.

Ab Windows 10, Version 1703, unterstützt Windows das Übergeben der SAR-Konfiguration und des Modemübertragungsstatus. Windows überlässt weiterhin die SAR-Geschäftslogik den IHVs und OEMs, damit sie sich dadurch selbst differenzieren können, bietet jedoch eine Schnittstelle zur Vereinfachung der Plattform. Zwei neue NDIS-OIDs und zwei neue MBIM CIDs wurden definiert, um diese Schnittstelle zu unterstützen. Geräte, die die Betriebssystemunterstützung nutzen möchten, müssen beide Befehle implementieren.

Dieses Feature wird durch Hinzufügen von zwei neuen OIDs und CIDs unterstützt. Für IHV-Partner, die MBIM implementieren, muss nur die CID-Version unterstützt werden.

Hinweis

In diesem Thema wird die Schnittstelle für IHV-Partner definiert, um die SAR-Plattformunterstützung in ihren Modemgerätetreibern zu implementieren. Wenn Sie nach Informationen zum Anpassen der SAR-Zuordnungstabelle für ein Gerät suchen, lesen Sie die Tabelle zur Anpassung der spezifischen Absorptionsrate (SAR).

Fließen

Flussdiagramm zur Veranschaulichung des SAR-Vorgangs.

MB-Schnittstellenupdate für SAR-Plattformunterstützung

Ein MBIM-kompatibles Gerät implementiert und meldet den folgenden Gerätedienst, wenn er von CID_MBIM_DEVICE_SERVICES abgefragt wird. Die vorhandenen bekannten Dienste sind in Abschnitt 10.1 der USB NCM MBIM 1.0-Spezifikation definiert. Microsoft erweitert dies, um den folgenden Dienst zu definieren.

Dienstname = Microsoft SAR Control

UUID = UUID_MS_SARControl

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

CID Mindestversion des Betriebssystems
MBIM_CID_MS_SAR_CONFIG Windows 10, Version 1703
MBIM_CID_MS_TRANSMISSION_STATUS Windows 10, Version 1703

MBIM_CID_MS_SAR_CONFIG

BESCHREIBUNG

Mit diesem Befehl werden Informationen über den SAR-Back-Off-Modus und die Ebene eines MB-Geräts festgelegt oder zurückgegeben. Das MB-Gerät muss sofort auf den SAR-Back-Off-Befehl reagieren, indem die aktuellen Sendestromgrenzwerte überschrieben und auf die Sendeantennen angewendet werden. Wenn die SAR-Konfiguration einer Antenne nicht vom Betriebssystem geändert wurde, sollte sie die aktuelle Einstellung beibehalten. Wenn das Betriebssystem beispielsweise die Antenne 1 so festlegt, dass sie dem SAR-Back-off-Index 1 entspricht, sollte die Konfiguration der Antenne 2 unverändert bleiben.

Es wird erwartet, dass Geräte, die den Befehl 'Query' unterstützen, diesen implementieren, um Geräteinformationen für das Betriebssystem und dessen Clients bereitzustellen. Für den Befehl "Festlegen" liegt er zwischen dem IHV und dem OEM, um zu definieren, welcher Wert jedes Felds akzeptabel ist. Die typische Erwartung besteht darin, dass der SAR Back off Index für alle Antennen als Mindestbasislinie konfigurierbar ist. Wenn eine Set-Anforderung mit Feldern gesendet wird, die vom Gerät nicht unterstützt werden, muss MBIM_STATUS_INVALID_PARAMETERS als Statuscode zurückgegeben werden.

Nach jeder Abfrage- oder Set-Antwort sollte das Modem eine MBIM_MS_SAR_CONFIG Struktur zurückgeben, die Informationen für alle Antennen auf dem Gerät enthält, das mit mobilem Breitband verbunden ist.

Abfrage

Der InformationBuffer für MBIM_COMMAND_MSG wird nicht verwendet. MBIM_MS_SAR_CONFIG wird im Informationspuffer von MBIM_COMMAND_DONE zurückgegeben.

Set

Der InformationBuffer in MBIM_COMMAND_MSG enthält ein MBIM_MS_SAR_CONFIG. MBIM_MS_SAR_CONFIG wird im InformationBuffer von MBIM_COMMAND_DONE zurückgegeben.

Unerwünschte Ereignisse

Nicht zutreffend.

Die Parameter

Vorgang Set Abfrage Benachrichtigung
Befehl MBIM_MS_SET_SAR_CONFIG Nicht anwendbar Nicht anwendbar
Antwort MBIM_MS_SAR_CONFIG MBIM_MS_SAR_CONFIG Nicht anwendbar

Datenstrukturen

Abfrage

Der InformationBuffer muss NULL sein, und "InformationBufferLength" muss null sein.

Set

Die folgende MBIM_MS_SET_SAR_CONFIG Struktur wird im InformationBuffer verwendet.

Offset Größe Feld Typ BESCHREIBUNG
0 4 SARMode MBIM_MS_SAR_CONTROL_MODE Weitere Informationen finden Sie in der MBIM_MS_SAR_CONTROL_MODE Tabelle.
4 4 SARBackOffStatus MBIM_MS_SAR_BACKOFF_STATE Weitere Informationen finden Sie in der MBIM_MS_SAR_BACKOFF_STATE Tabelle. Wenn MBIM_MS_SAR_CONTROL_MODE auf gerätegesteuert festgelegt ist, kann das Betriebssystem dieses Feld nicht festlegen.
8 4 ElementCount (EC) UINT32 Anzahl der MBIM_MS_SAR_CONFIG-Strukturen, die im DataBuffer folgen.
12 8 * EG SARConfigStatusRefList OL_PAIR_LIST Das erste Element des Paars ist ein 4-Byte-Offset, berechnet vom Anfang (Offset 0) dieser MBIM_MS_SET_SAR_CONFIG-Struktur auf eine MBIM_MS_SAR_CONFIG_STATE Struktur. Weitere Informationen finden Sie in der MBIM_MS_SAR_CONFIG_STATE Tabelle. Das zweite Element des Paars ist eine 4-Byte-Größe eines Zeigers auf die entsprechende MBIM_MS_SAR_CONFIG_STATE Struktur.
12 + (8 * EG) Datenpuffer Datenpuffer Feld von MBIM_MS_SAR_CONFIG_STATE Strukturen.

Die folgenden Strukturen werden in der vorherigen Tabelle verwendet.

MBIM_MS_SAR_CONTROL_MODE gibt an, wie der SAR-Back off-Mechanismus gesteuert wird.

Typ Wert BESCHREIBUNG
MBIMMsSARControlModeDevice 0 Der SAR-Backoff-Mechanismus wird direkt vom Modemgerät gesteuert.
MBIMMsSARControlModeOS 1 DER SAR-Back off-Mechanismus wird vom Betriebssystem gesteuert und verwaltet.

MBIM_MS_SAR_BACKOFF_STATE beschreibt den Zustand der SAR-Drosselung.

Typ Wert BESCHREIBUNG
MBIMMsSARBackOffStatusDeaktiviert 0 Der SAR Backoff ist im Modem deaktiviert.
MBIMMsSARBackOffStatusEnabled 1 SAR Back off ist im Modem aktiviert.

MBIM_MS_SAR_CONFIG_STATE beschreibt die möglichen Zustände für SAR-Backoff für die Antennen.

Offset Größe Feld Typ BESCHREIBUNG
0 4 SARAntennaIndex UINT32 Ein Antennenindex, der dem SARBackOffIndex-Feld in dieser Tabelle entspricht. Es entspricht der Antennennummer und bleibt der OEM-Implementierung überlassen, um jede Antenne auf dem Gerät zu indizieren. Jeder Index ist für diesen Wert gültig. Wenn dieser Wert auf 0xFFFFFFFF in einem Set-Befehl festgelegt ist, sollte der SARBackOffIndex auf alle Antennen angewendet werden. Wenn dieser Wert in Reaktion auf 0xFFFFFFFF festgelegt ist, gibt er an, dass SARBackOffIndex auf alle Antennen angewendet wird.
4 4 SARBAckOffIndex UINT32 Ein Back-off-Index, der der Back-off-Tabelle entspricht, die vom OEM oder Modemanbieter definiert wird. Die Tabelle enthält einzelne Bänder und zugeordnete Rückschalt-Parameter.

Antwort

Die folgende MBIM_MS_SAR_CONFIG Struktur ist im InformationBuffer zu verwenden. MBIM_MS_SAR_CONFIG gibt die Konfiguration für SAR an.

Offset Größe Feld Typ BESCHREIBUNG
0 4 SAR-Modus MBIM_MS_SAR_MODE Weitere Informationen finden Sie in der MBIM_MS_SAR_CONTROL_MODE Tabelle.
4 4 SARBackOffStatus MBIM_MS_SAR_BACKOFF_STATE Weitere Informationen finden Sie in der MBIM_MS_SAR_BACKOFF_STATE Tabelle.
8 4 SARWifiIntegration MBIM_MS_SAR_ WIFI_HARDWARE_INTEGRATION Weitere Informationen finden Sie in der MBIM_MS_SAR_HARDWARE_WIFI_INTEGRATION Tabelle. Dies impliziert, dass die Wi-Fi des Geräts und die Mobilfunk-SAR auf der Hardwareebene integriert sind und das Gerät die SAR-Steuerung für beide Funkgeräte automatisch anpasst.
12 4 ElementCount (EC) UINT32 Anzahl der MBIM_MS_SAR_CONFIG_STATE Strukturen, die im DataBuffer folgen.
16 8 * EG SARConfigStatusRefList OL_PAIR_LIST Das erste Element des Paars ist ein 4-Byte-Offset, berechnet vom Anfang (Offset 0) dieser MBIM_MS_SAR_CONFIG-Struktur bis zu einer MBIM_MS_SAR_CONFIG_STATE-Struktur. Weitere Informationen finden Sie in der MBIM_MS_SAR_CONFIG_STATE Tabelle. Das zweite Element des Paars ist ein Zeiger der Größe 4 -byte auf die entsprechende MBIM_MS_SAR_CONFIG_STATE-Struktur.
16 + (8 * EC) Datenpuffer Datenpuffer Anordnung von MBIM_MS_SAR_CONFIG_STATE Strukturen.

Die folgende MBIM_MS_SAR_HARDWARE_WIFI_INTEGRATION Struktur wird in der vorherigen Tabelle verwendet. Es gibt an, ob Wi-Fi und Cellular auf Hardwareebene integriert sind.

Typ Wert BESCHREIBUNG
MBIMMsSAR-WiFi-Hardware-Integration 0 Wi-Fi und das SAR-Wert des Mobilfunkmodems ist in das Gerät integriert.
MBIMMsSARWifiHardwareNotIntegrated 1 Wi-Fi und Mobilfunkmodem-SAR ist nicht in das Gerät integriert.

Benachrichtigung

Nicht zutreffend.

Statuscodes

Fehlercode BESCHREIBUNG
MBIM_STATUS_SUCCESS Die Anforderung wurde erfolgreich verarbeitet.
MBIM_STATUS_BUSY Das Gerät ist zurzeit ausgelastet.
MBIM_STATUS_FAILURE Die Anforderung ist fehlgeschlagen.
MBIM_STATUS_NO_DEVICE_SUPPORT (Kein Gerätesupport) Dieses Gerät unterstützt diesen Befehl nicht.
MBIM_STATUS_UNGÜLTIGE_PARAMETER Fehler beim Vorgang aufgrund ungültiger Parameter.
MBIM_STATUS_OPERATION_NOT_ALLOWED Der Vorgang ist fehlgeschlagen, da er nicht zulässig ist.

MBIM_CID_MS_TRANSMISSION_STATUS

BESCHREIBUNG

Dieser Befehl wird verwendet, um die Benachrichtigung vom Modem beim Übertragungszustand zu aktivieren oder zu deaktivieren. Es handelt sich um einen Befehl pro Executor, da jeder Executor einen anderen Kanalübertragungsstatus aufweisen kann. Beispielsweise könnte ein Dual-SIM-Modem eins auf LTE und die andere auf GSM haben. Gleichzeitig kann es verwendet werden, um den Übertragungsstatus des Modems bereitzustellen. Diese Benachrichtigung kann für Clients verwendet werden, die daran interessiert sind, ob das Modem Daten überträgt oder nicht. Das Modem sollte jederzeit eine Benachrichtigung bereitstellen, wenn ein Start oder Ende des TX-Datenverkehrs auftritt. Wenn der Zollzyklus zu klein ist und nicht in Echtzeit für den Host bereitgestellt werden kann, kann der TX-Zustand für eine festgelegte Zeit mit einem Hysterese-Timer aktiv gehalten werden, bevor er eine Aktualisierung des Zustands sendet. Als Beispiel könnte es sein, dass es einen kurzen TX-Ausbruch gab und das Modem das Start- und Endsignal nicht rechtzeitig bereitstellen konnte. Das Modem sollte eine Benachrichtigung senden, wenn der TX-Datenverkehr startet, und den TX-Datenverkehr während des Hysterese-Timers weiterhin überwachen. Wenn innerhalb des Zeitrahmens des Timers kein weiterer TX-Datenverkehr generiert wurde, sollte gemeldet werden, dass der TX-Datenverkehr beendet ist.

Dies ist sehr nützlich in Szenarien, in denen sowohl Wi-Fi als auch LTE verbunden sind. Wenn sowohl LTE als auch Wi-Fi in einem Sendezustand befinden und näherung erkannt wurde, kann Wi-Fi Back off erforderlich sein. Wenn LTE sich nicht im Übertragungszustand befindet, aber Wi-Fi es ist, ist möglicherweise ein Wi-Fi-Back-off nicht erforderlich. Dies gilt für allgemeine WLAN-/LTE-Verbindungen und mobile Hot Spot-Szenarien.

Der Wi-Fi-Backoff-Mechanismus und -Befehl liegt außerhalb des Umfangs dieser Spezifikation.

OEMs, die diesen Befehl verwenden, sollten sich der potenziellen Auswirkungen auf die Leistung bewusst sein, da das Modem übertragungsbezogene Benachrichtigungen jederzeit senden kann, einschließlich reduzierter Leistungszustände. Das Betriebssystem lässt diese Benachrichtigung standardmäßig nicht zu, die AP während des modernen Standbymodus zu wecken, um die Leistung zu verbessern.

Abfrage

Der InformationBuffer für MBIM_COMMAND_MSG wird nicht verwendet. MBIM_MS_TRANSMISSION_STATUS_INFO wird im InformationBuffer von MBIM_COMMAND_DONE zurückgegeben.

Set

Der Informationspuffer für MBIM_COMMAND_MSG enthält MBIM_MS_SET_TRANSMISSION_STATUS. MBIM_MS_TRANSMISSION_STATUS_INFO wird im InformationBuffer von MBIM_COMMAND_DONE zurückgegeben.

Unerwünschte Ereignisse

Unaufgeforderte Ereignisse enthalten MBIM_MS_TRANSMISSION_STATUS_INFO und werden gesendet, wenn es eine Änderung an den aktiven Over-the-Air-Kanälen (OTA) gibt. Wenn beispielsweise ein Modem mit dem Hochladen von Paketdaten begonnen hat, wäre es erforderlich, uplink-Kanäle einzurichten, wenn er den Netzwerkdatenkanal verwendet, damit er Nutzlasten hochladen kann. Dadurch würde die Benachrichtigung ausgelöst, die dem Betriebssystem bereitgestellt wird.

Die Parameter

Vorgang Set Abfrage Benachrichtigung
Befehl MBIM_MS_SET_TRANSMISSION_STATUS Nicht anwendbar Nicht anwendbar
Antwort MBIM_MS_TRANSMISSION_STATUS_INFO MBIM_MS_TRANSMISSION_STATUS_INFO MBIM_MS_TRANSMISSION_STATUS_INFO

Datenstrukturen

Abfrage

Der InformationBuffer für MBIM_COMMAND_MSG wird nicht verwendet. MBIM_MS_TRANSMISSION_STATUS_INFO wird im InformationBuffer von MBIM_COMMAND_DONE zurückgegeben.

Set

Die folgende MBIM_MS_SET_TRANSMISSION_STATUS Struktur wird im InformationBuffer verwendet.

Offset Größe Feld Typ BESCHREIBUNG
0 4 Kanalbenachrichtigung MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION Weitere Informationen finden Sie in der MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION Tabelle.
4 4 HysteresisTimer UINT32 Ein Hystereseindikator, der vom Modem verwendet wird, um zu bestimmen, wann der MBIMMsTransmissionStateInactive an den Host gesendet werden soll. Dieser Wert ist der Timer, den das Modem als kontinuierliche No-Transmission-Aktivität sieht, bevor ein OFF-Indikator an den Host gesendet wird. Dieser Timer sollte in Sekunden festgelegt werden, von 1 Sekunde bis 5 Sekunden.

Die folgende MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION Struktur wird in der obigen Tabelle verwendet. Es gibt an, ob die Modemkanalübertragung deaktiviert oder aktiviert ist.

Typ Wert BESCHREIBUNG
MBIMMsTransmissionNotificationDisabled 0 Benachrichtigung über den Übertragungsstatus des Modemkanals deaktiviert.
MBIMMsTransmissionNotificationEnabled 1 Benachrichtigung über den Übertragungsstatus des Modemkanals aktiviert.

Antwort

Die folgende MBIM_MS_TRANSMISSION_STATUS_INFO Struktur wird für die Antwort verwendet.

Offset Größe Feld Typ BESCHREIBUNG
0 4 Kanalbenachrichtigung MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION Weitere Informationen finden Sie in der MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION Tabelle.
4 4 Übertragungsstatus MBIM_MS_TRANSMISSION_STATUS Weitere Informationen finden Sie in der MBIM_MS_TRANSMISSION_STATUS Tabelle. Dies gibt an, ob das Modem alle 5 Sekunden TX-Datenverkehr hat.
8 4 HysteresisTimer UINT32 Ein Hystereseindikator, der vom Modem verwendet wird, um zu bestimmen, wann der MBIMMsTransmissionStateInactive an den Host gesendet werden soll. Dieser Wert ist der Timer, den das Modem als kontinuierliche No-Transmission-Aktivität sieht, bevor ein OFF-Indikator an den Host gesendet wird. Dieser Timer sollte in Sekunden festgelegt werden, von 1 Sekunde bis 5 Sekunden.

Die folgende MBIM_MS_TRANSMISSION_STATUS Struktur wird in der vorherigen Tabelle verwendet. Es gibt an, ob das Modem alle 5 Sekunden TX-Datenverkehr hat.

Typ Wert BESCHREIBUNG
MBIMMsTransmissionStateInactive 0 Das Modem hat in den letzten HysteresisTimer-Werten nicht aktiv Daten gesendet, ohne dabei kontinuierlich zu übertragen.
MBIMMsTransmissionStateActive 1 Das Modem wurde aktiv Daten übertragen.

Benachrichtigung

Weitere Informationen finden Sie in der MBIM_MS_TRANSMISSION_STATUS_INFO Tabelle.

Statuscodes

Fehlercode BESCHREIBUNG
MBIM_STATUS_SUCCESS Die Anforderung wurde erfolgreich verarbeitet.
MBIM_STATUS_BUSY Das Gerät ist zurzeit ausgelastet.
MBIM_STATUS_FAILURE Die Anforderung ist fehlgeschlagen.
MBIM_STATUS_NO_DEVICE_SUPPORT (Kein Gerätesupport) Dieses Gerät unterstützt diesen Befehl nicht.
MBIM_STATUS_UNGÜLTIGE_PARAMETER Fehler beim Vorgang aufgrund ungültiger Parameter.
MBIM_STATUS_OPERATION_NOT_ALLOWED Der Vorgang ist fehlgeschlagen, da er nicht zulässig ist.

Hardware Lab Kit (HLK)-Tests

Siehe Schritte zur Installation von HLK.

Stellen Sie in HLK Studio eine Verbindung mit dem Mobilfunkmodemtreiber des Geräts her, und führen Sie den Test aus: Win6_4.MB. GSM. Data.TestSAR.

Dieser Test enthält die folgenden Tests:

Testname BESCHREIBUNG
QuerySarConfig Dieser Test überprüft, ob der Test SAR-Konfigurationen erfolgreich abfragen kann.
SetSarConfig Dieser Test überprüft, ob der Test SAR-Konfigurationen erfolgreich festlegen kann.
QuerySarTransmissionStatus Dieser Test überprüft, ob der Test den SAR-Übertragungsstatus erfolgreich abfragen kann.
SetzeSarÜbertragungsStatus Dieser Test überprüft, ob der Test den SAR-Übertragungsstatus erfolgreich festlegen kann.

WinRT-API

MobileBroadbandSarManager

Protokollanalyse

Protokolle können mithilfe dieser Anweisungen gesammelt und decodiert werden: MB Sammeln von Protokollen.

Wichtige Anbieter und entsprechende Schlüsselwörter

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

Schlüsselwörter zum Filtern:

  1. SarConfig
  2. CWwanSar::OnNdisNotification
  3. LoadSemiStaticOEMSARTable
  4. AttemptAutoConfigureSAR
  5. PreCheckSemiStaticOEM-SAR-Tabelle
  6. WwanIntfOpcodeSarConfig
  7. WwanIntfOpcodeSarÜbertragungsstatus
  8. WwanMsmEventTypeSarConfig
  9. WwanMsmEventTypeSarTransmissionStatus

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

Schlüsselwörter zum Filtern: MobileBroadbandSarManager

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

Schlüsselwörter zum Filtern:

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

Siehe auch

Anpassen einer Zuordnungstabelle für spezifische Absorptionsrate (SAR)