Operasi Opsi Konfigurasi Protokol (PCO) MB
Gambaran Umum
Tujuan dari Opsi Konfigurasi Protokol (PCO) adalah untuk mentransfer opsi protokol jaringan eksternal yang terkait dengan aktivasi konteks protokol data paket (PDP). Definisi Windows NDIS untuk nilai PCO biasanya umum untuk menerima nilai PCO penuh dari modem dan jaringan di masa mendatang. Namun dimulai dengan Windows 10 versi 1709 beberapa modem hanya dapat meneruskan elemen PCO khusus operator ke OS. Topik ini mendefinisikan perilaku implementasi PCO khusus operator saat ini.
Alur
Ada tiga skenario di mana nilai PCO akan diteruskan ke host:
- Ketika nilai PCO baru telah tiba pada koneksi yang diaktifkan
- Saat aplikasi atau layanan meminta nilai PCO terbaru dari modem
- Ketika koneksi di bridged atau diaktifkan untuk pertama kalinya dan nilai PCO sudah ada di modem
Untuk skenario pertama, modem harus mengirim pemberitahuan NDIS_STATUS_WWAN_PCO_STATUS ke OS yang menunjukkan perubahan nilai PCO baru setiap kali nilai PCO baru diterima dari jaringan, dengan nomor port NDIS yang sesuai untuk mewakili PDN yang sesuai. Untuk menghindari pengurasan baterai yang tidak perlu, modem harus menghindari pemberitahuan yang bising, seperti yang dijelaskan dalam Perilaku modem dengan Selective Suspend dan Connected Standby.
Untuk skenario kedua, ketika aplikasi atau kueri layanan untuk nilai PCO dari modem pada koneksi PDN yang diaktifkan, host akan mengirim modem permintaan kueri OID_WWAN_PCO untuk membaca nilai PCO cache terbaru dalam modem.
Untuk skenario ketiga, ketika koneksi diaktifkan atau dihubungkan pada host, modem harus mengirim pemberitahuan NDIS_STATUS_WWAN_PCO_STATUS ketika nilai PCO sudah ada di modem untuk koneksi yang diaktifkan atau dihubungi yang diminta host. Pemberitahuan harus diteruskan dari nomor port NDIS yang sesuai dari PDN.
Gambar berikut menunjukkan alur skenario:
Perilaku modem dengan Penangguhan Selektif dan Siaga Tersambung
Ketika Penangguhan Selektif diaktifkan, modem dapat memberi tahu OS setiap kali menerima struktur data PCO dari jaringan. Namun, modem harus menghindari bangunnya perangkat yang tidak perlu. Jika tidak, pemberitahuan PCO yang bising dari jaringan akan sering membangunkan perangkat dan menguras baterai yang tidak perlu.
Ketika Connected Standby diaktifkan, modem tidak boleh memberi tahu OS ketika menerima struktur data PCO dari jaringan karena tidak hanya akan membangunkan perangkat, tetapi juga akan membangunkan OS, yang tidak diperlukan. Sebagai gantinya, modem harus menyimpan cache semua elemen PCO terbaru dari struktur data dan memberi tahu OS setelah OS keluar dari Connected Standby. Untuk modem MBIM, modem harus menyimpan semua struktur data PCO dan hanya mengirim pemberitahuan PCO ke OS setelah host berlangganannya. Ini akan dilakukan menggunakan CID MBIM_CID_DEVICE_SERVICE_SUBSCRIBE_LIST ketika daya sistem telah kembali ke daya penuh setelah keluar dari Siaga Terhubung.
Mereset modem berdasarkan nilai PCO
Berdasarkan nilai PCO yang diterima dari jaringan, modem akan direset dalam skenario berikut:
- Pengguna menyelesaikan aktivasi mandiri setelah menerima PCO = 5 dari jaringan. Nilai PCO baru (3, 0 atau apa pun yang dapat dikenali Aplikasi Operator Seluler) akan dikirim ke OS dan OS akan meneruskannya ke Aplikasi Operator Seluler.
- Pengguna menambahkan lebih banyak kredit ke akun mereka setelah menerima PCO = 3. Nilai PCO baru (0, atau apa pun yang dapat dikenali Oleh Aplikasi Operator Seluler) akan dikirim ke OS dan OS akan meneruskannya ke Aplikasi Operator Seluler.
Host tidak mengetahui modem yang direset, sehingga koneksi yang diaktifkan dari host tidak akan dinonaktifkan dan modem harus secara otomatis membangun kembali koneksi dengan PDN tersebut setelah mengatur ulang. Setelah membuat koneksi dan menerima nilai PCO masuk baru dari jaringan, modem akan memberikan pemberitahuan NDIS_STATUS_WWAN_PCO_STATUS yang tidak diminta ke host.
Diagram berikut mengilustrasikan alur reset modem ketika salah satu skenario ini terjadi, dengan Verizon Wireless sebagai contoh MO:
Antarmuka NDIS ke modem
Untuk mengkueri status dan payload nilai PCO yang diterima modem dari jaringan operator, lihat OID_WWAN_PCO. OID_WWAN_PCO menggunakan struktur NDIS_WWAN_PCO_STATUS , yang pada gilirannya berisi struktur WWAN_PCO_VALUE yang mewakili payload informasi PCO dari jaringan.
Untuk pemberitahuan status yang dikirim oleh driver miniport modem untuk menginformasikan OS status PCO saat ini dalam modem, lihat NDIS_STATUS_WWAN_PCO_STATUS.
MB CID ke modem
Layanan = MBB_UUID_BASIC_CONNECT_EXT_CONSTANT
UUID Layanan = 3d01dcc5-fef5-4d05-0d3a-bef7058e9aaf
CID berikut didefinisikan untuk PCO:
| CID | Kode perintah | Versi OS Minimum |
|---|---|---|
| MBIM_CID_PCO | 9 | Windows 10, versi 1709 |
MBIM_CID_PCO
Perintah ini digunakan untuk mengkueri data PCO yang di-cache dalam modem dari jaringan operator seluler.
Kueri
InformationBuffer berisi MBIM_PCO_VALUE di mana satu-satunya bidang yang relevan adalah SessionId. SessionId dicadangkan untuk digunakan di masa mendatang dan akan selalu 0 dalam Windows 10, versi 1709. SessionId dalam kueri menunjukkan nilai PCO aliran data IP mana yang akan dikembalikan oleh fungsi.
Set
Tidak dapat diterapkan.
Peristiwa yang Tidak Diminta
Peristiwa yang tidak diminta berisi MBIM_PCO_VALUE dan dikirim ketika nilai PCO baru telah tiba pada koneksi yang diaktifkan.
Parameter
| Operasi | Set | Kueri | Pemberitahuan |
|---|---|---|---|
| Perintah | Tidak berlaku | MBIM_PCO_VALUE | Tidak berlaku |
| Respons | Tidak berlaku | MBIM_PCO_VALUE | MBIM_PCO_VALUE |
Struktur Data
MBIM_PCO_TYPE
| Jenis | Nilai | Deskripsi |
|---|---|---|
| MBIMPcoTypeComplete | 0 | Menentukan bahwa struktur PCO lengkap akan diteruskan seperti yang diterima dari jaringan dan header secara realistis mencerminkan protokol dalam oktet 3 dari struktur PCO, yang ditentukan dalam spesifikasi 3GPP TS24.008. |
| MBIMPcoTypePartial | 1 | Menentukan bahwa modem hanya akan meneruskan subset struktur PCO yang diterimanya dari jaringan. Header cocok dengan struktur PCO yang ditentukan dalam spesifikasi 3GPP TS24.008, tetapi "Protokol konfigurasi" oktet 3 mungkin tidak valid. |
MBIM-PCO-TYPE
| Offset | Ukuran | Bidang | Jenis | Deskripsi |
|---|---|---|---|---|
| 0 | 4 | SessionId | UINT32 | SessionId dalam kueri menunjukkan nilai PCO aliran data IP mana yang akan dikembalikan oleh fungsi. |
| 4 | 4 | PcoDataSize | UINT32 | Panjang PcoData, dari 0 hingga 256. Nilai ini akan menjadi 0 dalam kueri. |
| 8 | 4 | PcoDataType | UINT32 | Jenis data PCO. Untuk informasi selengkapnya, lihat MBIM_PCO_TYPE. |
| 12 | PcoDataBuffer | DATABUFFER | Struktur PCO dari spesifikasi 3GPP TS24.008. |
Kode Status
CID ini hanya menggunakan Kode Status Generik.
Uji Hardware Lab Kit (HLK)
Lihat Langkah-langkah untuk menginstal HLK.
Di HLK Studio, sambungkan ke driver modem Seluler perangkat dan jalankan pengujian: TestPco.