Conceitos básicos do Microchip Curiosity PIC32MZ EF - Gratuito RTOS
Visão geralConfiguração do hardware Microchip Curiosity PIC32MZ EFConfiguração do hardware do Microchip Curiosity PIC32MZ EF usando PICkit On Board (PKOB)Configuração do ambiente de desenvolvimentoMonitoramento de mensagens MQTT na nuvemCompilação e execução do projeto de demonstração do FreeRTOSSolução de problemas

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

Conceitos básicos do Microchip Curiosity PIC32MZ EF

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 RTOS repositório Github gratuito da Amazon.

nota

De acordo com a Microchip, estamos removendo o Curiosity PIC32MZEF (DM320104) da ramificação principal do repositório de Integração de Referência do FreeRTOS e não o carregaremos mais em novas versões. A Microchip emitiu um aviso oficial de que o PIC32MZEF (DM320104) não é mais recomendado para novos designs. Os projetos e o código-fonte do PIC32MZEF ainda podem ser acessados por meio das tags de lançamento anteriores. A Microchip recomenda que os clientes usem a placa de desenvolvimento Curiosity PIC32MZ-EF-2.0 (DM320209) para novos designs. A plataforma PIC32MZv1 ainda pode ser encontrada na versão v202012.00 do repositório de Integração de Referência do FreeRTOS. No entanto, não há mais suporte para a plataforma não na versão v202107.00 da Referência do FreeRTOS.

Este tutorial fornece instruções para começar a usar o Microchip Curiosity PIC32MZ EF. Se você não tiver o pacote Microchip Curiosity PIC32MZ EF, acesse o catálogo do AWS Partner Device para adquirir um dos nossos parceiros.

O pacote inclui os seguintes itens:

Você também precisa os seguintes itens para depuração:

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.

Importante

  • Neste tópico, o caminho para o diretório de download do FreeRTOS é chamado de freertos.

  • Caracteres de espaço no caminho freertos podem causar falhas na compilação. Ao clonar ou copiar o repositório, verifique se o caminho criado não contém caracteres de espaço.

  • O tamanho máximo de um caminho de arquivo no Microsoft Windows é 260 caracteres. Caminhos longos de diretório de download do FreeRTOS podem causar falhas de compilação.

  • O código-fonte pode conter links simbólicos, por isso se estiver usando o Windows para extrair o arquivo, talvez seja necessário:

    Dessa forma, o Windows pode criar links simbólicos adequadamente ao extrair o arquivamento. Caso contrário, os links simbólicos serão gravados como arquivos comuns que contêm os caminhos dos links simbólicos como texto ou estão vazios. Para obter mais informações, consulte a entrada no blog Symlinks no Windows 10!.

    Se você usa o Git no Windows, você deve habilitar o modo Desenvolvedor ou deve:

    • Definir core.symlinks como verdadeiro com o seguinte comando:

      git config --global core.symlinks true

    • Use um console com privilégios de administrador sempre que usar um comando git que grava no sistema (por exemplo, git pull, git clone, e git submodule update --init --recursive).

Visão geral

Este tutorial contém instruções para as seguintes etapas iniciais:

  1. Conectar sua placa a uma máquina host.

  2. Instalar software na máquina host para desenvolver e depurar aplicativos incorporados para seu microcontrolador.

  3. Compilar um aplicativo de demonstração do FreeRTOS de forma cruzada para uma imagem binária.

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

  5. Interagir com o aplicativo em execução na placa em uma conexão serial para fins de monitoramento e depuração.

