44-48 Siteplayer

25/5/05

08:16

Pgina 44

PROGRAMACIN
44

RESISTOR

Curso de Programacin SitePlayer SP1 (3)

Curso de programacin y utilizacin del mdulo SitePlayer TM SP1. El integrado constituye un autntico Web Server que permite interactuar con cualquier dispositivo electrnico a travs de una pgina de Internet absolutamente normal. El objetivo del presente Curso es dar a conocer la tcnica de programacin del mdulo a travs de diversos ejemplos prcticos que utilizan la red para comunicar con diversos dispositivos remotos. Captulo tercero. Por Roberto Nogarotto

omo se indicaba en el primer captulo del presente Curso, el mtodo de realizacin de una aplicacin completa basada en el mdulo SitePlayer puede estudiarse en dos fases principales: la creacin de la pgina web y la creacin de un archivo de definiciones que se descarga en el mdulo junto con la pgina web. Adems, si el mdulo va conectado a un microcontrolador, obviamente, habr de escribirse el programa de gestin de la comunicacin entre el propio microcontro-

lador y el mdulo. Una vez terminados la pgina web y el archivo de definiciones, un software especfico llamado SitePlayerLinker permitir obtener el archivo nico de programacin del mdulo y descargarlo en su interior a travs de la conexin Ethernet. Las pginas web se crean utilizando el lenguaje html. En el presente captulo del curso se conocern los diversos programas diseados con la finalidad de hacer comprensibles las pocas instrucciones utilizadas incluso a aquellos lectores que tengan muy poco o ningn

conocimiento de este lenguaje. Previamente se analizar con cierto detalle cmo se crea el archivo de definiciones. EL ARCHIVO DE DEFINICIONES El archivo de definiciones puede considerarse dividido en tres secciones bsicas: la de definiciones. la de objetos y la de exportaciones. En la primera se establecen una serie de parmetros que el Linker utiliza para generar el archivo en formato binario, adems de ciertos parme-

44-48 Siteplayer

25/5/05

08:16

Pgina 45

$Sitepath "C:\Program SitePlayer\SP_Root"

Files\

SECCIN DE DEFINICIONES Las definiciones deben comenzar con el smbolo $ (dlar). Los comentarios irn precedidos del smbolo ; (punto y coma). A continuacin se analizarn las definiciones ms importantes disponibles. Se utilizar la sintaxis siguiente: entre corchetes se indicar el argumento de la definicin y se indicar a continuacn el valor de defecto del mdulo. $DHCPON [ON/OFF] DEFAULT: ON Con esta instruccin se concreta si el mdulo debe tener una direccin IP fija, en cuyo caso este parmetro se situar en Off, o si la direccin IP es del tipo dinmico y se obtiene de un servidor que utiliza el protocolo DHCP (Dynamic Host Configuration Protocol). Si este parmetro est en On y el mdulo no consigue obtener una direccin IP de un servidor, utilizar la direccin IP definida por la directiva $InitialIP. $DEVICENAME [NOMBRE] Con esta directiva puede asociarse a cada mdulo una denominacin concreta, aunque no puede sobrepasar los 64 caracteres de longitud. $DOWNLOADPASSWORD [PASSWORD] Esta funcin permite especificar una password con una longitud mxima de 16 caracteres. El mdulo pide esta password cada vez que se pretende descargar en l un nuevo

$INITIALIP [XXX.XXX.XXX.XXX] Con esta orden se especifica la direccin IP inicial del mdulo, en formato de punto decimal (si est deshabilitada la funcin DHCP), o bien la direccin IP si no se puede obtener una asignacin del servidor (estando habilitada la modalidad DHCP). $PARSE [EXTENSIN] Con esta directiva puede indicarse en qu tipo de archivo, adems de en los html, deben buscarse los objetos. $POSTIRQ [ON/OFF] DEFAULT: OFF Colocando en On esta definicin se habilita la patilla 11 del mdulo para generar un impulso de 5 microsegundos cada vez que se reciban datos va Ethernet, aunque slo cuando stos modifiquen los que ya se encuentran en memoria. $SITEFILE [FILENAME] Cuando el programa SiteLinker elabora un directorio para crear una pgina web descargable en el mdulo SitePlayer, se crea tambin un archivo binario con extensin .SBD. Esta orden permite insertar el nombre que debe atribuirse a este archivo. $SITEPASSWORD [PASSWORD] Se aplica a proteger todos los archivos que residen en un directorio dado.

