Repository files navigation

m68000 is a Motorola 68000 interpreter, disassembler and assembler (code emitter) written in Rust.

This library emulates the common user and supervisor instructions of the M68k ISA. It is configurable to behave like the given CPU type (see below), changing the instruction's execution times and exception handling.

This library has been designed to be used in two different contexts:

• It can be used to emulate a whole CPU, and the user of this library only have to call the interpreter methods and exception when an interrupt or reset occurs. This is the typical use case for an emulator.
• It can also be used as a M68k user-mode interpreter to run a M68k program, but without the requirement of having an operating system compiled to binary M68k. In this case, the application runs the program until an exception occurs (TRAP for syscalls, zero divide, etc.), which can be handled in Rust code (or any other language using the C interface), so the application can implement the surrounding environment required by the M68k program in a high level language and not in M68k assembly.

The CPU type is specified with a generic parameter on the main structure. The traitCpuDetails contains all the details of the emulated CPU:

• Instruction execution times
• Exception processing times
• Exception stack format

m68000 provides CPU details for the following CPUs:

• MC68000 (as described in the M68000 8-/16-/32-Bit Microprocessors User’s Manual, Ninth Edition)
• SCC68070 microcontroller

m68000 requires a nightly compiler as it uses thebtree_extract_if andbigint_helper_methods features of the std.

First, since the memory map is application-dependant, it is the user's responsibility to define it by implementing theMemoryAccess trait on their memory structure, and passing it to the core on each instruction execution.

Second, choose the CPU behavior by specifying the instance that implements theCpuDetails trait, whether it is your own or one of the provided ones in the crate.

The filesrc/bin/scc68070.rs is a usage example that implements the SCC68070 microcontroller.

constMEM_SIZE:u32 =65536;structMemory([u8;MEM_SIZEasusize]);// Define your memory management system.implMemoryAccessforMemory{// Implement the MemoryAccess trait.fnget_byte(&mutself,addr:u32) ->Option<u8>{if addr <MEM_SIZE{Some(self.0[addrasusize])}else{None}}// And so on...}fnmain(){letmut memory =Memory([0;MEM_SIZEasusize]);// Load the program in memory here.letmut cpu:M68000<m68000::cpu_details::Mc68000> =M68000::new();// Execute instructions    cpu.interpreter(&mut memory);}

SeeCINTERFACE.md.

m68000 is distributed under the terms of theMozilla Public License version 2.0. Refer to the LICENSE file for more information.