NITRO-DWC[-DL] Library Revision History


NITRO-DWC[-DL] 3.1 plus (2008/07/08)
Note 20-01: Fixed a bug in the DWC_CleanupInet[Async] functions that prevented processing from ending under specific conditions.
Note 20-02: Fixed a bug in the DWC_DebugConnectInetAsync function that always caused a data access exception to occur.
Note 20-03: Fixed a bug that would on rare occasions cause a stack buffer overflow when matchmaking was cancelled.
Note 20-04: Fixed a bug that sometimes caused matchmaking to succeed with deleted friends.
Note 20-05: Fixed a typo in the name of a definition used by HTTP communications (DWC_GHTTP).
Note 20-06: Made it more convenient to embed the NITRO-Crypto library.
Note 20-07: Revised the Function Reference.
Known issues in NITRO-DWC[-DL] 3.1 plus
NITRO-DWC[-DL] 3.1 Release (2008/06/11)
Note 19-01: Automatic connections to the Internet now support the Nintendo Spot option (for use in Japan only).
Note 19-02: Fixed a bug related to memory allocation during automatic connection to the Internet.
Note 19-03: Fixed a bug in the error code for fatal errors occurring during automatic connection to the Internet.
Note 19-04: Fixed a bug where a data access exception would occur when using the DWC_TestInetAsync function.
Note 19-05: Fixed a bug where a data access exception would occur when the DWC_LoginAsync function failed and a retry was then attempted.
Note 19-06: Changed specifications related to the way the DWC_GetMatchStringValue function handles empty strings.
Note 19-07: Fixed a bug where the player evaluation callback was sometimes not called during peer matchmaking with friend specified.
Note 19-08: Fixed a bug where part of initialization was not performed when using the DWC_Init function.
Note 19-09: Revised the Programming Manual.
Note 19-10: Revised the Function Reference.
Known issues in NITRO-DWC[-DL] 3.1 Official Version
NITRO-DWC[-DL] 3.0 plus (2008/03/05)
Note 18-01: Fixed problem of scanf being replaced by printf when dwc.h is included
Note 18-02: Fixed problem of received data being different from sent data starting with 0xfefe transmitted via unreliable transfer
Note 18-03: Fixed problem of process continuing without notification even if transmission via reliable transfer failed
Note 18-04: Corrected a problem with the timeout process during matchmaking
Note 18-05: Added functions to deal with legacy friendship registration keys from old specification.
Note 18-06: Corrected a problem related to chunked transfer coding by the HTTP protocol stack
Note 18-07: Made revisions to the Programming Manual
Note 18-08: Revised Function Reference
Known issues in NITRO-DWC[-DL] 3.0 plus
NITRO-DWC[-DL] 3.0 Release (2008/01/11)
Note 17-01: Revised Function Reference
Known issues in NITRO-DWC[-DL] Version 3.0
NITRO-DWC[-DL] 3.0 RC (2008/01/08)
Note 16-01: Changed specifications related to the creation of friend codes
Note 16-02: Implemented a measure for one-sided friends, which result from cancellation of friend relationship
Note 16-03: Support for Nitro SDK 4.2
Note 16-04: Changed URL in the message inside Nintendo Wi-Fi Connection Settings
Note 16-05: Implemented a timeout for ranking
Note 16-06: Support for GameSpy SDK 2.05.00
Note 16-07: Changed specifications for handling the buffer set by the DWC_SetRecvBuffer function
Note 16-08: Eliminated a bug in the Nintendo Wi-Fi Connection Settings
Note 16-09: Eliminated a bug in server-client type matchmaking
Note 16-10: Eliminated a bug that caused the storage server to freeze when the line was cut
Note 16-11: In the sample demos, changed old-specification functions to new functions
Note 16-12: Reduced program size
Note 16-13: To the Illegal String Check library, added a function for specifying a forced check in all regions
Note 16-14: Changed specifications for the DWC_RnkResGetTotal function
Note 16-15: Changed specifications and eliminated a bug related to the performance of unreliable transfer during reliable transfer
Note 16-16: Eliminated a bug that occurred during the process of obtaining the file list using the Download library
Note 16-17: Eliminated a bug with P2P connections in an environment that does not allow NAT transversing
Note 16-18: Revised Programming Manual
Note 16-19: Changed specifications related to the timing of transfer of the requests to build friend relationships
Note 16-20: Revised Function Reference
Known issues in NITRO-DWC[-DL] Version 3.0 RC
NITRO-DWC[-DL] 2.2 Release (2007/08/24)
Note 15-01: Fixed a bug in the DWC_Realloc[Ex] function
Note 15-02: Corrected problems related to communication errors during matchmaking.
Note 15-03: Fixed a bug when invalid data is obtained using the general-purpose ranking management tool.
Note 15-04: Changed the size of dynamically allocated memory in the Illegal String Check library.
Note 15-05: Revised the Function Reference.
Known issues in NITRO-DWC[-DL] 2.2 Official Version
NITRO-DWC[-DL] 2.2 RC (2007/07/24)
Note 14-01: Changed constants in the general-purpose ranking library.
Note 14-02: Added acquisition modes to the general-purpose ranking library.
Note 14-03: Made the general-purpose ranking management tool support proxy servers.
Note 14-04: Corrected a problem with the previous/next display button in the general-purpose ranking management tool.
Note 14-05: Fixed a memory-corruption bug in the Illegal String Check library.
Note 14-06: Corrected a problem with freeing memory in the DWC_CancelMatching function.
Note 14-07: Corrected problems related to communication errors in the DWC_LoginToStorageServerAsync function.
Note 14-08: Corrected a bug that occurred when calling the friend relationship establishment callback function.
Note 14-09: Corrected a bug in determining private IP addresses related to peer-to-peer connections.
Note 14-10: Made revisions to the Programming Manual.
Note 14-11: Revised the Function Reference.
Known issues in NITRO-DWC[-DL] Version 2.2 RC
NITRO-DWC[-DL] 2.1 Release (2007/05/18)
Note 13-01: Changed the maximum size of the user-defined data that can be used with general-purpose ranking.
Note 13-02: Added Korea to the region codes used with general-purpose 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 a function for checking invalid character strings.
Note 12-02: Changed the specifications for the English message for Wi-Fi Connection Configuration.
Note 12-03: Reviewed processing executed by the DWC_GetDateTime function when the real-time clock exceeds 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 Release (2007/03/12)
Note 11-01: Added a function to get the authenticated user ID.
Note 11-02: Added functions for converting back and forth 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 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 version of CodeWarrior used in the build of the AOSS/Easy Wireless Start Library
Note 10-02: Corrected a bug with error handling for the DWC_ProcessFriendsMatch function.
Note 10-03: Corrected bugs with the conditions for establishment of 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 version of CodeWarrior 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 the Wi-Fi Connection Configuration.
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 specifications of the DWC_NdCleanupAsync function.
Note 8-05: Changed the specifications of the memory deallocation function specified by the DWC_SetMemFunc function.
Note 8-06: Changed the server URL used by the general-purpose ranking library.
Note 8-07: Changed the general ranking management tool (DWCRankingAdmin.exe).
Note 8-08: Dealt with parts where there is no timeout during communications with the GameSpy server during matchmaking.
Note 8-09: Fixed an issue with the error code of errors 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 problems related to communication errors of the DWC_NASLoginProcess function.
Note 8-12: Corrected a problem where execution would sometimes stop during matchmaking for a great number of people.
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 problems related to communication errors in 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 cancel operation.
Note 8-20: Fixed the sound problem in the Wi-Fi Connection Configuration.
Note 8-21: Corrected a problem when moving Wi-Fi user information using Wi-Fi Connection Configuration.
Note 8-22: Removed the 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
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 roster
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 that caused the child DS to freeze when the parent DS was 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] 3.1 plus

