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).
- 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 emdocs/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.
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 |
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çãoCada 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.