Dukungan Platform SAR MB

Gambaran Umum

Specific Absorption Rate (SAR) adalah kemampuan untuk mengubah daya pemancar radio MBB sebagai reaksi terhadap kedekatan antena MBB dengan pengguna. Secara tradisional, OEM telah menerapkan solusi kepemilikan untuk SAR. Ini mengharuskan OEM untuk menerapkan perintah layanan perangkat yang hanya diidentifikasi antara Driver Mode Pengguna (UMDF) dan modem mereka atau memerlukan komponen mode kernel untuk berinteraksi langsung dengan modem. Beberapa OEM bahkan mungkin memiliki solusi hibrid di mana mereka memiliki komponen modem modem UMDF dan modem kernel. Ketika kesadaran radiasi radio telah meningkat, menstandarkan antarmuka untuk komponen perangkat lunak OEM untuk melewati perintah SAR ke modem memperkenalkan manfaat berikut:

  1. OEM dapat berpindah ke komponen mode pengguna dan membuat sistem lebih stabil, karena kesalahan dalam mode pengguna tidak fatal terhadap sistem dibandingkan dengan mode kernel.
  2. Windows menyediakan antarmuka standar platform dan mengurangi implementasi kepemilikan dari OEM.
  3. Layanan dalam platform yang ingin memanfaatkan SAR dapat mengambil informasi dari modem.

Mulai dari Windows 10, versi 1703, Windows mendukung melewati konfigurasi SAR dan status transmisi modem. Windows akan terus meninggalkan logika bisnis SAR ke IHV dan OEM untuk digunakan sebagai faktor yang membedakan diri tetapi akan menyediakan antarmuka untuk menyederhanakan platform. Dua OID NDIS baru dan dua CID MBIM baru telah didefinisikan untuk mendukung antarmuka ini. Perangkat yang ingin memanfaatkan dukungan OS harus menerapkan kedua perintah.

Fitur ini didukung dengan menambahkan dua OID dan CID baru. Untuk mitra IHV yang menerapkan MBIM, hanya versi CID yang perlu didukung.

Catatan

Topik ini mendefinisikan antarmuka bagi mitra IHV untuk menerapkan dukungan platform SAR di driver perangkat modem mereka. Jika Anda mencari info tentang menyesuaikan tabel pemetaan SAR untuk perangkat, lihat Menyesuaikan tabel pemetaan Tingkat Penyerapan Tertentu (SAR).

Alur

SAR operation flowchart.

Pembaruan Antarmuka MB untuk Dukungan Platform SAR

Perangkat yang mematuhi MBIM mengimplementasikan dan melaporkan layanan perangkat berikut saat dikueri oleh CID_MBIM_DEVICE_SERVICES. Layanan terkenal yang ada didefinisikan dalam bagian 10.1 dari spesifikasi USB NCM MBIM 1.0. Microsoft memperluas ini untuk menentukan layanan berikut.

Nama Layanan = Microsoft SAR Control

UUID = UUID_MS_SARControl

Nilai UUID = 68223D04-9F6C-4e0F-822D-28441FB72340

CID Versi OS Minimum
MBIM_CID_MS_SAR_CONFIG Windows 10, versi 1703
MBIM_CID_MS_TRANSMISSION_STATUS Windows 10, versi 1703

MBIM_CID_MS_SAR_CONFIG

Deskripsi

Perintah ini mengatur atau mengembalikan informasi tentang mode dan tingkat back off SAR perangkat MB. Perangkat MB harus segera bertindak pada perintah back off SAR dengan menimpa batas daya Transmisi saat ini dan menerapkannya ke antena transmisi. Jika konfigurasi SAR antena tidak diubah oleh sistem operasi, konfigurasi tersebut harus mempertahankan pengaturannya saat ini. Misalnya, jika sistem operasi menetapkan antena 1 menjadi SAR back off indeks 1, konfigurasi antena 2 harus tetap sama tanpa perubahan apa pun.

