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 MT7697Hx
**Importante**
Essa integração de referência está hospedada no Amazon-FreeRTOS repositório que está obsoleto. 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 agora Amazon-FreeRTOS obsoleto, consulte o. [Amazon-FreeRTOS Guia de migração do repositório Github](github-repo-migration.md)
Este tutorial fornece instruções para começar a usar o kit de desenvolvimento MediaTek MT7697Hx. [Se você não tiver o kit de desenvolvimento MediaTek MT7697Hx, 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 Kit de Desenvolvimento MediaTek MT7697hx.
### Download e instalação do Keil MDK
Você pode usar o GUI-based Keil Microcontroller Development Kit (MDK) para configurar, criar e executar projetos FreeRTOS em sua 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 de [introdução do Keil MDK](http://www2.keil.com/mdk5/install/) e escolha Baixar. MDK-Core**
1. Insira e envie suas informações para serem registradas com o Keil.
1. Right-click use o executável do MDK e salve o instalador do Keil MDK em 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 (série MT76x7).
## 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 do MQTT com o AWS IoT Cliente 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\!". 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 kit de desenvolvimento MediaTek MT7697hx para o modo PROGRAMA.
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 **Usar**, defina o depurador como **CMSIS-DAP Depurador 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** em seu kit de desenvolvimento MediaTek MT7697hx.
## 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 **Destino** e, em seguida, escolha **Áreas de Read/Write memória**. Confirme se IRAM1 e IRAM2 estão selecionados.
1. Escolha a guia **Depurar** e, em seguida, escolha **CMSIS-DAP Depurador**.
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 kit de desenvolvimento MediaTek MT7697hx para o modo PROGRAMA.
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 kit de desenvolvimento MediaTek MT7697hx.
1. No menu μVision, escolha **Debug** e, em seguida, escolha **Start/Stop Debug** Session. A janela **Chamar pilha \+ 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 \+ Locals (Chamar pilha \+ 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. Right-click no `aws_demos` projeto, escolha **Opções** e, na guia **Utilitários**, escolha **Configurações**, ao lado de **“-- Usar driver de depuração --**”.
1. Verifique se as configurações na guia **Debug (Depurar)** são exibidas da seguinte forma:
1. Verifique se as configurações na guia **Flash Download (Atualizar download)** são exibidas da seguinte forma:
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).