Documentación software de las utilidades DOMOUTILS

Transcripción

1 Documentación software de las utilidades DOMOUTILS Félix Villanueva Francisco Moya Juan Carlos López 10 de mayo de 2001 Id: domobox-ref-utils.ltx,v /05/10 18:49:10 paco Exp

2 Índice General 1 Introducción 3 2 UTILIDAD DOMO Introducción Comandos de la utilidad DOMO comando domo comando domo comando xmit comando rcv comando write-file comando read-file comando load-mem comando save-mem comando put comando get comando skip Implementación de la utilidad DOMO descripción de funciones UTILIDAD PRG Implementación de la utilidad DOMO UTILIDAD DUMP Implementación de la utilidad DUMP UTILIDAD HEX implementación de la utilidad hex UTILIDAD MAKEDESC Introduccion Comandos

3 6.0.3 Ejemplo de utilización UTILIDAD MAKENAV 22 8 UTILIDAD FIXDESC 23 9 Almacenamiento de pantallas 24 Id: domobox-ref-utils.ltx,v /05/10 18:49:10 paco Exp 2

4 Capítulo 1 Introducción El objetivo de este documento es mostrar el modo de funcionamiento asi como explicar como se han implementado el conjunto de utilidades denominadas DOMOUTILS. Las DOMOUTILS se han creado para facilitar el control del dispositivo DOMOBOX a partir del interfaz serie que este posee, dichas domoutils implementan dos posibles métodos de conexión Puerto serie : Conexión directa entre el puerto serie del PC donde se ejecutan las domoutils y el dispositivo DOMOBOX. Red Ethernet : Conexión entre el PC y el dispositivo DOMOBOX mediante el uso de la tarjeta adaptadora MicroCobox de Lantronix la cual sirve de interfaz entre el puerto serie del dispositivo DOMOBOX y la toma de red Ethernet. El desarrollo de dichas utilidades se ha realizado bajo plataforma Linux mediante el empleo del lenguaje de programación ANSI-C. En el caso de la domoutil Domo se ha desarrollado un Shell que proporciona al usuario una linea de comandos mediante la cual puede introducir y ver los resultados de los comandos que se definirán en sucesivos apartados de este documento. Las DOMOUTILS desarrolladas a grandes rasgos son las siguientes; domo :Utilidad Mini-Shell que proporciona al usuario una linea de comandos mediante la cual puede introducir y ver los resultados de los comandos que se definirán en su apartado correspondiente ha esta utilidad. prg : Utilidad que carga el firmware del domobox, a partir del firmware compilado y almacenado en un archivo.hex esta utilidad lo almacena en el equipo DOMOBOX y lo deja listo para ejecutarse mediante ISP (In-System Programming) proporcionado por el microcontrolador 89C51RC+ [PHI98]. serialview : emula la entrada/salida serie de un controlador dump : Obtiene y muestra una parte de la memoria del FLASH microcontrolador especificada en los argumentos. hex : Dependiendo de los argumentos convierte un archivo de notación hexadecimal a asccii o convierte la entrada proporcionada en asccii a través de la entrada estándar a formato hexadecimal y la muestra por la salida estándar. Id: domobox-ref-utils.ltx,v /05/10 18:49:10 paco Exp 3

5 Como se puede observar no todas las domoutils interactuan con el DOMOBOX sino que existen utilidades de apoyo para la confección de archivos en hexadecimal, visualización de resultados etc.. que ayudan tanto en las labores de programación y depuración del firmware del DOMOBOX como en la utilización de este. Id: domobox-ref-utils.ltx,v /05/10 18:49:10 paco Exp 4

