ESCUELA TCNICA SUPERIOR DE INGENIEROS DE

TELECOMUNICACIN

MANUAL DE USUARIO DEL

CLIENTE DE TFTP IMPLEMENTADO
EN C PARA EL ENTORNO
EDCOLDFIRE DEL MCF5272
AUTORES:
CORONADO BARRIOS, MIGUEL
LPEZ NAVARRO, ANTONIO JOS
PREZ MAGARIOS,NURIA
SAN SEGUNDO HERNNDEZ, RUBN

FECHA
JUNIO 2006

Departamento de Ingeniera Electrnica

E.T.S.I. de Telecomunicacin

Universidad Politcnica de Madrid

NDICE DE CONTENIDOS
1. Software Requerido
1.1 Servidor de TFTP
1.2 Entorno de desarrollo EDColdFire .
2. Hardware Requerido
3. Uso del Sistema ..
3.1 Comando help
3.2 Comando md

3.3 Comando show

3.4 Comando set

3.5 Comando quit

3.6 Comando read
3.7 Comando write
ANEXO: Ficheros ..

4
4
6
7
7
8
9
10
11
12
13
14
16

NDICE DE FIGURAS
Figura 1:Aspecto de la pgina donde se puede realizar la descargar del servidor
Figura 2:Pantalla de inicio del servidor TFTP
Figura 3:Elegimos la opcin configuracin del men File
Figura 4:En Root Directory se guardarn los ficheros enviados y recibidos
Figura 5:Permitimos enviar y recibir archivos
Figura 6:Seccin de la pgina del laboratorio donde descargar el programa
Figura 7:Configuracin de la conexin mediante un switch
Figura 8:Pantalla en la que se selecciona el programa a cargar en el Coldfire
Figura 9:Pantalla de inicio del programa
Figura 10:Escribimos help
Figura 11:Men help con explicacin de los comandos y sus parmetros
Figura 12:El comandomdpresenta las posiciones de memoria y lo que almacenan
Figura 13:Aparecen los parmetros de la comunicacin junto con sus valores
Figura 14:Vemos cmo cambia la direccin cliente tras aplicar el set
Figura 15:Con quit cerramos la conexin
Figura 16:Leemos del servidor
Figura 17:Pantalla del servidor una vez finalizada la lectura.
Figura 18:Escribimos 19 bytes en el fichero test5.txt
Figura 19:Pantalla del servidor despus de una lectura y una escritura.

5
5
5
6
6
7
8
8
9
9
10
10
12
12
13
13
14
14

MANUAL DE USUARIO
Este documento es el manual de usuario del mdulo Ethernet del MCF5272. En
l se detallan los requisitos hardware y software para su utilizacin, as como una
aproximacin a las utilidades del mismo.

1.- Software Requerido

Para poder utilizar el mdulo Ethernet del MCF5272 se requieren los siguientes
programas o archivos:
-

Entorno de desarrollo EDColdFire para la plataforma ENT2004CF.

Fichero EthernetMCF5272.zip
Servidor de TFTP

1.1.- Servidor de TFTP

El software del servidor de TFTP puede descargarse del siguiente enlace:
www.solarwinds.net/Tools/Free_tools/TFTP_Server
Debe aparecer la siguiente pgina:

Figura 1: Aspecto de la pgina donde se puede realizar la descargar del servidor

Una vez descargado, lo instalamos en el ordenador que actuar de servidor, de forma

que al ejecutarlo salga la siguiente pantalla:

Figura 2: Pantalla de inicio del servidor TFTP

Debemos realizar algunos ajustes en la configuracin para que funcione

correctamente. Por esto, seleccionamos la opcin CONFIGURE del men FILE:

Figura 3: Elegimos la opcin configuracin del men File

En la pestaa TFTP Root Directory, indicamos dnde queremos que se guarden

los ficheros que enviamos y recibimos desde el cliente:

Figura 4: En Root Directory se guardarn los ficheros enviados y recibidos

Por ltimo, debemos especificar en la pestaa SECURITY que queremos transmitir y

recibir ficheros:

Figura

5:

Permitimos enviar y recibir archivos

Con esto ya tendramos configurado el servidor de TFTP.

1.2.- Entorno de desarrollo EDColdFire para la plataforma ENT2004CF

Este software est disponible en el siguiente enlace:
http://lorien.die.upm.es/lsed/?status=documentos

Figura 6: Seccin de la pgina del laboratorio donde descargar el programa

No son necesarios programas adicionales para que el EDColdFire funcione.

Instalamos este software que es el que nos permitir ejecutar los programas que
manejan el mdulo Ethernet del Coldfire, as como la comunicacin con la plataforma
ENT2004CF.

2.- Hardware Requerido

Para poder llevar a cabo operaciones con el mdulo Ethernet del Coldfire se
necesita el siguiente hardware:
-

Plataforma ENT2004CF que contiene un MCF5272 junto con los circuitos

