Conceitos básicos do Texas Instruments CC3220SF-LAUNCHXL - FreeRTOS

Conceitos básicos do Texas Instruments CC3220SF-LAUNCHXL

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 Texas Instruments CC3220SF-LAUNCHXL. Se você não tiver o kit de desenvolvimento CC3220SF-LAUNCHXL da Texas Instruments (TI), acesse o catálogo do AWS Partner Device para comprar um com 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.

Configuração do ambiente de desenvolvimento

Siga as etapas abaixo para configurar o ambiente de desenvolvimento para começar a usar o FreeRTOS.

Observe que o FreeRTOS oferece suporte a dois IDEs para o kit de desenvolvimento TI CC3220SF-LAUNCHXL: Code Composer Studio e IAR Embedded Workbench versão 8.32. Você pode usar o IDE para começar.

Instalar o Code Composer Studio

  1. Vá até TI Code Composer Studio.

  2. Faça download do instalador off-line da plataforma da máquina host (Windows, macOS ou Linux 64 bits).

  3. Descompacte e execute o instalador off-line. Siga os prompts.

  4. Em Product Families to Install (Famílias de produtos para instalar), escolha SimpleLink Wi-Fi CC32xx Wireless MCUs.

  5. Na próxima página, aceite as configurações padrão para testes de depuração e, em seguida, escolha Finish (Concluir).

Se você encontrar problemas ao instalar o Code Composer Studio, consulte Suporte de ferramentas de desenvolvimento de TI, Perguntas frequentes do Code Composer Studio e Solução de problemas do CCS.

Instalar o IAR Embedded Workbench

  1. Faça download e execute o Instalador do Windows para a versão 8.32 do IAR Embedded Workbench for ARM. Em Debug probe drivers (Depurar drivers de teste), selecione TI XDS.

  2. Conclua a instalação e inicie o programa. Na página License Wizard (Assistente de licença), escolha Register with IAR Systems to get an evaluation license (Registrar com IAR Systems para obter uma licença de avaliação) ou use sua própria licença do IRA.

Instalar o SimpleLink CC3220 SDK

Instale o SimpleLink CC3220 SDK. O SimpleLink Wi-Fi CC3220 SDK contém drivers para o MCU programável CC3220SF, mais de 40 aplicações de exemplo e a documentação necessária para usar as amostras.

Instalar o Uniflash

Instale o Uniflash. CCS Uniflash é uma ferramenta independente usada para programar a memória flash incorporada em TI MCUs. O Uniflash tem uma GUI, linha de comando e interface de scripts.

Instalação do Service Pack mais recente

  1. No TI CC3220SF-LAUNCHXL, coloque o jumper SOP no conjunto de pinos do meio (posição = 1) e redefina a placa.

  2. Inicie o Uniflash. Se a sua placa CC3220SF LaunchPad for exibida em Detected Devices (Dispositivos detectados), selecione Start (Iniciar). Se a placa não for detectada, selecione CC3220SF-LAUNCHXL na lista de placas em New Configuration (Nova configuração) e selecione Start Image Creator (Iniciar criador de imagens).

  3. Escolha Novo projeto.

  4. Na página Start new project (Iniciar novo projeto), insira um nome para o projeto. Em Device Type (Tipo de dispositivo), selecione CC3220SF. Em Device Mode (Modo de dispositivo), escolha Develop (Desenvolver) e, em seguida, Create Project (Criar projeto).

  5. No lado direito da janela da aplicação Uniflash, escolha Connect (Conectar).

  6. Na coluna à esquerda, selecione Advanced (Avançado), Files (Arquivos) e, em seguida, Service Pack (Pacotes de serviços).

  7. Escolha Browse (Procurar) e navegue até onde você instalou o CC3220SF SimpleLink SDK. O service pack está localizado em ti/simplelink_cc32xx_sdk_VERSION/tools/cc32xx_tools/servicepack-cc3x20/sp_VERSION.bin.

  8. Selecione o botão Burn (Gravar) ( Feather icon representing a lightweight or simplified feature or concept. ) e depois selecione Program Image (Create & Program) (Imagem do programa (criar e programar)) para instalar o pacote de serviços. Lembre-se de alternar o jumper SOP de volta para a posição 0 e redefina a placa.

Configuração de provisionamento de Wi-Fi

Para definir as configurações de Wi-Fi para sua placa, execute uma das seguintes ações:

Compilação e execução do projeto de demonstração do FreeRTOS

Compilação e execução do projeto de demonstração do FreeRTOS no TI Code Composer

