Compilation et test rapide

Assurez-vous que votre environnement matériel SDR (pilote/lib) a été correctement configuré avant d'exécuter ce projet.

La commande ci-dessus renifle sur le canal 37. Vous devriez voir de nombreux paquets à l'écran si vous avez des appareils BLE (téléphone/tablette/ordinateur portable) à proximité.

La commande ci-dessus transmet des paquets de découverte sur le canal ADV. Vous devriez voir un appareil nommé « SDR/Bluetooth/Low/Energy » dans une autre application de reniflage BLE (comme LightBlue).

Pour obtenir une séquence d'opérations plus rapide sur HACKRF, utilisez ce qui suit :

dans hackrf/host/libhackrf/src/hackrf.c. Recompilez ensuite la bibliothèque HACKRF et réinstallez-la. N'oubliez pas de recompiler BTLE pour prendre en compte la modification de la bibliothèque HACKRF.

Outre les outils, le répertoire matlab contient l'évaluation d'algorithmes et d'autres scripts utiles

Utilisation de btle_rx

Affiche tous les arguments/utilisations.

Numéro de canal. Valeur par défaut 37 (un des canaux ADV). Valeur valide 0~39 (tous les canaux ADV et DATA).

Gain de réception en dB. HACKRF rxvga par défaut 6, valide 0 - 62. bladeRF par défaut gain rx max 66 dB (valide 0 - 66). Le gain doit être réglé très soigneusement pour garantir les meilleures performances dans votre situation. Il est suggéré de tester à partir d'un gain faible, car un gain élevé provoque toujours une forte distorsion et ne vous apporte rien.

Gain LNA en dB (HackRF uniquement). Défaut 32, valide 0 - 40. Le gain doit être réglé très soigneusement pour garantir les meilleures performances dans votre situation.

Activer l'amplificateur (HackRF uniquement). Désactivé par défaut.

Adresse d'accès. Par défaut 8e89bed6 pour les canaux ADV 37 38 39. Vous devez spécifier la valeur correcte pour le canal de données selon la procédure de configuration de connexion capturée.

Par défaut 555555 pour le canal ADV. Vous devez spécifier la valeur correcte pour le canal de données selon la procédure de configuration de connexion capturée.

Mode verbeux. Affiche plus d'informations en cas d'erreur.

Mode brut. Après la détection de l'adresse d'accès, affiche les 42 octets bruts suivants (sans désembrouillage ni analyse).