Diharapkan bagi perangkat yang mendukung perintah ini untuk mengimplementasikan Kueri sehingga mereka memberikan informasi perangkat ke OS dan kliennya. Untuk perintah Set, itu adalah antara IHV dan OEM untuk menentukan nilai mana dari setiap bidang yang dapat diterima. Harapan umumnya adalah bahwa indeks back off SAR dapat dikonfigurasi untuk semua antena sebagai garis besar minimum. Jika permintaan Set dikirim dengan bidang yang tidak didukung oleh perangkat, maka MBIM_STATUS_INVALID_PARAMETERS harus dikembalikan sebagai kode status.

Setelah setiap respons Kueri atau Atur, modem harus mengembalikan struktur MBIM_MS_SAR_CONFIG yang berisi informasi untuk semua antena pada perangkat yang terkait dengan Mobile Broadband.

Kueri

InformationBuffer pada MBIM_COMMAND_MSG tidak digunakan. MBIM_MS_SAR_CONFIG dikembalikan di InformationBuffer MBIM_COMMAND_DONE.

Set

InformationBuffer di MBIM_COMMAND_MSG berisi MBIM_MS_SAR_CONFIG. MBIM_MS_SAR_CONFIG dikembalikan di InformationBuffer MBIM_COMMAND_DONE.

Peristiwa yang Tidak Diminta

Tidak dapat diterapkan.

Parameter

Operasi Set Kueri Pemberitahuan
Perintah MBIM_MS_SET_SAR_CONFIG Tidak berlaku Tidak berlaku
Respons MBIM_MS_SAR_CONFIG MBIM_MS_SAR_CONFIG Tidak berlaku

Struktur Data

Kueri

InformationBuffer adalah NULL dan InformationBufferLength adalah nol.

Set

Struktur MBIM_MS_SET_SAR_CONFIG berikut akan digunakan dalam InformationBuffer.

Offset Ukuran Bidang Jenis Deskripsi
0 4 SARMode MBIM_MS_SAR_CONTROL_MODE Untuk informasi selengkapnya, lihat tabel MBIM_MS_SAR_CONTROL_MODE.
4 4 SARBackOffStatus MBIM_MS_SAR_BACKOFF_STATE Untuk informasi selengkapnya, lihat tabel MBIM_MS_SAR_BACKOFF_STATE. Jika MBIM_MS_SAR_CONTROL_MODE diatur ke dikontrol perangkat, MAKA OS tidak akan dapat mengatur bidang ini.
8 4 ElementCount (EC) UINT32 Jumlah struktur MBIM_MS_SAR_CONFIG yang mengikuti di DataBuffer.
12 8 * EC SARConfigStatusRefList OL_PAIR_LIST Elemen pertama dari pasangan adalah offset 4 byte, dihitung dari awal (offset 0) dari struktur MBIM_MS_SET_SAR_CONFIG ini, ke struktur MBIM_MS_SAR_CONFIG_STATE. Untuk informasi selengkapnya, lihat tabel MBIM_MS_SAR_CONFIG_STATE. Elemen kedua dari pasangan adalah ukuran 4 byte dari penunjuk ke struktur MBIM_MS_SAR_CONFIG_STATE yang sesuai.
12 + (8 * EC) DataBuffer DATABUFFER Array struktur MBIM_MS_SAR_CONFIG_STATE.

Struktur berikut digunakan dalam tabel sebelumnya.

MBIM_MS_SAR_CONTROL_MODE menentukan bagaimana mekanisme back off SAR dikontrol.

Jenis Nilai Deskripsi
MBIMMsSARControlModeDevice 0 Mekanisme back off SAR dikendalikan oleh perangkat modem secara langsung.
MBIMMsSARControlModeOS 1 Mekanisme back off SAR dikontrol dan dikelola oleh sistem operasi.

MBIM_MS_SAR_BACKOFF_STATE menjelaskan status back off SAR.

Jenis Nilai Deskripsi
MBIMMsSARBackOffStatusDisabled 0 Back off SAR dinonaktifkan dalam modem.
MBIMMsSARBackOffStatusEnabled 1 Back off SAR diaktifkan dalam modem.

MBIM_MS_SAR_CONFIG_STATE menjelaskan kemungkinan status untuk backoff SAR untuk antena.

