Revision as of 03:53, 27 April 2020

Cinoop 3DS

A multiplatform Game Boy emulator written in C; currently available for: Windows, OS X, Linux based OSes, Nintendo DS, Nintendo 3DS, Nintendo GameCube, Sony PSP, and Sony PS4. Read my article about writing Cinoop here.

Progress

CPU: All instructions are implemented, GPU: Can display tile maps, and sprites. Palette swapping is not implemented yet, so some colours may be displayed incorrectly. Memory: Support for 32KB ROMs, without mappers, only (Tetris and Dr. Mario), Input: Supported, Sound: None, Games: Tetris is most likely the only playable game.

Building

Just run make on the directory to build all binaries. You can also run make windows for just Windows, make ds for just DS, make gamecube for just GameCube, make 3ds for just 3DS, make linux for just Linux, make psp for just PSP, or make ps4 for just PS4. Building the Windows version requires LDFS, and has been tested with MinGW, using another compiler may require some tweaking.

Building the DS version requires devkitARM and libnds, from devkitPro. Building the GameCube version requires devkitPPC and libogc, from devkitPro. Building the 3DS version requires devkitARM and ctrulib from devkitPro. Building the Linux version requires X11, and the OpenGL development files. It has been tested with Ubuntu. Building the PSP version requires the Minimalist PSP SDK. Building the PS4 version requires PS4-SDK. Building and running the OS X version requires XQuartz.

Usage

For Windows, OS X, and Linux, pass the ROM you would like to run as the first argument. You can do this by either dragging the ROM onto Cinoop, or starting it from the command line: cinoop tetris.gb To view the full debug log, you will need to redirect stdout to a file, like so: cinoop tetris.gb 1>debug.txt For PS4, the ROM is read from a USB flash drive as a raw image. Use Win32 Disk Imager or dd to write it for example. For other versions, the ROM name is hard coded as tetris.gb.

Windows Controls

B: Z
A: X
Start: Enter
Select: Backspace
DPad: Arrow keys
Debug: Space
Reset (not finished yet): *
Quit: Escape

DS Controls

B: B
A: A
Start: Start
Select: Select
DPad: DPad

GameCube Controls

B: B
A: A
Start: Start
Select: Z
DPad: DPad

3DS Controls

B: B
A: A
Start: Start
Select: Select
DPad: DPad or Circle Pad

Linux Controls

(not supported)

OS X Controls

(not supported)

PSP Controls

B: Square
A: Cross
Start: Start
Select: Select
DPad: DPad

PS4 Controls

Use a DS as a wireless controller

@@ Line 7: / Line 7: @@
 | author = CTurt
 | website = https://github.com/CTurt/Cinoop
-| download = https://dlhb.gamebrew.org/3dshomebrew/Cinoop-master.zip
 | source = https://dlhb.gamebrew.org/3dshomebrew/Cinoop-master.zip
 }}
