NITRO-DWC[-DL] Library Revision History


NITRO-DWC[-DL] 2.1 Official Version (2007/05/18)
Note 13-01: Changed the maximum size of the user-defined data that can be used with general ranking
Note 13-02: Added Korea to the region codes used with general ranking
Note 13-03: Corrected a problem that prevented freeing of the memory during communications errors (DNS errors)
Note 13-04: Corrected a problem that caused a reference to a NULL pointer during communications errors
Note 13-05: Corrected a problem of the stack being used by HTTP communications (the GHTTP library)
Note 13-06: Made revisions to the Programming Manual
Note 13-07: Revised the Function Reference
Known issues in NITRO-DWC[-DL] 2.1 Official Version
NITRO-DWC[-DL] 2.1 RC (2007/04/09)
Note 12-01: Added functions for checking invalid character strings
Note 12-02: Changed the specifications for the English message for Nintendo Wi-Fi Connection Configuration
Note 12-03: Reviewed the processing executed by the DWC_GetDateTime function when the real-time clock exceeded 2099/12/31 23:59:59
Note 12-04: Made revisions to the Programming Manual
Note 12-05: Made additions and revisions to the Function Reference
Known issues in NITRO-DWC-DL Version 2.1 RC
NITRO-DWC[-DL] 2.0 Official Version (2007/03/12)
Note 11-01: Added a function for getting the authenticated user ID
Note 11-02: Added functions for back-and-forth conversions between friendship registration keys and strings.
Note 11-03: Added NITRO-CHARACTER data file for each icon.
Note 11-04: Revamped the socket closing process in the Download library.
Note 11-05: Corrected the problem that blocked the DWC_NdCleanupAsync function.
Note 11-06: Fixed the problem of the private functions being used in the sample demos.
Note 11-07: Made revisions to the Programming Manual
Note 11-08: Made additions and revisions to the Function Reference
Known issues in NITRO-DWC[-DL] 2.0 Official Version
Note: The NITRO-DWC 2.0 official version includes all changes up to the NITRO-DWC[-DL] 1.3 official version plus.
NITRO-DWC[-DL] 2.0 RC (2007/02/02)
Note 10-01: Made changes to the CodeWarrior version used in the build of the AOSS/Easy Wireless Start Library
Note 10-02: Corrected a bug-handling error in in the DWC_ProcessFriendsMatch function
Note 10-03: Corrected problems with the conditions for establishing friend relationships.
Note 10-04: Made revisions to the Programming Manual
Note 10-05: Revised the Function Reference
Known issues in NITRO-DWC-DL Version 2.0 RC
NITRO-DWC[-DL] 2.0 PR (2007/01/05)
Note 9-01: Made changes to the CodeWarrior version used in the build of the NITRO-DWC package
Known issues in NITRO-DWC[-DL] 2.0 PR

The NITRO-DWC[-DL] 2.0 and NITRO-DWC[-DL] 1.3 series are maintained as parallel versions branching from NITRO-DWC[-DL] 1.3 RC.
However, all the changes in the 1.3 series are included in the 2.0 series.

