## 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:

- save and restore ccbl settings to an external memory device
- display text of ccbl settings as a display list

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

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.

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.

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