6 Capítulo 2 UTILIDAD DOMO 2.1 Introducción Esta utilidad como bien se ha señalado en la introducción de este documento implementa un Mini-Shell que propordiona al usuario una linea de comandos mediante la cual puede introducir y ver los resultados de los comandos que serán descritos en este capitulo. Se ha utilizado en la implementación de este Mini-Shell (junto con C) guile que es un intérprete embebible del lenguaje de programación Scheme (un sencillo sublenguaje de Lisp) implementandose todo el resto de la funcionalidad en lenguaje C. Los comandos que esta utilidad pone a disposición del usuario son (por ahora omitiremos los argumentos): domo : Establece una conexión con el dispositivo DOMOBOX. domo : Finaliza la conexión con el dispositivo DOMOBOX. xmit : Manda una trama de datos al dispositivo DOMOBOX. rcv : Recibe una trama de datos del dispositivo DOMOBOX. write-file: Escribe un archivo en una posición de la memoria de uno de los componentes del dispositivo DOMOBOX. read-file: Lee desde una posición de memoria de uno de los componentes del dispositivo DOMO- BOX y lo almacena en un fichero load-mem: Carga los datos almacenados en el fichero indicado en la memoria del dispositivo DOMOBOX (AT45DO11) a partir de la dirección indicada en los argumentos. save-mem: Lee los datos almacenados en la memoria del dispositivo DOMOBOX (AT45DO11) a partir de la dirección indicada en los argumentos y lo almacena en un fichero especificado. get: Obtiene un solo caracter que identificará una respuesta por parte del DOMOBOX y lo muestra por pantalla 5

7 put: Transmite el caracter (comando del DOMOBOX) que se le especifique al dispositivo DOMO- BOX skip: Este comando se pone a la escucha para identificar si el dispositivo DOMOBOX esta enviando datos al PC y si es asi los muestra por pantalla, finaliza cuando no existe dicha transmisión. Una vez ejecutado el archivo correspondiente a esta utilidad (no es necesario introducir ningun argumento) el usuario visualizará un prompt domo.> que indicará que el Mini-Shell esta listo para que se introduzcan comandos. Todos los comandos tendran la siguiente sintaxis: (comando argumento1 argumento2...) Una vez terminada la sesión de comandos se debe teclear el comando guile (quit) para salir por completo de la utilidad. NOTA: Los comandos deben ir entre paréntesis. 2.2 Comandos de la utilidad DOMO comando domo Este comando como ya se ha indicado se utiliza para establecer una conexión con el dispositivo DOMO- BOX y es el primer comando que se debe ejecutar para poder tener acceso a dicho dispositivo. sintaxis la sintaxis del comando: (domo accesmode [flags]) accesmode: Especifica el modo de conexión entre el PC y el dispositivo DOMOBOX, en el caso de que sea a traves del puerto serie se deverá especificar el archivo correspondiente a dicho puerto de lo contrario, es decir, una conexión a traves de la red Ethernet se debe poner la cadena lantronix que especifica que el acceso se realiza a traves de dicha tarjeta. flags: En el caso de que el modo de conexión sea via puerto serie se debe incluir una cadena que especifique velocidad y formato de la comunicación, dicha cadena sera de la forma [velocidad,bitsparidad-stop] por ejemplo la cadena (9600,8N1) definiría 9600 velocidad de conexión, 8 bits de datos, sin paridad y un bit de stop comando domo Cierra la conexión entre el PC y el dispositivo DOMOBOX. no tiene ningún argumento. sintaxis La sintaxis del comando: ( domo) Id: domobox-ref-utils.ltx,v /05/10 18:49:10 paco Exp 6

8 2.2.3 comando xmit Este comando se utiliza para mandar una trama de datos al dispositivo DOMOBOX, esta trama, deberá estar en caracteres ascii ya que este comando se encarga de pasar esta cadena a formato hexadecimal para a continuación transmitirla al domobox, la cadena podra contener cualquier tipo de datos acorde con lo que se quiera realizar, paso de argumentos de un comando al domobox,lectura memoria, etc... sintaxis La sintaxis del comando: (xmit cadena ) comando rcv Recibe una cadena mandada por el dispositivo DOMOBOX y la muestra por pantalla en formato asccii (la cadena es recibida en hexadecimal), es evidente que la utilización de este comando siempre irá precedida de un comando que origine en el dispositivo DOMOBOX una respuesta. sintaxis La sintaxis del comando: (rcv) comando write-file Este comando se utiliza para obtener una parte de la memoria de cualquiera de los elementos que forman parte del dispositivo DOMOBOX y almacenarla en el archivo especificado. sintaxis La sintaxis del comando : dirección: (write-file direccion numberbytes comando archivo destino ) Dirección a partir de la cual se va a comenzar la lectura en el dispositivo especificado (2 bytes en hexadecimal) numberbytes: Número de bytes que se desean leer. Comando: Es un solo carácter acorde con los comandos que acepta el domobox y que especifica en que dispositivo se va a realizar la lectura.vease [Mol00] capítulo 5 para ver los comandos disponibles. Id: domobox-ref-utils.ltx,v /05/10 18:49:10 paco Exp 7

