Wi-Fi implémentation du jumelage direct

Cette section fournit des instructions de conception et des conditions requises pour qu’un périphérique participe aux cas d’usage Appuy et Configuration et Appuy et Reconnecter.

Notes

L’implémentation de jumelage décrite dans cette rubrique est actuellement prise en charge dans Windows 8.1, pour le couplage avec des périphériques d’imprimante uniquement.

Windows 10 et les versions ultérieures prennent en charge nfc pour Wi-Fi transfert de connexion statique direct via l’enregistrement de configuration de l’opérateur P2P Wi-Fi de l’alliance Wi-Fi. Pour plus d’informations, consultez Wi-Fi Alliance.

Appairage d’appareils direct Wi-Fi périphérique

Pendant l’appui, NFP reçoit des informations d’appairage à partir de l’appareil qui se connecte. NFP transmet les informations de jumelage à Windows. Wi-Fi appareils direct suivent la procédure de jumelage hors bande (OOB) de Wi-Fi Alliance et les recommandations du forum NFC. Windows s’appuie sur un message de jumelage propriétaire, comme défini ci-dessous.

Windows invite l’utilisateur à donner son consentement et, le cas échéant, Windows tente de se connecter à chacune des adresses, dans l’ordre, jusqu’à ce que l’une d’elles réussisse. Il n’y a plus d’interaction entre un fournisseur NFP dans le PC et l’appareil de connexion.

En utilisant NFC comme exemple, l’installation unidirectionnelle s’effectue en stockant les informations de couplage dans une balise NFC statique ou passive (une balise NFC active en mode d’émulation statique peut également être utilisée). Windows s’abonne à ces informations de jumelage. Un fournisseur NFP compatible NFC sur le PC reçoit les informations de connexion de la balise et les transmet à Windows en tant qu’abonné. À la réception des informations de connexion, Windows effectue l’installation réelle de l’appareil in-band à l’aide de techniques spécifiques à la classe d’appareil.

Exigences d’interopérabilité

Pour garantir l’interopérabilité entre les fournisseurs NFP, les informations de jumelage doivent être encapsulées dans un format de message spécifique au fournisseur.

Comme décrit ailleurs dans ce document, il n’existe aucune exigence spécifique pour les technologies de proximité autres que pour les fournisseurs NFP compatibles NFC.

Windows nécessite des fournisseurs NFP compatibles NFC pour prendre en charge un mécanisme spécifique défini par le forum NFC pour transmettre les informations de couplage OOB direct Wi-Fi pour le couplage unidirectionnel. Le message NDEF contient un premier enregistrement avec une valeur de champ TNF de 0x01 et un champ TYPE égal à « Hs », ainsi qu’un autre enregistrement de transporteur qui pointe vers un Wi-Fi Enregistrement de configuration de l’opérateur direct. Dans cette méthode, seule la CHARGE UTILE de l’enregistrement NDEF sera utilisée.

Appairage unidirectionnel à l’aide de NFC pour Wi-Fi Direct

Cette section fournit plus d’informations sur la façon dont NFC, Wi-Fi Direct et Windows fonctionnent ensemble pour prendre en charge le couplage sans fil unidirectionnel pour Wi-Fi appareils Direct tels que les imprimantes.

Références de fournisseur NFP

Wi-Fi Appairage direct s’effectue à l’aide d’un type de message select de transfert de connexion standardisée du forum NFC. Le graphique ci-dessous fournit une vue d’ensemble de la façon dont un message de sélection de transfert de connexion est appliqué pour Wi-Fi appairage d’appareils Direct, en particulier les enregistrements NDEF 3 et 4. Le message De sélection de transfert décrit un ou plusieurs enregistrements « ac » ou « Autre transporteur ». Ces enregistrements suivent l’enregistrement De sélection de transfert séquentiellement et ont chacun un type bien défini. Enfin, le message contient un enregistrement de jumelage d’appareils défini par Microsoft qui fournit à Windows des informations sur la façon de traiter l’opération de jumelage.

Wi-Fi message de jumelage direct d’appareils

Dans les exemples de cas d’usage qui suivent, les balises NFC de type 2 sont utilisées à titre d’exemple. S’il est nécessaire d’utiliser un autre type de balise NFC, le message NDEF doit être correctement encapsulé conformément à cette définition de balise.

