n64chain

KO | EN

gitlite — search

#javascript #hacktoberfest #golang #android #deep-learning #linux #nodejs #java #cli #vue #security #ios #mcp #openai

(★ 156)

A (free) open-source N64 development toolchain.

파일 탐색기

최종 버전 다운로드 (.zip)

- Makefile
- n64chain-doc.bib
- n64chain-doc.tex
- - data.txt
- - main.c
- Makefile
- - init.c
  - rspbuf.c
- - gfx.rsp
  - gfx.rsps
- Makefile
- - io.h
  - libn64.h
  - mq.h
  - sp.h
  - stddef.h
  - stdint.h
  - syscall.h
  - time.h
- - filesystem.c
  - init.c
  - pi_thread.c
  - si_thread.c
- - fbtext.c
  - main.c
  - mm.c
  - panic.c
  - thread.c
  - time.c
- - vi.c
- - init.c
  - sp_thread.c
- - defs.h
  - init.rsp
  - init.rsps
- Makefile
- rom.ld
- - 3d.c
  - 3dscene.c
  - main.c
- Makefile
- emitter.c
- emitter.h
- identifiers.c
- identifiers.h
- lexer.l
- main.c
- Makefile
- opcodes.h
- parser.y
- rspasm.h
- symbols.c
- symbols.h
- - main.c
- Makefile
- build-posix64-toolchain.sh
- build-win64-toolchain.sh
- checksum.c
- mkfs.c
.gitignore
LICENSE
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# n64chain

This is a Nintendo 64 development toolchain based on GCC that does not depend on any proprietary Nintendo library.
Only thing that you need to provide is a 2kb bootcode compatible with your CIC to bootstrap the code.
This is not included in n64chain.

The library includes basic OS functionality supporting multi-threading through hardware interrupts on the
single MIPS 4300 CPU of the N64. Mainly written in C and MIPS assembly, it is expected to provide a
lightweight development environment and thus requires some low-level baby sitting.

## Building

To build the toolchain, first put your boot code named `header.bin` on the `libn64` folder. Run `build-posix64-toolchain.sh`
in the `tools` folder on a bash-compatible shell to start building the cross-compiler.
Prerequisites are GMP, MPFR and MPC with development headers, build-essential, and bison, which can be installed via `apt install build-essential libmpfr-dev libmpc-dev libgmp-dev flex bison`
on Ubuntu. On Mac, the Xcode command-line tools are also required. The other prerequisites can be installed via the homebrew 
package manager like so `brew install mpfr isl libmpc gmp flex bison && brew link bison --force`.

There is also a Windows compatible version `build-win64-toolchain.sh` that still requires a UNIX-like environment to run.

After the custom GCC build is completed, you should be able to build the helloworld example by running `make` inside
helloworld folder or with `make -C helloworld` on project root. This will also build the libn64 dependency on the project root.
When it is complete you should have a `.z64` rom image ready to be run on a Nintendo 64. The same procedure applies for the
`rdpdemo` and `threadtest` examples.

## Basic N64 architecture

The N64 have a main MIPS4300 processor and a MIPS-like coprocessor called the Reality Co-processor (RCP). These two share
the RDMEM, albeit not sharing a common data bus (instead through DMA controllers and instructions). RCP has two major
sub-units namely the Reality Signal Processor (RSP) and Reality Display Processor (RDP).

Although use-case is dependent on the developer RSP, having an additional vector co-processor, is generally used for
processing 3D transformations and audio processing via microcodes (a program written with a subset of MIPS instructions)
and RDP is used for rasterizing the final image directly onto a display buffer. The latter uses custom 64-bit 'commands'
that instruct RDP to do various pixel manipulations. Using these resources in a balance is key to write performant
applications on N64.

n64chain

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

n64chain

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README