elua/doc/pt/installing_lm3s.html

$$HEADER$$
<h3>Usando <b>eLua</b> com as CPUs LM3S (Cortex-M3) da Luminary Micro</h3>
 <p><a href="http://www.luminarymicro.com">Luminary Micro</a> é a empresa que produziu a primeira implementação de silicone do mundo para o processador Cortex-M3. A relação de produtos da Luminary é bastante variada, que vão desde dispositivos relativamente simples até CPUs com recursos completos (com on-chip USB, EMAC, CAN, e muitos outros periféricos). O software que acompanha estes dispositivos também é muito bom, com drivers para todos os periféricos da CPU e aplicativos de terceiros. A algum tempo atrás, entramos em contato com a Luminary Micro, solicitando um apoio a este projeto através de um de seus kits de avaliação, a resposta foi excelente (obrigado mais uma vêz, Luminary!). Foi assim que uma <a href="http://www.luminarymicro.com/products/lm3s8962_can_ethernet_evaluation_kit.html">EKx-LM3S8962K</a> veio parar na minha mesa. Esta é a placa de desenvolvimento que eu vou usar neste tutorial. <b>eLua</b> também suporta a placa <a href="http://www.luminarymicro.com/products/ekk-lm3s6965_ethernet_evaluation_kit.html">EKx-LM3S6965</a> da Luminary (que pode ser programada exatamente como a EKX-LM3S8962) e a placa <a href="http://www.micromint.com/index.php/products/by-family/sbcs/77">Eagle 100</a> da <a href="http://www.micromint.com">Micromint</a>, que usa um procedimento de instalação diferente.
</p>
 <h3>Pré-requisitos</h3> 
 <p>Antes de começar a utilizar <b>eLua</b> com a CPU LM3S, certifique-se de que:</p>
 <ul>
 <li>você está usando Windows. Isso mesmo, eu disse <b>Windows</b>. O motivo é bastante simples: vamos utilizar as ferramentas da Luminary para gravar  <b>eLua</b> na placa, e estas são específicas para Windows. Este é o caso de muitas CPUs e fabricantes que existem por aí. Pode-se ter o Windows instalado no seu disco rígido, ou debaixo de emulador no Linux, não importa, caso você esteja bastante irritado, pode-se rodá-lo também a partir do <a href="http://www.winehq.org/">Wine</a>. Uso o XP, Vista deve funcionar também.</li>
 <li>você instalou o programa LM Flash Programmer da Luminary. Procure-o <a href="http://www.luminarymicro.com/products/ekk-lm3s8962_can_ethernet_evaluation_kit.html">nesta página</a>, por exemplo (o link está na guia "Software Updates").</li>
 <li>você já tem a imagem de <b>eLua</b> para a CPU LM3S8962 (<a href="building.html">gerada</a> ou <a href="downloads.html">baixada</a>).</li>
 </ul>
 <h3>Instalando <b>eLua</b> nas CPUs EKx-LM3S8962EK e EKx-LM3S6965</h3>
 <p>Felizmente, esta instalação está mais fácil do que nunca. Uma das coisas agradáveis sobre esses dois kits é que eles usam a porta USB on-board, tanto para baixar o firmware quanto para emular uma porta serial (através de um conversor USB/UART, sendo assim, você não precisa de nenhum software especial para a CPU ter acesso a essa porta UART). Além disso, a placa sabe automaticamente como (e quando) alternar entre o modo de download do firmware para o modo de emulação UART, assim você não precisa trocar jumpers de lá para cá, ou qualquer coisa assim. O esforço de atualização do firmware é nenhum mesmo. Então, vamos fazê-lo:</p>
 <ul>
 <li>conecte sua board no seu PC usando um cabo USB. Caso não tenha instalado ainda os drivers, você será solicitado a fazê-lo neste momento.</li>
 <li>se você já estiver usando a conexão USB na placa no modo de emulação UART, feche o programa do terminal (ou, pelo menos, desconecte-o da porta USB).</li>
 <li>inicie a aplicação "Luminary Micro Flash programmer".</li>
 <li>na guia "Configuração", selecione "LM3S8962 Ethernet and CAN Evaluation board" ou "LM3S6965 Ethernet Evaluation Board" (dependendo da placa).</li>
 <li>na guia "Programa", selecione o arquivo <b>eLua</b>.bin que você gerou na etapa de compilação.</li>
 <li>selecione as "opções" da maneira que achar melhor (geralmente escolho "Erase entire flash" e "Reset MCU after program").</li>
 <li>pressione o botão "Program".</li>
 <li>espere até que a gravação tenha terminado, em seguida, saia do aplicativo.</li>
 </ul>
<p>Vale a pena mencionar que uma vez que essas placas vem com um conversor USB JTAG, deve ser possível usar o OpenOCD (ou um pacote similar) em vez do programa da  Luminary para gravar a imagem de <b>eLua</b>. Os fóruns da Luminary Micro são um bom lugar para procurar informações, se você está explorando a opção OpenOCD.</p>
<h3>Instalando eLua na Eagle 100</h3>
<p>A placa Eagle 100 também pode ser programada via JTAG, mas não inclui um adaptador USB para JTAG onboard, assim você precisará de um adaptador externo, se você pretende utilizar JTAG para programação. Felizmente, ele também vem com um carregador Ethernet, assim você pode carregar a sua imagem através da Ethernet. O único requisito para utilizar o bootloader é para iniciar a sua imagem no endereço 0x2000 em vez do 0x0 de costume, já que é onde ficam os jumpers do bootloader. O <a href="building.html">sistema de geração do eLua</a> faz isso automaticamente se a placa "= eagle-100" parâmetro é dado em tempo de compilação. Para uma descrição completa do bootloader Ethernet consulte o <a href="http://www.micromint.com/index.php/products/by-family/sbcs/54/118">manual da placa Eagle 100</a>, ou (mais especificamente) <a href="http://www.micromint.com/index.php/products/by-family/sbcs/54/122">neste link</a> (procure pela seção 2.7, <b>atualizações do firmware usando o gerenciador de inicialização Ethernet</b>).<br>
Você ainda precisa do programa Flash LM para usar o bootloader Ethernet, mas desde que a placa pode utilizar JTAG para fazer upload do firmware, deve ser possível usá-lo com OpenOCD (ou com um pacote similar) e um adaptador USB externo JTAG. Os fóruns da Luminary Micro são um bom lugar para procurar informações, se você está explorando a opção OpenOCD.</p>
$$FOOTER$$