Поделиться через


Поддержка платформы SAR MB

Общие сведения

Удельный коэффициент поглощения (SAR) — это возможность изменять мощность радиопередатчика MBB в ответ на близость антенны MBB к пользователю. Традиционно изготовители оборудования внедряют собственные решения для SAR. Для этого изготовителю оборудования необходимо реализовать команду службы устройства, которая определяется только между драйвером пользовательского режима (UMDF) и модемом, либо требует, чтобы компоненты режима ядра напрямую взаимодействовали с модемом. Некоторые изготовители оборудования могут даже иметь гибридное решение, в котором они имеют как UMDF-модем, так и компоненты модема в режиме ядра. По мере повышения осведомленности о радиоизлучении стандартизация интерфейса для программных компонентов OEM для передачи через команду SAR в модем предоставляет следующие преимущества:

  1. Изготовители оборудования могут перейти к компонентам пользовательского режима и сделать систему более стабильной, так как ошибки в пользовательском режиме не являются фатальными для системы по сравнению с режимом ядра.
  2. Windows предоставляет стандартный интерфейс платформы и сокращает объем защищаемой реализации от изготовителей оборудования.
  3. Службы на платформе, которые хотят воспользоваться преимуществами SAR, могут извлекать информацию из модема.

Начиная с Windows 10 версии 1703, Windows поддерживает передачу через конфигурацию SAR и состояние передачи модема. Windows будет по-прежнему оставлять бизнес-логику SAR для IHV и ИЗГОТОВИТЕЛей, чтобы использовать их в качестве самостоятельного фактора, но будет предоставлять интерфейс для оптимизации платформы. Для поддержки этого интерфейса определены два новых идентификатора NDIS OID и два новых ИДЕНТИФИКАТОРа MBIM CID. Устройства, которые хотят воспользоваться поддержкой ОС, должны реализовывать обе команды.

Эта функция поддерживается путем добавления двух новых идентификаторов OID и CID. Для партнеров IHV, реализующих MBIM, должна поддерживаться только версия CID.

Примечание

В этом разделе определяется интерфейс для партнеров IHV для реализации поддержки платформы SAR в драйверах модемных устройств. Сведения о настройке таблицы сопоставления SAR для устройства см. в статье Настройка таблицы сопоставления с определенной скоростью поглощения (SAR).

Поток

Блок-схема, иллюстрирующая операцию SAR.

Обновление интерфейса в МБ для поддержки платформы SAR

Устройство, совместимое с MBIM, реализует и сообщает следующую службу устройства при запросе CID_MBIM_DEVICE_SERVICES. Существующие хорошо известные службы определены в разделе 10.1 спецификации USB NCM MBIM 1.0. Корпорация Майкрософт расширяет эту возможность для определения следующей службы.

Service Name = Microsoft SAR Control

UUID = UUID_MS_SARControl

Значение UUID = 68223D04-9F6C-4E0F-822D-28441FB72340

CID Минимальная версия ОС
MBIM_CID_MS_SAR_CONFIG Windows 10 версии 1703
MBIM_CID_MS_TRANSMISSION_STATUS Windows 10 версии 1703

MBIM_CID_MS_SAR_CONFIG

Описание

Эта команда задает или возвращает сведения о режиме и уровне отключения SAR устройства в МБ. Устройство MB должно немедленно реагировать на команду sar back off, перезаписав текущие ограничения мощности передачи и применяя их к передающим антеннам. Если конфигурация SAR антенны не была изменена операционной системой, она должна сохранить текущее значение. Например, если операционная система устанавливает для антенны 1 значение SAR от индекса 1, то конфигурация антенны 2 должна оставаться прежней без каких-либо изменений.

Ожидается, что устройства, поддерживающие эту команду, реализуют запрос, чтобы они предоставляли сведения об устройстве операционной системе и ее клиентам. Для команды Set между IHV и ИЗГОТОВИТЕЛем оборудования определяется допустимое значение каждого поля. Типичное ожидание заключается в том, что индекс отката SAR настраивается для всех антенн в качестве минимального базового плана. Если запрос set отправляется с полями, которые не поддерживаются устройством, то MBIM_STATUS_INVALID_PARAMETERS должны быть возвращены в качестве кода состояния.

После каждого ответа Query или Set модем должен возвращать MBIM_MS_SAR_CONFIG структуру, содержащую сведения обо всех антеннах на устройстве, связанном с мобильной широкополосной связью.

Запрос

InformationBuffer на MBIM_COMMAND_MSG не используется. MBIM_MS_SAR_CONFIG возвращается в InformationBuffer MBIM_COMMAND_DONE.

Присвойте параметру

