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.
©2005, 2006 Nintendo Co.,Ltd. All rights reserved.
Microsoft Internet Explorer 5.0/Netscape 6.0 or later versions are recommended.
Revision history up to NITRO-DWC 1.2 Release Version / NITRO-DWC-DL 1.2 Release Version
Introduction
Structure of NITRO-DWC
How to Use
Notes
About this Document
About the Sample Demos
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
NITRO-DWC allows for the formulaic processing of the features below:
NITRO-DWC-DL can use only the following features:
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.
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 |
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.
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.
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.
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.
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 -".
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