Champ	Valeur	Description
TNF	0x02	Format du champ Type qui suit. Type de média tel que défini dans RFC 2046.
Type	'application/vnd.ms-windows.wfd.oob'	Nouvelle chaîne de type que nous définissons pour ce scénario.
Taille des données OOB	WORD	Jusqu’à 64 Ko de données OOB prises en charge.
Wi-Fi données OOB directes	<blob de taille indiquée par le champ précédent>	Wi-Fi données OOB directes, comme défini ci-dessous.

Wi-Fi format OOB direct

Le tableau suivant décrit le format des données OOB WiFi Direct. Les données unidirectionnelles OOB peuvent être transmises par n’importe quel appareil OOB P2P unidirectionnel.

Attributs	ID d’attribut	Obligatoire ou facultatif	Notes
En-tête OOB Consultez la table de format de l’attribut d’en-tête OOB.	N/A	Obligatoire	L’attribut OOB Header doit être présent dans l’objet blob de données OOB P2P et sa valeur De type OOB doit être définie sur « Données d’approvisionnement unidirectionnelles OOB ».
Informations sur l’appareil OOB Consultez la table de format des attributs d’informations sur l’appareil OOB.	1	Obligatoire	Cet attribut doit être présent. Il fournit des informations sur cet appareil P2P.
Informations d’approvisionnement OOB	2	Obligatoire	Cet attribut doit être présent. Il fournit des informations d’approvisionnement que cet appareil P2P s’attend à utiliser.
Délai d’expiration de la configuration OOB	5	Obligatoire	Cet attribut doit être présent. Il fournit des informations sur la durée pendant laquelle cet appareil P2P attend une réponse sur Wi-Fi Direct.

Format de l’attribut d’en-tête OOB

Nom du champ	Taille (octets)	Valeur	Description
Longueur totale des données	2	Variable	Longueur de l’objet blob de données OOB entier (en-tête compris).
Longueur	2	Variable	Longueur des champs suivants dans l’en-tête OOB.
Version	1	0x10	Valeur identifiant la version de cet enregistrement OOB P2P.
OOB Type	1	Variable	Valeur identifiant le type de transaction OOB. La valeur spécifique est définie dans la table Types de transactions OOB .
OUI	0 ou 3	Variable	OUI propre au fournisseur. Cette étape est facultative. Doit être présent uniquement lorsque le type OOB est spécifique au fournisseur.
OUI Type	0 ou 1	Variable	Type spécifique au fournisseur. Cette étape est facultative. Doit être présent uniquement lorsque le type OOB est spécifique au fournisseur.

Types de transactions OOB

Type OOB (Hex)	Description
0x00	Données de provisionnement unidirectionnelles OOB
0x01	Données de l’écouteur d’approvisionnement OOB
0x02	Données du connecteur d’approvisionnement OOB
0x03	OOB Reinvoke Data
0x04-0xDC	Réservé
0xDD	Spécifique au fournisseur
0xDE-0xFF	Réservé

Format d’attribut d’informations sur l’appareil OOB

Nom du champ	Taille (octets)	Valeur	Description
ID d’attribut	1	1	Identification du type d’attribut OOB P2P. La valeur spécifique est définie dans la table Attributs OOB P2P.
Longueur	2	Variable	Longueur des champs suivants dans l’attribut .
Adresse de l’appareil P2P	6	Comme défini dans spécification P2P.	Identificateur utilisé pour référencer de manière unique un appareil P2P.
Méthodes de configuration	2	Comme défini dans spécification P2P.	Méthodes WSC prises en charge par cet appareil. Note: L’ordre des octets dans le champ Méthodes de configuration doit être big-endian.
Type d’appareil principal	8	Comme défini dans spécification P2P.	Type d’appareil principal de l’appareil P2P. Contient uniquement la partie Données de l’attribut WSC Primary Device Type (à l’exclusion des champs ID d’attribut et Longueur). Note: L’ordre des octets dans le champ Type d’appareil principal doit être big-endian.
Bitmap de capacité d’appareil	1	Comme défini dans spécification P2P.	Ensemble de paramètres indiquant les fonctionnalités de l’appareil P2P.
Nom de l’appareil	Variable	Comme défini dans spécification P2P.	Nom convivial de l’appareil P2P. Contient l’intégralité du format TLV de l’attribut Nom de l’appareil WSC. Note: L’ordre des octets dans le champ Nom de l’appareil doit être big-endian.