-<youtube></youtube>
+<youtube>94Q91xDJatE</youtube>
-= Cinoop - Source Only! =
+= Cinoop 3DS =
 A multiplatform Game Boy emulator written in C; currently available for: Windows, OS X, Linux based OSes, Nintendo DS, Nintendo 3DS, Nintendo GameCube, Sony PSP, and Sony PS4. Read my article about writing Cinoop [http://cturt.github.io/cinoop.html here].
 == Progress ==
-'''CPU:''' All instructions are implemented, '''GPU:''' Can display tile maps, and sprites. Palette swapping is not implemented yet, so some colours may be displayed incorrectly. '''Memory:''' Support for 32KB ROMs, without mappers, only (Tetris and Dr. Mario), '''Input:''' Supported, '''Sound:''' None, '''Games:''' Tetris is most likely the only playable game, [[File:screenshots/tetris.png|Windows version running Tetris]] [[File:screenshots/ds.png|DS emulator running Cinoop]] [[File:screenshots/gamecube.png|GameCube emulator running Cinoop]] [[File:screenshots/ubuntu.png|Ubuntu version running Tetris]] [[File:screenshots/psp.png|PSP emulator running Cinoop]] [https://www.youtube.com/watch?v=94Q91xDJatE Video of PS4 verstion running Tetris] The DS version does not run full speed, and the Linux port does not yet support input.
+'''CPU:''' All instructions are implemented, '''GPU:''' Can display tile maps, and sprites. Palette swapping is not implemented yet, so some colours may be displayed incorrectly. '''Memory:''' Support for 32KB ROMs, without mappers, only (Tetris and Dr. Mario), '''Input:''' Supported, '''Sound:''' None, '''Games:''' Tetris is most likely the only playable game.
 == Building ==
-Just run <code>make</code> on the directory to build all binaries. You can also run <code>make windows</code> for just Windows, <code>make ds</code> for just DS, <code>make gamecube</code> for just GameCube, <code>make 3ds</code> for just 3DS, <code>make linux</code> for just Linux, <code>make psp</code> for just PSP, or <code>make ps4</code> for just PS4. Building the Windows version requires [https://github.com/CTurt/LDFS LDFS], and has been tested with [http://www.mingw.org/ MinGW], using another compiler may require some tweaking. Building the DS version requires devkitARM and libnds, from [http://devkitPro.org devkitPro]. Building the GameCube version requires devkitPPC and libogc, from [http://devkitPro.org devkitPro]. Building the 3DS version requires devkitARM and ctrulib from [http://devkitPro.org devkitPro]. Building the Linux version requires [http://en.wikipedia.org/wiki/X_Window_System X11], and the OpenGL development files. It has been tested with [http://www.ubuntu.com/ Ubuntu]. Building the PSP version requires the [http://sourceforge.net/projects/minpspw/ Minimalist PSP SDK]. Building the PS4 version requires [https://github.com/CTurt/PS4-SDK PS4-SDK]. Building and running the OS X version requires [https://xquartz.macosforge.org XQuartz].
+Just run <code>make</code> on the directory to build all binaries. You can also run <code>make windows</code> for just Windows, <code>make ds</code> for just DS, <code>make gamecube</code> for just GameCube, <code>make 3ds</code> for just 3DS, <code>make linux</code> for just Linux, <code>make psp</code> for just PSP, or <code>make ps4</code> for just PS4. Building the Windows version requires [https://github.com/CTurt/LDFS LDFS], and has been tested with [http://www.mingw.org/ MinGW], using another compiler may require some tweaking.
+Building the DS version requires devkitARM and libnds, from [http://devkitPro.org devkitPro]. Building the GameCube version requires devkitPPC and libogc, from [http://devkitPro.org devkitPro]. Building the 3DS version requires devkitARM and ctrulib from [http://devkitPro.org devkitPro]. Building the Linux version requires [http://en.wikipedia.org/wiki/X_Window_System X11], and the OpenGL development files. It has been tested with [http://www.ubuntu.com/ Ubuntu]. Building the PSP version requires the [http://sourceforge.net/projects/minpspw/ Minimalist PSP SDK]. Building the PS4 version requires [https://github.com/CTurt/PS4-SDK PS4-SDK]. Building and running the OS X version requires [https://xquartz.macosforge.org XQuartz].
 == Usage ==
 For Windows, OS X, and Linux, pass the ROM you would like to run as the first argument. You can do this by either dragging the ROM onto Cinoop, or starting it from the command line: cinoop tetris.gb To view the full debug log, you will need to redirect <code>stdout</code> to a file, like so: cinoop tetris.gb 1&gt;debug.txt For PS4, the ROM is read from a USB flash drive as a raw image. Use [http://sourceforge.net/projects/win32diskimager/ Win32 Disk Imager] or <code>dd</code> to write it for example. For other versions, the ROM name is hard coded as <code>tetris.gb</code>.