# CRIANDO A BIBLIOTECA
# ====================

# Crie um diretório <dir_lib> fixo para guardar a biblioteca. Neste
# diretório, crie um sub-diretório de  nome 'src' (sugestão) para quardar os
# códigos-fonte em VHDL com as 'packages' vhdl.
#
# OBS.: O  comando 'mkdir' precisa  ser executado  apenas 1 vez,  para a
#       criação dos diretórios da biblioteca.

mkdir -p <dir_lib>/src
cd <dir_lib>

# Editar no diretório '<dir_lib>/src' os códigos-fonte VHDL das 'package' que
# farão parte da Biblioteca desejada <lib_nome>.
# Veja como exemplo os arquivos:
#   http://www.inf.ufpr.br/nicolui/grad/ci068/geral/VHDL/lib/src/clocks.vhdl
#   http://www.inf.ufpr.br/nicolui/grad/ci068/geral/VHDL/lib/src/portas.vhdl
#
gedit src/<arquivo_package_1>.vhdl
......
gedit src/<arquivo_package_n>.vhdl

# No diretório <dir_lib>, compilar o código-fonte VHDL
ghdl -a -work=<lib_nome> -P<dir_lib> src/<arquivo_package_1>.vhdl ... src/<arquivo_package_n>.vhdl

# No diretório <dir_lib> são  criados os arquivos <arquivo_package_1>.o,
#  ..., <arquivo_package_n>.o e <lib_nome>-obj93.cf 

# Por exemplo, se os arquivos  VHDL "clocks.vhdl" e "portas.vhdl" formam
# a biblioteca "ci068", e o diretório da biblioteca é "${HOME}/lib/vhdl"
# teríamos:

mkdir -p ${HOME}/lib/vhdl/src    
cd ${HOME}/lib/vhdl
gedit src/clocks.vhdl
gedit src/portas.vhdl
ghdl -a -work=ci068 -P${HOME}/lib/vhdl src/clocks.vhdl src/portas.vhdl

# No  exemplo  acima, no  diretório  '${HOME}/lib/vhdl'  são criados  os
# arquivos 'clocks.o', 'portas.o' e 'ci068-obj93.cf'


# USANDO A BIBLIOTECA
# ===================
# 
# Ao editar os  arquivos VHDL de seu projeto, use  o cabeçalho abaixo para
# cada entity em seu arquivo que use os componentes da biblioteca:
#
#     library IEEE, <lib_nome>;
#     use IEEE.std_logic_1164.all;
#     use <lib_nome>.<package_1>.all;
#     .........
#     .........
#     use <lib_nome>.<package_n>.all;
#
# Nas  seções   'arquitecture'  não   se  coloca  'component'   para  os
# componentes que estão na biblioteca incluída no cabeçalho.
#
# Veja exemplos em:
#   http://www.inf.ufpr.br/nicolui/grad/ci068/geral/VHDL/exemplos/clock_lib.vhdl
#   http://www.inf.ufpr.br/nicolui/grad/ci068/geral/VHDL/exemplos/registrador_lib.vhdl
#

# COMPILANDO SEUS PROJETOS
# ========================
#
# Na   receita  de   compilação  já   existente,  acrescentar   a  opção
# '-P<dir_lib>' em cada comando 'ghdl':
#
gedit circuito.vhdl
ghdl -a -P${HOME}/lib/vhdl circuito.vhdl
ghdl -e -P${HOME}/lib/vhdl teste
ghdl -r -P${HOME}/lib/vhdl teste --vcd=teste.vcd
gtkwave teste.vcd