Wi-Fi implementación de emparejamiento directo
En esta sección se proporcionan instrucciones de diseño y requisitos para que un dispositivo periférico participe en los casos de uso Tap y Setup y Tap y Reconectar.
Nota
La implementación de emparejamiento descrita en este tema se admite actualmente en Windows 8.1, solo para emparejamiento con dispositivos de impresora.
Windows 10 y versiones posteriores admite NFC para Wi-Fi entrega de conexiones estáticas directas a través del registro de configuración de Wi-Fi alianza Wi-Fi P2P Carrier. Para obtener más información, consulte Wi-Fi Alliance.
Emparejamiento directo de dispositivos periféricos Wi-Fi
Durante la pulsación, NFP recibe información de emparejamiento del dispositivo de conexión. NFP pasa la información de emparejamiento a Windows. Wi-Fi dispositivos directos siguen el procedimiento de emparejamiento fuera de banda (OOB) de Wi-Fi Alliance y las recomendaciones del foro NFC. Windows se basa en un mensaje de emparejamiento propietario, tal como se define a continuación.
Windows pedirá al usuario su consentimiento y, si se da, Windows intentará conectarse a cada una de las direcciones, en orden, hasta que se realice correctamente. No hay ninguna interacción adicional entre un proveedor NFP en el equipo y el dispositivo de conexión.
El uso de NFC como ejemplo, la instalación unidireccional se logra almacenando la información de emparejamiento en una etiqueta NFC estática o pasiva (también se puede usar una etiqueta NFC activa en modo de emulación estática). Windows se suscribe a esta información de emparejamiento. Un proveedor NFP habilitado para NFC en el equipo recibe la información de conexión de la etiqueta y lo pasa a Windows como suscriptor. Tras recibir la información de conexión, Windows realiza la instalación real del dispositivo en banda mediante técnicas específicas de clase de dispositivo.
Requisitos de interoperabilidad
Para garantizar la interoperabilidad entre proveedores de NFP, la información de emparejamiento debe encapsularse en un formato de mensaje específico del proveedor.
Como se describe en otra parte de este documento, no hay requisitos específicos para las tecnologías de proximidad que no sean para los proveedores NFP habilitados para NFC.
Windows requiere proveedores NFP habilitados para NFC para admitir un mecanismo específico definido por el foro NFC para transmitir la información de emparejamiento de OOB directo Wi-Fi para el emparejamiento unidireccional. El mensaje NDEF contiene un primer registro con un valor de campo TNF de 0x01 y un campo TYPE igual a "Hs" y un registro de operador alternativo que apunta a un registro de configuración de operador directo de Wi-Fi. En este método, solo se usará la CARGA del registro NDEF.
Emparejamiento unidireccional mediante NFC para Wi-Fi Direct
En esta sección se proporcionan más detalles sobre cómo NFC, Wi-Fi Direct y Windows funcionan conjuntamente para admitir el emparejamiento inalámbrico unidireccional para Wi-Fi dispositivos Direct como impresoras.
Referencias del proveedor NFP
Wi-Fi emparejamiento directo se realiza mediante un foro NFC estandarizado Connection Handover Select tipo de mensaje. En el gráfico siguiente se proporciona información general sobre cómo se aplica un mensaje connection Handover Select para Wi-Fi emparejamiento directo de dispositivos, específicamente los registros NDEF 3 y 4. El mensaje Handover Select describe uno o varios registros "ac" o "Alternate Carrier". Estos registros siguen el registro Handover Select secuencialmente y cada uno tiene un tipo bien definido. Por último, el mensaje contendrá un registro de emparejamiento de dispositivos definido por Microsoft que proporciona a Windows información sobre cómo procesar la operación de emparejamiento.
Wi-Fi mensaje de emparejamiento directo de dispositivos
En los casos de uso de ejemplo siguientes, las etiquetas de tipo NFC 2 se usan como ejemplo ilustrativo. Si es necesario usar un tipo de etiqueta NFC diferente, el mensaje NDEF se debe encapsular correctamente según esa definición de etiqueta.
| Campo | Valor | Descripción |
|---|---|---|
| TNF | 0x02 | Formato del campo Tipo que sigue. Tipo de medio tal y como se define en RFC 2046. |
| Tipo | 'application/vnd.ms-windows.wfd.oob' | Nueva cadena de tipo que definimos para este escenario. |
| Tamaño de los datos OOB | WORD | Se admiten hasta 64 KB de datos OOB. |
| Wi-Fi datos de OOB directo | <blob de tamaño indicado por el campo anterior> | Wi-Fi datos de OOB directo tal y como se define a continuación. |
Wi-Fi formato OOB directo
En la tabla siguiente se describe el formato de los datos de OOB de WiFi Direct. Los datos unidireccionales de OOB pueden transmitirse por cualquier dispositivo OOB P2P unidireccional.
| Atributos | Identificador de atributo | Obligatorio/opcional | Nota |
|---|---|---|---|
| Encabezado OOB Vea tabla de formato de atributo de encabezado OOB. |
N/D | Obligatorio | El atributo Encabezado OOB estará presente en el blob de datos OOB P2P y su valor de tipo OOB establecido en "Datos de aprovisionamiento unidirectional de OOB". |
| Información del dispositivo OOB Consulte tabla de formato de atributo de información del dispositivo OOB. |
1 | Obligatorio | Este atributo debe estar presente. Proporciona información sobre este dispositivo P2P. |
| Información de aprovisionamiento de OOB | 2 | Requerido | Este atributo debe estar presente. Proporciona información de aprovisionamiento que espera usar este dispositivo P2P. |
| Tiempo de espera de configuración de OOB | 5 | Requerido | Este atributo debe estar presente. Proporciona información sobre cuánto tiempo esperará este dispositivo P2P durante Wi-Fi Direct. |
Formato de atributo de encabezado OOB
| Nombre del campo | Tamaño (octetos) | Valor | Descripción |
|---|---|---|---|
| Longitud total de datos | 2 | Variable | Longitud del blob de datos OOB completo (incluido el encabezado). |
| Length | 2 | Variable | Longitud de los campos siguientes en el encabezado OOB. |
| Versión | 1 | 0x10 | Valor que identifica la versión de este registro OOB P2P. |
| Tipo OOB | 1 | Variable | Valor que identifica el tipo de transacción OOB. El valor específico se define en la tabla Tipos de transacción OOB . |
| OUI | 0 o 3 | Variable | OUI específica del proveedor. Es un valor opcional. Solo debe estar presente cuando el tipo OOB es específico del proveedor. |
| Tipo de OUI | 0 o 1 | Variable | Tipo específico del proveedor. Es un valor opcional. Solo debe estar presente cuando el tipo OOB es específico del proveedor. |
Tipos de transacción OOB
| Tipo OOB (hexadecimal) | Descripción |
|---|---|
| 0x00 | Datos de aprovisionamiento unidireccionales de OOB |
| 0x01 | Datos del agente de escucha de aprovisionamiento de OOB |
| 0x02 | Datos del conector de aprovisionamiento de OOB |
| 0x03 | Datos de OOB Reinvoke |
| 0x04-0xDC | Reservado |
| 0xDD | Específico del proveedor |
| 0xDE-0xFF | Reservado |
Formato de atributo de información de dispositivo OOB
| Nombre del campo | Tamaño (octetos) | Valor | Descripción |
|---|---|---|---|
| Identificador de atributo | 1 | 1 | Identificar el tipo de atributo OOB P2P. El valor específico se define en la tabla Atributos OOB de P2P. |
| Length | 2 | Variable | Longitud de los campos siguientes en el atributo . |
| Dirección del dispositivo P2P | 6 | Tal como se define en la especificación P2P. | Identificador que se usa para hacer referencia de forma única a un dispositivo P2P. |
| Métodos de configuración | 2 | Tal como se define en la especificación P2P. | Métodos WSC compatibles con este dispositivo. Nota: El orden de bytes dentro del campo Métodos de configuración será big-endian. |
| Tipo de dispositivo principal | 8 | Tal como se define en la especificación P2P. | Tipo de dispositivo principal del dispositivo P2P. Contiene solo la parte Data del atributo WSC Primary Device Type (excluye los campos Id. de atributo y Longitud). Nota: El orden de bytes dentro del campo Tipo de dispositivo principal será big-endian. |
| Mapa de bits de funcionalidad del dispositivo | 1 | Tal como se define en la especificación P2P. | Conjunto de parámetros que indican las funcionalidades del dispositivo P2P. |
| Device Name (Nombre del dispositivo) | Variable | Tal como se define en la especificación P2P. | Nombre descriptivo del dispositivo P2P. Contiene el formato TLV completo del atributo Nombre de dispositivo WSC. Nota: El orden de bytes dentro del campo Nombre del dispositivo será big-endian. |
Atributos de OOB P2P
| Tipo OOB (hexadecimal) | Descripción |
|---|---|
| 0x00 | Estado de OOB |
| 0x01 | Información del dispositivo OOB |
| 0x02 | Información de aprovisionamiento de OOB |
| 0x03 | Id. de grupo de OOB |
| 0x04 | Canal de escucha de OOB |
| 0x05 | Tiempo de espera de configuración de OOB |
| 0x06-0xDC | Reservado |
| 0xDD | Atributo específico del proveedor |
| 0xDE-0xFF | Reservado |
Formato de atributo de información de aprovisionamiento de OOB
| Nombre del campo | Tamaño (octetos) | Valor | Descripción |
|---|---|---|---|
| Identificador de atributo | 1 | 1 | Identificar el tipo de atributo OOB P2P. El valor específico se define en la tabla Atributos OOB P2P . |
| Length | 2 | Variable | Longitud de los campos siguientes en el atributo . |
| Mapa de bits de configuración de aprovisionamiento | 1 | Variable | Un conjunto de opciones de configuración de aprovisionamiento, tal como se define en la tabla Configuración de aprovisionamiento . |
| Método config seleccionado | 2 | Tal y como se define en la especificación P2P. | El método WSC seleccionado por este dispositivo P2P para el aprovisionamiento. |
| Longitud del anclaje | 1 | 0 - 8 | Número de bytes en el siguiente campo Datos de PIN. Este campo establecido en 0 indica que no hay datos de PIN adicionales. |
| Anclar datos | Variable | n | Este campo es opcional. Este campo solo está presente si el campo Longitud del PIN no es 0 y contiene una matriz de octetos que representan un PIN que se va a usar para el aprovisionamiento. |
Configuración de aprovisionamiento
| Bits | Information | Notas |
|---|---|---|
| 0 | Crear nuevo grupo | El bit Crear nuevo grupo se establece en 1 si esta información de aprovisionamiento es para formar un nuevo grupo con el dispositivo P2P de destino. De lo contrario, esta información de aprovisionamiento es para unirse a un grupo existente. |
| 1 | Aplicar la configuración del tipo de grupo | El bit Aplicar configuración de tipo de grupo se establece en 1 si se debe aplicar el bit Tipo de grupo deseado; de lo contrario, el bit Tipo de grupo deseado es simplemente una preferencia. |
| 2 | Tipo de grupo deseado | El bit Tipo de grupo deseado se establecerá en 0 si el tipo de grupo deseado es transitorio y se establecerá en 1 si el tipo de grupo deseado es persistente. |
| 3 - 7 | Reservado |
Formato de atributo de tiempo de espera de configuración de OOB
| Nombre del campo | Tamaño (octetos) | Valor | Descripción |
|---|---|---|---|
| Identificador de atributo | 1 | 5 | Identificar el tipo de atributo OOB P2P. El valor específico se define en la tabla Atributos OOB P2P . |
| Length | 2 | 1 | Longitud de los campos siguientes en el atributo . |
| Tiempo de espera de configuración del agente de escucha | 1 | De 0 a 255 | Cantidad de tiempo que este dispositivo P2P pasará esperando Wi-Fi comunicación directa después de la transferencia de datos OOB, en unidades de 100 milisegundos. (Máximo de 25,5 segundos). |
Registro de emparejamiento de dispositivos Windows
El registro de emparejamiento de dispositivos Windows sigue la especificación NDEF. Proporciona información adicional a Windows sobre cómo procesar el mensaje Connection Handover Select. Los campos TNF y Type deben especificarse según la especificación NDEF. Los demás campos siguientes se mostrarán secuencialmente en el campo Carga del registro NDEF.
| Nombre del campo | Value | Valor de longitud | Descripción |
|---|---|---|---|
| TNF | 0x02 | 3 bits | Formato del campo Tipo que sigue. Tipo de medio tal y como se define en RFC 2046. |
| Tipo | 'application/vnd.ms-windows.devicepairing' | 0x28 bytes | Nueva cadena de tipo que definimos para este escenario. |
| MajorVersion | 0x1 | 2 bytes | La versión principal debe ser 0x1. |
| MinorVersion | 0x0 | 2 bytes | Se requiere que la versión secundaria sea 0x0. |
| Marcas | 0x0 o 0x01 | 4 bytes | Establezca en 0x0 para probar todos los transportes. Establézcalo en 0x1 para intentar la instalación secuencialmente y detenerla después de que se haya realizado correctamente por primera vez. La preferencia para los transportes se indica mediante la secuencia de registros alternativos del transportista. Nota Los valores 0x0002 a través de 0x0064 están reservados. |
| Longitud del nombre descriptivo del dispositivo | Longitud del campo nombre descriptivo del dispositivo. | 1 byte | Longitud del nombre descriptivo del dispositivo. |
| Nombre descriptivo del dispositivo | Cadena codificada UTF-8 de hasta 255 bytes. | Longitud del nombre descriptivo del dispositivo | Nombre descriptivo del dispositivo que se mostrará en la interfaz de usuario de consentimiento en el cliente. |
Wi-Fi Direct just works ceremony, static connection handover tag format
Por ejemplo, lo siguiente es una implementación típica de una etiqueta pasiva NFC. Esto corresponde a un caso de entrega de conexión estática con un registro de operador directo Wi-Fi, una impresora de recurso compartido de red y el registro de emparejamiento ms-device.
En esta primera tabla se muestra el formato de la parte de emparejamiento directo de Wi-Fi de la etiqueta.
| Offset | Contenido | Length | Explicación |
|---|---|---|---|
| 0 | 0x91 | 1 | Encabezado de registro NDEF: MB=1b, ME=0b, CF=0b, SR=1b, IL=0b, TNF=001b |
| 1 | 0x02 | 1 | Longitud del tipo de registro: 2 octetos |
| 2 | 0x0A | 1 | Longitud del tipo de registro: 10 octetos |
| 3 | 0x48 0x73 | 2 | Tipo de registro: "Hs" |
| 5 | 0x12 | 1 | Número de versión: Principal = 1, Menor = 2 |
| 6 | 0xD1 | 1 | Encabezado de registro NDEF: MB=1b, ME=1b, CF=0b, SR=1b, IL=0b, TNF=001b |
| 7 | 0x02 | 1 | Longitud del tipo de registro: 2 octetos |
| 8 | 0x04 | 1 | Longitud de carga: 4 octetos |
| 9 | 0x61 0x63 | 2 | Tipo de registro: "ac" |
| 11 | 0x01 | 1 | Marcas de operador: CPS=1, "activo" |
| 12 | 0x01 | 1 | Longitud de referencia de datos del operador: 1 octeto |
| 13 | 0x30 | 1 | Referencia de datos del operador: "0" |
| 14 | 0x00 | 1 | Recuento de referencias de datos auxiliares: 0 |
| 15 | 0x1A | 1 | Encabezado de registro NDEF: MB=0b, ME=0b, CF=0b, SR=1b, IL=1b, TNF=010b |
| 16 | 0x22 | 1 | Longitud del nombre del tipo de registro: 34 octetos |
| 17 | 0x3E | 1 | Longitud de carga: 62 octetos |
| 18 | 0x01 | 1 | Longitud del identificador: 1 octeto |
| 19 | 0x61 0x70 0x70 0x6C 0x69 0x63 0x61 0x74 0x69 0x6F 0x6E 0x2F 0x76 0x6E 0x64 0x2E 0x6D 0x73 0x2D 0x77 0x69 0x6E 0x64 0x6F 0x77 0x73 0x2E 0x77 0x66 0x64 0x2E 0x6F 0x6F 0x62 |
34 | Nombre del tipo de registro: 'application/vnd.ms-windows.wfd.oob' |
| 53 | 0x30 | 1 | Identificador: "0" |
| 54 | 0x3E 0x00 | 2 | Wi-Fi longitud directa de datos OOB: 62 octetos. La longitud se lee como un short sin signo e incluye todo el blob. Incluye 2 octetos de longitud. Este valor debe almacenarse en formato little-endian. |
| 56 | 0x02, 0x00 | 2 | Longitud del encabezado: 2 octetos |
| 58 | 0x10 | 1 | Versión: 0x10 |
| 59 | 0x00 | 1 | Tipo OOB: 0x00 (unidireccional) |
| 60 | 0x01 | 1 | Atributo: 0x01 (atributo de información del dispositivo) |
| 61 | 0x22 0x00 | 2 | Longitud de la información del dispositivo: 34 octetos |
| 63 | 0x01 0x23 0x34 0xab 0xcd 0xef |
6 | Wi-Fi dirección MAC del dispositivo P2P directo: "01:23:34:ab:cd:ef" |
| 69 | 0x01 0x00 | 2 | Tipo de configuración |
| 71 | 0x00 0x01 0x00 0x50 0xF2 0x00 0x00 0x00 |
8 | Tipo de dispositivo principal |
| 79 | 0x12 | 1 | Capacidad |
| 80 | 0x10 0x11 | 2 | Atributo: Nombre del dispositivo |
| 82 | 0x00 0x0d | 2 | Longitud del nombre del dispositivo: 13 octetos |
| 84 | 0x43 0x6f 0x6e 0x74 0x6f 0x73 0x6f 0x20 0x4d 0x6f 0x75 0x73 0x65 |
13 | Nombre descriptivo del dispositivo en UTF-8. Tenga en cuenta que no hay ningún carácter de terminación NULL y que UTF-8 puede ser de uno o dos bytes por carácter. En este ejemplo se lee "Contoso Mouse" |
| 97 | 0x02 | 1 | Atributo: información de aprovisionamiento |
| 98 | 0x0c 0x00 | 2 | Longitud de la información de aprovisionamiento: 12 octetos |
| 100 | 0x07 | 1 | Establecer mapa de bits: nuevo grupo, aplicar persistente |
| 101 | 0x01 0x00 | 2 | Método de configuración: entrada de patilla |
| 103 | 0x08 | 1 | Longitud de patilla: 8 octetos |
| 104 | 0x01 0x02 0x03 0x04 0x05 0x06 0x07 0x08 |
8 | Pin: "12345678" |
| 112 | 0x05 | 1 | Atributo: información de tiempo de espera de configuración |
| 113 | 0x01 0x00 | 2 | Duración del tiempo de espera de configuración |
| 115 | 0x64 | 1 | 10 segundos, en unidades de 100 milisegundos |
En esta segunda tabla se muestra el formato de la parte de emparejamiento de impresoras de red de la etiqueta.
| Offset | Contenido | Length | Explicación |
|---|---|---|---|
| 116 | 0x12 | 1 | Encabezado de registro NDEF: MB=0b,ME=0b, CF=0b, SR=1b, IL=0b,TNF=010b |
| 117 | 0x29 | 1 | Campo de longitud de tipo |
| 118 | 0x19 | 1 | Campo de longitud de carga |
| 119 | 0x61 0x70 0x70 0x6c 0x69 0x63 0x61 0x74 0x69 0x6f 0x6e 0x2f 0x76 0x6e 0x64 0x2e 0x6d 0x73 0x2d 0x77 0x69 0x6e 0x64 0x6f 0x77 0x73 0x2e 0x6e 0x77 0x70 0x72 0x69 0x6e 0x74 0x69 0x6e 0x67 0x2e 0x6f 0x6f 0x62 |
41 | Nombre del tipo de registro: "application/vnd.ms-windows.nwprinting.oob" |
| 160 | 0x5c 0x5c 0x70 0x72 0x69 0x6e 0x74 0x53 0x65 0x72 0x76 0x65 0x72 0x5c 0x70 0x72 0x69 0x6e 0x74 0x65 0x72 0x4e 0x61 0x6d 0x69 0x6e 0x74 0x65 0x65 |
25 | Nombre de la impresora: "\printServer\printerName" |
En esta tercera tabla se muestra el formato de la parte de emparejamiento MS-Device de la etiqueta.
| Offset | Contenido | Length | Explicación |
|---|---|---|---|
| 185 | 0x52 | 1 | Encabezado de registro NDEF: MB=0b, ME=1b, CF=0b, SR=1b, IL=0b,TNF=010b |
| 186 | 0x28 | 1 | Campo de longitud de tipo |
| 187 | 0x15 | 1 | Campo de longitud de carga |
| 188 | 0x61 0x70 0x70 0x6c 0x69 0x63 0x61 0x74 0x69 0x6f 0x6e 0x2f 0x76 0x6e 0x64 0x2e 0x6d 0x73 0x2d 0x77 0x69 0x6e 0x64 0x6f 0x77 0x73 0x2e 0x64 0x65 0x76 0x69 0x63 0x65 0x70 0x61 0x69 0x65 0x70 0x61 0x69 0x72 0x69 0x6E 0x67 |
40 | Nombre del tipo de registro: "application/vnd.ms-windows.devicepairing" |
| 228 | 0x00 0x01 0x00 0x00 |
4 | Versión: Principal = 1, Secundaria = 0 |
| 232 | 0x00 | 1 | Marcas: se establece en 0, pruebe todos los transportes. |
| 233 | 0x0F | 1 | Longitud del nombre descriptivo del dispositivo |
| 234 | 0x43 0x6f 0x6e 0x74 0x74 0x65 0x72 0x50 0x72 0x69 0x6e 0x6f 0x73 0x6f 0x20 |
15 | El nombre descriptivo del dispositivo que se muestra al usuario: "Contoso Printer" |
Wi-Fi requisitos de conectividad directa
Los dispositivos y clientes deben tener activada la radio Wi-Fi. Si no es así, se producirá un error en el emparejamiento.
Control de casos perimetrales
Si un usuario ha emparejado previamente un dispositivo, pero después quita manualmente el dispositivo de la lista de dispositivos, al pulsar de nuevo se producirá un intento de instalar o emparejar.
Si un usuario entra en el intervalo de actuación pero, de repente, deja antes de transferir la información fuera de banda (OOB), el dispositivo puede conectarse, pero el equipo no buscará el dispositivo. En este caso, no habrá ninguna interfaz de usuario de consentimiento del equipo y el usuario tendrá que pulsar de nuevo. Si el dispositivo ya se puede detectar cuando se vuelve a pulsar, debe permanecer reconocible y debe restablecer el período de tiempo de espera.
Para Wi-Fi dispositivos Direct, si la radio Wi-Fi desactiva, la instalación no se realizará correctamente.
Si un usuario pulsa dos dispositivos aproximadamente al mismo tiempo, solo se intentará el emparejamiento de la primera información OOB recibida.
Cualquier intento de pulsar el dispositivo en un sistema que ejecute un sistema operativo que no admita Pulsar para configurar o Pulsar para volver a conectar puede provocar que el dispositivo entre en modo conectable, pero el emparejamiento no tendrá lugar. Los usuarios tendrán que usar una interfaz de usuario de emparejamiento proporcionada para Bluetooth y usar el botón de emparejamiento para iniciar el emparejamiento.