MSP430 Lab 02 Criar e Compilar um projeto Software CCS Neste post iremos criar um novo projeto utilizando a IDE CCS da Texas Instruments, compilar o código feito em linguagem C e fazer o Debug da aplicação utilizando a mesma ferramenta. Introdução A sigla IDE significa Ambiente de Desenvolvimento Integrado (Integrated Development Environment) e contém todas as ferramentas necessárias para desenvolver projetos embarcados (Compilador, Simulador, Editor, Debug, OS e outros). A interface de programação do CCS suporta dois modos de operação sendo eles o simples, com funcionalidades básicas de edição/compilação e menus com poucos itens, e o modo avançado onde à opção de integrar aplicativos à IDE além de menus e janelas mais versáteis e complexas. O usuário pode alterar entre os dois modos a qualquer momento acessando o menu de opções da IDE. A área de trabalho do CCS (Workspace) segue o mesmo padrão de
interfaces já conhecidas como MPLAB-X da Microchip, o Code Warrior da Freescale dentre outras, onde a barra lateral à esquerda contém a arvore dos projetos. Na figura abaixo, observamos a hierarquia de organização dos projetos alocados na área de trabalho do CCS. Hierarquia CCS Iniciando o CCS e o Workspace A criação de um novo projeto utilizando o CCS é feita de forma fácil e intuitiva, utilizando o Project Wizard, configurando os dados do projeto em apenas uma janela. Inicie o Code Composer Studio e abra o Workspace.
Iniciando o CCS Quando o CCS carregar, uma janela de diálogo irá abrir indicando a localização da pasta workspace. Encontre o local onde o seu projeto deverá ser salvo. Se deseja que esta seja a pasta permanente, marque a opção Use this as the default. Clique em OK. Esta pasta contém todas as configurações padrões do CCS incluindo as do projeto e janelas quando a IDE é fechado, logo as mesmas configurações vão estar disponíveis quando o software for aberto novamente. Ative a licença. Configurações de licença Na primeira vez que o CCS é aberto, a janela License Setup Wizard deve aparece. Caso você já iniciou o CCS
anteriormente e fez a opção errada, basta ir no menu Help -> Code Composer Studio Licensing Information e clicar na aba Upgrade e no botão Launch License Setup -> selecione o botão CODE SIZE LIMITED e clique Finish, como pode ser observado na figura acima. Se você planeja trabalhar somente com a linha LaunchPad, a limitação de código para a versão Free do CCS (16 KB) não será um problema pois estes microcontroladores suportam exatamente 16 KB de memória Flash. Aguarde até que a janela CCS workbench abra. Janela de trabalho do software O termo workbench se refere a Desktop do Ambiente de desenvolvimento (desktop development environment) ou mesa de trabalho em tradução livre. A workbench irá abrir na visualização CCS Edit como observado no canto superior direito da imagem acima e esta visualização é usada para criar ou montar projetos em C/C++. A
aba referente à CCS Debug é automaticamente habilitada quando a sessão de debug é iniciada. Esta janela é utilizada para analisar o projeto quanto à valores das variáveis, contador de programa, registradores e muito mais. Criando um novo projeto Um projeto contém todos os arquivos necessários para gerar o arquivo de saída (.out) e o binário que será executado no hardware do MSP430. Para criar um novo projeto clique em: File -> New -> CCS Project
CCS new project Nesta janela, nomeie o projeto e escolha o modelo do microcontrolador. Mantenha as opções como mostrado na figura acima para a placa LaunchPad. Não se esqueça de clicar em Empty Project (with main.c) para um básico template de edição ser adicionado. Clique em Finish. O software adicionará o projeto ao workspace e irá mostrá-lo no painel lateral esquerdo (Project Explorer). Abra o arquivo main.c para edição. Editar, compilar e Debug do algorítmo [crayon-5a7b2fa290abc798349876/] Questões como registradores específicos do microcontrolador, timer e outros serão discutidos em laboratórios posteriores a este. Clique no botão salvar, localizado na barra superior, como observado na figura abaixo. Botão salvar projeto
Clique no botão Debug. Botão de debug Após salvar, clique no botão Debug. O programa será compilado, a janela de debug perspective view será aberta e o mesmo será carregado na memória Flash do microcontrolador automaticamente se não houver nenhum erro. Quando o download do executável para a memória Flash do microcontrolador completar, a janela Debug perspective irá abrir e será nela que iremos trabalhar a partir de agora.
Área de debug do software A confirmação de onde estamos pode ser observado na aba no canto superior direito da tela, como observado na figura abaixo. Janela de debug Neste ponto de nossa prática, o programa já está carregado
dentro da Flash do microcontrolador, porém ainda não estamos vendo o Led piscar. Se observamos na janela principal, há uma pequena seta azul apontando para a função main(). Esta seta indica para onde o contador do programa (Program Counter PC) está apontando. Clique no batão Resume para executar o código. Botão de início executar o firmware Neste momento, o led vermelho (Figura abaixo) deverá piscar em uma frequência de 4 Hz.
Posição do LED em teste Quando clicamos no botão Suspend, a seta azul, localizada ao lado dos números das linhas do programa na janela main.c, deve parar em alguma parte do código, pois estamos interrompendo a execução e não especificamos o local exato do apontador. Botão para parar a execução do firmware Se clicarmos no Suspend, as opções step into, step over e step return estarão abertas para o nosso uso.
Opçoes de debug Estas funções sevem para navegar dentro da execução do programa e é ilustrado pela seta azul. Provavelmente, o programa que estamos executando deve parar no final da função do while. Se observarmos na aba variables (Lateral superior direita), teremos o valor da variável i declarada para armazenar a contagem da temporização entre o led aceso e apagado. Janela com valores de registradores e variáveis Clicando no botão Step Into a seta azul (Figura abaixo) deve se posicionar no laço do while. Se clicarmos novamente, a seta deve ir para o final do looping e clicando mais uma vez ela volta para o laço do while. Este ciclo irá ocorrer ate que a variável i tenha o seu valor totalmente decrementado. O valor da variável é observado como descrito acima.
Posição do ponteiro do Program Counter Para terminar o modo Debug basta apertar o botão Terminate (Figura abaixo). A janela irá fechar automaticamente e o software irá abrir o CCS Edit. Deste modo, podemos criar, editar e alterar o algorítmo novamente. Botão para terminar a execução e voltar ao Edit Window Conclusão Neste segundo post descrevemos como criar, editar, compilar e analisar um projeto utilizando a IDE CCS. Como observamos, todo o processo é feito de forma clara e podemos afirmar que o
CCS é uma das interfaces mais poderosas e completas para o desenvolvimento de aplicações embarcadas para microcontroladores, e no caso da Launchpad, não apresenta nenhuma restrição por estar na versão Free.