ryu64emulator / ryu64

A Nintendo 64 Emulator made in C#!

Welcome to Ryu64!

Hello, and welcome, to Ryu64! This emulator aims to emulate the Nintendo 64, don't expect much right now, no commercial games work at the time of writing this. But hopefully, that is soon to change, if you want to help just make a PR, we'll be glad to accept improvements to the emulator.

FAQ

What does the name "Ryu64" derive from?

Simply put, the name just comes from the RyuJIT which is what .NET uses to run applications built in both Visual Basic and C#, we use the latter.

Is there anywhere I can see your guys work on the emulator, and communicate, all in real time?

There is! We have a discord where all the developers hang out, talk about development, etc. Join here.

What is 86RYU? (Currently not in use, JIT coming soon)

86RYU is the x86 JIT currently developing along side this emulator, it aims to give some functionality C# it'd otherwise lack, aka, a functional x86 JIT that isn't RyuJIT and doesn't use MSIL. For maximum efficiency the JIT is programmed in C, compiled using GCC, the GNU Compiler, then linked in via a DLL / SO. The Github for that project is here.

Okay hopefully that answered most of your questions, if it didn't, join the discord and ask, go ahead, don't be shy!

ryu64's Issues

Test issue for webhook

Fix an issue some directly modifying Framebuffer homebrew has

General Issue

An issue arises when trying to run some homebrew like this and this as well as many others, both share similar error messages and graphical defects so are thought to be related.

Logs

Unhandled Exception: Ryu64.Common.Exceptions+InvalidOrUnimplementedMemoryMapException: "0x1ffffb0c" does not pertain to any mapped memory.  PC: 0x8000138c
   at Ryu64.MIPS.Memory.GetEntry(UInt32 index) in C:\Users\FranklinFamily\source\repos\Ryu64\Ryu64.MIPS\Memory.cs:line 238
   at Ryu64.MIPS.Memory.set_Item(UInt32 index, Int32 size, Byte[] value) in C:\Users\FranklinFamily\source\repos\Ryu64\Ryu64.MIPS\Memory.cs:line 295
   at Ryu64.MIPS.Memory.WriteUInt32(UInt32 index, UInt32 value) in C:\Users\FranklinFamily\source\repos\Ryu64\Ryu64.MIPS\Memory.cs:line 418
   at Ryu64.MIPS.InstInterp.SW(OpcodeDesc Desc) in C:\Users\FranklinFamily\source\repos\Ryu64\Ryu64.MIPS\Interpreter\InstInterpLoadStore.cs:line 108
   at Ryu64.MIPS.R4300.InterpretOpcode(UInt32 Opcode) in C:\Users\FranklinFamily\source\repos\Ryu64\Ryu64.MIPS\Interpreter\R4300.cs:line 127
   at Ryu64.MIPS.R4300.<>c.<PowerOnR4300>b__25_0() in C:\Users\FranklinFamily\source\repos\Ryu64\Ryu64.MIPS\Interpreter\R4300.cs:line 251
   at System.Threading.Thread.ThreadMain_ThreadStart()
   at System.Threading.ExecutionContext.RunInternal(ExecutionContext executionContext, ContextCallback callback, Object state)
--- End of stack trace from previous location where exception was thrown ---
   at System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw()

- CPUADDU.n64

Unhandled Exception: Ryu64.Common.Exceptions+InvalidOrUnimplementedMemoryMapException: "0x1ffffb0c" does not pertain to any mapped memory.  PC: 0x8000138c
   at Ryu64.MIPS.Memory.GetEntry(UInt32 index) in C:\Users\FranklinFamily\source\repos\Ryu64\Ryu64.MIPS\Memory.cs:line 238
   at Ryu64.MIPS.Memory.set_Item(UInt32 index, Int32 size, Byte[] value) in C:\Users\FranklinFamily\source\repos\Ryu64\Ryu64.MIPS\Memory.cs:line 295
   at Ryu64.MIPS.Memory.WriteUInt32(UInt32 index, UInt32 value) in C:\Users\FranklinFamily\source\repos\Ryu64\Ryu64.MIPS\Memory.cs:line 418
   at Ryu64.MIPS.InstInterp.SW(OpcodeDesc Desc) in C:\Users\FranklinFamily\source\repos\Ryu64\Ryu64.MIPS\Interpreter\InstInterpLoadStore.cs:line 108
   at Ryu64.MIPS.R4300.InterpretOpcode(UInt32 Opcode) in C:\Users\FranklinFamily\source\repos\Ryu64\Ryu64.MIPS\Interpreter\R4300.cs:line 127
   at Ryu64.MIPS.R4300.<>c.<PowerOnR4300>b__25_0() in C:\Users\FranklinFamily\source\repos\Ryu64\Ryu64.MIPS\Interpreter\R4300.cs:line 251
   at System.Threading.Thread.ThreadMain_ThreadStart()
   at System.Threading.ExecutionContext.RunInternal(ExecutionContext executionContext, ContextCallback callback, Object state)
--- End of stack trace from previous location where exception was thrown ---
   at System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw()

- FastQuantizationMultiBlockGFX16BIT.n64

Images

- CPUADDU.n64

- FastQuantizationMultiBlockGFX16BIT.n64

Start preparing for HLE rendering

Task List

• Add a way to get the F3D Version / Extension. (probably through a checksum)
• Figure out a way to get currently executing F3D Microcode.
• Add a basic framework for a F3D interpreter.

Add Doubleword Instructions

Add all the Doubleword instructions.

Add A JIT (86RYU)

Recommended to be worked on after most instructions are implemented in the interpreter, however, this can really be worked on anytime, but requires 86RYU to be finished first.

Add TLB Support

Add TLB Support.

Implement A GUI

This one is tough and not very high in priority, but would be nice.

Add Floating Point Instructions

Add all Floating Point instructions.

Add Basic Sound Support

Add support for the AI Registers.