Configuração do hardware Microchip Curiosity PIC32MZ EF

  1. Conecte a placa MikroElectronika USB UART click ao conector microBUS 1 no Microchip Curiosity PIC32MZ EF.

  2. Conecte a placa auxiliar PIC32 LAN8720 PHY ao cabeçalho J18 no Microchip Curiosity PIC32MZ EF.

  3. Conecte a placa MikroElectronika USB UART click ao computador usando um cabo USB A para USB mini-B.

  4. Para conectar a placa à Internet, use uma das seguintes opções:

    • Para usar Wi-Fi, conecte a placa de clique MikroElectronika Wi-Fi 7 ao conector microBUS 2 no Microchip Curiosity PIC32MZ EF. Consulte Configurando as demonstrações gratuitas RTOS.

    • Para usar Ethernet para conectar a placa Microchip Curiosity PIC32MZ EF à internet, conecte a placa filha PIC32 LAN8720 PHY ao cabeçalho J18 no Microchip Curiosity PIC32MZ EF. Conecte uma extremidade do cabo Ethernet à placa auxiliar LAN8720 PHY. Conecte a outra extremidade ao roteador ou outra porta da Internet. Você também deve definir a macro PIC32_USE_ETHERNET do pré-processador.

  5. Se ainda não tiver feito isso, solde o conector angular ao conjunto ICSP no Microchip Curiosity PIC32MZ EF.

  6. Conecte uma extremidade do cabo ICSP do Kit de cabos de programação PICkit 3 ao Microchip Curiosity PIC32MZ EF.

    Se não tiver Kit de cabos de programação PICkit 3, você poderá usar jumpers de cabo M-F Dupont para estabelecer a conexão. Observe que o círculo branco indica a posição do Pino 1.

  7. Conecte a outra extremidade do cabo ICSP (ou jumpers) ao Depurador MPLAB Snap. O Pino 1 do Conector de programação SIL de 8 pinos está marcado com um triângulo preto na parte inferior direita da placa.

    Certifique-se de que qualquer cabo conectado ao Pino 1 no Microchip Curiosity PIC32MZ EF, indicado pelo círculo branco, esteja alinhado ao Pino 1 no Depurador MPLAB Snap.

    Para obter mais informações sobre o Depurador MPLAB Snap, consulte MPLAB Snap In-Circuit Debugger Information Sheet.

Configuração do hardware do Microchip Curiosity PIC32MZ EF usando PICkit On Board (PKOB)

Recomendamos seguir o procedimento de configuração na seção anterior. No entanto, você pode avaliar e executar demonstrações do FreeRTOS com depuração básica usando o programador/depurador do PICkit On Board (PKOB) integrado seguindo estas etapas.

  1. Conecte a placa MikroElectronika USB UART click ao conector microBUS 1 no Microchip Curiosity PIC32MZ EF.

  2. Para conectar a placa à Internet, siga um destes procedimentos:

    • Para usar Wi-Fi, conecte a placa de clique MikroElectronika Wi-Fi 7 ao conector microBUS 2 no Microchip Curiosity PIC32MZ EF. (Siga as etapas em “Como configurar seu Wi-Fi” em Configurando as demonstrações gratuitas RTOS).

    • Para usar Ethernet para conectar a placa Microchip Curiosity PIC32MZ EF à internet, conecte a placa filha PIC32 LAN8720 PHY ao cabeçalho J18 no Microchip Curiosity PIC32MZ EF. Conecte uma extremidade do cabo Ethernet à placa auxiliar LAN8720 PHY. Conecte a outra extremidade ao roteador ou outra porta da Internet. Você também deve definir a macro PIC32_USE_ETHERNET do pré-processador.

  3. Conecte a porta USB micro-B chamada “USB DEBUG” na placa Microchip Curiosity PIC32MZ EF ao seu computador usando um cabo USB tipo A para USB micro-B.

  4. Conecte a placa MikroElectronika USB UART click ao computador usando um cabo USB A para USB mini-B.

Configuração do ambiente de desenvolvimento

nota

