MOS Hardware Template

Template for projects using the mos-hardware crate.

Getting started

The project requires rust-mos and is setup to build for C64 by default. A docker image of rust-mos is available for x86 and arm: (mrkits/rust-mos) or for arm64. See also llvm-mos wiki.

Docker and Visual Studio Code

The easiest way is to use the provided .devcontainer.json configuration for vscode.

1. Configure Visual Studio Code with the Remote - Containers extension. From the command-line:

   code --install-extension ms-vscode-remote.remote-containers

2. Install and start Docker
3. Open the project (e.g. with code .) and when asked, re-open in Dev container
4. In the vscode terminal type:

   cargo build --release --target mos-c64-none

   resulting in the binary target/mos-c64-none/release/mos-example (not missing .prg extension).