InformationBuffer на MBIM_COMMAND_MSG содержит MBIM_MS_SAR_CONFIG. MBIM_MS_SAR_CONFIG возвращается в InformationBuffer MBIM_COMMAND_DONE.

Нежелательные события

Не применяется

Параметры

Операция Присвойте параметру Запрос Уведомление
Get-Help MBIM_MS_SET_SAR_CONFIG Неприменимо Неприменимо
Ответ MBIM_MS_SAR_CONFIG MBIM_MS_SAR_CONFIG Неприменимо

Структуры данных

Запрос

Параметр InformationBuffer должен иметь значение NULL, а InformationBufferLength — ноль.

Присвойте параметру

Следующая MBIM_MS_SET_SAR_CONFIG структура должна использоваться в InformationBuffer.

Offset Размер Поле Тип Описание
0 4 SARMode MBIM_MS_SAR_CONTROL_MODE Дополнительные сведения см. в таблице MBIM_MS_SAR_CONTROL_MODE.
4 4 SARBackOffStatus MBIM_MS_SAR_BACKOFF_STATE Дополнительные сведения см. в таблице MBIM_MS_SAR_BACKOFF_STATE. Если MBIM_MS_SAR_CONTROL_MODE настроено для управления устройством, операционная система не сможет задать это поле.
8 4 ElementCount (EC) UINT32 Количество MBIM_MS_SAR_CONFIG структур, которые следуют в DataBuffer.
12 8 * EC SARConfigStatusRefList OL_PAIR_LIST Первый элемент пары представляет собой 4-байтовое смещение, вычисленное от начала (смещение 0) этой MBIM_MS_SET_SAR_CONFIG структуры до MBIM_MS_SAR_CONFIG_STATE структуры. Дополнительные сведения см. в таблице MBIM_MS_SAR_CONFIG_STATE. Второй элемент пары представляет собой 4-байтовый размер указателя на соответствующую MBIM_MS_SAR_CONFIG_STATE структуру.
12 + (8 * EC) DataBuffer DATABUFFER Массив структур MBIM_MS_SAR_CONFIG_STATE.

В предыдущей таблице используются следующие структуры.

MBIM_MS_SAR_CONTROL_MODE указывает, как контролируется механизм возврата SAR.

Тип Значение Описание
MBIMMsSARControlModeDevice 0 Механизм отката SAR управляется модемным устройством напрямую.
MBIMMsSARControlModeOS 1 Механизм отката SAR контролируется операционной системой и управляется им.

MBIM_MS_SAR_BACKOFF_STATE описывает состояние sar back off.

Тип Значение Описание
MBIMMsSARBackOffStatusDisabled 0 В модеме отключена функция sar back off.
MBIMMsSARBackOffStatusEnabled 1 В модеме включена функция резервного копирования sar.

MBIM_MS_SAR_CONFIG_STATE описывает возможные состояния для sar backoff для антенн.

Offset Размер Поле Тип Описание
0 4 SARAntennaIndex UINT32 Индекс антенны, соответствующий полю SARBackOffIndex в этой таблице. Он соответствует номеру антенны и остается для oem-реализации для индексирования каждой антенны на устройстве. Для этого значения допустим любой индекс. Если для этого значения задано значение 0xFFFFFFFF в команде Set , параметр SARBackOffIndex следует применять ко всем антеннам. Если в ответ для этого значения задано значение 0xFFFFFFFF , это означает, что SARBackOffIndex применяется ко всем антеннам.
4 4 SARBAckOffIndex UINT32 Индекс отката, соответствующий таблице back off, определенной изготовителем оборудования или поставщиком модема. Таблица содержит отдельные полосы и связанные параметры back off.

Ответ

В InformationBuffer должна использоваться следующая структура MBIM_MS_SAR_CONFIG. MBIM_MS_SAR_CONFIG указывает конфигурацию для SAR.

Offset Размер Поле Тип Описание
0 4 SARMode MBIM_MS_SAR_MODE Дополнительные сведения см. в таблице MBIM_MS_SAR_CONTROL_MODE.
4 4 SARBackOffStatus MBIM_MS_SAR_BACKOFF_STATE Дополнительные сведения см. в таблице MBIM_MS_SAR_BACKOFF_STATE.
8 4 SARWifiIntegration MBIM_MS_SAR_ WIFI_HARDWARE_INTEGRATION Дополнительные сведения см. в таблице MBIM_MS_SAR_HARDWARE_WIFI_INTEGRATION. Это означает, что Wi-Fi устройства и сотовой сети SAR интегрированы на аппаратном уровне, и устройство автоматически настраивает управление SAR для обоих радиостанций.
12 4 ElementCount (EC) UINT32 Количество MBIM_MS_SAR_CONFIG_STATE структур, которые следуют в DataBuffer.
16 8 * EC SARConfigStatusRefList OL_PAIR_LIST Первый элемент пары — это смещение в 4 байта, вычисленное от начала (смещение 0) этой MBIM_MS_SAR_CONFIG структуры до MBIM_MS_SAR_CONFIG_STATE структуры. Дополнительные сведения см. в таблице MBIM_MS_SAR_CONFIG_STATE. Второй элемент пары — это 4-байтовый размер указателя на соответствующую MBIM_MS_SAR_CONFIG_STATE структуру.
16 + (8 * EC) DataBuffer DATABUFFER Массив структур MBIM_MS_SAR_CONFIG_STATE.

