Udostępnij przez


Obsługa platformy SAR MB

Przegląd

Specyficzny współczynnik absorpcji (SAR) to możliwość zmiany mocy nadajnika radiowego MBB w reakcji na bliskość anteny MBB do użytkownika. Tradycyjnie producenci OEM zaimplementowali zastrzeżone rozwiązania dla SAR. Wymaga to od producenta OEM zaimplementowania polecenia usługi urządzenia, które jest rozpoznawane wyłącznie przez sterownik trybu użytkownika (UMDF) i modem lub wymaga, aby komponenty trybu jądra wchodziły bezpośrednio w interakcję z modemem. Niektórzy producenci OEM mogą nawet mieć rozwiązanie hybrydowe, w którym mają zarówno składniki modemu UMDF, jak i modemu w trybie jądra. Wraz ze wzrostem świadomości promieniowania radiowego standaryzacja interfejsu dla składników oprogramowania OEM w celu przekazania polecenia SAR do modemu wprowadza następujące korzyści:

  1. Producenci OEM mogą przechodzić w kierunku składników trybu użytkownika, co sprawia, że system jest bardziej stabilny, ponieważ błędy w trybie użytkownika nie są śmiertelne dla systemu w przeciwieństwie do trybu jądra.
  2. System Windows zapewnia standardowy interfejs platformy i ogranicza stosowanie zastrzeżonych implementacji przez OEM-ów.
  3. Usługi na platformie, które chcą korzystać z SAR, mogą pobierać informacje z modemu.

Począwszy od systemu Windows 10 w wersji 1703, system Windows obsługuje przechodzenie przez konfigurację SAR i stan transmisji modemu. System Windows będzie nadal pozostawiać logikę biznesową SAR producentom sprzętu (IHV) i producentom oryginalnego wyposażenia (OEM) do użycia jako czynnik wyróżniający, ale zapewni interfejs usprawniający platformę. Dwa nowe identyfikatory OID NDIS i dwa nowe identyfikatory CID MBIM zostały zdefiniowane w celu obsługi tego interfejsu. Urządzenia, które chcą korzystać z obsługi systemu operacyjnego, muszą implementować oba polecenia.

Ta funkcja jest obsługiwana przez dodanie dwóch nowych OID-ów i CID-ów. W przypadku partnerów IHV, którzy implementują MBIM, należy obsługiwać tylko wersję CID.

Uwaga / Notatka

W tym temacie zdefiniowano interfejs dla partnerów IHV w celu zaimplementowania obsługi platformy SAR w sterownikach urządzeń modemu. Jeśli szukasz informacji na temat dostosowywania tabeli mapowania SAR dla urządzenia, zobacz Dostosowywanie tabeli mapowania określonego współczynnika absorpcji (SAR).

Flow

Schemat blokowy ilustrujący operację SAR.

Aktualizacja interfejsu MB dla obsługi platformy SAR

Urządzenie zgodne z MBIM implementuje i zgłasza następującą usługę urządzenia podczas wykonywania zapytań przez CID_MBIM_DEVICE_SERVICES. Istniejące dobrze znane usługi są zdefiniowane w sekcji 10.1 specyfikacji USB NCM MBIM 1.0. Firma Microsoft rozszerza tę usługę, aby zdefiniować następującą usługę.

Nazwa usługi = Microsoft SAR Control

UUID = UUID_MS_SARControl

Wartość UUID = 68223D04-9F6C-4E0F-822D-28441FB72340

CID Minimalna wersja systemu operacyjnego
MBIM_CID_MS_SAR_CONFIG Windows 10, wersja 1703
MBIM_CID_MS_TRANSMISSION_STATUS Windows 10, wersja 1703

MBIM_CID_MS_SAR_CONFIG

Opis

To polecenie ustawia lub zwraca informacje o trybie redukcji oraz poziomie SAR urządzenia MB. Urządzenie MB musi natychmiast zareagować na polecenie redukcji SAR, zastępując bieżące limity mocy nadawania i stosując je do anten nadawczych. Jeśli konfiguracja SAR anteny nie została zmieniona przez system operacyjny, powinien zachować jego bieżące ustawienie. Jeśli na przykład system operacyjny ustawia antenę 1 na indeks SAR back off 1, konfiguracja anteny 2 powinna pozostać taka sama.

