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á.

# Configuração da biblioteca coreMQTT
<a name="afr-porting-mqtt"></a>

Os dispositivos na borda podem usar o protocolo MQTT para se comunicar com a Nuvem AWS. O AWS IoT hospeda um agente MQTT que recebe e envia mensagens para dispositivos conectados na borda.

A biblioteca coreMQTT implementa o protocolo MQTT para dispositivos que executam o . A biblioteca coreMQTT não precisa ser transferida, mas o projeto de teste do dispositivo deve passar em todos os testes MQTT para qualificação. Para obter mais informações, consulte [Biblioteca coreMQTT](https://docs.aws.amazon.com/freertos/latest/userguide/coremqtt.html) no *Guia do usuário do FreeRTOS*.

## Pré-requisitos
<a name="testing-prereqs-mqtt"></a>

Para configurar os testes da biblioteca coreMQTT, você precisa de uma porta de interface de transporte de rede. Para saber mais, consulte [Fazer portabilidade da Network Transport Interface](afr-porting-network-transport-interface.md).

## Testar
<a name="testing-mqtt"></a>

Execute testes de integração da coreMQTT:
+ Registre seu certificado de cliente no agente MQTT.
+ Configure o endpoint do agente em `config` e execute os testes de integração.

## Criação de demonstração de referência do MQTT
<a name="reference-mqtt"></a>

Recomendamos usar o agente coreMQTT para lidar com a segurança de thread em todas as operações do MQTT. O usuário também precisará publicar e assinar tarefas e testes do Device Advisor para validar se a aplicação integra TLS, MQTT e outras bibliotecas FreeRTOS de forma eficaz. 

Para qualificar oficialmente um dispositivo para FreeRTOS, valide seu projeto de integração com os casos de teste da MQTT do AWS IoT Device Tester. Consulte o [fluxo de trabalho do AWS IoT Device Advisor](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-console-tutorial.html) para obter instruções de configuração e teste. Os casos de teste obrigatórios para TLS e MQTT estão listados abaixo:


**Casos de teste do TLS**  

| Caso de teste | Casos de teste | Testes necessários | 
| --- | --- | --- | 
| TLS | Conexão TLS | Sim | 
| TLS | Pacotes de criptografia de suporte ao TLS do AWS IoT | Um [pacote de criptografia](https://docs.aws.amazon.com/iot/latest/developerguide/transport-security.html#tls-cipher-suite-support) recomendado  | 
| TLS | Certificado de servidor TLS desprotegido | Sim | 
| TLS | TLS: certificado do servidor de nome de assunto incorreto | Sim | 


**Casos de teste do MQTT**  

| Caso de teste | Casos de teste | Testes necessários | 
| --- | --- | --- | 
| MQTT | MQTT Connect | Sim | 
| MQTT | Novas tentativas de jitter de conexão MQTT | Sim, sem avisos | 
| MQTT | MQTT Subscribe | Sim | 
| MQTT | MQTT Publish | Sim | 
| MQTT | QoS 1 ClientPuback de MQTT | Sim | 
| MQTT | No Ack PingResp de MQTT | Sim |