9 Archivo destino: Indica el archivo donde se almacena los datos que el DOMOBOX nos facilita para su posterior estudio comando read-file A partir de un archivo que se le pasa como argumento escribe el contenido de ese archivo en la posición de memoria definida en el comando en el dispositivo del DOMOBOX que se especifique en la linea de comandos. sintaxis La sintaxis del comando: (read-file dirección comando archivo origen ) dirección: Especifica la dirección inicial de destino del contenido del archivo especificado en archivo origen. comando: Es un solo carácter acorde con los comandos que acepta el domobox y que especifica en que dispositivo se va a realizar la escritura.vease [?] capítulo 5 para ver los comandos disponibles. archivo origen: Nombre del archivo origen que contiene los datos a transmitir. Los datos en el archivo origen deben estar en hexadecimal comando load-mem Carga los datos almacenados en el fichero indicado en la memoria del dispositivo DOMOBOX (AT45DO11) a partir de la dirección indicada en los argumentos. sintaxis La sintaxis del comando: (load-mem dirección archivo origen ) dirección: Especifica dirección a partir de la cual se van a cargar los datos almacenados en el archivo origen. archivo origen: Contiene los datos a transmitir a memoria comando save-mem Almacena,en el fichero indicado, el número de bytes y a partir de la dirección indicada los datos almacenados en la memoria del dispositivo DOMOBOX (AT45D011). Id: domobox-ref-utils.ltx,v /05/10 18:49:10 paco Exp 8

10 sintaxis La sintaxis del comando: (load-mem archivo destino dirección numberbytes ) dirección: Especifica dirección a partir de la cual se van a cargar los datos almacenados en el archivo destino. archivo destino: Contiene los datos a transmitir a memoria. numberbytes: Número de bytes a almacenar comando put Este comando manda un solo caracter ( que será un comando de los descritos en [Mol00] capítulo 5). sintaxis La sintaxis del comando: (put comando ) comando: Un solo caracter especificando una acción comando get Obtiene un solo caracter que identificará una respuesta por parte del DOMOBOX y lo muestra por pantalla, se utiliza principalmente para ver el estad de dicho dispositivo (observar si esta listo, si ha captado un determinado comando...) sintaxis La sintaxis del comando: (get) comando skip Este comando se pone a la escucha para identificar si el dispositivo DOMOBOX esta enviando datos al PC y si es asi los muestra por pantalla, finaliza cuando no existe dicha transmisión. sintaxis La sintaxis del comando: (skip) 2.3 Implementación de la utilidad DOMO En esta sección vamos a ver la implementación de la utilidad DOMO, esta utilidad viene implementada en un módulo domo.c y se sirve de dos archivos auxiliares (serial.c y dsocket.c) que implementan las dos formas ya descritas de conexión entre un PC y el dispositivos DOMOBOX. Ya se ha mencionado que se utiliza un Mini-Shell implementado en guile para capturar los comandos, diversos parametros de este Mini-Shell se han puesto en el archivo domo.scm. Id: domobox-ref-utils.ltx,v /05/10 18:49:10 paco Exp 9