Oczekuje się, że urządzenia obsługujące to polecenie zaimplementują funkcję zapytania, aby dostarczać informacje o urządzeniu do systemu operacyjnego i jego klientów. Dla polecenia Set to IHV i OEM ustalają, która wartość każdego pola jest akceptowalna. Typowe oczekiwania polegają na tym, że indeks cofnięcia SAR można skonfigurować dla wszystkich anten jako minimalna linia bazowa. Jeśli żądanie ustawienia jest wysyłane z polami, które nie są obsługiwane przez urządzenie, MBIM_STATUS_INVALID_PARAMETERS musi zostać zwrócony jako kod stanu.

Po każdym zapytaniu lub operacji ustawienia modem powinien zwrócić strukturę MBIM_MS_SAR_CONFIG zawierającą informacje o wszystkich antenach na urządzeniu skojarzonym z technologią Mobile Broadband.

Zapytanie

Usługa InformationBuffer dla MBIM_COMMAND_MSG nie jest używana. MBIM_MS_SAR_CONFIG jest zwracana w MBIM_COMMAND_DONE InformationBuffer.

Ustawienie

Bufor informacji w MBIM_COMMAND_MSG zawiera MBIM_MS_SAR_CONFIG. MBIM_MS_SAR_CONFIG jest zwracany w buforze informacyjnym MBIM_COMMAND_DONE.

Zdarzenia niezamówione

Nie dotyczy.

Parametry

Operacja Ustawienie Zapytanie Powiadomienie
Komenda MBIM_MS_SET_SAR_CONFIG Nie dotyczy Nie dotyczy
Odpowiedź MBIM_MS_SAR_CONFIG MBIM_MS_SAR_CONFIG Nie dotyczy

Struktury danych

Zapytanie

Wartość InformationBuffer ma wartość NULL, a wartość InformationBufferLength wynosi zero.

Ustawienie

Następująca struktura MBIM_MS_SET_SAR_CONFIG powinna być użyta w InformationBuffer.

Przesunięcie Rozmiar (No changes needed) Typ Opis
0 4 SARMode MBIM_MS_SAR_CONTROL_MODE Aby uzyskać więcej informacji, zobacz tabelę MBIM_MS_SAR_CONTROL_MODE.
4 4 SARBackOffStatus MBIM_MS_SAR_BACKOFF_STATE Aby uzyskać więcej informacji, zobacz tabelę MBIM_MS_SAR_BACKOFF_STATE. Jeśli MBIM_MS_SAR_CONTROL_MODE ma być kontrolowana przez urządzenie, system operacyjny nie będzie mógł ustawić tego pola.
8 4 ElementCount (EC) UINT32 Liczba struktur MBIM_MS_SAR_CONFIG, które są zgodne z danymi DataBuffer.
12 8 * EC SARConfigStatusRefList OL_PAIR_LIST Pierwszym elementem pary jest 4-bajtowy offset, obliczany od początku (offset 0) struktury MBIM_MS_SET_SAR_CONFIG do struktury MBIM_MS_SAR_CONFIG_STATE. Aby uzyskać więcej informacji, zobacz tabelę MBIM_MS_SAR_CONFIG_STATE. Drugi element pary to 4-bajtowy rozmiar wskaźnika do odpowiedniej struktury MBIM_MS_SAR_CONFIG_STATE.
12 + (8 * EC) Bufor Danych DATABUFFER Tablica struktur MBIM_MS_SAR_CONFIG_STATE.

Poniższe struktury są używane w poprzedniej tabeli.

MBIM_MS_SAR_CONTROL_MODE określa sposób kontrolowania mechanizmu wycofywania SAR.

Typ Wartość Opis
MBIMsSARControlModeDevice 0 Mechanizm wycofywania SAR jest kontrolowany bezpośrednio przez urządzenie modemowe.
MBIMMsSARControlModeOS 1 Mechanizm wycofywania SAR jest kontrolowany i zarządzany przez system operacyjny.

MBIM_MS_SAR_BACKOFF_STATE opisuje stan cofania SAR.

Typ Wartość Opis
StanWycofaniaSARMBIMMNieaktywny 0 Funkcja redukcji mocy SAR jest wyłączona w modemie.
MBIMMsSARBackOffStatusWłączony 1 SAR back off jest włączony w modemie.

MBIM_MS_SAR_CONFIG_STATE opisuje możliwe stany wycofywania SAR dla anten.