(2008/07/08)


Note 20-01: Fixed a bug in the DWC_CleanupInet[Async] functions that prevented processing from ending under specific conditions.

Fixed a bug that prevented processing from ending when the DWC_CleanupInet[Async] function was called after failing to automatically connect to the Internet in environments without a Nintendo Spot (for use in Japan only). This bug first occurred in the official release of NITRO-DWC[-DL] 3.1.


Note 20-02: Fixed a bug in the DWC_DebugConnectInetAsync function that always caused a data access exception to occur.

Fixed a bug in the DWC_DebugConnectInetAsync function that always caused a data access exception to occur. This bug first occurred in the official release of NITRO-DWC[-DL] 3.1.


Note 20-03: Fixed a bug that would on rare occasions cause a stack buffer overflow when matchmaking was cancelled.

Fixed a bug that would on rare occasions cause a stack buffer overflow when matchmaking was cancelled. Added a buffer overflow check and an update check for the internal management data that could cause overflows to occur.


Note 20-04: Fixed a bug that sometimes caused matchmaking to succeed with deleted friends.

Fixed a bug that sometimes caused matchmaking to succeed with a friend who was removed from the Friend Roster if that friend was removed while connected to Nintendo Wi-Fi Connection and matchmaking was performed during the same connection session.


Note 20-05: Fixed a typo in the name of a definition.

