Following the excellent PSXdev tutorials by Lameguy64 at: http://lameguy64.net/tutorials/pstutorials/ [archived URL]

... but using a Rust SDK / toolchain: https://github.com/ayrtonm/psx-sdk-rs

In the 4 to 6 months since I started this learning / conversion project (mid-2024 to early 2025), the original tutorials have sadly dropped off the web :( I am now linking to the archived pages at the Internet Archive's Wayback Machine.

• 1.1 Setting up Graphics and Hello World
• 1.2 Drawing Graphics Primitives; Yellow Square
• 1.3 Textures, TPages and CLUTs; Textures
• 1.4 Initializing / Parsing Controller Data; Controllers
• 1.5 Rotating and moving polys using Fixed Point Math
• 1.6 Loading a TIM from CDROM filesystem; controller and CDROM DMA; Using the CD-ROM

• A.1 Random Number Generation: using system timer and user interaction to generate a seed

These bonus examples are written by me and don't come with a step-by-step tutorial, I'll try to document them, but they should demonstrate a simple isolated PSX concept or how-to that I've tried to figure out on my own, and recorded here for future reference.

1. Install the latest cargo-psx from psk-sdk-rs, ideally from source, following the simple instructions in the README. (cd cargo-psx; cargo install --path .)
2. Install Mednafen (Playstation and other console runner / emulator) for your system. You will need to follow the PSX BIOS instructions, this may be slightly complicated, but if you are doing PSX dev / emulation, you'll need to figure this out and obtain appropraite BIOS for the systems you need to emulate.
3. Run a tutorial example from this repo, e.g.:

cd 1.1_HelloWorld
cargo psx run

With cargo-psx and Mednafen correctly installed, you should see an blue/indigo screen with HELLO, WORLD! in white text.

All the original tutorial examples assume US / NA (North American) NTSC modes, so that is what I use here by default.

In the Mednafen config file, that's:

;Default region to use.
psx.region_default na

I hope these examples are useful to someone. The best way to use them would be to read the original tutorials to understand how the PSX works, then cross-reference these examples with the psx-sdk-rs psx API documentation.

C.Horn (Jan 2025)