Przesunięcie Rozmiar (No changes needed) Typ Opis
0 4 SARAntennaIndex UINT32 Indeks anteny, który odpowiada polu SARBackOffIndex w tej tabeli. Odpowiada numerowi anteny i pozostaje w implementacji producenta OEM, aby zaindeksować każdą antenę na urządzeniu. Każdy indeks jest prawidłowy dla tej wartości. Jeśli ta wartość jest ustawiona na 0xFFFFFFFF w poleceniu Set, parametr SARBackOffIndex należy zastosować do wszystkich anten. Jeśli ta wartość jest ustawiona na 0xFFFFFFFF w odpowiedzi, oznacza to, że właściwość SARBackOffIndex jest stosowana do wszystkich anten.
4 4 SARBAckOffIndex UINT32 Indeks wycofywania, który odpowiada tabeli wycofywania zdefiniowanej przez dostawcę OEM lub modemu. Tabela zawiera poszczególne pasma i powiązane parametry ograniczania.

Odpowiedź

Następującą strukturę MBIM_MS_SAR_CONFIG należy stosować w informacyjnym buforze. MBIM_MS_SAR_CONFIG określa konfigurację sar.

Przesunięcie Rozmiar (No changes needed) Typ Opis
0 4 SARMode MBIM_MS_SAR_MODE Aby uzyskać więcej informacji, zobacz tabelę MBIM_MS_SAR_CONTROL_MODE.
4 4 SARBackOffStatus MBIM_MS_SAR_BACKOFF_STATE Aby uzyskać więcej informacji, zobacz tabelę MBIM_MS_SAR_BACKOFF_STATE.
8 4 SARWifiIntegration MBIM_MS_SAR_WIFI_HARDWARE_INTEGRATION Aby uzyskać więcej informacji, zobacz tabelę MBIM_MS_SAR_HARDWARE_WIFI_INTEGRATION. Oznacza to, że Wi-Fi urządzenia i sieci komórkowej SAR są zintegrowane w warstwie sprzętowej, a urządzenie automatycznie dostosuje kontrolę SAR dla obu urządzeń radiowych.
12 4 ElementCount (EC) UINT32 Liczba struktur MBIM_MS_SAR_CONFIG_STATE, które następują w DataBuffer.
16 8 * EC SARConfigStatusRefList OL_PAIR_LIST Pierwszym elementem pary jest przesunięcie o 4 bajty, obliczane od początku (przesunięcie 0) struktury MBIM_MS_SAR_CONFIG, do struktury MBIM_MS_SAR_CONFIG_STATE. Aby uzyskać więcej informacji, zobacz tabelę MBIM_MS_SAR_CONFIG_STATE. Drugi element pary to wskaźnik o rozmiarze 4 -byte do odpowiedniej struktury MBIM_MS_SAR_CONFIG_STATE.
16 + (8 * EC) Bufor Danych DATABUFFER Tablica struktur MBIM_MS_SAR_CONFIG_STATE.

Poniższa struktura MBIM_MS_SAR_HARDWARE_WIFI_INTEGRATION jest używana w powyższej tabeli. Określa, czy Wi-Fi i sieć komórkowa są zintegrowane na poziomie sprzętowym.

Typ Wartość Opis
MBIMMsSARWifiHardwareIntegrated 0 Wi-Fi i modem komórkowy SAR jest zintegrowany z urządzeniem.
Sprzęt Wi-Fi nie zintegrowany MBIM SAR 1 Wi-Fi i SAR modemu komórkowego nie są zintegrowane z urządzeniem.

Powiadomienie

Nie dotyczy.

Kody stanu

Kod błędu Opis
MBIM_STATUS_SUKCES Żądanie zostało pomyślnie przetworzone.
MBIM_STATUS_BUSY Urządzenie jest obecnie zajęte.
MBIM_STATUS_FAILURE Żądanie nie powiodło się.
MBIM_STATUS_NO_DEVICE_SUPPORT (Brak wsparcia dla urządzenia) Urządzenie nie obsługuje tego polecenia.
MBIM_STATUS_NIEPRAWIDŁOWE_PARAMETRY Operacja nie powiodła się z powodu nieprawidłowych parametrów.
MBIM_STATUS_OPERATION_NOT_ALLOWED Operacja nie powiodła się, ponieważ operacja jest niedozwolona.

MBIM_CID_MS_TRANSMISSION_STATUS

Opis