Attributs OOB P2P

Type OOB (Hex)	Description
0x00	État OOB
0x01	Informations sur l’appareil OOB
0x02	Informations d’approvisionnement OOB
0x03	ID de groupe OOB
0x04	Canal d’écoute OOB
0x05	Délai d’expiration de la configuration OOB
0x06-0xDC	Réservé
0xDD	Attribut spécifique au fournisseur
0xDE-0xFF	Réservé

Format d’attribut d’informations d’approvisionnement OOB

Nom du champ	Taille (octets)	Valeur	Description
ID d’attribut	1	1	Identification du type d’attribut OOB P2P. La valeur spécifique est définie dans la table Attributs OOB P2P .
Longueur	2	Variable	Longueur des champs suivants dans l’attribut .
Bitmap des paramètres d’approvisionnement	1	Variable	Ensemble d’options de paramètres d’approvisionnement, tels que définis dans la table Paramètres d’approvisionnement .
Méthode de configuration sélectionnée	2	Comme défini dans spécification P2P.	Méthode WSC sélectionnée par cet appareil P2P pour l’approvisionnement.
Longueur de l’épingle	1	0 - 8	Nombre d’octets dans le champ données du code confidentiel suivant. Ce champ défini sur 0 n’indique aucune donnée de code confidentiel supplémentaire.
Épingler des données	Variable	n	Ce champ est facultatif. Ce champ est présent uniquement si le champ Longueur du code confidentiel n’est pas 0 et contient un tableau d’octets qui représente un code confidentiel à utiliser pour l’approvisionnement.

Paramètres d’approvisionnement

Bits	Information	Notes
0	Créer un groupe	Le bit Créer un nouveau groupe est défini sur 1 si ces informations d’approvisionnement sont destinées à former un nouveau groupe avec l’appareil P2P cible. Sinon, ces informations d’approvisionnement sont destinées à rejoindre un groupe existant.
1	Appliquer le paramètre de type de groupe	Le bit Appliquer le paramètre de type de groupe est défini sur 1 si le bit Type de groupe souhaité doit être appliqué, sinon, le bit Type de groupe souhaité est simplement une préférence.
2	Type de groupe souhaité	Le bit type de groupe souhaité doit être défini sur 0 si le type de groupe souhaité est temporaire, et doit être défini sur 1 si le type de groupe souhaité est persistant.
3 - 7	Réservé

Format de l’attribut de délai d’expiration de la configuration OOB

Nom du champ	Taille (octets)	Valeur	Description
ID d’attribut	1	5	Identification du type d’attribut OOB P2P. La valeur spécifique est définie dans la table Attributs OOB P2P .
Longueur	2	1	Longueur des champs suivants dans l’attribut .
Délai d’expiration de la configuration de l’écouteur	1	0 - 255	Durée d’attente de cet appareil P2P pour Wi-Fi communication directe après le transfert de données OOB, en unités de 100 millisecondes. (Maximum de 25,5 secondes).

Enregistrement de jumelage d’appareils Windows

L’enregistrement de jumelage d’appareils Windows suit la spécification NDEF. Il fournit des informations supplémentaires à Windows sur la façon de traiter le message de sélection de transfert de connexion. Les champs TNF et Type doivent être spécifiés conformément à la spécification NDEF. Les autres champs ci-dessous sont répertoriés séquentiellement dans le champ Charge utile de l’enregistrement NDEF.