11 2.3.1 descripción de funciones Para una correcta comprensión del código se ha dividido esta utilidad en funciones que realizan un cometido especifico y que a continuación se pasan a describir detalladamente: int main (int argc, char *argv[]): Esta función es la función principal de la utilidad y se encarga de llamar a las funciones de serial.c para abrir un descriptor de archivo que se utilizará en la conexión con el dispositivo DOMOBOX, por último llama a la función gh_enter que es la encargada de inicializar el intreprete de Scheme. void main_prog (int argc, char *argv[]): Es la función que se encarga de inicializar la utilidad mediante init_domo y es la función principal del interprete de scheme. init_domo(): Esta función se encarga de inicializar esta utilidad, en este caso las labores de inicialización corresponden a la definición de los comandos indicados en la sección anterior y a asociarlos con los procedimientos que se encargarán de implementar la funcionalidad de dichos comandos.esto se realiza mediante la llamada a la función gh_new_procedure de guile.por ultimo y mediante la función de guile gh_load se carga el módulo domo.scm. Funciones de conversión guile->c: Las funciones que a continuación se enumeran se encargan, para cada comando, de pasar los argumentos que se han facilitado junto con el comando a tipos reconocidos en C (ya que el programa los captura en tipos guile) mediante funciones de libreria de guile. Estas funciones tras hacer la conversión de argumentos llaman a la función que implenta la funcionalidad de dicho comando y, en caso de que devuelva algún dato, lo convierte de nuevo en una estructura de guile para ser devuelto al programa principal. SCM domo_put(scm s) SCM domo_get(void) SCM domo_rcv(void) SCM domo_xmit(scm s) SCM domo_destructor(void) SCM domo_constructor(scm p, SCM c) SCM domo_skip(void) SCM domo_load_mem(scm saddr, SCM name) SCM domo_save_mem(scm saddr, SCM name, SCM ssz) SCM domo_read_file(scm saddr, SCM scmd, SCM name) SCM domo_write_file(scm saddr, SCM ssize, SCM scmd, SCM name) Como se puede observar existe una función por cada comando descrito a la cual se les pasa todos los argumentos que acompañan a dicho comando en el tipo de guile SCM. Id: domobox-ref-utils.ltx,v /05/10 18:49:10 paco Exp 10

12 void domo_wfile(int addr, int size, int cmd, char* file): Función que implementa la funcionalidad del comando write-file, abre el fichero destino para escritura y a continuación construyen una trama con la dirección y el tamaño que se le han pasado como argumento enviándola al dispositivo DOMOBOX mediante la llamada a la función domo_buf_xmit, a continuación y mediante la función domo_putch envía el comando (tambien es un argumento) y tras comprobar que el dispositivo DOMOBOX ha confirmado la operación (mediante el envio de un punto. ) comienza a leer mediante la función domo_buf_rcv y lo escribe en el archivo destino hasta que la transmisión ha finalizado. void domo_mem2file(int addr, char* file, int sz): Función que implementa la funcionalidad del comando save-mem, Abre el archivo destino para la escritura y mediante la función domo_mem2buf lee del dispositivo DOMOBOX la memoria y lo almacena en la variable buf para a continuación escribirlo en el archivo destino. void domo_file2mem(int* addr, char* file): Función que implementa la funcionalidad del comando load-mem, Abre el archivo origen para lectura y mediante la función domo_buf2mem lee del archivo origen una trama de datos y la pone en la posición de memoria que la pasa como argumento. void domo_rfile(int addr, int cmd, char* file): Función que implementa la funcionalidad del comando read-file, abre el fichero destino para lectura y a continuación construyen una trama con la dirección que se le han pasado como argumento y los datos leidos enviándola al dispositivo DOMOBOX mediante la llamada a la función domo_buf_xmit, a continuación y mediante la función domo_putch envía el comando (también es un argumento) y tras comprobar que el dispositivo DOMOBOX ha confirmado la operación (mediante el envio de un punto. ) actualiza la nueva direccion y comienza de nuevo el proceso hasta que el archivo ha finalizado. void domo_buf_rcv(char* buf, int* len): Esta función se encarga de recibir una trama en el vector buf, para ello transmite al dispositivo DOMOBOX una B la cual indica al DOMOBOX que si tiene lista alguna trama la envie, esta función la capta (Aplicando transparencia y comprobando el checksum) y la almacena en el citado vector buf. void domo_buf_xmit(char* buf, int len): Esta función trasnmite un vector (buf) de una determinada longitud (len) desde el PC al dispositivo DOMOBOX, para ello se transmite al dispositivo una b indicándole que se prepare para recibir una trama y a continuación se realiza la transmisión caracter a caracter mediante la funcion domo_putch (aplicando transparencia) por último se comprueba el checksum de la trama recibida por el DOMOBOX con la que realmente se ha mandado y si no es igual se informa del problema. domo_flush(): Id: domobox-ref-utils.ltx,v /05/10 18:49:10 paco Exp 11

