Subversion Repositories phr

\documentclass [a4paper,11pt]{article}

% Configuración del idioma

\usepackage [utf8] {inputenc}

\usepackage [spanish] {babel}

\addto\captionsspanish{\renewcommand{\contentsname}{Contenidos}}

% Para incluir gráficos

\usepackage{graphicx}

%

\ProvidesPackage{reporte-phr}

\usepackage{reporte-phr}

% Para el titulo

\def\logo{./img/title/phr_logo.pdf}

\def\producto{Interfáz gráfica de usuario\par \vspace{0.5ex} PHR GUI v0.1}

\title{Guía de Instalación y uso}

%\author{Maximiliano Quinteros}

\def\docver{BETA}

\date{Abril de 2013}

%comandos por maximiq

\newcommand{\problema}[1]{\vspace{1.5ex}\textbf{Problema: #1}}

\newcommand{\solucion}[1]{\vspace{1.5ex}\textbf{Solución:} #1 \vspace{1.5ex}}

\begin {document}

\maketitle

\tableofcontents

\clearpage

\section{Introducción}

Para transferir el diseño que realiza el usuario a la FPGA es necesario establecer una comunicación entre la computadora donde se sintetiza el proyecto y la FPGA de la placa PHR. En bajo nivel la computadora se comunica a través de un puerto USB con el chip FT2232D de la placa OOCDLink que luego se conecta mediante interfaz JTAG con la FPGA y la PROM. Subiendo en el nivel de abstracción es necesario un software que tome un archivo generado por la herramienta de síntesis y lo envíe a través de los drivers del sistema operativo al dispositivo concreto.

PHR GUI es una interfaz gráfica que permite al usuario transmitir los datos de una manera muy sencilla sin la necesidad de tener que sumirse en los pormenores de la transferencia del fichero. Si bien este es el software con el que interactúa el usuario tiene que considerarse simplemente como un front-end para la aplicación que hace el verdadero trabajo. Esta es la denominada xc3sprog.

\begin{figure}[!h]

\centering

  \includegraphics{./img/intro/front-end.pdf}

  \caption{PHR GUI es una interfaz que facilita el uso de xc3sprog.}

%  \label{none}

\end{figure}

Xc3sprog\footnote{http://xc3sprog.sourceforge.net/} es en realidad un conjunto de aplicaciones de licencia libre que funciona en linea de comandos y sirve para programar mediante JTAG varios dispositivos. Su nombre hace referencia a que inicialmente fue diseñado para la familia de FPGA Spartan-3 de Xilinx. Sin embargo se ha extendido el manejo a otros tipos de dispositivos que incluyen otras FPGAs, CPLDs, XCF flash PROMs, microprocesadores AVRs de Atmel y memorias flash SPI. Xc3sprog soporta varios cables JTAG, incluyendo cables de puerto paralelo y programadores USB.

Es además capaz de funcionar con los drivers propietarios del chip FT2232D o con la libreria libre libUSB. Se encuentra disponible para los sistemas Linux y Windows.

\section{Instalación}\label{sec:instalacion}

\subsection{MS Windows}

Actualmente PHR GUI para Windows funciona con los drivers propietarios ofrecidos por el fabricante del chip FT2232D, Future Technology Devices International.

El procedimiento general para hacer correr la aplicación en los sistemas Windows consiste en primero descargar los drivers propietarios del FT2232D. Luego instalarlos para poder conectar la placa OOCDLink. Por último instalar la PHR GUI v0.1 que distribuye los binarios de xc3sprog.

A continuación se desarrolla el procedimiento específico para Windows XP.

\subsubsection{Windows XP}

Necesitará el hardware PHR y los siguientes paquetes de software:

\begin{description}

\item[Drivers D2XX:] Son los drivers provistos por FTDI y están disponibles en distintas formas. Este manual  ejemplifica la instalación con la versión ejecutable. En particular se usa el archivo \texttt{CDM v2.10.00 WHQL Certified.exe}, pero se recomienda la versión mas nueva al momento de la descarga.

Para descargarlo consulte: \texttt{http://www.ftdichip.com/Drivers/}.

En la misma página puede ver el procedimiento mas detallado de instalación.

\item[Instalador de PHR GUI v0.1:] Se puede obtener de la sección de descargas en el sitio web del proyecto: \texttt{http://opencores.org/project,phr,downloads}.

\end{description}

\subsubsection*{Procedimiento:}

\begin{enumerate}

\item  Ejecutar el asistente de instalación de los drivers D2XX. Esto prepara al sistema para que en el próximo paso se reconozcan los controladores de una forma mas sencilla.

\begin{figure}[!h]

\centering

  \includegraphics[width=0.9\textwidth]{./img/instalacion/ftdi-wiz.pdf}

%  \caption{caption.}

%  \label{none}

\end{figure}

Si Windows le muestra una advertencia de que el software no supera la prueba de compatibilidad con Windows XP elija \emph{Contibuar}.

\item Conectar la PHR al USB

PICTURES MISSING

\item Ejecutar el instalador de PHR GUI v0.1.

\begin{figure}[!h]

\centering

  \includegraphics[width=0.9\textwidth]{./img/instalacion/phr-gui-wiz.pdf}

%  \caption{caption.}

%  \label{none}

\end{figure}

Una vez terminado el asistente puede optar por abrir el programa que debe estar listo para ser utilizado.

\end{enumerate}

\subsection{Linux}

La instalación en los sistemas Linux no es necesaria ya que PHR GUI v0.1 está desarrollada en el lenguaje Python 2.7.6 y las distribuciones Linux incluyen un interprete Python. Sin embargo hay que seguir una serie de pasos que están relacionados en su mayoría con el software xc3sprog. Se describe el procedimiento general:

\begin{enumerate}

\item Obtenga los binarios de xc3sprog. Para esto hay dos opciones:

        \begin{enumerate}

        \item Descargar desde la web los binarios ya compilados para la arquitectura específica (\texttt{http://sourceforge.net/projects/xc3sprog/}).

        \item Descargar desde la web o a través de svn el código fuente del proyecto y compilarlo manualmente.

        \end{enumerate}

\emph{Nota:} Xc3sprog hace uso de los paquetes \emph{usblib} y \emph{libftdi}.

\item Desde el sitio web de PHR descargue PHR GUI v0.1 para Linux.

\item Descomprima el archivo anterior.

\begin{lstlisting}

user@host:phr-gui$ comando para descomprimir

cd ./phr-gui/

chmod +x phr-gui.py

\end{lstlisting}

\item xc3sprog link

\begin{lstlisting}

link

\end{lstlisting}

\item ejecucion del programa

\end{enumerate}

\section{Uso de la interfaz}

Para poder transferir el diseño a la placa el usuario debe realizar la síntesis del proyecto y generar un archivo en formato BIT que es el formato por defecto de Xilinx.

Una ves obtenido el fichero, la PHR ofrece dos posibilidades al momento de descargar el diseño sobre la FPGA. Un método consiste en transferir los datos directamente a la FPGA (\emph{configuración de la FPGA}) y el otro método consiste en transferirlos a la PROM (\emph{programación de la PROM}). El primero es mucho mas rápido pero debido a la volatilidad de la FPGA tiene la desventaja de que se pierde el diseño una vez que el circuito es desenergizado. Contrariamente, el segundo es un procedimiento mas lento pero su ventaja radica en que los datos se conservan en los sucesivos ciclos de encendido y apagado.

La forma en que se setea la FPGA para que ésta tome los datos de una u otra fuente es mediante un selector en donde un jumper se cambia de posición. El hecho se ilustra en la Fig. \ref{cargaFPGA}. Luego el usuario debe interactuar con la interfaz PHR GUI (ver Fig. \ref{phrgui}) para que la computadora efectivamente envíe los datos correspondientes.

\begin{figure}[!h]

\centering

  \includegraphics{./img/uso/fpgaSelector.pdf}

  \caption{Selección de la fuente de carga.}

  \label{cargaFPGA}

\end{figure}

\begin{figure}[!h]

\centering

  \includegraphics[width=11cm]{./img/uso/msw9x.png}

  \caption{Interfaz de usuario PHR GUI.}

  \label{phrgui}

\end{figure}

\subsection{Configuración de la FPGA}

Procedimiento para transferir el diseño a la FPGA:

\begin{enumerate}

\item Coloque el jumper de la PHR para que la FPGA cargue desde JTAG (ver Fig. \ref{cargaFPGA}).

\item Elija el archivo BIT que desea transferir desde el diálogo que surge al presionar el botón \emph{Elegir fichero}.

\item Luego presione el botón \emph{Configurar FPGA}.

\item El software xc3sprog es invocado y PHR GUI muestra su salida.

\item El diseño debe comenzar a funcionar una vez terminado el proceso de descarga.

\end{enumerate}

\subsection{Programación de la PROM}

Procedimiento para transferir el diseño a la PROM:

\begin{enumerate}

\item Coloque el jumper de la PHR para que la FPGA cargue desde PROM (ver Fig. \ref{cargaFPGA}).

\item Elija el archivo BIT que desea transferir desde el diálogo que surge al presionar el botón \emph{Elegir fichero}.

\item Presione el botón \emph{Programar PROM}.

\item El software xc3sprog es invocado y PHR GUI muestra su salida.

\item Una vez terminado el proceso de programación, presione el botón de RESET en la placa PHR (ver Fig.  \ref{cargaFPGA}) para que la FPGA cargue el diseño.

\end{enumerate}

\subsection{Interpretación de las salidas de texto}

\subsubsection*{Comprobar conexión}

Para verificar que el hardware esté bien conectado se puede recurrir al botón \emph{Comprobar conexión}. Al presionarlo se espera una salida como la siguiente:

\begin{lstlisting}

PHR>>> ./xc3sprog -c ftdiphr

XC3SPROG (c) 2004-2011 xc3sprog project $Rev: 164 $ OS: Linux

Free software: If you contribute nothing, expect nothing!

Feedback on success/failure/enhancement requests:

        http://sourceforge.net/mail/?group_id=170565

Check Sourceforge for updates:

        http://sourceforge.net/projects/xc3sprog/develop

Using Libftdi,

JTAG loc.:   0  IDCODE: 0x02218093  Desc:    XC3S200A Rev: A  IR length:  6

JTAG loc.:   1  IDCODE: 0xd5045093  Desc:      XCF02S Rev: M  IR length:  8

\end{lstlisting}

Lo importante son las dos últimas líneas en donde se reconocen 2 elementos en la cadena JTAG. En la posición 0 con ID 0x02218093 se encuentra la FPGA (XC3S200A). En la posición 1 con ID 0xd5045093 se encuentra la PROM (XCF02S).

\subsubsection*{Configurar FPGA}

\begin{lstlisting}

luis@luis-laptop:build$ ./xc3sprog -v -c ftdiphr -p 0 /media/datos3/temp/xilinx_projects/PHRprojects/test1/test1_top.bit:w:0:BIT

XC3SPROG (c) 2004-2011 xc3sprog project $Rev: 164 $ OS: Linux

Free software: If you contribute nothing, expect nothing!

Feedback on success/failure/enhancement requests:

        http://sourceforge.net/mail/?group_id=170565

Check Sourceforge for updates:

        http://sourceforge.net/projects/xc3sprog/develop

Using devlist.txt

Using cablelist.txt

Cable ftdiphr type ftdi VID 0x0403 PID 0x6010 dbus data 00 enable 0b cbus data 00 data 00

Using Libftdi, Using JTAG frequency   6.000 MHz from undivided clock

JTAG chainpos: 0 Device IDCODE = 0x02218093     Desc: XC3S200A

Created from NCD file: test1_top.ncd;UserID=0xFFFFFFFF

Target device: 3s200avq100

Created: 2014/03/19 18:31:15

Bitstream length: 1196128 bits

DNA is 0x95cde80efb9ba0fe

done. Programming time 288.0 ms

USB transactions: Write 83 read 9 retries 18

\end{lstlisting}

\subsubsection*{Programar PROM}

\begin{lstlisting}

luis@luis-laptop:build$ ./xc3sprog -v -c  ftdiphr -p 1 /media/datos3/temp/xilinx_projects/PHRprojects/test1/output/Untitled.mcs:w:0:IHEX

XC3SPROG (c) 2004-2011 xc3sprog project $Rev: 164 $ OS: Linux

Free software: If you contribute nothing, expect nothing!

Feedback on success/failure/enhancement requests:

        http://sourceforge.net/mail/?group_id=170565

Check Sourceforge for updates:

        http://sourceforge.net/projects/xc3sprog/develop

Using devlist.txt

Using cablelist.txt

Cable ftdiphr type ftdi VID 0x0403 PID 0x6010 dbus data 00 enable 0b cbus data 00 data 00

Using Libftdi, Using JTAG frequency   6.000 MHz from undivided clock

JTAG chainpos: 1 Device IDCODE = 0xd5045093     Desc: XCF02S

Erasing......done

Erase time 3158.5 ms

Programming does not end at block boundary (nbits = 1196432), padding

Programming block    292/   293 at XCF frame 0x2480.done

Programming time 3236.6 ms

Verify block    292/   293 at XCF frame 0x2480

Success! Verify time 938.0 ms

USB transactions: Write 903 read 890 retries 2040

\end{lstlisting}

\section{Soluciones a problemas frecuentes}

%\subsection{Instalación}

%\subsection{Uso de la interfaz}

\problema{[Windows] Cualquiera de los tres botones, Configurar FPGA, Programar PROM o Comprobar conexión, invocan comandos pero no producen salida alguna}

\solucion{Si la placa OOCDLink no se conectó nunca en la computadora, posiblemente sea necesario instalar la librería para que xc3sprog funcione correctamente. Consulte la sección \ref{sec:instalacion} para instalar la placa.}

\problema{}

\solucion{}

\end {document}