Nom du champ	Valeur	Valeur de longueur	Description
TNF	0x02	3 bits	Format du champ Type qui suit. Type de média tel que défini dans RFC 2046.
Type	'application/vnd.ms-windows.devicepairing'	0x28 octets	Nouvelle chaîne de type que nous définissons pour ce scénario.
MajorVersion	0x1	2 octets	La version principale doit être 0x1.
MinorVersion	0x0	2 octets	La version mineure doit être 0x0.
Indicateurs	0x0 ou 0x01	4 octets	Définissez sur 0x0 pour essayer tous les transports. Définissez sur 0x1 de tenter l’installation de façon séquentielle et de s’arrêter après la première réussite. La préférence pour les transports est indiquée par la séquence d’enregistrements de transporteur alternatifs. Note Les valeurs 0x0002 via 0x0064 sont réservées.
Longueur du nom convivial de l’appareil	Longueur du champ nom convivial de l’appareil.	1 octet	Longueur du nom convivial de l’appareil.
Nom convivial de l'appareil	Chaîne encodée UTF-8 jusqu’à 255 octets.	Longueur du nom convivial de l’appareil	Nom convivial de l’appareil qui sera affiché dans l’interface utilisateur de consentement sur le client.

Wi-Fi Direct just works cérémonie, format de balise de transfert de connexion statique

Par exemple, voici une implémentation classique pour une balise passive NFC. Cela correspond à un cas de transfert de connexion statique avec un enregistrement de support direct Wi-Fi, une imprimante de partage réseau et l’enregistrement de couplage ms-device.

Ce premier tableau illustre le format de la partie Wi-Fi appairage direct de la balise.

Offset	Contenu	Longueur	Explication
0	0x91	1	En-tête d’enregistrement NDEF : MB=1b, ME=0b, CF=0b, SR=1b, IL=0b, TNF=001b
1	0x02	1	Longueur du type d’enregistrement : 2 octets
2	0x0A	1	Longueur du type d’enregistrement : 10 octets
3	0x48 0x73	2	Type d’enregistrement : « Hs »
5	0x12	1	Numéro de version : Majeur = 1, Mineur = 2
6	0xD1	1	En-tête d’enregistrement NDEF : MB=1b, ME=1b, CF=0b, SR=1b, IL=0b, TNF=001b
7	0x02	1	Longueur du type d’enregistrement : 2 octets
8	0x04	1	Longueur de la charge utile : 4 octets
9	0x61 0x63	2	Type d’enregistrement : « ac »
11	0x01	1	Indicateurs de l’opérateur : CPS=1, « active »
12	0x01	1	Longueur de référence des données de support : 1 octet
13	0x30	1	Référence des données de support : « 0 »
14	0x00	1	Nombre de références de données auxiliaires : 0
15	0x1A	1	En-tête d’enregistrement NDEF : MB=0b, ME=0b, CF=0b, SR=1b, IL=1b, TNF=010b
16	0x22	1	Longueur du nom du type d’enregistrement : 34 octets
17	0x3E	1	Longueur de la charge utile : 62 octets
18	0x01	1	Longueur de l’ID : 1 octet
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	Nom du type d’enregistrement : 'application/vnd.ms-windows.wfd.oob'
53	0x30	1	ID : « 0 »
54	0x3E 0x00	2	Wi-Fi longueur des données OOB directes : 62 octets. La longueur est lue sous la forme d’un court-métrage non signé et comprend l’ensemble de l’objet blob. Comprend 2 octets de longueur. Cette valeur doit être stockée dans un format little endian.
56	0x02, 0x00	2	Longueur de l’en-tête : 2 octets
58	0x10	1	Version : 0x10
59	0x00	1	Type OOB : 0x00 (unidirectionnel)
60	0x01	1	Attribut : 0x01 (Attribut d’informations sur l’appareil)
61	0x22 0x00	2	Longueur des informations sur l’appareil : 34 octets
63	0x01 0x23 0x34 0xab 0xcd 0xef	6	Wi-Fi adresse MAC de l’appareil Direct P2P : « 01 :23 :34 :ab :cd :ef »
69	0x01 0x00	2	Type de configuration
71	0x00 0x01 0x00 0x50 0xF2 0x00 0x00 0x00	8	Type d’appareil principal
79	0x12	1	Fonctionnalité
80	0x10 0x11	2	Attribut : Nom de l’appareil
82	0x00 0x0d	2	Longueur du nom de l’appareil : 13 octets
84	0x43 0x6f 0x6e 0x74 0x6f 0x73 0x6f 0x20 0x4d 0x6f 0x75 0x73 0x65	13	Nom convivial de l’appareil dans UTF-8. Notez qu’il n’existe aucun caractère de fin NULL et que UTF-8 peut contenir un ou deux octets par caractère. Cet exemple montre comment lire « Contoso Mouse »
97	0x02	1	Attribut : informations d’approvisionnement
98	0x0c 0x00	2	Longueur des informations d’approvisionnement : 12 octets
100	0x07	1	Définition de bitmap : nouveau groupe, application persistante
101	0x01 0x00	2	Méthode config : entrée de code pin
103	0x08	1	Longueur de la broche : 8 octets
104	0x05 0x06 0x07 0x08 0x01 0x02 0x03 0x04	8	Épingle : « 12345678 »
112	0x05	1	Attribut : informations sur le délai d’expiration de la configuration
113	0x01 0x00	2	Durée du délai d’expiration de la configuration
115	0x64	1	10 secondes, en unités de 100 millisecondes

