Operazioni PIN MB
Panoramica
In questo argomento vengono descritte le operazioni correlate al controllo di accesso delle informazioni di sottoscrizione archiviate nella memoria del dispositivo MB o nella scheda SIM (Subscriber Identity Module). Ciò include l'abilitazione, la disabilitazione o la modifica del PIN (Personal Identification Number), nonché lo sblocco tramite PIN o Personal Unlocking Key (PUK).
Architettura/flussi
Azioni utente per abilitare/disabilitare/sbloccare/modificare il PIN
Query dell'esperienza utente cellulare per lo stato PIN1/PUK1
Sblocco automatico dopo la ripresa dall'ibernazione
MBIM_CID_MS_PIN_EX
Questo CID è descritto qui: MBIM_CID_MS_PIN_EX
MBIM_CID_PIN_LIST
Descrizione
Questo comando restituisce un elenco di tutti i diversi tipi di numeri di identificazione personale (PIN) supportati dal dispositivo MB e dettagli aggiuntivi per ogni tipo di PIN, ad esempio la lunghezza del PIN (lunghezza minima e massima), il formato PIN e la modalità di immissione PIN (abilitata/disabilitata/non disponibile). Questo CID specifica anche la modalità corrente di ogni PIN supportato dalla funzione . Le funzioni devono segnalare tutti i PIN supportati. Tuttavia, PIN1 per i dispositivi in modalità multipla deve essere segnalato una sola volta.
Un PIN segnalato come PIN1 deve essere conforme alle linee guida per PIN1: per i dispositivi basati su CDMA si tratta di un PIN che fornisce funzionalità di verifica o identificazione di alimentazione e per i dispositivi basati su GSM si tratta di un PIN sim (Subscriber Identity Module).
Le funzioni devono essere in grado di restituire queste informazioni quando lo stato pronto passa a MBIMSubscriberReadyStateInitialized o quando lo stato pronto è MBIMSubscriberReadyStateDeviceLocked (PIN bloccato). Le funzioni devono anche restituire queste informazioni in altri stati pronti, laddove possibile.
Solo query
InformationBuffer del messaggio di query è vuoto. InformationBuffer di MBIM_COMMAND_DONE contiene un MBIM_PIN_LIST_INFO.
Parametri
| Set | Query | Notifica | |
|---|---|---|---|
| Comando | N/D | Empty | N/D |
| Response. | N/D | MBIM_PIN_LIST_INFO | N/D |
strutture di dati
MBIM_PIN_MODE
| Tipi | Valore |
|---|---|
| MBIMPinModeNotSupported | 0 |
| MBIMPinModeEnabled | 1 |
| MBIMPinModeDisabled | 2 |
MBIM_PIN_FORMAT
| Tipi | Valore |
|---|---|
| MBIMPinFormatUnknown | 0 |
| MBIMPinFormatNumeric | 1 |
| MBIMPinFormatAlphaNumeric | 2 |
MBIM_PIN_DESC
| Offset | Dimensione | Campo | Tipo | Descrizione |
|---|---|---|---|---|
| 0 | 4 | PinMode | MBIM_PIN_MODE | Vedere la tabella precedente MBIM_PIN_MODE. Viene visualizzato se il blocco è abilitato o meno. Non viene visualizzato se lo stato del blocco è bloccato o sbloccato. |
| 4 | 4 | PinFormat | MBIM_PIN_FORMAT | Vedere la tabella precedente MBIM_PIN_FORMAT. |
| 8 | 4 | PinLengthMin | UINT32 | Numero minimo di caratteri nel PIN. I dispositivi non devono specificare un valore maggiore di 16. I dispositivi devono specificare 0xffffffff, se la lunghezza del PIN non è disponibile. |
| 12 | 4 | PinLengthMax | UINT32 | Numero massimo di caratteri nel PIN. I dispositivi non devono specificare un valore maggiore di 16. I dispositivi devono specificare 0xffffffff, se la lunghezza del PIN non è disponibile. |
Query
InformationBuffer deve essere null e InformationBufferLength sarà zero.
Risposta
La struttura seguente deve essere utilizzata in InformationBuffer:
MBIM_PIN_LIST_INFO
| Offset | Dimensione | Campo | Tipo | Descrizione |
|---|---|---|---|---|
| 0 | 16 | PinDescPin1 | MBIM_PIN_DESC | MBIM_PIN_DESC struttura che descrive PIN1. Per i dispositivi GSMbased, si tratta di un PIN SIM (Subscriber Identity Module). Per i dispositivi basati su CDMA, il blocco del dispositivo power-on viene segnalato come PIN1. |
| 16 | 16 | PinDescPin2 | MBIM_PIN_DESC | MBIM_PIN_DESC struttura che descrive IL PIN2. Si tratta di un PIN SIM2 che protegge determinate funzionalità SIM. |
| 32 | 16 | PinDescDeviceSimPin | MBIM_PIN_DESC | MBIM_PIN_DESC struttura che descrive il PIN della scheda da dispositivo a SIM. Si tratta di un PIN che blocca il dispositivo a una SIM specifica. |
| 48 | 16 | PinDescDeviceFirstSimPin | MBIM_PIN_DESC | MBIM_PIN_DESC struttura che descrive il PIN della scheda DEVICE-to-first-SIM. Si tratta di un PIN che blocca il dispositivo alla SIM inserita per la prima volta. |
| 64 | 16 | PinDescNetworkPin | MBIM_PIN_DESC | MBIM_PIN_DESC struttura che descrive il PIN di personalizzazione di rete. Questo è un PIN che consente al dispositivo di essere personalizzato in una rete. Per altre informazioni su questo tipo di PIN, vedere specifica 3GPP 22.022. |
| 80 | 16 | PinDescNetworkSubsetPin | MBIM_PIN_DESC | MBIM_PIN_DESC struttura che descrive il PIN di personalizzazione del subset di rete. Questo è un PIN che consente al dispositivo di essere personalizzato in un subset di una rete. Per altre informazioni su questo tipo di PIN, vedere specifica 3GPP 22.022. |
| 96 | 16 | PinDescServiceProviderPin | MBIM_PIN_DESC | MBIM_PIN_DESC struttura che descrive il PIN di personalizzazione del provider di servizi (SP). Questo è un PIN che consente al dispositivo di essere personalizzato a un provider di servizi. Per altre informazioni su questo tipo di PIN, vedere specifica 3GPP 22.022. |
| 112 | 16 | PinDescCorporatePin | MBIM_PIN_DESC | MBIM_PIN_DESC struttura che descrive il PIN di personalizzazione aziendale. Si tratta di un PIN che consente di personalizzare il dispositivo a un'azienda specifica. Per altre informazioni su questo tipo di PIN, vedere specifica 3GPP 22.022. |
| 128 | 16 | PinDescSubsidyLock | MBIM_PIN_DESC | MBIM_PIN_DESC struttura che descrive il PIN di sblocco delle sovvenzioni. Si tratta di un PIN che consente al dispositivo di essere limitato a funzionare in una rete specifica. Per altre informazioni su questo tipo di PIN, vedere specifica 3GPP 22.022. |
| 144 | 16 | PinDescCustom | MBIM_PIN_DESC | MBIM_PIN_DESC struttura che descrive il PIN personalizzato. Si tratta di un tipo PIN definito dal fornitore personalizzato. Non è incluso nell'elenco precedente. |
Codici di stato
| Codice di stato | Descrizione |
|---|---|
| MBIM_STATUS_PIN_REQUIRED | L'operazione di elenco PIN non è riuscita perché un PIN deve essere immesso prima che questa operazione possa procedere. |
Test
I test seguenti vengono eseguiti come parte dell'elenco di test TestPin HLK:
| Nome test | Descrizione |
|---|---|
| PinListQueryRadioOn | Questo test tenta una query di elenco pin con la radio. |
| PinListQueryRadioOff | Questo test tenta una query di elenco pin con la radio disattivata. |
| NoPinSupport | Questo test verifica un dispositivo che non supporta PIN1. |
| PinExSetEnableDisableWithValidPin | Questo test abilita e disabilita PIN1 con un pin valido. |
| PinExSetDisableIncorrectPinWithValidLength | Questo test tenta di abilitare PIN1 con un pin non corretto con lunghezza valida. |
| PukEnableDisableThroughIncorrectPinExDisable | Questo test abilita PUK1 immettendo pin1 non corretto più volte e quindi disabilita PUK1. |
| PinExSetChangeWithBothInvalidAndValidPin | Questo test abilita PIN1, modifica immediatamente il PIN e lo disabilita. |
| RebootTestMachineToPutPinIntoLockState | Questo test riavvia il dispositivo per rendere il modem immettere lo stato di blocco e richiedere la voce del PIN valida. |
| PinExSetEnterWithValidPin | Questo test verifica che il dispositivo sia in stato di blocco per richiedere la voce del codice PIN. |
L'elenco di test di TestPowerStates HLK contiene anche un test pertinente- SimPinUnlockAfterHibernate.
Analisi dei log
Log di esempio:
Sblocco automatico:
462678 [0]0F3C.1280::2020-05-05 13:03:46.378805100 [Microsoft-Windows-WWAN-SVC-EVENTS][Request=0x53] Received PinInfo, status=WWAN_STATUS_SUCCESS , Type=WwanPinTypePin1 State=WwanPinStateEnter Attempts=3, miniport={7971731f-33f9-4f1a-9718-087c12e64c5d}
462753 [7]0F3C.2A6C::2020-05-05 13:03:46.379718400 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanPinSM::maybeUnlockPin: Attempting auto-PIN-unlock. Interface: {{7971731f-33f9-4f1a-9718-087c12e64c5d}}
462809 [7]0F3C.2A6C::2020-05-05 13:03:46.380157500 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Error] CWwanPinSM::maybeUnlockPin: Attempt to auto-unlock PIN succeeded
Set Pin (WwanPinTypePinPin1):
546408 [3]0F3C.1240::2020/05/02-09:18:09.178460200 [Microsoft-Windows-WWAN-SVC-EVENTS][Request=0x6C] Sent SET PinAction, Type=2(WwanPinTypePin1), Operation=0(WwanPinOperationEnter), miniport={7971731f-33f9-4f1a-9718-087c12e64c5d}, ErrorCode=3407873(WIN=The request will be completed later by NDIS status indication.)
546425 [1]3DB0.12EC::2020/05/02-09:18:09.178564700 [Microsoft.Windows.CellCore.MBBSettingsUX]{"meta":{"provider":"Microsoft.Windows.CellCore.MBBSettingsUX","event":"MBCategory::_SetPinAction. WwanSetInterface succeeded","time":"2020-05-02T16:18:09.1785647Z","cpu":1,"pid":15792,"tid":4844,"channel":11,"level":4}}
546644 [2]0F3C.39E4::2020/05/02-09:18:09.426362600 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanPinSM::processPinActionResponse: SetPin rsp rcvd (result:0x0) PIN Info (state:1, type:3, attemptsRemaining:3) IsPin1Blocked 0
546645 [2]0F3C.39E4::2020/05/02-09:18:09.426364800 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanPinSM::maybeCapturePin: Capturing PIN for PIN ENTER/ENABLE operation Interface: {{7971731f-33f9-4f1a-9718-087c12e64c5d}}
546688 [7]3B64.2A80::2020/05/02-09:18:09.426727000 [MbaeApiLogging]{"NotificationCode":"WwanMsmEventTypePinActionComplete: Success","AdapterID":"{7971731f-33f9-4f1a-9718-087c12e64c5d}","NotificationSize":24,"meta":{"provider":"MbaeApiLogging","event":"CWwanTranslator::ProcessWwanNotification","time":"2020-05-02T16:18:09.4267270Z","cpu":7,"pid":15204,"tid":10880,"channel":11,"level":5}}
546702 [0]3B64.242C::2020/05/02-09:18:09.426762000 [Microsoft.Windows.CellCore.MBBSettingsUX]{"meta":{"provider":"Microsoft.Windows.CellCore.MBBSettingsUX","event":"MBMediaManager::ProcessWwanNotification WwanMsmEventTypePinActionComplete","time":"2020-05-02T16:18:09.4267620Z","cpu":0,"pid":15204,"tid":9260,"channel":11,"level":4}}
546710 [7]0F3C.1208::2020/05/02-09:18:09.426809700 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] _PublishSebNotification: Event Source=WwanNotificationSourceMsm, Code=WwanMsmEventTypePinActionComplete
547064 [2]3DB0.1194::2020/05/02-09:18:09.427921200 [MbaeApiLogging]{"NotificationCode":"WwanMsmEventTypePinActionComplete: Success","AdapterID":"{7971731f-33f9-4f1a-9718-087c12e64c5d}","NotificationSize":24,"meta":{"provider":"MbaeApiLogging","event":"CWwanTranslator::ProcessWwanNotification","time":"2020-05-02T16:18:09.4279212Z","cpu":2,"pid":15792,"tid":4500,"channel":11,"level":5}}
547106 [2]3DB0.0B38::2020/05/02-09:18:09.428040100 [Microsoft.Windows.CellCore.MBBSettingsUX]{"meta":{"provider":"Microsoft.Windows.CellCore.MBBSettingsUX","event":"MBMediaManager::ProcessWwanNotification WwanMsmEventTypePinActionComplete","time":"2020-05-02T16:18:09.4280401Z","cpu":2,"pid":15792,"tid":2872,"channel":11,"level":4}}
Elenco pin:
465632 [4]0F3C.47F4::2020-05-05 13:03:46.395488200 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanPinSM::tracePinDesc: PIN1 (mode:1, format:1, pinlnmin:4, pinlnmax:8)
465633 [4]0F3C.47F4::2020-05-05 13:03:46.395489800 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanPinSM::tracePinDesc: PIN2 (mode:1, format:1, pinlnmin:4, pinlnmax:8)
465634 [4]0F3C.47F4::2020-05-05 13:03:46.395491400 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanPinSM::tracePinDesc: DEVSIMPIN (mode:0, format:0, pinlnmin:0, pinlnmax:0)
465635 [4]0F3C.47F4::2020-05-05 13:03:46.395492800 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanPinSM::tracePinDesc: DEVFIRSTSIMPIN (mode:0, format:0, pinlnmin:0, pinlnmax:0)
465636 [4]0F3C.47F4::2020-05-05 13:03:46.395494200 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanPinSM::tracePinDesc: NWPIN (mode:0, format:0, pinlnmin:0, pinlnmax:0)
465637 [4]0F3C.47F4::2020-05-05 13:03:46.395495800 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanPinSM::tracePinDesc: NWSUBSETPIN (mode:0, format:0, pinlnmin:0, pinlnmax:0)
465641 [5]0F3C.47F4::2020-05-05 13:03:46.395510100 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanPinSM::tracePinDesc: SVCPROVIDERPIN (mode:0, format:0, pinlnmin:0, pinlnmax:0)
465643 [5]0F3C.47F4::2020-05-05 13:03:46.395513700 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanPinSM::tracePinDesc: CORPORATEPIN (mode:0, format:0, pinlnmin:0, pinlnmax:0)
465644 [5]0F3C.47F4::2020-05-05 13:03:46.395515200 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanPinSM::tracePinDesc: SUBSIDYLOCK (mode:0, format:0, pinlnmin:0, pinlnmax:0)
WinRT API
Vedere anche
Accesso all'applicazione e al file system UICC MB
Per altre informazioni sulle operazioni pin, vedere OID_WWAN_PIN.