As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Testar a comunicação entre os dispositivos cliente Os dispositivos cliente podem usar o AWS IoT Device SDK para descobrir, conectar e se comunicar com um dispositivo principal. Você pode usar o cliente de descoberta do Greengrass no AWS IoT Device SDK para usar a [API de descoberta do Greengrass](greengrass-discover-api.md), que retorna informações sobre os dispositivos principais aos quais um dispositivo cliente pode se conectar. A resposta da API inclui os endpoints do agente MQTT para conexão e os certificados que devem ser usados para verificar a identidade de cada dispositivo principal. Depois disso, o dispositivo cliente poderá testar cada endpoint até se conectar com êxito a um dispositivo principal. Os dispositivos cliente podem descobrir somente os dispositivos principais aos quais você os associa. Antes de testar as comunicações entre um dispositivo cliente e um dispositivo principal, você deve associar um ao outro. Para obter mais informações, consulte [Associar dispositivos cliente](associate-client-devices.md). A API de descoberta do Greengrass retorna os endpoints do agente MQTT do dispositivo principal que você especifica. É possível usar o [componente detector de IP](ip-detector-component.md) para gerenciar esses endpoints para você ou gerenciá-los manualmente para cada dispositivo núcleo. Para obter mais informações, consulte [Gerenciar endpoints do dispositivo principal do](manage-core-device-endpoints.md). **nota** Para usar a API de descoberta do Greengrass, um dispositivo cliente deve ter a permissão `greengrass:Discover`. Para obter mais informações, consulte [AWS IoT Política mínima para dispositivos clientes](device-auth.md#client-device-minimal-iot-policy). O AWS IoT Device SDK está disponível em várias linguagens de programação. Para obter mais informações, consulte [AWS IoT Dispositivo SDKs](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sdks.html) no *Guia do AWS IoT Core desenvolvedor*. **Topics** + [Testar a comunicação (Python)](#test-client-device-communications-python) + [Testar a comunicação (C\$1\$1)](#test-client-device-communications-cpp) + [Comunicações de teste (JavaScript)](#test-client-device-communications-javascript) + [Testar a comunicação (Java)](#test-client-device-communications-java) ## Testar a comunicação (Python) Nesta seção, você usa a amostra de descoberta do Greengrass no [AWS IoT Device SDK v2 para Python](https://github.com/aws/aws-iot-device-sdk-python-v2) para testar a comunicação entre um dispositivo cliente e um dispositivo principal. **Importante** Para usar a AWS IoT Device SDK v2 para Python, um dispositivo deve executar o Python 3.6 ou posterior. **Para testar as comunicações (AWS IoT Device SDK v2 para Python)** 1. Baixe e instale a [AWS IoT Device SDK v2 para Python](https://github.com/aws/aws-iot-device-sdk-python-v2) AWS IoT na coisa para se conectar como um dispositivo cliente. No dispositivo cliente, faça o seguinte: 1. Clone o repositório AWS IoT Device SDK v2 for Python para baixá-lo. ``` git clone https://github.com/aws/aws-iot-device-sdk-python-v2.git ``` 1. Instale a AWS IoT Device SDK v2 para Python. ``` python3 -m pip install --user ./aws-iot-device-sdk-python-v2 ``` 1. Mude para a pasta de amostras na AWS IoT Device SDK v2 para Python. ``` cd aws-iot-device-sdk-python-v2/samples/greengrass ``` 1. Execute a aplicação de amostra de descoberta do Greengrass. Essa aplicação espera argumentos que especifiquem o nome do item do dispositivo cliente, o tópico e a mensagem MQTT que serão usados e os certificados que autenticam e protegem a conexão. O exemplo a seguir envia a mensagem “Hello World\$1” para o tópico `clients/MyClientDevice1/hello/world`. + *MyClientDevice1*Substitua pelo nome do item do dispositivo cliente. + *\$1/certs/AmazonRootCA1.pem*Substitua pelo caminho para o certificado CA raiz da Amazon no dispositivo cliente. + *\$1/certs/device.pem.crt*Substitua pelo caminho para o certificado do dispositivo no dispositivo cliente. + *\$1/certs/private.pem.key*Substitua pelo caminho para o arquivo de chave privada no dispositivo cliente. + *us-east-1*Substitua pela AWS região em que seu dispositivo cliente e dispositivo principal operam. ``` python3 basic_discovery.py \\ --thing_name MyClientDevice1 \\ --topic 'clients/MyClientDevice1/hello/world' \\ --message 'Hello World!' \\ --ca_file ~/certs/AmazonRootCA1.pem \\ --cert ~/certs/device.pem.crt \\ --key ~/certs/private.pem.key \\ --region us-east-1 \\ --verbosity Warn ``` A aplicação de amostra de descoberta envia a mensagem dez vezes e se desconecta. Ela também assina o mesmo tópico em que publica as mensagens. Se a saída indicar que a aplicação recebeu mensagens MQTT no tópico, o dispositivo cliente poderá se comunicar com êxito com o dispositivo principal. ``` Performing greengrass discovery... awsiot.greengrass_discovery.DiscoverResponse(gg_groups=[awsiot.greengrass_discovery.GGGroup(gg_group_id='greengrassV2-coreDevice-MyGreengrassCore', cores=[awsiot.greengrass_discovery.GGCore(thing_arn='arn:aws:iot:us-east-1:123456789012:thing/MyGreengrassCore', connectivity=[awsiot.greengrass_discovery.ConnectivityInfo(id='203.0.113.0', host_address='203.0.113.0', metadata='', port=8883)])], certificate_authorities=['-----BEGIN CERTIFICATE-----\ MIICiT...EXAMPLE=\ -----END CERTIFICATE-----\ '])]) Trying core arn:aws:iot:us-east-1:123456789012:thing/MyGreengrassCore at host 203.0.113.0 port 8883 Connected! Published topic clients/MyClientDevice1/hello/world: {"message": "Hello World!", "sequence": 0} Publish received on topic clients/MyClientDevice1/hello/world b'{"message": "Hello World!", "sequence": 0}' Published topic clients/MyClientDevice1/hello/world: {"message": "Hello World!", "sequence": 1} Publish received on topic clients/MyClientDevice1/hello/world b'{"message": "Hello World!", "sequence": 1}' ... Published topic clients/MyClientDevice1/hello/world: {"message": "Hello World!", "sequence": 9} Publish received on topic clients/MyClientDevice1/hello/world b'{"message": "Hello World!", "sequence": 9}' ``` Em vez disso, se a aplicação gerar um erro, consulte [Solução de problemas de descoberta do Greengrass](troubleshooting-client-devices.md#greengrass-discovery-issues). Também é possível ver os logs do Greengrass no dispositivo principal para verificar se o dispositivo cliente se conecta e envia mensagens com êxito. Para obter mais informações, consulte [Monitore AWS IoT Greengrass logs](monitor-logs.md). ## Testar a comunicação (C\$1\$1) Nesta seção, você usa a amostra de descoberta do Greengrass no [AWS IoT Device SDK v2 para C\$1\$1](https://github.com/aws/aws-iot-device-sdk-cpp-v2) para testar a comunicação entre um dispositivo cliente e um dispositivo principal. Para criar a AWS IoT Device SDK v2 para C\$1\$1, um dispositivo deve ter as seguintes ferramentas: + C\$1\$1 11 ou posterior + CMake 3.1 ou posterior + Um dos seguintes compiladores: + GCC 4.8 ou posterior + Clang 3.9 ou posterior + MSVC 2015 ou posterior **Para testar as comunicações (AWS IoT Device SDK v2 para C\$1\$1)** 1. Baixe e crie a [AWS IoT Device SDK versão 2 para C\$1\$1](https://github.com/aws/aws-iot-device-sdk-cpp-v2) para AWS IoT conectar como um dispositivo cliente. No dispositivo cliente, faça o seguinte: 1. Crie uma pasta para o espaço de trabalho AWS IoT Device SDK v2 for C\$1\$1 e altere para ela. ``` cd mkdir iot-device-sdk-cpp cd iot-device-sdk-cpp ``` 1. Clone o repositório AWS IoT Device SDK v2 para C\$1\$1 para baixá-lo. O sinalizador `--recursive` especifica para fazer download dos submódulos. ``` git clone --recursive https://github.com/aws/aws-iot-device-sdk-cpp-v2.git ``` 1. Crie uma pasta para a saída de compilação AWS IoT Device SDK v2 for C\$1\$1 e altere-a para ela. ``` mkdir aws-iot-device-sdk-cpp-v2-build cd aws-iot-device-sdk-cpp-v2-build ``` 1. Crie a AWS IoT Device SDK v2 para C\$1\$1. ``` cmake -DCMAKE_INSTALL_PREFIX="~/iot-device-sdk-cpp" -DCMAKE_BUILD_TYPE="Release" ../aws-iot-device-sdk-cpp-v2 cmake --build . --target install ``` 1. Crie o aplicativo de amostra Greengrass discovery na AWS IoT Device SDK v2 para C\$1\$1. Faça o seguinte: 1. Mude para a pasta de amostra do Greengrass discovery na AWS IoT Device SDK v2 para C\$1\$1. ``` cd ../aws-iot-device-sdk-cpp-v2/samples/greengrass/basic_discovery ``` 1. Crie uma pasta para a saída da compilação de amostra de descoberta do Greengrass e mude para ela. ``` mkdir build cd build ``` 1. Crie a aplicação de amostra de descoberta do Greengrass. ``` cmake -DCMAKE_PREFIX_PATH="~/iot-device-sdk-cpp" -DCMAKE_BUILD_TYPE="Release" .. cmake --build . --config "Release" ``` 1. Execute a aplicação de amostra de descoberta do Greengrass. Essa aplicação espera argumentos que especifiquem o nome do item do dispositivo cliente, o tópico MQTT que será usado e os certificados que autenticam e protegem a conexão. No exemplo a seguir, é feita a assinatura no tópico `clients/MyClientDevice1/hello/world` e a publicação de uma mensagem que você digita na linha de comando para o mesmo tópico. + *MyClientDevice1*Substitua pelo nome do item do dispositivo cliente. + *\$1/certs/AmazonRootCA1.pem*Substitua pelo caminho para o certificado CA raiz da Amazon no dispositivo cliente. + *\$1/certs/device.pem.crt*Substitua pelo caminho para o certificado do dispositivo no dispositivo cliente. + *\$1/certs/private.pem.key*Substitua pelo caminho para o arquivo de chave privada no dispositivo cliente. + *us-east-1*Substitua pela AWS região em que seu dispositivo cliente e dispositivo principal operam. ``` ./basic-discovery \ --thing_name MyClientDevice1 \ --topic 'clients/MyClientDevice1/hello/world' \ --ca_file ~/certs/AmazonRootCA1.pem \ --cert ~/certs/device.pem.crt \ --key ~/certs/private.pem.key \ --region us-east-1 ``` A aplicação de amostra de descoberta assina o tópico e solicita que você digite uma mensagem para publicar. ``` Connecting to group greengrassV2-coreDevice-MyGreengrassCore with thing arn arn:aws:iot:us-east-1:123456789012:thing/MyGreengrassCore, using endpoint 203.0.113.0:8883 Connected to group greengrassV2-coreDevice-MyGreengrassCore, using connection to 203.0.113.0:8883 Successfully subscribed to clients/MyClientDevice1/hello/world Enter the message you want to publish to topic clients/MyClientDevice1/hello/world and press enter. Enter 'exit' to exit this program. ``` Em vez disso, se a aplicação gerar um erro, consulte [Solução de problemas de descoberta do Greengrass](troubleshooting-client-devices.md#greengrass-discovery-issues). 1. Digite uma mensagem, como **Hello World\$1**. ``` Enter the message you want to publish to topic clients/MyClientDevice1/hello/world and press enter. Enter 'exit' to exit this program. Hello World! ``` Se a saída indicar que a aplicação recebeu a mensagem MQTT no tópico, o dispositivo cliente poderá se comunicar com êxito com o dispositivo principal. ``` Operation on packetId 2 Succeeded Publish received on topic clients/MyClientDevice1/hello/world Message: Hello World! ``` Também é possível ver os logs do Greengrass no dispositivo principal para verificar se o dispositivo cliente se conecta e envia mensagens com êxito. Para obter mais informações, consulte [Monitore AWS IoT Greengrass logs](monitor-logs.md). ## Comunicações de teste (JavaScript) Nesta seção, você usa a amostra de descoberta do Greengrass na [AWS IoT Device SDK v2 JavaScript para](https://github.com/aws/aws-iot-device-sdk-js-v2) testar as comunicações entre um dispositivo cliente e um dispositivo principal. **Importante** Para usar a AWS IoT Device SDK v2 JavaScript, um dispositivo deve executar o Node v10.0 ou posterior. **Para testar as comunicações (AWS IoT Device SDK v2 para JavaScript)** 1. Baixe e instale a [AWS IoT Device SDK v2 para JavaScript](https://github.com/aws/aws-iot-device-sdk-js-v2) que a AWS IoT coisa se conecte como um dispositivo cliente. No dispositivo cliente, faça o seguinte: 1. Clone a AWS IoT Device SDK v2 do JavaScript repositório para baixá-la. ``` git clone https://github.com/aws/aws-iot-device-sdk-js-v2.git ``` 1. Instale a AWS IoT Device SDK v2 para JavaScript. ``` cd aws-iot-device-sdk-js-v2 npm install ``` 1. Mude para a pasta de amostra do Greengrass discovery na AWS IoT Device SDK v2 para. JavaScript ``` cd samples/node/greengrass/basic_discovery ``` 1. Instale a aplicação de amostra de descoberta do Greengrass. ``` npm install ``` 1. Execute a aplicação de amostra de descoberta do Greengrass. Essa aplicação espera argumentos que especifiquem o nome do item do dispositivo cliente, o tópico e a mensagem MQTT que serão usados e os certificados que autenticam e protegem a conexão. O exemplo a seguir envia a mensagem “Hello World\$1” para o tópico `clients/MyClientDevice1/hello/world`. + *MyClientDevice1*Substitua pelo nome do item do dispositivo cliente. + *\$1/certs/AmazonRootCA1.pem*Substitua pelo caminho para o certificado CA raiz da Amazon no dispositivo cliente. + *\$1/certs/device.pem.crt*Substitua pelo caminho para o certificado do dispositivo no dispositivo cliente. + *\$1/certs/private.pem.key*Substitua pelo caminho para o arquivo de chave privada no dispositivo cliente. + *us-east-1*Substitua pela AWS região em que seu dispositivo cliente e dispositivo principal operam. ``` node dist/index.js \ --thing_name MyClientDevice1 \ --topic 'clients/MyClientDevice1/hello/world' \ --message 'Hello World!' \ --ca_file ~/certs/AmazonRootCA1.pem \ --cert ~/certs/device.pem.crt \ --key ~/certs/private.pem.key \ --region us-east-1 \ --verbose warn ``` A aplicação de amostra de descoberta envia a mensagem dez vezes e se desconecta. Ela também assina o mesmo tópico em que publica as mensagens. Se a saída indicar que a aplicação recebeu mensagens MQTT no tópico, o dispositivo cliente poderá se comunicar com êxito com o dispositivo principal. ``` Discovery Response: {"gg_groups":[{"gg_group_id":"greengrassV2-coreDevice-MyGreengrassCore","cores":[{"thing_arn":"arn:aws:iot:us-east-1:123456789012:thing/MyGreengrassCore","connectivity":[{"id":"203.0.113.0","host_address":"203.0.113.0","port":8883,"metadata":""}]}],"certificate_authorities":["-----BEGIN CERTIFICATE-----\nMIICiT...EXAMPLE=\n-----END CERTIFICATE-----\n"]}]} Trying endpoint={"id":"203.0.113.0","host_address":"203.0.113.0","port":8883,"metadata":""} [WARN] [2021-06-12T00:46:45Z] [00007f90c0e8d700] [socket] - id=0x7f90b8018710 fd=26: setsockopt() for NO_SIGNAL failed with errno 92. If you are having SIGPIPE signals thrown, you may want to install a signal trap in your application layer. Connected to endpoint={"id":"203.0.113.0","host_address":"203.0.113.0","port":8883,"metadata":""} Publish received. topic:"clients/MyClientDevice1/hello/world" dup:false qos:0 retain:false {"message":"Hello World!","sequence":1} Publish received. topic:"clients/MyClientDevice1/hello/world" dup:false qos:0 retain:false {"message":"Hello World!","sequence":2} Publish received. topic:"clients/MyClientDevice1/hello/world" dup:false qos:0 retain:false {"message":"Hello World!","sequence":3} Publish received. topic:"clients/MyClientDevice1/hello/world" dup:false qos:0 retain:false {"message":"Hello World!","sequence":4} Publish received. topic:"clients/MyClientDevice1/hello/world" dup:false qos:0 retain:false {"message":"Hello World!","sequence":5} Publish received. topic:"clients/MyClientDevice1/hello/world" dup:false qos:0 retain:false {"message":"Hello World!","sequence":6} Publish received. topic:"clients/MyClientDevice1/hello/world" dup:false qos:0 retain:false {"message":"Hello World!","sequence":7} Publish received. topic:"clients/MyClientDevice1/hello/world" dup:false qos:0 retain:false {"message":"Hello World!","sequence":8} Publish received. topic:"clients/MyClientDevice1/hello/world" dup:false qos:0 retain:false {"message":"Hello World!","sequence":9} Publish received. topic:"clients/MyClientDevice1/hello/world" dup:false qos:0 retain:false {"message":"Hello World!","sequence":10} Complete! ``` Em vez disso, se a aplicação gerar um erro, consulte [Solução de problemas de descoberta do Greengrass](troubleshooting-client-devices.md#greengrass-discovery-issues). Também é possível ver os logs do Greengrass no dispositivo principal para verificar se o dispositivo cliente se conecta e envia mensagens com êxito. Para obter mais informações, consulte [Monitore AWS IoT Greengrass logs](monitor-logs.md). ## Testar a comunicação (Java) Nesta seção, você usa a amostra de descoberta do Greengrass no [AWS IoT Device SDK v2 para Java](https://github.com/aws/aws-iot-device-sdk-java-v2) para testar a comunicação entre um dispositivo cliente e um dispositivo principal. **Importante** Para criar a AWS IoT Device SDK v2 para Java, um dispositivo deve ter as seguintes ferramentas: Java 8 ou posterior, com `JAVA_HOME` apontando para a pasta Java. Apache Maven **Para testar as comunicações (AWS IoT Device SDK v2 para Java)** 1. Baixe e crie a [AWS IoT Device SDK versão 2 para Java](https://github.com/aws/aws-iot-device-sdk-java-v2) para AWS IoT conectar-se como um dispositivo cliente. No dispositivo cliente, faça o seguinte: 1. Clone o repositório AWS IoT Device SDK v2 for Java para baixá-lo. ``` git clone https://github.com/aws/aws-iot-device-sdk-java-v2.git ``` 1. Mude para a pasta AWS IoT Device SDK v2 for Java. 1. Crie a AWS IoT Device SDK v2 para Java. ``` cd aws-iot-device-sdk-java-v2 mvn versions:use-latest-versions -Dincludes="software.amazon.awssdk.crt*" mvn clean install ``` 1. Execute a aplicação de amostra de descoberta do Greengrass. Essa aplicação espera argumentos que especifiquem o nome do item do dispositivo cliente, o tópico MQTT que será usado e os certificados que autenticam e protegem a conexão. No exemplo a seguir, é feita a assinatura no tópico `clients/MyClientDevice1/hello/world` e a publicação de uma mensagem que você digita na linha de comando para o mesmo tópico. + Substitua as duas instâncias *MyClientDevice1* de pelo nome do item do dispositivo cliente. + *\$1HOME/certs/AmazonRootCA1.pem*Substitua pelo caminho para o certificado CA raiz da Amazon no dispositivo cliente. + *\$1HOME/certs/device.pem.crt*Substitua pelo caminho para o certificado do dispositivo no dispositivo cliente. + *\$1HOME/certs/private.pem.key*Substitua pelo caminho para o arquivo de chave privada no dispositivo cliente. + *us-east-1*Substitua pelo Região da AWS local em que seu dispositivo cliente e o dispositivo principal operam. ``` DISCOVERY_SAMPLE_ARGS="--thing_name MyClientDevice1 \ --topic 'clients/MyClientDevice1/hello/world' \ --ca_file $HOME/certs/AmazonRootCA1.pem \ --cert $HOME/certs/device.pem.crt \ --key $HOME/certs/private.pem.key \ --region us-east-1" mvn exec:java -pl samples/Greengrass/Discovery \ -Dexec.mainClass=greengrass.BasicDiscovery \ -Dexec.args="$DISCOVERY_SAMPLE_ARGS" ``` A aplicação de amostra de descoberta assina o tópico e solicita que você digite uma mensagem para publicar. ``` Connecting to group ID greengrassV2-coreDevice-MyGreengrassCore, with thing arn arn:aws:iot:us-east-1:123456789012:thing/MyGreengrassCore, using endpoint 203.0.113.0:8883 Started a clean session Enter the message you want to publish to topic clients/MyClientDevice1/hello/world and press Enter. Type 'exit' or 'quit' to exit this program: ``` Em vez disso, se a aplicação gerar um erro, consulte [Solução de problemas de descoberta do Greengrass](troubleshooting-client-devices.md#greengrass-discovery-issues). 1. Digite uma mensagem, como **Hello World\$1**. ``` Enter the message you want to publish to topic clients/MyClientDevice1/hello/world and press Enter. Type 'exit' or 'quit' to exit this program: Hello World! ``` Se a saída indicar que a aplicação recebeu a mensagem MQTT no tópico, o dispositivo cliente poderá se comunicar com êxito com o dispositivo principal. ``` Message received on topic clients/MyClientDevice1/hello/world: Hello World! ``` Também é possível ver os logs do Greengrass no dispositivo principal para verificar se o dispositivo cliente se conecta e envia mensagens com êxito. Para obter mais informações, consulte [Monitore AWS IoT Greengrass logs](monitor-logs.md).