Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
19 commits
Select commit Hold shift + click to select a range
dadfcab
Updates on iDMA and cluster for Burst Splitting parametrization (#9)
RiccardoGandolfi Jan 8, 2026
04a29ba
Updated iDMA commit: re-added user signal to iDMA req structure (#12)
RiccardoGandolfi Jan 9, 2026
3c0a112
Update iDMA version and CHANGELOG (#13)
yvantor Jan 10, 2026
5b16361
[IDMA CLOCK GATING] Added clock gating features in iDMA + updated pul…
RiccardoGandolfi Feb 25, 2026
e1c7aa3
[CI] Add CI
LuigiGhionda Mar 3, 2026
7dd95f2
[MAKEFILE] Bump regression_tests to fix idma_{3d,2d} and add idma tes…
LuigiGhionda Mar 30, 2026
1d9cb16
[BENDER] Nuke the Bender.local and restore .lock and .yml entries
RiccardoGandolfi May 21, 2026
3720bd9
[MAKEFILE] Add flag for write access in questaOne rtl build
RiccardoGandolfi Jun 12, 2026
2917af8
[ELFLOADER] Align preloaded sections to the TB bus width
petreiuss Jul 27, 2026
cbcba1f
[FPGA] Added include guard to avoid conflict with pulp_soc_define fil…
ccarlotta Mar 16, 2026
5b3ec1d
[PULP_CLUSTER] Update cluster_peripherals commit + remove signals tie…
RiccardoGandolfi Nov 12, 2026
57c2777
[CI] Add rule to clone pulp-sdk + update nonfree commit: new CI script
RiccardoGandolfi Nov 12, 2026
96d541c
[MAKEFILE] Update pulp-sdk commit: fix for tcdm tests
RiccardoGandolfi Nov 12, 2026
71be48b
[iDMA] Fix for clock gating race condition
RiccardoGandolfi Nov 13, 2026
66c22ef
[SDK] Update pulp-sdk commit: fix for tcdm tests
RiccardoGandolfi Nov 13, 2026
d7dfc0f
[MAKEFILE] Clean from pulp-runtime references
RiccardoGandolfi Nov 17, 2026
1149124
[DMA] Remove references to mchan
RiccardoGandolfi Nov 17, 2026
f9a71a0
[GF22] Replace non-existent gf12 paths with gf22
RiccardoGandolfi Nov 18, 2026
559383d
[DMA] Remove mchan_wrap
RiccardoGandolfi Nov 18, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 7 additions & 12 deletions .github/workflows/gitlab-ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -9,19 +9,14 @@ name: gitlab-ci
on: [ push, pull_request, workflow_dispatch ]

jobs:

check:
gitlab-ci:
runs-on: ubuntu-latest
steps:
-
name: Mirror and check
uses: pulp-platform/pulp-actions/gitlab-ci@v2
- name: Check Gitlab CI
uses: pulp-platform/pulp-actions/gitlab-ci@v2.4.1 # update version as needed, not autoupdated
# Skip on forks or pull requests from forks due to missing secrets.
if: >
github.repository == 'pulp-platform/pulp_cluster' &&
(github.event_name != 'pull_request' ||
github.event.pull_request.head.repo.full_name == github.repository)
if: github.repository == 'FondazioneChipsIT/pulp_cluster' && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository)
with:
domain: iis-git.ee.ethz.ch
repo: github-mirror/pulp_cluster
token: ${{ secrets.GITLAB_TOKEN }}
domain: gitlab.chips.it
repo: digitalresearchline/githubmirrors/pulp_cluster
token: ${{ secrets.GITLAB_TOKEN }}
6 changes: 4 additions & 2 deletions .gitlab-ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -13,13 +13,15 @@ init:
stage: nonfree
script: make nonfree-init
artifacts:
paths: [ nonfree/ci.yml ]
paths: [ nonfree/.gitlab-ci.yml ]

subpipe:
stage: nonfree
needs: [ init ]
variables:
PARENT_PIPELINE_SOURCE: $CI_PIPELINE_SOURCE
trigger:
include:
- artifact: nonfree/ci.yml
- artifact: nonfree/.gitlab-ci.yml
job: init
strategy: depend
2 changes: 1 addition & 1 deletion Bender.lock
Original file line number Diff line number Diff line change
Expand Up @@ -179,7 +179,7 @@ packages:
Git: https://github.com/pulp-platform/icache-intc.git
dependencies: []
idma:
revision: 6be43a77c81e86c53e821dfbc618522c375ff28c
revision: 2e637216e0455d77706a50d0639b86891e2a83aa
version: null
source:
Git: https://github.com/pulp-platform/iDMA.git
Expand Down
31 changes: 13 additions & 18 deletions Bender.yml
Original file line number Diff line number Diff line change
Expand Up @@ -18,25 +18,25 @@ dependencies:
cluster_interconnect: { git: "https://github.com/pulp-platform/cluster_interconnect.git", rev: v1.3.0 }
event_unit_flex: { git: "https://github.com/pulp-platform/event_unit_flex.git", rev: astral-v1.0 }
mchan: { git: "https://github.com/pulp-platform/mchan.git", version: =1.2.4 }
idma: { git: "https://github.com/pulp-platform/iDMA.git", rev: 6be43a77c81e86c53e821dfbc618522c375ff28c } #devel
idma: { git: "https://github.com/FondazioneChipsIT/iDMA.git", rev: 7073edd83950232c12f900d2b6d65016b886a50a }
obi: { git: "https://github.com/pulp-platform/obi.git", version: =0.1.7 }
hier-icache: { git: "https://github.com/pulp-platform/hier-icache.git", version: =1.3.0 }
cluster_icache: { git: "https://github.com/pulp-platform/cluster_icache.git", version: =0.2.0 }
cluster_peripherals: { git: "https://github.com/pulp-platform/cluster_peripherals.git", rev: "072ddd876c88324ef28856d4b2697424aaa231ce" }
cluster_peripherals: { git: "https://github.com/pulp-platform/cluster_peripherals.git", rev: 072ddd876c88324ef28856d4b2697424aaa231ce }
axi: { git: "https://github.com/pulp-platform/axi.git", version: =0.39.8 }
timer_unit: { git: "https://github.com/pulp-platform/timer_unit.git", version: =1.0.2 }
timer_unit: { git: "https://github.com/pulp-platform/timer_unit.git", version: =1.0.3 }
common_cells: { git: "https://github.com/pulp-platform/common_cells.git", version: =1.38.0 }
tech_cells_generic: { git: "https://github.com/pulp-platform/tech_cells_generic.git", version: =0.2.3 }
flex-v: { git: "https://github.com/pulp-platform/flex-v.git", rev: e9355c2f6ec4c105abdff39489e5d1be93bc4374 }
flex-v: { git: "https://github.com/pulp-platform/flex-v.git", rev: astral-v1.1 }
cv32e40p: { git: "https://github.com/pulp-platform/cv32e40p.git", rev: astral-v1.0 }
ibex: { git: "https://github.com/pulp-platform/ibex.git", rev: "pulpissimo-v6.1.2" }
scm: { git: "https://github.com/pulp-platform/scm.git", rev: v1.2.0 }
hci: { git: "https://github.com/pulp-platform/hci.git", rev: 2a5a508 } # yt/wen-filter
register_interface: { git: "https://github.com/pulp-platform/register_interface.git", version: 0.4.4 }
scm: { git: "https://github.com/pulp-platform/scm.git", version: =1.2.0 }
hci: { git: "https://github.com/pulp-platform/hci.git", rev: 3e63936991569d0b1e315d6914478937b37bb338 }
register_interface: { git: "https://github.com/pulp-platform/register_interface.git", version: =0.4.7 }
redundancy_cells: { git: "https://github.com/pulp-platform/redundancy_cells.git", rev: 6ba6f41 } # yt/redmule-v2
redmule: { git: "https://github.com/pulp-platform/redmule.git", version: =2.0.4 }
neureka: { git: "https://github.com/pulp-platform/neureka.git", rev: f4e131c } # branch: lg/astral-v1.1
softex: { git: "https://github.com/belanoa/softex.git" , rev: astral-v1.0 }
redmule: { git: "https://github.com/pulp-platform/redmule.git", rev: dbcba6b1efda24dc909ebdd4ace132f798c8c12b }
neureka: { git: "https://github.com/pulp-platform/neureka.git", rev: 2e076f7d25cdfba38821ee95595bb27aec53c764 }
softex: { git: "https://github.com/belanoa/softex.git", rev: 11dd29e85d40e29fea0481b471f1c0cc967df1a4 }

export_include_dirs:
- include
Expand All @@ -54,12 +54,7 @@ sources:
- rtl/cluster_event_map.sv
- rtl/cluster_timer_wrap.sv
- rtl/obi_pulp_adapter.sv
- target: mchan
files:
- rtl/mchan_wrap.sv
- target: idma
files:
- rtl/idma_wrap.sv
- rtl/idma_wrap.sv
- rtl/hwpe_subsystem.sv
- rtl/instr_width_converter.sv
- rtl/per2axi_wrap.sv
Expand Down Expand Up @@ -94,6 +89,6 @@ sources:

- target: pulp_standalone_synth
files:
- nonfree/gf12/sourcecode/tc_sram.sv
- nonfree/gf12/sourcecode/tc_clk.sv
- gf22/sourcecode/tc_sram.sv
- gf22/sourcecode/tc_clk.sv

2 changes: 1 addition & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## v0.0.0
## ChipsIt-v0.0.0
### Added
* iDMA: integrated iDMA wrap supporting up to 3D transfers with 2 physical channels and parametric burst length

Expand Down
46 changes: 21 additions & 25 deletions Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,6 @@ VENV := venv
top_level ?= pulp_cluster
library ?= work
elf-bin ?= stimuli.riscv
bwruntest = $(ROOT_DIR)/pulp-runtime/scripts/bwruntests.py

REGRESSIONS := $(ROOT_DIR)/regression_tests

Expand All @@ -47,8 +46,8 @@ endef
# Nonfree components #
######################

NONFREE_REMOTE ?= git@iis-git.ee.ethz.ch:pulp-restricted/pulp-cluster-nonfree.git
NONFREE_COMMIT ?= aad59d36bfef6b74f03ffed28903a44cb86b9497
NONFREE_REMOTE ?= git@gitlab.chips.it:digitalresearchline/chips-restricted/pulp-cluster-nonfree.git
NONFREE_COMMIT ?= e0e713be4a9215484e07d6f1244c21352e71a4bd

nonfree-init:
git clone $(NONFREE_REMOTE) nonfree
Expand Down Expand Up @@ -79,17 +78,17 @@ Bender.lock:

.PHONY: sw-init sw-clean

sw-init: pulp-runtime fault_injection_sim regression_tests
sw-init: pulp-sdk fault_injection_sim
sw-clean:
@rm -rf pulp-runtime fault_injection_sim regression_tests
@rm -rf pulp-sdk fault_injection_sim

## Clone pulp-runtime as SW stack
PULP_RUNTIME_REMOTE ?= https://github.com/pulp-platform/pulp-runtime.git
PULP_RUNTIME_COMMIT ?= 3b48b0c6872cc01ba169a2c9c886ebb815d22cdc
### Clone pulp-sdk as SW stack
PULP_SDK_REMOTE ?= https://github.com/FondazioneChipsIT/pulp-sdk.git
PULP_SDK_COMMIT ?= 55fedf856aafa0a305c6bcd02b7e62b69bc74246

pulp-runtime:
git clone $(PULP_RUNTIME_REMOTE) $@
cd $@ && git checkout $(PULP_RUNTIME_COMMIT)
pulp-sdk:
git clone ${PULP_SDK_REMOTE} $@
cd $@ && git checkout ${PULP_SDK_COMMIT} && git submodule update --init --recursive

## Clone fault injection scripts
FAULT_SIM_REMOTE ?= https://github.com/pulp-platform/InjectaFault.git
Expand All @@ -100,8 +99,8 @@ fault_injection_sim:
cd $@ && git checkout $(FAULT_SIM_COMMIT)

## Clone regression tests
REGRESSION_TESTS_REMOTE ?= https://github.com/pulp-platform/regression_tests.git
REGRESSION_TESTS_COMMIT ?= f173611e3e8f15e7f526d40712135e7ff976f805 # branch: lg/upstream
REGRESSION_TESTS_REMOTE ?= https://github.com/FondazioneChipsIT/regression_tests.git
REGRESSION_TESTS_COMMIT ?= a795d6a318c5aa5842e61e2e2daf2d2c6cb89454 # branch: chips-it

regression_tests:
git clone $(REGRESSION_TESTS_REMOTE) $@
Expand All @@ -121,13 +120,9 @@ sim-clean:
include bender-common.mk
include bender-sim.mk
scripts/compile.tcl: | Bender.lock
$(call generate_vsim, $@, $(common_defs) $(common_targs) -t idma $(sim_defs) $(sim_targs),..)
$(call generate_vsim, $@, $(common_defs) $(common_targs) $(sim_defs) $(sim_targs),..)
echo 'vlog "$(realpath $(ROOT_DIR))/tb/dpi/elfloader.cpp" -ccflags "-std=c++11"' >> $@

scripts/compile.tcl-mchan: | Bender.lock
$(call generate_vsim, scripts/compile.tcl, $(common_defs) $(common_targs) -t mchan $(sim_defs) $(sim_targs),..)
echo 'vlog "$(realpath $(ROOT_DIR))/tb/dpi/elfloader.cpp" -ccflags "-std=c++11"' >> scripts/compile.tcl

include bender-synth.mk
scripts/synth-compile.tcl: | Bender.lock
$(BENDER) script synopsys $(common_targs) $(common_defs) $(synth_targs) $(synth_defs) > $@
Expand All @@ -141,21 +136,22 @@ $(library):
$(QUESTA) vlib $(library)


uv:
cd $(shell bender path idma) && \
curl -LsSf https://astral.sh/uv/install.sh | sh && \
uv sync --locked
idma_venv:
python3 -m venv $(VENV) && \
$(VENV)/bin/python -m pip install -U pip && \
$(VENV)/bin/python -m pip install -r $(shell $(BENDER) path idma)/requirements.txt && \
$(VENV)/bin/python -m pip install "setuptools<81"

generate_idma_rtl: uv
. "$(shell bender path idma)/.venv/bin/activate" && $(MAKE) -C $(shell bender path idma) idma_hw_all
generate_idma_rtl: idma_venv
. "$(VENV)/bin/activate" && $(MAKE) -C $(shell $(BENDER) path idma) idma_hw_all

compile: $(library)
@test -f Bender.lock || { echo "ERROR: Bender.lock file does not exist. Did you run make checkout in bender mode?"; exit 1; }
@test -f scripts/compile.tcl || { echo "ERROR: scripts/compile.tcl file does not exist. Did you run make scripts in bender mode?"; exit 1; }
$(VSIM) -c -do 'quit -code [source scripts/compile.tcl]'

build_qone: compile
$(QOPT) $(compile_flag) -debug +designfile -suppress 3053 -suppress 8885 -work $(library) $(top_level)_tb -o $(top_level)_tb_optimized
$(QOPT) $(compile_flag) -debug +designfile -access=rw+/$(top_level)_tb. -suppress 3053 -suppress 8885 -work $(library) $(top_level)_tb -o $(top_level)_tb_optimized


build: compile
Expand Down
1 change: 0 additions & 1 deletion bender-synth.mk
Original file line number Diff line number Diff line change
Expand Up @@ -6,4 +6,3 @@ synth_defs :=

# Don't add the following for linting
synth_targs := -t pulp_standalone_synth
synth_targs += -t idma
34 changes: 34 additions & 0 deletions include/pulp_soc_defines.sv
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,10 @@
*
*/

`ifndef PULP_SOC_DEFINES_SV
`define PULP_SOC_DEFINES_SV


`define CLUSTER_ALIAS
`define PRIVATE_ICACHE
`define HIERARCHY_ICACHE_32BIT
Expand Down Expand Up @@ -51,3 +55,33 @@
`define NB_DMAS 4
`define NB_MPERIPHS 1
`define NB_SPERIPHS 12

// Width of byte enable for a given data width
`define EVAL_BE_WIDTH(DATAWIDTH) (DATAWIDTH/8)

`define NB_L2_CHANNELS 4

// Default JTAG ID code type
typedef struct packed {
bit [ 3:0] version;
bit [15:0] part_num;
bit [10:0] manufacturer;
bit _one;
} jtag_idcode_t;

// PULP Platform manufacturer and default PulpOpen part number
localparam bit [10:0] JtagPulpManufacturer = 11'h6d9;
localparam bit [15:0] JtagPulpOpenPartNum = 16'hc5e5;
localparam bit [ 3:0] JtagPulpOpenVersion = 4'h1;
localparam jtag_idcode_t PulpOpenIdCode = '{
_one : 1,
manufacturer : JtagPulpManufacturer,
part_num : JtagPulpOpenPartNum,
version : JtagPulpOpenVersion
};

// JTAG
`define DMI_JTAG_IDCODE PulpOpenIdCode
// `define DMI_JTAG_IDCODE 32'h249511C3

`endif
70 changes: 38 additions & 32 deletions rtl/idma_wrap.sv
Original file line number Diff line number Diff line change
Expand Up @@ -271,25 +271,34 @@ module dmac_wrap #(
// Here, another clock gating level is applied:
// - completely hw-controlled, this clock gating cell controls the datapath clock, disabling it when not needed.

logic keep_datapath_clocked, datapath_clk_en;

// Register to keep the clock active until event completion
// Once the transfer has started its execution (busy_o == 1'b1)
// the datapath needs to be clocked until the completion event
// has been received (|trans_complete). Then the datapath
// can be gated again.
// The maximum inflight number of transfers is computed as: (FIFO DEPTH + number of outstanding bursts held by the backend +
// the transfer currently handled by the midend) * number of streams
localparam int unsigned MaxInflight = NumStreams * (GLOBAL_QUEUE_DEPTH + NB_OUTSND_BURSTS + 2);
localparam int unsigned InflightWidth = $clog2(MaxInflight + 1);

logic datapath_clk_en;
logic [InflightWidth-1:0] inflight_d, inflight_q;

// This counter keeps track of any ongoing transfers on the streams.
always_comb begin : proc_inflight
inflight_d = inflight_q;
for (int unsigned s = 0; s < NumStreams; s++) begin
if (fe_valid[s] & fe_ready[s]) inflight_d = inflight_d + 1'b1;
if (trans_complete[s]) inflight_d = inflight_d - 1'b1;
end
end

always_ff @(posedge clk_i, negedge rst_ni) begin
if (rst_ni == 1'b0) begin
keep_datapath_clocked <= 1'b0;
end else if (busy_o == 1'b1) begin
keep_datapath_clocked <= 1'b1;
end else if (|trans_complete) begin
keep_datapath_clocked <= 1'b0;
inflight_q <= '0;
end else begin
inflight_q <= inflight_d;
end
end

assign datapath_clk_en = (one_fe_valid | (|trans_complete) | keep_datapath_clocked);
// Check if the datapath needs to be clocked.

assign datapath_clk_en = one_fe_valid | (|trans_complete) | (inflight_q != '0);

// // ----------------------------------------------------------------------------------------------------------
// // DATAPATH CLOCK GATING CELL --> This gates everything except for the frontend and the periph_to_reg modules
Expand Down Expand Up @@ -507,7 +516,7 @@ module dmac_wrap #(
.HardwareLegalizer ( 1'b1 ),
.RejectZeroTransfers ( 1'b1 ),
.ErrorHandling ( 1'b0 ),
.BurstLen ( IDMA_BURST_LENGTH )
.Burst_len ( IDMA_BURST_LENGTH )
) i_idma_backend_r_obi_rw_init_w_axi (
.clk_i ( datapath_clk_gated ),
.rst_ni ( rst_ni ),
Expand All @@ -519,8 +528,6 @@ module dmac_wrap #(
.req_dst_addr_i ( idma_req[s].dst_addr ),
.req_src_protocol_i ( idma_req[s].opt.src_protocol ),
.req_dst_protocol_i ( idma_req[s].opt.dst_protocol ),
.req_src_head_i ( '0 ),
.req_dst_head_i ( '0 ),
.req_axi_id_i ( idma_req[s].opt.axi_id ),
.req_src_burst_i ( idma_req[s].opt.src.burst ),
.req_src_cache_i ( idma_req[s].opt.src.cache ),
Expand Down Expand Up @@ -724,20 +731,21 @@ module dmac_wrap #(
assign obi_write_req_from_dma[s/2].rready = obi2axi_write_req_from_dma[s/2].rready ;

idma_backend_synth_r_axi_rw_init_rw_obi #(
.DataWidth (AXI_DATA_WIDTH),
.AddrWidth (AXI_ADDR_WIDTH),
.UserWidth (AXI_USER_WIDTH),
.AxiIdWidth (AXI_ID_WIDTH),
.NumAxInFlight (NB_OUTSND_BURSTS),
.BufferDepth (32'd3),
.TFLenWidth (TFLenWidth),
.MemSysDepth (32'd0),
.CombinedShifter (1'b0),
.RAWCouplingAvail (1'b0),
.MaskInvalidData (1'b0),
.HardwareLegalizer (1'b1),
.RejectZeroTransfers (1'b1),
.ErrorHandling (1'b0)
.DataWidth ( AXI_DATA_WIDTH ),
.AddrWidth ( AXI_ADDR_WIDTH ),
.UserWidth ( AXI_USER_WIDTH ),
.AxiIdWidth ( AXI_ID_WIDTH ),
.NumAxInFlight ( NB_OUTSND_BURSTS ),
.BufferDepth ( 32'd3 ),
.TFLenWidth ( TFLenWidth ),
.MemSysDepth ( 32'd0 ),
.CombinedShifter ( 1'b0 ),
.RAWCouplingAvail ( 1'b0 ),
.MaskInvalidData ( 1'b0 ),
.HardwareLegalizer ( 1'b1 ),
.RejectZeroTransfers ( 1'b1 ),
.ErrorHandling ( 1'b0 ),
.Burst_len ( IDMA_BURST_LENGTH )
) i_idma_backend_r_axi_rw_init_rw_obi (
.clk_i ( datapath_clk_gated ),
.rst_ni ( rst_ni ),
Expand All @@ -749,8 +757,6 @@ module dmac_wrap #(
.req_dst_addr_i ( idma_req[s].dst_addr ),
.req_src_protocol_i ( idma_req[s].opt.src_protocol ),
.req_dst_protocol_i ( idma_req[s].opt.dst_protocol ),
.req_src_head_i ( '0 ),
.req_dst_head_i ( '0 ),
.req_axi_id_i ( idma_req[s].opt.axi_id ),
.req_src_burst_i ( idma_req[s].opt.src.burst ),
.req_src_cache_i ( idma_req[s].opt.src.cache ),
Expand Down
Loading
Loading