This crate is a low-level abstraction (aka a Peripheral Access Crate) over the CPU and memory-mapped registers available on the Nintendo 64 console.
Due to the low-level nature of the API, most projects (games especially) are unlikely to use this crate directly.
| Peripheral | Registers | Complete |
|---|---|---|
| CP0 | 32 of 32 | ✓ |
| CP1 | 2 of 2* | ✓ |
| MI | 4 of 4 | ✓ |
| VI | 16 of 16 | ✓ |
| AI | 6 of 6 | ✓ |
| PI | 13 of 13 | ✓ |
| RI | 0 of ? | ✕ |
| SI | 6 of 6** | ✓ |
* The CP1/FPU has two control registers. The general purpose floating-point registers are manually accessible, but are
typically handled by the compiler when using f32 or f64 types.
** The SI might contain more registers that haven't been fully researched.
In your project's Cargo.toml:
[dependencies]
n64-pac = "0.x.y"Refer to the docs for examples and details regarding safety.
This crate is only intended to be used in the N64 embedded environment.
Please note this crate requires a nightly rust toolchain in order to use nightly-only inline assembly features and arbitrary discriminants.