Dukungan Platform SAR MB
Gambaran Umum
Tingkat Penyerapan Spesifik (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 mengimplementasikan perintah layanan perangkat yang hanya diidentifikasi antara User Mode Driver (UMDF) mereka dan modem atau memerlukan komponen mode kernel untuk berinteraksi langsung dengan modem. Beberapa OEM bahkan mungkin memiliki solusi hibrid di mana mereka memiliki komponen 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:
- OEM dapat berpindah ke komponen mode pengguna dan membuat sistem lebih stabil, karena kesalahan dalam mode pengguna tidak fatal dengan sistem dibandingkan dengan mode kernel.
- Windows menyediakan antarmuka standar platform dan mengurangi implementasi kepemilikan dari OEM.
- 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
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 pemancar. 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 Atur, 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 Broadband Seluler.
Kueri
InformationBuffer di 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 akan menjadi 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 ini 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 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 harus 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 pelaksana 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 mulai dan berakhir tepat waktu. 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. Hal 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 di 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 di MBIM_COMMAND_MSG tidak digunakan. MBIM_MS_TRANSMISSION_STATUS_INFO dikembalikan di InformationBuffer MBIM_COMMAND_DONE.
Set
Struktur MBIM_MS_SET_TRANSMISSION_STATUS berikut akan 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 Histeresis 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 mengirim indikator OFF ke host. Timer ini harus diatur dalam detik, berkisar antara 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 Histeresis 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 mengirim indikator OFF ke host. Timer ini harus diatur dalam detik, berkisar antara 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 bahwa pengujian dapat berhasil mengkueri konfigurasi SAR. |
| SetSarConfig | Pengujian ini memverifikasi bahwa pengujian dapat berhasil mengatur konfigurasi SAR. |
| QuerySarTransmissionStatus | Pengujian ini memverifikasi bahwa pengujian dapat berhasil mengkueri status transmisi SAR. |
| SetSarTransmissionStatus | Pengujian ini memverifikasi bahwa pengujian dapat berhasil mengatur status transmisi SAR. |
WinRT API
Analitik log
Log dapat dikumpulkan dan didekode menggunakan instruksi berikut: MB Collecting Logs.
Penyedia penting dan kata kunci yang sesuai
Microsoft-Windows-WWAN-SVC-EVENTS (3cb40aaa-1145-4fb8-b27b-7e30f0454316)
Kata kunci untuk pemfilteran:
- SarConfig
- CWwanSar::OnNdisNotification
- LoadSemiStaticOEMSARTable
- AttemptAutoConfigureSAR
- PreCheckSemiStaticOEMSARTable
- WwanIntfOpcodeSarConfig
- WwanIntfOpcodeSarTransmissionStatus
- WwanMsmEventTypeSarConfig
- WwanMsmEventTypeSarTransmissionStatus
MobileBroadband WinRT WPP (56dd9c57-06cc-48ba-b123-876a6495ba13)
Kata kunci untuk pemfilteran: MobileBroadbandSarManager
WwanProtDIM (3a07e1ba-3a6b-49bf-8056-c105b54dd7fb)
Kata kunci untuk pemfilteran:
- NDIS_WWAN_SAR_CONFIG_INFO
- SarMode
- NDIS_WWAN_SAR_TRANSMISSION_STATUS_INFO
- HysteresisTimer
Lihat juga
Mengkustomisasi tabel pemetaan Tingkat Penyerapan Tertentu (SAR)