代码风格 发布流程
构建指南 构建 EXTRAS
Develop 分支 v19.0.0.0 v20.0.0.0 v20.0.0.2 v20.0.0.3 v20.1.0.0 v20.1.0.1 v20.1.0.5 v21.0.0.0 v21.0.1.0 v21.1.0.0 v21.1.0.1 v21.1.0.2 v21.2.0.0 v21.2.1.0 v21.2.1.1 v22.0.0.0 v22.0.0.1 v22.1.0.0 v23.0.0.0 v23.0.0.1 v24.1.0.1
标准库概览 Hello World 教程 X86 全系统教程 开发自定义组件教程 使用标准库创建开发板 使用本地资源
创建磁盘镜像 设备 m5term 构建 Linux ARM 内核 构建 Android Marshmallow 访客二进制文件
内存系统概述 gem5 内存系统 替换策略 索引策略 经典内存系统一致性 经典缓存 (Classic Caches)
Ruby 概述 缓存一致性协议 Garnet 2.0 HeteroGarnet MOESI CMP 目录 Garnet 合成流量 SLICC 语言 MI 示例 Garnet 独立运行 互连网络 MOESI Hammer MOESI CMP Token MESI 两级缓存 CHI 协议 替换策略
SimpleCPU O3CPU TraceCPU Minor CPU 模型 执行基础 可视化
全系统模式 (Full System) 系统仿真模式 (SE)
基于 Trace 的调试 基于调试器 (GDB) 的调试 调试模拟代码 报告问题
架构支持概览 ARM 实现 ISA 解析器 X86 microop ISA
Edit this page
authors: Bobby R. Bruce
last edited: 2026-01-30 06:21:33 +0000

Garnet 合成流量

Garnet 合成流量提供了一个框架，用于使用受控输入模拟 Garnet 网络。这对于网络测试/调试 或使用合成流量进行纯网络模拟很有用。

Note: The garnet synthetic traffic injector only works with Garnet_standalone coherence protocol.

How to run

First build gem5 with the Garnet_standalone coherence protocol. This protocol is ISA-agnostic, and hence we build it with the NULL ISA.

For gem5 <= 23.0:

scons build/NULL/gem5.debug PROTOCOL=Garnet_standalone

For gem5 >= 23.1

scons defconfig build/NULL build_opts/NULL
scons setconfig build/NULL RUBY_PROTOCOL_GARNET_STANDALONE=y
scons build/NULL/gem5.debug

Example command:

./build/NULL/gem5.debug configs/example/garnet_synth_traffic.py  \
--num-cpus=16 \
--num-dirs=16 \
--network=garnet2.0 \
--topology=Mesh_XY \
--mesh-rows=4  \
--sim-cycles=1000 \
--synthetic=uniform_random \
--injectionrate=0.01

Parameterized Options

System Configuration       Description
--num-cpus Number of cpus. This is the number of source (injection) nodes in the network.
--num-dirs Number of directories. This is the number of destination (ejection) nodes in the network.
--network Network model: simple or garnet2.0. Use garnet2.0 for running synthetic traffic.
--topology Topology for connecting the cpus and dirs to the network routers/switches.
--mesh-rows The number of rows in the mesh. Only valid when –topology is Mesh* MeshDirCorners*



Network Configuration   Description
--router-latency Default number of pipeline stages in the garnet router. Has to be >= 1. Can be over-ridden on a per router basis in the topology file.
--link-latency Default latency of each link in the network. Has to be >= 1. Can be over-ridden on a per link basis in the topology file.
--vcs-per-vnet Number of VCs per Virtual Network.
--link-width-bits Width in bits for all links inside the garnet network. Default = 128.



Traffic Injection Configuration           Description
--sim-cycles Total number of cycles for which the simulation should run.
--synthetic The type of synthetic traffic to be injected. The following synthetic traffic patterns are currently supported: uniform_random, tornado, bit_complement, bit_reverse, bit_rotation, neighbor, shuffle, and transpose
--injectionrate Traffic Injection Rate in packets/node/cycle. It can take any decimal value between 0 and 1. The number of digits of precision after the decimal point can be controlled by --precision which is set to 3 as default in garnet_synth_traffic.py.
--single-sender-id Only inject from this sender. To send from all nodes, set to -1.
--single-dest-id Only send to this destination. To send to all destinations as specified by the synthetic traffic pattern, set to -1.
--num-packets-max Maximum number of packets to be injected by each cpu node. Default value is -1 (keep injecting till sim-cycles).
--inj-vnet Only inject in this vnet (0, 1 or 2). 0 and 1 are 1-flit, 2 is 5-flit. Set to -1 to inject randomly in all vnets.



Implementation of Garnet Synthetic Traffic

The synthetic traffic injector is implemente in GarnetSnytheticTraffic.cc. The sequence of steps involved in generating and sending a packet are as follows.