Profiling Tool Manual

User Manual:

Open the PDF directly: View PDF .
Page Count: 10

Download
Open PDF In Browser	View PDF

Herramienta de perfilado para una arquitectura basada en
RISC-V
Manual de instalación y de usuario

Arturo Salas Delgado - 201229804

Manual de instalación
Las herramientas necesarias para la utilización de la herramienta de perfilado basada en una
arquitectura basada en RISC-V son el Toolchain de RISC-V y un simulador llamada rv8. Además, se
debe de descargar la herramienta de perfilado para poder ser usada. Los pasos para su instalación son
los que se muestran a continuación:
Toolchain RISC-V
Para la instalación de este toolchain, que contiene el compilador de RISC-V para poder programar un
procesador desde código C, se van a requerir de las siguientes bibliotecas:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•

autoconf
automake
autotools-dev
curl
libmpc-dev
libmpfr-dev
libgmp-dev
gawk
build-essential
bison
flex
texinfo
gperf
libtool
patchutils
git

El siguiente comando debe ser ejecutado en una terminal de Linux para la instalación de las bibliotecas
mencionadas anteriormente:
$ sudo apt-get install autoconf automake autotools-dev curl libmpc-dev libmpfr-dev libgmp-dev
gawk build-essential bison flex texinfo gperf libtool patchutils git
Se debe clonar el repositorio del toolchain de RISC-V mediante el siguiente comando:
$ git clone https://github.com/riscv/riscv-gnu-toolchain riscv-gnu-toolchain-rv32i
Una ver clonado el repositorio, se entra al directorio creado usando el siguiente comando:
$ cd riscv-gnu-toolchain-rv32i
Para verificar que ha sido clonado de manera correcta, se usa el siguiente comando:
$ git checkout bf5697a

Para la búsqueda de actualizaciones se usa el siguiente comando:
$ git submodule update --init –recursive
Y una vez completado los pasos anteriores, se procede a instalar la herramienta mediante el siguiente
comando:
$ sudo ./configure –with-arch=rv32i
En caso de existir un error en la ejecución del comando anterior, se procede a ejecutar el siguiente
comando:
$ sudo ./configure --with-xlen=32 –with-arch=I
Y para completar la instalación se ejecuta el siguiente comando:
$ sudo make -j$(nproc)
Una vez instalado el toolchain de RISC-V, se procede a la instalación de la herramienta elf2hex para el
tratamiento de archivos .elf que contienen el ensamblado de un programa compilado. Se debe de clonar
el repositorio mediante el uso del siguiente comando:
$ git clone https://github.com/riscv/riscv-fesvr riscv-fesvr
Se entra al nuevo directorio creado:
$ cd riscv-fesvr/
Se configura la herramienta mediante el uso del siguiente comando:
$ sudo ./configure
Y finalmente se procede a la instalación:
$ sudo make install
Simulador rv8
Además del toolchain de RISC-V, es necesario la instalación de una herramienta llamada rv8, el cual es
un simulador basado en las diferentes arquitecturas de RISC-V para obtener métricas según el usuario
desee.

El primer comando a ejecutar para la instalación del simulador es el siguiente:
$ export RISCV=/opt/riscv/toolchain
Ahora se procede a clonar la herramienta mediante el uso del siguiente comando:
$ git clone https://github.com/rv8-io/rv8.git
Se entra al directorio creado:
$ cd rv8
Se procede a actualizar los submódulos de la herramienta usando el siguiente comando:
$ git submodule update --init –recursive
Se prepara la herramienra para su instalación:
$ make
Y se instala la herramienta usando el siguiente comando:
$ sudo make install
Herramienta de perfilado
Para el uso de la herramienta de perfilado, se debe de clonar el repositorio mediante el uso del siguiente
comando:
$ git clone https://github.com/artsaldel/ProfilingTool.git
Se entra al directorio nuevo:
$ cd ProfilingTool
Y se configura la compilación necesaria mediante la ejecución del siguiente comando:
$ make

Manual de Usuario
Para el uso de la herramienta de perfilado para una arquitectura basada en RISC-V se debe de abrir una
terminal de linux e ingresar al directorio de la herramienta mediante el siguiente comando:
$ cd ProfilingTool
Una vez ahí, solamente se debe de ejecutar un script llamado tool.sh mediante el siguiente comando:
$ sh tool.sh
La terminal mostrará la siguiente interfaz de usuario:

Si se desea crear un nuevo programa en C para ser simulado, se debe de ingresar la opción #1 al
sistema, donde se habilitará la edición de un programa llamado program.c que podrá ser simulado por
la herramienta después. Se edita el archivo, se guarda pulsando “ctrl + O” y se sale de la edición
pulsando “ctrl + X”. Una vez seleccionado se mostrará lo siguiente:

En caso de tener un programa en C existente y funcional, solamente se debe de seleccionar la opción #2
e ingresar el path donde se encuentra el archivo .c, tal como se muestra a continuación:

Si se desea editar editar el archivo de configuración para una arquitectura basada en pipeline, se debe
de ingresar la opción #3. La edición de este archivo es tal como se muestra a continuación:

Nota: Es necesario que el archivo de configuración tenga el formato mostrado anteriormente, en caso
de no ser así, la aplicación no obtendrá las métricas necesarias para la simulación. Además, el archivo
correspondiente a esta configuración se encuentra en el directorio raíz con el nombre de
config_pipeline.config.
Si se desea editar editar el archivo de configuración para una arquitectura basada en multiciclo, se debe
de ingresar la opción #4. La edición de este archivo es tal como se muestra a continuación:

Nota: Es necesario que el archivo de configuración tenga el formato mostrado anteriormente, en caso
de no ser así, la aplicación no obtendrá las métricas necesarias para la simulación. Además, el archivo
correspondiente a esta configuración se encuentra en el directorio raíz con el nombre de
config_multicycle.config.
Y una vez completado el programa en C y los archivos de configuración, se procede a la simulación
para obtener tiempos de ejecución seleccionando la opción #5. El sistema mostrará la opción de
seleccionar la arquitectura sobre la cual se desea basar la simulación, tal como se muestra a
continuación:

Para simular sobre una arquitectura pipeline, se debe de ingresar la opción #1. Para simular sobre una
arquitectura multiciclo, se debe ingresar la opción #2. Los tiempos de ejecución resultantes se guardan
en un archivo llamado timeResults.txt ubicado en la raíz del directorio. Además, el set de instrucciones
que podrá ser ejecutado por una arquitectura basada en RISC-V se encuentra en un archivo llamado
executableBinary.txt ubicado en la raíz del directorio. También, los tiempos resultantes se muestran en
la terminal tal como se muestra a continuación:

Una vez ejecutada la simulación en el menú principal se debe de seleccionar la opción #6 para salir de
la herramienta de perfilado.



---

Source Exif Data:

File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.4
Linearized                      : No
Page Count                      : 10
Language                        : es-CR
Creator                         : Writer
Producer                        : LibreOffice 5.3
Create Date                     : 2018:06:02 08:32:18-06:00

EXIF Metadata provided by EXIF.tools