NITRO-DWC[-DL] 1.3 RC (2006/12/29)
Note 8-01: Added Korean language support to Wi-Fi Connection settings.
Note 8-02: Added a function for testing the connection to the Internet.
Note 8-03: Added a feature for performing HTTP communications (GHTTP Library.)
Note 8-04: Changed the DWC_NdCleanupAsync function specification
Note 8-05: Changed the specifications of the memory deallocation function specified in the DWC_SetMemFunc function.
Note 8-06: Changed the server URL used by the general ranking library.
Note 8-07: Changed the general ranking management tool (DWCRankingAdmin.exe.)
Note 8-08: Added support for parts where there is no timeout during communications with the GameSpy server during matchmaking.
Note 8-09: Fixed an issue with the error code generated during wireless link disconnection.
Note 8-10: Corrected a problem related to the default settings of the Nintendo authentication server to be used.
Note 8-11: Corrected a problem related to communication errors of the DWC_NASLoginProcess function.
Note 8-12: Corrected a problem where execution would sometimes stop during matchmaking for more than one person.
Note 8-13: Corrected a problem related to freeing memory for the DWC_ShutdownFriendsMatch function.
Note 8-14: Corrected a problem with the isChanged argument of the DWCUpdateServersCallback function.
Note 8-15: Corrected a problem related to communication errors of the DWC_LoginToStorageServerAsync function.
Note 8-16: Corrected a problem related to freeing memory for HTTP communications and general-purpose ranking.
Note 8-17: Corrected a problem related to freeing memory for the DWC_NdCleanupAsync function.
Note 8-18: Corrected an issue with the download library socket close operation.
Note 8-19: Corrected an issue with the download library cancellation operation.
Note 8-20: Fixed a sound problem in the Wi-Fi Connection setting.
Note 8-21: Corrected a problem when moving Wi-Fi user information using Wi-Fi Connection settings.
Note 8-22: Removed problematic definitions
Note 8-23: Standardized the character code used in all comments to SJIS.
Note 8-24: Revised the sample demo
Note 8-25: Made revisions to the Programming Manual
Note 8-26: Revised the Function Reference
Known issues in NITRO-DWC[-DL] Version 1.3 RC
NITRO-DWC 1.2 Release Version plus3/NITRO-DWC-DL 1.2 Release Version (2006/08/02)
Note 7-01: Improved security for the Download functionality
Note 7-02: Set the new error code 540XX
Note 7-03: Fixed a bug in the DWC_UpdateConnection function
Note 7-04: Fixed a bug in the DWC_LoginToStorageServerAsync function
Note 7-05: Corrected sample demos
Note 7-06: Made revisions to the Programming Manual
Note 7-07: Revised function reference
Note 7-08: Fixed a bug in the general-purpose ranking management tool (DWCRankingAdmin.exe)
- Known issues in NITRO-DWC 1.2 Release Version plus3/NITRO-DWC-DL 1.2 Release Version
NITRO-DWC-DL 1.2 RC (2006/07/03)
Note 6-01: Added Nintendo Authentication Server verification process functions
Note 6-02: Added functions to check the connection to an access point
Note 6-03: Made changes to the game name/secret key/product ID for each sample demo
Note 6-04: Fixed a bug related to the initialization of the Wi-Fi connection configuration
Note 6-05: Revised the Function Reference
Known issues in NITRO-DWC-DL Version 1.2 RC
NITRO-DWC 1.2 Release version (2006/06/22)
Note 5-01: Changed the conditions under which the DWCBuddyFriendCallback function is called when a friend relationship is established
Note 5-02: Made revisions to the access point authentication process when making an automatic connection to the Internet
Note 5-03: Made revisions to the Programming Manual
Note 5-04: Revised the Function Reference
Note 5-05: Changed the sample demo rank_sample
Note 5-06: Made changes with consideration to when user-defined data is not used in general-purpose ranking.
Note 5-07: Fixed a bug when there is an error on the download server in the download library
Known issues in Version 1.2 release version
NITRO-DWC 1.2 RC2 (2006/06/08)
Note 4-01: Made changes to the internal operations of the service locator information acquisition process
Known issues in Version 1.2 RC2
NITRO-DWC 1.2 RC (2006/06/06)
Note 3-01: Added a general-purpose ranking library
Note 3-02: Added a download library
Note 3-03: Added and changed the error information that can be obtained with the DWC_GetLastError and DWC_GetLastErrorEx functions
Note 3-04: Fixed a bug that occurred when the SSID of connection destinations 1-3 were set as "FREESPOT" with the configuration utility
Note 3-05: Fixed a bug that occurred when the nickname included in the DS console owner information was 10 characters long
Note 3-06: Fixed a bug where matchmaking would not end if it was started after disconnecting in the middle of a game
Note 3-07: Fixed a bug where the reception timeout callback was not being called
Note 3-08: Fixed a bug where it was not possible to connect to some hotspots
Note 3-09: Expanded the screen name that could be checked on the Authentication Server to a length of 25 characters
Note 3-10: Fixed a bug in the arguments for the DWCFriendStatusCallback and DWCBuddyFriendCallback functions
Note 3-11: Made additions and revisions to the Programming Manual
Note 3-12: Made additions and revisions to the Function Reference
Note 3-13: Made additions and revisions to the sample demo
Note 3-14: Deleted the add-ins directory
Known issues in Version 1.2 RC
NITRO-DWC 1.1 Release version (2006/03/10)
Note 2-01: Added the DWC_StopScMatchingAsync function
Note 2-02: Added the DWC_CancelGHTTPRequest function
Note 2-03: Added the DWC_GetApInfo function
Note 2-04: Added the DWC_GetDateTime function
Note 2-05: Added the DWC_SetConnectApType function (for debugging)
Note 2-06: Added the DWC_DebugConnectInetAsync function (for debugging)
Note 2-07: Added the dwc_connect_inet_sample demo
Note 2-08: Revised the DWC_SetSendSplitMax function
Note 2-09: Changed the Wi-Fi Connection Configuration message
Note 2-10: Upgraded the version of the child program for moving Wi-Fi user information included in Wi-Fi Connection settings
Note 2-11: Fixed a bug in the Wi-Fi Connection configuration
Note 2-12: Fixed a bug in the automatic Internet connection process (1)
Note 2-13: Fixed a bug in the automatic Internet connection process (2)
Note 2-14: Fixed a bug in the DWC_GetInetStatus function
Note 2-15: Fixed a bug in the DWC_ProcessInet function
Note 2-16: Fixed a bug in the DWC_CleanupInet function
Note 2-17: Revised the DWC_CreateUserData function
Note 2-18: Corrected sample demos
Note 2-19: Removed the document "User Information Management/Friend Connection Overview"
Note 2-20: Reviewed the function reference and the NITRO-DWC Programming Manual document.
Known Issues in 1.1 Release Version
NITRO-DWC 1.0 Release Version (2006/01/30)
Note 1-01: Added the DWC_SetFriendStatusCallback function
Note 1-02: Revised the conditions under which the DWC_IsSendableReliable function returns FALSE
Note 1-03: Added a check for the maximum number of people connected
Note 1-04: Added a check for the maximum length of the friends list
Note 1-05: Revised the error handling in the debug configuration functions for sending and receiving data
Note 1-06: Added return values for failures in the GHTTP library functions
Note 1-07: Changed the return values of several functions from void to BOOL
Note 1-08: Added functions for encoding and decoding Base64
Note 1-09: Fixed a bug where the child DS was freezing up due to the parent DS becoming disconnected from the network
Note 1-10: Fixed a bug in the DWC_CheckFriendKey function
Note 1-11: Added a function for loading one's own data from a data storage server
Note 1-12: Fixed a bug that prevented the prohibition of connecting to a friend of a friend in peer matchmaking with specified friends
Note 1-13: Fixed a bug that was causing a Fatal Error 71002
Note 1-14: Unified the sample source comments with the reference glossary
Note 1-15: Revised the demos for dwc_frienddata_sample and dwc_friend_match_sample
Note 1-16: Changed the receive buffer size for the dwc_sample demo
Known Issues in 1.0 Release Version
- Revision history prior to the release

NITRO-DWC[-DL] 2.1 Official Version

(2007/05/18)


Note 13-01: Changed the maximum size of the user-defined data that can be used with general ranking

Changed the maximum size of the user-defined data that can be used with general ranking from 768 bytes to 764 bytes.


