GEM5 Garnet DVFS / NoC DVFS教程：ruby.clk_domain ruby.voltage_domain

简介

gem5中的 NoC部分是Garnet实现的，但是Garnet并没有单独的时钟域，而是保持ruby一致，要做noc的DVFS，便是要改ruby的

改电压

#这里只是生成一个随便变量名，存一下值。改是和频率一起的
userssaved_voltage_domain = VoltageDomain(voltage = options.sys_voltage)
userssaved_voltage_domain = VoltageDomain(voltage =
['1V','0.9V','0.8V','0.7V'])

改频率

Create a seperate clock domain for Ruby

#改频率的同时顺便改一下电压值
system.ruby.clk_domain = SrcClockDomain(clock = options.ruby_clock,voltage_domain=userssaved_voltage_domain,domain_id = 0)
system.ruby.clk_domain.clock = ['1GHz','700MHz','400MHz','230MHz']system.dvfs_handler.domains = system.ruby.clk_domain
system.dvfs_handler.enableHandler = 1

system.ruby 对应GEM5 源代码解读

system.ruby 中的system

这里的system和 fs.py中的test_sys是一个东西，来自于

test_sys = makeLinuxX86System(test_mem_mode, np, bm[0], args.ruby, cmdline=cmdline)

而makeLinuxX86System 来在configs/common/FSConfig.py。
test_sys代表仿真的硬件系统
同时test_sys它也是gem5最终运行时的输入

Simulation.run(args, root, test_sys, FutureClass)

system.ruby 中的ruby

system.ruby 的文件路径

gem5/src/sim/System.py System.cc System.hh
然而 System.py System.cc System.hh 中都搜不到ruby，也就是他们并不自带ruby的定义。
而是在fs.py中，调用了 configs/ruby/Ruby.py
Ruby.create_system(
args, True, test_sys, test_sys.iobus, test_sys._dma_ports, bootmem
)

system.ruby 是什么

configs/ruby/Ruby.py 中，调用的create_system给test_sys添加了system.ruby 这个组件。
如果用户在fs.py这个层面的文件中不调用这个函数的，system 中是不会有system.ruby的。

def create_system(options,full_system,system,piobus=None,dma_ports=[],bootmem=None,cpus=None,
):system.ruby = RubySystem()

RubySystem() 是什么

路径在 gem5/src/mem/ruby/system/ RubySystem.py RubySystem.cc RubySystem.hh

RubySystem() 在 gem5/src/mem/ruby/system/ RubySystem.py中如下

class RubySystem(ClockedObject):type = "RubySystem"cxx_header = "mem/ruby/system/RubySystem.hh"cxx_class = "gem5::ruby::RubySystem"randomization = Param.Bool(False,"insert random delays on message enqueue times (if True, all message \buffers are enforced to have randomization; otherwise, a message \buffer set its own flag to enable/disable randomization)",)block_size_bytes = Param.UInt32(64, "default cache block size; must be a power of two")memory_size_bits = Param.UInt32(64, "number of bits that a memory address requires")phys_mem = Param.SimpleMemory(NULL, "")system = Param.System(Parent.any, "system object")access_backing_store = Param.Bool(False,"Use phys_mem as the functional \store and only use ruby for timing.",)# Profiler related configuration variableshot_lines = Param.Bool(False, "")all_instructions = Param.Bool(False, "")num_of_sequencers = Param.Int("")number_of_virtual_networks = Param.Unsigned("")

总结

我们现在知道了system. ruby 中，system是启动需要的硬件描述，ruby则是额外的加进去system的硬件模块的描述，这个增加的模块类名是RubySystem。 我们在下面两章节讲述ruby的voltage domain 和 clock domain.

ruby.clk_domain 对应GEM5 RUBY 源代码解读

system.ruby 是 RubySystem类的实例， RubySystem继承自ClockedObject

clockedObject是继承至Clocked 类。
clocked 类里有clockdomain

我们看gem5/src/sim/ClockedObject.py 可以看到clk_domain.

class ClockedObject(SimObject):type = "ClockedObject"abstract = Truecxx_header = "sim/clocked_object.hh"cxx_class = "gem5::ClockedObject"# The clock domain this clocked object belongs to, inheriting the# parent's clock domain by defaultclk_domain = Param.ClockDomain(Parent.clk_domain, "Clock domain")

ruby.clk_domain 总结

system.ruby.clk_domain是
1 system 从fs.py中调用了FSConfig.py中的函数(名字叫makeLinuxX86System)调用，生成了system。
2. system.ruby 从fs.py 中调用了Ruby.py中的函数(名字叫Ruby.create_system），生成了system.ruby =RubySystem()
3. RubySystem继承了clockedobject，clockedobject自带了clk_domain.

ruby.voltage_domain 对应GEM5 RUBY 源代码解读

ClockedObject 中没有voltage_domain，那么继承自ClockedObject 的RubySystem 哪里来的voltage_domain ？

所以我们看看

# Create a seperate clock domain for Rubytest_sys.ruby.clk_domain = SrcClockDomain(clock=args.ruby_clock, voltage_domain=test_sys.voltage_domain)

也就是说，voltage domain在ruby里其实只是clokdomain的附加。

SrcClockDomain 文件路径

gem5/src/sim/ClockDomain.py 中定义了 SrcClockDomain。
也就是和ClockDomain是同一个文件。

SrcClockDomain 是什么

没错，其实就是ClockDomain 的一个扩展版而已。而且扩展的这个电压也用的不多，可以认为只是文字上在clkdomain后上加了个后缀，以便power相关的读取。
更详细的说，X ghz才影响结果，X ghz顺便捎上了电压值 Y，这个Y不影响运行，最后结果跑完了生成一串Y值，用于类似于读excel得出power相关的结果。
总计就是电压值是附加的，附属于clk。

# Source clock domain with an actual clock, and a list of voltage and frequency
# op points
class SrcClockDomain(ClockDomain):type = "SrcClockDomain"cxx_header = "sim/clock_domain.hh"cxx_class = "gem5::SrcClockDomain"

总结

RubySystem继承了clockedobject，clockedobject自带了clk_domain.
同时， 将 RubySystem自带的clk_domain，丰富了一下，制定为带电压的clk_domain的扩展类，也就是SrcClockDomain这个类。

# Create a seperate clock domain for Rubytest_sys.ruby.clk_domain = SrcClockDomain(clock=args.ruby_clock, voltage_domain=test_sys.voltage_domain)

对应GEM5 源代码解读：dvfs_handler

文件路径

gem5/src/sim/ dvfs_handler.cc dvfs_handler.hh
在 dvfs_handler.hh 中：

include

55 #include "debug/DVFS.hh"

56 #include “params/DVFSHandler.hh”
57 #include “sim/clock_domain.hh”
58 #include “sim/eventq.hh”
59 #include “sim/sim_object.hh”

定义domain

180 private:
181 typedef std::map<DomainID, SrcClockDomain*> Domains;
182 Domains domains;

定义 enableHandler

bool enableHandler;

bool isEnabled() const { return enableHandler; }