Fixed a typo in the name of the following definition, which is used by HTTP communications (DWC_GHTTP).


Note 20-06: Made it more convenient to embed the NITRO-Crypto library.

Revised the NITRO-DWC build tree so that in order to use NITRO-Crypto from NITRO-DWC, you simply have to build the source instead of running make attach to embed NITRO-Crypto in the NITRO-SDK.


Note 20-07: 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] 3.1 plus

None.


NITRO-DWC[-DL] 3.1 Official Version

(2008/06/11)


Note 19-01: Automatic connections to the Internet now support the Nintendo Spot option (for use in Japan only).

Automatic connections to the Internet now support the Nintendo Spot option (for use in Japan only). As of this version's release, Nintendo Spot does not support connections via Nintendo Wi-Fi Connection.


Note 19-02: Fixed a bug related to memory allocation during automatic connection to the Internet.

Fixed a bug which would sometimes allocate an unexpected amount of memory during automatic connection to the Internet.


Note 19-03: Fixed a bug in the error code for fatal errors occurring during automatic connection to the Internet.

Fixed a bug where an unexpected error code was set for fatal errors occurring during automatic connection to the Internet.


Note 19-04: Fixed a bug where a data access exception would occur when using the DWC_TestInetAsync function.

Formerly, if the DWC_TestInetAsync function was called at any time outside of the period between connection to the Internet using the DWC_ConnectInetAsync function and disconnection using a DWC_CleanupInet* function, a data access exception would occur. This bug has been fixed by modifying DWC_TestInetAsync so that it now returns FALSE during periods where calling it is prohibited.


Note 19-05: Fixed a bug where a data access exception would occur when the DWC_LoginAsync function failed and a retry was then attempted.

Fixed a bug which formerly caused a data access exception to occur when processing of the DWC_LoginAsync function resulted in an error because of a failure to resolve the GameSpy server name and a retry was later attempted.


Note 19-06: Changed specifications related to the way the DWC_GetMatchStringValue function handles empty strings.

The DWC_GetMatchStringValue function now returns the default string even when the string corresponding to the key is an empty string.


Note 19-07: Fixed a bug where the player evaluation callback was sometimes not called during peer matchmaking with friend specified.

Fixed a bug where the player evaluation callback was sometimes not called during peer matchmaking with friend specified, depending on the exact timing of the call.


Note 19-08: Fixed a bug where part of initialization was not performed when using the DWC_Init function.

