MB UICC-Anwendungs- und Dateisystemzugriff
Übersicht
In diesem Thema wird eine Erweiterung der MBIM-Schnittstelle (Mobile Broadband Interface Model) angegeben, um den Zugriff auf intelligente UICC-Karte-Anwendung und Dateisysteme zu ermöglichen. Diese Erweiterung für MBIM macht den logischen Zugriff auf die ETSI TS 102 221-konformen Anwendungen und Dateisysteme der UICC verfügbar und wird in Windows 10, Version 1903 und höher, unterstützt.
UICC-Zugriff und Sicherheit
Die UICC stellt ein Dateisystem bereit und unterstützt eine Reihe von Anwendungen, die gleichzeitig ausgeführt werden können. Dazu gehören USIM für UMTS, CSIM für CDMA und ISIM für IMS. Die SIM ist ein Legacyteil der UICC, der als eine dieser Anwendungen (für GSM) modelliert werden kann.
Das folgende Diagramm aus Abschnitt 8.1 der technischen Spezifikation ETSI TS 102 221 zeigt ein Beispiel Karte Anwendungsstruktur.
Das UICC-Dateisystem kann als Gesamtstruktur von Verzeichnisstrukturen betrachtet werden. Die Legacy-SIM-Struktur basiert auf einer Masterdatei (MASTER File, MF) und enthält bis zu zwei Ebenen von Unterverzeichnissen (Dedizierte Dateien oder DFs), die Elemental Files (EFs) enthalten, die verschiedene Arten von Informationen enthalten. Die SIM definiert DFs unter dem MF, von denen DFTelecom Informationen enthält, die für mehrere Zugriffstypen wie das allgemeine Telefonbuch gemeinsam sind. Zusätzliche Anwendungen werden effektiv als separate Strukturen implementiert, die jeweils in einer eigenen Anwendungsverzeichnisdatei (Application Directory File, ADF) basieren. Jede ADF wird durch einen Anwendungsbezeichner identifiziert, der bis zu 128 Bit lang sein kann. Eine Datei unter dem Karte Stamm (EFDir unter dem MF im Diagramm) enthält die Anwendungsnamen und die entsprechenden Bezeichner. Innerhalb einer Struktur (MF oder ADF) können DFs und EFs durch einen Pfad von Datei-IDs identifiziert werden, wobei eine Datei-ID eine 16-Bit-Ganzzahl ist.
NDIS-Schnittstellenerweiterungen
Die folgenden OIDs wurden definiert, um den Zugriff auf UICC-Anwendungen und Dateisysteme zu unterstützen.
- OID_WWAN_UICC_APP_LIST
- OID_WWAN_UICC_FILE_STATUS
- OID_WWAN_UICC_ACCESS_BINARY
- OID_WWAN_UICC_ACCESS_RECORD
- OID_WWAN_PIN_EX2
MBIM-Dienst- und CID-Werte
| Dienstname | UUID | UUID-Wert |
|---|---|---|
| Microsoft Low-Level UICC-Zugriff | UUID_MS_UICC_LOW_LEVEL | C2F6588E-F037-4BC9-8665-F4D44BD09367 |
| Microsoft Basic IP-Konnektivitätserweiterungen | UUID_BASIC_CONNECT_EXTENSIONS | 3D01DCC5-FEF5-4D05-9D3A-BEF7058E9AAF |
In der folgenden Tabelle sind die UUID und der Befehlscode für die einzelnen CID sowie angegeben, ob die CID Set-, Abfrage- oder Ereignisanforderungen (Benachrichtigung) unterstützt. Weitere Informationen zu den Parametern, Datenstrukturen und Benachrichtigungen finden Sie im einzelnen Abschnitt der einzelnen CID in diesem Thema.
| CID | UUID | Befehlscode | Set | Abfrage | Benachrichtigen |
|---|---|---|---|---|---|
| MBIM_CID_MS_UICC_APP_LIST | UUID_MS_UICC_LOW_LEVEL | 7 | N | J | N |
| MBIM_CID_MS_UICC_FILE_STATUS | UUID_MS_UICC_LOW_LEVEL | 8 | N | J | N |
| MBIM_CID_MS_UICC_ACCESS_BINARY | UUID_MS_UICC_LOW_LEVEL | 9 | J | J | N |
| MBIM_CID_MS_UICC_ACCESS_RECORD | UUID_MS_UICC_LOW_LEVEL | 10 | J | J | N |
| MBIM_CID_MS_PIN_EX | UUID_BASIC_CONNECT_EXTENSIONS | 14 | J | J | N |
MBIM_CID_MS_UICC_APP_LIST
Diese CID ruft eine Liste von Anwendungen in einer UICC und Informationen darüber ab. Wenn die UICC im Modem vollständig initialisiert und bereit ist, sich beim Mobilfunkanbieter zu registrieren, muss eine UICC-Anwendung für die Registrierung ausgewählt werden, und eine Abfrage mit dieser CID sollte die ausgewählte Anwendung im Feld ActiveAppIndex in der als Antwort verwendeten MBIM_UICC_APP_LIST-Struktur zurückgeben.
Parameter
| Vorgang | Set | Abfrage | Benachrichtigung |
|---|---|---|---|
| Get-Help | Nicht verfügbar | Empty | Nicht verfügbar |
| Antwort | Nicht verfügbar | MBIM_UICC_APP_LIST | Nicht verfügbar |
Abfrage
Der InformationBuffer von MBIM_COMMAND_MSG ist leer.
Set
Nicht zutreffend
Antwort
Der InformationBuffer in MBIM_COMMAND_DONE enthält die folgende MBIM_UICC_APP_LIST-Struktur.
MBIM_UICC_APP_LIST (Version 1)
| Offset | Size | Feld | type | Beschreibung |
|---|---|---|---|---|
| 0 | 4 | Version | UINT32 | Die Versionsnummer der folgenden Struktur. Dieses Feld muss für Version 1 dieser Struktur auf 1 festgelegt werden. |
| 4 | 4 | AppCount | UINT32 | Die Anzahl der UICC-Anwendungen MBIM_UICC_APP_INFO Strukturen, die in dieser Antwort zurückgegeben werden. |
| 8 | 4 | ActiveAppIndex | UINT32(0..NumApp - 1) | Der Index der Anwendung, die vom Modem für die Registrierung beim Mobilfunknetz ausgewählt wird. Dieses Feld muss zwischen 0 und AppCount - 1 sein. Es wird in das Array von Anwendungen indiziert, die von dieser Antwort zurückgegeben werden. Wenn keine Anwendung für die Registrierung ausgewählt ist, enthält dieses Feld 0xFFFFFFFF. |
| 12 | 4 | AppListSize | UINT32 | Die Größe der App-Listendaten in Bytes. |
| 8*AppCount | AppList | OL_PAIR_LIST | Das erste Element des Paars ist ein 4-Byte-Feld mit dem Offset einer App-Info im DataBuffer. Das zweite Element des Paars ist ein 4-Byte-Feld mit der Größe der App-Informationen. | |
| AppListSize | DataBuffer | DATABUFFER | Ein Array vonAppCount-MBIM_UICC_APP_INFO-Strukturen * . |
MBIM_UICC_APP_INFO
| Offset | Size | Feld | type | Beschreibung |
|---|---|---|---|---|
| 0 | 4 | AppType | MBIM_UICC_APP_TYPE | Der Typ der UICC-Anwendung. |
| 4 | 4 | AppIdOffset | OFFSET | Offset für die Anwendungs-ID im Databuffer. Nur die ersten AppIdSize-Bytes sind sinnvoll. Wenn die Anwendungs-ID länger als MBIM_MAXLENGTH_APPID Bytes ist, gibt AppIdSize die tatsächliche Länge an, aber nur die ersten MBIM_MAXLENGTH_APPID Bytes befinden sich in diesem Feld. Dieses Feld ist nur gültig, wenn AppType nicht MBIMUiccAppTypeMf, MBIMUiccAppTypeMfSIM oder MBIMUiccAppTypeMfRUIM ist. |
| 8 | 4 | AppIdSize | GRÖßE (0..16) | Die Größe der Anwendungs-ID in Bytes, wie in Abschnitt 8.3 der technischen Spezifikation ETSI TS 102 221 definiert. AppIdSize kann eine Zahl größer als 16 enthalten, aber in diesem Fall befinden sich nur die ersten 16 (MBIM_MAXLENGTH_APPID) Bytes im Databuffer. Dieses Feld ist für die App-Typen MBIMUiccAppTypeMf, MBIMUiccAppTypeMfSIM oder MBIMUiccAppTypeMfRUIM auf 0 festgelegt. |
| 12 | AppNameOffset | OFFSET | Offset für den Anwendungsnamen im Databuffer. Eine UTF-8-Zeichenfolge, die den Namen der Anwendung angibt. Die Länge dieses Felds wird von AppNameLength angegeben. Wenn die Länge größer oder gleich MBIM_MAXLENGTH_APPNAME Bytes ist, enthält dieses Feld den ersten MBIM_MAXLENGTH_APPNAME - 1 Byte des Namens. Die Zeichenfolge ist immer NULL-beendet. | |
| 16 | 4 | AppNameLength | GRÖßE (0..256) | Die Länge des Anwendungsnamens in Bytes. AppNameLength kann eine Zahl enthalten, die gleich oder größer als 256 ist, aber in diesen Fällen befinden sich nur die ersten 255 Bytes (MBIM_MAXLENGTH_APPNAME - 1) im Databuffer. |
| 20 | 4 | NumPinKeyRefs | GRÖßE (0..8) | Die Anzahl der Anwendungs-PIN-Schlüsselverweise. Anders ausgedrückt: Die Anzahl der gültigen PinKeyRef-Elemente. Anwendungen auf einem virtuellen R-UIM weisen keine PIN-Schlüsselverweise auf. |
| 24 | 4 | KeyRefOffset | OFFSET | Offset von PinKeyRef im DataBuffer. PinKeyRef ist ein Bytearray, das die PIN-Schlüsselverweise der Anwendung für verschiedene Überprüfungsebenen (Schlüssel für PIN1, PIN2 und möglicherweise eine universelle PIN) angibt, wie in Tabelle 9.3 und Abschnitt 9.4.2 der technischen Spezifikation ETSI TS 102 221 definiert. Im Falle eines Karte mit einer einzelnen Überprüfung oder eines MBB-Treibers und/oder Modems, das keine unterschiedlichen Anwendungsschlüssel für verschiedene Anwendungen unterstützt, muss das erste Byte des PinKeyRef-Felds 0x01 (PIN1) und das zweite Byte 0x81 (PIN2) sein, wie in Abschnitt 9.5.1 von ETSI TS 102 221 beschrieben. |
| 28 | 4 | KeyRefSize | GRÖßE (0..8) | Die Größe von PinKeyRef. |
| 32 | DataBuffer | DATABUFFER | Der Datenpuffer, der AppId, AppName und PinKeyRef. eines Karte mit einzeler Überprüfung enthält, oder ein MBB-Treiber und/oder Modem, das keine unterschiedlichen Anwendungsschlüssel für verschiedene Anwendungen unterstützt, dieses Feld muss 0x01 sein. |
MBIM_UICC_APP_TYPE
| type | Wert | Beschreibung |
|---|---|---|
| MBIMUiccAppTypeUnknown | 0 | Unbekannter Typ. |
| MBIMUiccAppTypeMf | 1 | Legacy-SIM-Verzeichnisse, die im MF verwurzelt sind. |
| MBIMUiccAppTypeMfSIM | 2 | Legacy-SIM-Verzeichnisse, die am DF_GSM. |
| MBIMUiccAppTypeMfRUIM | 3 | Legacy-SIM-Verzeichnisse, die am DF_CDMA. |
| MBIMUiccAppTypeUSIM | 4 | USIM-Anwendung. |
| MBIMUiccAppTypeCSIM | 5 | CSIM-Anwendung. |
| MBIMUiccAppTypeISIM | 6 | ISIM-Anwendung. |
Konstanten
Die folgenden Konstanten werden für MBIM_CID_MS_UICC_APP_INFO definiert.
const int MBIM_MAXLENGTH_APPID = 32
const int MBIM_MAXLENGTH_APPNAME = 256
const int MBIM_MAXNUM_PINREF = 8
Nicht angeforderte Ereignisse
Nicht zutreffend
Statuscodes
Es gelten die folgenden status-Codes:
| Statuscode | Beschreibung |
|---|---|
| MBIM_STATUS_SUCCESS | Grundlegende MBIM-status wie für alle Befehle definiert. |
| MBIM_STATUS_BUSY | Grundlegende MBIM-status wie für alle Befehle definiert. |
| MBIM_STATUS_FAILURE | Grundlegende MBIM-status wie für alle Befehle definiert. |
| MBIM_STATUS_NO_DEVICE_SUPPORT | Grundlegende MBIM-status wie für alle Befehle definiert. |
| MBIM_STATUS_SIM_NOT_INSERTED | Der UICC-Vorgang kann nicht ausgeführt werden, da die UICC fehlt. |
| MBIM_STATUS_BAD_SIM | Der UICC-Vorgang kann nicht ausgeführt werden, da sich die UICC in einem Fehlerzustand befindet. |
| MBIM_STATUS_NOT_INITIALIZED | Der UICC-Vorgang kann nicht ausgeführt werden, da die UICC noch nicht vollständig initialisiert ist. |
MBIM_CID_MS_UICC_FILE_STATUS
Diese CID ruft Informationen zu einer angegebenen UICC-Datei ab.
Parameter
| Vorgang | Set | Abfrage | Benachrichtigung |
|---|---|---|---|
| Befehl | Nicht verfügbar | MBIM_UICC_FILE_PATH | Nicht zutreffend |
| Antwort | Nicht verfügbar | MBIM_UICC_FILE_STATUS | Nicht verfügbar |
Abfrage
Der InformationBuffer von MBIM_COMMAND_MSG enthält die Ziel-EF als MBIM_UICC_FILE_PATH-Struktur.
MBIM_UICC_FILE_PATH (Version 1)
| Offset | Size | Feld | type | Beschreibung |
|---|---|---|---|---|
| 0 | 4 | Version | UINT32 | Die Versionsnummer der folgenden Struktur. Dieses Feld muss für Version 1 dieser Struktur 1 sein. |
| 4 | 4 | AppIdOffset | OFFSET | Der Offset in Bytes, der vom Anfang dieser Struktur bis zum Puffer berechnet wird, der die Anwendungs-ID enthält. |
| 8 | 4 | AppIdSize | GRÖßE (0..16) | Die Größe der Anwendungs-ID in Bytes gemäß Abschnitt 8.3 der technischen Spezifikation ETSI TS 102 221. Für 2G-Karten muss dieses Feld auf Null (0) festgelegt werden. |
| 12 | 4 | FilePathOffset | OFFSET | Der Offset in Bytes, der vom Anfang dieser Struktur bis zum Puffer berechnet wird, der den Dateipfad enthält. Der Dateipfad ist ein Array von 16-Bit-Datei-IDs. Die erste ID muss entweder 0x7FFF oder 0x3F00 sein. Wenn die erste ID 0x7FFF ist, ist der Pfad relativ zum ADF der von AppId erstellten Anwendung. Andernfalls ist es ein absoluter Pfad, der vom MF aus beginnt. |
| 16 | 4 | FilePathSize | GRÖßE (0..8) | Die Größe des Dateipfads in Bytes. |
| 20 | DataBuffer | DATABUFFER | Der Datenpuffer, der AppId und FilePath enthält. |
Set
Nicht zutreffend
Antwort
Die folgende MBIM_UICC_FILE_STATUS-Struktur wird im InformationBuffer verwendet.
MBIM_UICC_FILE_STATUS (Version 1)
| Offset | Size | Feld | type | Beschreibung |
|---|---|---|---|---|
| 0 | 4 | Version | UINT32 | Die Versionsnummer der folgenden Struktur. Dieses Feld muss für Version 1 dieser Struktur 1 sein. |
| 4 | 4 | StatusWord1 | UINT32(0..256) | Ein für den UICC-Befehl spezifischer Rückgabeparameter. |
| 8 | 4 | StatusWord2 | UINT32(0..256) | Ein für den UICC-Befehl spezifischer Rückgabeparameter. |
| 12 | 4 | Dateizugriff | MBIM_UICC_FILE_ACCESSIBILITY | Die Barrierefreiheit der UICC-Datei. |
| 16 | 4 | FileType | MBIM_UICC_FILE_TYPE | Der UICC-Dateityp. |
| 20 | 4 | Dateistruktur | MBIM_UICC_FILE_STRUCTURE | Die UICC-Dateistruktur. |
| 24 | 4 | ItemCount | UINT32 | Die Anzahl der Elemente in der UICC-Datei. Für transparente und TLV-Dateien ist dies auf 1 festgelegt. |
| 28 | 4 | Size | UINT32 | Die Größe jedes Elements in Bytes. Bei transparenten oder TLV-Dateien ist dies die Größe des gesamten EF. Bei datensatzbasierten Dateien stellt dies die Gesamtzahl der Datensätze dar. |
| 32 | 16 | FileLockStatus | MBIM_PIN_TYPE_EX[4] | Ein Array vom Typ MBIM_PIN_TYPE_EX, das die Zugriffsbedingung für jeden Vorgang (READ, UPDATE, ACTIVATE und DEACTIVATE in dieser Reihenfolge) für diese Datei beschreibt. |
MBIM_UICC_FILE_ACCESSIBILITY
Die MBIM_UICC_FILE_ACCESSIBILITY-Enumeration wird in der vorherigen MBIM_UICC_FILE_STATUS-Struktur verwendet.
| type | Wert | Beschreibung |
|---|---|---|
| MBIMUiccFileAccessibilityUnknown | 0 | Dateifreigabe unbekannt. |
| MBIMUiccFileAccessibilityNotShareable | 1 | Nicht freigegebene Datei. |
| MBIMUiccFileAccessibilityShareable | 2 | Freigegebene Datei. |
MBIM_UICC_FILE_TYPE
Die MBIM_UICC_FILE_TYPE-Enumeration wird in der vorherigen MBIM_UICC_FILE_STATUS-Struktur verwendet.
| type | Wert | Beschreibung |
|---|---|---|
| MBIMUiccFileTypeUnknown | 0 | Dateityp unbekannt. |
| MBIMUiccFileTypeWorkingEf | 1 | Funktionierende EF. |
| MBIMUiccFileTypeInternalEf | 2 | Interne EF. |
| MBIMUiccFileTypeDfOrAdf | 3 | Dedizierte Datei, ein Verzeichnis, das von anderen Knoten übergeordnet ist. Dies kann ein DF oder ADF sein. |
MBIM_UICC_FILE_STRUCTURE
Die MBIM_UICC_FILE_STRUCTURE-Enumeration wird in der vorherigen MBIM_UICC_FILE_STATUS-Struktur verwendet.
| type | Wert | Beschreibung |
|---|---|---|
| MBIMUiccFileStructureUnknown | 0 | Eine unbekannte Dateistruktur. |
| MBIMUiccFileStructureTransparent | 1 | Ein einzelner Datensatz mit variabler Länge. |
| MBIMUiccFileStructureCyclic | 2 | Ein zyklischer Satz von Datensätzen, die jeweils die gleiche Länge aufweisen. |
| MBIMUiccFileStructureLinear | 3 | Ein linearer Satz von Datensätzen, die jeweils die gleiche Länge aufweisen. |
| MBIMUiccFileStructureBerTLV | 4 | Eine Gruppe von Datenwerten, auf die per Tag zugegriffen werden kann. |
MBIM_PIN_TYPE_EX
Die MBIM_PIN_TYPE_EX-Enumeration wird in der obigen MBIM_UICC_FILE_STATUS-Struktur verwendet.
| type | Wert | Beschreibung |
|---|---|---|
| MBIMPinTypeNone | 0 | Es steht keine PIN für die Eingabe aus. |
| MBIMPinTypeCustom | 1 | Der PIN-Typ ist ein benutzerdefinierter Typ und keiner der anderen in dieser Enumeration aufgeführten PIN-Typen. |
| MBIMPinTypePinPin1 | 2 | Die PIN1-Taste. |
| MBIMPinTypePinPin2 | 3 | Die PIN2-Taste. |
| MBIMPinTypeDeviceSimPin | 4 | Die Sim-Taste des Geräts. |
| MBIMPinTypeDeviceFirstSimPin | 5 | Das Gerät zum ersten SIM-Schlüssel. |
| MBIMPinTypeNetworkPin | 6 | Der Netzwerkpersonalisierungsschlüssel. |
| MBIMPinTypeNetworkSubsetPin | 7 | Der Personalisierungsschlüssel für die Netzwerkteilmenge. |
| MBIMPinTypeServiceProviderPin | 8 | Der Personalisierungsschlüssel des Dienstanbieters . |
| MBIMPinTypeCorporatePin | 9 | Der Personalisierungsschlüssel des Unternehmens. |
| MBIMPinTypeSubsidyLock | 10 | Der Schlüssel zum Entsperren der Subvention. |
| MBIMPinTypePuk1 | 11 | Die Persönliche IdentifikationSnummer 1 Entsperrschlüssel (PUK1). |
| MBIMPinTypePuk2 | 12 | Der Persönliche Identifikations-Schlüssel 2 Entsperrschlüssel (PUK2). |
| MBIMPinTypeDeviceFirstSimPuk | 13 | Das Gerät zum allerersten SIM-PIN-Entsperrschlüssel. |
| MBIMPinTypeNetworkPuk | 14 | Der Schlüssel zum Entsperren der Netzwerkpersonalisierung. |
| MBIMPinTypeNetworkSubsetPuk | 15 | Der Schlüssel zum Entsperren der Netzwerkteilmenge für die Personalisierung. |
| MBIMPinTypeServiceProviderPuk | 16 | Der Schlüssel zum Entsperren des Dienstanbieters. |
| MBIMPinTypeCorporatePuk | 17 | Der Entsperrschlüssel für die Unternehmenspersonalisierung. |
| MBIMPinTypeNev | 18 | Der NEV-Schlüssel. |
| MBIMPinTypeAdm | 19 | Der Verwaltungsschlüssel. |
Nicht angeforderte Ereignisse
Nicht zutreffend
Statuscodes
Es gelten die folgenden status Codes:
| Statuscode | Beschreibung |
|---|---|
| MBIM_STATUS_BUSY | Grundlegende MBIM-status für alle Befehle definiert. |
| MBIM_STATUS_FAILURE | Grundlegende MBIM-status für alle Befehle definiert. |
| MBIM_STATUS_SIM_NOT_INSERTED | Der UICC-Vorgang kann nicht ausgeführt werden, da die UICC fehlt. |
| MBIM_STATUS_BAD_SIM | Der UICC-Vorgang kann nicht ausgeführt werden, da sich die UICC in einem Fehlerzustand befindet. |
| MBIM_STATUS_SHAREABILITY_CONDITION_ERROR | Die Datei kann nicht ausgewählt werden, da sie nicht freigegeben werden kann und derzeit von einer anderen Anwendung zugegriffen wird. Das status Wort, das von der SIM zurückgegeben wird, ist 6985. |
MBIM_CID_MS_UICC_ACCESS_BINARY
Diese CID sendet einen bestimmten Befehl für den Zugriff auf eine UICC-Binärdatei mit dem Strukturtyp MBIMUiccFileStructureTransparent oder MBIMUiccFileStructureBerTLV.
Parameter
| Vorgang | Set | Abfrage | Benachrichtigung |
|---|---|---|---|
| Befehl | Nicht verfügbar | MBIM_UICC_ACCESS_BINARY | Nicht verfügbar |
| Antwort | Nicht verfügbar | MBIM_UICC_RESPONSE | Nicht verfügbar |
Abfrage
Liest eine Binärdatei. Der InformationBuffer für MBIM_COMMAND_MSG enthält eine MBIM_UICC_ACCESS_BINARY-Struktur. Eine MBIM_UICC_RESPONSE-Struktur wird im InformationBuffer von MBIM_COMMAND_DONE zurückgegeben.
MBIM_UICC_ACCESS_BINARY (Version 1)
| Offset | Size | Feld | type | Beschreibung |
|---|---|---|---|---|
| 0 | 4 | Version | UINT32 | Die Versionsnummer der folgenden Struktur. Dieses Feld muss für Version 1 dieser Struktur auf 1 festgelegt werden. |
| 4 | 4 | AppIdOffset | OFFSET | Der Offset in Bytes vom Anfang dieser Struktur bis zum Puffer, der die Anwendungs-ID enthält. |
| 8 | 4 | AppIdSize | GRÖßE (0..16) | Die Größe der Anwendungs-ID in Bytes, wie in Abschnitt 8.3 der technischen Spezifikation ETSI TS 102 221 definiert. Für 2G-Karten muss dieses Feld auf Null (0) festgelegt werden. |
| 12 | 4 | FilePathOffset | OFFSET | Der Offset in Bytes, der vom Anfang dieser Struktur bis zum Puffer berechnet wird, der den Dateipfad enthält. Der Dateipfad ist ein Array von 16-Bit-Datei-IDs. Die erste ID muss entweder 0x7FFF oder 0x3F00 sein. Wenn die erste ID 0x7FFF ist, ist der Pfad relativ zur ADF der anwendung, die von AppId erstellt wurde. Andernfalls handelt es sich um einen absoluten Pfad, der am MF beginnt. |
| 16 | 4 | FilePathSize | SIZE | Die Größe des Dateipfads in Bytes. |
| 20 | 4 | FileOffset | UINT32 | Der Offset, der beim Lesen aus der Datei verwendet werden soll. Dieses Feld kann größer als 256 sein und kombiniert sowohl offset high als auch offset low gemäß der technischen Spezifikation ETSI TS 102 221. |
| 24 | 4 | NumberOfBytes | UINT32 | Die Anzahl der zu lesenden Bytes. Beispielsweise könnte ein Clienttreiber diese Funktion verwenden, um eine transparente (Binärdatei) zu lesen, die größer als 256 Bytes ist, obwohl die maximale Menge, die in einem einzelnen UICC-Vorgang gelesen oder geschrieben werden kann, 256 Bytes gemäß der technischen Spezifikation von ETSI TS 102 221 beträgt. Es liegt in der Verantwortung der Funktion, dies in mehrere APDUs aufzuteilen und das Ergebnis in einer einzigen Antwort zurückzusenden. |
| 28 | 4 | LocalPinOffset | OFFSET | Der Offset in Bytes, der vom Anfang dieser Struktur bis zum Puffer berechnet wird, der das Kennwort enthält. Dies ist die lokale PIN (PIN2), die für den Fall verwendet wird, dass für den Vorgang eine überprüfung der lokalen PIN erforderlich ist. |
| 32 | 4 | LocalPinSize | GRÖßE (0..16) | Die Größe des Kennworts in Bytes. |
| 36 | 4 | BinaryDataOffset | OFFSET | Der Offset in Bytes, der vom Anfang dieser Struktur bis zum Puffer berechnet wird, der die befehlsspezifischen Daten enthält. Binärdaten werden nur für SET-Vorgänge verwendet. |
| 40 | 4 | BinaryDataSize | GRÖßE (0..32768) | Die Größe der Daten in Bytes. |
| 44 | DataBuffer | DATABUFFER | Der Datenpuffer, der AppId, FilePath, LocalPin und BinaryData enthält. |
Set
Nicht zutreffend
Antwort
Die folgende MBIM_UICC_RESPONSE-Struktur wird im InformationBuffer verwendet.
MBIM_UICC_RESPONSE (Version 1)
| Offset | Size | Feld | type | Beschreibung |
|---|---|---|---|---|
| 0 | 4 | Version | UINT32 | Die Versionsnummer der folgenden Struktur. Dieses Feld muss für Version 1 dieser Struktur 1 sein. |
| 4 | 4 | StatusWord1 | UINT32(0..256) | Ein für den UICC-Befehl spezifischer Rückgabeparameter. |
| 8 | 4 | StatusWord2 | UINT32(0..256) | Ein für den UICC-Befehl spezifischer Rückgabeparameter. |
| 12 | 4 | ResponseDataOffset | OFFSET | Der Offset in Bytes, der vom Anfang dieser Struktur bis zum Puffer berechnet wird, der die Antwortdaten enthält. Die Antwortdaten werden nur für QUERY-Vorgänge verwendet. |
| 16 | 4 | ResponseDataSize | GRÖßE (0..32768) | Die Größe der Daten in Bytes. |
| 20 | DataBuffer | DATABUFFER | Der Datenpuffer, der ResponseData enthält. |
Nicht angeforderte Ereignisse
Nicht zutreffend
Statuscodes
Es gelten die folgenden status Codes:
| Statuscode | Beschreibung |
|---|---|
| MBIM_STATUS_BUSY | Grundlegende MBIM-status für alle Befehle definiert. |
| MBIM_STATUS_FAILURE | Grundlegende MBIM-status für alle Befehle definiert. |
| MBIM_STATUS_SIM_NOT_INSERTED | Der UICC-Vorgang kann nicht ausgeführt werden, da die UICC fehlt. |
| MBIM_STATUS_BAD_SIM | Der UICC-Vorgang kann nicht ausgeführt werden, da sich die UICC in einem Fehlerzustand befindet. |
| MBIM_STATUS_SHAREABILITY_CONDITION_ERROR | Die Datei kann nicht ausgewählt werden, da sie nicht freigegeben werden kann und derzeit von einer anderen Anwendung zugegriffen wird. Das status Wort, das von der SIM zurückgegeben wird, ist 6985. |
| MBIM_STATUS_PIN_FAILURE | Der Vorgang ist aufgrund eines PIN-Fehlers fehlgeschlagen. |
MBIM_CID_MS_UICC_ACCESS_RECORD
Diese CID sendet einen bestimmten Befehl für den Zugriff auf eine lineare feste oder zyklische UICC-Datei mit dem Strukturtyp MBIMUiccFileStructureCyclic oder MBIMUIccFileStructureLinear.
Parameter
| Vorgang | Set | Abfrage | Benachrichtigung |
|---|---|---|---|
| Get-Help | Nicht zutreffend | MBIM_UICC_ACCESS_RECORD | Nicht verfügbar |
| Antwort | Nicht verfügbar | MBIM_UICC_RESPONSE | Nicht verfügbar |
Abfrage
Liest den Inhalt eines Datensatzes. Der InformationBuffer für MBIM_COMMAND_MSG enthält die folgende MBIM_UICC_ACCESS_RECORD-Struktur. MBIM_UICC_RESPONSE wird im InformationBuffer von MBIM_COMMAND_DONE zurückgegeben.
MBIM_UICC_ACCESS_RECORD (Version 1)
| Offset | Size | Feld | type | Beschreibung |
|---|---|---|---|---|
| 0 | 4 | Version | UINT32 | Die Versionsnummer der folgenden Struktur. Dieses Feld muss für Version 1 dieser Struktur auf 1 festgelegt werden. |
| 4 | 4 | AppIdOffset | OFFSET | Der Offset in Bytes vom Anfang dieser Struktur bis zum Puffer, der die Anwendungs-ID enthält. |
| 8 | 4 | AppIdSize | GRÖßE (0..16) | Die Größe der Anwendungs-ID in Bytes, wie in Abschnitt 8.3 der technischen Spezifikation ETSI TS 102 221 definiert. Für 2G-Karten muss dieses Feld auf Null (0) festgelegt werden. |
| 12 | 4 | FilePathOffset | OFFSET | Der Offset in Bytes, der vom Anfang dieser Struktur bis zum Puffer berechnet wird, der den Dateipfad enthält. Der Dateipfad ist ein Array von 16-Bit-Datei-IDs. Die erste ID muss entweder 0x7FFF oder 0x3F00 sein. Wenn die erste ID 0x7FFF ist, ist der Pfad relativ zum ADF der von AppId erstellten Anwendung. Andernfalls ist es ein absoluter Pfad, der vom MF aus beginnt. |
| 16 | 4 | FilePathSize | SIZE | Die Größe des Dateipfads in Bytes. |
| 20 | 4 | RecordNumber | UINT32(0..256) | Die Datensatznummer. Dies stellt jederzeit den absoluten Datensatzindex dar. Der relative Datensatzzugriff wird nicht unterstützt, da das Modem mehrere Zugriffe auf eine Datei (NEXT, PREVIOUS) ausführen kann. |
| 24 | 4 | LocalPinOffset | OFFSET | Der Offset in Bytes, der vom Anfang dieser Struktur bis zum Puffer berechnet wird, der das Kennwort enthält. Das Sperrkennwort ist eine UTF-8-Zeichenfolge mit Null-Beendigung mit Dezimalstellen. |
| 28 | 4 | LocalPinSize | GRÖßE (0..16) | Die Größe des Kennworts in Bytes. |
| 32 | 4 | RecordDataOffset | OFFSET | Der Offset in Bytes, der vom Anfang dieser Struktur bis zum Puffer berechnet wird, der die befehlsspezifischen Daten enthält. Datensatzdaten werden nur für SET-Vorgänge verwendet. |
| 36 | 4 | RecordDataSize | GRÖßE (0..256) | Die Größe der Daten in Bytes. |
| 40 | DataBuffer | DATABUFFER | Der Datenpuffer, der AppId, FilePath, LocalPin und RecordData enthält. |
Set
Nicht zutreffend
Antwort
Im InformationBuffer wird eine MBIM_UICC_RESPONSE-Struktur verwendet.
Nicht angeforderte Ereignisse
Nicht zutreffend
Statuscodes
Es gelten die folgenden status-Codes:
| Statuscode | Beschreibung |
|---|---|
| MBIM_STATUS_BUSY | Grundlegende MBIM-status wie für alle Befehle definiert. |
| MBIM_STATUS_FAILURE | Grundlegende MBIM-status wie für alle Befehle definiert. |
| MBIM_STATUS_SIM_NOT_INSERTED | Der UICC-Vorgang kann nicht ausgeführt werden, da die UICC fehlt. |
| MBIM_STATUS_BAD_SIM | Der UICC-Vorgang kann nicht ausgeführt werden, da sich die UICC in einem Fehlerzustand befindet. |
| MBIM_STATUS_SHAREABILITY_CONDITION_ERROR | Die Datei kann nicht ausgewählt werden, da sie nicht freigegeben werden kann und derzeit von einer anderen Anwendung zugegriffen wird. Das von der SIM zurückgegebene status Wort ist 6985. |
| MBIM_STATUS_PIN_FAILURE | Der Vorgang ist aufgrund eines PIN-Fehlers fehlgeschlagen. |
MBIM_CID_MS_PIN_EX
Dieser CID wird verwendet, um alle PIN-Sicherheitsvorgänge gemäß Abschnitt 9 der technischen Spezifikation ETSI TS 102 221 durchzuführen. Die CID ähnelt MBIM_CID_MS_PIN, erweitert sie jedoch, um UICC-Karten mit mehreren Apps zu unterstützen. Es werden nur single-verification-fähige UICCs unterstützt. UICCs mit mehreren Überprüfungen, die mehrere Anwendungs-PIN unterstützen, werden nicht unterstützt. Eine Anwendungs-PIN (PIN1) ist allen ADFs/DFs und Dateien auf der UICC zugewiesen. Jede Anwendung kann jedoch eine lokale PIN (PIN2) als Benutzerüberprüfungsanforderung der Ebene 2 angeben, sodass für jeden Zugriffsbefehl eine zusätzliche Validierung erforderlich ist. Dieses Szenario unterstützt MBIM_CID_MS_PIN_EX.
Genau wie MBIM_CID_MS_PIN meldet das Gerät bei MBIM_CID_MS_PIN_EX jeweils nur eine PIN. Wenn mehrere PINs aktiviert sind und auch die Berichterstellung für mehrere PINs aktiviert ist, müssen Funktionen PIN1 zuerst melden. Wenn beispielsweise die Berichterstattung über die Subventionssperre aktiviert ist und die PIN1 der SIM-Karte aktiviert ist, sollte die PIN der Subventionssperre erst in einer nachfolgenden Abfrageanforderung gemeldet werden, nachdem PIN1 erfolgreich überprüft wurde. Eine leere PIN ist zusammen mit MBIMPinOperationEnter zulässig. Eine leere PIN wird angegeben, indem Sie pinSize auf 0 festlegen. In diesem Fall ähnelt ein SET-Befehl einer ABFRAGE und gibt den Status der PIN zurück, auf die verwiesen wird. Dies ist vollständig auf das Verhalten des VERIFY-Befehls ausgerichtet, wie in Abschnitt 11.1.9 der technischen Spezifikation ETSI TS 102 221 angegeben.
Parameter
| Vorgang | Set | Abfrage | Benachrichtigung |
|---|---|---|---|
| Get-Help | MBIM_SET_PIN_EX | MBIM_PIN_APP | Nicht verfügbar |
| Antwort | MBIM_PIN_INFO_EX | MBIM_PIN_INFO_EX | Nicht verfügbar |
Abfrage
Die folgende MBIM_PIN_APP-Struktur wird im InformationBuffer verwendet.
MBIM_PIN_APP (Version 1)
| Offset | Size | Feld | type | Beschreibung |
|---|---|---|---|---|
| 0 | 4 | Version | UINT32 | Die Versionsnummer der folgenden Struktur. Dieses Feld muss für Version 1 dieser Struktur auf 1 festgelegt werden. |
| 4 | 4 | AppIdOffset | OFFSET | Der Offset in Bytes vom Anfang dieser Struktur bis zum Puffer, der die Anwendungs-ID enthält. |
| 8 | 4 | AppIdSize | GRÖßE (0..16) | Die Größe der Anwendungs-ID in Bytes gemäß Abschnitt 8.3 der technischen Spezifikation ETSI TS 102 221. Für 2G-Karten muss dieses Feld auf Null (0) festgelegt werden. |
| 12 | DataBuffer | DATABUFFER | Die AppId, wie in der technischen Spezifikation ETSI TS 102 221 definiert. |
Set
Die folgende MBIM_SET_PIN_EX-Struktur wird im InformationBuffer verwendet.
MBIM_SET_PIN_EX
| Offset | Size | Feld | type | Beschreibung |
|---|---|---|---|---|
| 0 | 4 | PinType | MBIM_PIN_TYPE_EX | Der PIN-Typ. Weitere Informationen finden Sie in der tabelle MBIM_PIN_TYPE_EX in diesem Thema. |
| 4 | 4 | PinOperation | MBIM_PIN_OPERATION | Der PIN-Vorgang. Siehe MBIM 1.0. |
| 8 | 4 | PinOffset | OFFSET | Der Offset in Bytes, der vom Anfang dieser Struktur auf eine Zeichenfolgen-PIN berechnet wird, die den PIN-Wert darstellt, mit dem die Aktion ausgeführt werden soll, oder den PIN-Wert, der zum Aktivieren oder Deaktivieren von PIN-Einstellungen erforderlich ist. Dieses Feld gilt für alle Werte von PinOperation. |
| 12 | 4 | Anheften | SIZE (0..32) | Die Größe in Bytes, die für die PIN verwendet wird. |
| 16 | 4 | NewPinOffset | OFFSET | Der Offset in Bytes, der vom Anfang dieser Struktur auf die NewPin-Zeichenfolge berechnet wird, die den neuen PIN-Wert darstellt, der festgelegt werden soll, wenn PinOperation MBIMPinOperationChange oder MBIMPinOperationEnter ist, für PinTypeMBIMPinTypePuk1 oder PinTypeMBIMPinTypePuk2. |
| 20 | 4 | NewPinSize | SIZE (0..32) | Die Größe in Bytes, die für den NewPin verwendet wird. |
| 24 | 4 | AppIdOffset | OFFSET | Der Offset in Bytes, der vom Anfang dieser Struktur bis zum Puffer berechnet wird, der die Anwendungs-ID enthält. |
| 28 | 4 | AppIdSize | GRÖßE (0..16) | Die Größe der Anwendungs-ID in Bytes gemäß Abschnitt 8.3 der technischen Spezifikation ETSI TS 102 221. Für 2G-Karten muss dieses Feld auf Null (0) festgelegt werden. |
| 32 | DataBuffer | DATABUFFER | Der Datenpuffer, der die Anheftung, NewPin und AppId enthält. |
Antwort
Die folgende MBIM_PIN_INFO_EX-Struktur wird im InformationBuffer verwendet.
| Offset | Size | Feld | type | Beschreibung |
|---|---|---|---|---|
| 0 | 4 | PinType | MBIM_PIN_TYPE_EX | Der PIN-Typ. Weitere Informationen finden Sie in der tabelle MBIM_PIN_TYPE_EX in diesem Thema. |
| 4 | 4 | PinState | MBIM_PIN_STATE | Der PIN-Status. Siehe MBIM 1.0. |
| 8 | 4 | VerbleibendeEmpts | UINT32 | Die Anzahl der verbleibenden Versuche für PIN-bezogene Vorgänge, z. B. Eingabe, Aktivierung oder Deaktivierung. Geräte, die diese Informationen nicht unterstützen, müssen diesen Member auf 0xFFFFFFFF festlegen. |
Nicht angeforderte Ereignisse
Nicht zutreffend
Statuscodes
Es gelten die folgenden status-Codes:
| Statuscode | Beschreibung |
|---|---|
| MBIM_STATUS_BUSY | Grundlegende MBIM-status wie für alle Befehle definiert. |
| MBIM_STATUS_FAILURE | Grundlegende MBIM-status wie für alle Befehle definiert. |
| MBIM_STATUS_SIM_NOT_INSERTED | Der UICC-Vorgang kann nicht ausgeführt werden, da die UICC fehlt. |
| MBIM_STATUS_BAD_SIM | Der UICC-Vorgang kann nicht ausgeführt werden, da sich die UICC in einem Fehlerzustand befindet. |
| MBIM_STATUS_PIN_DISABLED | Fehler beim Vorgang, da die PIN deaktiviert ist. |
| MBIM_STATUS_PIN_REQUIRED | Fehler beim Vorgang, da eine PIN eingegeben werden muss, um fortzufahren. |
| MBIM_STATUS_NO_DEVICE_SUPPORT | Der Vorgang ist fehlgeschlagen, da ein SET für einen entsprechenden PIN-Typ vom Gerät nicht unterstützt wird. |