megadrive-sys

Crates.iomegadrive-sys
lib.rsmegadrive-sys
version0.1.0
sourcesrc
created_at2021-02-25 01:11:02.119837
updated_at2021-02-25 01:11:02.119837
descriptionBindings to the Sega Mega Drive (Genesis) hardware.
homepagehttps://github.com/ricky26/rust-mega-drive
repositoryhttps://github.com/ricky26/rust-mega-drive
max_upload_size
id360192
size48,083
Ricky Taylor (ricky26)

documentation

README

Mega Drive toolkit for Rust

This repository hosts a few packages for use with the SEGA Mega Drive.

Using these packages

At the moment, these packages only work with a fork of LLVM & Rust. To use them you will need to build both.

Building LLVM

  1. Checkout the llvm-12 branch from LLVM project fork.

  2. Build the toolchain with cmake:

    1. Generate the project with the M68k backend enabled:
      cd M68x0-mono-repo
      mkdir build
      cd build
      cmake -G Ninja "-DLLVM_USE_LINKER=lld" "-DCMAKE_BUILD_TYPE=RelWithDebInfo" "-DLLVM_ENABLE_ASSERTIONS=ON" "-DLLVM_PARALLEL_LINK_JOBS=1" "-DLLVM_TARGETS_TO_BUILD=X86" "-DLLVM_EXPERIMENTAL_TARGETS_TO_BUILD=M68k" "-DLLVM_ENABLE_PROJECTS=clang;lld" ..
      
    2. Build:
      ninja -j16
      
      (This step can take along time and a lot of memory if used with a lot of threads.)
    3. You should now have all of the LLVM binaries in build/bin.

Building Rust

  1. Checkout the Rust fork (clone the m68k-linux branch).

  2. Copy config.toml.example to config.toml and edit:

    1. Set [build] target = ["x86_64-unknown-linux-gnu", "m68k-unknown-linux-gnu"
    2. Set [target.x86_64-unknown-linux-gnu] llvm-config = "path/to/build/bin/llvm-config"
  3. Build:

    ./x.py build --stage=2 rustc cargo
    
  4. You should now have a Rust toolchain in build/x86_64-unknown-linux-gnu/stage2.

  5. Link the toolchain in rustup so it is easier to use:

    rustup toolchain link m68k "path/to/build/x86_64-unknown-linux-gnu/stage2"
    

Building this repository

  1. Set the required environment variables:
    export MEGADRIVE_HOME=path/to/repo
    export RUSTUP_TOOLCHAIN=m68k
    export LLVM_CONFIG=path=/to/llvm/build/bin/llvm-config
    
  2. Build the tools & libraries:
    cargo build --release
    
  3. Install the cargo tool:
    cd tools/cargo-megadrive
    cargo install --path=.
    
  4. Build the example Mega Drive image:
    cd examples/megapong
    cargo megadrive build
    
  5. You should now have an example megadrive image in target/m68k-none-eabi/release/megapong.md.

License

This suite is distributed under the terms of the MIT license. The full license text can be read in LICENSE.

Commit count: 212

cargo fmt