Note 13-02: Added Korea to the region codes used with general ranking

Added Korea (DWC_RNK_REGION_KR) to the region codes used with general ranking.
Following this change, Korea has also been added to the region specification of the general-purpose ranking management tool.


Note 13-03: Corrected a problem that prevented freeing of the memory during communications errors (DNS errors)

When a DNS error occurred in the DWCi_QR2Startup function of an internal function, the memory that was allocated within that function was not being freed. This problem has been fixed.


Note 13-04: Corrected a problem that caused a reference to a NULL pointer during communications errors

There was a problem with references to a NULL pointer when communications errors occurred at certain limited times during matchmaking. This problem has been fixed.


Note 13-05: Corrected a problem of the stack being used by HTTP communications (the GHTTP library)

A maximum of 8 KB was allocated from the stack by HTTP communications (the GHTTP library). This has been corrected such that the memory is now allocated from the heap.


Note 13-06: Made revisions to the Programming Manual

Revised the Nintendo Wi-Fi Connection NITRO-DWC Programming Manual - General-Purpose Ranking Edition located in $NITRODWC_ROOT/docs.
For details, see the revision history of that document.


Note 13-07: Revised the Function Reference

Made revisions to the following items. For details, see the revision history for each item.
Note: Some of the minor terminology revisions may not be reflected in the revision histories.


Known issues in NITRO-DWC[-DL] 2.1 Official Version

None.


NITRO-DWC[-DL] 2.1 RC

(2007/04/09)


Note 12-01: Added functions for checking invalid character strings

For online checking of invalid character strings, added the following functions:

For details, see the function reference and the added dwc_prof_sample sample demo.


Note 12-02: Changed the English message specifications for Nintendo Wi-Fi Connection Configuration

Removed the support telephone number that was displayed when "North America" was set for the region and "English" was set for the language under Nintendo Wi-Fi Connection settings.
With this change in specifications, there will no longer be any region-dependent difference in the displayed message.


Note 12-03: Reviewed the processing executed by the DWC_GetDateTime function when the real-time clock exceeded 2099/12/31 23:59:59

In the past, when the DWC_GetDateTime function was used for date and time retrieval from the authentication server, execution would fail if the real-time clock exceeded 2099/12/31, 23:59:59. We have corrected this problem.


Note 12-04: Made revisions to the Programming Manual

Revised the Nintendo Wi-Fi Connection NITRO-DWC Programming Manual - General-Purpose Ranking Edition located in $NITRODWC_ROOT/docs.
For details, see the revision history of that document.


Note 12-05: Made additions and revisions to the Function Reference

Made additions and revisions to the items listed below. For details, see the Revision History for each item.
Note: The revision histories may not reflect some of the minor changes, such as modifications in terminology.


Known issues in NITRO-DWC-DL Version 2.1 RC

None.


NITRO-DWC[-DL] 2.0 Official Version

(2007/03/12)


Note 11-01: Added a function for getting the authenticated user ID

To get the authenticated user ID stored in the DS, added the DWC_GetAuthenticatedUserId function.


Note 11-02: Added functions for back-and-forth conversions between friendship registration keys and strings.

Added the DWC_FriendKeyToString and DWC_StringToFriendKey functions for back-and-forth conversions between friendship registration keys and 12-digit decimal strings.


Note 11-03: Added NITRO-CHARACTER data file for each icon

To the $NITRODWC_ROOT/data/Wi-Fi_icons/ directory, added the NITRO-CHARACTER data for the "Wi-Fi Connection support icon" and the "Wi-Fi signal strength icon." Use these data for the icons included in the titles that support the Wi-Fi Connection.


Note 11-04: Revamped the socket closing process in the Download library.

Revamped the socket closing process in the Download library as follows: revised the code such that the callback that notifies the end of an asynchronous process is issued without waiting for the socket closing process to end.


Note 11-05: Corrected the problem that blocked the DWC_NdCleanupAsync function.

Corrected the following problem: the internal process inside the DWC_NdCleanupAsync function was sometimes blocked for several seconds.


Note 11-06: Fixed the problem of the private functions being used in the sample demos.

Fixed the problem with the private functions being used in the sample demos. Also made other minor revisions.


Note 11-07: Made revisions to the Programming Manual

Revised the Nintendo Wi-Fi Connection NITRO-DWC Programming Manual in $NITRODWC_ROOT/docs.
For details, see the revision history of that document.


Note 11-08: Made additions and revisions to the Function Reference

Made additions and revisions to the following items. For details, see the Revision History for each item.
Note: Some of the minor terminology revisions may not be reflected in the revision histories.


Known issues in NITRO-DWC[-DL] 2.0 Official Version

None.


- NITRO-DWC-DL 2.0 RC

(2007/02/02)


Note 10-01: Made changes to the CodeWarrior version used in the build of the AOSS/Easy Wireless Start Library

The version of CodeWarrior for the AOSS/Easy Wireless Start Library used in the Wi-Fi Connection configuration was changed to 2.0 SP1.
Therefore, all versions of CodeWarrior used in the build for the NITRO-DWC package were changed to 2.0 SP1.


Note 10-02: Corrected a bug-handling error in in the DWC_ProcessFriendsMatch function

Corrected a bug that caused the DWC_GetLastError[Ex] function to unintentionally set to DWC_ERROR_FATAL when continuing the internal processing after an error occurred while the DWC_ProcessFriendsMatch was in progress.


Note 10-03: Corrected problems with the conditions for establishing friend relationships.

Corrected a bug that caused friend relationships to be established, even between titles in which the DWC_CreateUserData function specified different initial codes.
Specifically, this bug was occurring when the titles had connected to a Wi-Fi connection at least once and the friend information exchanged in DS Wireless Networking was created or exchanged.


