| Siguiente: 7. Conclusiones Superior: Hospedaje Linux de multicomputadores Anterior: 5. El hardware de |
El driver, exaustivamente documentado en [IRA00], es un m�dulo cargable ([RUB98]) denominado M�dulo QPC/C40S, seg�n muestra la Fig. 14.
Nuestro driver ofrece una interfaz a los procesos de usuario basada en dispositivos para gestinar los recursos de la QPC-C40S. Soporta los siguientes:
Las operaciones de lectura y escritura en estos dispositivos hacen accesible la memoria de intercambio a los procesos de usuario. El tama�o de los datos a intercambiar est� en funci�n del tama�o de cada partici�n. Las llamadas al sistema que soporta el driver son las siguientes:
Las operaciones read y write se pueden utilizar con todos los dispositivos. El tama�o de los datos puede ser cualquier n�mero de octetos, excepto para LIA, que ha de ser m�ltiplo de cuatro. Estas llamadas son bloqueantes tanto para LIA como para DPRAM, excepto en dpram0. En LIA el proceso invocante es bloqueado si los datos que pide no est�n disponibles (en una operaci�n de lectura), o cuando el dispositivo no est� vac�o a fin de recibir datos (en las operaciones de escritura).
El criterio para bloquear los procesos en los dispositivos dpramX se implementa con sem�foros, que informan sobre qui�n es el propietario temporal de la memoria correspondiente. La propiedad de la memoria alterna entre el DSP y el PC cuando uno escribe y el otro lee. Por ejemplo, el procesador I del DSP escribe una cadena de caracteres en /dev/dpram1, entonces dicho procesador no podr� volver a escribir hasta que alguien (lo m�s normal es que sea el PC) lea de /dev/dpram1 momento en el que se cambia el sem�foro.
La llamada ioctl est� indicada para realizar operaciones de configuraci�n sobre un dispositivo. Estas operaciones son dos, el reset y la inicializaci�n de la tarjeta, las cuales configuran la tarjeta usando los registros de entrada salida. Por ejemplo:
/*Reset de la tarjeta.*/
if(ioctl(LIA, QPCC40S_IOCTL_RESET) != 0){
printf("Imposible reset QPC\n");
exit (1);
}
/*Inicializar la tarjeta.*/
if(ioctl(LIA, QPCC40S_IOCTL_INIT) != 0){
printf("Imposible inicializar QPC\n");
exit (1);
}
El par�metro LIA es un descriptor del dispositivo LIA, el segundo par�metro especifica la operaci�n deseada. La llamada ioctl tambi�n se aprovecha para que los procesos de usuario puedan leer y escribir cualquier registro de entrada salida de la tarjeta. Para esto se utiliza el tercer par�metro de la llamada ioctl. Con �l se accede a una estructura con dos campos: el n�mero de registro y su valor. Por ejemplo, con las siguientes instrucciones se puede leer el registro de estado de la QPC:
DatosIoctl.NumReg = QPC_R_STATUS;
if(ioctl(descriptor,
QPCC40S_IOCTL_LEER_REGISTRO,
&DatosIoctl) != 0) {
printf("Imposible leer Reg. Estado\n");
exit (1);
}
La variable descriptor es un descriptor de cualquier dispositivo atendido por el driver. La variable DatosIoctl es una estructura de la siguiente forma:
struct Ioctl_Estructura{
unsigned short NumReg;
unsigned short ValorReg;
};
Cuando retorna, la llamada ioctl el campo ValorReg de la estructura contendr� el valor del registro de estado de la tarjeta.
Las macros
QPCC40S_IOCTL_LEER_REGISTRO,
QPCC40S_IOCTL_RESET,
QPC_R_STATUS...
y la estructura Ioctl_Estructura est�n definidas en el fichero de cabecera del driver: qpcc40s.h, por lo que dicho fichero debe ser incluido en los programas de usuario.
Hemos desarrollado una biblioteca de usuario que implementa utilidades de gesti�n de la QPC-C40S, seg�n muestra la Fig. 15. De momento, la utilidad m�s importante es el manejo de los ficheros ejecutables en formato COFF ([GIN98]), a fin cargarlos en los procesadores C44. Se espera que con el tiempo esta biblioteca vaya aumentando sus utilidades, a medida que ganemos experiencia en este trabajo.
Cuando una funci�n de la biblioteca encuentra un error devuelve un valor negativo, su valor absoluto especifica el tipo de error producido. Esta clasificaci�n de los errores se ha hecho imitando la biblioteca NetAPI de Blue Wave. Cada error tiene una macro asociada en el fichero de cabecera de la biblioteca (qpclib.h), y se ha implementado una funci�n que a partir de ese c�digo devuelve una cadena de texto explicativo del error:
char* QpcLib_TextoDeError(int);
Por ejemplo, si se produce un error al cargar el programa COFF en el C44, se usa la funci�n anterior para dar una informaci�n m�s ampliada al usuario:
/* Cargar el programa C40 deseado en el
* procesador I */
if((ret = QpcLib_CargarPrograma(LIA,
argv[1])) != QPCLIB_E_NOERR){
printf("Error al cargar %s en LIA: ",
argv[1]);
printf("\n%s\n",
QpcLib_TextoDeError(ret));
exit(1);
}
El compilador de Texas Instruments para la arquitectura C40 genera los programas en formato COFF. Esto nos obliga a comprender este formato de ficheros objeto a la hora de usar el driver para cargar programas en los procesadores C44. No se trata de comunicar el fichero COFF, tal cual, al procesador, sino interpretar dicho fichero y comunicar la informaci�n precisa. La biblioteca QpcLib ofrece la siguiente funci�n para realizar este trabajo:
int QpcLib_CargarPrograma (int, char *);
El primer par�metro es un descriptor del dispositivo /dev/lia, la funci�n supone que ya est� abierto y lo utiliza para escribir la informaci�n extra�da del fichero COFF. El segundo par�metro es el camino para encontrar el fichero COFF en el sistema. Devuelve un c�digo de error de la biblioteca.
Esta forma de cargar programas en un C40 obliga a tener un sistema operativo con sistema de ficheros. Puede ocurrir que el PC hu�sped de la tarjeta ejecute un sistema de tiempo real sin sistema de ficheros. Para solucionar esto, las rutinas que interpretan el formato COFF (fichero coff.c de la biblioteca) est�n controladas por una directiva de compilaci�n que, en vez de escribir el ejecutable C40 sobre el dispositivo LIA, lo escriben en un fichero de texto, en forma de secuencia de n�meros, de esta forma:
unsigned long ArrayCoff[] = {
796360720L /* 0x2F778010 */,
1038852176L /* 0x3DEBA050 */,
1L /* 0x1 */,
...... ........
3145728L /* 0x300000 */
};
Los n�meros se escriben formando la declaraci�n de un vector, con la intenci�n de que el fichero resultante pueda ser incluido en los fuentes de un programa. Ese programa, a la hora de cargar el ejecutable en el C40, no usar�a la funci�n QpcLib_CargarPrograma, sino que escribir�a en el dispositivo LIA cada uno de los n�meros de este vector. De esta forma no se necesita sistema de ficheros para cargar un ejecutable en los procesadores DSP. Para ello hay que compilar la biblioteca QpcLib con la opci�n coff_to_array:
make coff_to_array
De esta forma, el fichero coff.c de la biblioteca se transforma en un ejecutable llamado coff_to_array, que admite los siguientes par�metros:
coff_to_array Nombre_Fichero_COFF [Nombre_Fichero_Destino]
El primer par�metro es el fichero objeto en formato COFF, tal como lo deja el enlazador de Texas Instruments. El segundo par�metro es el nombre del fichero donde escribir el vector de n�meros. Si se omite, se escribe en un fichero llamado array.hh.