Cette fréquence (Hz) remplacera le réglage du canal (au cas où l'on souhaite travailler sur une fréquence autre que BTLE. Plus polyvalent).

Si un bit est à 1 dans ce masque, le bit correspondant de l'adresse d'accès sera pris en compte dans la décision de présence de paquet (au cas où l'on souhaite un mot unique plus court/plus clairsemé pour la détection de paquets. Plus polyvalent).

Ceci active le suivi du canal de données (saut de fréquence) après que les informations de configuration de liaison ont été capturées dans le paquet ADV_CONNECT_REQ sur le canal ADV.

Enregistre les paquets dans un fichier pcap.

Utilisation de btle_tx

ou

packets.txt est un fichier texte qui contient les paramètres de ligne de commande (packet1 packet2 ... rN). Un paramètre par ligne. Une ligne commençant par « # » est considérée comme un commentaire. Voir l'exemple packets.txt.

est une chaîne qui décrit un paquet. Tous les paquets composent une séquence de paquets.

signifie que la séquence sera répétée N fois. S'il n'est pas spécifié, la séquence ne sera envoyée qu'une seule fois.

Format de la chaîne packetX

Chaque chaîne descripteur commence par le numéro de canal BTLE (0~39), puis est suivie par le type de paquet (RAW/iBeacon/ADV_IND/ADV_DIRECT_IND/etc. Voir tous les exemples de formats À LA FIN : Annexe ), puis par une paire champ-valeur spécifique au type de paquet, et enfin par une paire Space-valeur (optionnelle) où la valeur indique combien de millisecondes seront attendues après l'envoi de ce paquet.

N'UTILISEZ PAS le caractère espace « » dans un descripteur de paquet en ligne de commande. Vous POUVEZ utiliser l'espace dans le descripteur de paquet du fichier txt.

N'UTILISEZ PAS « - » à l'intérieur de chaque champ. « - » est un caractère magique utilisé pour séparer les différents champs dans le descripteur de paquet.

• Exemple btle_tx : Paquets de découverte

Ouvrez l'application LightBlue (ou un autre renifleur BLE) sur votre iPhone/appareil avant cette commande :

Vous verrez un appareil nommé « SDR Bluetooth Low Energy » dans votre application LightBlue.

Ligne de commande correspondante :

Remarque : le caractère espace « » est remplacé par « / » car l'espace n'est pas pris en charge en ligne de commande.

• Exemple btle_tx : Établissement de connexion

Ce qui précède simule une procédure d'établissement de connexion entre le dispositif 1 et le dispositif 2. Fichier descripteur correspondant BTLE/host/btle-tools/src/packets.txt.

Le 1er paquet -- le dispositif 1 envoie un paquet ADV_IND sur le canal 37.

Le 2e paquet -- après que le dispositif 2 (en état de scan) a reçu le paquet ADV du dispositif 1, le dispositif 2 envoie un paquet CONNECT_REQ pour demander l'établissement de la connexion avec le dispositif 1. Dans ce paquet de demande, il y a l'adresse MAC du dispositif 2 (InitA), l'adresse MAC cible (adresse MAC du dispositif 1, AdvA), l'adresse d'accès (AA) qui sera utilisée par le dispositif 1 lors des envois de paquets suivants sur le canal de données, la valeur d'initialisation CRC pour les paquets suivants du dispositif 1, les informations de saut de canal (ChM et Hop) pour le canal de données utilisé par le dispositif 1, etc.

Le 3e paquet -- le dispositif 1 envoie une PDU de données de couche liaison vide sur le canal 9 (déterminé par le schéma de saut) conformément aux informations de demande de connexion reçues du dispositif 2. (« XX » après le champ « DATA » signifie qu'il n'y a pas de données pour ce champ.)

L'espace temporel entre les paquets est de 1 s (1000 ms). Réglez le renifleur de paquets de TI sur le canal 37, puis la procédure d'établissement ci-dessus sera capturée.

• Exemple btle_tx : iBeacon

La commande ci-dessus envoie un paquet iBeacon et le répète 100 fois avec un espace temporel de 100 ms. Fichier descripteur correspondant BTLE/host/btle-tools/src/packets_ibeacon.txt. Vous pouvez utiliser une clé renifleur BLE pour voir le paquet.

La chaîne descripteur du paquet :

canal 37 (un des canaux de publicité BTLE 37 38 39)

mot-clé de format de paquet qui signifie format iBeacon. (En réalité, il s'agit du format ADV_IND dans Core_V4.0.pdf)

adresse de publicité (adresse MAC) définie comme 010203040506 (voir Core_V4.0.pdf)

nous la spécifions ici comme UUID fixe d'Estimote : B9407F30F5F8466EAFF925556B57FE6D

numéro majeur du format iBeacon. (Ici, il est 0008)

numéro mineur du format iBeacon. (Ici, il est 0009)

paramètre de puissance d'émission du format iBeacon (ici, il est C5)

combien de millisecondes seront attendues après l'envoi de ce paquet. (Ici, c'est 100 ms)

Démos

Voir une comparaison avec le renifleur de paquets de TI ici : http://sdr-x.github.io/BTLE-SNIFFER/

Voir la démo vidéo btle_rx ou la démo vidéo btle_rx (en Chine) et la démo vidéo 1 btle_tx ou la démo vidéo 2 btle_tx (en Chine)

Annexe : Exemples de descripteurs de paquets de btle_tx pour tous les formats

Paquets RAW : (tous les bits seront envoyés directement au modulateur GFSK)

Paquets des canaux de publicité (canal 37 par exemple) :

Paquets des canaux de données (canal 9 par exemple) :

Paquets de découverte : (qui peuvent afficher n'importe quel nom ou service dans une application de scan, comme LightBlue) :

FLAGS : 0x01 mode découvrable limité LE ; 0x02 mode découvrable général LE SERVICE : 0x02 UUID de service 16 bits, d'autres UUID 16 bits disponibles 0x03 UUID de service 16 bits, liste complète des UUID 16 bits disponibles 0x04 UUID de service 32 bits, d'autres UUID 3a2 bits disponibles 0x05 UUID de service 32 bits, liste complète des UUID 32 bits disponibles 0x06 UUID de service 128 bits, d'autres UUID 128 bits disponibles 0x07 UUID de service 128 bits, liste complète des UUID 128 bits disponibles