Executar testes de Bluetooth Low Energy

Para configurar o Raspberry Pi para executar testes de BLE

1. Baixe uma das imagens Yocto personalizadas que contenham o software necessário para executar os testes.

   • Imagem para Raspberry Pi 4B

   • Imagem para Raspberry Pi 3B+

   nota

   A imagem do Yocto só deve ser usada para testes com AWS IoT Device Tester FreeRTOS e não para qualquer outra finalidade.

2. Atualize a imagem yocto no cartão SD do Raspberry Pi.

   1. Usando uma ferramenta de gravação de cartão SD, como Etcher, instale o arquivo image-name.rpi-sd.img obtido por download no cartão SD. Como a imagem do sistema operacional é grande, essa etapa deve levar algum tempo. Depois ejete seu cartão SD do computador e insira o cartão microSD no seu Raspberry Pi.

3. Configure seu Raspberry Pi.

   1. Durante a primeira inicialização, recomendamos que você conecte o Raspberry Pi a um monitor, teclado e mouse.

   2. Conecte seu Raspberry Pi a uma fonte de alimentação micro USB.

   3. Faça login usando as credenciais padrão. Para ID de usuário, insira root. Para senha, insira idtafr.

   4. Usando uma conexão Wi-Fi ou Ethernet, conecte o Raspberry Pi à sua rede.

      1. Para conectar seu Raspberry Pi por Wi-Fi, abra /etc/wpa_supplicant.conf no Raspberry Pi e adicione suas credenciais Wi-Fi à configuração de 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. Execute ifup wlan0 para iniciar a conexão Wi-Fi. Pode levar alguns minutos para se conectar à sua rede Wi-Fi.

   5. Para uma conexão Ethernet, execute ifconfig eth0. Para uma conexão Wi-Fi, execute ifconfig wlan0. Anote o endereço IP, que aparece como inet addr na saída do comando. Você precisa do endereço IP posteriormente neste procedimento.

   6. (Opcional) Os testes executam comandos no Raspberry Pi sobre SSH usando as credenciais padrão para a imagem yocto. Para segurança adicional, recomendamos que você configure a autenticação de chave pública para SSH e desative o SSH baseado em senha.

      1. Crie uma chave SSH usando o comando OpenSSL ssh-keygen. Se você já tem um par de chaves SSK no seu computador host, é uma prática recomendada criar um novo AWS IoT Device Tester para permitir que os FreeRTOS façam login no seu Raspberry Pi.

         nota

         O Windows não vem com um cliente SSH instalado. Para obter informações sobre como instalar um cliente SSH no Windows, consulte Como fazer download do software SSH.

      2. O comando ssh-keygen solicita que você informe um nome e caminho para armazenar o par de chaves. Por padrão, os arquivos de pares de chaves são nomeados como id_rsa (chave privada) e id_rsa.pub (chave pública). No macOS e no Linux, o local padrão desses arquivos é ~/.ssh/. No Windows, o local padrão é C:\Users\user-name.

      3. Quando uma frase-chave for solicitada, bastará pressionar ENTER para continuar.

      4. Para adicionar sua chave SSH ao Raspberry Pi para que os AWS IoT Device Tester FreeRTOS possam entrar no dispositivo, use o comando do seu computador host. ssh-copy-id Esse comando adiciona sua chave pública ao arquivo ~/.ssh/authorized_keys no seu Raspberry Pi.

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

      5. Quando solicitado a inserir uma senha, digite idtafr. Essa é a senha padrão para a imagem yocto.

         nota

         O comando ssh-copy-id pressupõe que a chave pública é chamada id_rsa.pub. No macOS e Linux, o local padrão é ~/.ssh/. No Windows, o local padrão é C:\Users\user-name\.ssh. Se você atribuiu à chave pública um nome diferente ou armazenou em um local diferente, você deve especificar o caminho para sua chave pública SSH usando a opção -i para ssh-copy-id (por exemplo, ssh-copy-id -i ~/my/path/myKey.pub). Para obter mais informações sobre a criação de chaves SSH e a cópia de chaves públicas, consulte SSH-COPY-ID.

      6. Para testar se a autenticação da chave pública está funcionando, execute ssh -i /my/path/myKey root@raspberry-pi-device-ip.

         Se você não receber uma solicitação de senha, a autenticação de chave pública está funcionando.

      7. Verifique se é possível fazer login no seu Raspberry Pi usando uma chave pública e, depois, desative o SSH baseado em senha.

         1. No Raspberry Pi, edite o arquivo /etc/ssh/sshd_config.

         2. Defina o recurso PasswordAuthentication como no.

         3. Salve e feche o arquivo sshd_config.

         4. Recarregue o servidor SSH executando /etc/init.d/sshd reload.

   7. Crie um arquivo resource.json.

      1. No diretório em que você extraiu o AWS IoT Device Tester, crie um arquivo chamado. resource.json

      2. Adicione as seguintes informações sobre seu Raspberry Pi ao arquivo, rasp-pi-ip-address substituindo-as pelo endereço IP do seu 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. Se você decidir não usar a autenticação de chave pública para SSH, adicione o seguinte à seção connectivity do arquivo resource.json.

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

      4. (Opcional) Se você decidir usar a autenticação de chave pública para SSH, adicione o seguinte à seção connectivity do arquivo resource.json.

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