Exécuter des tests Bluetooth Low Energy

Pour configurer votre Raspberry Pi afin d'exécuter les tests BLE

1. Téléchargez l'une des images Yocto personnalisées contenant le logiciel requis pour effectuer les tests.

   • Image pour Raspberry Pi 4B

   • Image pour Raspberry Pi 3B+

   Note

   L'image Yocto ne doit être utilisée qu'à des fins de test avec AWS IoT Device Tester FreeRTOS et à aucune autre fin.

2. Flashez l'image yocto sur la carte SD pour Raspberry Pi.

   1. En utilisant un outil d'écriture sur carte SD comme Etcher, flashez le fichier image-name.rpi-sd.img téléchargé sur la carte SD. Comme l'image du système d'exploitation est volumineuse, cette étape peut prendre un peu de temps. Éjectez ensuite votre carte SD de votre ordinateur et insérez la carte microSD dans votre Raspberry Pi.

3. Configurez votre Raspberry Pi.

   1. Pour le premier démarrage, nous vous recommandons de connecter le Raspberry Pi à un moniteur, un clavier et une souris.

   2. Connectez votre Raspberry Pi à une source d'alimentation micro USB.

   3. Connectez-vous à l'aide des informations d'identification par défaut. Pour l’ID utilisateur, saisissez root. Pour le mot de passe, saisissez idtafr.

   4. En utilisant une connexion Wi-Fi ou Ethernet, connectez le Raspberry Pi à votre réseau.

      1. Pour connecter votre Raspberry Pi par Wi-Fi, ouvrez /etc/wpa_supplicant.conf sur le Raspberry Pi et ajoutez vos informations d'identification Wi-Fi à la configuration Network.

         ctrl_interface=/var/run/wpa_supplicant
         ctrl_interface_group=0
         update_config=1
         
         network={
                 scan_ssid=1
                 ssid="your-wifi-ssid"
                 psk="your-wifi-password"
                 }

      2. Exécutez ifup wlan0 pour démarrer la connexion Wi-Fi. La connexion à votre réseau Wi-Fi peut prendre une minute.

   5. Pour une connexion Ethernet, exécutez ifconfig eth0. Pour une connexion Wi-Fi, exécutez ifconfig wlan0. Prenez note de l'adresse IP qui apparaît sous la forme inet addr dans la sortie de commande. Vous aurez besoin de l'adresse IP ultérieurement dans cette procédure.

   6. (Facultatif) Les tests exécutent les commandes sur le Raspberry Pi via SSH à l'aide des informations d'identification par défaut pour l’image yocto. Pour plus de sécurité, nous vous recommandons de configurer l'authentification par clé publique pour SSH et de désactiver SSH basé sur un mot de passe.

      1. Créez une clé SSH à l'aide de la commande OpenSSLssh-keygen. Si vous avez déjà une paire de clés SSK sur votre ordinateur hôte, il est recommandé d'en créer une nouvelle AWS IoT Device Tester pour permettre à FreeRTOS de se connecter à votre Raspberry Pi.

         Note

         Windows n'est fourni avec une installation de client SSH. Pour plus d'informations sur la façon d'installer un client SSH sur Windows, consultez la section Download SSH Software.

      2. La commande ssh-keygen vous invite à indiquer un nom et un chemin d'accès pour stocker la paire de clés. Par défaut, les fichiers de la paire de clés sont nommés id_rsa (clé privée) et id_rsa.pub (clé publique). Sur Mac OS et Linux, l'emplacement par défaut de ces fichiers est ~/.ssh/. Sur Windows, l'emplacement par défaut est C:\Users\user-name.

      3. Lorsque vous êtes invité à saisir une expression clé, appuyez sur Entrée pour continuer.

      4. Pour ajouter votre clé SSH sur votre Raspberry Pi afin que AWS IoT Device Tester FreeRTOS puisse se connecter à l'appareil, utilisez ssh-copy-id la commande de votre ordinateur hôte. Cette commande ajoute votre clé publique au fichier ~/.ssh/authorized_keys sur votre Raspberry Pi.

         ssh-copy-id root@raspberry-pi-ip-address

      5. Lorsque vous êtes invité à saisir un mot de passe, saisissez idtafr. Il s'agit du mot de passe par défaut de l’image yocto.

         Note

         La commande ssh-copy-id suppose que la clé publique est nommée id_rsa.pub. Sur macOS et Linux, l'emplacement par défaut est ~/.ssh/. Sur Windows, l'emplacement par défaut est C:\Users\user-name\.ssh. Si vous avez donné à la clé publique un autre nom ou si vous l'avez stockée à un autre emplacement, vous devez spécifier le chemin d'accès qualifié complet de votre clé publique SSH à l'aide de l'option -i pour ssh-copy-id (par exemple, ssh-copy-id -i ~/my/path/myKey.pub). Pour plus d'informations sur la création de clés SSH et la copie des clés publiques, consultez SSH-COPY-ID.

      6. Pour vérifier que l'authentification par clé publique fonctionne, exécutez ssh -i /my/path/myKey root@raspberry-pi-device-ip.

         Si vous n'êtes pas invité à saisir un mot de passe, votre authentification par clé publique fonctionne.

      7. Vérifiez que vous pouvez vous connecter à votre Raspberry Pi à l'aide d'une clé publique, puis désactivez SSH basé sur un mot de passe.

         1. Sur le Raspberry Pi, modifiez le fichier /etc/ssh/sshd_config.

         2. Définissez l'attribut PasswordAuthentication sur no.

         3. Enregistrez et fermez le fichier sshd_config.

         4. Rechargez le serveur SSH en exécutant /etc/init.d/sshd reload.

   7. Créez un fichier resource.json.

      1. Dans le répertoire dans lequel vous avez extrait AWS IoT Device Tester, créez un fichier nomméresource.json.

      2. Ajoutez les informations suivantes concernant votre Raspberry Pi au fichier, en les rasp-pi-ip-address remplaçant par l'adresse IP de votre Raspberry Pi.

         [
             {
                 "id": "ble-test-raspberry-pi",
                 "features": [
                     {"name":"ble", "version":"4.2"}
                 ],
                 "devices": [
                     {
                         "id": "ble-test-raspberry-pi-1",
                         "connectivity": {
                             "protocol": "ssh",
                             "ip": "rasp-pi-ip-address"
                         }
                     }
                 ]
             }
         ]

      3. Si vous n'avez pas choisi d'utiliser l'authentification par clé publique pour SSH, ajoutez ce qui suit à la connectivity section du resource.json fichier.

         "connectivity": {
             "protocol": "ssh",
             "ip": "rasp-pi-ip-address",
             "auth": {
                 "method": "password",
                 "credentials": {
                     "user": "root",
                     "password": "idtafr"
                 }
             }
         }

      4. (Facultatif) Si vous avez choisi d'utiliser l’authentification par clé publique pour SSH, ajoutez les éléments suivants à la section connectivity du fichier resource.json.

         "connectivity": {
             "protocol": "ssh",
             "ip": "rasp-pi-ip-address",
             "auth": {
                 "method": "pki",
                 "credentials": {
                     "user": "root",
                     "privKeyPath": "location-of-private-key"
                 }
             }
         }