n64sys.c File Reference

N64 System Interface. More...

Macros
#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)
	Underlying implementation of data_cache_hit_invalidate.
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 ()
	Get amount of available memory.
bool	is_memory_expanded ()
	Is expansion pak in use.
tv_type_t	get_tv_type ()
	Is system NTSC/PAL/MPAL.
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	__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.

Detailed Description

N64 System Interface.

Macro Definition Documentation

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).