# edabk-hust/edabk_brain_soc architecture

> Architecture diagram of the GitHub repository edabk-hust/edabk_brain_soc, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/edabk-hust/edabk_brain_soc
- Repository: https://github.com/edabk-hust/edabk_brain_soc

## Overview

edabk_brain_soc is a RISC-V SoC and neurosynaptic-core hardware/software co-design. The documented runtime path configures a single physical 256-axon, 32-neuron core over Wishbone, computes neuron potentials and spikes, and exposes spike output. Firmware is intended to schedule packets and switch logical cores by saving and loading parameter sets. The supplied tree omits the RTL implementation, so its documented blocks have null paths; relationships among them are supported by the README, not sampled RTL.

Main entry points: [`verilog/dv/edabk_firmware_demo/edabk_firmware_demo.c`](https://github.com/edabk-hust/edabk_brain_soc/blob/main/verilog/dv/edabk_firmware_demo/edabk_firmware_demo.c) (SNN Firmware)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["SoC Interface"]
  node_wishbone["Wishbone Bus"]
  node_decoder["Address Decoder"]
end

subgraph group_core["SNN Core"]
  node_synapse["Synapse Matrix"]
  node_parameters[("Neuron Parameters")]
  node_neuron["Neuron Compute"]
  node_spikeout["Spike Output"]
end

subgraph group_software["Firmware Control"]
  node_firmware["SNN Firmware"]
  node_scheduler["Packet Scheduler"]
  node_core_switch["Core Switching"]
end

node_soc(("RISC-V SoC"))

node_soc -->|"bus access"| node_wishbone
node_wishbone -->|"addresses"| node_decoder
node_decoder -->|"selects"| node_synapse
node_decoder -->|"selects"| node_parameters
node_decoder -->|"selects"| node_spikeout
node_wishbone -->|"configures"| node_synapse
node_wishbone -->|"configures"| node_parameters
node_synapse -->|"connections"| node_neuron
node_parameters -->|"supplies parameters"| node_neuron
node_neuron -->|"updates potential"| node_parameters
node_neuron -->|"emits spikes"| node_spikeout
node_firmware -.->|"manages packets"| node_scheduler
node_scheduler -.->|"selects core"| node_core_switch
node_core_switch -->|"loads and saves"| node_parameters

click node_firmware "https://github.com/edabk-hust/edabk_brain_soc/blob/main/verilog/dv/edabk_firmware_demo/edabk_firmware_demo.c"

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_wishbone,node_decoder toneBlue
class node_synapse,node_parameters,node_neuron,node_spikeout toneAmber
class node_firmware,node_scheduler,node_core_switch toneMint
class node_soc toneIndigo
```

## Components

### SoC Interface

- **Wishbone Bus**
- **Address Decoder**

### SNN Core

- **Synapse Matrix**
- **Neuron Parameters**
- **Neuron Compute**
- **Spike Output**

### Firmware Control

- [SNN Firmware](https://github.com/edabk-hust/edabk_brain_soc/blob/main/verilog/dv/edabk_firmware_demo/edabk_firmware_demo.c): `verilog/dv/edabk_firmware_demo/edabk_firmware_demo.c`
- **Packet Scheduler**
- **Core Switching**

### Other components

- **RISC-V SoC**

## Connections

- RISC-V SoC → Wishbone Bus: bus access (evidence: `README.md`)
- Wishbone Bus → Address Decoder: addresses (evidence: `README.md`)
- Address Decoder → Synapse Matrix: selects (evidence: `README.md`)
- Address Decoder → Neuron Parameters: selects (evidence: `README.md`)
- Address Decoder → Spike Output: selects (evidence: `README.md`)
- Wishbone Bus → Synapse Matrix: configures (evidence: `README.md`)
- Wishbone Bus → Neuron Parameters: configures (evidence: `README.md`)
- Synapse Matrix → Neuron Compute: connections (evidence: `README.md`)
- Neuron Parameters → Neuron Compute: supplies parameters (evidence: `README.md`)
- Neuron Compute → Neuron Parameters: updates potential (evidence: `README.md`)
- Neuron Compute → Spike Output: emits spikes (evidence: `README.md`)
- SNN Firmware → Packet Scheduler: manages packets
- Packet Scheduler → Core Switching: selects core
- Core Switching → Neuron Parameters: loads and saves (evidence: `README.md`)