Fixed a bug where, if the DWC_Init function returned anything other than DWC_INIT_RESULT_NOERROR, part of initialization was not performed, and a data access exception would occur later when the DWC_InitFriendsMatch function was called.


Note 19-09: Revised the Programming Manual.

Revised the following programming manuals in $NITRODWC_ROOT/docs.

For details, see the revision history of that document.


Note 19-10: 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] 3.1 Official Version

None.


NITRO-DWC[-DL] 3.0 plus

(2008/03/05)


Note 18-01: Fixed problem of scanf being replaced by printf when dwc.h is included

Resolved the problem where the sprintf standard functions would be replaced by OS_SPrintf when dwc.h is included. This problem was due to the revision in NITRO-DWC 3.0.


Note 18-02: Fixed problem of received data being different from sent data starting with 0xfefe transmitted via unreliable transfer

When unreliable transfer was used to send data and the data started with 0xfefe, the data received at the other end would have 0xfefe appended a second time at the start, with the result that the last 2 bytes would be lost. That problem has been corrected.


Note 18-03: Fixed problem of process continuing without notification even if transmission via reliable transfer failed

The application was not informed when reliable transfer failed due to a poor environment for wireless communications. The problem has been fixed.
If repeated attempts to resend the data continue to fail, the error 97630 is now generated.


Note 18-04: Corrected a problem with the timeout process during matchmaking

Because of a problem with the timeout process during matchmaking, in rare instances the error 85010 would be generated even when the communications process was proceeding correctly. That problem has been fixed.


Note 18-05: Added functions to deal with legacy friend registration keys from old specification.

From NITRO-DWC 3.0 a new method is being used for calculating the check value contained in friend registration keys. Because of this change, the friend registration keys are not compatible with those created by older versions of the library. New functions have been added that allow the use of these legacy friend registration keys if the need arises.
The functions that have have added are the DWC_CreateFriendKeyLegacy function and the DWC_CheckFriendKeyLegacy function.


Note 18-06: Corrected a problem related to chunked transfer coding by the HTTP protocol stack

There was a problem with reception failures related to chunked transfer coding by the HTTP protocol stack used inside the Download library (which differs from the HTTP Communications library). That has been fixed.


Note 18-07: Made revisions to the Programming Manual

Made revisions to the following programming manuals in $NITRODWC_ROOT/docs.

For details, see the revision history of that document.


Note 18-08: Revised 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] 3.0 plus

None.


NITRO-DWC[-DL] 3.0

(2008/01/11)


Note 17-01: Revised Function Reference

Made revisions and additions 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 3.00

None.


NITRO-DWC[-DL] 3.0 RC

(2008/01/08)


Note 16-01: Changed specifications related to the creation of friend codes

Changed the algorithm for creating friend codes.
As a result of this change, the system is no longer compatible with the friend codes created using NITRO-DWC 2.2 and earlier versions.


Note 16-02: Implemented a measure for one-sided friends, which result from cancellation of a friend relationship

Revised the DWC_IsBuddyFriendData function to return the values that allow users to determine whether both parties in a friendship recognize that friendship.
Added the DWC_WasBuddyFriendData function, which will check whether the other person has cancelled the friend relationship.


Note 16-03: Support for Nitro SDK 4.2

Eliminated the following bug with the Nitro SDK 4.2 build: system would freeze when a user quit the Nintendo Wi-Fi Connection Settings.


Note 16-04: Changed URL in the message inside Nintendo Wi-Fi Connection Settings

Updated URL in the message inside the Nintendo Wi-Fi Connection Settings.


Note 16-05: Implemented a timeout for ranking

Changed the specification for performing timeout processes in the application such that timeouts are performed inside the library.
The time for timeouts is 30 seconds.


Note 16-06: Support for GameSpy SDK 2.05.00

Added support for GameSpy SDK 2.05.00


