Operasi Lampirkan MB LTE
Konfigurasi APN Lampirkan LTE untuk Modem MBIM
Secara tradisional, lampiran LTE telah dianggap sebagai bagian dari pendaftaran dan Windows belum secara langsung terlibat dalam prosedur lampiran LTE. Namun, tidak seperti pendaftaran jaringan sakelar sirkuit biasa, LTE adalah jaringan khusus sakelar paket dan mengharuskan pembawa EPS default diaktifkan bagi perangkat untuk mempertahankan pendaftaran di jaringan LTE.
Untuk membuat pembawa EPS default dengan jaringan, perangkat harus meminta aktivasi konteks PDP selama prosedur lampiran LTE, yang memerlukan spesifikasi Nama Titik Akses (APN). Sesuai standar 3GPP, ada empat skenario di mana perangkat dapat menentukan APN saat mencoba melampirkan LTE:
- Perangkat menentukan APN lampiran LTE tertentu.
- Perangkat menentukan API lampiran LTE tertentu tetapi jaringan memutuskan untuk membiarkan perangkat terpasang pada APN lain sebagai gantinya selama roaming.
- Perangkat tidak menentukan API lampirkan LTE dan memungkinkan jaringan menetapkannya kembali ke perangkat.
- Perangkat yang terdaftar dari jaringan 2G/3G ke LTE dan sudah ada minimal satu konteks PDP aktif. Jaringan menggunakannya sebagai APIN lampirkan LTE.
Saat ini, semua informasi APN lampiran LTE disediakan oleh IHV dan OEM langsung dalam modem untuk setiap penyedia yang memiliki konfigurasi. Namun, ini bukan model yang sepenuhnya dapat diskalakan bagi IHV dan OEM untuk memiliki semua kemungkinan LTE melampirkan pengaturan APN untuk semua operator di seluruh dunia. Mulai Windows 10, versi 1703, antarmuka baru didefinisikan untuk OID NDIS dan CID milik Microsoft MBIM untuk mendukung konfigurasi APIN lampiran LTE dari OS.
Mulai Windows 10, versi 1703, jika perangkat keras yang mendasar mendukung LTE melampirkan konfigurasi APN dari OS maka pengguna akan dapat mengonfigurasi APIN lampiran LTE dari Pengaturan. Perangkat keras yang memiliki konfigurasi APN lampiran LTE default juga harus membuat konfigurasinya tersedia oleh OS.
Fitur ini didukung dengan menambahkan dua OID dan CID baru. Untuk mitra IHV yang menerapkan MBIM, hanya versi CID yang harus didukung.
Pembaruan Antarmuka MB untuk Operasi Lampirkan LTE
Dua CID MBIM baru telah dibuat untuk memungkinkan LTE melampirkan konfigurasi APN dan agar OS mengambil status lampiran LTE terbaru perangkat. Jika mitra IHV memutuskan untuk mendukung manajemen APN lampirkan LTE default OS, kedua perintah harus didukung.
Nama Layanan = Ekstensi Koneksi Dasar
UUID = UUID_BASIC_CONNECT_EXTENSIONS
Nilai UUID = 3d01dcc5-fef5-4d05-0d3abef7058e9aaf
| CID | Kode Perintah | Versi OS Minimum |
|---|---|---|
| MBIM_CID_MS_LTE_ATTACH_CONFIG | 3 | Windows 10, versi 1703 |
| MBIM_CID_MS_LTE_ATTACH_STATUS | 4 | Windows 10, versi 1703 |
MBIM_CID_MS_LTE_ATTACH_CONFIG
Deskripsi
Konteks lampiran LTE dapat berbeda, tergantung pada bagaimana jaringan berinteraksi dengan perangkat selama runtime. Untuk sisa dokumentasi ini, konteks lampiran LTE akan disebut sebagai konteks PDP saat ini yang sedang digunakan untuk lampiran LTE dan konteks lampiran LTE default akan disebut sebagai apa yang dikonfigurasi pada perangkat yang melakukan LTE attach dengan ketika tidak ada konteks PDP lain yang diaktifkan. MBIM_CID_MS_LTE_ATTACH_CONFIG memungkinkan OS ke Kueri dan Mengatur konteks lampiran LTE default dari penyedia SIM yang disisipkan (pasangan MCC/MNC).
Meskipun API lampirkan LTE dapat dianggap secara teknis sebagai konteks, hal ini berbeda dari semua konteks lain yang disimpan dalam modem. Untuk semua aktivasi konteks lainnya terjadi setelah pendaftaran dan, berdasarkan berbagai kondisi, OS dapat memutuskan konteks mana yang paling cocok untuk koneksi. Namun, konteks lampiran LTE diaktifkan sebagai bagian dari pendaftaran perangkat di jaringan LTE. OS tidak dapat mengambil status terkait jaringan apa pun sebelum penyelesaian pendaftaran; karena keterbatasan ini, OS harus dapat mengonfigurasi konteks lampiran LTE untuk semua kondisi roaming perangkat yang berbeda untuk memastikan perangkat dapat mendaftar di jaringan LTE terlepas dari status roamingnya.
Aktivasi konteks lampiran LTE dengan jaringan tidak memerlukan permintaan koneksi eksplisit OS karena OS tidak mengetahui aktivasi konteks modem yang dimulai sendiri. Konteks lampiran LTE default termasuk dalam kategori ini. Ketika OS mengeluarkan permintaan MBIM_CID_CONNECT untuk mengaktifkan konteks PDP dan konteks PDP yang diberikan cocok dengan semua hal berikut, modem harus menyelesaikan permintaan aktivasi CID dengan sukses tanpa memunculkan pembawa over-the-air baru dengan jaringan:
- Ada konteks PDP yang diaktifkan yang dimulai oleh modem dan tidak tersedia untuk OS.
- Konteks PDP cocok dengan APN yang ditentukan dalam permintaan CID.
- Jenis IP konteks PDP yang diaktifkan kompatibel dengan jenis IP yang diminta di CID.
Ini penting karena OS tidak mengetahui semua konteks PDP yang dimulai oleh modem. Ini akan mengurangi kebisingan dan beban jaringan. Jika tidak, modem harus memunculkan spesifikasi OS APN pencocokan pembawa over-the-air baru sesuai permintaan aktivasi konteks normal. Kompatibilitas jenis IP ditentukan di sini:
| Jenis IP konteks PDP yang diaktifkan dalam modem | Kompatibel dengan jenis IP yang diminta | Tidak kompatibel dengan jenis IP yang diminta |
|---|---|---|
| IPv4 | Default; IPv4; IPv4v6; IPv4 dan v6 | IPv6 |
| IPv6 | Default; IPv6; IPv4v6; IPv4 dan v6 | IPv4 |
| IPv4v6 | Default; IPv4; IPv6; IPv4v6; IPv4 dan v6 | Tidak ada |
Catatan
Modem tidak boleh memunculkan konteks PDP kedua jika hanya salah satu jenis IP yang diaktifkan melalui udara. Misalnya, jika IPv4 diaktifkan dan host meminta IPv4 dan IPv6 maka modem harus menyelesaikan permintaan aktivasi tanpa memunculkan pembawa IPv6.
Ketika OS mengeluarkan permintaan MBIM_CID_CONNECT untuk menonaktifkan konteks PDP, modem harus memeriksa hal berikut:
- Apakah perangkat terpasang LTE dan konteks yang akan dinonaktifkan adalah satu-satunya konteks PDP yang diaktifkan untuk mempertahankan pendaftaran LTE
- Apakah konteks yang akan dinonaktifkan juga digunakan oleh modem secara internal untuk layanan apa pun yang tidak terekspos ke OS
Jika salah satu dari ini benar, modem harus menyelesaikan permintaan penonaktifan CID tetapi terus mempertahankan pembawa over-the-air dengan jaringan. Jika tidak, modem harus menonaktifkan konteks sesuai permintaan penonaktifan normal.
Semua konfigurasi APN lampirkan LTE default yang disediakan oleh OS adalah per penyedia dan cocok dengan ID Penyedia rumah kartu SIM yang dimasukkan (pasangan MCC/MNC). Modem hanya boleh menyediakan konteks lampiran LTE yang dikonfigurasi untuk ID Penyedia SIM yang disisipkan saat ini saat dikueri. Modem harus selalu mengembalikan tiga konteks lampiran LTE default yang cocok dengan ID Penyedia SIM yang disisipkan, satu untuk setiap kondisi roaming (home/partner/non-partner).
Diharapkan bahwa di seluruh pertukaran SIM, modem harus menghapus konteks lampiran LTE defaultnya sebelum menerapkan konfigurasi untuk kartu SIM berikutnya. Jika kartu SIM yang baru dimasukkan tidak memiliki konfigurasi konteks lampiran LTE default, maka perangkat harus mengembalikan string kosong NULL untuk APN konteks lampiran LTE untuk semua kondisi roaming sambil menjaga konteks tetap diaktifkan. Jika konteks dinonaktifkan, perangkat diharapkan tidak melampirkan pada LTE karena tidak ada konfigurasi yang dapat digunakan untuk melampirkan LTE. Ketika pengguna bertukar kembali ke kartu SIM yang sebelumnya dikonfigurasi pada perangkat, modem harus memulihkan konfigurasi lampiran LTE default pabriknya untuk kartu SIM. Tidak diharapkan konfigurasi run time bertahan di seluruh pertukaran SIM. Kapan saja, seharusnya hanya ada satu APIN lampirkan LTE default dalam modem per kondisi roaming (home/partner/non-partner).
OS akan selalu mengatur ketiga konteks lampiran LTE default saat perintah Set dikeluarkan, satu untuk setiap kondisi roaming. Jika daftar yang disediakan oleh OS tidak memiliki tepat tiga maka perintah Set harus ditolak. Jika salah satu konteks lampiran LTE default yang disediakan dikonfigurasi oleh OS tempat kondisi roaming cocok dengan status pendaftaran saat ini, modem harus terlepas dari jaringan dan melakukan kembali LTE attach dengan konteks lampiran LTE yang baru ditentukan. Jika tidak, perangkat diharapkan untuk menggunakan konteks lampiran LTE default yang ditentukan lain kali saat kondisi roaming cocok. Jika konteks lampiran LTE default yang ditentukan perangkat gagal mendaftar di jaringan LTE, maka perangkat harus kembali ke 3G/2G sebagaimana mestinya. Ketika modem tidak dapat membedakan antara jaringan mitra dan non-mitra, modem harus menggunakan konteks lampiran LTE default non-mitra untuk semua skenario roaming. Jika OS mengonfigurasi konteks lampiran LTE default sebagai jenis IP = default, maka diharapkan modem menetapkan jenis IP yang paling sesuai untuk konteks lampiran LTE. Namun, OS mengharapkan modem untuk tetap mengembalikan kondisi roaming mitra dan jenis IP konteks lampiran LTE yang mencerminkan konfigurasi secara akurat.
IHV dan OEM dapat mengonfigurasi konteks lampiran LTE sebagai konfigurasi default dalam modem, tetapi konteks tersebut harus ditandai sebagai MBIM_MS_CONTEXT_SOURCE = MbimMsContextSourceModemProvisioned.
Sesuai standar 3GPP, konteks lampiran LTE default dapat dibagi menjadi dua kategori: dimulai UE dan dimulai jaringan. Jika perangkat dikonfigurasi dengan string akses kosong NULL, perangkat diharapkan tidak memberikan konteks lampiran LTE apa pun ke jaringan dan menunggu jaringan menetapkannya kembali ke perangkat. Sama seperti yang ditentukan oleh MBIM 1.0, jika jenis IP konteks lampiran LTE dikonfigurasi menjadi default maka modem harus memilih jenis IP terbaik berdasarkan algoritma internalnya.
Diagram berikut mengilustrasikan contoh alur konfigurasi lampiran LTE.
Kueri
MBIM_MS_LTE_ATTACH_CONFIG_INFO dikembalikan dari Kueri yang telah selesai dan Atur pesan di InformationBuffer. Untuk Kueri, InformationBuffer adalah NULL.
Set
Untuk Diatur, InformationBuffer berisi MBIM_MS_SET_LTE_ATTACH_CONFIG.
Peristiwa yang Tidak Diminta
Event InformationBuffer berisi struktur MBIM_MS_LTE_ATTACH_CONFIG_INFO. Dalam beberapa kasus, konteks lampiran LTE default diperbarui oleh jaringan baik Over-The-Air (OTA) atau oleh Layanan Pesan Singkat (SMS) yang tidak melewati perintah MBIM_CID_MS_LTE_ATTACH_CONFIG dari OS. Fungsi harus memperbarui konteks lampiran LTE default dan tag MBIM_MS_CONTEXT_SOURCE = MbimMsContextSourceOperatorProvisioned yang sesuai. Setelah itu, fungsi harus memberi tahu Host tentang pembaruan yang menggunakan peristiwa ini dengan daftar yang diperbarui.
Parameter
| Operasi | Set | Kueri | Pemberitahuan |
|---|---|---|---|
| Perintah | MBIM_SET_MS_LTE_ATTACH_CONFIG | Tidak berlaku | Tidak berlaku |
| Respons | MBIM_MS_LTE_ATTACH_CONFIG_INFO | MBIM_MS_LTE_ATTACH_CONFIG_INFO | MBIM_MS_LTE_ATTACH_CONFIG_INFO |
Struktur Data
Kueri
InformationBuffer adalah NULL dan InformationBufferLength adalah nol.
Set
Struktur MBIM_MS_SET_LTE_ATTACH_CONFIG berikut harus digunakan dalam InformationBuffer. Perintah Set hanya valid jika daftar berisi jumlah elemen tiga, satu untuk setiap kondisi roaming (rumah/mitra/non-mitra).
| Offset | Ukuran | Bidang | Jenis | Deskripsi |
|---|---|---|---|---|
| 0 | 4 | Operasi | MBIM_MS_LTE_CONTEXT_OPERATIONS | Menentukan jenis operasi yang digunakan perintah Set. Jika diatur ke MbimMsLteAttachContextOperationRestoreFactory, semua bidang lain harus diabaikan. Konteks lampiran LTE default yang dibuat OS atau -dimodifikasi harus dihapus dan konteks lampiran LTE default yang telah dikonfigurasi pabrik default harus dimuat. Jika modem tidak memiliki konfigurasi default, maka semua konteks lampiran LTE default kondisi roaming harus diatur ke string APN kosong dan jenis IP = default. |
| 4 | 4 | ElementCount (EC) | UINT32 | Jumlah struktur MBIM_MS_LTE_ATTACH_CONTEXT yang mengikuti di DataBuffer. Komponen ini saat ini ditentukan menjadi tiga, satu untuk setiap kondisi roaming (rumah/mitra/non-mitra). |
| 8 | 8 * EC | MsLteAttachContextRefList | OL_PAIR_LIST | Elemen pertama dari pasangan adalah offset 4 byte, dihitung dari awal (offset 0) dari struktur MBIM_MS_LTE_ATTACH_CONFIG_INFO ini, ke struktur MBIM_MS_LTE_ATTACH_CONTEXT (Untuk informasi selengkapnya, lihat tabel MBIM_MS_LTE_ATTACH_CONTEXT). Elemen kedua dari pasangan adalah ukuran 4 byte penunjuk ke struktur MBIM_MS_LTE_ATTACH_CONTEXT yang sesuai. |
| 8 + (8 * EC) | DataBuffer | DATABUFFER | Array struktur MBIM_MS_LTE_ATTACH_CONTEXT. |
Struktur berikut digunakan dalam tabel sebelumnya.
MBIM_MS_LTE_ATTACH_CONTEXT_OPERATIONS menjelaskan jenis operasi yang dapat digunakan dalam perintah Set.
| Jenis | Nilai | Deskripsi |
|---|---|---|
| MbimMsLteAttachContextOperationDefault | 0 | Operasi default untuk menimpa konteks lampiran LTE default yang ada dalam modem. OS akan selalu menggantikan ketiga konteks lampiran LTE default untuk kondisi roaming. |
| MbimMsLteAttachContextOperationRestoreFactory | 1 | Pulihkan konteks lampiran LTE default yang telah dikonfigurasi sebelumnya untuk ID Penyedia SIM yang saat ini disisipkan. Semua konteks lampiran LTE default yang diganti atau dibuat oleh OS harus dihapus dan diganti. Jika tidak ada konteks lampiran LTE default yang telah dikonfigurasi sebelumnya default untuk ID Penyedia SIM yang disisipkan saat ini dengan satu atau beberapa kondisi roaming, maka lampiran LTE default harus mengembalikan string APN kosong dan jenis IP = default. |
MBIM_MS_LTE_ATTACH_CONTEXT menentukan konteks yang akan digunakan untuk konfigurasi lampiran LTE.
| Offset | Ukuran | Bidang | Jenis | Deskripsi |
|---|---|---|---|---|
| 0 | 4 | IPType | MBIM_CONTEXT_IP_TYPE | Untuk informasi selengkapnya, lihat tabel MBIM_CONTEXT_IP_TYPE. |
| 4 | 4 | Roaming | MBIM_MS_LTE_ATTACH_CONTEXT_ROAMING_CONTROL | Menunjukkan kondisi roaming mana yang berlaku untuk konteks lampiran LTE default ini. Untuk informasi selengkapnya, lihat tabel MBIM_MS_LTE_ATTACH_CONTEXT_ROAMING_CONTROL. |
| 8 | 4 | Source | MBIM_MS_CONTEXT_SOURCE | Menentukan sumber pembuatan konteks. Untuk informasi selengkapnya, lihat tabel MBIM_MS_CONTEXT_SOURCE. |
| 12 | 4 | AccessStringOffset | OFFSET | Offset dalam buffer data ke string, AccessString, untuk mengakses jaringan. Untuk jaringan berbasis GSM, ini akan menjadi string Nama Titik Akses (APN) seperti "data.thephone-company.com". Ukuran string tidak boleh melebihi 100 karakter. Jika AccessString kosong, maka perangkat mengharapkan jaringan untuk menetapkan string akses kembali ke perangkat. Jenis IP masih harus ditentukan dalam kasus ini. |
| 16 | 4 | AccessStringSize | SIZE(0..200) | Ukuran yang digunakan untuk AccessString. Nilai ini harus 0 jika perangkat mengharapkan jaringan untuk menetapkan string akses kembali ke perangkat untuk melampirkan LTE. |
| 20 | 4 | UserNameOffset | OFFSET | Offset dalam byte, dihitung dari awal struktur ini, ke string, UserName, yang mewakili nama pengguna untuk mengautentikasi. Anggota ini bisa NULL. |
| 24 | 4 | UserNameSize | SIZE(0..510) | Ukuran yang digunakan untuk UserName. |
| 28 | 4 | PasswordOffset | OFFSET | Offset dalam byte, dihitung dari awal struktur ini, ke string, Kata Sandi, yang mewakili kata sandi nama pengguna. Anggota ini bisa NULL. |
| 32 | 4 | Ukuran Kata Sandi | SIZE(0..510) | Ukuran yang digunakan untuk Kata Sandi. |
| 36 | 4 | Kompresi | MBIM_COMPRESSION | Menentukan kompresi yang akan digunakan dalam koneksi data untuk header dan data. Anggota ini hanya berlaku untuk perangkat berbasis GSM. Host mengatur anggota ini ke MBIMCompressionNone untuk perangkat berbasis CDMA. Untuk informasi selengkapnya, lihat tabel MBIM_COMPRESSION. |
| 40 | 4 | AuthProtocol | MBIM_AUTH_PROTOCOL | Jenis autentikasi yang digunakan untuk aktivasi PDP. Untuk informasi selengkapnya, lihat tabel MBIM_AUTH_PROTOCOL. |
| 44 | DataBuffer | DATABUFFER | Buffer data yang berisi AccessString, UserName, dan Password. |
MBIM_MS_LTE_ATTACH_CONTEXT_ROAMING_CONTROL menunjukkan kondisi roaming mana yang berlaku untuk konteks lampiran LTE default ini.
| Jenis | Nilai | Deskripsi |
|---|---|---|
| MbimMsLteAttachContextRoamingControlHome | 0 | Menunjukkan apakah konteks lampiran LTE default diizinkan untuk digunakan pada jaringan rumah atau tidak. |
| MbimMsLteAttachContextRoamingControlPartner | 1 | Menunjukkan apakah konteks diizinkan untuk digunakan pada jaringan roaming mitra atau tidak. |
| MbimMsLteAttachContextRoamingControlNonPartner | 2 | Menunjukkan apakah konteks diizinkan untuk digunakan pada jaringan roaming non-mitra atau tidak. |
MBIM_MS_CONTEXT_SOURCE menentukan sumber pembuatan konteks.
| Jenis | Nilai | Deskripsi |
|---|---|---|
| MbimMsContextSourceAdmin | 0 | Konteks dibuat oleh admin IT Perusahaan dari OS. |
| MbimMsContextSourceUser | 1 | Konteks dibuat oleh pengguna melalui pengaturan OS. |
| MbimMsContextSourceOperator | 2 | Konteks dibuat oleh operator melalui OMA-DM atau saluran lainnya. |
| MbimMsContextSourceModem | 3 | Konteks dibuat oleh IHV atau OEM. |
| MbimMsContextSourceDevice | 4 | Konteks dibuat oleh database OS APN. |
Respons
Struktur MBIM_MS_LTE_ATTACH_CONFIG_INFO berikut akan digunakan dalam InformationBuffer.
| Offset | Ukuran | Bidang | Jenis | Deskripsi |
|---|---|---|---|---|
| 0 | 4 | ElementCount (EC) | UINT32 | Jumlah struktur MBIM_MS_LTE_ATTACH_CONTEXT yang mengikuti di DataBuffer. Komponen ini saat ini ditentukan menjadi tiga, satu untuk setiap kondisi roaming (rumah/mitra/non-mitra). |
| 4 | 8 * EC | MsLteAttachContextRefList | OL_PAIR_LIST | Elemen pertama dari pasangan adalah offset 4-byte, dihitung dari awal (offset 0) dari struktur MBIM_MS_LTE_ATTACH_CONFIG_INFO ini, ke struktur MBIM_MS_LTE_ATTACH_CONTEXT (Untuk informasi selengkapnya, lihat tabel MBIM_MS_LTE_ATTACH_CONTEXT). Elemen kedua dari pasangan adalah ukuran 4 byte dari penunjuk ke struktur MBIM_MS_LTE_ATTACH_CONTEXT yang sesuai. |
| 4 + (8 * EC) | DataBuffer | DATABUFFER | Array struktur MBIM_MS_LTE_ATTACH_CONTEXT. |
Pemberitahuan
Untuk informasi selengkapnya, lihat tabel MBIM_MS_LTE_ATTACH_CONFIG_INFO.
Kode Status
Untuk operasi Kueri dan Atur:
| Kode Status | Deskripsi |
|---|---|
| MBIM_STATUS_READ_FAILURE | Operasi gagal karena perangkat tidak dapat mengambil konteks yang disediakan. |
| MBIM_STATUS_NO_DEVICE_SUPPORT | Operasi gagal karena perangkat tidak mendukung operasi. |
Untuk Atur operasi saja:
| Kode Status | Deskripsi |
|---|---|
| MBIM_STATUS_INVALID_PARAMETERS | Operasi gagal karena parameter yang tidak valid. |
| MBIM_STATUS_WRITE_FAILURE | Operasi gagal karena permintaan pembaruan tidak berhasil. |
MBIM_CID_MS_LTE_ATTACH_STATUS
Deskripsi
Per persyaratan 3GPP, meskipun perangkat dapat menentukan konteks lampiran LTE default yang akan digunakan saat LTE melampirkan ke jaringan tanpa konteks PDP yang diaktifkan, mungkin ada situasi di mana perangkat akan melampirkan LTE pada konteks PDP yang berbeda dari konteks lampiran LTE default yang dikonfigurasi pada perangkat. Berikut ini adalah daftar semua skenario yang mungkin:
- UE menentukan APN lampiran LTE tertentu.
- UE menentukan APIN lampiran LTE tertentu tetapi jaringan memutuskan untuk membiarkan perangkat terpasang pada APN lain sebagai gantinya selama roaming.
- UE tidak menentukan APN lampirkan LTE dan memungkinkan jaringan menetapkannya kembali ke perangkat.
- UE terdaftar dari jaringan 2G/3G ke LTE dan sudah ada minimal satu konteks PDP aktif. Jaringan menggunakannya sebagai APIN lampirkan LTE.
Ketika LTE default perangkat terpasang, perangkat harus mengirim pemberitahuan MBIM_CID_MS_LTE_ATTACH_STATUS ke OS untuk memberikan detail konteks PDP pada lampiran LTE terbaru. Lampiran LTE default terjadi ketika salah satu skenario berikut terpenuhi:
- Perangkat awalnya terpasang ke jaringan LTE.
- Perangkat menyerahkan dari 2G/3G ke LTE tanpa konteks PDP yang diaktifkan sebelumnya.
Konteks lampiran LTE yang dikembalikan dari MBIM_CID_LTE_ATTACH_STATUS bisa menjadi salah satu dari berikut ini:
- Konteks lampiran LTE default disimpan dalam modem.
- Konteks lampiran LTE default yang ditetapkan kembali dari jaringan.
Selama runtime, OS juga harus dapat mengkueri informasi lampiran yang terakhir digunakan untuk lampiran LTE default. Modem diharapkan untuk mengembalikan konteks lampiran LTE default terakhir yang diketahui. Jika perangkat diserahkan dari jaringan LTE ke 2G/3G, modem diharapkan mengembalikan konteks yang digunakan untuk lampiran LTE sebelumnya. Setiap kali perangkat membatalkan pendaftaran dari jaringan, apn diharapkan menjadi kosong.
Diagram di bawah ini mengilustrasikan contoh alur pesan untuk status lampiran LTE.
Kueri
MBIM_MS_LTE_ATTACH_STATUS dikembalikan dari Kueri pesan lengkap di InformationBuffer. Untuk Kueri, InformationBuffer adalah NULL.
Set
Operasi set tidak didukung.
Peristiwa yang Tidak Diminta
Event InformationBuffer berisi struktur MBIM_MS_LTE_ATTACH_STATUS.
Parameter
| Operasi | Set | Kueri | Pemberitahuan |
|---|---|---|---|
| Perintah | Tidak berlaku | Tidak berlaku | Tidak berlaku |
| Respons | Tidak berlaku | MBIM_MS_LTE_ATTACH_STATUS | MBIM_MS_LTE_ATTACH_STATUS |
Struktur Data
Kueri
InformationBuffer adalah NULL dan InformationBufferLength akan menjadi nol.
Set
Operasi set tidak didukung.
Respons
Struktur MBIM_MS_LTE_ATTACH_STATUS berikut akan digunakan dalam InformationBuffer.
| Offset | Ukuran | Bidang | Jenis | Deskripsi |
|---|---|---|---|---|
| 0 | 4 | LteAttachState | MBIM_MS_LTE_ATTACH_STATE | Menunjukkan apakah perangkat saat ini terpasang ke jaringan LTE atau tidak. Untuk informasi selengkapnya, lihat tabel MBIM_MS_LTE_ATTACH_STATE. |
| 4 | 4 | IPType | MBIM_CONTEXT_IP_TYPES | Untuk informasi selengkapnya, lihat tabel MBIM_CONTEXT_IP_TYPE. |
| 8 | 4 | AccessStringOffset | OFFSET | Offset dalam buffer data ke string, AccessString, untuk mengakses jaringan. Untuk jaringan berbasis GSM, ini akan menjadi string Nama Titik Akses (APN) seperti "data.thephone-company.com". Untuk jaringan berbasis CDMA, ini mungkin kode panggilan khusus seperti "#777" atau Pengidentifikasi Akses Jaringan (NAI) seperti "foo@thephone-company.com". Anggota ini dapat berupa NULL untuk meminta jaringan menetapkan APN default. Catatan: Tidak semua jaringan mendukung konvensi APN NULL ini. Oleh karena itu, kegagalan koneksi yang disebabkan oleh APN yang tidak valid adalah kemungkinan hasil. Ukuran string tidak boleh melebihi 100 karakter. |
| 12 | 4 | AccessStringSize | SIZE(0..200) | Ukuran dalam byte yang digunakan untuk AccessString. |
| 16 | 4 | UserNameOffset | OFFSET | Offset dalam byte, dihitung dari awal struktur ini, ke string, UserName, yang mewakili nama pengguna untuk mengautentikasi. Anggota ini bisa NULL. |
| 20 | 4 | UserNameSize | SIZE(0..510) | Ukuran dalam byte yang digunakan untuk UserName. |
| 24 | 4 | PasswordOffset | OFFSET | Offset dalam byte, dihitung dari awal struktur ini, ke string, Kata Sandi, yang mewakili kata sandi nama pengguna. Anggota ini bisa NULL. |
| 28 | 4 | Ukuran Kata Sandi | SIZE(0..510) | Ukuran dalam byte yang digunakan untuk Kata Sandi. |
| 32 | 4 | Kompresi | MBIM_COMPRESSION | Menentukan kompresi yang akan digunakan dalam koneksi data untuk header dan data. Anggota ini hanya berlaku untuk perangkat berbasis GSM. Host menetapkan anggota ini ke MBIMCompressionNone untuk perangkat berbasis CDMA. Untuk informasi selengkapnya, lihat tabel MBIM_COMPRESSION. |
| 36 | 4 | AuthProtocol | MBIM_AUTH_PROTOCOL | Jenis autentikasi yang digunakan untuk aktivasi PDP. Untuk informasi selengkapnya, lihat tabel MBIM_AUTH_PROTOCOL. |
| 40 | 4 | DataBuffer | DATABUFFER |
Struktur data berikut digunakan dalam tabel sebelumnya.
MBIM_MS_LTE_ATTACH_STATE menunjukkan apakah perangkat saat ini terpasang pada jaringan LTE atau tidak.
| Jenis | Nilai | Deskripsi |
|---|---|---|
| MbimMsLteAttachStateDetached | 0 | Menunjukkan perangkat tidak terpasang ke jaringan LTE. |
| MbimMsLteAttachStateAttached | 1 | Menunjukkan perangkat terpasang ke jaringan LTE. |
Pemberitahuan
Untuk informasi selengkapnya, lihat tabel MBIM_MS_LTE_ATTACH_STATUS.
Kode Status
Untuk operasi Kueri dan Atur:
| Kode Status | Deskripsi |
|---|---|
| MBIM_STATUS_READ_FAILURE | Operasi gagal karena perangkat tidak dapat mengambil konteks yang disediakan. |
| MBIM_STATUS_NO_DEVICE_SUPPORT | Operasi gagal karena perangkat tidak mendukung operasi. |
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.TestLteAttach.
Atau, jalankan testlist TestLteAttach HLK dengan netsh-mbn dan netsh-mbn-test-installation.
netsh mbn test feature=lte testpath="C:\\data\\test\\bin" taefpath="C:\\data\\test\\bin"
File ini menunjukkan hasil pengujian HLK seharusnya dihasilkan di direktori tempat perintah 'netsh mbn test' dijalankan dari: TestLteAttach.htm.
Pengujian Manual
- Persyaratan: Sim dengan pengaturan APN yang benar dan satu informasi APN lagi untuk penggunaan manual.
- Buka Pengaturan-Jaringan> & Internet -> Seluler
- Klik Opsi tingkat lanjut
Menggunakan Pengaturan Seluler:
- Setidaknya harus ada apn yang merupakan pengaturan dari informasi sim. Anda bisa mendapatkan informasi terperinci APN dengan mengklik APN dan mengklik tombol "lihat".
Menggunakan Pengaturan Manual:
- Ikuti bagian "Tambahkan APN" di Pengaturan seluler untuk mengatur APN secara manual.
- Lampirkan APN dan periksa status terlampir.
Panduan Pemecahan Masalah Lampirkan MB LTE
- Dapatkan semua profil Lampirkan APN di bawah %ProgramData%\Microsoft\WwanSvc\DMProfiles
- Memahami profil tertentu mana yang akan diterapkan berdasarkan prioritas jenis pembuatan
- Selidiki log untuk memeriksa mengapa LTE Attach APN salah dikonfigurasi
- Mengumpulkan dan mendekode log menggunakan instruksi dalam Mengumpulkan Log
- Buka file .txt yang dihasilkan di TextAnalysisTool
- Memuat filter Lampirkan LTE
Contoh log LTE Attach
10409 [0]0370.0434::2020-03-06 01:16:13.118424000 [WwanDimCommon] ReadyState : WwanReadyStateInitialized (0x1)
14137 [0]0370.0684::2020-03-06 01:16:13.146883200 [WwanProfileManager]INFO: SaveModemConfiguredLteAttachConfig: added modem configured LTE attach profile
14362 [0]0370.0684::2020-03-06 01:16:13.149255900 [WwanProfileManager]INFO: SaveModemConfiguredLteAttachConfig: added modem configured LTE attach profile
14476 [1]0370.0434::2020-03-06 01:16:13.149677900 [WwanDimCommon] ReadyState : WwanReadyStateInitialized (0x1)
14503 [0]0370.0684::2020-03-06 01:16:13.151412000 [WwanProfileManager]INFO: SaveModemConfiguredLteAttachConfig: added modem configured LTE attach profile
14962 [0]0370.0684::2020-03-06 01:16:13.156860700 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanDataExecutor::OnLteAttachProfileUpdate: WwanPmGetLteAttachProfileInEffect() didn't find anything, using Network Assigned.
14963 [0]0370.0684::2020-03-06 01:16:13.156862600 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanDataExecutor::OnLteAttachProfileUpdate: LTEAttachConfig has same config as modem has, skip