106 lines
3.3 KiB
Ruby
106 lines
3.3 KiB
Ruby
require "thor"
|
|
require "rubyx"
|
|
require "risc/interpreter"
|
|
|
|
class RubyXC < Thor
|
|
class_option :parfait , type: :numeric
|
|
|
|
|
|
desc "compile FILE" , "Compile given FILE to binary"
|
|
long_desc <<-LONGDESC
|
|
Compile the give file name to binary object file (see long descr.)
|
|
|
|
Output will be elf object file of the same name, with .o, in root directory.
|
|
|
|
Note: Because of Bug #13, you need to run "ld -N file.o" on the file, before
|
|
executing it. This can be done on a mac by installing a cross linker
|
|
(brew install arm-linux-gnueabihf-binutils), or on the target arm machine.
|
|
LONGDESC
|
|
|
|
def compile(file)
|
|
begin
|
|
ruby = File.read(file)
|
|
rescue
|
|
fail MalformattedArgumentError , "No such file #{file}"
|
|
end
|
|
puts "compiling #{file}"
|
|
|
|
linker = ::RubyX::RubyXCompiler.new(extract_options).ruby_to_binary( ruby , :arm )
|
|
writer = Elf::ObjectWriter.new(linker)
|
|
|
|
outfile = file.split("/").last.gsub(".rb" , ".o")
|
|
writer.save outfile
|
|
|
|
return outfile
|
|
end
|
|
|
|
|
|
desc "interpret FILE" , "Interpret given FILE "
|
|
long_desc <<-LONGDESC
|
|
Compiles the given file to an intermediate RISC format, and runs the
|
|
Interpreter.
|
|
|
|
RISC is the last abstract layer inside the compiler. It is in nature
|
|
very close to arm (without quirks and much smaller).
|
|
|
|
An interpreter was originally developed for the RISC layer for debugging purposes.
|
|
Running the interpreter is about 50k slower than binary, but it can be used
|
|
to veryfy simple programs.
|
|
|
|
No output file will be generated, the only output is generated by the
|
|
given program.
|
|
|
|
The program must define a main method on the Space class, which will be invoked.
|
|
LONGDESC
|
|
|
|
def interpret(file)
|
|
begin
|
|
ruby = File.read(file)
|
|
rescue
|
|
fail MalformattedArgumentError , "No such file #{file}"
|
|
end
|
|
compiler = RubyX::RubyXCompiler.new(extract_options)
|
|
linker = compiler.ruby_to_binary(ruby, :interpreter)
|
|
|
|
puts "interpreting #{file}"
|
|
|
|
interpreter = Risc::Interpreter.new(linker , STDOUT )
|
|
interpreter.start_program
|
|
interpreter.tick while(interpreter.instruction)
|
|
|
|
end
|
|
|
|
desc "execute FILE" , "Compile given FILE and execute resulting binary"
|
|
long_desc <<-LONGDESC
|
|
Just like the compile task, this compiles the file to an object/binary file.
|
|
|
|
Then rubyxc will link and run the resulting object file. For this to work,
|
|
qemu needs to be set up correctly on the system. Specifically, because of
|
|
bug #13, arm-linux-gnueabihf-ld needs to exist (it's part of the cross compiled
|
|
arm binutils).
|
|
|
|
The resulting a.out will be run via qemu-arm. This is part of the qemu "linux" package
|
|
and interprets the arm binary on the host, assuming a linux os.
|
|
|
|
This whole approach should only be used for preliminary checking that no core-dumps
|
|
are generated by the program, or when no benchmarking (as the times will be whatever).
|
|
|
|
For simple functional test though, it is a much much quicker way to run the binary
|
|
than transferring it to another machine. The a.out is left in place to be run again.
|
|
LONGDESC
|
|
|
|
def execute(file)
|
|
outfile = compile(file)
|
|
system "arm-linux-gnu-ld -N #{outfile}"
|
|
puts "Linked ok, now running #{outfile}"
|
|
system "qemu-arm ./a.out ; echo $?"
|
|
end
|
|
|
|
private
|
|
def extract_options
|
|
opt = { factory: options[:parfait] || 1024 }
|
|
return {parfait: opt}
|
|
end
|
|
|
|
end
|