Skip to content

About

Blocos VHDL reutilizáveis do Insper-RISC-V: flip-flop, registradores, decodificadores, buffers e funções utilitárias. Base compartilhada por Core, Memory e Peripherals.

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

Common-Components

🌐 Português · English

Blocos genéricos de VHDL que o Core, a Memory e os Peripherals compartilham. Cada bloco existe aqui uma só vez, e os demais repositórios o importam como submódulo (Common-Components).

1. Documentação

  • docs/pt-br: uma página por entidade e pacote de src/, com finalidade, genéricos, portas, comportamento e pontos de uso; o espelho em inglês fica em docs/en.
  • AUTHORS.md: autores com commits no repositório, com nome e conta do GitHub.
  • CONTRIBUTING.md: regras obrigatórias de contribuição, norma VHDL-2008, nomenclatura, cabeçalhos, docstrings e verificação antes de abrir Pull Request.
  • CITATION.cff: metadados para citação do software.

2. Conteúdo

Os fontes ficam em src/.

Arquivo Bloco
adder.vhd Somador parametrizável
flip_flop.vhd Flip-flop de 1 bit com habilitação e reset assíncrono
generic_register.vhd Registrador parametrizável com habilitação e reset assíncrono
clearable_register.vhd Registrador paralelo com clear síncrono e habilitação, composto sobre o generic_register
mux_2x1.vhd, mux_4x1.vhd, mux_8x1.vhd, mux_16x1.vhd, mux_32x1.vhd, mux_64x1.vhd, mux_tree.vhd Multiplexadores de 2, 4, 8, 16, 32, 64 e N entradas
onehot_decoder.vhd Decodificador one-hot
tristate_buffer_1bit.vhd Buffer de três estados de 1 bit
synchronizer.vhd Sincronizador de cruzamento de domínios de clock, com stages flip-flops em série e data_width bits independentes
altera/virtual_jtag.vhd Virtual JTAG da Intel (sld_virtual_jtag) com índice de instância e largura de IR por genérico, só para FPGA (exige a biblioteca altera_mf)
config_pkg.vhd Pacote de constantes de elaboração que espelha o platform.yaml: base da ISA (IS_64, IS_E), largura do endereço (ADDR_BITS), subtipos word_t, reg_t, addr_t e map_addr_t, uma constante HAS_* por extensão e cache, o mapa de memória em bytes e as funções isa_string e check_isa. O topo de uma plataforma troca o arquivo por uma versão gerada com o mesmo nome
counter64.vhd Contador de até 64 bits em duas metades, com vai-um registrado, escrita por metade e pulso de estouro; a largura da palavra vem do config_pkg
utils_pkg.vhd Tipos e funções auxiliares: comparação de vetores (equals, not_equals, is_equal_dynamic), inversão de bits (reverse_vector), redução OU e E em árvore (reduce_or, reduce_and) e log2_ceil

3. Verificação

git clone --recurse-submodules https://github.com/insper-riscv/Common-Components.git
cd Common-Components
uv sync

make check   # verificação de sintaxe VHDL-2008 de todos os fontes, em ordem de dependência (GHDL)
make test    # testes por entidade em cocotb (make test TEST=Adder para um alvo)
make paths   # existência de todos os caminhos listados na configuração

Cada bloco tem um teste de entidade em tests/python/unittests/, e o catálogo que os conduz é o tests/python/tests.json. Os invólucros de teste em tests/vhdl/ achatam os tipos que o cocotb não enxerga (mux_tree, utils_pkg, config_pkg). As ferramentas (GHDL e uv) vêm da imagem ci-vhdl do repositório Infra, onde a integração contínua executa.


Copyright 2026 Insper. Licenciado sob a Apache License, Version 2.0.

About

Blocos VHDL reutilizáveis do Insper-RISC-V: flip-flop, registradores, decodificadores, buffers e funções utilitárias. Base compartilhada por Core, Memory e Peripherals.

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Contributors

Languages