Note 10-04: Made revisions to the Programming Manual

Revised the Nintendo Wi-Fi Connection NITRO-DWC Programming Manual - General-Purpose Ranking Edition located in $NITRODWC_ROOT/docs.
For details, see the revision history of that document.


Note 10-05: Revised the Function Reference

Revisions were made to the following items. For details, see the revision history for each item.
Note: Some of the minor terminology revisions may not be reflected in the revision histories.


Known issues in NITRO-DWC-DL Version 2.0 RC

None.


- NITRO-DWC[-DL] 2.0 PR

(2007/01/05)


Note 9-01: Made changes to the CodeWarrior version used in the build of the NITRO-DWC package

Changed the version of CodeWarrior (with the exception of one section) used in the build for the NITRO-DWC package to 2.0 SP1.
See Known issues in NITRO-DWC [-DL] 2.0 PR for information about the section that was not changed.


Known issues in NITRO-DWC[-DL] 2.0 PR

The CodeWarrior version was not changed to 2.0 SP1 in the AOSS/Easy Wireless Start Library used in the Wi-Fi Connection configuration, so only this section does not support the NITRO-SDK 4.0 series.
This problem is planned be corrected with the next version.


NITRO-DWC[-DL] 1.3 RC

(2006/12/29)


Note 8-01: Added Korean language support to Wi-Fi Connection settings

Wi-Fi Connection Configuration now supports Korean language. DWC_LANGUAGE_HANGUL has been added to the languages that can be specified to the DWC_StartUtility and DWC_StartUtilityEx functions.


Note 8-02: Added a function for testing the connection to the Internet

The following function for testing the Internet connection by communicating with a connection test server has been added.


Note 8-03: Added a feature for performing HTTP communications (GHTTP Library)

Added the following functions for HTTP communications (GHTTP library).


Note 8-04: Changed the DWC_NdCleanupAsync function specification

The return value has been changed from void to BOOL, and now returns whether the download library shutdown process has started successfully. The sample demo dwc_nd_sample has also been changed to match this.


Note 8-05: Changed the specifications of the memory deallocation function specified in the DWC_SetMemFunc function

Although specifications have allowed NULL to be passed in the argument ptr representing the memory deallocation function specified to the DWC_SetMemFunc function, this has been absorbed by the library and no longer passes NULL in the argument ptr representing the memory deallocation function specified by the application.


Note 8-06: Changed the server URL used by the general ranking library

The server URL used by the general-purpose ranking library has changed along with the new GameSpy server.


Note 8-07: Changed the general ranking management tool (DWCRankingAdmin.exe)

All PIDs can now be deleted for the development server.
The URL of the GameSpy server has also changed.


Note 8-08: Support for parts where there is no timeout during communications with the GameSpy server during matchmaking

A timeout has been added in order to handle cases where there is no response from the server because there was some code for which a timeout did not exist regarding communication with the GameSpy server during matchmaking.


Note 8-09: Fixed an issue with the error code generated during wireless link disconnection

An issue was found where an error code "0" was returned at disconnection of wireless link, and has been corrected.


Note 8-10: Corrected a problem related to the default settings of the Nintendo authentication server to be used

A problem was corrected where the authentication server for products was being used by default before DWC_InitInet or DWC_InitInetEx function was called.


Note 8-11: Corrected a problem related to communication errors of the DWC_NASLoginProcess function.

A problem has been corrected where the state obtained from the DWC_NASLoginProcess function would not change from DWC_NASLOGIN_STATE_IDLE and processing would not just end if a communication error occurred at a particular time after the authentication process was started by the DWC_NASLoginAsync function. Note that the state DWC_NASLOGIN_STATE_IDLE has been eliminated along with this revision.


Note 8-12: Corrected a problem where execution would sometimes stop during matchmaking for more than one person.

A problem was corrected where execution would occasionally freeze during matchmaking involving a lot of people. Although this problem was likely to occur when matchmaking for four or more people, it would almost never occur when matchmaking for four people, but would increase in likelihood as the number of people would increase.


Note 8-13: Corrected a problem related to freeing memory for the DWC_ShutdownFriendsMatch function

A problem was corrected where memory that should be freed by the DWC_ShutdownFriendsMatch function was not being freed when a communication error had occurred as a result of exceedingly poor signal quality after connecting to Wi-Fi Connection using DWC_LoginAsync.


Note 8-14: Corrected a problem with the isChanged argument of the DWCUpdateServersCallback function.

A problem was corrected where the argument isChanged of the DWCUpdateServersCallback callback function was always TRUE when the data type for friend information was DWC_FRIENDDATA_LOGIN_ID regardless of whether the friend roster had been updated.


Note 8-15: Corrected a problem related to communication errors of the DWC_LoginToStorageServerAsync function.

A problem was corrected where execution would stop when a communication error occurred during processing of the DWC_LoginToStorageServerAsync function.


Note 8-16: Corrected a problem related to freeing memory for HTTP communications and general-purpose ranking.

This problem is caused by the HTTP communication (GHTTP) library. The problem was that a completion callback was not being invoked and memory was not being released when the DWC_CancelGHTTPRequest function was called. This was due to the fact that memory allocated when a request is issued (by DWC_GetGHTTPData, DWC_GetGHTTPDataEx, or DWC_PostGHTTPData) is released when a completion callback executes. This occurs even when the DWC_ShutdownGHTTP function is called without waiting for the completion callback. The above problem has been corrected so that operations are carried out correctly when canceling or releasing the library.

Finally, another problem with the DWC_GetGHTTPDataEx function has been corrected where the receive buffer was not released under the following conditions.

Note: The general-purpose ranking library had the same problem because it used the GHTTP library internally.


