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 AWS nuvem. AWS IoT hospeda um agente MQTT que envia e recebe mensagens de e 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).

## Teste
<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 do MQTT. 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 | Suítes de AWS IoT cifras de suporte ao TLS | 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 MQTT 1 ClientPuback  | Sim | 
| MQTT | MQTT sem Ack PingResp | Sim |