[Basics] Getting Started


#1

#Bienvenido al tutorial virtual de Aquila.

Primero que nada gracias por elegir la plataforma Aquila para desarrollar, estamos seguros que la vas a pasar excelente aprendiendo en esta potente y versátil plataforma.
En este tutorial, que estará dividido en varias partes, aprenderás todo lo necesario sobre la plataforma Aquila y sobre la placa de desarrollo Altair.
Se intentará explicar todos y cada uno de los aspectos más relevantes de la materia, así como los que causan más confusión en los desarrolladores, aunque en este se comenzará por todo lo básico, así que ¡empecemos!

##“What’s in the box?”

En este momento, estarás viendo una caja así en tus manos (o junto a tu computadora). Dentro, se encuentra toda la magia.

Abajo e izquierda: Altair; Derecha: Programador USB; Arriba: Extensión cable USB (Hembra-Macho).

Esto es un Altair, en esta pequeña placa cargarás todos tus proyectos, conectarás sensores, cables. Será el cerebro de todos tus prototipos, lo presumirás al mundo y estarás muy orgulloso de todas tus creaciones. (Te invito a revisar su datasheet -> https://github.com/makerlabmx/altair-hardware/blob/master/Altair-Datasheet-ES.pdf)

Este es el programador USB, lo necesitarás para poder conectar el puerto USB de tu computadora al Altair y así pasar todas tus ideas plasmadas en código al Altair. (Y su datasheet -> https://github.com/makerlabmx/usb-serial-hardware/blob/master/USB-Serial-Datasheet-ES.pdf)

Este es un cable USB Hembra-Macho, a pesar de que puedes conectar el Altair directamente al puerto de la máquina, en algunos cosas es más práctico simplemente enviar el nuevo código sin desconectar el meticuloso cableado que tengas. Por eso se entrega esta extensión de USB. ¡Te va a facilitar la vida muchísimo!

##Instalando y Conectando

Ya conoces el hardware inicial para comenzar a trabajar, ahora hace falta hacer la configuración requerida para poder echar a andar todo el sistema.

###Nuevo INSTALLER del Software de Aquila.
Sigue el siguiente link para llevar a acabo la instalación sencilla. (Para Windows)
No obstante, también se encuentran las instrucciones para Linux y OSX.
Instalador Rapido Windows, Instrucciones Linux/OSX
Te podrás saltar la mayor parte de los pasos de este tutorial, no obstante recomiendo que leas del paso 4, 5, 8 y 9. El instalador que ahí encontrarás hará todo el trabajo sucio. Esperamos te facilite mucho la vida mientras te ahorra mucho tiempo.
De cualquier forma, si prefieres instalar todo manualmente los pasos los puedes seguir.

Paso 1: Instalar el IDE de Arduino; debes fijarte que estés instalando la versión 1.5.7+ (al día de hoy puedes ya bajar la 1.5.8; esta versión sólo se consigue en BETA en la misma página de descarga sólo que un poco más abajo). Asegúrate de estar bajando la versión que corresponda a la cantidad de BITS* de tu sistema 32/64 o podrías tener problemas. (Sólo aplica para Linux)

Paso 2: Ahora falta descargar la información del Hardware del Altair de modo que el IDE de Arduino lo reconozca (así como también muestre ejemplos que funcionen para él)
Puedes hacerlo desde aquí -> https://github.com/makerlabmx/altair-arduinoide
(El botón de descarga está del lado derecho, Download as ZIP)
Deja el ZIP en tu carpeta de descargas por el momento.

Paso 3: Necesitarás ejecutar al menos una vez el IDE de Arduino y LO CIERRAS. Acto seguido, descomprimirás el ZIP que acabas de descargar, el contenido lo pondrás en C > Documentos > Arduino > hardware.
(en caso de que no se haya creado la carpeta Hardware, deberás crearla)

Paso 4: La manera de revisar de que todo esté hecho bien hasta ahora es, abriendo el IDE y revisando en el Herramientas> Placa… ahí debería aparecer Altair (posiblemente hasta abajo o hasta arriba). Selecciónalo.

Paso 5 (TIP): Como un paso extra (para facilitar la vida) revisen rápidamente bajo el menú “Herramientas” el apartado de “Port” (o Puerto), sólo vean qué aparece. Más adelante lo revisaremos de nuevo. (Ojo que el Altair hasta este punto debe estar desconectado).

Paso 6: Antes de seguir adelante, necesitarán instalar un driver para USB, lo encuentran en esta página. Sólo eligan el que corresponda a su OS y sigan adelante. No les debería llevar nada de tiempo.
http://www.ftdichip.com/Drivers/VCP.htm

Paso 7: Ahora, se conecta del puerto USB de tu máquina al cable y la punta hembra del cable al Programador USB. Después, conectar el Programador USB al Altair es sencillo, simplemente verifica que en ambos el logo de Makerlab esté hacia abajo. Alinea los 6 pines y conecta hasta el fondo.

Paso 8: Ya que todo está conectado, el IDE sabe que trabajaremos con un Altair (porque lo seleccionamos en el paso 4), ahora debemos decirle en qué puerto está conectado el Altair. De nuevo irán a Herramientas > Puerto; ahí deberías de ver que hay un elemento más en la lista. Selecciónalo. (Quizá debas esperar unos segundos en lo que Windows reconoce el Altair para que aparezca entre los Puertos, puede que demore un poco.)

Paso 9: Listo! Si todo ha sido seguido al pie de la letra, tanto la computadora como el Altair deberían estar listos para comenzar a prototipar. Te recomiendo comiences por cargar los ejemplos de Altair y te vayas familiarizando con la sintaxis del lenguaje. (Estos los encuentras en Archivo > Ejemplos.

####¡En los siguientes tutoriales explicaré los ejemplos para que no haya pierde con nada!
Y por último, ¡No olvides preguntar para ir resolviendo las dudas que tengas! :smile:


Recursos para Aquila (Documentación, código, etc.)
[Basics] Curso de Aquila - Día 1