Note 16-07: Changed specifications for handling the buffer set by the DWC_SetRecvBuffer function

The DWC_SetRecvBuffer function exhibited the following problem: once a buffer with the specified aid was configured, that buffer would continue to remain valid even after the aid was disconnected. As a result, the next time a user connected using that same aid, you would receive any data they sent. This problem was solved by changing the function's specification.

With this change, the buffer set by DWC_SetRecvBuffer will be invalidated when the connection to the specified aid is terminated. Thus, it is now necessary to reconfigure the buffer every time a new connection is made.


Note 16-08: Eliminated a bug in the Nintendo Wi-Fi Connection Settings

Resolved a problem with operations that occurred when the DS clamshell was closed during the Nintendo Wi-Fi Connection settings.


Note 16-09: Eliminated a bug in server-client type matchmaking

Solved the following problem: when communications requiring NAT transversing were filtered by specific conditions, matchmaking would quit due to an error on the server side.


Note 16-10: Eliminated a bug that caused the storage server to freeze when the line was cut

Solved the following problem: the system would freeze if the line was dropped during log on to the storage server.


Note 16-11: In the sample demos, changed old-specification functions to new functions

The old-specification functions used inside the demos have been replaced by new functions.


Note 16-12: Reduced program size

The scanf and printf functions were replaced with the code for simple versions.


Note 16-13: To the Illegal String Check library, added a function for specifying a forced check in all regions

Added the DWC_CheckProfanityExAsync function to the Illegal String Check library which can be set to forcibly check all regions.


Note 16-14: Changed specifications for the DWC_RnkResGetTotal function

When the Ranking library is set to friend-ranking mode (DWC_RNK_GET_MODE_FRIENDS) and the rankings of a player's friends are obtained, the parameter returned by the DWC_RnkResGetTotal function now includes that player. Up until this change, the function would return 0 if the player had no registered friends; with the change, the function returns 1 in the same situation.


Note 16-15: Changed specifications and eliminated a bug related to the performance of unreliable transfer during reliable transfer

When the data exceeding the size specified by the DWC_SetSendSplitMax function is received through reliable transfer, a problem would occur if the received data was sent using unreliable transfer. This problem has been resolved by making it possible to send and receive a mix of reliable and unreliable transfer.


Note 16-16: Eliminated a bug that occurred during the process of obtaining the file list using the Download library

Resolved the following problem: when a file in the Download Server had the maximum number of characters in its name, file description, or attribution string, the file list could not be obtained.


Note 16-17: Eliminated a bug with P2P connections in an environment that does not allow NAT transversing

Solved the problem where making a P2P connection in an environment that does not allow NAT transversing would occasionally result in an 85010 error.


Note 16-18: Revised Programming Manual

Revised the following programming manuals in $NITRODWC_ROOT/docs.

For details, see the revision history of that document.


Note 16-19: Changed specifications related to the timing of transfer of the requests to build friend relationships

Changed the specification such that the request to build a friend relationship is sent only once to each partner during each login session.


Note 16-20: Revised Function Reference

Made revisions and additions 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 3.00 RC

None.


NITRO-DWC[-DL] 2.2 Official Version

(2007/08/24)


Note 15-01: Fixed a bug in the DWC_Realloc[Ex] function

Fixed a bug that, during copying to newly allocated memory from source memory, would cause an illegal access as a result of a problem with the loading size.


Note 15-02: Corrected problems related to communication errors during matchmaking.

Fixed a bug that caused a data access exception to occur when there was a communication error during matchmaking.


Note 15-03: Fixed a bug when invalid data is obtained using the general-purpose ranking management tool.

Fixed a bug that caused the general-purpose ranking management tool to exit abnormally when invalid data was obtained.


Note 15-04: Changed the size of dynamically allocated memory in the Illegal String Check library.

The memory size that is allocated dynamically within the Illegal String Check library was enlarged by 512 bytes to match specification changes of the server.
Up until now, the library only had sections that were read and discarded, and there were no operational problems.