Note 8-17: Corrected a problem related to freeing memory for the DWC_NdCleanupAsync function.

A problem was corrected where the DWC_NdCleanupAsync function could not be called (an assert would occur if called) if an error occurred during asynchronous processing of the DWC_NdInitAsync function, regardless of whether the library had already allocated memory.
A note has been added to the function reference in question regarding releasing the library.


Note 8-18: Corrected an issue with the download library socket close operation.

The socket close operation was accessing an already deallocated memory area, and has been corrected.


Note 8-19: Corrected an issue with the download library cancellation operation.

The socket was not being closed when a cancel was called between server connection completion and data transmission in the download library. This issue was corrected.


Note 8-20: Fixed a sound problem in the Wi-Fi Connection setting.

Corrected an issue with the Wi-Fi Connection setting where closing the DS unit during AOSS setting generated an abnormal sound from headphones.


Note 8-21: Corrected a problem when moving Wi-Fi user information using Wi-Fi Connection settings.

Although DS download play can be used when moving Wi-Fi user information using Wi-Fi Connection Configuration, a problem has been corrected when a child would disconnect upon downloading data and attempt to restart where the parent device would sometimes have to continue waiting because it could not detect this state.


Note 8-22: Removed problematic definitions

An issue has been corrected where including dwc.h will define generic names such as print/vprintf/SCREEN_WIDTH/SCREEN_HEIGHT.


Note 8-23: Standardized the character code used in all comments to SJIS.

Parts of source code that were using character codes other than SJIS have been revised to use SJIS.


Note 8-24: Revised the sample demo

Parts of code that used OS_Free to release the receive buffer for ghttp_sample has been revised to use DWC_Free(). Processing performed when an error occurs with dwc_nd_sample has been revised. In addition, a description regarding temporary operations of the Download Server has been deleted from readme.txt. A problem with handling user-defined data regarding rank_sample has been corrected.


Note 8-25: Made revisions to the Programming Manual

We made revisions to each programming manual included in $NITRODWC_ROOT/docs.
For details, see the revision history of each document in question.


Note 8-26: Revised the Function Reference

Revisions were made to the items listed below: For details, see the Revision History for each item.
Note: Some of the minor terminology revisions may not be reflected in the revision histories.

Known issues in NITRO-DWC-DL Version 1.3 RC

None.


NITRO-DWC 1.2 Release Version plus3/NITRO-DWC-DL 1.2 Release Version

(2006/08/02)


Note 7-01: Improved security for the Download functionality

Up until now, the security level was lowered in order to connect to the temporary download server. However, the actual working server is up now, so security has been improved.


Note 7-02: Set the new error code 540XX

We added the error code 540XX (the final two digits indicate the type of access point connected to) when disconnecting from an access point.


Note 7-03: Fixed a bug in the DWC_UpdateConnection function

We fixed a bug that was causing problems in the error code set when using the DWC_UpdateConnection function to detect a disconnection from an access point.


Note 7-04: Fixed a bug in the DWC_LoginToStorageServerAsync function

A problem was corrected where a callback was not generated when an error occurred with the DWC_LoginToStorageServerAsync function.


Note 7-05: Revised the sample demo


Note 7-06: Made revisions to the Programming Manual

Revisions were made to the following documents contained in $NITRODWC_ROOT/docs: For details, see the revision history in the respective documents:
"Nintendo Wi-Fi Connection NITRO-DWC Programming Manual"
"Nintendo Wi-Fi Connection NITRO-DWC Programming Manual -Download Edition-"
Nintendo Wi-Fi Connection NITRO-DWC Programming Manual - General-Purpose Ranking Edition-"


Note 7-07: Revised function reference

We made revisions to the items below. For details, see the revision history for each item.
Note: Some of the minor terminology revisions may not be reflected in the revision histories.

Note 7-08: Fixed a bug in the general-purpose ranking management tool (DWCRankingAdmin.exe)

We fixed a bug where user-defined data could not be obtained normally.
Version 1.00 --> Version 1.01


- Known issues in NITRO-DWC 1.2 Release Version plus3/NITRO-DWC-DL 1.2 Release Version

None.


NITRO-DWC-DL Version 1.2 RC

(2006/07/03)


Note 6-01: Added a verification process function for Nintendo Authentication Server

We added the function DWC_NASLogin*, which performs the verification process for Nintendo Authentication. Up until now, this process had been performed inside the DWC_LoginAsync function, but when FriendsMatch Library features such as friend management and matchmaking are not in use, this function performs the authentication process instead.
We have added the dwc_naslogin_sample sample demo in accordance with these changes.
Note: Since the FriendsMatch Library is not included in NITRO-DWC-DL, the authentication process must be performed with this function.


NOTE 6-02: Added functions to check the connection to an access point

We added a function to check that a connection to an access point is being maintained normally. Up until now, this process had been performed inside the DWC_ProcessFriendsMatch function, but when FriendsMatch Library features such as friend management and matchmaking are not in use, this function performs the connection check instead.
Note: Since the FriendsMatch Library is not included in NITRO-DWC-DL, the connection check must be performed with this function.


NOTE 6-03: Made changes to the game name/secret key/product ID for each sample demo

Up until now, the game name "gmtest" has been used in the sample demo. However, since developers who had been generally using GameSpy were using it as a shared name, it was possible that using this name could give a glimpse into the information about games in development and that data on a back-end server could be unexpectedly altered. Because of this issue, we have changed the name exclusively for the NITRO-DWC sample demo to "dwctest".


Note 6-04: Fixed a bug related to the initialization of the Wi-Fi connection configuration

Since the functions GX_SetBGScrOffset and GX_SetBGCharOffset were not being called explicitly when initializing a Wi-Fi connection configuration, there was a bug where the screen display was becoming corrupted when changes were made to offsets with these functions. This bug has been fixed.