Como importar a demonstração do FreeRTOS para o TI Code Composer
  1. Abra o TI Code Composer e escolha OK para aceitar o nome padrão do espaço de trabalho.

  2. Na página Getting Started (Conceitos básicos), selecione Import Project (Importar projeto).

  3. Em Select search-directory (Selecionar diretório de pesquisa), digite projects/ti/cc3220_launchpad/ccs/aws_demos. O projeto aws_demos deve ser selecionado por padrão. Para importar o projeto para o TI Code Composer, escolha Finish (Concluir).

  4. No Project Explorer, clique duas vezes em aws_demos para tornar o projeto ativo.

  5. Em Project (Projeto), escolha Build Project (Criar projeto) para garantir que o projeto seja compilado sem erros ou avisos.

Como executar a demonstração do FreeRTOS no TI Code Composer
  1. Verifique se o jumper Sense On Power (SOP) no Texas Instruments CC3220SF-LAUNCHXL está na posição 0. Para obter mais informações, consulte o Guia do usuário do processador de rede SimpleLink Wi-Fi CC3x20, CC3x3x.

  2. Use um cabo USB para conectar o Texas Instruments CC3220SF-LAUNCHXL ao computador.

  3. No explorador de projeto, certifique-se de que o CC3220SF.ccxml esteja selecionado como a configuração de destino ativa. Para ativá-la, clique com o botão direito do mouse no arquivo e selecione Set as active target configuration (Definir como configuração de destino ativa).

  4. No TI Code Composer, em Run (Executar), selecione Debug (Depurar).

  5. Quando o depurador parar no ponto de interrupção em main(), vá para o menu Run (Executar) e escolha Resume (Continuar).

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.

Criação e execução do projeto de demonstração do FreeRTOS no IAR Embedded Workbench

Para importar a demonstração do FreeRTOS para o IAR Embedded Workbench
  1. Abra o IAR Embedded Workbench, escolha File (Arquivo) e, em seguida, escolha Open Workspace (Abrir Workspace).

  2. Navegue até projects/ti/cc3220_launchpad/iar/aws_demos, escolha aws_demos.eww e escolha OK.

  3. Clique com o botão direito do mouse no nome do projeto (aws_demos) e, em seguida, selecione Make (Fazer).

Como executar a demonstração do FreeRTOS no IAR Embedded Workbench
  1. Verifique se o jumper Sense On Power (SOP) no Texas Instruments CC3220SF-LAUNCHXL está na posição 0. Para obter mais informações, consulte o Guia do usuário do processador de rede SimpleLink Wi-Fi CC3x20, CC3x3x.

  2. Use um cabo USB para conectar o Texas Instruments CC3220SF-LAUNCHXL ao computador.

  3. Compile o projeto novamente.

    Para recriar o projeto, no menu Project (Projeto), escolha Make (Fazer).

  4. No menu Project (Projeto), escolha Download and Debug (Fazer download e depurar). Você pode ignorar "Aviso: Falha ao inicializar EnergyTrace", se for exibido. Para obter mais informações sobre EnergyTrace, consulte MSP EnergyTrace Technology.

  5. Quando o depurador parar no ponto de interrupção em main(), vá para o menu Debug (Depurar) e escolha Go (Ir).

Uso da CMake com o FreeRTOS

Se você preferir não usar um IDE para desenvolvimento do FreeRTOS, também é possível usar o CMake para compilar e executar as aplicações de demonstração ou aplicações 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 uma pasta para conter os arquivos de compilação gerados (build-folder).

  2. Verifique se o caminho de pesquisa (variável de ambiente $PATH) contém a pasta onde o binário do compilador TI CGT está localizado (por exemplo, C:\ti\ccs910\ccs\tools\compiler\ti-cgt-arm_18.12.2.LTS\bin).

    Se você estiver usando o compilador de TI ARM com sua placa TI, use o comando a seguir para gerar arquivos de compilação do código-fonte:

    cmake -DVENDOR=ti -DBOARD=cc3220_launchpad -DCOMPILER=arm-ti -S freertos -B build-folder

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

Solução de problemas

Se você não vir mensagens no cliente MQTT do console do AWS IoT, pode ser necessário definir configurações de depuração para a placa.

Para configurar as configurações de depuração para placas de TI
  1. No Code Composer, no Project Explorer, escolha aws_demos.

  2. No menu Run (Executar), escolha Debug Configurations (Configurações de depuração).

  3. No painel de navegação, selecione aws_demos.

  4. Na guia Target (Destino), em Connection Options (Opções de conexão), escolha Reset the target on a connect (Redefinir o destino em uma conexão).

  5. Escolha Aplicar e selecione Fechar.

Se essas etapas não funcionarem, verifique a saída do programa no terminal serial. Você deve ver um texto que indica a origem do problema.

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.