= Herramientas de Programación y Depurado =

El proyecto ''GNU-ARM toolchain'' es el compilado de las herramientas tradicionales del ''GNU toolchain'' configuradas para generar o reconocer código ARM.

Esto significa que dentro de todos los proyectos que integran el ''GNU toolchain'' ya se encuentran lo necesario para generar la herramienta ''GNU-ARM'' específica.
El mantenimiento y mejoras de la "porción ARM" que tienen estas herramientas, está realizada por comunidades en general auspiciadas por ARM Holdings plc.

Estas mismas comunidades realizan Pre-built que se pueden bajar de paginas específicas y que libera a los usuarios del tedioso proceso de bajar cada herramienta (gcc, ld, gdb, etc) y realizar el compilado de las mismas para ARM.
El proyecto de estas ''GNU-ARM toolchain'' es el siguiente          

https://launchpad.net/gcc-arm-embedded/

Dentro de esta misma página, se puede encontrar un link a un proyecto para Ubuntu, él cual permite una fácil instalación y actualización de mismo, al agregar un repositorio especifico para luego instalar y mantener el proyecto con las herramientas de administración de paquetes de Ubuntu. 

https://launchpad.net/~team-gcc-arm-embedded/+archive/ubuntu/ppa

En este último se encuentra un instructivo para instalar las herramientas.

Estos pasos se pueden resumir de la siguiente manera 
   * Paso 1: Agregar el repositorio al directorio source.list.d, para ello se abre una terminal y se ingresa  
{{{
sudo add-apt-repository ppa:team-gcc-arm-embedded/ppa
}}}
   * Paso 2: Se actualiza el repositorio ingresando
{{{
sudo apt-get update
}}}
   * Paso 3: Se instala el "toolchain" escribiendo
{{{ 
sudo apt-get install gcc-arm-embedded
}}}
  
=== Instalación del depurador ===

La aplicación para depurar un proyecto es el GDB, herramienta utilizada en cualquier proyecto GNU, pero en este caso compilado para depurar código ARM.

Si bien el depurador está preparado para depurar programas en ARM, el problema es que este programa debe correr primero en una arquitectura ARM, para esto tenemos dos soluciones:
    * Simulación: un núcleo ARM es simulado por el propio GDB y allí corre nuestra aplicación.
    * La aplicación corre en un hardware (una placa externa) y se depura por una conexión remota (In-Circuit Debugging) 
Para los ejemplos y primeras pruebas en ensamblador utilizaremos la primera solución, el problema es que por ser utilizada con fines académico no está disponible en las últimas versiones del GDB para ARM, deberemos entonces usar una versión anterior cuando se quiera usar esta característica

   * Bajar versión anterior de GDB (64bits)
[[attachment:arm-old-gdb]]

   * Copiar este archivo al directorio donde se instaló el GNU ARM (/usr/bin)
Posicionado sobre el directorio donde bajamos el archivo hacemos 

{{{
sudo cp arm-old-gdb /usr/bin
}}} 
   * Dar permisos de ejecución al achivo copiado
{{{
sudo chmod +x /usr/bin/arm-old-gdb
}}}

  

##Bajar el siguiente paquete 
## [[attachment:gdb-arm-none-eabi_7.6.50.20131218-0ubuntu1+1_i386.deb]]
##o para el caso de 64 bits
## [[attachment:gdb-arm-none-eabi_7.7.1+dfsg-1+6_amd64.deb]]

##luego en una consola, ejecutar 
##{{{
## sudo dpkg -i --force-overwrite Descargas/gdb-arm-none-eabi_7.6.50.20131218-0ubuntu1+1_i386.deb
##}}}
##esta linea supone que el archivo se descargó en el directorio "Descargas", de no ser así modificar la ruta 


Una vez instalado el paquete, se tendrá todas las herramientas GNU para ARM identificadas con el prefijo '''arm-none-eabi-''' y el depurador '''arm-old-gdb''' solo para el caso de necesitar el simulador 

== DEBUG ==

Para realizar un debug se procede de la siguiente manera

Se debe ejecutar 
{{{ 
arm-old-gdb --tui
}}}
luego dentro de este programa se escribe
{{{
target sim
load {archivo .elf a depurar}
file
list
}}}
Aparecerá en una ventana el fuente a depurar, escribiendo 
{{{ break nn}}} 
se hace un break point (nn es el numero de linea que te aparece al costado izquierdo del archivo fuente)
un tutorial de la herramienta se puede ver en 

 http://sourceware.org/gdb/onlinedocs/gdb/TUI.html

##== Proyecto CIAA ==

##La Cátedra utiliza para el desarrollo de los diferentes prácticos una placa EDU-CIAA

##Esta placa pertenece al proyecto CIAA (Computadora Industrial Abierta Argentina), si desean conocer mas sobre este proyecto, pueden entrar a la página del mismo

##http://www.proyecto-ciaa.com.ar/

##Para la instalación del IDE y de las demás herramientas necesarias seguir los siguientes pasos 

##=== Instalación del IDE para la placa de desarrollo EDU-CIAA ===

##Una vez instalado las herramientas de programación, se continua con los siguientes pasos 

##==== OpenOCD ====
##Es la herramienta requerida para hacer el puente entre la placa y el depurador.
 
##En las versiones mas nuevas de Ubuntu, ya viene disponible para instalarlo desde los repositorios junto con las librerías para el manejo del USB.

##{{{ sudo apt-get install openocd }}}

##Luego es necesario darles los permisos, bajamos el siguiente archivo:

##[[attachment:99-openocd.rules]]

##y desde una consola y sobre el directorio donde bajamos el archivo, se escribe:

##{{{ sudo cp 99-openocd.rules /etc/udev/rules.d/ }}}

##Finalmente para que el OpenOCD tenga permiso desde el usuario a acceder al USB, debemos hacer 

##{{{ sudo useradd -plugdev USERNAME }}} 

##Donde {{{USERNAME}}} es el nombre del usuario 

##==== Eclipse ====

##En primer lugar, antes de instalar eclipse se debe instalar Java 

##{{{ sudo aptitude install default-jdk }}}

##Luego se baja el paquete Eclipse desde este link 

##https://github.com/gnu-mcu-eclipse/org.eclipse.epp.packages/releases/

##el paquete se descomprime en una carpeta y ya es suficiente para comenzar a usarlo 

  
##==== Firmware ====

##El archivo adjunto contiene el proyecto de firmware, donde se cambiaron algunas configuraciones para ser mas sencillo su uso en modo '''baremetal'''

##[[attachment:Firmware_td2.tar.gz]]