dptest Manual Version 0.1


Summary

dptest is ...

... a program for adding several functions that are compatible with the ccbl program that runs on the N64.

Its main functions are:

ccbl is ...

... the name of a program that runs on the N64. It was created as a simple tutorial for the ColorCombiner and Blender functions of RDP, a function program for the Nintendo 64.

In order to be compatible with dptest, the ccbl made by the command "make DPTEST=1" is stored, by default, as dptest.n64 in [instal-dir]/ccbl/dptest.n64. This can be changed by the user.

Please also refer to the ccbl Manual.

Operating Environment

Platforms Windows 95, Windows 98, Windows NT 4.0(SR3)
Targets MSP-A, MSP-B, MSP-C
Partner-N64PC
IS-Viewer64

Note: dptest cannot be used on the Partner-N64PC under Windows NT with a Partner PCI I/F board.


How to Use dptest

Required Files

The following files are included in the dptest package.

dptest.exe dptest executable file
TargetN64.dll DLL for controlling the various target devices.
KMCCtrl.dll DLL for controlling the Partner-N64PC.
dptest.n64 ccbl ROM image for dptest.

Store these files in any directory. However, make sure to store them all in the same directory.

Running dptest

Double click on dptest.exe in Windows Explorer.

The dptest main window will open, which is shown below.

Main Window Graphic
dptest Main Menus
File Save
Restore
Exit
Target Initialize
Sample Static DL Setup
Sample Dynamic DL Setup
Save
Restore
Setup Select Target
Help About dptest

Setup

In order to use the dptest functions, you must specify the type of target to be used.

Choose [Select Target] from the [Setup] menu. The "Select Target" dialog box will appear.

Graphic of Select Target dialog box
Selecting a Target
To select any of MSP-A, MSP-B, or MSP-C Select the [MSP] radio button.
Then select the target to be used from the combo box on the right.
To select Partner-N64PC Select the [PTR] radio button.
In the edit box on the right, enter the full pathname of the directory in which Partner (debugger) is installed.
To select IS-Viewer64 Select the [ISV] radio button.
Then select the connected IS-Viewer64s that will be used from the combo box on the right.
The IS-Viewer64s are numbered from 0 (zero) in the order from the closest to the PC in the daisy chain. Please note that they are not identified by their SCSI ID.

When you are finished with your selection, click the OK button. Your selection will be validated and the N64 will be initialized.

dptest Functions

The main dptest functions are listed below.

Initialize
Menu [Target]-[Initialize]
Description Initializes the N64 and transfers ccbl.
Save As
Menu [File]-[Save to File]
Description Saves the content set by ccbl to a file.
Restore settings from file
Menu [File]-[Restore Settings]
Description Reads and restores ccbl settings which have been saved in a file.
Get sample settings for static display list
Menu [Target]-[Sample Static DL Settings]
Description Outputs ccbl settings to the GBI window as a static display list.
Get sample settings for dynamic display list
Menu [Target]-[Sample Dynamic DL Settings]
Description Outputs ccbl settings to the GBI window as a dynamic display list.

GBI Window

When the "Get sample settings for static/dynamic display list" function is executed, the resulting text is displayed in the window illustrated below. This window is called the GBI window.

Graphic of GBI window
File Save As
Save
Close
Edit Copy
Select All
Target Sample Static DL Settings
Sample Dynamic DL Settings

In this window, you can view the output display list and save it to a file.


Error Messages


Write failure to file
Please make sure there is enough space available on the storage medium.
Also check whether or not the file is write-protected.

Forced exit
User's operation was canceled while the target was being accessed.

Not a ccbl saved file.
Attempted to restore ccbl settings from a file which was not saved in ccbl.

ccbl saved file is wrong version
dptest version is older than that of the ccbl file which is being loaded. Please use the latest version of dptest and the corresponding version of ccbl.

Cannot find DLL
The DLL required for each target cannot be found. Check whether or not the software for the specified target has been properly installed.

Opening target failed.
The target does not exist. Check whether or not the hardware for the specified target has been properly installed.

Target does not exist
The target does not exist. Check whether or not the hardware for the specified target has been properly installed.

Specified target is already in use
Two instances of dptest are running and an attempt has been made to use the same target as that being used by the dptest that was started first.

Failure on initializing target
Initialization of the target has failed.

Program file (dptest.n64) not found on target side
Check whether or not dptest.n64 has been stored in the same directory as dptest.exe.

Registry

dptest settings are saved in a registry The next time dptest is started, the settings are loaded and applied to the program's operation.

The key name of this registry is "HKEY_LOCAL_MACHINE\SOFTWARE\Monegi\DPTest". This file should not be edited. However, the key may be deleted by deleting "HKEY_LOCAL_MACHINE\SOFTWARE\Monegi\DPTest".