В предыдущей таблице используется следующая структура MBIM_MS_SAR_HARDWARE_WIFI_INTEGRATION. Он указывает, интегрируются ли Wi-Fi и сотовая сеть на аппаратном уровне.

Тип Значение Описание
MBIMMsSARWifiHardwareIntegrated 0 Wi-Fi и сотовый модем SAR интегрирован в устройство.
MBIMMsSARWifiHardwareNotIntegrated 1 Wi-Fi и сотовый модем SAR не интегрирован в устройство.

Уведомление

Не применяется

Коды состояний

Код ошибки Описание
MBIM_STATUS_SUCCESS Запрос успешно обработан.
MBIM_STATUS_BUSY Устройство в настоящее время занято.
MBIM_STATUS_FAILURE Ошибка запроса.
MBIM_STATUS_NO_DEVICE_SUPPORT Устройство не поддерживает эту команду.
MBIM_STATUS_INVALID_PARAMETERS Операция завершилась сбоем из-за недопустимых параметров.
MBIM_STATUS_OPERATION_NOT_ALLOWED Операция завершилась сбоем, так как операция не разрешена.

MBIM_CID_MS_TRANSMISSION_STATUS

Описание

Эта команда используется для включения или отключения уведомления от модема о состоянии передачи. Это команда для каждого исполнителя, так как каждый исполнитель может иметь разное состояние передачи канала. Например, модем с двумя SIM-картами может иметь один на LTE, а другой на GSM. В то же время его можно использовать для предоставления состояния передачи модема. Это уведомление можно использовать для клиентов, которых интересует, передает ли модем данные. Модем должен предоставлять уведомление каждый раз, когда начинается или заканчивается трафик TX. Если рабочий цикл слишком мал и не может быть предоставлен в режиме реального времени на узел, состояние TX может оставаться активным в течение заданного времени с помощью таймера гистерезиса перед отправкой обновления состояния. Например, это может быть то, что произошел короткий всплеск TX, и модем не смог вовремя предоставить уведомление о начале и конце. Модем должен отправлять уведомление о запуске трафика TX и продолжать отслеживать трафик TX во время таймера гистерезиса. Если трафик TX больше не был создан в течение периода времени таймера, он должен сообщить, что трафик TX закончился.

Это очень полезно в сценариях, где подключены как Wi-Fi, так и LTE. Если и LTE, и Wi-Fi находятся в состоянии передачи и обнаружена близость, может потребоваться Wi-Fi отката. Если lte не находится в состоянии передачи, но Wi-Fi, то Wi-Fi откат может не потребоваться. Это относится к общим сценариям подключения Wi-Fi/LTE и мобильной горячей точки.

Механизм и команда Wi-Fi не область этой спецификации.

Изготовители оборудования, использующие эту команду, должны знать о потенциальном влиянии питания, так как модем может постоянно отправлять уведомления, связанные с передачей данных, включая пониженное состояние питания. Операционная система по умолчанию не разрешает этому уведомлению пробуждение точки доступа во время режима современного режима ожидания для повышения производительности питания.

Запрос

InformationBuffer на MBIM_COMMAND_MSG не используется. MBIM_MS_TRANSMISSION_STATUS_INFO возвращается в InformationBuffer MBIM_COMMAND_DONE.

Присвойте параметру

InformationBuffer на MBIM_COMMAND_MSG содержит MBIM_MS_SET_TRANSMISSION_STATUS. MBIM_MS_TRANSMISSION_STATUS_INFO возвращается в InformationBuffer MBIM_COMMAND_DONE.

Нежелательные события

Незапрошенные события содержат MBIM_MS_TRANSMISSION_STATUS_INFO и отправляются при изменении активных каналов по беспроводной сети (OTA). Например, если модем начал отправку данных пакетов, при использовании сетевого канала данных потребуется настроить каналы исходящей связи, чтобы можно было отправлять полезные данные. Это приведет к отправке уведомления операционной системе.

Параметры

