A IDE é bem amigável para os programadores casuais e permite escrever programas simples sem muito esforço. Ao primeiro olhar, pode parecer que uma versão não padrão de C/C++ é usada, mas isto se deve ao fato da IDE adicionar headers e a função main() para você automaticamente no momento em que você clica em Upload. Me parece que você pode ter apenas um arquivo de código fonte por projeto, o que é razoável para coisas não muito complexas.

Para aqueles que desejam desenvolver de maneira tradicional usando linha de comando, eu criei este template baseado em CMake para o Arduino Uno. Ele foi feito de tal forma que possibilita adicionar suporte a outros modelos de Arduino apenas criando um novo arquivo com as configurações do hardware. Não há restrição de uso deste template em outras distribuições Linux (nem mesmo em outros sistemas operacionais, uma vez que o CMake roda em Mac e Windows também), mas claro que modificações podem ser necessárias. Patches são sempre bem-vindos.

Usando o template CMake para Arduino

Você vai precisar, claro, dos pacotes do cmake instalados e uma versão compatível do SDK do Arduino (veja acima como resolver esta questão Ubuntu Maverick x Uno). Apenas o pacote arduino-core é necessário para rodar este template.

Faça download da última versão aqui:

arduino_cmake.tar.gz

Esta é uma versão modificada do exemplo clássico chamado Blink, convertido em C/C++ padrão (é estranho o fato das bibliotecas do Arduino serem escritas em uma mistura de C e C++ e não apenas C). Este exemplo é bacana porque lhe dá uma resposta visual sem ser necessário espetar algum componente extra na placa. Parece que quase todas as vesões do Arduino possuem um LED embutido ligado ao pino 13. Como o cmake não é tão conhecido (o que é uma pena por ser uma ferramente excelente), segue as instruções de como compilar o exemplo:

$ mkdir build
$ cd build
$ cmake ..
$ make

Você pode exportar a variaǘel de ambiente ARDUINO_PORT ou editar o arquivo CMakeLists.txt para alterar a porta no qual seu dispositivo está conectado. Provavelmente você não vai precisar mexer nisso se estiver usando o combo Ubuntu Maverick e Arduino Uno.

Dois targets extras foram adicionados ao Makefile para tornar as coisas mais fáceis:

• make flash – Vai “flashar” (gravar o software) na hardware conectado em ARDUINO_PORT.
• make reset – Reinicia o hardware (mais ou menos o mesmo que apertar o botão de reset na placa).

Dicas

Minha forma predileta de depuração de software é usando printf(). A versão modificada do Blink que está sendo usada no template contém algumas mensagens de debug nesta forma. Use o minicom para ver estas mensagens pelo terminal:

$ minicom -b 115200 -D /dev/ttyACM0

Você precisa sair do minicom antes de “flashar” o hardware novamente. Faça isso usando CTRL+A e depois X.

Aviso

Ao seguir este tutorial e usar o template do buildsystem, você pode potencialmente destruir seu Arduino e transformá-lo em um peso de papel (não muito bom, uma vez que ele é bem leve). Você está assumindo este risco, eu não me responsabilizo por nada.

Shadow build – Chega de repositórios sujos após uma compilação. Compilar seu código dentro do repositório é opcional, você precisa apenas criar um diretório qualquer fora da sua árvore e chamar o script de configuração do seu projeto (configure). Existem várias situações onde isto é especialmente necessário: compilar a mesma árvore de código para diferentes plataformas ou quando seu código fonte está localizado em um storage lento (como um compartilhamento de rede ou uma partição criptografada).

Integração com testes automatizados – Desenvolvimento orientado a testes tem sido cada vez mais comum e provou ser uma importante ferramenta para detectar regressões. Este template provê mais do que um modo fácil de rodar seus testes (digitando “make check”), mas um relatório gráfico mostrando quão abrangentes seus testes são usando LCOV.

LCOV mostrando a cobertura dos unit tests

Documentação de código – Desenvolvedores em geral são preguiçosos se tratando de escrever documentos, a não ser que você lhes dê uma forma fácil de ver o o belo resultado de uma documentação bem escrita. Após digitar “make doc”, uma página HTML é automaticamente gerada agrupando toda a informação extraídas dos markups qdoc3 do seu código fonte.

Documentação extraída da classe Foobar

Internacionalização – Um buildsystem moderno precisa prover um jeito fácil para os tradutores atualizarem os arquivos de tradução. Precisamos ter em mente que tradutores não são necessariamente desenvolvedores e eles podem não gostar de ter que vasculhar o código fonte em busca de strings para tradução. Este template fornece uma integração com lupdate e lrelease – ferramentas i18n do Qt – criando todos os aquivos .ts necessários ao Qt Linguist.

Use o Qt Linguist para editar os arquivos de tradução

Fácil depuração – É meio óbvio que um buildsystem também deve gerar uma versão do software especial para depuração. Você também não precisa instalar esta versão no sistema para fazer testes (pelo menos no Linux).

Empacotamento – Seu software precisa ser de fácil distribuição. Adicionamos o suporte a empacotamento para Debian como exemplo neste template para demonstrar como é fácil fazer um pacote baseado neste buildsystem. Alguém anima contribuir com o empacotamento RPM?

Considerações finais

Só fiz testes deste template no Linux. Infelizmente algumas features só vão funcionar se você estiver usando GCC, como por exemplo a cobertura de código dos testes automatizados.

A última versão para download está disponível aqui. Você também pode navegar pelo repositório git do template. Lembre-se: patches e sugestões são sempre bem-vindos.

Mais instruções de uso (em inglês) no aquivo BUILD.

Se você é corajoso, compile seu próprio pacote com estes patches aqui.