Offset Ukuran Bidang Jenis Deskripsi
0 4 SARAntennaIndex UINT32 Indeks antena yang sesuai dengan bidang SARBackOffIndex dalam tabel ini. Ini sesuai dengan nomor antena dan dibiarkan ke implementasi OEM untuk mengindeks setiap antena pada perangkat. Indeks apa pun valid untuk nilai ini. Jika nilai ini diatur ke 0xFFFFFFFF dalam perintah Set , SARBackOffIndex harus diterapkan ke semua antena. Jika nilai ini diatur ke 0xFFFFFFFF sebagai respons, itu menunjukkan bahwa SARBackOffIndex diterapkan ke semua antena.
4 4 SARBAckOffIndex UINT32 Indeks back off yang sesuai dengan tabel back off yang ditentukan oleh OEM atau vendor modem. Tabel memiliki pita individual dan parameter back off terkait.

Respons

Struktur MBIM_MS_SAR_CONFIG berikut akan digunakan dalam InformationBuffer. MBIM_MS_SAR_CONFIG menentukan konfigurasi untuk SAR.

Offset Ukuran Bidang Jenis Deskripsi
0 4 SARMode MBIM_MS_SAR_MODE Untuk informasi selengkapnya, lihat tabel MBIM_MS_SAR_CONTROL_MODE.
4 4 SARBackOffStatus MBIM_MS_SAR_BACKOFF_STATE Untuk informasi selengkapnya, lihat tabel MBIM_MS_SAR_BACKOFF_STATE.
8 4 SARWifiIntegration MBIM_MS_SAR_ WIFI_HARDWARE_INTEGRATION Untuk informasi selengkapnya, lihat tabel MBIM_MS_SAR_HARDWARE_WIFI_INTEGRATION. Ini menyiratkan Wi-Fi perangkat dan SAR Seluler terintegrasi pada lapisan perangkat keras dan perangkat akan secara otomatis menyesuaikan kontrol SAR untuk kedua radio.
12 4 ElementCount (EC) UINT32 Jumlah struktur MBIM_MS_SAR_CONFIG_STATE yang mengikuti di DataBuffer.
16 8 * EC SARConfigStatusRefList OL_PAIR_LIST Elemen pertama dari pasangan adalah offset 4 byte, dihitung dari awal (offset 0) dari struktur MBIM_MS_SAR_CONFIG ini, ke struktur MBIM_MS_SAR_CONFIG_STATE. Untuk informasi selengkapnya, lihat tabel MBIM_MS_SAR_CONFIG_STATE. Elemen kedua dari pasangan adalah ukuran 4-byte dari penunjuk ke struktur MBIM_MS_SAR_CONFIG_STATE yang sesuai.
16 + (8 * EC) DataBuffer DATABUFFER Array struktur MBIM_MS_SAR_CONFIG_STATE.

Struktur MBIM_MS_SAR_HARDWARE_WIFI_INTEGRATION berikut digunakan dalam tabel sebelumnya. Ini menentukan apakah Wi-Fi dan Seluler terintegrasi pada tingkat perangkat keras.

Jenis Nilai Deskripsi
MBIMMsSARWifiHardwareIntegrated 0 Wi-Fi dan SAR modem Seluler terintegrasi dalam perangkat.
MBIMMsSARWifiHardwareNotIntegrated 1 Wi-Fi dan SAR modem Seluler tidak terintegrasi dalam perangkat.

Pemberitahuan

Tidak dapat diterapkan.

Kode Status

Kode Kesalahan Deskripsi
MBIM_STATUS_SUCCESS Permintaan berhasil diproses.
MBIM_STATUS_BUSY Perangkat saat ini sibuk.
MBIM_STATUS_FAILURE Permintaan gagal.
MBIM_STATUS_NO_DEVICE_SUPPORT Perangkat tidak mendukung perintah ini.
MBIM_STATUS_INVALID_PARAMETERS Operasi gagal karena parameter yang tidak valid.
MBIM_STATUS_OPERATION_NOT_ALLOWED Operasi gagal karena operasi tidak diperbolehkan.

MBIM_CID_MS_TRANSMISSION_STATUS

Deskripsi