O projeto do FreeRTOS para esse dispositivo é baseado no MPLAB Harmony v2. Para criar o projeto, você precisa usar versões das ferramentas do MPLAB que são compatíveis com Harmony v2, como v2.10 do MPLAB XC32 Compiler e as versões 2.X.X do MPLAB Harmony Configurator (MHC).

  1. Instale o Python versão 3.x ou posterior.

  2. Instale o MPLAB X IDE:

    nota

    Atualmente, há suporte para as Integrações de referência v202007.00 do AWS FreeRTOS somente no MPLabv5.35. Há suporte para as versões anteriores das Integrações de referência do AWS FreeRTOS no MPLabv5.40.

    Downloads de MPLab v5.35
    Últimos downloads do MPlab (MPLab v5.40)

  3. Instale o MPLAB XC32 Compiler:

  4. Inicie um emulador de terminal UART e abra uma conexão com as seguintes configurações:

    • Taxa de baud: 115200

    • Dados: 8 bits

    • Paridade: nenhum

    • Bits de parada: 1

    • Controle de fluxo: nenhum

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

Abrir a demonstração do FreeRTOS no IDE do MPLAB

  1. Abra o MPLAB IDE. Se você tiver mais de uma versão do compilador instalado, você precisa selecionar o compilador que você deseja usar de dentro do IDE.

  2. No menu File (Arquivo), escolha Open project (Abrir projeto).

  3. Navegue e abre projects/microchip/curiosity_pic32mzef/mplab/aws_demos.

  4. Selecione Open project (Abrir projeto).

nota

Quando você abre o projeto pela primeira vez, pode aparecer uma mensagem de erro sobre o compilador. No IDE, navegue até Tools (Ferramentas), Options (Opções), Embedded (Incorporado) e selecione o compilador que você está usando para seu projeto.

Para usar a Ethernet para se conectar, você deve definir a macro do pré-processador PIC32_USE_ETHERNET.

Como usar Ethernet para se conectar usando o IDE do MPLAB

  1. No IDE do MPLAB, clique com o botão direito do mouse no projeto e escolha Propriedades.

  2. Na caixa de diálogo Propriedades do projeto, escolha nome do compilador (Opções globais) para expandi-lo e selecione nome do compilador-gcc.

  3. Em categorias de Opções, escolha Pré-processamento e mensagens e, em seguida, adicione a string PIC32_USE_ETHERNET às macros do pré-processador.

Execução do projeto de demonstração do FreeRTOS

  1. Compile o projeto novamente.

  2. Na guia Projects (Projetos), clique com o botão direito do mouse na pasta de nível superior aws_demos e, em seguida, escolha Debug (Depurar).

  3. Quando o depurador parar no ponto de interrupção em main(), no menu Run (Executar), escolha Resume (Continuar).

Compilação da demonstração do FreeRTOS com CMake

Se você preferir não usar um IDE para desenvolvimento do FreeRTOS, também é possível usar o CMake para compilar e executar os aplicativos de demonstração ou aplicativos que você desenvolveu usando editores de código e ferramentas de depuração de terceiros.

Como compilar a demonstração do FreeRTOS com CMake

  1. Crie um diretório para a contenção dos arquivos de compilação gerados, como build-directory.

  2. Use o comando a seguir para gerar arquivos de compilação do código-fonte.

    cmake -DVENDOR=microchip -DBOARD=curiosity_pic32mzef -DCOMPILER=xc32 -DMCHP_HEXMATE_PATH=path/microchip/mplabx/version/mplab_platform/bin  -DAFR_TOOLCHAIN_PATH=path/microchip/xc32/version/bin -S freertos -B build-folder
    nota

    Você deve especificar os caminhos corretos para os binários da cadeia de ferramentas e do Hexmate, como os caminhos C:\Program Files (x86)\Microchip\MPLABX\v5.35\mplab_platform\bin e C:\Program Files\Microchip\xc32\v2.40\bin.

  3. Altere os diretórios para o diretório de compilação (build-directory) e, em seguida, execute make a partir desse diretório.

Para obter mais informações, consulte Uso da CMake com o FreeRTOS.

Para usar a Ethernet para se conectar, você deve definir a macro do pré-processador PIC32_USE_ETHERNET.

Solução de problemas

Para obter informações sobre a solução de problemas, consulte Solução de problemas de conceitos básicos.