ReASM

Wiki

A experimental RISC-V IMFD compatible assembler/disassembler to Luau. Soon to be IMFDVB compatible!

125+ supported instructions & directives!

Note

Some programs, will not work! Create an issue if you find an assembly file which is compiling invalid.

Example:

void printf(const char *, ...); /* manually define printf if we are not using stdlib.h */

int fib(int n) {
    if (n <= 1)
        return n;
    return fib(n-1) + fib(n-2);
}

void printFib(int n, int i) {
    if (i < n) {
        printf("%d ", fib(i));
        printFib(n, i+1);
    }
}

int main() {
    int terms = 10;
    printFib(terms, 0);
    return 0;
}

clang -S -target riscv32 -march=rv32im main.c -o main.s
reasm main.s -o main.luau # where the magic happens
luau main.luau

Usage:

reasm main.S -o main.luau --mode {module|main|bench} --trace --comments

Input file can either be a .S assembly file, or a .elf file which is linked (experimental).

Options

• --comments: This will place comments all around the generated code with details such as the instruction's purpose, operands, and any relevant debug information.
• --trace: Everytime a jump happens it will log to output, this is a more extreme option and should only be used for debug.
• --mode:
  • module will automatically expose memory, API to inject functions, and registers to whoever imports.
  • main will generate a simple Luau file which runs on its own.
  • bench will generate a module prepared for benchmarking with Scriptbench or Benchmarker.

Resources:

Super helpful resources in development below:

• https://www.cs.sfu.ca/~ashriram/Courses/CS295/assets/notebooks/RISCV/RISCV_CARD.pdf
• https://msyksphinz-self.github.io/riscv-isadoc/
• https://godbolt.org/
• https://projectf.io/posts/riscv-cheat-sheet/
• https://en.wikipedia.org/wiki/RISC-V_instruction_listings (IMB)

TODO:

• Improved floating points
• Support for %hi(val)(5) assembly syntax.
• Vector operations
• Bit manipulation operators
• Work on support for ELF files. (or decide to remove it)
  • No bindings for function '<register??>'
  • ECALL & AUIPC
  • Read labels