Function

nuScCreateScheduler

Syntax

void nuScCreateScheduler(u8 videoMode, u8 numFields)

Arguments

videoMode       video mode setting(OS_VI_NTSC_LAN1) 
numFields        notification cycle of retrace(1=60Hz,2=30Hz...) 

Return Value

None

Description

Initialization and startup of the Scheduler

Set VI and start VI manager. It also creates and activates the thread for RCP task control. Since the function is called for initialization when starting up, it is not necessary to call this function from the application for NuSystem.

With the N64OS, the messages are sent to the related message queues when an interruption such as retrace or PRE NMI occurs. Since there is only one message queue that can be registered, multiple threads are not able to receive messages. Therefore, NuSystem has a feature, called the Scheduler, which sends the retrace and PRE NMI messages to multiple threads. The Scheduler receives retrace and PRE NMI interrupts from the N64 hardware and sends the event messages to registered clients. The nuScAddClient function is used to register clients.

During initialization of the scheduler, the VI manager is started, the video mode is set in "videoMode," and the retrace announcement cycle is set in "numFields." The screen is then blacked out with the osViBlack function. In addition, a system event handler thread is created as a VI (V-SYNC), SP, and DP event handler, and a graphics task thread and audio task thread are created for RCP task management. Furthermore, osTvType is referenced and frameRate is set.

The system event handler thread receives the VI and PRE NMI events from the N64OS and sends the messages to the registered clients.

When a PRE NMI event is received, the Y-Scale from two frames earlier (during which 0.5 seconds elapsed), is set to 1.0, the screen is cleared by osViSetBlack(TRUE), and osAfterPreNMI() is called. Once this occurs graphics tasks and audio tasks are prohibited from starting, in preparation for a reset.

The graphics task thread receives the graphics task message and executes the graphics task. Normally, the graphics task message is created and sent by the nuGfxTaskStart function.

The audio task thread receives the audio task message and executes the audio task. Normally, the audio task message is created and sent by the Audio Manager. If a graphics task is executed by the RSP while executing an audio task, the graphics task is stopped and the audio task is executed. The graphics task is restarted after the audio task is completed.

Revision History

2/1/99 Added text regarding processing after a PRE NMI event has occurred.