Operazioni PCO (MB Protocol Configuration Options)
Panoramica
Lo scopo delle opzioni di configurazione del protocollo (PCO) è trasferire le opzioni del protocollo di rete esterne associate a un'attivazione del contesto PDP (Packet Data Protocol). Le definizioni NDIS di Windows per i valori PCO sono in genere generiche per ricevere valori PCO completi dal modem e dalla rete in futuro. Tuttavia, a partire da Windows 10 versione 1709 alcuni modem sono in grado di passare solo elementi PCO specifici dell'operatore al sistema operativo. Questo argomento definisce il comportamento dell'implementazione PCO specifica dell'operatore corrente.
Flussi
Esistono tre scenari in cui il valore PCO verrà passato all'host:
- Quando un nuovo valore PCO è arrivato su una connessione attivata
- Quando un'app o un servizio esegue una query per il valore PCO più recente dal modem
- Quando una connessione viene bridged o attivata per la prima volta e un valore PCO esiste già nel modem
Per il primo scenario, il modem deve inviare una notifica di NDIS_STATUS_WWAN_PCO_STATUS al sistema operativo che indica una modifica di un nuovo valore PCO ogni volta che viene ricevuto un nuovo valore PCO dalla rete, con il numero di porta NDIS appropriato per rappresentare il PDN corrispondente. Per evitare di svuotare la batteria inutilmente, il modem deve evitare notifiche rumorose, come descritto in Comportamento modem con sospensione selettiva e standby connesso.
Per il secondo scenario, quando un'app o un servizio esegue una query sul valore PCO dal modem in una connessione PDN attivata, l'host invierà al modem una richiesta di query OID_WWAN_PCO per leggere il valore PCO memorizzato nella cache più recente nel modem.
Per il terzo scenario, quando una connessione viene attivata o bridged nell'host, il modem deve inviare una notifica di NDIS_STATUS_WWAN_PCO_STATUS quando nel modem esiste già un valore PCO per la connessione attivata o bridged richiesta dall'host. La notifica deve essere passata dal numero di porta NDIS corrispondente del PDN.
La figura seguente illustra il flusso dello scenario:
Comportamento del modem con sospensione selettiva e standby connesso
Quando la sospensione selettiva è abilitata, il modem può inviare una notifica al sistema operativo ogni volta che riceve una struttura di dati PCO dalla rete. Tuttavia, il modem deve evitare la riattivazione del dispositivo non necessaria. In caso contrario, le notifiche PCO rumorose dalla rete riattivano il dispositivo frequentemente e svuotano la batteria inutilmente.
Quando lo standby connesso è abilitato, il modem non deve notificare al sistema operativo quando riceve strutture di dati PCO dalla rete, perché non solo riattiva il dispositivo, ma riattiva anche il sistema operativo, che non è necessario. Al contrario, il modem deve memorizzare nella cache tutti gli elementi PCO più recenti dalla struttura dei dati e notificare al sistema operativo una volta che il sistema operativo esce da Connected Standby. Per un modem MBIM, deve memorizzare nella cache tutte le strutture di dati PCO e inviare notifiche PCO al sistema operativo solo dopo la sottoscrizione dell'host. Questa operazione verrà eseguita usando il CID MBIM_CID_DEVICE_SERVICE_SUBSCRIBE_LIST quando l'alimentazione del sistema è tornata a piena potenza dopo l'uscita dallo standby connesso.
Reimpostazione del modem in base ai valori PCO
In base ai valori PCO ricevuti dalla rete, il modem verrà reimpostato negli scenari seguenti:
- L'utente ha completato l'attivazione automatica dopo aver ricevuto PCO = 5 dalla rete. Al sistema operativo verrà inviato un nuovo valore PCO (3, 0 o qualsiasi app per operatori mobili) e il sistema operativo lo passerà all'app operatore mobile.
- L'utente ha aggiunto più credito al proprio account dopo aver ricevuto PCO = 3. Al sistema operativo verrà inviato un nuovo valore PCO (0 o qualsiasi app per operatori mobili) e il sistema operativo lo passerà all'app operatore mobile.
L'host non è a conoscenza del modem da reimpostare, quindi le connessioni attivate dall'host non verranno disattivate e il modem dovrebbe ristabilire automaticamente la connessione con il PDN dopo la reimpostazione. Dopo aver stabilito la connessione e ricevuto un nuovo valore PCO in ingresso dalla rete, il modem fornirà una notifica NDIS_STATUS_WWAN_PCO_STATUS non richiesta all'host.
Il diagramma seguente illustra il flusso di reimpostazione del modem quando si verifica uno di questi scenari, con Verizon Wireless come esempio MO:
Interfaccia NDIS per il modem
Per eseguire una query sullo stato e il payload di un valore PCO, vedere OID_WWAN_PCO. OID_WWAN_PCO usa la struttura NDIS_WWAN_PCO_STATUS , che a sua volta contiene una struttura WWAN_PCO_VALUE che rappresenta il payload delle informazioni PCO dalla rete.
Per la notifica di stato inviata da un driver miniport modem per informare il sistema operativo dello stato PCO corrente nel modem, vedere NDIS_STATUS_WWAN_PCO_STATUS.
CID MB al modem
Service = MBB_UUID_BASIC_CONNECT_EXT_CONSTANT
Service UUID = 3d01dcc5-fef5-4d05-0d3a-bef7058e9aaf
I CID seguenti sono definiti per PCO:
| CID | Codice del comando | Versione minima del sistema operativo |
|---|---|---|
| MBIM_CID_PCO | 9 | Windows 10, versione 1709 |
MBIM_CID_PCO
Questo comando viene usato per eseguire query sui dati PCO memorizzati nella cache nel modem dalla rete dell'operatore mobile.
Query
InformationBuffer contiene un MBIM_PCO_VALUE in cui l'unico campo pertinente è SessionId. SessionId è riservato per uso futuro e sarà sempre 0 in Windows 10 versione 1709. SessionId in una query indica il valore PCO del flusso di dati IP da restituire dalla funzione.
Set
Non applicabile.
Evento non richiesto
Gli eventi non richiesti contengono un MBIM_PCO_VALUE e vengono inviati quando un nuovo valore PCO è arrivato in una connessione attivata.
Parametri
| Operazione | Set | Query | Notifica |
|---|---|---|---|
| Comando | Non applicabile | MBIM_PCO_VALUE | Non applicabile |
| Risposta | Non applicabile | MBIM_PCO_VALUE | MBIM_PCO_VALUE |
strutture di dati
MBIM_PCO_TYPE
| Type | valore | Descrizione |
|---|---|---|
| MBIMPcoTypeComplete | 0 | Specifica che la struttura PCO completa verrà passata come ricevuta dalla rete e l'intestazione riflette realisticamente il protocollo in ottetto 3 della struttura PCO, definito nella specifica TS24.008 3GPP. |
| MBIMPcoTypePartial | 1 | Specifica che il modem passerà solo un subset di strutture PCO ricevute dalla rete. L'intestazione corrisponde alla struttura PCO definita nella specifica TS24.008 3GPP, ma il "protocollo di configurazione" di ottetto 3 potrebbe non essere valido. |
MBIM-PCO-TYPE
| Offset | Dimensione | Campo | Tipo | Descrizione |
|---|---|---|---|---|
| 0 | 4 | SessionId | UINT32 | SessionId in una query indica il valore PCO del flusso di dati IP da restituire dalla funzione. |
| 4 | 4 | PcoDataSize | UINT32 | Lunghezza di PcoData, da 0 a 256. Questo valore sarà 0 in una query. |
| 8 | 4 | PcoDataType | UINT32 | Tipo di dati PCO. Per altre informazioni, vedere MBIM_PCO_TYPE. |
| 12 | PcoDataBuffer | DATABUFFER | Struttura PCO dalla specifica TS24.008 3GPP. |
Codici di stato
Questo CID usa solo codici di stato generici.
Test di Hardware Lab Kit (HLK)
Vedere Passaggi per l'installazione di HLK.
In HLK Studio connettersi al driver del modem cellulare del dispositivo ed eseguire il test: TestPco.