Note 6-05: Revised function reference

We made revisions to the items below. For details, see the revision history for each item.

Known issues in NITRO-DWC-DL Version 1.2 RC

None.


NITRO-DWC Version 1.2 Release

(2006/06/22)


Note 5-01: Made changes to the call conditions for the DWCBuddyFriendCallback function called when a friend relationship is established.

The DWCBuddyFriendCallback function, which is called when a friend relationship is established, will now be called when the network communication used to establish the friend relationship is successful. This network communication used to establish the friend relationship may be performed twice, depending on the timing. Should that happen, the callback will have occurred each time.
We have made changes so that the the callback is not called when a friend relationship is already established.


Note 5-02: Revised the access point authentication process when making an automatic connection to the Internet.

We have revised the process for making an automatic connection to the Internet for access point authentication processes in order to improve connectivity to access points that accept only open system authentications.


Note 5-03: Made revisions to the Programming Manual

Revisions were made to the following documents contained in $NITRODWC_ROOT/docs: For details, see the Revision History for each document.
Nintendo Wi-Fi Connection NITRO-DWC Programming Manual
Nintendo Wi-Fi Connection NITRO-DWC Programming Manual - General-Purpose Ranking Version -


Note 5-04: Revised function reference

Revisions were made to the items listed below. For details, see the Revision History for each item.

Note 5-05: Made changes to the sample demo rank_sample

We added user-defined data to the CRC, and made changes to check for falsification.


Note 5-06: Made changes for when the user-defined data is not used in the general purpose ranking library.

We made changes for when user-defined data is not used in the general purpose ranking library. Users can now select NULL as the data argument and 0 for the size in the DWC_RnkPutScoreAsync function.


Note 5-07: Fixed the problems with the download server error in the download library.

We fixed the issue where the program will stop due to an insufficient receive buffer when the download server returns an error.
Along with this fix was an addition of error code 31030 for an insufficient receive buffer error. Also, the minimum buffer size passed to DWC_NdGetFileAsync was set to 128 bytes. A buffer of at least 128 bytes will need to be specified, even if the downloaded data is smaller than this size.


Known Issues in 1.2 Release Version

None.


NITRO-DWC Version 1.2 RC2

(2006/06/08)


Note 4-01: Made changes to the internal operations of the handler for obtaining service locator information

We made changes to the internal operations of the process for obtaining service locator information that the download feature uses.


Known issues in Version 1.2 RC2

None.


NITRO-DWC Version 1.2 RC

(2006/06/06)


Note 3-01 Added 'General-Purpose Ranking Constants'

Added general-purpose ranking constants.
For details, see the documentation in $NITRODWC_ROOT/docs.


Note 3-02: Added Download library

Added the library for downloading content from the Download server provided by Nintendo.
For details, see the documentation in $NITRODWC_ROOT/docs.


Note 3-03: Made additions and changes to the error information that can be obtained with the DWC_GetLastError function and the DWC_GetLastErrorEx function.

Made the following additions and changes to the error information that can be obtained with DWC_GetLastError and DWC_GetLastErrorEx:


Note 3-04: Fixed the problem that occurred when FREESPOT was set for the SSID of connection targets 1 to 3 in the Settings Utility

When FREESPOT was set for the SSID of connection targets 1 to 3 in the Settings Utility and a connection test was performed, the error that occurred had the error code is 5XX05, whereas it should have been some error code between 5XX00 and 5XX02. That problem has been fixed.


Note 3-05: Fixed the problem that occurred when the nickname in the DS owner information was 10 characters long

When the end user saved owner information to the DS and entered a nickname with 10 characters, an error code 20109 would be generated when connecting to Wi-Fi Connection. That problem has been corrected.
Note: This problem does not arise in NITRO-DWC 1.0 and later versions.
Note: This is a problem that gets corrected by the NITRO-DWC 1.1 PLUS patch.


Note 3-06: Fixed the problem that matchmaking would not end if started after disconnecting during a game.

When matchmaking was started after disconnecting during a game, sometimes that matchmaking process would not end. That problem has been fixed.
This problem occurred when the Reception state of Reliable transmission was to reset after peer-to-peer communications was disconnected.
Note: This is a problem that gets corrected by the NITRO-DWC 1.1 PLUS patch.


Note 3-07: Fixed problem of Reception timeout callback not being called

The Reception timeout callback specified by the DWC_SetUserRecvTimeoutCallback function was not being called. This problem was corrected.
Data sent using DWC_SendReliable* would accumulate in the Send buffer because there was no acknowledgment confirming reception by the receiver side. While the Send buffer remained full in this way, there would be no call to the Reception timeout callback.
Note: This is a problem that gets corrected by the NITRO-DWC 1.1 PLUS2 patch.


Note 3-08: Fixed the problem that prevented connection to some hotspots

When connecting at a hotspot, the required information would not be sent to the Authentication server. This problem has been fixed.
This problem made it impossible to connect at some hotspots.
Note: This problem does not arise in NITRO-DWC 1.0 and later versions.
Note: This is a problem that gets corrected by the NITRO-DWC 1.1 PLUS2 patch.


Note 3-09: Extended the screen name that the Authentication server can check to 25 characters

The screen name in the game that gets sent to the Authentication server using the DWC_LoginAsync function has been extended to 25 characters. Before the maximum length was 10 characters.
In accordance, changes and additions were made to the explanation for the ingamesn argument of the DWC_LoginAsync function in the Reference Manual.
Note: This change is made by the NITRO-DWC 1.1 PLUS2.


Note 3-10: Fixed problem with arguments of DWCFriendStatusCallback function and DWCBuddyFriendCallback function

The following three functions:

allow the following two functions to be set as callbacks: A problem occurred when the value -1 was unexpectedly entered for the 'index' argument of these callback functions. That has now been corrected.
The problem would occur in these two callback functions when a friendship was established with the friend registered last in the buddy list.
In the case of the DWCFriendStatusCallback function, when -1 was set for the value of the 'index' argument, the other arguments (status/statusString) would also be abnormal.
Note: This is a problem that gets corrected by the NITRO-DWC 1.1 PLUS3.


Note 3-11: Made additions and revisions to the Programming Manual

Revised the 'Nintendo Wi-Fi Connection NITRO-DWC Programming Manual' included in $NITRODWC_ROOT/docs.
Also made additions to the Programming Manual for the general-purpose ranking feature and the download feature.


Note 3-12: Made additions and revisions to the Function Reference

Additions and revisions were made to the items listed below. For details, see the Revision History for each item.
Note: Some of the minor terminology revisions may not be reflected in the revision histories.


Note 3-13: Made additions and revisions to the sample demos


Note 3-14: Deleted the 'add-ins' directory

Deleted the directory $NITRODWC_ROOT/add-ins from the package.


Known issues in Version 1.2 RC

None.


NITRO-DWC Version 1.1 Release

(2006/03/10)


Note 2-01: Added the DWC_StopScMatchingAsync function

Added DWC_StopScMatchingAsync as a function to cancel server-client matchmaking.


Note 2-02: Added the DWC_CancelGHTTPRequest function

Added DWC_CancelGHTTPRequest as a function to cancel HTTP communication.


Note 2-03: Added the DWC_GetApInfo function

Added DWC_GetApInfo as a function that gets data specific to the connected access point after completing an Internet connection. This function gets the connection candidate (targets 1 through 3, the Nintendo Wi-Fi USB Connector, etc.) to which the access point is connected and the access point's SSID and BSSID. In addition, location information can also be obtained for Wi-Fi Station connections.


Note 2-04: Added the DWC_GetDateTime function

Added the function DWC_GetDateTime for getting the current date and time in GMT based on the time information retrieved from the authentication server during authentication processing. This function can also be used to get the GMT date and time after authentication. Be aware that there may be discrepancies in minute/second units.


Note 2-05: Added the DWC_SetConnectApType function (for debugging)

The DWC_SetConnectApType function was added to explicitly set the target connection candidate (targets 1 through 3, the Nintendo Wi-Fi Station, etc.) before connecting to the Internet. The DWC_ConnectInetAsync function, which then runs, will only connect to the specified candidate. Use this function for debugging. This specification will be ignored in the FINALROM version.


Note 2-06: Added the DWC_DebugConnectInetAsync function (for debugging)

If this function is used instead of DWC_ConnectInetAsync when connecting to the Internet, you can explicitly specify the SSIP and WEP key for the access point. Use this function for debugging.


Note 2-07: Added the dwc_connect_inet_sample demo

This simple demo shows the process for connecting to the Internet. It also includes a demo for the new functions DWC_SetConnectApType and DWC_DebugConnectInetAsync.


Note 2-08: Revised the DWC_SetSendSplitMax function

If an attempt to set a value larger than that defined in DWC_TRANSPORT_SEND_MAX was made, the value was reset to DWC_TRANSPORT_SEND_MAX and TRUE was returned; this was changed to use assert processing.


Note 2-09: Changed the Wi-Fi Connection Configuration message

Several revisions were made to the displayed message when the test fails during Wi-Fi connection settings.


Note 2-10: Upgraded the version of the child program for moving Wi-Fi user information included in Wi-Fi connection settings

The Wi-Fi User Data Migration Device Program included in the Wi-Fi connection settings was updated with a NITRO-SDK 3.0 build version.


Note 2-11: Fixed a bug in the Wi-Fi Connection Configuration

Fixed an issue where the sound effect would loop while the B button was pressed when cancelling the AOSS settings in the Wi-Fi connection settings.


Note 2-12: Fixed a bug in the automatic Internet connection process (1)

Fixed an issue where the connection test failure would stop for the Nintendo Wi-Fi USB Connector in the Wi-Fi Connection Settings.
Note: The connection test used in the Wi-Fi connection settings is the same as the Internet auto-connect process used in games.


Note 2-13: Fixed a bug in the automatic Internet connection process (2)

Fixed an issue where a very long URL for hotspot authentication would result in a connection stop, while connecting to a hotspot for an Internet connection.


Note 2-14: Fixed a bug in the DWC_GetInetStatus function

Fixed an issue where a freeze would occur when the DWC_GetInetStatus function was called between the DWC_InitInet and DWC_ConnectInetAsync function calls.


Note 2-15: Fixed a bug in the DWC_ProcessInet function

Fixed an issue where a freeze would occur if DWC_ProcessInet was called when the auto-connect control object for an Internet connection was still uninitialized (DWC_InitInet had not been called).


Note 2-16: Fixed a bug in the DWC_CleanupInet function

Fixed an issue where a freeze would occur when the DWC_CleanupInet function was called between the DWC_InitInet and DWC_ConnectInetAsync function calls.


Note 2-17: Revised the DWC_CreateUserData function

Revised the random number generation method used when creating user data. Because the tick value was used as the random seed, if the OS_InitTick function is called with the same timing as the DWC_CreateUserData function, the same login ID can be created. To fix this, the base value for the random seed was changed to use the OS_GetLowEntropyData function.


Note 2-18: Corrected sample demos

Unused files and unnecessary notes were deleted.


Note 2-19: Removed the document "User Information Management/Friend Connection Overview"

The content of the User Data Management and Friend Connection Overview documentation was moved to the Programming Guidelines and NITRO-DWC Programming Manual. The original document was removed.


Note 2-20: Reviewed the function reference and the "NITRO-DWC Programming Manual" document.