Perintah ini digunakan untuk mengaktifkan atau menonaktifkan pemberitahuan dari modem pada status transmisi. Ini adalah perintah per eksekutor karena setiap eksekutor dapat memiliki status transmisi saluran yang berbeda. Misalnya, modem SIM ganda mungkin memilikinya di LTE dan yang lainnya di GSM. Pada saat yang sama, ini dapat digunakan untuk memberikan status transmisi modem. Pemberitahuan ini dapat digunakan untuk klien yang tertarik pada apakah modem mengirimkan data atau tidak. Modem harus memberikan pemberitahuan kapan saja ada awal atau akhir lalu lintas TX. Jika siklus tugas terlalu kecil dan tidak dapat disediakan secara real time kepada host, maka status TX dapat disimpan sebagai aktif untuk waktu yang ditetapkan dengan timer histeresis sebelum mengirimkan pembaruan status. Sebagai contoh, mungkin ada ledakan singkat TX dan modem tidak dapat memberikan pemberitahuan awal dan akhir pada waktunya. Modem harus mengirimkan pemberitahuan ketika lalu lintas TX dimulai dan harus terus memantau lalu lintas TX-nya selama timer histeresis. Jika tidak ada lagi lalu lintas TX yang dihasilkan dalam jangka waktu timer, maka harus melaporkan bahwa lalu lintas TX telah berakhir.

Ini sangat berguna dalam skenario di mana Wi-Fi dan LTE terhubung. Jika LTE dan Wi-Fi berada dalam status transmisi dan kedekatan terdeteksi, maka Wi-Fi back off mungkin diperlukan. Jika LTE tidak dalam status transmisi tetapi Wi-Fi, maka Wi-Fi mundur mungkin tidak diperlukan. Ini berlaku untuk koneksi Wi-Fi/LTE umum dan skenario hot spot seluler.

Mekanisme dan perintah back off Wi-Fi berada di luar cakupan spesifikasi ini.

OEM yang menggunakan perintah ini harus menyadari potensi dampak daya karena modem mungkin mengirimkan pemberitahuan terkait transmisi setiap saat, termasuk pengurangan status daya. OS, secara default, tidak akan memungkinkan pemberitahuan ini untuk membangunkan AP selama Siaga Modern untuk meningkatkan performa daya.

Kueri

InformationBuffer pada MBIM_COMMAND_MSG tidak digunakan. MBIM_MS_TRANSMISSION_STATUS_INFO dikembalikan di InformationBuffer MBIM_COMMAND_DONE.

Set

InformationBuffer di MBIM_COMMAND_MSG berisi MBIM_MS_SET_TRANSMISSION_STATUS. MBIM_MS_TRANSMISSION_STATUS_INFO dikembalikan di InformationBuffer MBIM_COMMAND_DONE.

Peristiwa yang Tidak Diminta

Peristiwa yang tidak diminta berisi MBIM_MS_TRANSMISSION_STATUS_INFO dan dikirim ketika ada perubahan pada saluran over-the-air (OTA) aktif. Misalnya, jika modem mulai mengunggah data paket, akan diperlukan untuk menyiapkan saluran uplink saat menggunakan saluran data jaringan sehingga dapat mengunggah payload. Ini akan memicu pemberitahuan untuk diberikan ke sistem operasi.

Parameter

Operasi Set Kueri Pemberitahuan
Perintah MBIM_MS_SET_TRANSMISSION_STATUS Tidak berlaku Tidak berlaku
Respons MBIM_MS_TRANSMISSION_STATUS_INFO MBIM_MS_TRANSMISSION_STATUS_INFO MBIM_MS_TRANSMISSION_STATUS_INFO

Struktur Data

Kueri

InformationBuffer pada MBIM_COMMAND_MSG tidak digunakan. MBIM_MS_TRANSMISSION_STATUS_INFO dikembalikan di InformationBuffer MBIM_COMMAND_DONE.

Set

Struktur MBIM_MS_SET_TRANSMISSION_STATUS berikut harus digunakan dalam InformationBuffer.

Offset Ukuran Bidang Jenis Deskripsi
0 4 ChannelNotification MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION Untuk informasi selengkapnya, lihat tabel MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION.
4 4 HysteresisTimer UINT32 Indikator Hysteresis yang digunakan oleh modem untuk menentukan kapan harus mengirim MBIMMsTransmissionStateInactive ke host. Nilai ini adalah timer yang dilihat modem sebagai aktivitas tanpa transmisi berkelanjutan sebelum mengirimkan indikator OFF ke host. Timer ini harus diatur dalam detik, mulai dari 1 detik hingga 5 detik.

