Elaborado por Ana Eugenia Sánchez Villalobos
Revisado por Erick Carvajal Barboza
Email: erick punto carvajal punto barboza arroba ucr punto ac punto cr
Escuela de Ingeniería Eléctrica, Universidad de Costa Rica
En esta guía de instalación encontrará los pasos necesarios para instalar y ejecutar el flujo de diseño de circuitos integrados OpenLane. Los paquetes que se instalarán en este tutorial corresponden a la configuración básica. Para utilizar versiones distintas diríjase al siguiente enlace donde encontrará una guía breve para la instalación de otros paquetes para el uso de OpenLane.
Antes de instalar es necesario tener instalados los siguientes requerimientos:
En caso de tener alguno de estos programas instalados y no saber su versión,
puede utilizar el comando version en la terminal,
como el siguiente ejemplo:
>$ git version
Para la instalación de esta es importante tener en cuenta que se utilizará
Python3. Virtualenv, es una herramienta que permite crear entornos virtuales
aislados de Python. Para instalar virtualenv, basta con ejecutar
la siguiente línea de código en la terminal:
>$ sudo apt install -y build-essential python3 python3-venv python3-pip
Nota: Podría ser necesario tener permisos de root para instalar los paquetes correctamente.
Para evitar problemas de instalación del paquete Docker,
es importante desinstalar cualquier versión desactualizada. Para remover dichas
versiones ejecute la siguiente línea en la terminal.
>$ sudo apt-get remove docker docker-engine docker.io containerd runc
Para instalar Git, ejecute las siguientes lineas de código en la terminal.
>$ sudo apt-get update
>$ sudo apt-get install git-all
Es posible verificar la instalación utilizando el comando version,
de forma que si no se instaló correctamente, mostrará un mensaje de error.
Para instalar docker es importante contar con la versión de
64-bits de alguna de las siguientes distribuciones de Ubuntu:
Antes de instalar docker por primera vez, es necesario
configurar el repositorio, para esto ejecute los siguientes comandos en la
terminal:
>$ sudo apt-get update
>$ sudo apt-get install ca-certificates curl gnupg lsb-release
Luego de esto se añade la llave GPG oficial de Docker, en otras palabras el GNU Privacy Guard de Docker, con las siguientes líneas en la terminal.
>$ sudo mkdir -p /etc/apt/keyrings
>$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
Ahora, para configurar el repositorio ejecute el siguiente comando:
>$ echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
Para instalar Docker se ejecutan las siguientes líneas de código en la terminal:
>$ sudo apt-get update
>$ sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin
Para verificar la correcta instalación, ejecute el siguiente comando:
>$ sudo docker run hello-world
Para evitar el uso constante de sudo debe crear un grupo llamado docker mediante el siguiente comando:
>$ sudo groupadd docker
Luego, debe agregar su usuario a ese grupo, usando el siguiente comando:
>$ sudo usermod -aG docker ${USER}
Para que estos cambios tomen efecto debe reiniciar la computadora o cerrar
la sesión (hacer log-off) de su computadora. Puede verificar que haya sido
agregado correctamente al grupo ejecutando el comando groups
en la terminal.
Actualmente OpenLane no está soportado en Windows. Si no desea instalar
algún sistema operativo basado en Linux en su computadora, deberá utilizar una
máquina virtual e instalar algún sistema operativo Linux en la misma.
Se recomienda el uso de VirtualBox, pero cualquier plataforma de
virtualización debería funcionar correctamente.
Posteriormente, siga las instrucciones para instalar OpenLane en Linux mostradas en la Sección anterior.
Instale el administrador de paquetes Homebrew y posteriormente instale los pre-requisitos utilizando el siguiente comando:
>$ brew install python make brew install --cask docker
El procedimiento mostrado a continuación fue validado en una computadora con Ubuntu 20.04.4 LTS, distintas distribuciones de Linux o MacOS podría requerir pasos adicionales.
En esta sección se muestran los pasos necesarios para la instalación de OpenLane, el cual incluye la instalación del PDK (Physical Design Kit) SkyWater SKY130, el cual se utilizará para la ejecución de todas las etapas (Síntesis Lógica, Floorplan, Posicionamiento y Enrutamiento Automático, Extracción, Análisis Estático de Temporización, etc).
Los comandos que se deben ejecutar se muestran a continuación (podría necesitar permisos de root):
>$ git clone https://github.com/The-OpenROAD-Project/OpenLane.git
>$ cd
>$ sudo make
>$ make test
La línea make test, hace una prueba que tarda alrededor de 5
minutos y verifica la instalación correcta de cada etapa del flujo y los PDKs.
Si fuera necesario, para actualizar OpenLane y los archivos que incluye, se deben ejecutar
las siguientes líneas de código. Dentro de estas líneas se incluye el comando
make test, esto para asegurarse del correcto funcionamiento del flujo.
>$ cd OpenLane/
>$ git checkout master
>$ git pull
>$ make
>$ make test
Luego de haber seguido todos los pasos correctamente, podemos proceder a utilizar OpenLane, para esto se debe ejecutar las siguientes dos líneas:
>$ export PDK_ROOT=se encuentran las instalaciones de skywater-pdk, open_pdks, y sky130A>
>$ export OPENLANE_IMAGE_NAME=
Estas líneas de código deben ejecutarse dentro de la carpeta de OpenLane,
la cual fue creada en la sección de instalación de docker.
La ruta al archivo donde se encuentran las instalaciones de skywater-pdk,
open_pdks, y sky130A, es usualmente
Luego de esto se ejecuta la siguiente línea para entrar al entorno de OpenLane.
>$ make mount
Para encontrar una lista actualizada de las preguntas más comunes puede ir al siguiente enlace.