Macros
#define	RDPQ_VALIDATE_FLAG_NOECHO 0x00000001
	Disable echo of commands triggering validation errors.

#define	RDPQ_LOG_FLAG_SHOWTRIS 0x00000001
	Show all triangles in logging (default: off)

#define	RDPQ_VALIDATE_DETACH_ADDR 0x00800000
	Special detach RDRAM address.

Functions
void	rdpq_validate (uint64_t buf, uint32_t flags, int errs, int *warns)
	Validate the next RDP command, given the RDP current state.

Variables
void(*	rdpq_trace )(void)
	Log all the commands run by RDP until the time of this call.

void(*	rdpq_trace_fetch )(bool new_buffer)
	Notify the trace engine that RDP is about to change buffer.

int	__rdpq_debug_log_flags
	Flags that configure the logging.

Detailed Description

Author: Dennis Heinze denni.nosp@m.sjp..nosp@m.heinz.nosp@m.e@gm.nosp@m.ail.c.nosp@m.om

Macro Definition Documentation

◆ RDPQ_VALIDATE_DETACH_ADDR

#define RDPQ_VALIDATE_DETACH_ADDR 0x00800000

Special detach RDRAM address.

When this is set to a non-zero value, the validator will treat the address specified here as a special "detach" marker. When SET_COLOR_IMAGE or SET_Z_IMAGE are sent with this address, the validator will adjust its internal state as if the no SET_COLOR_IMAGE was ever sent, giving appropriate error messages if a drawing command is then issued.

This allows libdragon to improve the user experience when the user forgets to configure the render target, explicitly telling that no render target is currently attached to RDP.

On real hardware, when the RDP is configured to access an address in range 0x00800000 - 0x00FFFFFF, it will simply ignore all writes (and all reads return 0), so anything in that range is actually a safe value to "disable" a render target.

Function Documentation

◆ rdpq_validate()

void rdpq_validate	(	uint64_t *	buf,
		uint32_t	flags,
		int *	errs,
		int *	warns
	)

Validate the next RDP command, given the RDP current state.

Parameters

	buf	Pointer to the RDP command
	flags	Flags that configure the validation
[out]	errs	If provided, this variable will contain the number of validation errors that were found.
[out]	warns	If provided, this variable will contain the number of validation warnings that were found.

Variable Documentation

◆ rdpq_trace

void(* rdpq_trace) (void) ( void )

extern

Log all the commands run by RDP until the time of this call.

Given that RDP buffers get reused as circular buffers, it is important to call this function often enough.

◆ rdpq_trace_fetch

void(* rdpq_trace_fetch) (bool new_buffer) ( bool new_buffer )

extern

Notify the trace engine that RDP is about to change buffer.

Calling this function notifies the trace engine that the RDP buffer is possibly going to be switched soon, and the current pointers should be fetched and stored away for later dump.

Notice that this function does not create a copy of the memory contents, but just saves the DP_START/DP_END pointers. It is up to the client to make sure to call rdpq_trace() at least once before the same buffer gets overwritten in the future.

Parameters

new_buffer If true, we know for sure that the RDP is about to switch buffer. If false, this is an optimistic reading (eg: done in idle time), so the contents might match previous readings.

Macros

Functions

Variables