Skip to content

DOOM.md

Latest commit

 

History

History
109 lines (73 loc) · 4.28 KB

DOOM.md

File metadata and controls

109 lines (73 loc) · 4.28 KB
Raw

DOOM on the CDJ-3000

Installing

Compatibility

  • Compatible with Renesas SoC based CDJ-3000s.

Note

There are reports that a Rockchip variant of the CDJ-3000 exists. Trying to install Magic Phono on this variant has not been tested. If you have one of these variants, please reach out to us!

Prerequisites

  • A compatible CDJ-3000
    • Audio connected via Digital Out (Analog Out support is WIP)
  • An SD-card with of at least 1 GiB in size
  • A USB key formatted to FAT32

Quick Install Guide

Prepare: Install Magic Phono Loader on CDJ-3000

Magic Phono Loader works by toggling a boot flag in non-volatile memory to allow booting firmware from an SD-card.

If no bootable SD-card is present, the CDJ-3000 will continue booting from internal firmware as usual.

You only need to do this once per player.

Caution

The chances of this bricking your CDJ-3000 is low, however there is a non-zero chance something could go wrong.

This tool is experimental software. USE AT YOUR OWN RISK.

Note

Besides from togging the boot flag in non-volatile memory, Magic Phono does not touch or modify any internal firmware or settings. Magic Phono runs entirely from SD-card.

To prepare your player:

  • Download the pre-built CDJ3KvSDBOOT001.UPD update file.
  • Copy it to a FAT32 USB key. Make sure there are no other update files on the USB key.
  • Insert the USB key into your CDJ-3000. Enter udpate mode by pressing IN/CUE and RELOOP/EXIT while powering on the unit.
  • Once complete, you can reboot your CDJ.
  • Congratulations! You can now boot custom firmwares from an SD-card, such as MagicPhono Linux.
  • If no bootable SD-card is present the CDJ-3000 will continue booting from internal firmware as usual.

Prepare: Download and Install Magic Phono to an SD-card

  • Download the pre-built magicphono-cdj3k-1.0-dev.img image.
  • Write it to a SD-card using a tool like Raspberry Pi Imager (despite the name it can write any image file to an SD card).
    • Tap OS on the left, scroll down and select Use Custom (see below)
    • Select the downloaded .img file
    • Tap Next, choose your SD-card and Write

Prepare: Copy the DOOM levels to USB key

  • Download doom1.wad and put it in the root directory of the USB key.

NOTE: Even though DOOM is open source, the actual game assets in doom1.wad are still commercial, copyrighted intellectual property. This is why it needs to be downloaded and copied seperately and cannot be directly included in the Magic Phono firmware image.

Run Magic Phono firmware with DOOM

  • On a CDJ-3000 with MagicPhono Loader installed:
    • Put the SD-card (Magic Phono image) in the SD slot
    • Put the USB key (with doom1.wad) in the USB slot
    • Turn the CDJ-3000 on
  • MagicPhono Linux should boot from the SD-card and start DOOM automatically.

Warning

Root access via SSH is enabled by default with no password. This will be disabled in future pre-built images as MagicPhono Linux stabilizes.

Known Issues

  • Audio currently only works via Digital Out. Analog Out support is work in progress.
  • Controls can get stuck sometimes, needs some improvement.

DOOM Controls

  • Rotary Encoder Press: Menu OK
  • Rotary Encoder: Menu up/down
  • Back: Menu back
  • Slip Forward: Forward
  • Slip Reverse: Back
  • Beat Jump Left: Fire
  • Beat Jump Right: Open/Use
  • Jogwheel : Look left/right
  • Jogwheel Press: Fire
  • Track Search Left: Strafe left
  • Track Search Right: Straft right
  • Loop Beat 4: Strafe modifier

Help

If DOOM doesnt start automatically, SSH into your player to debug what might be happening.

Some useful debugging commands:

dmesg
journalctl -b