pertinentes para su correcto funcionamiento.
Direccin MAC e IP para la plataforma.

Existen dos posibles configuraciones de conexin de la plataforma para operar

con el mdulo Ethernet:
-

Configuracin 1: La plataforma y el PC conectados a travs de un switch de

comunicaciones a una red IP.
Para esta conexin se necesitan dos cables de red y un switch. Cada uno
de los cables se emplea para conectar tanto el PC (servidor) como la
salida Ethernet de ENT2004CF con el switch.

Figura 7: Configuracin de la conexin mediante un switch

Configuracin 2: La plataforma directamente conectada a un PC (servidor)

Para este tipo de conexin se necesita un cable de red cruzado para
conectar la salida del mdulo Ethernet con la entrada de red del PC.

3.- Uso del Sistema

Lo primero que tendremos que hacer ser abrir el entorno de desarrollo
EDColdFire, abrir la conexin con la plataforma ENT2004CF mediante el men
conexin

y ejecutar el servidor de TFTP en el ordenador servidor.

Para poner en funcionamiento el cliente TFTP en el ColdFire debe ejecutarse en el

entorno de desarrollo el programa EJEMPLO_TFTP.c que se encuentra en el fichero
EthernetMCF5272.zip. Para ello, tendremos que descomprimir dicho fichero, abrir el
fichero EJEMPLO_TFTP.c y compilarlo (empleando el botn
). A continuacin,
cargar el programa EJEMPLO_TFTP.hcf, que es el archivo con el cdigo mquina que
se cargar en el Coldfire. Para ello, pulsamos el botn
seleccionamos el programa EJEMPLO_TFTP.hcf.

y en el men Cargar

Figura 8: Pantalla en la que se selecciona el programa a cargar en el Coldfire

Le damos al botn correspondiente a la ejecucin sin puntos de parada

y abrimos la ventana del Terminal. Al abrirla, deber tener el siguiente aspecto, que se
corresponde con la pantalla de inicio del cliente de TFTP:

Figura 9: Pantalla de inicio del programa

3.1.- Comando help

Si escribimos el comando help se desplegar un men en el que aparecen

todos los comandos que podemos ejecutar, junto con sus parmetros y una pequea
descripcin:

Figura 10: Escribimos help

Figura 11: Men help con explicacin de los comandos y sus parmetros

3.2.- Comando md
Si escribimos el comando md, aparecer un men en el que se muestran los
datos guardados en el espacio de memoria del Coldfire reservado para el usuario, que
comienza en la direccin de memoria guardada en al variable USERSPACE. La
primera lnea indica la posicin de memoria a partir de la cual se leern cuatro palabras
de 32 bits; el nmero que aparece est expresado con formato hexadecimal.A
continuacin escribe las cuatro palabras de 32 bits con los correspondientes datos
almacenados en cada una de ellas, expresados en hexadecimal. Por ltimo, se escribe la
traduccin a cdigo ASCII de lo almacenado, que se corresponder con el archivo
enviado o recibido.

Figura 12: El comando md presenta las posiciones de memoria y lo que almacenan

3.3-Comando show
Al introducir este comando aparecern en pantalla los parmetros asociados con
la comunicacin como son: la direccin IP del servidor, la direccin IP del cliente, la
direccin de la pasarela, la mscara de red, la direccin MAC y el nombre del fichero
que vamos a enviar.

Figura 13: Aparecen los parmetros de la comunicacin junto con sus valores

Todos estos parmetros podrn ser modificados mediante el comando set, que
explicaremos a continuacin.

10

3.4- Comando set

Este comando nos permitir modificar alguno de los parmetros que aparecen al
desplegarse el men asociado al comando show. Estos parmetros son:
o
o
o
o
o
o

Direccin IP del servidor:

138.100.30.125
Direccin IP del cliente:
138.100.30.121
Direccin IP de la pasarela: 138.100.30.1
Mscara de red:
255.255.255.128
Direccin MAC:
0.11.203.255
Nombre del fichero con el que vamos a trabajar

Dichos parmetros estn inicializados con los valores por defecto indicados
arriba en el archivo tftp_main.c al principio junto con las dems constantes
estticas.
La sintaxis de este comando es:
set <parmetro a modificar> <nuevo valor parmetro>
Explicamos este comando con un ejemplo. En este ejemplo modificaremos la
direccin IP del cliente. Supongamos que queremos que nuestro cliente sea aquel con
direccin IP: 138.100.30.130.
Lo primero que hacemos es ejecutar el comando show para ver los valores
asociados a cada parmetro antes de llevar a cabo el cambio. Vemos que la direccin IP
del cliente es: 138.100.30.121.
A continuacin escribimos:
set client 138.100.30.130
Con esta sentencia indicamos que lo que queremos modificar es el valor
asociado al cliente y que el nuevo valor es 138.100.30.130.
Por ltimo, volvemos a ejecutar show para comprobar que la direccin del
cliente se ha modificado correctamente.

