NITRO-DWC Function Reference Manual
(US Version)

Supports NITRO-DWC 1.2 Release Version
Supports NITRO-DWC-DL 1.2 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 up to NITRO-DWC 1.2 Release Version / NITRO-DWC-DL 1.2 Release Version

Table of Contents

Introduction
Structure of NITRO-DWC
How to Use
Notes
About this Document
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 NITRO-DWC with only the download feature extracted. Items marked with a in the features list cannot be used.

NITRO-DWC / NITRO-DWC-DL require the following libraries and compilers.

Notes

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

NITRO-DWC allows for the formulaic processing of the features below:

NITRO-DWC-DL can use only the following features:

Using the Library

Set the path to NitroDWC in the environment variable NITRODWC_ROOT.

To use NITRO-DWC you must connect to Nintendo's Authentication server and to the GameSpy's 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 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 the character string "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 a 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: Presently, there is no method available for checking the operating state of the download server.

Comments

Regarding licenses

Root certificates from VeriSign et al. are incorporated as part of the automatic connection process. For reasons related to licensing, do not modify or use it for other purposes.

A font is included to verify the operation of sample demos. For reasons related to licensing, do not modify or use it for other purposes.

About WEP Keys

Documentation

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

In addition, documents such as the "Nintendo Wi-Fi Connection Programming Guidelines" which contain cautions for when producing a game, or the newest versions of packaged documentation can be obtained from the Nintendo support website.
NOTE: When using NITRO-DWC-DL, refer to the "Nintendo Wi-Fi Connection NITRO-DWC Programming Guidelines - Download Edition -".

About the Sample Demos

The implemented "feature samples" marked with a ○ are stored in $(NITRODWC_ROOT)/build/demos. 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. ・rsaquo;
dwc_connect_inet_sample This simple demo shows the process up to connecting to the Internet. ・rsaquo; ・rsaquo;
dwc_userdata_sample This demo handles user data. ・rsaquo;
dwc_frienddata_sample This demo shows the handling of friend information. ・rsaquo;
dwc_anybody_match_sample This demo shows the creation of an automatic mesh connection, without any awareness of the connection order for a large number of unspecified partners. ・rsaquo;
dwc_friend_match_sample This demo shows the creation of an automatic mesh connection without any awareness of friend-exclusive connection order. ・rsaquo;
dwc_sc_match_sample This demo shows the creation of a semi-automatic mesh connection, with a friend exclusive server-client method. ・rsaquo;
dwc_eval_callback_sample This sample is about evaluating matchmaking candidate players during peer matchmaking. ・rsaquo;
friend_match This sample is about matchmaking. ・rsaquo;
rank_sample A sample of the general-purpose ranking feature ・rsaquo;
ghttp_sample A sample demonstrating the HTTP networking features. ・rsaquo;
dwc_naslogin_sample This is the Nintendo Authentication Server login sample. ・rsaquo; ・rsaquo;
dwc_nd_sample A sample demonstrating the download features (the Wi-Fi download service) ・rsaquo; ・rsaquo;

NTR-06-0404-001-C2
CONFIDENTIAL