NITRO-DWC Function Reference Manual
(US Version)

Supports NITRO-DWC[-DL] 2.1 Release Version

Note: This document contains proprietary information. Please take strict measures to keep this information confidential.

Microsoft Internet Explorer 5.0/Netscape 6.0 or later versions are recommended.

Revision History

Revision History through NITRO-DWC[-DL] 2.1 Release Version

Table of Contents

Introduction
Structure of NITRO-DWC
How to Use
Notes
About this Document
Icon Image Data
About the Sample Demos

Introduction

NITRO-DWC can be used to connect to the internet through Nintendo DS wireless communications (infrastructure mode), register friends, reference friends' status, and to connect to other Nintendo DS units that meet set conditions.

Note: NITRO-DWC[-DL] is only the download feature extracted from NITRO-DWC. Items in the feature list of this manual preceded by cannot be used with NITRO-DWC-DL.

NITRO-DWC[-DL] requires the following libraries and compilers:

Notes

The Structure of NITRO-DWC / NITRO-DWC-DL

The NITRO-DWC Library allows standard processing of the following features:

The NITRO-DWC-DL Library allows use of the following features among the above:

How to Use

Set the path to NitroDWC in the environment variable NITRODWC_ROOT.

To use NITRO-DWC[-DL] you must connect to the Nintendo authentication server and to the GameSpy server. Doing this requires an environment that can connect to the Internet.

Notes

Maintenance information regarding each server:

●Nintendo Server for Connection Tests

This server is intended to check if the Nintendo DS is currently in an environment where it can connect to the Internet. It runs non-stop.

Refer to the following link to confirm the operation status of each server; if the character string "This is test.html page" appears, the server is running.

Test Connection Server
●Nintendo Authentication Server

This server authenticates the user ID (Nintendo Wi-Fi Connection ID) that is set on the Nintendo DS, and issues information for connecting to the GameSpy server.

Two types of authentication servers are available: Use the development authentication server during development and debugging and the product authentication server when creating the final ROM. Although both the development and the production authentication server are operating continuously, the development authentication server may go down because it does not have a redundant configuration. If the development authentication server goes down for any reason, the product authentication server may be used.

Refer to the following links to confirm the operation status of each authentication server. If "AuthServer is up" appears, the server is running.

Authentication Server for Production Authentication Server for Development

IMPORTANT: By default, the authentication server for development is used. To switch the authentication server, you can use the DWC_SetAuthServer function. For more details, see the Function Reference.

●GameSpy Server

The GameSpy server is down every Tuesday from 16:00 to 18:00 Japan time (UTC/GMT +9). Sometimes the maintenance work will not be completed by 18:00 and the down time will last a little longer.

Note: Presently, there is no method available for checking the operating state of the GameSpy server.
Note: The general-purpose ranking feature also utilizes the GameSpy server.

●Nintendo Download Server

This is the server used for the Wi-Fi Download service. For details, read the Nintendo Wi-Fi Connection NITRO-DWC Programming Manual - Download Edition.

As with the Authentication server, there are two versions of the Nintendo Download server: one for development and one for production. Switching between the servers matches the switching between Authentication servers.

Note: Currently, there is no method available for checking the operating state of the download server.

●Comments

Licenses

About WEP Keys

Documentation

The $NITRODWC_ROOT/docs/ directory contains the following programming-related documents:

In addition, you can also obtain the latest versions of documentation, such as "Nintendo Wi-Fi Connection Programming Guideline" that include precautions on producing code, and other documentation included in this package from the Nintendo Support Page.

Note: When using NITRO-DWC-DL, refer to the "Nintendo Wi-Fi Connection NITRO-DWC Programming Guidelines - Download Edition -".

Icon Image Data

The $NITRODWC_ROOT/data/Wi-Fi_icons/ directory contains bitmap data and NITRO-CHARACTER data for the "Wi-Fi Connection Support Icon" and "Wi-Fi Reception Strength Icons" used by the Nintendo Wi-Fi Connection supported titles.
For the use of the individual icons, refer to the Nintendo Wi-Fi Connection Programming Guideline.

About the Sample Demos

The $NITRODWC_ROOT/build/demos/ directory contains the sample demos to be used as a reference for implementation.
Keep the following in mind:

The objective of each sample demo is explained below.

Sample name Overview NITRO-DWC NITRO-DWC-DL
dwc_sample This sample demonstrates the comprehensive use of the DWC Library features.
dwc_connect_inet_sample This is a simple sample of connecting to the Internet and checking the connection.
dwc_userdata_sample This is a sample used for handling user data.
dwc_frienddata_sample This is a sample used for handling friend information.
dwc_anybody_match_sample This is a sample showing the creation of an automatic mesh connection without any awareness of the connection order for a large number of unspecified partners.
dwc_friend_match_sample This is a sample showing the creation of an automatic mesh connection without any awareness of friend-exclusive connection order.
dwc_sc_match_sample This is a sample showing the creation of a semi-automatic mesh connection with a friend-exclusive server-client method.
dwc_eval_callback_sample This sample is about evaluating matchmaking candidate players during peer matchmaking.
friend_match This sample is about matchmaking.
rank_sample A sample of the general-purpose ranking feature
ghttp_sample A sample demonstrating the HTTP networking features.
dwc_naslogin_sample This is the Nintendo Authentication Server login sample.
dwc_nd_sample A sample demonstrating the download features (the Wi-Fi download service)
dwc_prof_sample A sample of the illegal character string check

NTR-06-0479-001-F
CONFIDENTIAL