Crate mos_hardware

Expand description

This crate contains hardware register tables and support functions for 8-bit retro computers like the Commodore 64, Commander X16, MEGA65 and others. Please check the examples/ directory to see how Rust can be used generate basic graphics effects and interact with hardware.

Examples

Read and write to labelled hardware registers:

use mos_hardware::{c64,vic2};

let old_border_color = (*c64::VIC).border_color.read();
(*c64::VIC).border_color.write(vic2::LIGHT_RED);
(*c64::SID).potentiometer_x.write(3); // error: read-only register

Use bitflags to control hardware behaviour, e.g. where the VIC-II chip accesses screen memory and character sets:

let bank = vic2::ScreenBank::AT_2C00.bits() | vic2::ScreenBank::AT_2000.bits();
(*c64::VIC).screen_and_charset_bank.write(bank);

Convenience functions to perform hardware-specific tasks, e.g. generate random numbers using noise from the C64’s SID chip:

(*c64::SID).start_random_generator();
let random_number : u8 = rand8!(c64::SID);

Modules

c64

Commodore 64 support.

cia

Registers for the MOS Technology 6526/8520 Complex Interface Adapter (CIA)

cx16

Commander X16 support.

mega65

MEGA65 support.

sid

Registers for the MOS Technology 6581/8580 SID (Sound Interface Device)

vera

Registers for the Versatile Embedded Retro Adapter (VERA) graphics chip.

vic2

Registers for the MOS 6566/6567 (VIC-II) Chip

Macros

add

Add two integers using wrapping

highbyte

Get high byte from a 16-bit integer using pointer arithmetic

lowbyte

Get low byte from a 16-bit integer using pointer arithmetic

peek

Peek into memory (volatile read)

poke

Poke into memory (volatile write)

rand8

Use SID entropy to generate a random byte.

sub

Subtract two integers using wrapping

Functions

repeat_element

Repeat each element n times