N64 System Interface. More...

Macros
#define	build_opcode(op, cache) (((op) << 2) \| (cache))
	Helper macro to create the opcode for a cache operation. Operation is encoded in 5 bits where bits 4..2 contain the operation type and bits 0..1 determine the cache that is to be operated on.

#define	cache_op(op, linesize)
	Helper macro to perform cache refresh operations.

Functions
void	data_cache_hit_writeback (volatile const void *addr, unsigned long length)
	Force a data cache writeback over a memory region.

void	data_cache_hit_invalidate (volatile void *addr, unsigned long length)
	Force a data cache invalidate over a memory region.

void	data_cache_hit_writeback_invalidate (volatile void *addr, unsigned long length)
	Force a data cache writeback invalidate over a memory region.

void	data_cache_index_writeback_invalidate (volatile void *addr, unsigned long length)
	Force a data cache index writeback invalidate over a memory region.

void	data_cache_writeback_invalidate_all (void)
	Force a data cache writeback invalidate over whole memory.

void	inst_cache_hit_writeback (volatile const void *addr, unsigned long length)
	Force an instruction cache writeback over a memory region.

void	inst_cache_hit_invalidate (volatile void *addr, unsigned long length)
	Force an instruction cache invalidate over a memory region.

void	inst_cache_index_invalidate (volatile void *addr, unsigned long length)
	Force an instruction cache index invalidate over a memory region.

void	inst_cache_invalidate_all (void)
	Force an instruction cache invalidate over whole memory.

void *	malloc_uncached (size_t size)
	Allocate a buffer that will be accessed as uncached memory.

void *	malloc_uncached_aligned (int align, size_t size)
	Allocate a buffer that will be accessed as uncached memory, specifying alignment.

void	free_uncached (void *buf)
	Free an uncached memory buffer.

int	get_memory_size (void)
	Get amount of available memory.

bool	is_memory_expanded (void)
	Is expansion pak in use.

void	assert_memory_expanded (void)
	Assert that the expansion pak is present.

reset_type_t	sys_reset_type (void)
	Get reset type.

uint64_t	get_ticks (void)
	Read the number of ticks since system startup.

uint64_t	get_ticks_us (void)
	Read the number of microseconds since system startup.

uint64_t	get_ticks_ms (void)
	Read the number of millisecounds since system startup.

void	wait_ticks (unsigned long wait)
	Spin wait until the number of ticks have elapsed.

void	wait_ms (unsigned long wait_ms)
	Spin wait until the number of milliseconds have elapsed.

void	die (void)
	Force a complete halt of all processors.

void	sys_get_heap_stats (heap_stats_t *stats)
	Return information about memory usage of the heap.

void	__init_cop1 (void)
	Initialize COP1 with default settings that prevent undesirable exceptions.

Variables
int	__boot_memsize
	Memory size as detected by IPL3.

int	__boot_tvtype
	TV type as detected by IPL3.

int	__boot_resettype
	Reset type as detected by IPL3.

int	__boot_consoletype
	Console type as detected by IPL3.

bool	__expanded_memory_asserted = false
	Records whether the user called a function to check for the presence of expanded memory.

Detailed Description

N64 System Interface.

Author: Jennifer Taylor drago.nosp@m.nmin.nosp@m.ded@d.nosp@m.rago.nosp@m.nmind.nosp@m.ed.c.nosp@m.om; Giovanni Bajo giova.nosp@m.nnib.nosp@m.ajo@g.nosp@m.mail.nosp@m..com

Macro Definition Documentation

◆ build_opcode

#define build_opcode	(	op,
		cache
	)	(((op) << 2) \| (cache))

Helper macro to create the opcode for a cache operation. Operation is encoded in 5 bits where bits 4..2 contain the operation type and bits 0..1 determine the cache that is to be operated on.

Parameters

[in]	op	Operation type to perform.
[in]	cache	Specific cache to perform the operation on.

◆ cache_op

#define cache_op	(	op,
		linesize
	)

Value:

    ({ \
    if (length) { \
        void *cur = (void*)((unsigned long)addr & ~(linesize-1)); \
        int count = (int)length + (addr-cur); \
        for (int i = 0; i < count; i += linesize) \
            asm ("\tcache %0,(%1)\n"::"i" (op), "r" (cur+i)); \
    } \
})

Helper macro to perform cache refresh operations.

Parameters

[in]	op	Operation to perform
[in]	linesize	Size of a cacheline in bytes

Function Documentation

◆ __init_cop1()

void __init_cop1 ( void )

Initialize COP1 with default settings that prevent undesirable exceptions.

Enable FPU exceptions that can help programmers avoid bugs in their code. Underflow exceptions are not enabled because they are triggered whenever a denormalized float is generated, even if the FS bit is set (see below). So basically having the underflow exception enabled seems to be useless unless also the underflow (and the inexact) exceptions are off. Notice that underflows can happen also with library code such as tanf(BITCAST_I2F(0x3f490fdb)) (0.785398185253).

Macros