13 Implementa una escuha sobre el descriptor de archivo que identifica al dispositivo DOMOBOX identificando si hay datos listos para la lectura, de ser asi, los muestra por pantalla. Esta función espera 5 segundos para ver si llegan mas datos de no ser asi sale de la función. Se utiliza para no solapara acciones de lectura consecutivas sobre el dispositivo DOMOBOX. domo_getch(): Implementa la lectura de un caracter mandado por el dispositivo DOMOBOX, Si tras 5 segundos no se ha recibido ningún caracter se sale de la función informando de un timeout. void domo_putch(unsigned int c): Escribe el caracter c en el descriptor de archivo que identifica al Dispositivo DOMOBOX, se usa para mandar un solo caracter a dicho dispositivo. void domo_buf_ascii2hex(char* orig, char* dest, int* len): Copia el buffer orig (de longitud len) en dest pasando los caracteres del buffer orig a hexadecimal antes de copiarlos en dest. void domo_buf_hex2ascii(char* orig, int len, char* dest): Copia el buffer orig (de longitud len) en dest pasando los caracteres del buffer orig a ascii antes de copiarlos en dest. void hex2ascii(unsigned int c, unsigned char* p): convierte el caracter c expresado en hexadecimal a asccii y lo almacena en la posición apuntada por p. unsigned int ascii2hex(unsigned char* p): Devuelve el caracter p (expresado en asccii) en hexadecimal. int domo_mem2buf(char* buf, int sz, int* addr): Almacena en el vector buf a partir de la dirección que se le pasa como argumento sz bytes, la función construye una trama con la dirección y longitud de la lectura y la manda mediante la función domo_buf_xmit para a continuación mandar el comando de lectura al dispositivo DOMOBOX (en este caso m ). Tras verificar que el dispositivo DOMOBOX ha confirmado el comando (DOMO- BOX ha mandado el caracter. ) se procede a la lectura de las tramas enviadas por el DOMOBOX mediante la función domo_buf_rcv. La función devuelve el número de bytes recibidos. void domo_buf2mem(char* buf, int sz, int* addr): Transmite desde el vector buf al dispositivo DOMOBOX los datos almacenados en dicho vector y los almacena en la dirección que se le pasa como argumento, la función almacena en los tres primeros bytes del vector buf la dirección y longitud de la escritura y la manda mediante la función domo_buf_xmit para a continuación mandar el comando de escritura al dispositivo DOMOBOX (en este caso M ). Tras verificar que el dispositivo DOMOBOX ha confirmado el comando (DO- MOBOX ha mandado el caracter. ) reajusta la dirección donde ha finalizado la escritura. Id: domobox-ref-utils.ltx,v /05/10 18:49:10 paco Exp 12

14 Capítulo 3 UTILIDAD PRG Utilidad que carga el firmware del domobox, a partir del firmware compilado y almacenado en un archivo.hex esta utilidad lo almacena en el equipo DOMOBOX y lo deja listo para ejecutarse mediante ISP (In- System Programming) proporcionado por el microcontrolador 89C51RC+ y que viene especificado en [PHI98]. Sintaxis La sintaxis del comando es la siguiente: prg accesmode archivo.hex [1 2] accessmode: Indica el tipo de acceso que se va a realizar al dispositivo DOMOBOX, de ser via puerto serie especificara el archivo que identifica a dicho puerto serie (en linux sería del tipo /dev/ttys?) mientras que si es a traves de una red ethernet sera la cadena lantronix la que se tenga que indicar como argumento. archivo.hex: Indica el archivo que contiene todo el firmware que se va a almacenar en el controlador principal del dispositivo DOMOBOX. 1 2 : 3.1 Implementación de la utilidad DOMO Esta utilidad se ha implementado en C bajo el sistema operativo Linux como las anteriormente citadas domoutils, utiliza los módulos serial.c y dsocket.c que contienen implementada el acceso al dispositivo DOMOBOX ya sea bien mediante la conexión directa al puerto serie o a traves de una Red Ethernet mediante sockets a traves de la tarjeta de la empresa lantronix MicroCobox. El código fuente esta implentado en archivo prg.c que contiene las siguientes funciones: int main(int argc, char* argv[]) Función principal del programa, en primer lugar establece la conexión con el dispositivo DOMOBOX mediante la función open_domo (serial.c) y tras comprobar 13