11

Figura 14: Vemos cmo cambia la direccin cliente tras aplicar el set

3.5- Comando quit

Este comando nos permitir finalizar la conexin con el servidor TFTP.

Figura 15: Con quit cerramos la conexin

3.6- Comando read

Este comando nos permite descargar en la memoria del Coldfire el archivo
guardado en el directorio ROOT del servidor de TFTP cuyo nombre coincida con el
nombre almacenado en el parmetro filename.
La sintaxis del comando es:

12

read <nombre del archivo a leer>

Figura 16: Leemos del servidor

Una vez terminada correctamente la descarga, nos indicar el nmero de bytes

que han sido leidos. En el caso de la figura anterior han sido leidos 19 bytes.
Cuando hagamos la lectura, una vez finalizada la desgcarga del archivo
podremos observar algo similar a la siguiente figura en la pantalla del servidor TFTP:

Figura 17: Pantalla del servidor una vez finalizada la lectura.

3.7.- Comando write

Este comando nos permitir enviar el nmero de bytes que queramos de los que
tenemos almacenados en el espacio de usuario de la memoria del Coldfire a un fichero
del servidor cuya direccin IP est guardada en el parmetro server que hemos
definido en el fichero tftp_main.c con el valor por defecto 138.100.30.125.
La sintaxis del comando es:

13

write <n bytes a enviar> <nombre del fichero donde lo guardar en destino>

Figura 18: Escribimos 19 bytes en el fichero test5.txt

El programa lo que har ser crear un archivo con el nombre indicado en el

directorio ROOT del servidor TFTP si no exista o sobrescribirlo si ya estaba creado.
La pantalla del servidor, despus de una operacin de lectura (descarga de un
fichero) seguida de una operacin de escritura (carga) tendr el siguiente aspecto:

Figura 19: Pantalla del servidor despus de una lectura y una escritura.

14

ANEXO
Los programas necesarios para poder ejecutar el controlador del mdulo
Ethernet se encuentran en el fichero EthernetMCF5272.zip y son los siguientes:

Nombre
Fichero
arp.c

del Breve Descripcin

arp.h
EJEMPLO_TFTP.c
eth.h
fec.c
fec.h
icmp.c
icmp.h
ip.c
ip.h
m5272.h
m5272c3.h
m5272lib.c
m5272lib.h
mcf5xxx.h
nbuf.c
nbuf.h
nif.c
nif.h
start.asg

Descripcin de las rutinas para el Protocolo de Resolucin de

Direccines (ARP)
Definicin de tipos y declaracin de funciones para manejo de
ARP
Programa principal para el manejo de Ethernet
Definicin de tipos y declaracin de funciones para crear la trama
de Ethernet
Implementacin de las rutinas para el driver FEC (Fordward
Error Correction) del MCF5272
Definicin de tipos y declaracin de funciones para manejo del
driver FEC
Rutinas para manejar los paquetes ICMP
Definicin de tipos y declaracin de funciones para la creacin y
manejo de los paquetes ICMP
Rutinas para el manejo del Protocolo de Internet (IP)
Definicin de tipos y declaracin de funciones para el manejo del
Protocolo de Internet (IP)
Macros para escribir en los registros y en memoria, vectores de
rutinas de interrupcin y constantes para mscaras y direcciones
Definiciones para el controlador de interrupciones, informacin
acerca del Timer y mapa de memoria
Funciones para la plataforma de desarrollo ENT2004CF
Definicin de tipos y declaracin de funciones para la plataforma
de desarrollo ENT2004CF
Definiciones comunes para todos los procesadores Coldfire
Rutinas para la implementacin del esquema del Buffer de Red
Definiciones para la asignacin del Buffer de red
Rutinas de la Interfaz de Red
Definicin de tipos y declaracin de funciones para la Interfaz de
red
Esqueleto en ensamblador que nos permite unir todos los ficheros
y ejecutarlos.

15

stdlib.c
stdlib.h
tftp.c
tftp.h
tftp_main.c
tftp_main.h
timer.c
timer.h
udp.c
udp.h

Funciones que se encuentran normalmente en una librera

estndar de C
Definicin de tipos y declaracin de funciones para las funciones
de la librera estndar
Rutinas para la lectura de ficheros desde un servidor remoto
mediante TFTP (Trivial File Transfer Protocol)
Definicin de tipos y declaracin de funciones para TFTP
Rutinas de la interfaz del protocolo TFTP con el usuario
Definicin de tipos y declaracin de funciones para la interfaz del
protocolo TFTP con el usuario
Rutinas para acceder a los mdulos de timer
Definicin de tipos y declaracin de funciones para acceder a los
mdulos del timer
Rutinas para el manejo del UDP (User Datagram Protocol)
Definicin de tipos y declaracin de funciones para el UDP

16