MBIMEx 2.0 – 5G NSA 支援
因為 MBIM 1.0 errata 規格缺少變更具有新承載或修改承載的現有 CID 的機制，Windows 10 1903 版引進 MBIM 1.0 延伸模組 2.0 來擴充介面以支援 5G。
版本設定配置
注意
在本節中， MBIMEx 版本 一詞是指 MBIM Extensions 版本號碼。
主機會透過兩種方式了解裝置的 MBIMEx 版本：
- MBIM 擴充功能描述元。
- 如果裝置支援該訊息，則為選擇性MBM_CID_VERSION訊息，並宣告其支援。
如果這兩者不同，較高版本會指定裝置持續列舉至主機的 MBIMEx 版本。 較高的 MBIMEx 版本稱為裝置 宣佈的 MBIMEx 版本。 裝置宣佈的 MBIMEx 版本可以低於其原生 MBIMEx 版本，這是裝置支援的最高 MBIMEx 版本。 裝置只能透過MBIM_CID_VERSION訊息明確瞭解主機的 MBIMEx 版本。
在任何版本中，主機一律會使用裝置初始化順序開頭的 MBIM_CID_DEVICE_SERVICES，查詢裝置中支援的服務和 CID。
如果裝置支援MBIM_CID_VERSION，並在MBIM_CID_DEVICE_SERVICES查詢回應中公告其支援，則無法瞭解MBIM_CID_VERSION或 MBIMEx 版本低於 2.0 的主機會忽略它。 同時，瞭解MBIM_CID_VERSION且具有原生 MBIMEx 2.0 版或更新版本的主機會將MBIM_CID_VERSION訊息傳送至具有主機原生 MBIMEx 版本的裝置，而 CID 是接收MBIM_CID_DEVICE_SERVICES回應之後傳送到裝置的第一個 CID。
如果裝置在回應MBIM_CID_DEVICE_SERVICES查詢之後從主機接收的第一個 CID MBIM_CID_VERSION，裝置就會知道主機的 MBIMEx 版本。
如果裝置在回應MBIM_CID_DEVICE_SERVICES查詢之後從主機接收的第一個 CID 是任何其他 CID，則裝置會假設主機的原生 MBIMEx 版本為 1.0。
如果裝置不支援MBIM_CID_VERSION，則不會回應具有MBIM_CID_VERSION的MBIM_CID_DEVICE_SERVICES查詢。 因此主機不會傳送MBIM_CID_VERSION訊息，並假設裝置的原生 MBIMEx 版本為 1.0。
功能上，較高的 MBIMEx 版本是所有較低 MBIMEx 版本的超集。 主機支援所有在主機原生 MBIMEx 版本下方宣告 MBIMEx 版本的裝置。 如果裝置宣佈的 MBIMEx 版本高於主機的原生 MBIMEx 版本，則主機不預期支援裝置，在此情況下主機的確切行為是未定義的。
想要與較舊主機搭配運作的裝置一開始應該公告 MBIMEx 1.0 版或裝置預定在 MBIM 擴充功能描述元中運作的最低主機 MBIMEx 版本。
如果主機傳送的MBIM_CID_VERSION，其 MBIMEx 版本高於最初公告的裝置，則裝置應該在MBIM_CID_VERSION回應中指出較高的 MBIMEx 版本，最多回應較小的主機原生 MBIMEx 版本和裝置的原生 MBIMEx 版本。
注意
例如，裝置支援 MBIMEx 2.0 版，但旨在與不支援 MBIMEx 2.0 的舊版作業系統搭配使用。 裝置一開始會在USB描述元中公告 MBIMEx 1.0 版，並公告選擇性MBIM_CID_VERSION的支援。 插入執行 Windows 10 1803 版的主機時，主機無法瞭解MBIM_CID_VERSION，也不會將MBIM_CID_VERSION傳送至裝置。 對於主機，裝置的 MBIMEx 版本為 1.0。 主機會繼續在初始化順序中傳送其他 CID。 收到MBIM_CID_VERSION以外的 CID 時，裝置知道主機支援 MBIMEx 1.0 版。 這兩端會繼續符合 MBIMEx 1.0 版。 之後，當相同的裝置插入執行 Windows 10 1903 版且原生 MBIMEx 版本為 2.0 的主機時，主機會將MBIM_CID_VERSION傳送至裝置，以通知主機的原生 MBIMEx 版本為 2.0。 裝置會以裝置宣佈的 MBIMEx 2.0 版回應，將MBIM_CID_VERSION傳回。 這兩端會繼續符合 MBIMEx 2.0 版。
下表顯示具有三個假設主機和三個假設裝置的相容性矩陣，每個裝置都有其原生 MBIMEx 版本所述。 裝置一開始會在USB描述元中公告 MBIMEx 1.0 版。 矩陣顯示每個裝置如何與每部主機搭配運作。
| ) ) / 主機 (右下方的裝置 ( | Windows 10 版本 1809 或 (更早版本的原生 MBIMEx 1.0 版) | Windows 10 1903 版和更新版本 (MBIMEx 2.0 版) |
|---|---|---|
| 4G 裝置 原生 MBIMEx 1.0 版 |
裝置一開始會公告 MBIMEx 1.0。 沒有MBIM_CID_VERSION交換。 相容的裝置和主機。 默認適用於 MBIMEx 1.0 版。 | 裝置一開始會公告 MBIMEx 1.0。 沒有MBIM_CID_VERSION交換。 主機會使用 MBIMEx 1.0 與裝置搭配運作。 |
| 5G NSA 裝置 原生 MBIMEx 2.0 版 |
裝置一開始會公告 MBIMEx 1.0。 沒有MBIM_CID_VERSION交換。 裝置知道主機有 MBIMEx 1.0，並繼續進行 MBIMEx 1.0。 | 裝置一開始會公告 MBIMEx 1.0。 主機會傳送MBIM_CID_VERSION，通知裝置主機支援 MBIMEx 2.0。 裝置會以 MBIMEx 2.0 回應。 這兩端會繼續進行 MBIMEx 2.0。 |
下表列出 MBIMEx 2.0 版中修改的所有現有 CID，以及其修改的承載。 這些 CID 中所有未提及的承載，以及數據表中未提及的所有其他 CID 會從 MBIMEx 1.0 版接管，並維持不變。
| CID | 承載重量 |
|---|---|
| MBIM_CID_REGISTER_STATE | MBIM_REGISTRATION_STATE_INFO_V2 |
| MBIM_CID_PACKET_SERVICE | MBIM_PACKET_SERVICE_INFO_V2 |
| MBIM_CID_SIGNAL_STATE | MBIM_SIGNAL_STATE_INFO_V2 |
MBIM 服務
| 服務名稱 | UUID | UUID 值 |
|---|---|---|
| Microsoft 基本IP連線延伸模組 | UUID_BASIC_CONNECT_EXTENSIONS | 3D01DCC5-FEF5-4D05-9D3A-BEF7058E9AAF |
MBIM_CID_VERSION
對於支援 MBIM Microsoft 擴充功能 2.0 或更新版本的 MBB 驅動程式，MBIM_CID_VERSION是在主機與裝置之間交換 MBIM 版本資訊的必要命令。 對於具有無法辨識此 CID 之驅動程式的市場內裝置，主機會假設並提供回溯相容性。
如果裝置支援此命令，主機會以查詢的形式傳送此命令。 此查詢包含主機目前支援的 MBIM 版本號碼和 MBIM 延伸模組版本號碼。
在裝置端，裝置會根據 版本設定配置中定義的規則來調整其宣佈的 MBIM 版本號碼和 MBIM 延伸模組版本號碼，然後在回應中傳送它們給主機。
此命令定義於 Basic Connect 擴充功能 服務之下。
| CID | 命令程序代碼 | UUID |
|---|---|---|
| MBIM_CID_VERSION | 15 | 3d01dcc5-fef5-4d05-0d3abef7058e9aaf |
參數
| 作業 | Set | 查詢 | 通知 |
|---|---|---|---|
| 命令 | 不適用 | MBIM_VERSION_INFO | 不適用 |
| 回應 | 不適用 | MBIM_VERSION_INFO | 不適用 |
查詢
通知裝置主機的原生 MBIM 版本號碼和 MBIM 擴充功能版本號碼。 InformationBuffer 包含下列MBIM_VERSION_INFO結構。
| Offset | 大小 | 欄位 | 類型 | 描述 |
|---|---|---|---|---|
| 0 | 2 | bcdMBIMVersion | UINT16 | BCD 中發件者的 MBIM 版本號碼，位 7 到 8 之間具有隱含的小數點。 例如： 0x0100 == 1.00 == 1.0 。 這是位元組的位元組0x00，然後0x01。 |
| 2 | 2 | bcdMBIMExtendedVersion | UINT16 | BCD 中發件者的 MBIM 延伸模組版本號碼，位 7 到 8 之間具有隱含的小數點。 例如： 0x0100 == 1.00 == 1.0 。 這是位元組的位元組0x00，然後0x01。 |
Set
不適用。
回應
MBIM_COMMAND_DONE中的 InformationBuffer 包含MBIM_VERSION_INFO結構。
未經請求的事件
不適用。
狀態碼
此 CID 只會使用 MBIM 規格修訂 1.0 第 9.4.5 節中定義的一般狀態代碼。
MBIM_CID_MS_DEVICE_CAPS_V2
此 CID 與 MB Multi-SIM 作業上定義的相同，其本身是 MBIM 規格修訂 1.0 第 10.5.1 節中所定義的MBIM_CID_MS_DEVICE_CAPS延伸模組。 針對 MBIM 擴充功能 2.0 版，MBIM_DATA_CLASS數據表中定義了新的數據類別，可讓裝置報告其 5G 功能。 MBIMDataClass5G_NSA表示裝置支援 5G 非獨立 (NSA) ，定義於 3GPP TS 37.340，MBIMDataClass5G_SA表示裝置支援 5G 獨立 (SA) ，也定義於 3GPP TS 37.340 中。
如果裝置同時支援這兩個新的數據類別，則應該設定這兩個位。
MBIM_DATA_CLASS
| 類型 | Mask |
|---|---|
| MBIMDataClassNone | 0h |
| MBIMDataClassGPRS | 1h |
| MBIMDataClassEDGE | 2h |
| MBIMDataClassUMTS | 4h |
| MBIMDataClassHSDPA | 8h |
| MBIMDataClassHSUPA | 10h |
| MBIMDataClassLTE | 20h |
| MBIMDataClass5G_NSA | 40h |
| MBIMDataClass5G_SA | 80h |
| 保留 | 100h-8000h |
| MBIMDataClass1XRTT | 10000h |
| MBIMDataClass1XEVDO | 20000h |
| MBIMDataClass1XEVDORevA | 40000h |
| MBIMDataClass1XEVDV | 80000h |
| MBIMDataClass3XRTT | 100000h |
| MBIMDataClass1XEVDORevB | 200000h |
| MBIMDataClassUMB | 400000h |
| 保留 | 800000-40000000h |
| MBIMDataClassCustom | 80000000h |
MBIM_CID_REGISTER_STATE
此命令是 MBIM 規格 1.0 版中已定義MBIM_CID_REGISTER_STATE CID 的擴充功能。 此延伸模組會為響應結構新增名為 PreferredDataClasses 的新成員。
參數
| 作業 | Set | 查詢 | 通知 |
|---|---|---|---|
| 命令 | MBIM_SET_REGISTRATION_STATE | Empty | 不適用 |
| 回應 | MBIM_REGISTRATION_STATE_INFO_V2 | MBIM_REGISTRATION_STATE_INFO_V2 | MBIM_REGISTRATION_STATE_INFO_V2 |
查詢
InformationBuffer 為 Null，且 InformationBufferLength 為零。
Set
設定註冊狀態。 此資訊與 MBIM 規格修訂 1.0 中所述相同。
回應
MBIM_COMMAND_DONE中的 InformationBuffer 包含下列MBIM_REGISTRATION_STATE_INFO_V2結構。 相較於 MBIM 規格修訂 1.0 第 10.5.10.6 節中定義的MBIM_REGISTRATION_STATE_INFO結構，下列結構具有新的 PreferredDataClasses 位元段。 除非在此說明， 否則 MBIM 規格修訂 1.0 中表 10-55 中的欄位描述適用於此結構。
MBIM_REGISTRATION_STATE_INFO_V2
| Offset | 大小 | 欄位 | 類型 | 描述 |
|---|---|---|---|---|
| 0 | 4 | NwError | UINT32 | 網路特定錯誤。 MBIM 規格修訂 1.0 中的表 10-44 記載 NwError 的原因碼。 |
| 4 | 4 | RegisterState | MBIM_REGISTER_STATE | 請參閱 MBIM 規格修訂 1.0 中的表 10-46。 |
| 8 | 4 | RegisterMode | MBIM_REGISTER_MODE | 請參閱 MBIM 規格修訂 1.0 中的表 10-47。 |
| 12 | 4 | AvailableDataClass | UINT32 | MBIM_DATA_CLASS 中值的點陣圖，代表已註冊網路上支援的數據類別，用於註冊裝置的數據格。 如果 RegisterState 不是 MBIMRegisterStateHome、 MBIMRegisterStateRoaming 或 MBIMRegisterStatePartner，這個值就會設定為 MBIMDataClassNone。 |
| 16 | 4 | CurrentCellularClass | MBIM_CELLULAR_CLASS | 表示用於多重模式函式的目前行動數據類別。 如需詳細資訊，請參閱 MBIM 規格修訂 1.0 中的表格 10-8 。 對於單一模式函式，這與MBIM_CID_DEVICE_CAPS中所報告的行動電話通訊類別相同。 對於多重模式函式，會以更新 的 CurrentCellularClass 指出從 CDMA 轉換至 GSM，反之亦然。 |
| 20 | 4 | ProviderIdOffset | OFFSET | 從這個 結構的開頭算出的位元組位移，到數值 (0-9) 字串，稱為 ProviderId ，代表網路提供者識別。 針對 GSM 型網路，此字串是三位數的行動國家/地區代碼串連 (MCC) ，以及兩位數或三位數的行動網路代碼 (MNC) 。 GSM 型電信業者可能有多個 MNC，因此有多個 ProviderId。 對於 CDMA 型網路，此字串是五位數的系統標識碼 (SID) 。 一般而言，CDMA 型電信業者有多個 SID。 一般而言，電信業者針對每個市場都有一個 SID，通常會依法規在地理上分割，例如 美國 中的「城市統計區域」 (MSA) 。 如果無法使用此資訊，CDMA 型裝置必須指定MBIM_CDMA_DEFAULT_PROVIDER_ID。 處理查詢要求且註冊狀態處於自動註冊模式時，此成員會包含裝置目前相關聯的提供者標識碼，如果適用) ，則裝置目前與該標識符相關聯 (。 當註冊狀態處於手動註冊模式時，此成員會包含要求裝置註冊的提供者標識符， (即使提供者無法使用) 也一樣。 處理設定要求且註冊狀態處於手動模式時，這會包含主機所選取的提供者標識碼，用來註冊裝置。 當註冊狀態處於自動註冊模式時，會忽略此參數。 如果提供者標識碼無法使用，則CDMA 1xRTT提供者必須設定為 MBIM_CDMA_DEFAULT_PROVIDER_ID。 |
| 24 | 4 | ProviderIdSize | SIZE (0..12) | ProviderId 的大小，以位元組為單位。 |
| 28 | 4 | ProviderNameOffset | OFFSET | 以位元組為單位的位移，從這個 結構的開頭算出到名為 ProviderName 的字串，代表網路提供者的名稱。 此成員最多只能MBIM_PROVIDERNAME_LEN個字元。 針對 GSM 型網路，如果 [國家/地區縮寫] 和 [行動網路名稱] 的慣用簡報 (PCCI&N) 超過 20 個字元，裝置應該縮寫網络名稱。 當主機設定慣用的提供者清單時，會忽略此成員。 裝置應該為沒有這項資訊的裝置指定NULL字串。 |
| 32 | 4 | ProviderNameSize | SIZE (0..40) | ProviderName 的大小，以位元組為單位。 |
| 36 | 4 | RoamingTextOffset | OFFSET | 以位元組為單位的位移，從這個結構的開頭算出到名為 RoamingText 的字串，以通知使用者裝置正在漫遊。 此成員最多只能有63個字元。 當註冊狀態為 MBIMRegisterStatePartner 或 MBIMRegisterStateRoaming 時，此文字應該會為使用者提供其他資訊。 這個成員是選擇性的。 |
| 40 | 4 | RoamingTextSize | SIZE (0..126) | RoamingText 的大小，以位元組為單位。 |
| 44 | 4 | RegistrationFlag | MBIM_REGISTRATION_FLAGS | MBIM 規格修訂 1.0 中的每個表格 10-48 所設定的旗標。 |
| 48 | 4 | PreferredDataClass | UINT32 | MBIM_DATA_CLASS中值的點陣圖，表示裝置上已啟用的數據類別。 裝置只能使用已啟用的數據類別運作。 |
| 動態 | 4 | DataBuffer | DATABUFFER | 包含 ProviderId、 ProviderName 和 RoamingText 的數據緩衝區。 |
未經請求的事件
通知包含MBIM_REGISTRATION_STATE_INFO_V2結構。
狀態碼
此 CID 只會使用 MBIM 規格 1.0 第 9.4.5 節中定義的泛型狀態代碼。
MBIM_CID_PACKET_SERVICE
此命令是 MBIM 規格 1.0 版中所定義之現有MBIM_CID_PACKET_SERVICE的擴充功能。
此延伸模組會針對響應結構新增名為 FrequencyRange 的新成員，並將 HighestAvailableDataClass 成員重新命名為 CurrentDataClass ，以釐清其用途。
CurrentDataClass 指出目前註冊裝置的 RADIO Access Technology (RAT) 。 它包含來自 MBIM_DATA_CLASS 的單一值。
FrequencyRange 指出裝置目前使用的頻率範圍。 只有當 CurrentDataClass 字段指出已設定MBIMDataClass5G_NSA或MBIMDataClass5G_SA位時，這才有效。
參數
| 作業 | Set | 查詢 | 通知 |
|---|---|---|---|
| 命令 | MBIM_SET_PACKET_SERVICE | Empty | 不適用 |
| 回應 | MBIM_PACKET_SERVICE_INFO_V2 | MBIM_PACKET_SERVICE_INFO_V2 | MBIM_PACKET_SERVICE_INFO_V2 |
查詢
InformationBuffer 為 null，且 InformationBufferLength 為零。
Set
設定命令的資訊會在 MBIM 規格修訂 1.0 中說明。
回應
MBIM_COMMAND_DONE中的 InformationBuffer 包含MBIM_PACKET_SERVICE_INFO_V2結構。 相較於 MBIM 規格 1.0 版第 10.5.10.6 節中所定義的MBIM_PACKET_SERVICE_INFO結構，這個新結構具有 CurrentDataClass 和 FrequencyRange 字段。 除非這裡另有說明， 否則 MBIM 規格 1.0 版表 10-55 中的欄位描述適用於此處。
MBIM_PACKET_SERVICE_INFO_V2
| Offset | 大小 | 欄位 | 類型 | 描述 |
|---|---|---|---|---|
| 0 | 4 | NwError | UINT32 | 網路特定錯誤。 MBIM 規格修訂 1.0 中的表 10-44 記載 NwError 的原因碼。 |
| 4 | 4 | PacketServiceState | MBIM_PACKET_SERVICE_STATE | 請參閱 MBIM 規格修訂 1.0 中的表格 10-53。 |
| 8 | 4 | CurrentDataClass | MBIM_DATA_CLASS | 目前儲存格中的目前資料類別，根據 MBIM_DATA_CLASS指定。 如果函式不在附加封包服務狀態，則函式必須將這個成員設定為 MBIMDataClassNone。 除了 HSPA (換句話說，HSUPA 和 HSDPA) 和 5G DC 之外，函式會將此成員設定為單一MBIM_DATA_CLASS值。 針對 HSPA 數據服務，函式會指定 MBIMDataClass HSDPA 和 MBIMDataClassHSUPA 的位 OR。 對於支援 HSDPA 但不支援 HSUPA 的儲存格，只會指出 HSDPA (表示 UMTS 資料類別用於上行資料) 。 每當目前的數據類別變更時，函式就會傳送通知，指出 CurrentDataClass 的新值。 |
| 12 | 8 | UplinkSpeed | UINT64 | 包含每秒以位為單位的上行連結位速率。 |
| 20 | 8 | DownlinkSpeed | UINT64 | 包含下行連結位速率，每秒以位為單位。 |
| 38 | 4 | FrequencyRange | MBIM_FREQUENCY_RANGE | MBIM_FREQUENCY_RANGE中的值位掩碼，表示裝置目前使用的頻率範圍。 只有在 CurrentDataClass 是MBIMDataClass5G_NSA或MBIMDataClass5G_SA時才有效。 |
MBIM_FREQUENCY_RANGE
下列列舉會當做上述MBIM_PACKET_SERVICE_INFO_V2 結構中的值使用。
| 類型 | 值 | Description |
|---|---|---|
| MBIMFrequencyRangeUnknown | 0 | 如果系統類型不是 5G。 |
| MBIMFrequencyRange1 | 1 | 3GPP TS 38.101-1 (Sub-6G) 中的頻率範圍 1 (FR1) 。 |
| MBIMFrequencyRange2 | 2 | 3GPP TS 38.101-2 中的FR2 (mmWave) 。 |
| MBIMFrequencyRange1AndRange2 | 3 | 如果FR1和FR2貨運公司都已連線。 |
未經請求的事件
通知包含MBIM_PACKET_SERVICE_INFO_V2結構。
狀態碼
此 CID 只會使用 MBIM 規格 1.0 第 9.4.5 節中定義的泛型狀態代碼。
MBIM_CID_SIGNAL_STATE
此 CID 是MBIM_CID_SIGNAL_STATE的延伸模組，針對訊號狀態準則引進 RSRP 和 SNR。 只有在裝置指出支援 MBIM 延伸模組 2.0 版時，這個新的擴充功能才有效。 如果數據支援 MBIMDataClass5G_ (N) SA 資料類別，則此延伸模組是必要的。
只有在對應的 SystemType 為 MGBIMDataClassLTE 或 MBIMDataClass5G_ (N) SA 時，RSRP 和 SNR 欄位才有效。 如果數據機報告 RSRP 和/或 SNR，則 RSSI 欄位應設定為 99 的值。
如果對應的 SystemType MBIMDataClass5G_ (N) SA，則 RSRP 欄位為必要，且 SNR 字段是選擇性的。 如果對應的 SystemType 是 MBIMDataClassLTE，則 RSRP 和 SNR 字段是選擇性的，而且可以改用 RSSI 欄位。 在此情況下，可以藉由為 RsrpSnrOffset 和 RsrpSnrSize 成員設定零 (0) 值來省略 RSRP 和 SNR 欄位。
參數
| 作業 | Set | 查詢 | 通知 |
|---|---|---|---|
| 命令 | MBIM_SET_SIGNAL_STATE | Empty | 不適用 |
| 回應 | MBIM_SIGNAL_STATE_INFO_V2 | MBIM_SIGNAL_STATE_INFO_V2 | MBIM_SIGNAL_STATE_INFO_V2 |
查詢
InformationBuffer 為 null，且 InformationBufferLength 為零。
Set
設定命令的資訊會在 MBIM 規格修訂 1.0 中說明。
回應
MBIM_COMMAND_DONE中的 InformationBuffer 包含下列MBIM_SIGNAL_STATE_INFO_V2結構。
MBIM_SIGNAL_STATE_INFO_V2
| Offset | 大小 | 欄位 | 類型 | 描述 |
|---|---|---|---|---|
| 0 | 4 | Rssi | UINT32 | 請參閱 MBIM 規格修訂 1.0 中的表格 10.58。 |
| 4 | 4 | ErrorRate | UINT32 | 請參閱 MBIM 規格修訂 1.0 中的表格 10.58。 |
| 8 | 4 | SignalStrengthInterval | UINT32 | 報告間隔，以秒為單位。 |
| 12 | 4 | RssiThreshold | UINT32 | 觸發報表之 RSSI 編碼值的差異。 如果這不重要，請使用0xFFFFFFFF。 |
| 16 | 4 | ErrorRateThreshold | UINT32 | ErrorRate 觸發報表之編碼值的差異。 如果這不重要，請使用0xFFFFFFFF。 |
| 20 | 4 | RsrpSnrOffset | OFFSET | 從這個結構的開頭計算到包含 RSRP 和 SNR 訊號資訊的緩衝區，以位元組為單位的位移。 當沒有 RSRP 和 SNR 訊號資訊可用時，這個成員可以是 NULL 。 |
| 24 | 4 | RsrpSnrSize | SIZE | 緩衝區的大小，以位元組為單位，包含RSRP和SNR訊號資訊，格式為 MBIM_RSRP_SNR_INFO結構。 |
| 4 | DataBuffer | DATABUFFER | MBIM_RSRP_SNR結構。 |
MBIM_RSRP_SNR
下列MBIM_RSRP_SNR結構用於 MBIM_SIGNAL_STATE_INFO_V2 結構的 DataBuffer 中。
| Offset | 大小 | 欄位 | 類型 | 描述 |
|---|---|---|---|---|
| 0 | 4 | ElementCount | UINT32 | 在此元素後面的RSRP_SNR專案計數。 |
| 4 | 4 | DataBuffer | DATABUFFER | RSRP_SNR記錄的陣列，每個記錄都指定為MBIM_RSRP_SNR_INFO結構。 |
MBIM_RSRP_SNR_INFO
下列MBIM_RSRP_SNR_INFO結構的陣列用於MBIM_RSRP_SNR結構的 DataBuffer 中。
| Offset | 大小> | 欄位 | 類型 | 描述 | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 0 | 4 | RSRP | UINT32 |
|
||||||||||||||||||||||
| 4 | 4 | SNR | UINT32 |
|
||||||||||||||||||||||
| 8 | 4 | RSRPThreshold | UINT32 | 定義舊 (快取) RSRP 值和新計算的 RSRP 值之間的臨界值。 如果絕對差異大於閾值，裝置會觸發未經請求的事件。 單位為 1 dBm。 如果設定為零，請使用裝置函式中的預設行為。 如果設定為 0xFFFFFFFF，請勿使用此來觸發事件。 如果裝置不支援指定的臨界值，它會傳回其支援的最大值。 | ||||||||||||||||||||||
| 12 | 4 | SNRThreshold | UINT32 | 定義舊 (快取) SNR 值和新計算的 SNR 值之間的臨界值。 如果絕對差異大於閾值，裝置會觸發未經請求的事件。 單位為 1 dB。 如果設定為零，請使用裝置函式中的預設行為。 如果設定為 0xFFFFFFFF，請勿使用此來觸發事件。 如果裝置不支援指定的臨界值，它會傳回其支援的最大值。 | ||||||||||||||||||||||
| 16 | 4 | SystemType | MBIM_DATA_CLASS | 指出訊號狀態資訊有效的系統類型。 這個成員是一種類型的位掩碼，如 MBIM_DATA_CLASS中所定義。 |
未經請求的事件
通知包含MBIM_SIGNAL_STATE_INFO_V2結構。
狀態碼
此 CID 只會使用 MBIM 規格修訂 1.0 第 9.4.5 節中定義的一般狀態代碼。
LTE 訊號列計算
OS 應依照下列順序處理訊號強度計算的登錄設定：
Dataclass 是 CDMA (或其變體) 或 TDSCDMA
- 如果 「per_iccid」底下存在舊版訊號列對應數據表，請使用此設定。
- 否則，如果舊版訊號列對應數據表存在於 「per_device」底下，請使用此設定。
- 否則，請在程式代碼中使用預設訊號列對應數據表。
Dataclass 是 GSM 或 WCDMA
- 如果 GSM 或 WCDMA 技術特定訊號列對應資料表存在於 「per_iccid」底下，請使用此設定。
- 否則，如果 GSM 或 WCDMA 技術特定的訊號列對應數據表存在於 「per_device」底下，請使用此設定。
- 否則，如果舊版訊號列對應數據表存在於 「per_iccid」底下，請使用此設定。
- 否則，如果舊版訊號列對應數據表存在於 「per_device」底下，請使用此設定。
- 否則，請在程式代碼中使用預設訊號列對應數據表。
- RSSI >= 17;5 橫條
- RSSI >= 12;4 橫條
- RSSI >= 7;3 橫條
- RSSI >= 4;2 橫條
- RSSI >= 2;1 個橫條
- 還;0 橫條
Dataclass 是 LTE，而 RSRP 是由數據機報告
- 如果 RSRP 的 LTE 技術特定訊號列對應數據表存在於 「per_iccid」 底下，請使用此設定。
- 否則，如果 RSRP 的 LTE 技術特定訊號列對應數據表存在於 「per_device」 底下，請使用此設定。
- 否則，請在程式代碼中使用預設 LTE RSRP 訊號列對應資料表。
注意
如果已啟用 EnableLTESnrReporting，但數據機沒有 LTE 或 SNR 報告的 SNR 數據表，則只會使用 RSRP。 否則，RSRP 或 SNR 的較佳會轉換成訊號橫條。
Dataclass 是 LTE，RSSI 是由數據機報告
- 如果 LTE 技術特定訊號列對應資料表存在於 「per_iccid」底下，請使用此設定。
- 否則，如果 LTE 技術特定的訊號列對應數據表存在於 「per_device」底下，請使用此設定。
- 否則，如果舊版訊號列對應數據表存在於 「per_iccid」底下，請使用此設定。
- 否則，如果舊版訊號列對應數據表存在於 「per_device」底下，請使用此設定。
- 否則，請在程式代碼中使用預設訊號列對應數據表。
Dataclass 為 NR
- 如果 RSRP 的 NR 技術特定訊號列對應數據表存在於 「per_iccid」底下，請使用此設定。
- 否則，如果 RSRP 的 NR 技術特定訊號列對應數據表存在於 「per_device」 底下，請使用此設定。
- 否則，請在程式代碼中使用預設的 NR RSRP 訊號列對應資料表。
注意
如果已啟用 EnableNRSnrReporting，但數據機沒有 NR 或 SNR 報告的 SNR 數據表，則只會使用 RSRP。 否則，RSRP 或 SNR 的較佳會轉換成訊號橫條。
Dataclass 為 NSA
- 如果未設定 EnableLTEReportingOnNSA，或設定為 0：
- 遵循 Dataclass NR 流程。
- 如果 EnableLTEReportingOnNSA 設定為 1：
- 遵循 Dataclass LTE 流程 (RSRP 或 RSSI) 。
- 如果 EnableLTEReportingOnNSA 設定為 2：
- 如果 FrequencyRange 為 FR1，請遵循 DATAclass LTE 流程 (RSRP 或 RSSI) 。
- 如果 FrequencyRange 為 <> FR1，請遵循 Dataclass NR 流程。
- 如果 EnableLTEReportingOnNSA 設定為 3：
- 如果 FrequencyRange 為 FR2，請遵循 DATAclass LTE 流程 (RSRP 或 RSSI) 。
- 如果 FrequencyRange 為 <> FR2，請遵循 Dataclass NR 流程。
- 如果 EnableLTEReportingOnNSA 設定為 4：
- 使用 LTE 和 NR 流程計算訊號列。
- 選取最強的。
注意
如果數據機未在1-5中回報 LTE 訊號，則會使用 NR 訊號。 如果未使用 NR 訊號，則會套用 LTE 訊號。
SignalBar 計算的 COSA 自定義
EnableLTEReportingOnNSA：
0 = “使用 5G 訊號”
1 = “使用 LTE 訊號”
2 = 「如果鎖定在 5G 頻率範圍 1 上，請使用 LTE 訊號」
3 = 「如果鎖定在 5G 頻率範圍 2 上，請使用 LTE 訊號」
4 = 「使用 LTE 和 5G 的最強訊號」
EnableNRSnrReporting：
0 = “僅使用 RSRP”
1 = “同時使用 RSRP 和 SNR”
EnableLTESnrReporting：
0 = “僅使用 RSRP”
1 = “同時使用 RSRP 和 SNR”
Cellular/PerDevice/SignalBarMappingTable/SignalForBars/<SignalBar>
修改對應至要顯示之橫條數目的最小訊號強度值。 技術特定設定優先。 每個橫條數目都必須有有效的訊號強度對應，此設定才會生效。
Cellular/PerDevice/SignalBarMappingTable/SignalForBars/GERAN/<SignalBar>
修改對應到在 GSM 上鎖定裝置時要顯示的橫條數目的最小訊號強度值。 每個橫條數目都必須有有效的訊號強度對應，此設定才會生效。
Cellular/PerDevice/SignalBarMappingTable/SignalForBars/WCDMA/<SignalBar>
修改對應到WCDMA 上設定裝置時要顯示之橫條數目的最小訊號強度值。 每個橫條數目都必須有有效的訊號強度對應，此設定才會生效。
Cellular/PerDevice/SignalBarMappingTable/SignalForBars/LTE/<SignalBar>
修改對應到裝置在 LTE 上時顯示之橫條數目的最小訊號強度值。 每個橫條數目都必須有有效的訊號強度對應，此設定才會生效。
Cellular/PerDevice/SignalBarMappingTable/SignalForBars/LTERSRP/<SignalBar>
修改在 LTE 上設定裝置時，對應到要顯示之橫條數目的最小訊號強度值。 每個橫條數目都必須有有效的訊號強度對應，此設定才會生效。
Cellular/PerDevice/SignalBarMappingTable/SignalForBars/LTERSSNR/<SignalBar>
修改對應到裝置在 LTE 上時顯示之橫條數目的最小訊號強度值。 當 EnableLTESnrReporting 設定為 1 時使用。 每個橫條數目都必須有有效的訊號強度對應，此設定才會生效。
Cellular/PerDevice/SignalBarMappingTable/SignalForBars/NRRSRP/<SignalBar>
修改對應到裝置在 5G 上時顯示之橫條數目的最小訊號強度值。 每個橫條數目都必須有有效的訊號強度對應，此設定才會生效。
Cellular/PerDevice/SignalBarMappingTable/SignalForBars/NRRSSNR/<SignalBar>
修改對應到裝置在 5G 上時顯示之橫條數目的最小訊號強度值。 當 EnableNRSnrReporting 設定為 1 時使用。 每個橫條數目都必須有有效的訊號強度對應，此設定才會生效。
<SignalBar> 可以是 1-5 個值。
如果 OEM/MO 無法正確設定 RSSI 的對應資料表或不完整，請使用預設對應：
| Rssi | 顯示橫條 |
|---|---|
| [0,1] | 0 |
| [2,3] | 1 |
| [4,6] | 2 |
| [7,11] | 3 |
| [12,16] | 4 |
| [17,31] | 5 |
如果 OEM/MO 無法正確設定 RSRP 的對應資料表或不完整，請使用預設對應：
| RSRP | 顯示橫條 |
|---|---|
| [0,16] | 0 |
| [17,41] | 1 |
| [42,51] | 2 |
| [52,61] | 3 |
| [62,71] | 4 |
| [72,126] | 5 |
如果 OEM/MO 無法正確設定 SNR 的對應資料表或不完整，請使用預設對應：
| SNR | 顯示橫條 |
|---|---|
| [0,18] | 0 |
| [19,38] | 1 |
| [39,46] | 2 |
| [47,53] | 3 |
| [54,72] | 4 |
| [73,127] | 5 |