Eclipse + PlatformIO

Introdução

O PlatformIO é uma plataforma para o desenvolvimento de software destinado a várias arquiteturas e várias placas nomeadamente as ChipKIT UNO32 que usaremos nas aulas.

Uma das vantagens da utilização desta plataforma é a possibilidade de se usar as funções da biblioteca Arduino que começam a ser um autêntico standard no desenvolvimento de sistema baseados em microcontroladores.

Esta plataforma é usada em conjugação com um ambiente integrado de desenvolvimento (IDE). São vários os IDEs possíveis mas neste caso iremos usar o Eclipse tanto mais que é já do conhecimento da maioria dos estudantes.

Nesta página vamos descrever o processo de instalação e criação dum primeiro projeto usando o Eclipse + PlatformIO. Embora este exemplo seja feito no sistema operativo Windows, existe também a possibilidade de o fazermos noutros sistemas operativos como o OS X e Linux.

Instalação

O processo de instalação consiste nos seguintes passos:

  • Instalação do Eclipse IDE
  • Instalação do PlatformIO

Eclipse IDE

Porque o Eclipse IDE está escrito em Java um dos requisitos a satisfazer ainda antes da sua instalação é a instalação dum Java Runtime Environment (JRE). Para tal bastará executar o ficheiro jre-8u181-windows-x64.exe (ou outro mais recente) a obter daqui.

O Eclipse IDE (mais concretamente a sua versão para C/C++: Eclipse IDE for C/C++ Developers) pode ser obtido aqui, fazendo-se a sua instalação simplesmente descompactando o respetivo eclipse-cpp-2019-09-R-win32-x86_64.zip (ou outro mais recente) para dentro duma pasta.

PlatformIO

Porque o PlatformIO Core está escrito em Python é preciso começar por instalar o Python 2.7 (executando por exemplo o python-2.7.15.amd64.msi), não esquecendo de no processo de instalação selecionar a opção para adicionar a pasta de instalação (C:\Python27) ao PATH.

A instalação do PlatformIO faz-se executando o script get-platformio.py da linha de comando (por exemplo da PowerShell do Windows). Para tal será necessário executar o seguinte comando na pasta onde o script foi descarregado:

python.exe get-platformio.py

Criação dum projeto

Para criar um projeto Eclipse com o PlatformIO, fazer o seguinte:

  • File > New > Project… > General > Project > Next
  • Project name: blink
  • Use default location (workspace)
  • Next > Finish
  • Project Explorer > blink < Show in Local Terminal > Terminal
  • Para criar um projeto para a placa ChipKit UNO32, fazer:
    pio init --ide eclipse --board uno_pic32

    Nota: No caso do sistema operativo OSX, ver secção no final desta página.

  • Refrescar o projeto: Project Explorer > blink < Refresh
  • Criar na pasta src do projeto um ficheiro blink.cpp: New > Source File > Source file: blink.cpp > Finish
  • Copiar para esse ficheiro o código:
    #include <Arduino.h>
    
    #define LED 13
    
    void setup() {
      pinMode(LED, OUTPUT);
    }
    
    void loop() {
      digitalWrite(LED, true);
      delay(1000);
      digitalWrite(LED, false);
      delay(1000);
    }
  • Para compilar, carregar no botão “Build” ou duplo-click em Build Targets > PlatformIO: Build
  • Para programar a placa, fazer: Build Targets > PlatformIO: Upload
    blink_upload_platformio
  • Caso o porto COM não seja detetado, editar o ficheiro platformio.ini, com:
    upload_port = COMx

No final do processo, e face ao programa utilizado, o LED da placa ChipKIT irá piscar!