15 que se ha tenido exito en dicha conexión transmite al dispositivo DOMOBOX el caracter U que es el que le indica el modo de programación ISP. Cuando el dispositivo DOMOBOX este listo mandará de nuevo otro caracter U entonces la función main manda mediante la llamada a la funcion prg de este mismo módulo las tramas de inicio de programación donde se establece la frecuencia del oscilador y el modo de escritura. A continuación se pasa a un bucle donde se van leyendo las cadenas de programación contenidas en el archivo.hex especificado en los argumentos y mandadas al dispositivo DOMOBOX mediante la función prg de este mismo módulo. void prg(int fd, const char* s) Esta función escribe en el descriptor fd el buffer s. Ademas de transmitir dicho vector también se encarga de confirmar que el dispositivo DOMOBOX ha recibido la cadena correctamente sirviendose del auto-echo que implementa el firmware de ISP y que, estando en este modo de operación, el microcontrolador manda lo que recibe por lo que esta función la captura y la compara con la cadena original. Id: domobox-ref-utils.ltx,v /05/10 18:49:10 paco Exp 14

16 Capítulo 4 UTILIDAD DUMP Obtiene y muestra una parte de la memoria FLASH del microcontrolador 89C51RC+ especificada en los argumentos. Sintaxis La sintaxis de esta utilidad: dump accesmode initaddr endaddr accesmode: Indica el tipo de acceso que se va a realizar al dispositivo DOMOBOX, de ser via puerto serie especificara el archivo que identifica a dicho puerto serie (en linux sería del tipo /dev/ttys?) mientras que si es a traves de una red ethernet sera la cadena lantronix la que se tenga que indicar como argumento. initaddr: Indica la dirección de comienzo de la parte de memoria que queremos visualizar. endaddr: Indica la dirección final de memoria que queremos visualizar. 4.1 Implementación de la utilidad DUMP Esta utilidad se implementa en el archivo dump.c y hace uso de los módulos serial.c y dsocket.c para la conexión del PC con el dispositivo DOMOBOX ya sea mediante conexión directa mediante el puerto serie (serialc.) o mediante la interfaz con red Ethernet a traves de la placa MicroCobox de Lantronix. La implementación consta de una función principal y funciones auxiliares para pasar del formato ascii a hexadecimal y viceversa similares a las de la utilidad domo. La función principal realiza las siguientes acciones; A partir de los argumentos que se pasan en la linea de comandos establece la conexión oportuna via puerto serie o via Ethernet mediante socket, una vez realizada la conexión construye una trama de datos conforme a ISP (In System Programming) que en este caso será del tipo : : 15

17 yyyyxxxx00cc donde yyyy y xxxx determinan las correspondientes direciones de inicio y final de la lectura respectivamente mientras que cc es el cheksum de la trama completa.vease [PHI98] para ver el significado de los distintos códigos de estas tramas. Es necesario indicar que en la construcción de la trama con las direcciones que se le pasan como argumentos una, vez completada, dicho vector debe ser pasado por completo a hexadecimal antes de ser mandado. Una vez mandada la trama que implica la lectura la función se pone a la escucha de las tramas que manda el DOMOBOX y que contendrán los datos requeridos hasta que este termine (se pase el timeout fijado en 5 segundos sin que se reciba nada) y las muestra por pantalla. Id: domobox-ref-utils.ltx,v /05/10 18:49:10 paco Exp 16

