# cie-silicon/cnn_summer_2026_v0_1 architecture

> Architecture diagram of the GitHub repository cie-silicon/cnn_summer_2026_v0_1, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cie-silicon/cnn_summer_2026_v0_1
- Repository: https://github.com/cie-silicon/cnn_summer_2026_v0_1

## Overview

This repository is a Vivado integration project for a PicoRV32-based RISC-V SoC, with a portable processor wrapper, a sample block design, and Tcl-based project setup. The intended hardware workflow is that the processor runs a boot image from BRAM and uses the SoC’s AXI-connected peripherals; the README specifically identifies the boot-ROM image as the BRAM initialization source. The graph reflects documented capabilities and components visible in the tree. Most block-design wiring is not shown in the supplied excerpts, so those relationships are left unverified rather than asserted.

Main entry points: [`SoC_PJT/project_1/project_1.srcs/sources_1/bd/design_1`](https://github.com/cie-silicon/cnn_summer_2026_v0_1/tree/main/SoC_PJT/project_1/project_1.srcs/sources_1/bd/design_1) (SoC block design), [`SoC_PJT/project_1/project_1.gen/sources_1/bd/design_1/ip/design_1_axi_interconnect_0_imp_xbar_0/src/axi_crossbar.cpp`](https://github.com/cie-silicon/cnn_summer_2026_v0_1/blob/main/SoC_PJT/project_1/project_1.gen/sources_1/bd/design_1/ip/design_1_axi_interconnect_0_imp_xbar_0/src/axi_crossbar.cpp) (AXI interconnect), [`IP_REPO/pico_core_ip/src/picorv32_core.v`](https://github.com/cie-silicon/cnn_summer_2026_v0_1/blob/main/IP_REPO/pico_core_ip/src/picorv32_core.v) (Core wrapper IP), [`SoC_PJT/project_1/project_1.gen/sources_1/bd/design_1/ip/design_1_axi_bram_ctrl_0_0/src/axi_bram_ctrl.cpp`](https://github.com/cie-silicon/cnn_summer_2026_v0_1/blob/main/SoC_PJT/project_1/project_1.gen/sources_1/bd/design_1/ip/design_1_axi_bram_ctrl_0_0/src/axi_bram_ctrl.cpp) (AXI BRAM controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cpu["Processor"]
  node_picorv32["PicoRV32 core<br/>[picorv32.v]"]
  node_core_wrapper["Core wrapper IP<br/>[picorv32_core.v]"]
end

subgraph group_fabric["SoC Fabric"]
  node_design["SoC block design<br/>[design_1]"]
  node_axi_xbar["AXI interconnect<br/>[axi_crossbar.cpp]"]
  node_clock["Clock generation"]
  node_reset["Reset control"]
end

subgraph group_io["Memory and I/O"]
  node_bram_controller["AXI BRAM controller<br/>[axi_bram_ctrl.cpp]"]
  node_bram[("Block RAM")]
  node_bootrom["Boot ROM image<br/>[bootrom_pico.coe]"]
  node_uart["UART Lite"]
  node_gpio["AXI GPIO"]
  node_spi["Quad SPI"]
end

subgraph group_support["Project Support"]
  node_flash_models["Flash models"]
  node_testbench["Simulation testbench<br/>[TB.v]"]
end

node_developer(("SoC developer"))
node_vivado(("Vivado"))

node_developer -->|"launches"| node_vivado
node_vivado -.->|"opens project"| node_design
node_picorv32 -.->|"wrapped by"| node_core_wrapper
node_core_wrapper -.->|"integrated into"| node_design
node_design -.->|"uses fabric"| node_axi_xbar
node_axi_xbar -.->|"routes AXI"| node_bram_controller
node_bram_controller -.->|"accesses"| node_bram
node_bootrom -->|"initializes"| node_bram
node_axi_xbar -.->|"routes AXI"| node_uart
node_axi_xbar -.->|"routes AXI"| node_gpio
node_axi_xbar -.->|"routes AXI"| node_spi
node_flash_models -.->|"models flash"| node_spi
node_clock -.->|"provides clock"| node_design
node_reset -.->|"provides reset"| node_design
node_testbench -.->|"simulates"| node_design

click node_picorv32 "https://github.com/cie-silicon/cnn_summer_2026_v0_1/blob/main/IP_REPO/pico_core_ip/src/picorv32.v"
click node_core_wrapper "https://github.com/cie-silicon/cnn_summer_2026_v0_1/blob/main/IP_REPO/pico_core_ip/src/picorv32_core.v"
click node_design "https://github.com/cie-silicon/cnn_summer_2026_v0_1/tree/main/SoC_PJT/project_1/project_1.srcs/sources_1/bd/design_1"
click node_axi_xbar "https://github.com/cie-silicon/cnn_summer_2026_v0_1/blob/main/SoC_PJT/project_1/project_1.gen/sources_1/bd/design_1/ip/design_1_axi_interconnect_0_imp_xbar_0/src/axi_crossbar.cpp"
click node_bram_controller "https://github.com/cie-silicon/cnn_summer_2026_v0_1/blob/main/SoC_PJT/project_1/project_1.gen/sources_1/bd/design_1/ip/design_1_axi_bram_ctrl_0_0/src/axi_bram_ctrl.cpp"
click node_bram "https://github.com/cie-silicon/cnn_summer_2026_v0_1/tree/main/SoC_PJT/project_1/project_1.srcs/sources_1/bd/design_1/ip/design_1_blk_mem_gen_0_0"
click node_bootrom "https://github.com/cie-silicon/cnn_summer_2026_v0_1/blob/main/IP_REPO/pico_core_ip/src/bootrom_pico.coe"
click node_uart "https://github.com/cie-silicon/cnn_summer_2026_v0_1/tree/main/SoC_PJT/project_1/project_1.srcs/sources_1/bd/design_1/ip/design_1_axi_uartlite_0_0"
click node_gpio "https://github.com/cie-silicon/cnn_summer_2026_v0_1/tree/main/SoC_PJT/project_1/project_1.srcs/sources_1/bd/design_1/ip/design_1_axi_gpio_0_0"
click node_spi "https://github.com/cie-silicon/cnn_summer_2026_v0_1/tree/main/SoC_PJT/project_1/project_1.srcs/sources_1/bd/design_1/ip/design_1_axi_quad_spi_0_0"
click node_flash_models "https://github.com/cie-silicon/cnn_summer_2026_v0_1/tree/main/SoC_PJT/flashmodelfiles"
click node_clock "https://github.com/cie-silicon/cnn_summer_2026_v0_1/tree/main/SoC_PJT/project_1/project_1.srcs/sources_1/bd/design_1/ip/design_1_clk_wiz_0_0"
click node_reset "https://github.com/cie-silicon/cnn_summer_2026_v0_1/tree/main/SoC_PJT/project_1/project_1.srcs/sources_1/bd/design_1/ip/design_1_proc_sys_reset_0_0"
click node_testbench "https://github.com/cie-silicon/cnn_summer_2026_v0_1/blob/main/SoC_PJT/sim/TB.v"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_picorv32,node_core_wrapper toneBlue
class node_design,node_axi_xbar,node_clock,node_reset toneAmber
class node_bram_controller,node_bram,node_bootrom,node_uart,node_gpio,node_spi toneMint
class node_flash_models,node_testbench toneRose
class node_developer,node_vivado toneIndigo
```

## Components

### Processor

- [PicoRV32 core](https://github.com/cie-silicon/cnn_summer_2026_v0_1/blob/main/IP_REPO/pico_core_ip/src/picorv32.v): `IP_REPO/pico_core_ip/src/picorv32.v`
- [Core wrapper IP](https://github.com/cie-silicon/cnn_summer_2026_v0_1/blob/main/IP_REPO/pico_core_ip/src/picorv32_core.v): `IP_REPO/pico_core_ip/src/picorv32_core.v`

### SoC Fabric

- [SoC block design](https://github.com/cie-silicon/cnn_summer_2026_v0_1/tree/main/SoC_PJT/project_1/project_1.srcs/sources_1/bd/design_1): `SoC_PJT/project_1/project_1.srcs/sources_1/bd/design_1`
- [AXI interconnect](https://github.com/cie-silicon/cnn_summer_2026_v0_1/blob/main/SoC_PJT/project_1/project_1.gen/sources_1/bd/design_1/ip/design_1_axi_interconnect_0_imp_xbar_0/src/axi_crossbar.cpp): `SoC_PJT/project_1/project_1.gen/sources_1/bd/design_1/ip/design_1_axi_interconnect_0_imp_xbar_0/src/axi_crossbar.cpp`
- [Clock generation](https://github.com/cie-silicon/cnn_summer_2026_v0_1/tree/main/SoC_PJT/project_1/project_1.srcs/sources_1/bd/design_1/ip/design_1_clk_wiz_0_0): `SoC_PJT/project_1/project_1.srcs/sources_1/bd/design_1/ip/design_1_clk_wiz_0_0`
- [Reset control](https://github.com/cie-silicon/cnn_summer_2026_v0_1/tree/main/SoC_PJT/project_1/project_1.srcs/sources_1/bd/design_1/ip/design_1_proc_sys_reset_0_0): `SoC_PJT/project_1/project_1.srcs/sources_1/bd/design_1/ip/design_1_proc_sys_reset_0_0`

### Memory and I/O

- [AXI BRAM controller](https://github.com/cie-silicon/cnn_summer_2026_v0_1/blob/main/SoC_PJT/project_1/project_1.gen/sources_1/bd/design_1/ip/design_1_axi_bram_ctrl_0_0/src/axi_bram_ctrl.cpp): `SoC_PJT/project_1/project_1.gen/sources_1/bd/design_1/ip/design_1_axi_bram_ctrl_0_0/src/axi_bram_ctrl.cpp`
- [Block RAM](https://github.com/cie-silicon/cnn_summer_2026_v0_1/tree/main/SoC_PJT/project_1/project_1.srcs/sources_1/bd/design_1/ip/design_1_blk_mem_gen_0_0): `SoC_PJT/project_1/project_1.srcs/sources_1/bd/design_1/ip/design_1_blk_mem_gen_0_0`
- [Boot ROM image](https://github.com/cie-silicon/cnn_summer_2026_v0_1/blob/main/IP_REPO/pico_core_ip/src/bootrom_pico.coe): `IP_REPO/pico_core_ip/src/bootrom_pico.coe`
- [UART Lite](https://github.com/cie-silicon/cnn_summer_2026_v0_1/tree/main/SoC_PJT/project_1/project_1.srcs/sources_1/bd/design_1/ip/design_1_axi_uartlite_0_0): `SoC_PJT/project_1/project_1.srcs/sources_1/bd/design_1/ip/design_1_axi_uartlite_0_0`
- [AXI GPIO](https://github.com/cie-silicon/cnn_summer_2026_v0_1/tree/main/SoC_PJT/project_1/project_1.srcs/sources_1/bd/design_1/ip/design_1_axi_gpio_0_0): `SoC_PJT/project_1/project_1.srcs/sources_1/bd/design_1/ip/design_1_axi_gpio_0_0`
- [Quad SPI](https://github.com/cie-silicon/cnn_summer_2026_v0_1/tree/main/SoC_PJT/project_1/project_1.srcs/sources_1/bd/design_1/ip/design_1_axi_quad_spi_0_0): `SoC_PJT/project_1/project_1.srcs/sources_1/bd/design_1/ip/design_1_axi_quad_spi_0_0`

### Project Support

- [Flash models](https://github.com/cie-silicon/cnn_summer_2026_v0_1/tree/main/SoC_PJT/flashmodelfiles): `SoC_PJT/flashmodelfiles`
- [Simulation testbench](https://github.com/cie-silicon/cnn_summer_2026_v0_1/blob/main/SoC_PJT/sim/TB.v): `SoC_PJT/sim/TB.v`

### Other components

- **SoC developer**
- **Vivado**

## Connections

- SoC developer → Vivado: launches (evidence: `README.md`)
- Vivado → SoC block design: opens project
- PicoRV32 core → Core wrapper IP: wrapped by
- Core wrapper IP → SoC block design: integrated into
- SoC block design → AXI interconnect: uses fabric
- AXI interconnect → AXI BRAM controller: routes AXI
- AXI BRAM controller → Block RAM: accesses
- Boot ROM image → Block RAM: initializes (evidence: `README.md`)
- AXI interconnect → UART Lite: routes AXI
- AXI interconnect → AXI GPIO: routes AXI
- AXI interconnect → Quad SPI: routes AXI
- Flash models → Quad SPI: models flash
- Clock generation → SoC block design: provides clock
- Reset control → SoC block design: provides reset
- Simulation testbench → SoC block design: simulates