Supplemental descriptions were added to the NITRO-DWC Programming Manual and Function Reference.


Known Issues in 1.1 Release Version

None.


NITRO-DWC Version 1.0 Release

(2006/01/30)


Note 1-01: Added the DWC_SetFriendStatusCallback function

DWC_SetFriendStatusCallback was added to configure the callback functions that are called when a friend's communication state changes.
The above callback functions are usually set as the arguments of the friend list synchronous process function DWC_UpdateServersAsync. But, even when no friend list synchronous process is needed and there is a need to know the friend's communication state in real time, use this function to configure the callback functions.


Note 1-02: Revised the conditions under which the DWC_IsSendableReliable function returns FALSE

There was a bug where TRUE was returned when the DWC_IsSendableReliable function was called but FALSE was returned when the DWC_SendReliable* function was called during the generation of an error.
This bug has been fixed so that the DWC_IsSendableReliable function will return FALSE in this kind of situation.


Note 1-03: Added a check for the maximum number of people connected

The maximum number of people that can connect with matchmaking in the DWC Library is 32, so an ASSERT was added that checks whether the arguments of the DWC_ConnectToAnybodyAsync, DWC_ConnectToFriendsAsync, and DWC_SetupGameServer functions exceed this number.


Note 1-04: Added a check for the maximum length of the friends list

The maximum number of friends that the DWC Library can handle is 64, so an ASSERT was added that checks whether the friend list length arguments of the DWC_InitFriendsMatch and DWC_ConnectToFriendsAsync functions exceed this number.


Note 1-05: Revised the error handling in the debug configuration functions for sending and receiving data

No DWC error was set when a memory allocation error occurred inside the DWC_SetSendDelay, DWC_SetRecvDelay, DWC_SetSendDrop, and DWC_SetRecvDrop functions.
This is revised so the DWC_ECODE_TYPE_ALLOC FATAL ERROR is properly set.


Note 1-06: Added return values for failures in the GHTTP library functions

Added return values for failures to the GHTTP library functions below:


Note 1-07: Changed the return values of several functions from void to BOOL

Previously, none of the above functions had return values. They now return FALSE if they fail.
The primary reason for their failure is due to calling inactive functions in the FriendsMatch library. So, if these functions are used after the DWC_InitFriendsMatch function is called, they will not return FALSE.
However, in the DWC_SetSendDrop, DWC_SetRecvDrop, DWC_SetSendDelay, DWC_SetRecvDelay, and DWC_Ping functions, failures to allocate memory and designations of invalid AIDs will cause the functions to fail.


Note 1-08: Added functions for encoding and decoding Base64

The function DWC_Base64Encode (used to encode Base 64) and the function DWC_Base64Decode (used to decode Base 64) were added.
Previously, when status data was configured with the DWC_SetOwnStatusData function, the character string for the statusString argument of the friend state change notification callback DWCFriendStatusCallback could not be used. However, if the DWC_Base64Decode function is used, the statusString character string (a Base 64 character string) will be decoded and can be referenced.


Note 1-09: Fixed a bug where the child DS was freezing up due to the parent DS becoming disconnected from the network

During matchmaking, a temporary parent-child relationship is formed between connected DS devices.
There was a bug where, if the network fails due to a reason such as the power being cut off on the parent DS, any connected child DS devices would freeze up (but matchmaking could be cancelled).
This bug has been fixed so, that should this sort of situation occur and a child DS cannot communicate with its parent for a fixed amount of time, it will re-attempt matchmaking.


Note 1-10: Fixed a bug in the DWC_CheckFriendKey function

The DWC_CheckFriendKey function was being used to check the validity of friend registration keys on the CRC. However, there was a bug that was generating parameter errors during the friend list synchronous process. This occurred even though this function returned TRUE when the GS profile ID included in the friend registration key was negative and a correct friend registration key was input into the CRC.
This has been fixed so that a FALSE will return for friend registration keys whose GS profile ID is negative.


Note 1-11: Added a function for loading one's own data from a data storage server

The DWC_LoadOwnDataAsync function, which loaded your data from a data storage server, was unable to load anything except Private data.
Therefore, the following functions have been added: the DWC_LoadOwnPublicDataAsync function, which loads Public data, and the DWC_LoadOwnPrivateDataAsync function, which loads Private data.


Note 1-12: Fixed a bug that prevented the prohibition of connecting to a friend of a friend in peer matchmaking with specified friends

There was a bug where, even though a FALSE was specified in the distantFriend argument of the DWC_ConnectToFriendsAsync function, a connection would be made with friends outside of what was specified in the friendIdxList argument.
This bug was fixed so that if a FALSE is specified for distantFriend, there will only be connections made with those friends specified in friendIdxList (or all friends if friendIdxList=NULL).


Note 1-13: Fixed a bug that was causing a Fatal Error 71002

A bug existed where, after the networking state became unstable and a DWC error was generated, the internal process would continue and fatal error code 71002 would be generated.
This was fixed so that the fatal error does not occur.


Note 1-14: Unified the sample source comments with the reference glossary

Changes were made so that the sample source comments and the terminology used in the reference are consistent.
Specifically, "matching", which was forbidden from being used in the glossary, was changed to "matchmaking".


Note 1-15: Revised the demos for dwc_frienddata_sample and dwc_friend_match_sample

The following revisions were made to the $NITRODWC_ROOT/build/demos/dwc_frienddata_sample and $NITRODWC_ROOT/build/demos/dwc_friend_match_sample demos.


Note 1-16: Changed the receive buffer size for the dwc_sample sample demo

The following revision was made to the $NITRODWC_ROOT/build/demos/dwc_sample demo:


Known Issues in 1.0 Release Version

None.


Software Development Support Group


CONFIDENTIAL