Note 15-05: 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.2 Official Version

None.


NITRO-DWC[-DL] 2.2 RC

(2007/07/24)


Note 14-01: Changed constants in the general-purpose ranking library.

Constants used in the general-purpose ranking library have been changed as follows.


Note 14-02: Added acquisition modes to the general-purpose ranking library.

"Get modes" in the general-purpose ranking library have been added as follows.


Note 14-03: Made the general-purpose ranking management tool support proxy servers.

The general-purpose ranking management tool now supports proxy servers. This can be set in the tool.


Note 14-04: Corrected a problem with the previous/next display button in the general-purpose ranking management tool.

In the general-purpose ranking management tool, corrected the inability to use the button that displays what is before and after the currently displayed data.


Note 14-05: Fixed a memory-corruption bug in the Illegal String Check library.

Corrected a bug in the Illegal String Check library that caused two bytes to be overwritten past the memory region internally allocated from the heap when an illegal string check was performed.


Note 14-06: Corrected a problem with freeing memory in the DWC_CancelMatching function.

Corrected a bug that caused a portion of memory to not be released when the DWC_CancelMatching function was called after matchmaking had been started in the DWC_ConnectToAnybodyAsync function, given that NULL was specified as the pointer to the friend list in the DWC_InitFriendsMatch function.


Note 14-07: Corrected problems related to communication errors in the DWC_LoginToStorageServerAsync function.

Fixed a bug that caused a data access exception to occur when there was a communication error in the DWC_LoginToStorageServerAsync function.


Note 14-08: Corrected a problem with the DWCBuddyFriendCallback function that is called when a friend relationship is established.

Corrected a bug wherein the friend relationship establishment callback function would not be called, even if a friend relationship was established.


Note 14-09: Corrected a bug in determining private IP addresses related to peer-to-peer connections.

Corrected a problem that existed in part of the conditions for determining private IP addresses related to peer-to-peer connections.


Note 14-10: Made revisions to the Programming Manual.

Made revisions to the following programming manuals in $NITRODWC_ROOT/docs.

For details, see the revision history of each document.


Note 14-11: 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] Version 2.2 RC

None.


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-purpose 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-purpose 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 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 a function for checking invalid character strings.

The following functions for checking invalid character strings online have been added.

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


Note 12-02: Changed the specifications for the English message for 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 processing executed by the DWC_GetDateTime function when the real-time clock exceeds 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 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 to get 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 converting back and forth 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.

Added NITRO-CHARACTER data files for the "Wi-Fi Connection Support Icon" and the "Wi-Fi Reception Strength Icons" to $NITRODWC_ROOT/data/Wi-Fi_icons/. 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.

The socket closing processing of the Download library has been revised so that the callback notifying completion of asynchronous processing occurs without waiting for the socket closing processing to finish.


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 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 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] 2.0 Official Version

None.


NITRO-DWC[-DL] 2.0 RC

(2007/02/02)


Note 10-01: Made changes to the version of CodeWarrior 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 with error handling for 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 bugs with the conditions for establishment of 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 occurred if both parties created and exchanged friend data to be exchanged through DS Wireless Communications when both parties had previously connected to the Wi-Fi Connection at least once.


Note 10-04: Made revisions to the Programming Manual.

Revised the 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.

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] Version 2.0 RC

None.


NITRO-DWC[-DL] 2.0 PR

(2007/01/05)


Note 9-01: Made changes to the version of CodeWarrior 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 to be corrected with the next version.

NITRO-DWC[-DL] 1.3 RC

(2006/12/29)


Note 8-01: Added Korean language support to the Wi-Fi Connection Configuration.

Wi-Fi Connection Configuration now supports the 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 specifications of the DWC_NdCleanupAsync function.

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 by the DWC_SetMemFunc function.

Although specifications have allowed NULL to be passed in the ptr argument 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 ptr argument representing the memory deallocation function specified by the application.