Neste tutorial explico como configurar um repositório Git no DreamHost, inclusive com o Gitweb ativado. Você terá acesso de commit no seu repositório usando SSH e ele estara publicamente disponível para ser clonado via HTTP (uma vez que não temos o git-daemon rodando).

Aviso que o objetivo aqui não é ensinar a usar o Git, e sim, ensinar como publicar um repositório no DreamHost.

Preparando um hostname

Seu repositório Git pode ser instalado em qualquer um de seus sites hospedados no DreamHost. Preferi criar um sub-domínio exclusivo para isolar o conteúdo e facilitar meu gerenciamento.

Atualizando o Git

Neste momento, a versão instalada nos servidores do DreamHost é a 1.5.6.5. Achei prudente atualizar para uma versão >= 1.6 na tentativa de manter a compatibilidade com a versão do Git que acompanha as distros mais recentes (ex. Ubuntu Jaunty).

Acesse sua conta no DreamHost via SSH e faça download da última versão estável do Git. Algumas coisas devem ser observadas antes de instalar:

• Não é necessário a dependência da libcurl, uma vez que só vamos hospedar o repositório.
• Devemos desativar o mmap(2) para o DreamHost não achar que o Git está consumindo muita memória e matar o processo.
• Os arquivos devem ser instalados dentro de /home/$USER/packages. Este diretório é correto para instalações de software do usuário no DreamHost. O /home/$USER/packages/bin inclusive já está na sua variável de ambiente $PATH por padrão.

Portanto, após descompactar o código fonte, atente-se para rodar o script de configuração com as seguintes opções (o restante da instalação é convencional):

$ ./configure --prefix=/home/$USER/packages NO_CURL=1 NO_MMAP=1

Criando o repositório

Como criei um sub-domínio para meus repositórios, a raíz do meu domínio está em /home/$USER/git.example.com. Dentro deste diretório,  crie seu repositório:

$ mkdir test.git
$ cd test.git
$ git init --bare

Edite o arquivo description com algo relevante para aparecer no Gitweb. Por se tratar de um repositório que será clonado via HTTP, é necessário ativar um hook a ser executado após cada commit. Este hook atualiza algumas informações necessárias para clonar o repositório que convecionalmente é feito pelo git-daemon.

$ mv hooks/post-update.sample hooks/post-update

Na sua máquina local, dentro de um repositório Git válido já com alguns commits, adicione o seu repositório remoto (usei o nome “public” no exemplo). Em seguida faça o push para criar o branch master:

$ git remote add public ssh://username@example.com/home/username/git.example.com/test.git
$ git push public master

Caso não queira passar pela amolação de digitar senha a todo momento para atualizar o repositório, copie sua chave para o servidor remoto.

Quem quiser clonar o seu repositório público o fará via HTTP pelo comando a seguir:

$ git clone http://git.example.com/test.git

Instalando o Gitweb

Para usar o Gitweb, você precisa ter o suport a CGI ativado no DreamHost, como normalmente se tem por padrão. Copie o conteúdo da pasta gitweb que acompanha o tarball do Git para qualquer lugar acessível externamente (exemplo: crie a pasta cgi-bin/ e mova o arquivo para lá para termos http://git.example.com/cgi-bin/gitweb.cgi).

Nesta pasta, crie o arquivo gitweb_config.perl com o seguinte conteúdo:

$GIT = "/home/USERNAME/packages/bin/git";
$projectroot = "/home/USERNAME/git.example.com/";
$home_link_str = "http://git.example.com";

@stylesheets = ("gitweb.css");

$logo = "git-logo.png";
$favicon = "git-favicon.png";
$site_name = "git repositories";

Polindo a instalação

Desativei o directory listing que é comportamento padrão editando o arquivo .htaccess e acrescentando a seguinte linha:

Options -Indexes

Recomendo também criar um arquivo index.php que redirecione os acessos a http://git.example.com para o Gitweb:

<?php
header("location:http://git.example.com/cgi-bin/gitweb.cgi");
?>

Considerações finais

Este material foi fortemente baseado no conteúdo citado nas referências. É basicamente uma compilação atualizada das melhores partes com alguns poucos toques pessoais.

Por fim, sugiro que você, dono de uma conta no DreamHost, vote para que a equipe técnica que administra os servidores, proveja suporte nativo.

Referências:

• DreamHost Wiki
• Autopragmatic
• Craig Jolicoeur

Aproveito para agradecer a atenção e participação dos presentes.

Foto do workshop de D-Bus tirada do celular do Daniel Elias.

A extensão do VIM chamada  Omni Completion fazia a mesma coisa de forma satisfatória quando usando C, mas o fato é que nunca me acostumei a usar isso: ctags + rápida olhada nos headers eram o suficiente até então, mas foi quando o Qt e suas classes com milhões de atributos e métodos chegaram na minha vida. Hoje, enquanto queimava uns neurônios tentando lembrar o nome de um método da classe QSomething eu tive a brilhante idéia de usar  auto-completion do VIM (porque não?). Decepcionado, descobri que o Omni Completion não suporta C++ nativamente.

O Oráculo me disse algo a respeito de um add-on chamado OmniCppComplete. Poucos minutos foram o suficiente para instalar e ver quão legal é o plugin. Apenas o pop-up automático sugerindo nome de atributos que é irritante, mas pode-se facilmente desabilitá-lo e usar o bom e velho ^X^O sob demanda.

É claro que não há nada novo aqui (a primeira versão do OmniCpp data de 2006), mas você pode ser como eu, receoso em relação a testar novos add-ons do VIM, porque a maioria é lixo. Apenas poucos merecem a honra de estar no meu .vimrc. Este post portanto é para encorajar usuários do VIM a dar uma chance ao OmniCpp e se tornar mais efetivo.

OmniCppComplete em ação