Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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:
- 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.
- System Windows zapewnia standardowy interfejs platformy i ogranicza stosowanie zastrzeżonych implementacji przez OEM-ów.
- 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
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
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:
- SarConfig
- CWwanSar::OnNdisNotification
- WczytajPółStatycznąTabelęOEMSAR
- SpróbujAutomatycznieSkonfigurowaćSAR
- PreCheckSemiStaticOEMSARTable
- WwanIntfOpcodeSarConfig
- WwanIntfOpcodeSarTransmissionStatus
- WwanMsmEventTypeSarConfig
- 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:
- NDIS_WWAN_SAR_CONFIG_INFO
- SarMode
- NDIS_WWAN_SAR_TRANSMISSION_STATUS_INFO
- HisterezaTimer
Zobacz też
Dostosowywanie tabeli mapowania określonego współczynnika absorpcji (SAR)