Операция Присвойте параметру Запрос Уведомление
Get-Help MBIM_MS_SET_TRANSMISSION_STATUS Неприменимо Неприменимо
Ответ MBIM_MS_TRANSMISSION_STATUS_INFO MBIM_MS_TRANSMISSION_STATUS_INFO MBIM_MS_TRANSMISSION_STATUS_INFO

Структуры данных

Запрос

InformationBuffer на MBIM_COMMAND_MSG не используется. MBIM_MS_TRANSMISSION_STATUS_INFO возвращается в InformationBuffer MBIM_COMMAND_DONE.

Присвойте параметру

Следующая MBIM_MS_SET_TRANSMISSION_STATUS структура должна использоваться в InformationBuffer.

Offset Размер Поле Тип Описание
0 4 ChannelNotification MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION Дополнительные сведения см. в таблице MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION.
4 4 HysteresisTimer UINT32 Индикатор гистерезиса, используемый модемом для определения времени отправки MBIMMsTransmissionStateInactive на узел. Это значение является таймером, который модем считает непрерывным действием без передачи перед отправкой индикатора OFF на узел. Этот таймер должен быть установлен в секундах в диапазоне от 1 секунды до 5 секунд.

В предыдущей таблице используется следующая структура MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION. Он указывает, отключена или включена передача по каналу модема.

Тип Значение Описание
MBIMMsTransmissionNotificationDisabled 0 Уведомление о состоянии передачи канала модема отключено.
MBIMMsTransmissionNotificationEnabled 1 Уведомление о состоянии передачи канала модема включено.

Ответ

Для ответа используется следующая структура MBIM_MS_TRANSMISSION_STATUS_INFO.

Offset Размер Поле Тип Описание
0 4 ChannelNotification MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION Дополнительные сведения см. в таблице MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION.
4 4 TransmissionStatus MBIM_MS_TRANSMISSION_STATUS Дополнительные сведения см. в таблице MBIM_MS_TRANSMISSION_STATUS. Это указывает, имеет ли модем трафик TX каждые 5 секунд.
8 4 HysteresisTimer UINT32 Индикатор гистерезиса, используемый модемом для определения времени отправки MBIMMsTransmissionStateInactive на узел. Это значение является таймером, который модем считает непрерывным действием без передачи перед отправкой индикатора OFF на узел. Этот таймер должен быть установлен в секундах в диапазоне от 1 секунды до 5 секунд.

В предыдущей таблице используется следующая структура MBIM_MS_TRANSMISSION_STATUS. Указывает, используется ли трафик TX модемом каждые 5 секунд.

Тип Значение Описание
MBIMMsTransmissionStateInactive 0 Модем не был активно передавать данные без каких-либо непрерывных кругов передачи для последнего значения HysteresisTimer.
MBIMMsTransmissionStateActive 1 Модем активно передавал данные.

Уведомление

Дополнительные сведения см. в таблице MBIM_MS_TRANSMISSION_STATUS_INFO.

Коды состояний

Код ошибки Описание
MBIM_STATUS_SUCCESS Запрос успешно обработан.
MBIM_STATUS_BUSY Устройство в настоящее время занято.
MBIM_STATUS_FAILURE Ошибка запроса.
MBIM_STATUS_NO_DEVICE_SUPPORT Устройство не поддерживает эту команду.
MBIM_STATUS_INVALID_PARAMETERS Операция завершилась сбоем из-за недопустимых параметров.
MBIM_STATUS_OPERATION_NOT_ALLOWED Операция завершилась сбоем, так как операция не разрешена.

Тесты аппаратного лабораторного комплекта (HLK)

См. инструкции по установке HLK.

В HLK Studio подключитесь к драйверу сотового модема устройства и запустите тест : Win6_4,МБ. GSM. Data.TestSAR.

Этот тест содержит следующие тесты:

Имя теста Описание
QuerySarConfig Этот тест проверяет, что тест может успешно запрашивать конфигурации SAR.
SetSarConfig Этот тест проверяет, что тест может успешно настроить конфигурации SAR.
QuerySarTransmissionStatus Этот тест проверяет, может ли тест успешно запрашивать состояние передачи SAR.
SetSarTransmissionStatus Этот тест проверяет, что тест может успешно задать состояние передачи SAR.

API-интерфейс WinRT

MobileBroadbandSarManager

Служба Log Analysis

Журналы можно собирать и декодировать с помощью следующих инструкций: СБОР журналов в МБ.

Важные поставщики и соответствующие ключевые слова

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

Ключевые слова для фильтрации:

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

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

Ключевые слова для фильтрации: MobileBroadbandSarManager

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

Ключевые слова для фильтрации:

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

См. также:

Настройка таблицы сопоставления конкретной скорости поглощения (SAR)