LibIris

Contenido

1 Introducción
2 Características
3 Utilización del libIris
4 Ejemplo libIrisExample.py
- 4.1 Ejemplos en Linux
  - 4.1.1 Descarga del fichero ledp.hex
  - 4.1.2 Descarga del servidor servos8
- 4.2 Ejemplos en Windows
5 Descargas
- 5.1 Versión 1.0
6 Cambios
7 Acceso al repositorio

Introducción

LibIris es la librería en python para descarga de programas en la tarjeta Skypic. Implementa el protocolo del PIC_Bootloader. Además, permite cargar directamente los servidores del Proyecto Stargate. Este libreria permite implementar fácilmente aplicaciones de usuario en las que sea necesario descargar programas en la Skypic.
Un ejemplo es el programa Iris que tiene una interfaz gráfica para la descarga de programas. Está basado en la libIris.
El nombre Iris viene de la película Stargate, donde se colocaba el Iris como 'interfaz' con la puerta Stargate.

Características

Descarga de programas en la Skypic a través del PIC_Bootloader
Descarga de los servidores del proyecto Stargate
Lenguaje: Python
Multiplataforma: Linux y Windows
Licencia: GPL
Autor:
- Rafael Treviño, (c) 2007 : Creación de la librería.

Utilización del libIris

LibIris es una librería muy sencilla de utilizar. Para utilizarla basta con importar la librería, crear una instancia (pasándole el dispositivo serie) y usar el método 'download':

import libIris 

iris = libIris.Iris(serialName)
try:
  iris.download (file)
except:
  print 'Download failed.'

serialName es el nombre del dispositivo serie
file es una cadena que indica el objeto a descargar. Se puede especificar de tres formas:
- Mediante el nombre y ruta del fichero .hex.
- URL del fichero. Ej. http://mi_dominio.com/firmware.hex
- Nombre del servidor Stargate a descargar: sg-picp, sg-generic, sg-servos8, sg-null, sg-echo

Ejemplo libIrisExample.py

Con las fuentes del programa se incluye el ejemplo libIrisExample.py que es permite descargar fichero .hex en la Skypic mediante la línea de comandos.

Ejemplos en Linux

Descarga del fichero ledp.hex

Para hacer esta prueba primero será necesario bajarse el fichero ledp.hex a un directorio local y luego ejecutar:

$ python libIrisExample.py ledp.hex /dev/ttyUSB0
Stargate Iris 1.0. Download programs to Skypic board.
GPL license 

File: "ledp.hex"
Serial port: /dev/ttyUSB0 

File "ledp.hex" opened.
Serial port /dev/ttyUSB0 opened.
Identifing bootloader. (press skypic reset button if hangs)
Writing... OK
Activating program... OK

Descarga del servidor servos8

Para grabar el servidor Servos8 y poder así mover servos con la Skypic hay que ejecutar el comando:

$ python libIrisExample.py sg-servos8 /dev/ttyUSB0
Stargate Iris 1.0. Download programs to Skypic board.
GPL license 

File: "sg-servos8"
Serial port: /dev/ttyUSB0 

File from "http://www.iearobotics.com/proyectos/stargate/servidores/sg-servos8/download/sg-servos8-pic16f876-skypic.hex" opened.
Serial port /dev/ttyUSB0 opened.
Identifing bootloader. (press skypic reset button if hangs)
Writing... OK
Activating program... OK

Automáticamente se baja el servidor de internet y lo descarga en la Skypic

Ejemplos en Windows

Por hacer

Descargas

Versión 1.0

Fichero	Descripción
Archivo:LibIris-1.0.tgz	Librería libIris.

Cambios

2/Sep/2007: La versión 1.0 está obsoleta. Se ha llevado a esta página: Libiris-1.0
Publicación de la version 1.0

Acceso al repositorio

SVN del proyecto: http://svn.iearobotics.com/libIris/
La última versión se puede obtener así:

svn co http://svn.iearobotics.com/libIris/