Crate ttk91

A create for doing everyting related to the TTK91 instruction architecture used for teaching computer organisation at University of Helsinki.

Currently this crate provides the functionality to:

• Read .b91 files containing TTK91 bytecode.
• Read .k91 files containing TTK91 symbolic assembly.
• Compile bytecode from symbolic TTK91 assembly.
• Execute bytecode.

Example

use ttk91::{
    symbolic::Program,
    emulator::{Emulator, StdIo, Memory},
};

fn main() {
    // Simple TTK91 program that adds 13 and 15 together and outputs the answer.
    let symbolic_source = r#"
        ;; DATA
        X       DC      13
        Y       DC      15

        ;; CODE
        MAIN 	LOAD 	R1, X
                ADD 	R1, Y
                OUT 	R1, =CRT
                SVC 	SP, =HALT
    "#;

    // Parse the symbolic assembly into symbolic IR.
    let symbolic = Program::parse(symbolic_source).unwrap();

    // Translate the symbolic IR into bytecode IR.
    let compiled = symbolic.compile();

    // Convert the bytecode IR to bytecode.
    let memory = compiled.to_words();

    // Load the bytecode into an emulator which uses the standard output.
    let mut emulator = Emulator::new(memory, StdIo)
        .expect("could not initialize emulator");

    // Execute the bytecode.
    emulator.run()
        .expect("an error occured while emulating the program");
}

Executables

This crate comes with multiple command-line utilities. These utilities can be enables with the tools feature or individually with the ttk91repl and ttk91run features.

ttk91repl

The ttk91repl provides a Read-Execute-Print-Loop environment for the TTK91 symbolic assembly language. It supports alternating between writing and executing code and provides multiple commands suitable for debugging.

0x8000> LOAD  R1, =5
0x8001> OUT   R1, =CRT
5
0x0002> .register r1
Register R1 = 5
0x8002> SUB   R1, =1
0x8003> JNZER R1, 0x8001
4
3
2
1
0x8004>

ttk91run

The ttk91run command-line tool is capable of emulating TTK91 programs in both the symbolic and the bytecode formats.

$ ttk91run tests/hello.k91
28
$ ttk91run tests/hello.b91
28

Modules

bytecode

Parsing and storing bytecode programs.

compiler

Compilation from assembly source to bytecode.

emulator

Emulator for executing bytecode programs.

error

Common error handling functionality.

event

Event handling.

instruction

types for representing instructions and their parts

parsing

Types and traits for common parsing functionality.

symbol_table

Data structure for information associated with symbols.

symbolic

Parsing and storing symbolic assembly programs.