especifica que los archivos que constituyen la aplicacin Web Server estn contenidos en el directorio C:\ProgramFiles\SitePlayer\SP_Root . Por tanto, todos los archivos presentes en el directorio indicado se elaboran y constituyen la raz (root) del sitio del SitePlayer. SEZIONE OGGETTI Se denominan objetos aquellas variables mediante las cuales el SitePlayer puede comunicarse con el mundo exterior. En general, el SitePlayer est en comunicacin con un microcontrolador programado, como es el caso del programador/demoboard FT497; el dilogo se establece mediante la lectura y eventual modificacin de estos objetos. Por otra parte, estos objetos del SitePlayer tambin representan objetos en las pginas web. Por ejemplo: suponiendo que se desee presentar en pantalla la temperatura de un local o estancia. lo primero que habr que hacer es definir un objeto en el SitePlayer y en la pgina web, caracterizado con el mismo nombre en ambas ubicaciones. El microcontrolador, tras haber ledo el valor de la temperatura mediante una sonda termomtrica, se dirigir por la puerta serie a modificar el valor del objeto; el SitePlayer, cada vez que un navegador (browser) le requiera el envo de una pgina web, proceder a enviarla actualizando el objeto con el mismo nombre de la pgina. Los objetos tienen una longitud mxima de 32 caracteres, comprendiendo indiferentemente letras y nmeros, pero el primer carcter debe ser obligato-

PROGRAMACIN
RESISTOR

tros que definen el modo de funcionamiento del mdulo. La segunda define los objetos, que son las variables utilizadas por el mdulo para comunicar con el mundo exterior, que en este caso es el microcontrolador PIC. Finalmente, en la tercera seccin se establece qu archivos se generarn durante el proceso de linking. Pero conviene estudiar com ms detalle cada una de estas secciones.

sitio. Adems, el mdulo SitePlayerSP1, antes de permitir una descarga, verifica que el PC que ha solicitado esta operacin est integrado en la misma red local. $INCLUDE [FILENAME] Si se desea entrar un archivo (por ejemplo, una librera de objetos), este comando permite especificar exactamente el camino y el nombre del archivo a incluir.

$SITEPATH [PATH] Indica al programa SiteLinker dnde residen los archivos que constituyen la aplicacin Web Server. El argumento de esta funcin es el recorrido (path) completo del archivo. Por ejemplo:

45

44-48 Siteplayer

25/5/05

08:16

Pgina 46

riamente una letra. Vase a continuacin un ejemplo de deficin de un objeto: Temperatura db 25 Esta definicin crea un objeto llamado Temperatura: es del typo byte (db) y su valor por defecto es 25. Los objetos que pueden definirse son del tipo bit (formados por un solo bit; se utiliza el especificador DBIT), byte o lnea (formados por 8 bits, especificando DB), palabra (word) (16 bits, con DW) y, finalmente, doble (double) (32 bits, con DD). La ubicacin de los objetos en la memoria se indica mediante la directiva ORG, que es una funcin muy similar a la directiva homnima de los compiladores Assembler. En el mdulo SitePlayer los objetos pueden situarse en el espacio de memoria comprendido entre las direcciones 0000h y 02FFh, si bien alguna de las localizaciones queda reservada a la gestin del protocolo UDP. Ms adelante se ver cmo se especifican los objetos en las pginas web y cmo el microcontrolador accede a ellos a travs de la puerta serie. Adems de los objetos que se acaban de conocer, y que se aplicarn a los ejemplos de programa previstos para el programador/demoboard FT497, existe toda una serie de objetos que no se tratarn en profundidad: el Serial Port Output Object,

PROGRAMACIN