18 Capítulo 5 UTILIDAD HEX Dependiendo de los argumentos convierte un archivo de notación hexadecimal a ascii mostrandolo por pantalla (su contenido en ascii). Si no se especifica ningún argumento los caracteres que se introduzcan en formato ascii por el teclado los convertira en hexadecimal cuando se introduzca el caracter de fin de fichero y los mostrará por la salida estandar. Sintaxis La sintaxis de este comando es la siguiente: hex [archivo] archivo: Contiene los datos que van a ser cambiados de formato Esta utilidad sirve en labores de visión de resultados y en labores de depuracción para observar datos tanto hexadecimales como en formato ascii y sus correspondientes conversiones. 5.1 implementación de la utilidad hex La utilidad hex esta implementada en el módulo hex.c y contiene las siguientes funciones principales: void domo_buf_ascii2hex(char* orig, char* dest, int* len): Copia el buffer orig (de longitud len) en dest pasando los caracteres del buffer orig a hexadecimal antes de copiarlos en dest. void domo_buf_hex2ascii(char* orig, int len, char* dest): Copia el buffer orig (de longitud len) en dest pasando los caracteres del buffer orig a ascii antes de copiarlos en dest. 17

19 int main(int argc, char* argv[]): Es la función principal de la utilidad, dependiendo de si existe o no archivo origen en la linea de argumentos realiza una u otra operación. Si dicho archivo existe, va leyendo tramas de datos de dicho archivo y convirtiendo dichas tramas de formato hexadecimal a asccii mediante la función domo_buf_hex2ascii y mostrando por la salida estandar el vector devuelto por la mencionada función ya en formato ascii. Si dicho archivo no existe esta función lee de la entrada estándar (habitualmente el teclado) hasta que se introduce un EOF(fin de fichero) momento en el cual lo pasa a formato hexadecimal mediante la llamada a domo_buf_ascii2hex y lo muestra por pantalla. Id: domobox-ref-utils.ltx,v /05/10 18:49:10 paco Exp 18

20 Capítulo 6 UTILIDAD MAKEDESC Introduccion Tal y como se describe en [Moy00] las pantallas de información que el dispositivo DOMOBOX muestra por el receptor de TV se compone de diversos Metadatos como,por ejemplo, los datos de navegación (cual es la siguiente pantalla a cargar si se pulsa una u otra tecla del mando a distancia), información domótica, la propia presentación gráfica de las pantallas etc.. Esta utilidad nos implementa una serie de comandos que nos hace posible especificar los datos correspondientes a una pantalla (simple,iconos, areas o lonvar) junto con sus datos de navegación a la vez que nos permite especificar descriptores de linea variables lonworks, caracteres gráficos, alfanumericos etc... y construir por tanto su descriptor de Pantalla ( 33 bytes con todas las direcciónes y longitudes de los datos a mostrar en la pantalla descrita en dicho descriptor). Lo que esta utilidad nos muestra por la salida estandar es el descriptor de la pantalla o conjunto de pantallas una vez que se han especificado toda la información que contiene tal y como se debe almacenar en la memoria del DOMOBOX. Otra funcionalidad importante implementada es la de utilizar la salida de error para mostrar los comandos necesarios para que la utilidad domo (capitulo 2) carge en la memoria del dispositivo DOMOBOX toda la información referente a una pantalla. Tenemos dos opciones para insertar dichos comandos, una es introducir todos los comandos en un archivo y pasarselo como argumento a la utilidad, otra forma sería ejecutar la utilidad e ir tecleando los comandos directamente con el teclado Comandos los comandos disponibles con los argumentos son los siguientes; Pantalla: El formato para la introducción de la pantalla es el siguiente; P/S descriptor modo fichero destino1 destino2 destino3 destino4 descriptor: Indice de pantalla. modo: 0=simple, 1 = areas, 2= iconos y 3= areas lonvar. 19