Note 8-06: Changed the server URL used by the general-purpose 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: Dealt with parts where there is no timeout during communications with the GameSpy server during matchmaking.

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


Note 8-09: Fixed an issue with the error code of errors 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 problems 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 a great number of people.

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 almost never occurred when matchmaking for four people. However, it increased in likelihood as the number of people increased.


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 problems related to communication errors in 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 about 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 cancel 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 the sound problem in the Wi-Fi Connection Configuration.

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

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 the 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 for 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.


Note 8-26: 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] 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

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


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

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

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

Fixed a bug that prevented the callback 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

Made revisions to the following documents 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 -Download Edition-
Nintendo Wi-Fi Connection NITRO-DWC Programming Manual - General-Purpose Ranking Edition-


Note 7-07: Revised 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.

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

Fixed a bug that prevented user-defined data from being 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

Added the DWC_NASLogin* function, which performs the verification process for Nintendo authentication. Previously, this process was performed in the DWC_LoginAsync function, but when FriendsMatch Library features such as friend management and matchmaking are not used, this function performs the authentication process instead.
Added the dwc_naslogin_sample sample demo to reflect 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

Added a function to check that a connection to an access point is being maintained normally. Previously, this process was performed in the DWC_ProcessFriendsMatch function, but when FriendsMatch Library features such as friend management and matchmaking are not used, 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

Previously, the game name "gmtest" has been used in the sample demo. However, since developers who generally used GameSpy used it as a shared name, using this name could give a glimpse into the information about games in development and 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

Made revisions to the following items. 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, is now 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. If that happens, the callback occurs each time.
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.

Revised the process for making an automatic connection to the Internet for access point authentication processes to improve connectivity to access points that accept only open system authentications.


Note 5-03: Made revisions to the Programming Manual

Made revisions to the following documents 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

Made revisions to the following items. For details, see the revision history for each item.

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

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


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

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 zero for the size in the DWC_RnkPutScoreAsync function.


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

Corrected a problem that caused the application to stop due to an insufficient receive buffer when the download server returned an error.
Along with this fix was the 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 is needed, even if the downloaded data is smaller.


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

Made changes to the internal operations of the process for obtaining service locator information used by the download feature.


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 occur in NITRO-DWC Version 1.0 and later.
Note: This problem is corrected by the NITRO-DWC 1.1 PLUS patch.


Note 3-06: Corrected the problem that prevented matchmaking from ending if started after disconnecting during a game.

When matchmaking was started after disconnecting during a game, sometimes that matchmaking process did not end. This problem has been corrected.
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: Corrected a problem that prevented Reception timeout callback from being called

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


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

When connecting at a hotspot, the required information was not sent to the authentication server. This problem has been corrected.
This problem made it impossible to connect at some hotspots.
Note: This problem does not occur in NITRO-DWC Version 1.0 and later.
Note: This problem is 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 is sent to the authentication server using the DWC_LoginAsync function has been extended to 25 characters. Previously, 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 –1 was unexpectedly entered for the index argument of these callback functions. This problem has been corrected.
The problem occurred 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 problem is 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 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 $NITRODWC_ROOT/add-ins directory 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, and so on) 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 DWC_GetDateTime function 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, only connects 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 a bug that caused the sound effect to loop while the B button was pressed when canceling 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 roster

The maximum number of friends that the DWC Library can handle is 64, so an ASSERT was added that checks whether the friend roster 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 that caused the child DS to freeze when the parent DS was 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 if a child DS cannot communicate with its parent for a fixed amount of time, it re-attempts matchmaking.


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

The DWC_CheckFriendKey function was 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 roster 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, only connections with those friends specified in friendIdxList are made (or all friends if friendIdxList=NULL).


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

There was a bug that caused the internal process to continue and fatal error code 71002 to be generated after the networking state became unstable and a DWC error was 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 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