Struktur MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION berikut digunakan dalam tabel sebelumnya. Ini menentukan apakah transmisi saluran modem dinonaktifkan atau diaktifkan.

Jenis Nilai Deskripsi
MBIMMsTransmissionNotificationDisabled 0 Pemberitahuan status transmisi saluran modem dinonaktifkan.
MBIMMsTransmissionNotificationEnabled 1 Pemberitahuan status transmisi saluran modem diaktifkan.

Respons

Struktur MBIM_MS_TRANSMISSION_STATUS_INFO berikut digunakan untuk respons.

Offset Ukuran Bidang Jenis Deskripsi
0 4 ChannelNotification MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION Untuk informasi selengkapnya, lihat tabel MBIM_MS_TRANSMISSION_STATUS_NOTIFICATION.
4 4 TransmissionStatus MBIM_MS_TRANSMISSION_STATUS Untuk informasi selengkapnya, lihat tabel MBIM_MS_TRANSMISSION_STATUS. Ini menunjukkan apakah modem memiliki lalu lintas TX setiap 5 detik.
8 4 HysteresisTimer UINT32 Indikator Hysteresis yang digunakan oleh modem untuk menentukan kapan harus mengirim MBIMMsTransmissionStateInactive ke host. Nilai ini adalah timer yang dilihat modem sebagai aktivitas tanpa transmisi berkelanjutan sebelum mengirimkan indikator OFF ke host. Timer ini harus diatur dalam detik, mulai dari 1 detik hingga 5 detik.

Struktur MBIM_MS_TRANSMISSION_STATUS berikut digunakan dalam tabel sebelumnya. Ini menunjukkan apakah modem memiliki lalu lintas TX setiap 5 detik.

Jenis Nilai Deskripsi
MBIMMsTransmissionStateInactive 0 Modem tidak secara aktif mengirimkan data tanpa selang transmisi berkelanjutan untuk nilai HysteresisTimer terakhir.
MBIMMsTransmissionStateActive 1 Modem secara aktif mengirimkan data.

Pemberitahuan

Untuk informasi selengkapnya, lihat tabel MBIM_MS_TRANSMISSION_STATUS_INFO.

Kode Status

Kode Kesalahan Deskripsi
MBIM_STATUS_SUCCESS Permintaan berhasil diproses.
MBIM_STATUS_BUSY Perangkat saat ini sibuk.
MBIM_STATUS_FAILURE Permintaan gagal.
MBIM_STATUS_NO_DEVICE_SUPPORT Perangkat tidak mendukung perintah ini.
MBIM_STATUS_INVALID_PARAMETERS Operasi gagal karena parameter yang tidak valid.
MBIM_STATUS_OPERATION_NOT_ALLOWED Operasi gagal karena operasi tidak diperbolehkan.

Uji Hardware Lab Kit (HLK)

Lihat Langkah-langkah untuk menginstal HLK.

Di HLK Studio, sambungkan ke driver modem Seluler perangkat dan jalankan pengujian: Win6_4.MB. GSM. Data.TestSAR.

Pengujian ini berisi tes berikut:

Nama Pengujian Deskripsi
QuerySarConfig Pengujian ini memverifikasi pengujian dapat berhasil mengkueri konfigurasi SAR.
SetSarConfig Pengujian ini memverifikasi pengujian dapat berhasil mengatur konfigurasi SAR.
QuerySarTransmissionStatus Pengujian ini memverifikasi pengujian dapat berhasil mengkueri status transmisi SAR.
SetSarTransmissionStatus Pengujian ini memverifikasi bahwa pengujian dapat berhasil mengatur status transmisi SAR.

WinRT API

MobileBroadbandSarManager

Analisis Log

Log dapat dikumpulkan dan didekode menggunakan instruksi berikut: MB Mengumpulkan Log.

Penyedia penting dan kata kunci yang sesuai

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

Kata kunci untuk pemfilteran:

  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)

Kata kunci untuk pemfilteran: MobileBroadbandSarManager

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

Kata kunci untuk pemfilteran:

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

Lihat juga

Mengkustomisasi tabel pemetaan Tingkat Penyerapan Tertentu (SAR)