21 fichero: Nombre del fichero que alvergara el contenido de la pantalla. destino1: Pantalla destino para tecla 1 (indice de la página). destino2: Pantalla destino para tecla 2 (indice de la página). destino3: Pantalla destino para tecla 3 (indice de la página). destino4: Pantalla destino para tecla 4 (indice de la página). Descriptor de linea: Variable Lonworks: Gráficos: D fichero fichero L descriptor descriptor_lonvar G descriptor fichero descriptor: Indice. fichero : Fichero con el contenido. Alfanuméricos: A descriptor fichero descriptor: Indice. fichero : Fichero con el contenido. Navegación: N descriptor fichero descriptor: Indice. fichero : Fichero con el contenido Ejemplo de utilización Vamos a ver un pequeño ejemplo de como utilizar esta utilidad, partimos de que tenemos dos archivos Cocina.mem y Cocina.nav el primero generado con el editor de pantallas y el segundo con la utilidad makenav (capitulo siguiente), atendiendo a los comandos explicados en la sección anterior creamos un archivo ejemplo.src el cual va a tener los siguientes comandos conforme a la subsección anterior: S 21 1 Cocina.mem N 21 Cocina.nav Bien, si ejecutamos la utilidad makedesc de la siguiente forma; makedesc ejemplo.src > ejemplo.mem 2> ejemplo.scm Donde el caracter > y 2> representan el direccionamiento a la salida estandar y la salida de errores respectivamente en entorno linux, en el archivo ejemplo.mem nos integrará los datos de pantalla y navegación especificados en el archivo ejemplo.src junto con la información domótica (si la hubiera), si Id: domobox-ref-utils.ltx,v /05/10 18:49:10 paco Exp 20

22 ahora echamos un vistazo al archivo ejemplo.scm; (define addr 0) (load-mem #x0000 "domodb/desc.mem") (set! addr #x0400) (set! addr (load-mem addr "domodb/cocina.mem")) ; buf2mem: 1984 bytes at a2 (set! addr (load-mem addr "domodb/cocina.nav")) ; buf2mem: 64 bytes at 07a2-07b2 Podemos ver como se han generado los comandos de la utilidad domo que almacenan en memoria del dispositivo DOMOBOX los datos contenidos en los archivos cocina.mem y cocina.nav ademas actualizar la dirección para ir guardando dichos datos en la forma adecuada. Id: domobox-ref-utils.ltx,v /05/10 18:49:10 paco Exp 21

23 Capítulo 7 UTILIDAD MAKENAV Esta utilidad nos sirve para generar los archivos que contienen la información de navegación(y que tendrán extensión.nav) a partir de una serie de comandos que el usuario facilita bien mediante un archivo para el cual se ha elegido la extensión.src aunque no es obligatoria) que contiene los comandos o bien por la entrada estándar tecleando los comandos directamente. Los comandos tienen la siguiente sintaxis; Iconos:I (pos_x, pos_y):indice_icono>pagina_destino Areas: A (x0,y0,x1,y1)[attr_off:attr_on]>pagina_destino Lonvar:L (x0,y0,x1,y1)[attr_off:attr_on]>valor COMPLETAR Y MEJORAR Nota: los atributos se escriben en hexadecimal 22

24 Capítulo 8 UTILIDAD FIXDESC Esta utilidad nos genera a partir de los archivos.pan los archivos.mem que contienen toda la información con el contenido de las pantallas que utiliza el comando P de la utilidad makedesc para generar toda la información (datos de navegación, descriptores de linea..) relativos a una pantalla. COMPLETAR Y MEJORAR 23

25 Capítulo 9 Almacenamiento de pantallas Utilizando las utilidades bajo linux para almacenar un juego de pantallas en el dispositivo DOMOBOX debemos realizar los siguientes pasos, primero debemos diseñar con el editor de pantallas las pantallas que deseamos almacenar(archivos.mem), también debemos generar con la utilidad makenav los archivos.nav que contiene la información de navegación de cada una de las pantallas, a continuación y mediante la utilidad makedesc y mediante comandos generamos un archivo.scm que contendrá las instrucciones en comandos de la utilidad domo para cargar en memoria del dispositivo DOMOBOX los archivos que contienen la información tanto de las pantallas como los de navegación. Todos estos pasos se realizan tambien desde el editor de pantallas de forma automática y transparente al usuario. COMPLETAR Y MEJORAR 24

26 Bibliografía [Mol00] Félix Jesús Villanueva Molina. Documentación firmware del dispositivo domobox. Technical report, Grupo ARCO, 1.7, Septiembre [Moy00] Francisco Moya. Estructuras de gestion de pantallas del domobox. Technical report, Grupo Arco, Septiembre [PHI98] PHILIPS. DATA SHEET 89C51RC+/RD+, Octubre Id: domobox-ref-utils.ltx,v /05/10 18:49:10 paco Exp 25