To polecenie służy do włączania lub wyłączania powiadomienia z modemu w stanie transmisji. Jest to komenda dla każdego wykonawcy, ponieważ każdy z nich może mieć inny stan transmisji kanału. Na przykład podwójny modem SIM może mieć jeden na LTE, a drugi na GSM. Jednocześnie można go użyć do zapewnienia stanu transmisji modemu. To powiadomienie może być używane dla klientów, którzy są zainteresowani tym, czy modem przesyła dane, czy nie. Modem powinien podać powiadomienie w dowolnym momencie rozpoczęcia lub zakończenia ruchu TX. Jeśli cykl dyżurny jest zbyt mały i nie można go podać w czasie rzeczywistym do hosta, stan TX może być utrzymywany jako aktywny przez ustawiony czas przy użyciu czasomierza histerezy, zanim zostanie wysłana aktualizacja stanu. Na przykład może się okazać, że wystąpił krótki impuls TX, a modem nie mógł dostarczyć powiadomienia o rozpoczęciu i zakończeniu na czas. Modem powinien wysyłać powiadomienie, gdy ruch TX uruchamia się i powinien nadal go monitorować w trakcie działania czasomierza histerezy. Jeśli w przedziale czasowym czasomierza nie wygenerowano więcej ruchu TX, należy zgłosić, że ruch TX zakończył się.

Jest to bardzo przydatne w scenariuszach, w których zarówno Wi-Fi, jak i LTE są połączone. Jeśli zarówno LTE, jak i Wi-Fi są w stanie transmisji, a zbliżenie zostało wykryte, może być wymagane Wi-Fi wycofanie. Jeśli LTE nie jest w stanie transmisji, ale Wi-Fi jest, opóźnienie Wi-Fi może nie być konieczne. Dotyczy to ogólnych scenariuszy połączeń Wi-Fi/LTE i mobilnych punktów dostępu.

Mechanizm wycofania Wi-Fi i polecenie są poza zakresem tej specyfikacji.

Producenci OEM, którzy korzystają z tego polecenia, powinni mieć świadomość potencjalnego wpływu na zużycie energii, ponieważ modem może wysyłać powiadomienia związane z transmisją przez cały czas, w tym w stanach zmniejszonego zużycia energii. System operacyjny domyślnie nie zezwala na to powiadomienie, aby obudzić procesor aplikacyjny (AP) podczas modern standby w celu poprawy efektywności energetycznej.

Zapytanie

Usługa InformationBuffer dla MBIM_COMMAND_MSG nie jest używana. MBIM_MS_TRANSMISSION_STATUS_INFO jest zwracany w polu InformationBuffer komunikatu MBIM_COMMAND_DONE.

Ustawienie

InformationBuffer w MBIM_COMMAND_MSG zawiera MBIM_MS_SET_TRANSMISSION_STATUS. MBIM_MS_TRANSMISSION_STATUS_INFO jest zwracany w MBIM_COMMAND_DONE InformationBuffer.

Zdarzenia niezamówione

Niezamówione zdarzenia zawierają MBIM_MS_TRANSMISSION_STATUS_INFO i są wysyłane, gdy nastąpi zmiana aktywnych kanałów bezprzewodowych (OTA). Na przykład jeśli modem zaczął przekazywać dane pakietów, konieczne byłoby skonfigurowanie kanałów pasma, gdy używa kanału danych sieciowych, aby mógł przekazywać ładunki. Spowoduje to wyzwolenie powiadomienia, które ma zostać dostarczone do systemu operacyjnego.

Parametry

Operacja Ustawienie Zapytanie Powiadomienie
Komenda MBIM_MS_SET_TRANSMISSION_STATUS Nie dotyczy Nie dotyczy
Odpowiedź MBIM_MS_TRANSMISSION_STATUS_INFO MBIM_MS_TRANSMISSION_STATUS_INFO MBIM_MS_TRANSMISSION_STATUS_INFO

Struktury danych

Zapytanie

Usługa InformationBuffer dla MBIM_COMMAND_MSG nie jest używana. MBIM_MS_TRANSMISSION_STATUS_INFO jest zwracany w buforze informacyjnym MBIM_COMMAND_DONE.

Ustawienie

Następująca struktura MBIM_MS_SET_TRANSMISSION_STATUS powinna być używana w buforze informacyjnym.

Przesunięcie Rozmiar (No changes needed) Typ Opis
0 4 Powiadomienie kanału MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION Aby uzyskać więcej informacji, zobacz tabelę MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION.
4 4 HisterezaTimer UINT32 Wskaźnik histerezy używany przez modem do określenia, kiedy wysłać MBIMMsTransmissionStateInactive do hosta. Ta wartość to czasomierz, który modem interpretuje jako brak transmisji, zanim wyśle sygnał WYŁĄCZONY do hosta. Ten czasomierz powinien być ustawiony w sekundach, począwszy od 1 sekundy do 5 sekund.

Poniższa struktura MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION jest używana w poprzedniej tabeli. Określa, czy transmisja kanału modemu jest wyłączona, czy włączona.