utilizado para enviar una lnea directamente a travs de la puerta serie del SitePlayer, la Serial Peripheral Interface (SPI) Object, que se utiliza para aprovechar la SPI del SitePlayer (la SPI es un til sistema de interfaz serie para establecer comunicacin con dispositivos que utilizan este canal, como memorias, convertidores, controladores de motores, etc.). Finalmente, existen una serie de objetos que supervisan el envo de datos con el protocolo UDP. SECCIN EXPORTACIN En esta seccin se define qu archivos (y en qu posicin) se crearn durante la elaboracin del SiteLinker. Estos archivos sern tiles para insertarlos en programas escritos en C, Visual Basic, Assembler o HTML. Obviamente, si no son necesarios se puede omitir esta funcin. INSERTAR LOS OBJETOS EN LAS PGINAS WEB Ya se ha visto cmo se definen los objetos y cmo stos constituyen el canal de comunicacin, as que puede pasarse a conocer en qu forma pueden definirse en el interior de una pgina web. Para insertar un objeto en una pgina html basta con insertar el nombre del objeto (recurdese que debe coincidir exactamente con el nombre indicado en el archivo de definiciones) precedido por el

smbolo ^. Un sencillo ejemplo de cmo se inserta un objeto en lenguaje html ayudar a la comprensin del mtodo: <html> <body> La temperatura es ^Temperatura </body> </html> Visualizando con un navegador este sencillo archivo, aparecer la frase La temperatura es ^Temperatura. Sin embargo, cuando el programa se carga en el SitePlayer y luego se busca con el navegador, el lugar de ^Temperatura aparece ocupado por el valor numrico asumido en ese mismo instante por el objeto Temperatura. MODIFICADORES Sobre los objetos pueden ejecutarse operaciones matemticas, lgicas o de gestin de lneas. Utilizando operaciones matemticas puede conseguirse que al browser no se enve el valor numrico del objeto sino el valor modificado por una operacin matemtica dada. Por ejemplo: se podra enviar no el valor del objeto temperatura sino el mismo aumentado por un factor 2, o bien enviar separadamente las cifras que componen el objeto. Las operaciones que pueden ejecutarse sobre el objeto antes de enviarlo se resumen en la tabla incluida en esa pgina.

RESISTOR

46

Estas dos imgenes muestran lo que visualizara el navegador si la pgina residiera en un servidor normal (izquierda) o en el SitePlayer (derecha). como puede verse, SitePlayer procede a sustituir el texto ^Temperatura por el valor correspondiente.

44-48 Siteplayer

25/5/05

08:16

Pgina 47

Modificador es
Operacin ^objeto:n ^objeto+n ^objeto-n ^objeto*n ^objeto/n ^objeto&n ^objeto|n ^objeto~n ^objeto#n ^objeto$n ^objeto'n

aplicables a los Objetos

Significado del modificador Visualiza la n-sima cifra de Objeto, partiendo de la derecha. Por ejemplo, si objeto vale 35, ^objeto:1 visualiza slo la cifra 5. Suma a Objeto y visualiza el total. Resta n a Objeto y visualiza el total. Multiplica Objeto por n y visualiza el total. Divide Objeto por n y visualiza el total. Ejecuta el AND lgico entre n y Objeto y visualiza el total. Ejecuta el OR lgico entre n y Objeto y visualiza el total. Ejecuta el XOR lgico entre n y Objeto y visualiza el total. Ejecuta el AND lgico entre n y Objeto y visualiza "CHECKED" si el resultado es distinto de cero; si el resultado es cero no visualiza nada. Si Objeto = n visualiza "CHECKED"; en caso contrario no visualiza nada. Restituye el ensimo bit de Objeto desde la derecha (el primer bit es cero).

EL AMBIENTE DE DESARROLLO DEL MDULO SITEPLAYER: EL SITELINKER Ya se sabe cmo crear objetos e insertarlos en las pginas web y en los archivos de definiciones, de modo que ya puede entrarse en el mtodo de elaboracin de los archivos de las pginas web y del archivo de definiciones para obtener un archivo nico que se descargar en el mdulo SitePlayer. El programa que permite ejecutar estas tareas es el llamado

