Conceitos básicos do kit de desenvolvimento MT7697Hx da MediaTek - FreeRTOS
Visão geralConfiguração do ambiente de desenvolvimentoEstabelecimento de uma conexão serialMonitoramento de mensagens MQTT na nuvemCompilação e execução do projeto de demonstração do FreeRTOS com MDK KeilSolução de problemas

Conceitos básicos do kit de desenvolvimento MT7697Hx da MediaTek

Importante

Essa integração de referência está hospedada no repositório Amazon-FreeRTOS, que está preterido. Recomendamos começar aqui 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.

Este tutorial fornece instruções para começar a usar o MediaTek MT7697Hx Development Kit. Se você não tiver o Kit de desenvolvimento MT7697Hx da MediaTek, acesse o catálogo do AWS Partner Device para adquirir um dos nossos parceiros.

Antes de começar, você deve configurar o AWS IoT e seu download do FreeRTOS para conectar seu dispositivo à nuvem da AWS. Para obter instruções, consulte Primeiras etapas. Neste tutorial, o caminho para o diretório de download do FreeRTOS é chamado freertos.

Visão geral

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.

  2. Compilar uma aplicação de demonstração do FreeRTOS de forma cruzada para uma imagem binária.

  3. Carregar a imagem binária do aplicativo em sua placa e executar o aplicativo.

  4. 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 o computador à porta USB no MediaTek MT7697Hx 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 e escolha Download MDK-Core (Fazer download do MDK-Core).

  2. Insira e envie suas informações para serem registradas com o Keil.

  3. Clique com o botão direito no arquivo executável do MDK e salve o instalador do Keil MDK no seu computador.

  4. Abra o instalador do Keil MDK e siga as etapas para a conclusão. Instale o pacote de dispositivo MediaTek (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 a depuração, você pode abrir uma sessão para a porta com uma ferramenta de utilitário de terminal, como HyperTerminal ou 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 do AWS IoT para monitorar as mensagens enviadas pelo dispositivo para a nuvem da AWS.

Para assinar o tópico MQTT com o cliente MQTT do AWS IoT

  1. Faça login no console do AWS IoT.

  2. No painel de navegação, escolha Teste e, em seguida, escolha cliente de teste MQTT para abrir o cliente MQTT.

  3. Em Tópico de inscrição, insira your-thing-nameexample/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.

  2. Abra o arquivo de projeto projects/mediatek/mt7697hx-dev-kit/uvision/aws_demos/aws_demos.uvprojx.

  3. 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 MT7697Hx Development Kit no 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.

  2. No menu, escolha Flash e Configure Flash Tools (Configurar ferramentas de atualização).

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

  4. No menu, escolha Flash (Atualizar) e Download (Fazer download).

    O μVision notificará você quando o download for concluído.

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

  6. Escolha o botão RESET no seu MediaTek MT7697Hx Development Kit.

Solução de problemas

Depuração de projetos do FreeRTOS no Keil µVision

Atualmente, é necessário editar o pacote do MediaTek que está incluído no Keil μVision antes de depurar o projeto de demonstração do FreeRTOS para o MediaTek com o Keil μVision.

Para editar o pacote do MediaTek para depurar projetos do FreeRTOS

  1. Localize e abra o arquivo Keil_v5\ARM\PACK\.Web\MediaTek.MTx.pdsc na pasta de instalação do Keil MDK.

  2. Substitua todas as instâncias de flag = Read32(0x20000000); por flag = Read32(0x0010FBFC);.

  3. 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).

  2. Escolha a guia Target (Destino) e, depois, Read/Write Memory Areas (Ler/gravar áreas de memória). Confirme se IRAM1 e IRAM2 estão selecionados.

  3. Escolha a guia Debug (Depurar) e, depois, CMSIS-DAP Debugger (Depurador CMSIS-DAP).

  4. Abra vendors/mediatek/boards/mt7697hx-dev-kit/aws_demos/application_code/main.c e defina a macro MTK_DEBUGGER como 1.

  5. Compile novamente o projeto de demonstração no μVision.

  6. Defina o MediaTek MT7697Hx Development Kit no 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.

  7. No menu, escolha Flash (Atualizar) e Download (Fazer download).

    O μVision notificará você quando o download for concluído.

  8. Pressione o botão RESET (REDEFINIR) no MediaTek MT7697Hx Development Kit.

  9. No menu do μVision, escolha Depuração e Iniciar/Interromper sessão de depuração. A janela Chamar pilha + locais é aberta quando você inicia a sessão de depuração.

  10. 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 ) ; }

  11. Na janela Call Stack + Locals (Chamar pilha + locais), altere o valor de wait_ice para 0.

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

  2. 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).

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

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

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.