Typ Wartość Opis
MBIMsTransmissionNotificationDisabled 0 Wyłączono powiadomienie o stanie transmisji kanału modemu.
MBIMsTransmissionNotificationEnabled 1 Włączono powiadomienie o stanie transmisji kanału modemu.

Odpowiedź

Następująca struktura MBIM_MS_TRANSMISSION_STATUS_INFO jest używana na potrzeby odpowiedzi.

Przesunięcie Rozmiar (No changes needed) Typ Opis
0 4 Powiadomienie kanału MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION Aby uzyskać więcej informacji, zobacz tabelę MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION.
4 4 TransmissionStatus MBIM_MS_TRANSMISSION_STATUS Aby uzyskać więcej informacji, zobacz tabelę MBIM_MS_TRANSMISSION_STATUS. Wskazuje to, czy modem ma ruch TX co 5 sekund.
8 4 HisterezaTimer UINT32 Wskaźnik histerezy używany przez modem do określenia, kiedy wysłać MBIMMsTransmissionStateInactive do hosta. Ta wartość to czasomierz, który modem postrzega jako ciągły brak aktywności nadawczej, zanim wyśle sygnał OFF do hosta. Ten czasomierz powinien być ustawiony w sekundach, począwszy od 1 sekundy do 5 sekund.

Poniższa struktura MBIM_MS_TRANSMISSION_STATUS jest używana w poprzedniej tabeli. Wskazuje, czy modem generuje ruch TX co 5 sekund.

Typ Wartość Opis
MBIMsTransmissionStateInactive 0 Modem nie przesyłał danych aktywnie bez przerwy w transmisji przez czas określony ostatnią wartością HysteresisTimer.
MBIMMsTransmissionStateActive 1 Modem aktywnie przesyłał dane.

Powiadomienie

Aby uzyskać więcej informacji, zobacz tabelę MBIM_MS_TRANSMISSION_STATUS_INFO.

Kody stanu

Kod błędu Opis
MBIM_STATUS_SUKCES Żądanie zostało pomyślnie przetworzone.
MBIM_STATUS_BUSY Urządzenie jest obecnie zajęte.
MBIM_STATUS_FAILURE Żądanie nie powiodło się.
MBIM_STATUS_NO_DEVICE_SUPPORT (Brak wsparcia dla urządzenia) Urządzenie nie obsługuje tego polecenia.
MBIM_STATUS_NIEPRAWIDŁOWE_PARAMETRY Operacja nie powiodła się z powodu nieprawidłowych parametrów.
MBIM_STATUS_OPERATION_NOT_ALLOWED (Operacja niedozwolona) Operacja nie powiodła się, ponieważ operacja jest niedozwolona.

Testy zestawu Hardware Lab Kit (HLK)

Zobacz Kroki dotyczące instalacji HLK.

W programie HLK Studio połącz się z sterownikiem modemu komórkowego urządzenia i uruchom test: Win6_4.MB. GSM. Data.TestSAR.

Ten test zawiera następujące testy:

Nazwa testu Opis
QuerySarConfig Ten test sprawdza, czy test może pomyślnie wykonywać zapytania dotyczące konfiguracji SAR.
SetSarConfig Ten test sprawdza, czy test może pomyślnie ustawić konfiguracje SAR.
QuerySarTransmissionStatus Ten test sprawdza, czy test może pomyślnie wysłać zapytanie o stan transmisji SAR.
SetSarTransmissionStatus Ten test sprawdza, czy test może pomyślnie ustawić stan transmisji SAR.

WinRT API

MobileBroadbandSarManager

Analiza dzienników

Dzienniki można zbierać i dekodować, korzystając z poniższych instrukcji: MB zbieranie dzienników.

Ważne dostawcy i odpowiadające im słowa kluczowe

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

Słowa kluczowe do filtrowania:

  1. SarConfig
  2. CWwanSar::OnNdisNotification
  3. WczytajPółStatycznąTabelęOEMSAR
  4. SpróbujAutomatycznieSkonfigurowaćSAR
  5. PreCheckSemiStaticOEMSARTable
  6. WwanIntfOpcodeSarConfig
  7. WwanIntfOpcodeSarTransmissionStatus
  8. WwanMsmEventTypeSarConfig
  9. WwanMsmEventTypeSarTransmissionStatus

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

Słowa kluczowe do filtrowania: MobileBroadbandSarManager

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

Słowa kluczowe do filtrowania:

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

Zobacz też

Dostosowywanie tabeli mapowania określonego współczynnika absorpcji (SAR)