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á.
# Introdução ao kit de desenvolvimento MediaTek MT7697 Hx
**Importante**
Essa integração de referência está hospedada no repositório Amazon-FreeRTOS, que está preterido. Recomendamos [começar aqui](freertos-getting-started-modular.md) ao criar um novo projeto. Se você já tem um projeto FreeRTOS existente baseado no repositório Amazon-FreeRTOS que está preterido, consulte o [Guia de migração do repositório Github do Amazon FreeRTOS](github-repo-migration.md).
Este tutorial fornece instruções para começar a usar o MediaTek MT7697 Hx Development Kit. Se você não tiver o kit de desenvolvimento MediaTek MT7697 Hx, visite o Catálogo de dispositivos do AWS parceiro para comprar um de nosso [parceiro](https://devices.amazonaws.com/detail/a3G0L00000AAOmPUAX/MT7697Hx-Development-Kit).
Antes de começar, você deve configurar AWS IoT e fazer o download dos FreeRTOS para conectar seu dispositivo à nuvem. AWS Para obter instruções, consulte [Primeiras etapas](freertos-prereqs.md). Neste tutorial, o caminho para o diretório de download do FreeRTOS é chamado `freertos`.
## Visão geral do
Este tutorial contém instruções para as seguintes etapas iniciais:
1. Instalar software na máquina host para desenvolver e depurar aplicativos incorporados para seu microcontrolador.
1. Compilar uma aplicação de demonstração do FreeRTOS de forma cruzada para uma imagem binária.
1. Carregar a imagem binária do aplicativo em sua placa e executar o aplicativo.
1. Interagir com o aplicativo em execução na placa em uma conexão serial para fins de monitoramento e depuração.
## Configuração do ambiente de desenvolvimento
Antes de configurar seu ambiente, conecte seu computador à porta USB do MediaTek MT7697 Hx Development Kit.
### Download e instalação do Keil MDK
Você pode usar o Kit de desenvolvimento de microcontrolador (MDK) Keil baseado em GUI para configurar, compilar e executar projetos do FreeRTOS na placa. O Keil MDK inclui o IDE do μVision e o Depurador do μVision.
**nota**
O Keil MDK é compatível somente com máquinas Windows 7, Windows 8 e Windows 10 de 64 bits.
**Para fazer download e instalar o Keil MDK**
1. Acesse a página [Conceitos básicos do Keil MDK](http://www2.keil.com/mdk5/install/) e escolha **Download MDK-Core (Fazer download do MDK-Core)**.
1. Insira e envie suas informações para serem registradas com o Keil.
1. Clique com o botão direito no arquivo executável do MDK e salve o instalador do Keil MDK no seu computador.
1. Abra o instalador do Keil MDK e siga as etapas para a conclusão. Certifique-se de instalar o pacote de MediaTek dispositivos (MT76x7 Série).
## Estabelecimento de uma conexão serial
Conecte a placa ao computador host usando um cabo USB. Uma porta COM aparece no Gerenciador de dispositivos do Windows. Para depuração, você pode abrir uma sessão na porta com uma ferramenta utilitária de terminal, como ou. HyperTerminal TeraTerm
## Monitoramento de mensagens MQTT na nuvem
Antes de executar o projeto de demonstração do FreeRTOS, você pode configurar o cliente MQTT no console para monitorar AWS IoT as mensagens que seu dispositivo envia para a nuvem. AWS
**Para assinar o tópico MQTT com o cliente AWS IoT MQTT**
1. Faça login no [console do AWS IoT](https://console.aws.amazon.com/iotv2/).
1. No painel de navegação, escolha **Teste** e, em seguida, escolha **cliente de teste MQTT** para abrir o cliente MQTT.
1. Em **Tópico de inscrição**, insira ***your-thing-name*example/topic** e selecione **Inscreva-se no tópico**.
Quando o projeto de demonstração for executado com êxito em seu dispositivo, você verá "Olá, mundo\$1". enviado várias vezes para o tópico em que você assinou.
## Compilação e execução do projeto de demonstração do FreeRTOS com MDK Keil
**Para compilar o projeto de demonstração do FreeRTOS no Keil μVision**
1. No menu **Iniciar**, abra o Keil μVision 5.
1. Abra o arquivo de projeto `projects/mediatek/mt7697hx-dev-kit/uvision/aws_demos/aws_demos.uvprojx`.
1. No menu, escolha **Project (Projeto)** e **Build target (Compilar destino)**.
Depois que o código for compilado, você verá o arquivo executável de demonstração em `projects/mediatek/mt7697hx-dev-kit/uvision/aws_demos/out/Objects/aws_demo.axf`.
**Como executar o projeto de demonstração do FreeRTOS**
1. Defina o MediaTek MT7697 Hx Development Kit para o modo PROGRAM.
Para definir o kit no modo PROGRAM, mantenha pressionado o botão **PROG**. Com o botão **PROG** ainda pressionado, pressione e solte o botão **RESET** e, depois, solte o botão **PROG**.
1. No menu, escolha **Flash** e **Configure Flash Tools (Configurar ferramentas de atualização)**.
1. Em **Options for Target (Opções de destino) "`aws_demo`"**, escolha a guia **Debug (Depurar)**. Selecione **Use (Usar)**, defina o depurador como **CMSIS-DAP Debugger (Depurador CMSIS-DAP)** e escolha **OK**.
1. No menu, escolha **Flash (Atualizar)** e **Download (Fazer download)**.
O μVision notificará você quando o download for concluído.
1. Use um utilitário de terminal para abrir a janela do console de série. Defina a porta serial como 115200 bps, sem paridade, 8 bits e 1 bit de parada.
1. Escolha o botão **RESET** no seu kit de desenvolvimento MediaTek MT7697 Hx.
## Solução de problemas
### Depuração de projetos do FreeRTOS no Keil µVision
Atualmente, você deve editar o MediaTek pacote incluído no Keil μVision antes de poder depurar o projeto de demonstração do FreeRTOS com Keil μVision. MediaTek
**Para editar o MediaTek pacote para depuração de projetos FreeRTOS**
1. Localize e abra o arquivo `Keil_v5\ARM\PACK\.Web\MediaTek.MTx.pdsc` na pasta de instalação do Keil MDK.
1. Substitua todas as instâncias de `flag = Read32(0x20000000);` por `flag = Read32(0x0010FBFC);`.
1. Substitua todas as instâncias de `Write32(0x20000000, 0x76877697);` por `Write32(0x0010FBFC, 0x76877697);`.
**Para iniciar a depuração do projeto**
1. No menu, escolha **Flash** e **Configure Flash Tools (Configurar ferramentas de atualização)**.
1. Escolha a guia **Target (Destino)** e, depois, **Read/Write Memory Areas (Ler/gravar áreas de memória)**. Confirme isso IRAM1 e ambos IRAM2 estão selecionados.
1. Escolha a guia **Debug (Depurar)** e, depois, **CMSIS-DAP Debugger (Depurador CMSIS-DAP)**.
1. Abra `vendors/mediatek/boards/mt7697hx-dev-kit/aws_demos/application_code/main.c` e defina a macro `MTK_DEBUGGER` como `1`.
1. Compile novamente o projeto de demonstração no μVision.
1. Defina o MediaTek MT7697 Hx Development Kit para o modo PROGRAM.
Para definir o kit no modo PROGRAM, mantenha pressionado o botão **PROG**. Com o botão **PROG** ainda pressionado, pressione e solte o botão **RESET** e, depois, solte o botão **PROG**.
1. No menu, escolha **Flash (Atualizar)** e **Download (Fazer download)**.
O μVision notificará você quando o download for concluído.
1. Pressione o botão **RESET** no seu kit de desenvolvimento MediaTek MT7697 Hx.
1. No menu do μVision, escolha **Depuração** e **Iniciar/Interromper sessão de depuração**. A janela **Chamar pilha \$1 locais** é aberta quando você inicia a sessão de depuração.
1. No menu, escolha **Debug (Depurar)** e, depois, escolha **Stop (Parar)** para pausar a execução do código. O contador do programa é interrompido na seguinte linha:
```
{ volatile int wait_ice = 1 ; while ( wait_ice ) ; }
```
1. Na janela **Call Stack \$1 Locals (Chamar pilha \$1 locais)**, altere o valor de `wait_ice` para `0`.
1. Defina os pontos de interrupção no código-fonte do projeto e execute-o.
### Solução de problemas de configuração do depurador IDE
Se você está com problemas para depurar uma aplicação, as configurações do seu depurador podem estar incorretas.
**Para verificar se as configurações do depurador estão corretas**
1. Abra o Keil µVision.
1. Clique com o botão direito do mouse no projeto `aws_demos`, escolha **Options (Opções)**, e na guia **Utilities (Utilitários)**, escolha **Settings (Configurações)** ao lado de **“-- Use Debug Driver --” (Usar driver de depuração)**.
1. Verifique se as configurações na guia **Debug (Depurar)** são exibidas da seguinte forma:
![\[Caixa de diálogo de configuração do driver de destino CMSIS-DAP Cortex-M com número de série, versão do firmware, tipo de adaptador, opções do dispositivo de software e configurações.\]](http://docs.aws.amazon.com/pt_br/freertos/latest/userguide/images/mediatek-debug-2.png)
1. Verifique se as configurações na guia **Flash Download (Atualizar download)** são exibidas da seguinte forma:
![\[Janela de configuração do driver Cortex-M Target com opções para função de download, RAM para algoritmo, descrição do algoritmo de programação e detalhes do dispositivo.\]](http://docs.aws.amazon.com/pt_br/freertos/latest/userguide/images/mediatek-debug-3.png)
Para obter mais informações sobre soluções de problemas gerais sobre os Conceitos básicos do FreeRTOS, consulte [Solução de problemas de conceitos básicos](gsg-troubleshooting.md).