Ce deuxième tableau illustre le format de la partie de jumelage d’imprimantes réseau de la balise.

Offset	Contenu	Longueur	Explication
116	0x12	1	En-tête d’enregistrement NDEF : MB=0b,ME=0b, CF=0b, SR=1b, IL=0b,TNF=010b
117	0x29	1	Champ de longueur de type
118	0x19	1	Champ longueur de charge utile
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 0x73 0x2e 0x6e 0x77 0x70 0x72 0x69 0x6e 0x74 0x69 0x6e 0x67 0x2e 0x6f 0x6f 0x62	41	Nom du type d’enregistrement : « 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 0x65	25	Nom de l’imprimante : « \printServer\printerName »

Ce troisième tableau illustre le format de la partie de jumelage MS-Device de la balise.

Offset	Contenu	Longueur	Explication
185	0x52	1	En-tête d’enregistrement NDEF : MB=0b, ME=1b, CF=0b, SR=1b, IL=0b,TNF=010b
186.	0x28	1	Champ De longueur de type
187	0x15	1	Champ Longueur de charge utile
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 0x72 0x69 0x6E 0x67	40	Nom du type d’enregistrement : « application/vnd.ms-windows.devicepairing »
228	0x00 0x00 0x01 0x00	4	Version : Majeure = 1, Mineure = 0
232	0x00	1	Indicateurs : défini sur 0, essayez tous les transports
233	0x0F	1	Longueur du nom convivial de l’appareil
234	0x43 0x6f 0x6e 0x74 0x74 0x65 0x72 0x50 0x72 0x69 0x6e 0x43 0x6f 0x6e 0x74 0x6f 0x73 0x6f 0x20	15	Nom convivial de l’appareil affiché à l’utilisateur : « Contoso Printer »

Wi-Fi Exigences de connectivité directe

La Wi-Fi radio doit être activée sur les appareils et les clients. Si ce n’est pas le cas, le jumelage échoue.

Gestion des cas de périphérie

Si un utilisateur a déjà appairé un appareil, mais supprime ensuite manuellement l’appareil de la liste des appareils, appuyez de nouveau sur une tentative d’installation ou de jumelage.

Si un utilisateur entre dans la plage d’actionnement, puis s’en va soudainement avant que les informations hors bande (OOB) ne soient transférées, l’appareil peut devenir connectable, mais le PC ne recherche pas l’appareil. Dans ce cas, il n’y aura pas d’interface utilisateur de consentement à partir du PC et l’utilisateur devra appuyer à nouveau. Si l’appareil est déjà détectable lorsqu’il est à nouveau appuyé, il doit rester détectable et doit réinitialiser le délai d’expiration.

Pour Wi-Fi appareils direct, si la radio Wi-Fi s’éteint, l’installation ne réussit pas.

Si un utilisateur appuie sur deux appareils à peu près en même temps, seul le jumelage des premières informations OOB reçues est tenté.

Toute tentative d’appui sur l’appareil sur un système exécutant un système d’exploitation qui ne prend pas en charge l’appui sur l’installation ou l’appui pour se reconnecter peut entraîner la mise en mode connectable de l’appareil, mais le jumelage n’aura pas lieu. Les utilisateurs devront utiliser une interface utilisateur de jumelage fournie pour Bluetooth et utiliser le bouton de jumelage pour lancer le jumelage.

Rubriques connexes

• Informations de référence sur l’interface de pilote de périphérique (DDI) NFC