SiteLinker y es suministrado por la casa NetMedia, fabricante de SitePlayer. Una vez arrancado este programa, en pantalla del PC aparece una ventana principal que permite ejecutar algunas rdenes. La primera de ellas es abrir un archivo de definiciones (con extensin .SPD): para ello es necesario ejecutar el comando Open (Abrir) contenido en el men File (Archivo). Pueden abrirse dos tipos de archivos: con extensin .spd o con extensin .spb. Estos ltimos (*spb) estn ya

compilados y, por tanto, puede descargarse en el mdulo directamente. Una vez abierto un archivo, en el men Download (Descargar) se dispone de varios comandos que permiten compilar el programa (Make download file) (Crear archivo descargable), efectuar la programacin del mdulo (Download SitePlayer) (Descargar en SitePlayer) o compilar y programar el mdulo sin solucin de continuidad (Make and download) (Crear y Descargar). Antes de efectuar la

OFERTA DEL MES

Programador Lector para tarjetas Smart Card (Resistor 181 - Pag. 6 y 9)
El kit incluye todos los componentes, la placa taladrada y serigrafiada, el microcontrolador programado, el cable de conexion al PC, el software de gestin una Smart Card de 2 kbits. El software tambin puede adquirirse se paradamente (cd SFW269). Peden obtenerse tarjetas SmartCard adicionales. (cd CPC2K).

Cd FT269 Antes Eur 48 Ahora Eur 39

Pedidos a Revistas Profesionales, S. L. C/Valentn Beato 42, 3 plta. 28037 Madrid. Tel.: 91 304 87 64. Fax: 91 327 13 03 o rellenar el cupn adjunto

PROGRAMACIN
RESISTOR

47

44-48 Siteplayer

25/5/05

08:16

Pgina 48

El Ambiente SiteLinker

PROGRAMACIN

RESISTOR

48

programacin es preciso especificar la direccin IP atribuida al mdulo a programar. Para ello debe llamarse el comando IP Address for Download (Direccin IP para descargar), contenido en el men Configure (Configurar). El comando DownloadPassword del mismo men define la palabra clave que el SiteLinker enva al mdulo para poder descargar. Obviamente, esta palabra clave debe

ser igual que la instalada previamente en el mdulo que se quiere programar. Una vez iniciada la creacin del archivo a descargar, que tendr extensin .SPD, la pantalla de SiteLinker mostrar una serie de informaciones: la principal tarea que desarrolla el Linker es, sobre todo, la bsqueda de todos los objetos definidos en el archivo de definiciones. Si no es posible

encontrar la correspondencia de algn objeto, este incidencia se seala en pantalla. Si todo el proceso se ejecuta correctamente, se indica el nmero de objetos presentes y la cantidad de memoria flash ocupada. Si, adems, se haba actuado el comando Make and Download File (Crear y Descargar Archivo), se pone inmediatamente en marcha la programacin del mdulo.

DISPONIBILIDAD DEL

MATERIAL
El mdulo SitePlayer est disponible montado y verificado (cd. SP1) al precio de Eur 42,00: el conjunto hbrido resultante implementa un Web Server, un controlador Ethernet 10baseT, una memoria Flash para almacenar las pginas Web y un dispositivo de interfaz serie. Para mejorar el aprendizaje y facilitar el trabajo profesional con el SitePlayer se dispone del circuito demoboard/programador en kit (cd. FT497K) al precio de Eur 48,00. El kit incluye la placa de circuito imprso taladrada y serigrafiada, un PIC16F876, 8 leds, 1 dipswitch de 8 polos, 1 trimmer, 1 sensor de temperatura, salida PWM, salida analgica, conector Ethernet, conector para programacin incircuit del PIC. El kit comprende todos los componentes y los listados de demostracin a nivel fuente (fuente Basic para PIC; pginas HTML; archivos de definicin SPD), etc. El kit no comprende el mdulo SitePlayer, el alimentador de red y el programador del PIC (cd. FT386K, Eur 86,00). Los precios incluyen el IVA.

Puede adquirir sus mdulos SitePlayer y complementos en: