CTR-SDK Change Log

Applications are prohibited from spontaneously calling nn::applet::CTR::CloseApplication and closing. To prevent this occurrence, the return value of the nn::applet::CTR::IsExpectedToCloseApplication function is checked. If it is false (meaning that the system has not requested termination), the system now stops instead of closing the application.

Note 274-02: (CFG) Added an API function for getting the Entertainment Excluding Games restrictions in Parental Controls [SDK].

Added an API function for getting the Entertainment Excluding Games restrictions in Parental Controls.

Note 274-03: (HIO) Updated the hio Library for IS-CTR-DEBUGGER [SDK].

The hio library for IS-CTR-DEBUGGER was updated to version 20140423.

Note 274-04: (RO) Revised makecro. [SDK]

In some cases when using C++ exceptions, makecro would generate invalid cros.
This bug was fixed.

Note 274-05: (TOOL) Suppression of makecro Warnings When Using the Feature for Selecting C Library Implementations [SDK]

There is a feature for selecting C library implementations in ARMCC by importing symbols that start with __use_.
Fixed a bug where warnings would occur with ctr_makecro32.exe when using this feature.

Known Issues With the SDK 7.2.1 Release

FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used.
A large font size is set. (The size that causes the problem could vary depending on the font.)
Two levels of gradation are set for the number of gradations under Advanced Settings (applies to both the A4 and LA4 settings).

■ CTR-SDK Version 7.2.1 System Updater 0.20.51

(2014/05/13)

Note 273-01: (DevEnv) Added supported fonts to the e-manual viewer for China, Korea, and Taiwan [System Updater].

The system fonts for Japanese, North American, and European systems can now be displayed in the e-manual viewers for Chinese, Korean, and Taiwanese systems.
This addition was actually included in System Updater 0.20.18, but was accidentally omitted from the change log.

Note 273-02: (HOME Menu) Updated the HOME Menu [System Updater].

The following changes were made to the HOME Menu.

Systems in the Taiwan region now require EULA consent again at startup if the version of the EULA the user has consented to is 1.1 or earlier.

Note 273-03: (RO) Fixed a bug where relocation did not occur under specific conditions [System Updater].

Fixed a problem where relocation was not carried out appropriately when pointers in other modules were configured as the initial values of static variables, depending on conditions such as the size and alignment of cro.

Note 273-04: (System Settings) Updated System Settings [System Updater].

The following changes were made to System Settings.

WPA2-PSK (TKIP) is no longer supported.
Each of the settings in Parental Controls was changed to restricted by default.
The secret question for Parental Controls can now be set as free text.
An email address can now be registered for when the PIN code is forgotten.
Improved the descriptions of Parental Controls in the initial startup sequence.
Made the button for formatting the system red.

Known Issues With System Updater 0.20.51 in SDK Version 7.2.1

For more information about the known issues with System Updater, see the Symptoms of Known Issues file in the CTR-SDK.

■ CTR-SDK Version 7.2.0 Release

(2014/04/04)

Note 272-01: (ACT) Added an account system developer's guide [SDK].

Added an account system developer's guide to the Technical Notes.

Note 272-02: (ACT) Added the account library [SDK].

Added a library related to Nintendo Network accounts.

Note 272-03: (CAMERA) Changed the specifications of the SetReceiving function [SDK].

The buffer passed to the SetReceiving function must be taken from device memory. Changed the specifications so that the system stops on a panic if a buffer not taken from device memory is specified.

Note 272-04: (CFG) Added a function that gets whether Parental Controls have been set [SDK].

Added a function that gets whether Parental Controls have been set.

Note 272-05: (DBG) Fixed incorrect values for ExceptionScreen::Option [SDK].

Fixed a bug where the values for each of the nn::dbg::CTR::ExceptionScreen::Option members were incorrect.

Note 272-06: (DBG) Fixed a bug when unused debug output functions were being linked in some environments [SDK].

Fixed a bug where unused debug output functions were being linked in some environments.

Note 272-07: (DevEnv) Added Internet Browser icons [SDK].

Added Internet Browser icons that applications are free to use in $CTR_SDK/resources/icon/BrowserIcon. Also added related documentation.

Note 272-08: (DevEnv) Revised the system application and applet specifications [SDK].

Added supplemental notes about system applications and notes about the software keyboard to the system application and applet specifications ($CTR_SDK/documents/TechnicalNotes/AppletGuide/Applet_Specification.pdf).

Note 272-09: (EC) Revised the EC library documentation [SDK].

Made the following revisions to the EC library documentation.

Added specific examples of the cases when ResultAppletCancelled is returned to the descriptions of the nn::ec::CTR::EcApplet::RequestInitializeSession member functions.
Added a procedure for checking that a user's license information stays with the user when the user's Nintendo Network ID is removed from a service item reference.
Revised the description of the arguments in the reference for the EC_GenerateRIVToken function.
Added information to the section that describes error handling for the nn::ec::CTR::ResultError class in cases when it is not necessary for the application to show a message.
Added information about the need for currency notation prefixes and suffixes to be displayed, and how to display them, to the description of the nn::ec::CTR::Money structure.
Changed the "EcRightTool" notation in the patch manual to "EcDevTool."
Added notes about when to revert patches to the patch manual.
Added that content index values cannot be specified at random; they must be sequential.
Added information to that effect to the descriptions of functions that sync the eShop server and local license information on a normal exit.
Fixed typos in the description of the nn::ec::CTR::ServiceItemCatalog::Retrieve function.
Noted that the ticket envelope gets bigger the more items the user purchases.
Noted in the EcDevTool reference that an SD card must be inserted to add money.
Noted that service items retrieved with the nn::ec::CTR::ServiceItemCatalog::Retrieve function are sorted in ascending order by item code.
Deleted the line for specifying the CompanyCode from the AddOnContent.rsf file.
Revised the listing on the EcApplet-related nn::Result return values.
Changed the description of how to add data title versions.
Noted that the value of SaveDataSize in RSF files must not be changed before or after patches.
Corrected typos in the description of the ECardCatalogFilter::SetECardTypeCode function.
Noted that the GetPrice and GetItemId member functions do not return the correct values when the nn::ec::CTR::ContentSet::IsPurchasable or nn::ec::CTR::ServiceItem::IsPurchasable functions return false.
Noted that all API functions may return values other than the ones listed.
Noted that implementation in the application is not required if the application will not be patched.
Noted in the patch manual that, depending on the version, it may not be possible to add new Download Play child systems or e-manuals with a patch.
Noted in the description of the nn::applet::CTR::JumpToEShopTitlePage function that an application in OMAS is required for the jump destination.
Noted that the jump destination from the nn::applet::CTR::JumpToEShopTitlePage function is the Software Information page.
Added information to the manual about the restrictions on the service names that can be displayed in the EC applet.
Added information on handling authentication errors to the description of the EC_VerifyExtendedTicket function.
Added a description of the ECSV library.

Note 272-10: (EC) Added the nn::ec::IsRunningAsPatch function [SDK].

Added the nn::ec::IsRunningAsPatch function, which gets whether the application is running on its own or has a patch applied.

Note 272-11: (FS) Included fs_AddOnContent.h in fs.h [SDK].

Made revisions so that fs_AddOnContent.h, which is required when using fs functions related to downloadable content, is included in fs.h.

Note 272-12: (GD) Fixed a bug that occurred when RasterizerStage issued invalid register write commands while setting specific parameters [SDK].

Corrected the following bugs.
- A bug that would occur when a register write command was issued to write a value that exceeded the stipulated number of bits when the viewpoint specified in the SetScissor function was (0, 0, 0, 0). - A bug where it was possible to write while executing Draw on 0x61[31:8], even though access to that address is prohibited in the specifications.
- A bug where it was possible to write to 0x47[31:8], even though access to that address is prohibited in the specifications, depending on the arguments passed to the EnableClippingPlane function.

Note 272-13: (HIO) Updated the hio Library for IS-CTR-DEBUGGER [SDK].

The hio library for IS-CTR-DEBUGGER was updated to version 20131226.

Note 272-14: (RO) Changed the build rules for partial links [SDK].

Debug data is no longer added to partial links when creating DLLs.
This change decreases the memory used by the linker and improves link times.

Note 272-15: (TOOL) Added a feature to EcDevTool for calling the EULA consent screen [SDK].

Funds cannot be added if the user has not consented to the EULA with EcDevTool. This revision shows the EULA consent screen if the user has not consented. If the user changes the country setting in System Settings, the EULA consent is invalidated. For ease of debugging, this revision shows the EULA consent screen after the country setting is changed when the user has not consented to the EULA.

Note 272-16: (TOOL) Fixed an error display bug in EcDevTool [SDK].

Fixed a bug in the display of errors in EcDevTool.
An indication that an SD card must be inserted when adding money is now shown.

Note 272-17: (TOOL) Fixed a bug where StereoCameraCalibrator could not be started from the HOME Menu [SDK].

Fixed a bug where StereoCameraCalibrator could not be started from the HOME Menu.

Note 272-18: (TOOL) Revised makebanner [SDK].

Revised the default EULA version requested by applications. (EU was changed to 1.1, and TW was changed to 1.2.)

Note 272-19: (TOOL) Added notes to ctr_makecia for when making add-on content.

Added notes to the ctr_makecia documentation indicating that there must never be gaps between add-on content and indexes when using the -i option.

Note 272-20: (UBL) Deleted the nn::ubl::Clear function [SDK].

Deleted the nn::ubl::Clear function.
Initialize the Blocked User List from System Settings.

Note 272-21: (Y2R) Changed the specifications of the functions related to SetReceiving and SetSending [SDK].

The buffers passed to the functions related to SetReceiving and SetSending must be taken from device memory. Changed the specifications so that the system stops on a panic if a buffer not taken from device memory is specified.

Known Issues With the SDK 7.2.0 Release

In some cases, FontConverter cannot convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used.
A large font size is set. (The size that causes the problem could vary depending on the font.)
Two levels of gradation are set for the number of gradations under Advanced Settings (applies to both the A4 and LA4 settings).

CTR-SDK Version 7.2.0 Sample Demos

(2014/04/04)

Note 271-01: (EC) Added the EasyRedemption demo to make purchases with download codes using the EC applet [Sample Demos].

Added the EasyRedemption sample demo, which simplifies the implementation of purchases using download codes.

Known Issues With SDK 7.2.0 SampleDemos

None.

■ CTR-SDK Version 7.2.0 System Updater 0.20.48

(2014/04/04)

Note 270-01: (DevEnv) Added support for development menu join-in IDs [System Updater].

You can now link to the friend list when starting an application from the development menu in the same way as with the HOME Menu.
For more information, see the references for the nn::friends::UpdateGameMode and nn::friends::UpdateGameModeDescription functions.

Note 270-02: (DevEnv) Added a display to the development menu that shows the current setting for whether screenshots can be posted [System Updater].

The value of the setting for whether screenshots held by the system can be posted when applications are suspended (when transitioning to the HOME Menu) can now be checked from the development menu.

Note 270-03: (HOME Menu) Added a debug display feature [System Updater].

The current system mode is now shown in the debug display.

Note 270-04: (TOOL) Improved the OlvAccessKey input method [System Updater].

The numeric keypad can now be used for input when making OlvAccessKey settings with the Config tool.

Note 270-05: (TOOL) Added restrictions to the system mode settings [System Updater].

Restrictions were added to the ability to change the system mode to prevent situations where applications could not be started when specific conditions were met in System Settings.

Known Issues With System Updater 0.20.48 in SDK Version 7.2.0

For more information about the known issues with System Updater, see the Symptoms of Known Issues file in the CTR-SDK.

■ CTR-SDK Version 7.1.1 System Updater 0.20.18

(2014/01/07)

Note 269-01: (HOME Menu) Fixed a bug that caused the HOME Menu to stop responding [System Updater].

Fixed a bug that caused the HOME Menu to stop responding when certain conditions were met.

Known Issues With SDK 7.1.1 System Updater 0.20.18

For more information about the known issues with System Updater, see the Symptoms of Known Issues file in the CTR-SDK.

■ CTR-SDK Version 7.1.1 Release

(2014/01/07)

Note 268-01: (APPLET) Changed the specifications for the function to jump to Nintendo eShop [SDK | Sample Demos]

Made changes so that the nn::applet::JumpToEShopTitlePage function returns Result.

Note 268-02: (EC) Updated the documentation on the `nn::ec::CTR::ResultError` class [SDK]

Updated the documentation to include sample code for error handling that had been accidentally omitted.
Also added an example on canceling to the error handling sample code.

Note 268-03:(TOOL) Revised some error displays for `ctr_makerom` [SDK]

Fixed a bug that caused excessive errors to be output when the indents in RSF files were wrong.

Known Issues With SDK 7.1.1 Release

FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used.
A large font size is set. (The size that causes the problem could vary depending on the font.)
Two levels of gradation are set for the number of gradations under Advanced Settings (applies to both the A4 and LA4 settings).

■ CTR-SDK Version 7.1.1 Sample Demos

(2013/12/16)

Note 267-01: (APPLET) Changed the specifications for the function to jump to Nintendo eShop. [SDK | Sample Demos]

Made changes so that the nn::applet::JumpToEShopTitlePage functions returns Result.

Known Issues With SDK 7.1.1 Sample Demos

None.

■ CTR-SDK Version 7.1.1 System Updater 0.20.17

(2013/12/16)

Note 266-01:(EC) Fixed a bug that caused a 026-3123 error to occur when newly purchasing add-on content or a service item. [System Updater]

Fixed a bug that causes an 026-3123 error to occur when newly purchasing add-on content or a service item.

Known Issues With SDK 7.1.1 System Updater 0.20.17

For more information about the known issues with System Updater, see the Symptoms of Known Issues file in the CTR-SDK.

■ CTR-SDK Version 7.1.0 System Updater 0.20.10

(2013/11/26)

Note 265-01: (APPLET) Fixed a bug that caused the handle transition parameter to close during applet transitions. [System Updater]

Fixed a bug where the system would close a handle automatically when the handle was passed in the transition parameter during a transition from an application to the system applet.

Known Issues With SDK 7.1.0 System Updater 0.20.10

For more information about the known issues with System Updater, see the Symptoms of Known Issues file in the CTR-SDK.

■ CTR-SDK Version 7.1.0 Release

(2013/11/15)

Note 264-01:(APPLET) Added functions for jumping to Nintendo eShop. [SDK | Sample Demos]

Added a function to check whether Nintendo eShop is installed, and a function to jump to specific titles in Nintendo eShop.

Note 264-02:(BOSS) Fixed a bug where the error code sometimes could not be obtained when downloading of the NSA list failed. [SDK | Sample Demos]

Fixed a bug where sometimes the error code could not be obtained from the nn::boss::NsaList::GetResult function when an error was returned by the nn::boss::NsaList::Download function.
In conjunction with this bug fix, the sample_nsalist BOSS sample demo is also now fixed.

Note 264-03:(BOSS) Fixed a bug where tasks registered with `nn::boss::RegisterImmediateTask` would not execute immediately if the TaskPolicy argument was omitted. [SDK | Sample Demos]

Fixed a bug where tasks registered with nn::boss::RegisterImmediateTask would not execute immediately if you omitted the TaskPolicy argument, incorporated since CTR-SDK 7.0.2.
In conjunction with this bug fix, the sample_fgonlytask and sample_nsalist BOSS sample demos are also now fixed.

Note 264-04:(CFG) Added an API for converting country codes. [SDK | System Updater]

Added an API for converting between CTR country codes and ISO 3166-1 alpha-2 strings.
In conjunction with this, the GetCountryCodeA2 function will be deprecated.
In its place, use the ConvertCountryCodeToIso3166a2 function.

Note 264-05:(DevEnv) Suppressed the warnings associated with ARMCC 5.03. [SDK]

Suppressed the unnecessary warnings that arose when building with ARMCC 5.03.

Note 264-06:(DevEnv) Added the webbrs library for jumping to the Internet Browser. [SDK | Sample Demos]

Added the webbrs library, which is designed for jumping to the Internet Browser.

Note 264-07:(DevEnv) Added shared layout resource data supporting NW4C 3.0. [SDK]

Added the following layout resource data to support the layout formats of NW4C 3.0 and later versions.

$CTR_SDK/resources/icon/HomeNixSign/layout2
$CTR_SDK/resources/icon/UpdateIndicator/layout2

The following layout resource data supports the layout formats prior to NW4C 3.0.

$CTR_SDK/resources/icon/HomeNixSign/layout1
$CTR_SDK/resources/icon/UpdateIndicator/layout1

Note 264-08:(EC) Deleted the `EC_VerifyTicket` function from the ECSV library reference. [SDK]

Deleted the EC_VerifyTicket function and the ECTicketInfo structure from the ECSV library reference, because they normally do not need to be used.

Note 264-09:(EC) Added `EcDevTool`. [SDK]

Added EcDevTool, which is a tool that can be used to add to the balance of an eShop account, to delete the rights to purchased content or to delete an eShop account, and to change the country setting of an account on the eShop server to match the country setting of the CTR system.
In conjunction with this, deleted EcCashTool, EcRightTool, and EcCountryTool, which were used up until now.
Use EcDevTool from now on.

Note 264-10:(EC) Deleted the `nn::ec::GetAccountId` function. [SDK]

Deleted the nn::ec::GetAccountId function, in line with the introduction of the Nintendo Network ID.

Note 264-11:(EC) Added a description of the RSF file to use for add-on content. [SDK]

Added a description of the RSF file to use when creating add-on content to the section about how to create data titles in the ec API reference, and to the Guide to Developing a Build System ($CTR_SDK/documents/TechnicalNotes/BuildSystemDevelopmentGuide/BuildSystemDevelopmentGuide.html).

Note 264-12:(FS) Deleted the `nn::fs::ResultBackupNotRequired` class. [SDK]

Deleted the nn::fs::ResultBackupNotRequired class, because it is not needed for application development and was unintentionally included in the header file and documentation.

Note 264-13:(GR) Prohibited copying of the `FrameBuffer`, `RenderState`, and `Texture` classes. [SDK]

These are internally held classes, and when they are designed for self-reference they will not operate as intended, even when instances are copied.
Copying these classes has been prohibited by making both their copy constructors and assignment operators private.

Note 264-14:(GX) Fixed a bug where on rare occasions you could not get the correct result with the `glReadPixels` function. [SDK]

Fixed a bug that, depending on the timing, created the possibility that you might not be able to get the correct result with the glReadPixels function, because of a problem with internal processing by the function.

Note 264-15:(GX) Improved the check for uninitialized variables entered for the `dp3` instruction in the shader assembler. [SDK]

dp3 dst, src1, src2

When coded this way, a warning would be output if a variable was uninitialized, even if src1.w did not actually reference dp3. That has been fixed.

Note 264-16:(JPEG) Fixed a bug where Maker Notes would become invalid if the `JpegMpEncoder` class functions `SetUserMakerNote` and `SetImageUid` were used at the same time. [SDK]

Fixed a bug where, if encoding was conducted with valid values set for both the SetUserMakerNote and SetImageUid functions of the JpegMpEncoder class, the information specified by SetUserMakerNote would not be saved correctly and could not be obtained later when it was time to decode the data.

Note 264-17:(PL) Added `nn::pl::CTR::GetSharedFontRequiredMemorySize`. [SDK]

Added a way to calculate the required size of the memory region that must be passed for file operations with nn::pl::CTR::MountSharedFont.
Use nn::pl::CTR::GetSharedFontRequiredMemorySize when mounting shared font archives with nn::pl::CTR::MountSharedFont.

Note 264-18:(TOOL) Added descriptions of the various kinds of CFA files to the `ctr_makerom` reference. [SDK]

Added a link to a page with details about the creation of the various CFA files to the reference for ctr_makerom.

Note 264-19:(TOOL) Updated `makebanner`. [SDK]

Made the following modifications to makebanner.

Added a new category (R18+) to the COB ratings (for Australia).
An error is now generated when you use fog.
If you make entries for LongName, ShortName, and Publisher in the standard language specified for a region, an error is now generated if you do not make entries for all three items.

Made the following modifications to make_ex_banner.

If a value is specified for LimitYear, Month, or Date, an error is now generated if you do not make entries for all three items.

Note 264-20:(TOOL) Fixed a bug where `SaveDataFiler` ended during exporting. [SDK]

Fixed a bug where SaveDataFiler would sometimes terminate abnormally when save data or expanded save data containing multiple sets of data was being exported to an SD card.

Known Issues With SDK 7.1.0 Release

FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used.
A large font size is set. (The size that causes the problem could vary depending on the font.)
Two levels of gradation are set for the number of gradations under Advanced Settings (applies to both the A4 and LA4 settings).

■ CTR-SDK Version 7.1.0 Sample Demos

(2013/11/15)

Note 263-01:(APPLET) Added functions for jumping to Nintendo eShop. [SDK | Sample Demos]

Added a function to check whether Nintendo eShop is installed, and a function to jump to specific titles in Nintendo eShop.

Note 263-02:(BOSS) Improved error handling in the sample demos for NADL tasks. [Sample Demos]

Improved error handling in the sample demos for NADL tasks when functions like nn::boss::GetNsDataIdList return errors when getting lists of data from BOSS storage.
The error codes are now displayed.

Note 263-03:(BOSS) Fixed a bug where the error code sometimes could not be obtained when downloading of the NSA list failed. [SDK | Sample Demos]

Note 263-04:(BOSS) Added a process to the `sample_nsalist` BOSS sample demo to display error codes when errors occur. [Sample Demos]

Added an error handling process to the sample_nsalist BOSS sample demo to display the error code when an error is returned by the nn::boss::NsaList::Download function.

Note 263-05:(BOSS) Changed the execution count in the sample demos for upload tasks. [Sample Demos]

Changed the execution count in the sample demos for upload tasks (DataStore upload tasks) to more closely match the actual method used in applications.
Previously, the execution count was 1. That has been changed to multiple times (10) and the task is tried again when there are upload errors.

Note 263-06:(BOSS) Fixed a bug where tasks registered with `nn::boss::RegisterImmediateTask` would not execute immediately if the TaskPolicy argument was omitted. [SDK | Sample Demos]

Fixed a bug where dedicated immediate-execution tasks registered with nn::boss::RegisterImmediateTask would not execute immediately if you omitted the TaskPolicy argument, incorporated since CTR-SDK 7.0.2.
In conjunction with this bug fix, the sample_fgonlytask and sample_nsalist BOSS sample demos are also now fixed.

Note 263-07:(DevEnv) Added the webbrs library for jumping to the Internet Browser. [SDK | Sample Demos]

Added the webbrs library, which is designed for jumping to the Internet Browser.

Known Issues With SDK 7.1.0 Sample Demos

None.

■ CTR-SDK Version 7.0.8 System Updater 0.20.9

(2013/11/15)

Note 262-01:(CFG) Added an API for converting country codes. [SDK | System Updater]

Note 262-02:(DevEnv) Added a feature for enabling and disabling wireless to the Dev Menu [System Updater]

Added a feature to the Dev Menu for switching wireless on and off using the R Button.
For CTR/SPR, this is only enabled in debug mode.

Note 262-03:(HOME Menu) Updated the HOME Menu. [System Updater]

The following changes were made to the HOME Menu.

Added a button to start Miiverse.
To start the HOME Menu camera, you now press the L and R Buttons simultaneously. Previously, you only needed to press one or the other.

Note 262-04:(Mii Maker) Updated Mii Maker. [System Updater]

The following changes were made to Mii Maker.

Added support for updating Mii characters linked to Nintendo Network IDs.
Added support for calling from the Nintendo Network ID settings.
Fixed a bug where Mii encounters took place when exchanging Mii characters.

Note 262-05:(Miiverse) Added Miiverse. [System Updater]

Added Miiverse.

Note 262-06:(Nintendo Network ID Settings) Added Nintendo Network ID Settings. [System Updater]

Added Nintendo Network ID Settings.

Note 262-07:(System Settings) Updated the System Settings. [System Updater]

The following changes were made to the HOME Menu.

Added a button to jump to the Nintendo Network ID Settings.
Added a procedure to the process for initializing the system when getting the Nintendo Network ID to unbind the Nintendo Network ID from the system.
When the country setting is changed, now only the rating information is changed, and the Parental Control PIN is not removed.
The Parental Control rating information now supports the new rating in Australia.

Known Issues With SDK 7.0.8 System Updater 0.20.9

For more information about known issues with System Updater, see the Symptoms of Known Issues file in the CTR-SDK.

CTR-SDK Version 7.0.8 Release

(2013/11/06)

Note 261-01:(APPLET) Added the `nn::applet::CTR::GetInitialParam` function. [SDK]

Added the nn::applet::CTR::GetInitialParam function so that information can be received when starting from a system applet.

Known Issues With SDK 7.0.8 Release

FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used.
A large font size is set. (The size that causes the problem could vary depending on the font.)
Two levels of gradation are set for the number of gradations under Advanced Settings (applies to both the A4 and LA4 settings).

CTR-SDK Version 7.0.8 System Updater 0.20.8

(2013/11/06)

Note 260-01:(FRIENDS) Fixed a bug where the `nn::friends::Initialize` function would fail. [System Updater]

Fixed a bug where calls to the nn::friends::Initialize function would fail under certain system conditions due to a limit on the number of instances of the friends library that can be used at the same time.

Known Issues With SDK 7.0.8 System Updater 0.20.8

For more information about known issues with System Updater, see the Symptoms of Known Issues file in the CTR-SDK.

CTR-SDK Version 7.0.7 Release

(2013/10/28)

Note 259-01:(DevEnv) Changes Related to the SDK [SDK]

No SDK-related changes have been made to the functionality except the version information.

Known Issues With SDK 7.0.7 Release

FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used.
A large font size is set. (The size that causes the problem could vary depending on the font.)
Two levels of gradation are set for the number of gradations under Advanced Settings (applies to both the A4 and LA4 settings).

CTR-SDK Version 7.0.7 System Updater 0.20.7

(2013/10/28)

Note 258-01:(TOOL) Added a feature to configure OLV access keys to the `Config` tool. [System Updater]

Added a feature to configure OLV access keys to the Config tool.
For more information, see the documentation of the Config tool.

Known Issues With SDK 7.0.7 System Updater 0.20.7

For more information about known issues with System Updater, see the Symptoms of Known Issues file in the CTR-SDK.

CTR-SDK Version 7.0.6 Release

(2013/10/21)

Note 257-01:(DevEnv) Changes Related to the SDK [SDK]

No SDK-related changes have been made to the functionality except the version information.

Known Issues With SDK 7.0.6 Release

FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used.
A large font size is set. (The size that causes the problem could vary depending on the font.)
Two levels of gradation are set for the number of gradations under Advanced Settings (applies to both the A4 and LA4 settings).

CTR-SDK Version 7.0.6 System Updater 0.20.6

(2013/10/21)

Note 256-01:(OS) Made revisions to make the system more stable. [System Updater]

Made revisions to improve system stability.
These changes do not affect the operations of the application.

Known Issues With SDK 7.0.6 System Updater 0.20.6

For more information about known issues with System Updater, see the Symptoms of Known Issues file in the CTR-SDK.

CTR-SDK Version 7.0.5 Release

(2013/10/16)

Note 255-01:(DevEnv) Changes Related to the SDK [SDK]

No SDK-related changes have been made to the functionality except the version information.

Known Issues With SDK 7.0.5 Release

FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used.
A large font size is set. (The size that causes the problem could vary depending on the font.)
Two levels of gradation are set for the number of gradations under Advanced Settings (applies to both the A4 and LA4 settings).

CTR-SDK Version 7.0.5 System Updater 0.20.5

(2013/10/16)

Note 254-01:(OS) Made revisions to make the system more stable. [System Updater]

Made revisions to improve system stability.
These changes do not affect the operations of the application.

Known Issues With SDK 7.0.5 System Updater 0.20.5

For more information about known issues with System Updater, see the Symptoms of Known Issues file in the CTR-SDK.

CTR-SDK Version 7.0.4 Release

(2013/10/07)

Note 253-01:(TOOL) Updated `makebanner`. [SDK]

Revised the description for RatingRequired.
Revised the description for LongName, ShortName, and Publisher.

Known Issues With SDK 7.0.4 Release

FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used.
A large font size is set. (The size that causes the problem could vary depending on the font.)
Two levels of gradation are set for the number of gradations under Advanced Settings (applies to both the A4 and LA4 settings).

CTR-SDK Version 7.0.4 System Updater 0.20.4

(2013/10/07)

Note 252-01:(OS) Made revisions to make the system more stable. [System Updater]

Made revisions to improve system stability.
These changes do not affect the operations of the application.

Known Issues With SDK 7.0.4 System Updater 0.20.4

For more information about known issues with System Updater, see the Symptoms of Known Issues file in the CTR-SDK.

CTR-SDK Version 7.0.3 Release

(2013/09/27)

Note 251-01:(DevEnv) Changes Related to the SDK [SDK]

No SDK-related changes have been made to the functionality except the version information.

Known Issues With SDK 7.0.3 Release

FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used.
A large font size is set. (The size that causes the problem could vary depending on the font.)
Two levels of gradation are set for the number of gradations under Advanced Settings (applies to both the A4 and LA4 settings).

CTR-SDK Version 7.0.3 System Updater 0.20.3

(2013/09/27)

Note 250-01:(OS) Made revisions to make the system more stable. [System Updater]

Made revisions to improve system stability.
These changes do not affect the operations of the application.

Known Issues With SDK 7.0.3 System Updater 0.20.3

For more information about known issues with System Updater, see the Symptoms of Known Issues file in the CTR-SDK.

■ CTR-SDK Version 7.0.2 Release

(2013/09/18)

Note 249-01: (BOSS) Fixed a bug in which the permission settings for tasks registered with the `nn::boss::RegisterImmediateTask` function could not be changed [SDK]

Fixed a bug in which the TASK_PERMISSION values of settings for immediate execution tasks registered with the nn::boss::RegisterImmediateTask function could not be changed.

Note 249-02: (CFG) Added an API function for converting `SimpleAddress` information IDs between the CTR and Wii U [SDK | System Updater]

Added an API function for conversions between the SimpleAddress information IDs obtained from the CTR and Wii U systems.

Note 249-03: (MATH) Fixed a bug in which the input matrix was not being reflected in the fourth row of the output matrix from the `MTX44MultTranslate` function [SDK]

Of the two types of MTX44MultTranslate function, the pM input for the fourth row of the pOut output was not being applied in the one that pre-multiplies the translation matrix (see below).
This was fixed in the MTX44MultTranslateC(MTX44* pOut, const VEC3* pT, const MTX44* pM) function.

Note 249-04: (TOOL) Fixed a bug in which an error would occur during `cro` creation [SDK]

Fixed a bug in which an error in ctr_makecro32.exe prevented the creation of cro files.

Note 249-05: (TOOL) Made `ctr_makerom32.exe` faster [SDK]

Improved the processing speed for ctr_makerom32.exe.

Note 249-06: (TOOL) Revised `makebanner` [SDK]

Fixed some mistakes in the LongName, ShortName, and Publisher character length checking.
Fixed error conditions in English title names (LongName, ShortName, and Publisher).

Known Issues with SDK 7.0.2 Release

FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used.
A large font size is set. (The size that causes the problem could vary depending on the font.)
Two levels of gradation are set for the number of gradations under Advanced Settings (applies to both the A4 and LA4 settings).

■ CTR-SDK Version 7.0.2 System Updater 0.20.2

(2013/09/18)

Note 248-01: (CFG) Added an API function for converting `SimpleAddress` information IDs between the CTR and Wii U [SDK | System Updater]

Added an API function for conversions between the SimpleAddress information IDs obtained from the CTR and Wii U systems.

Note 248-02: (OS) Fixed a bug where the debugger would hang if attached while terminating a thread [System Updater]

Fixed a bug where the debugger could hang (and the LCD would turn red) if attached while a thread was ending.

Note 248-03: (OS) Fixed a bug in which large programs could not be executed [System Updater]

Fixed a bug in which large programs, included in AXF files, could not be executed via makerom when the region they occupied in the CCI or CIA file was large (16MB or more).

Known Issues with SDK 7.0.2 System Updater 0.20.2

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 7.0.1 Release

(2013/09/06)

Note 247-01: (EC) Revised the price notation information conversion feature [SDK].

Fixed a bug where the nn::ec::Server::ConvertPrice function ended up returning erroneous price notations.

Known Issues with SDK 7.0.1 Release

FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used.
A large font size is set. (The size that causes the problem could vary depending on the font.)
Two levels of gradation are set for the number of gradations under Advanced Settings (applies to both the A4 and LA4 settings).

■ CTR-SDK Version 7.0.1 System Updater 0.20.1

(2013/09/06)

Note 246-01: (OS) Made revisions to make the system more stable [System Updater]

Made revisions to improve system stability.
These changes do not affect the behavior of the application.

Known Issues with SDK 7.0.1 System Updater 0.20.1

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 7.0.0 Release

(2013/08/23)

Note 245-01: (APPLET) Added a function for setting posting permissions for the screenshots obtained by the system [SDK | System Updater]

Added a function to set in advance by the application whether it is okay to post externally from the application (within the console) any screenshots automatically obtained when the application is interrupted and a transition made to the HOME Menu. Also added a function for getting those setting values.

Note 245-02: (BOSS) Split up the `nn::boss::TaskResultCode` codes for DataStore upload and download tasks [SDK | System Updater]

Split up the nn::boss::TaskResultCode values such that error status could be understood in greater detail when an execution error occurs for the DataStore upload and download tasks.
The delineated DataStore error values are listed under the "//DataStore error" comments for nn::boss::TaskResultCode in boss_Const.h.

Note 245-03: (CAMERA) Made changes so the `camera` library appears in the list of middleware in CTR Master Editor [SDK]

When applications using the camera library are loaded into CTR Master Editor, made changes such that NINTENDO:CameraActivate is now displayed in the middleware list.

Note 245-04: (DevEnv) Integrated E-Commerce Kit [SDK | Sample Demos]

Integrated the content of E-Commerce Kit into this package.
See here for the past Revision History for E-Commerce Kit.

Note 245-05: (DevEnv) Added support for full-text searches of the documentation [SDK]

Added support for full-text searches of the CTR-SDK documentation.

Note 245-06: (GX) Deleted the `DMPGL` documentation [SDK]

The following documents have been deleted from the package.

DMPGL 2.0 System API Specifications
DMPGL 2.0 Data Manipulation Specifications
DMPGL 2.0 Programming Guide
DMPGL 2.0 Specification

Content from these documents has been integrated into the CTR Programming Manual; please refer to that moving forward.

Note 245-07: (GX) Added the `dmp_FragmentMaterial.emission` Uniform Location value macro [SDK]

Support for dmp_FragmentMaterial.emission was missing from Note 44-39.
Added the new macro, GL_LOC_DMP_FRAGMENTMATERIAL_EMISSION.

Note 245-08: (GX) Made revisions to the shader assembler tool [SDK]

A previous update to the shader linker tool, ctr_VertexShaderLinker32, produced log output at build that was unnecessary.
This bug was fixed.

Note 245-09: (HID) Deleted the nn::hid::AccelerometerReader::SetOffsetFromBaseStatus function [SDK | Sample Demos]

In conjunction with the new prohibition against the proprietary setting of the horizontal offset for the accelerometer within applications, the SetOffsetFromBaseStatus function was deleted.
Relevant features were also deleted from SampleDemos.

Note 245-10: (HIO) Updated the hio Library for IS-CTR-DEBUGGER. [SDK]

The hio library for IS-CTR-DEBUGGER was updated to version 20130809.

Note 245-11: (HIO) Improved the `nn::hio::Initialize` function [SDK]

Added support for using the nn::hio::Initialize function from the nninitStartUp function.

Note 245-12: (IR) Made changes so the infrared communication feature appears in the list of middleware in CTR Master Editor [SDK]

When applications using infrared communication features are read into CTR Master Editor, made it such that they are displayed in the middleware list as using some of the following. NINTENDO:Ir, NINTENDO:IrCommunicator or NINTENDO:ExtraPad

Note 245-13: (IR) Deleted the feature for specifying the baud rate for communication [SDK | Sample Demos]

Deleted the baudrate argument from the nn::ir::Communicator::Initialize function, which specified the infrared baud rate.
The baud rate for communication is fixed at 115,200.
In conjunction with this, deleted the relevant features from SampleDemos.

Note 245-14: (MATH) Fixed a bug in which the `SinFIdx`, `CosFIdx`, and `SinCosFIdx` functions would hang if passed a large number [SDK]

Fixed a bug in which the SinFIdx, CosFIdx and SinCosFIdx functions would block internally when passed an extremely large number as an argument.

Note 245-15: (MII) Integrated structures that handle Mii StoreData [SDK]

Added the nn::mii::StoreData structure, and made changes such that it can be used laterally as the definition of Mii StoreData as handled by the friend presence library and Face Library.
Doing so eliminates the need for casting between libraries, and makes it possible to pass and receive Mii information.
The former type names have been re-defined as typedef identifiers and macros to maintain application build compatibility.

Note 245-16: (PL) Fixed a bug that added artifacts to the drawing results by the `RectDrawer` class. [SDK]

Artifacts appeared in the drawing results when drawing with the RectDrawer class due to a failure to properly add a command to clear the framebuffer cache to the commands that were being executed.
This bug was fixed.

Note 245-17: (SND) Added an ASSERT to the buffer passed to the `SetupBcwav` and `AppendWaveBuffer` functions [SDK]

Changed it such that the nn::snd::CTR::Voice::SetupBcwav and nn::snd::CTR::Voice::AppendWaveBuffer functions will end in an ASSERT if the address of the waveform buffer passed as an argument to them is in device memory.

Note 245-18: (TOOL) Added a feature to BossLotcheckTool for checking the StreetPass Relay feature [SDK | System Updater]

Added a feature to BossLotcheckTool for testing the StreetPass Relay feature.

Note 245-19: (TOOL) Fixed a bug in the RSF Rom/Include [SDK]

Fixed a bug where ctr_makerom32 fails in an error when a file not specified in Rom/Include exists in the ROMFS.

Note 245-20: (TOOL) Fixed a bug related to the `ctr_TexturePackager` tool's custom mipmaps [SDK]

Fixed the following problems specific to custom mipmaps for ctr_TexturePackager32.exe.

A bug where processes are interrupted because memory was illegally deallocated internally when specifying a custom mipmap.
A bug where error checking is not normally occurring for miplevel and other attributes for textures number 2 and higher.

Known Issues with SDK 7.0.0 Release

FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used.
A large font size is set. (The size that causes the problem could vary depending on the font.)
Two levels of gradation are set for the number of gradations under Advanced Settings (applies to both the A4 and LA4 settings).

■ CTR-SDK Version 7.0.0 System Updater 0.20.0

(2013/08/23)

Note 244-01: (APPLET) Added a function for setting posting permissions for the screenshots obtained by the system [SDK | System Updater]

Note 244-02: (BOSS) Fixed a bug that occurred when tasks running in the background were instructed to run in the foreground [System Updater]

Fixed a bug that occurred when tasks consigned to run on a background schedule were instructed to run immediately in the foreground and subsequently did not run correctly in the foreground.

Note 244-03: (BOSS) Split up the `nn::boss::TaskResultCode` codes for DataStore upload and download tasks [SDK | System Updater]

Note 244-04: (DevEnv) Fixed a bug in which an error would occur when operating buttons in the development menu [System Updater]

Fixed a bug that resulted in a fatal error when operating buttons after loading an application via the debugger.

Note 244-05: (HID) Fixed an extremely rare bug in which the system would fail to get input from the touch screen or buttons [System Updater]

Fixed an extremely rare failure to get input from the touch screen, HOME Button or other buttons.

Note 244-06: (TOOL) Added a feature to BossLotcheckTool for checking the StreetPass Relay feature [SDK | System Updater]

Added a feature to BossLotcheckTool for testing the StreetPass Relay feature.

Known Issues with SDK 7.0.0 System Updater 0.20.0

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

CTR-SDK Version 7.0.0 Sample Demos

(2013/08/23)

Note 243-01: (DevEnv) Integrated E-Commerce Kit [SDK | Sample Demos]

Integrated the content of E-Commerce Kit into this package.
See here for the past Revision History for E-Commerce Kit.

Note 243-02: (GX) Eliminated use of uninitialized values in vertex shaders. [Sample Demos]

The vertex shader assemblers in a number of sample demos under demo2 and gx were implemented to use uninitialized components for some registers, and this caused the shader linker tool to output warnings.
This bug was fixed.

Note 243-03: (HID) Deleted the nn::hid::AccelerometerReader::SetOffsetFromBaseStatus function [SDK | Sample Demos]

Note 243-04: (IR) Deleted the feature for specifying the baud rate for communication [SDK | Sample Demos]

Known Issues with SDK 7.0.0 Sample Demos

None.

CTR-SDK Version 6.1.0 System Updater 0.19.48

(2013/08/07)

Note 242-01: (CEC) Added support for the StreetPass Relay feature [System Updater]

Added support for the StreetPass Relay feature.
The StreetPass Relay feature is one that performs StreetPass communication using SpotPass communication.
Games using StreetPass can use this new feature without the need to change program code or to contact Nintendo.
A development environment and detailed documentation will be released at a later date. Until then, direct your questions to Nintendo.

Known Issues With the SDK 6.1.0 System Updater 0.19.48

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

CTR-SDK Version 6.1.0 System Updater 0.19.16

(2013/06/28)

Note 241-01: (OS) Made revisions to make the system more stable [System Updater]

Made revisions to improve system stability.
These changes do not affect the behavior of the application.

Known Issues With SDK 6.1.0 System Updater 0.19.16

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

CTR-SDK Version 6.1.0 Release

(2013/06/21)

Note 240-01: (CRYPTO) Removed API references for classes that can no longer be used [SDK]

Removed the documentation for classes that can no longer be used from the API reference.

Note 240-02: (FS) Added a reference related to the save data rollback prevention feature [SDK]

Added a page summarizing the save data rollback prevention feature in the API reference.
To support this addition, also revised the existing API references where necessary.

Note 240-03: (FS) Added an API function related to the save data rollback prevention feature [SDK | System Updater]

Added API related to the save data rollback prevention feature that specifies an archive name.
It is now possible to overwrite the SecureValue value for the save data of other titles.
For details. see File System: Save Data Rollback Prevention Support Feature in the API reference.

Note 240-04: (GD) Deleted the known issues for the GD `LightingSample` demo [SDK]

Deleted a description of a previously resolved issue for the GD LightingSample demo from the SDK Known Issues section. (The areas being lit would blink periodically, but this issue was resolved as described in Note 190-04.)

Note 240-05: (GD) Fixed a bug in determining whether the state update for the `VertexInputStage::SetIndexBuffer` function had been skipped [SDK]

Fixed a bug when using the GD library for rendering where the process for updating the settings in the nn::gd::CTR::VertexInputStage::SetIndexBuffer function was skipped if used to repeatedly render vertices with the same index buffer address and different m_MemAddr's for their respective resources.

Note 240-06: (GR) Made the `gr::FrameBuffer::MakeClearRequest` function into a const function [SDK]

Within the old gr::FrameBuffer::MakeClearRequest function, the value of the depthStencilBuffer.clearDepth member variable was directly clamped and changes to the value occurred.
Changed such that clamping would be performed on a local variable, and that this function would become a const function.

Note 240-07: (GX) Updated the shader assembler tool [SDK]

Enhanced the linker's warning features.
Added a pragma to suppress some linker warnings.

Note 240-08: (GX) Fixed a bug with drawing open edges in the silhouette shader [SDK]

Fixed a bug that resulted in misalignment of open edge silhouette coordinates so they were not connected smoothly.

Note 240-09: (GX) Updated documentation [SDK]

The following updates were made to the GX documentation.

DMPGL20_specification.pdf

Added a description of operations when the alpha component is referenced for a texture that does not have an alpha component.
Added a description of operations when a disabled texture unit is referenced.
Corrected an incorrect description of how to set dmp_Silhouette.openEdgeWidth.
Corrected an incorrect description of the effect of dmp_Silhouette.openEdgeDepthBias.

DMPGL20_system_API_specification.pdf

Added a description of address alignment in texture memory.
Added that RGB888 textures cannot be used on cube maps.
Deleted an incorrect description of busy counter parameters, which stated that the profiling time setting had no effect on operations when the profiling count was 0.

VertexShaderReferenceManual.pdf

Enhanced the linker's warnings. Added features for specifying warning levels and for checking consistency.
Added a pragma directive to suppress_linker_warning_level2_level3.

Note 240-10: (HIO) Made working memory specification changes [SDK]

Made it such that it will work even when working memory is not specified.

Note 240-11: (OS) Finalized performance improvements [SDK]

The performance improvements described in Note 221-11 have been extended to System Updater 0.18.16.
Applications using CTR-SDK 5.2 and later can take advantage of the performance improvements in System Updater 0.18.16.

Note 240-12: (RO) Fixed a bug in which exceptions would occur in the `nn::ro::GetAddress` function [SDK]

Fixed a bug in which exceptions would occur when the nn::ro::GetAddress was called.

Note 240-13: (TOOL) Fixed a bug where `makecro` generated invalid `cro` files [SDK]

Fixed a bug where the ctr_makecro32.exe tool generated invalid CRO files, which caused the system to hang when they were unloaded and the nn::ro::GetAddress function to throw an exception. This bug was fixed.

Note 240-14: (TOOL) Fixed a bug where an invalid warning was being output by `makecro` [SDK]

Fixed a bug where ctr_makecro32.exe output an invalid warning if a field width was specified with any of the printf family of functions.

Note 240-15: (TOOL) Fixed a bug in the replacement of unresolved symbols in the `makecro` tool [SDK]

Fixed a bug that caused overwriting of data in invalid locations when ctr_makecro32.exe replaced unresolved symbols.

Note 240-16: (TOOL) Fixed a bug where the destructors for static objects of export type index or offset in the `ro` module were not called [SDK]

Fixed a bug where the destructors for static ro objects of export type index or offset were not called even when the nn::ro::Module::DoFinalize function was called.

Known Issues with SDK 6.1.0 Release

FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used.
A large font size is set. (The size that causes the problem could vary depending on the font.)
Two levels of gradation are set for the number of gradations under Advanced Settings (applies to both the A4 and LA4 settings).

CTR-SDK Version 6.1.0 System Updater 0.19.6

(2013/06/21)

Note 239-01: (FS) Added an API function related to the save data rollback prevention feature [SDK | System Updater]

Note 239-02: (HOME Menu) Support for save data backup [System Updater]

When the user moves the cursor over an SD card application that supports save-data backups, a triangular button appears on the lower left of the screen. The user can click this button to create a backup of the application's save data.

Note 239-03: (System Settings) Support for save data backup [System Updater]

It is now possible to create, restore, and delete backups from the Data Management application, under 3DS Data Management > Save-Data Backup.
It is now also possible to create a backup of save data when deleting software. (It will be restored when the software is re-installed.)

Note 239-04: (System Settings) Support for brightness settings in the System Settings [System Updater]

It is now possible to adjust the screen brightness from System Settings, under Other Settings, by tapping the upper-left button. Before, it was only possible to adjust the screen brightness from the HOME Menu.

Known Issues With SDK 6.1.0 System Updater 0.19.6

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

CTR-SDK Version 6.1.0 Sample Demos

(2013/06/21)

Note 238-01: (CAMERA) Fixed a bug where the correction matrix was not configured correctly [Sample Demos]

Fixed a bug where the correction matrix used for drawing in the CAMERA sample demo was not configured correctly.

Known Issues with SDK 6.1.0 Sample Demos

None.

CTR-SDK Version 6.0.1 System Updater 0.19.3

(2013/05/20)

Note 237-01: (RO) Fixed a bug where system could hang during load operations [System Updater]

There was a bug where the system could hang if any of the functions in Group 1 was called while any of the functions in Group 2 was called at the same time, on a separate thread.
Group 1:

nn::ro::Initialize
nn::ro::Finalize
nn::ro::RegisterList
nn::ro::LoadModule
nn::ro::RegistrationList::Unregister
nn::ro::Module::Link
nn::ro::Module::Unlink
nn::ro::Module::Unload

Group 2:

nn::os::StackMemory
The Initialize or Finalize (member) functions on nn::uds, nn::dlp, or nn::ir
nn::mic::SetBuffer
nn::mic::ResetBuffer

This bug was fixed.

Known Issues with SDK 6.0.1 System Updater 0.19.3

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

CTR-SDK Version 6.0.1 Release

(2013/04/23)

Note 236-01: (DSP) Added feature for sound output from speakers when the system is closed [SDK | System Updater]

Added the nn::snd::CTR::SetHeadphoneOutOnShellClose function to output sound to the speakers when the system is closed and Sleep Mode is blocked.

Note 236-02: (FND) Fixed the `assert` in `nn::fnd::UnitHeapTemplate::Initialize` [SDK]

Fixed a bug where the nn::fnd::UnitHeapTemplate::Initialize function would end on an assert when called with a 0 for the size argument.
In this instance, it is initialized with the unit heap from which no allocation can occur.

Note 236-03: (FS) Added a way to set permissions for save data/expanded save data access [SDK | System Updater]

Added AccessControlInfo and AccessableSaveDataIds as settings to the RSF file to support access to another person's save data and for access two or more expanded save data.
Use of these enables access to a maximum of six other save data or expanded save data besides your own.
For more information, see the ctr_makerom reference page.

Note 236-04: (TOOL) Fixed a bug where `BannerModelConverter`, `make_ex_banner`, and `makedlexbanner` threw an exception and crashed [SDK]

Fixed a bug where the following tools threw an exception and crashed because of the change described in Note 230-07.

BannerModelConverter
make_ex_banner
makedlexbanner

Known Issues with SDK 6.0.1 Release

In the GD LightingSample demo, the area where light shines sometimes flashes in cycles.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used.
A large font size is set. (The size that causes the problem could vary depending on the font.)
Two levels of gradation are set for the number of gradations under Advanced Settings (applies to both the A4 and LA4 settings).

CTR-SDK Version 6.0.1 System Updater 0.19.1

(2013/04/23)

Note 235-01: (DSP) Added feature for sound output from speakers when the system is closed [SDK | System Updater]

Added the nn::snd::CTR::SetHeadphoneOutOnShellClose function to output sound to the speakers when the system is closed and Sleep Mode is blocked.

Note 235-02: (FS) Added a way to set permissions for save data/expanded save data access [SDK | System Updater]

Known Issues with SDK 6.0.1 System Updater 0.19.1

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

CTR-SDK Version 6.0.1 Sample Demos

(2013/04/23)

Note 234-01: (SND) Added the `SpeakerOutOnShellClose` sample demo [Sample Demos]

Added a sample demo to play sound from the speakers while the system is closed.

Known Issues with SDK 6.0.1 Sample Demos

None.

CTR-SDK Version 6.0.0 Release

(2013/04/11)

Note 233-01: (DevEnv) Removed a revision history that is no longer needed from the change log for CTR-SDK 5.0 Sample Demos [SDK]

Removed a revision history that is no longer needed from the change log for CTR-SDK 5.0 Sample Demos.

Known Issues with SDK 6.0.0 Release

In the GD LightingSample demo, the area where light shines sometimes flashes in cycles.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used.
A large font size is set. (The size that causes the problem could vary depending on the font.)
Two levels of gradation are set for the number of gradations under Advanced Settings (applies to both the A4 and LA4 settings).

CTR-SDK Version 6.0.0 System Updater 0.19.0

(2013/04/11)

Note 232-01: (APPLET) Fixed a bug where the system sometimes failed to enter Sleep Mode when a library applet was starting [System Updater]

Fixed a bug where the system would sometimes not go into Sleep Mode correctly when closed when a library applet was starting.

Note 232-02: (CAMERA) Fixed a bug where an `Event` object obtained from the `GetVsyncInterruptEvent` and `GetBufferErrorInterruptEvent` functions was in the `Signal` state [System Updater]

Fixed a bug where an event obtained from the GetVsyncInterruptEvent or GetBufferErrorInterruptEvent function could be in the Signal state, depending on the application that used the camera the last time it was started, even if the application had not used the camera yet.

Note 232-03: (CAMERA) Reduced power consumption when camera is in standby [System Updater]

Modified the camera's internal settings so that it consumes less power when in standby.

Note 232-04: (CEC) Fixed a bug where `SetActivateBox` settings were not reflected immediately [System Updater]

Fixed a bug where MessageBox::SetActivateBox settings were not reflected immediately.

Note 232-05: (CEC) Fixed a fatal error that occurred when canceling communication [System Updater]

Fixed a bug where a fatal error would occur (RSL: 0xD8E007F7 Level: -5 Summary: 7 Module: 1 Desc: 1015) when canceling communication at the same time as finding a communication partner (including when transition to or waking up from Sleep Mode).

Note 232-06: (UDS) Fixed a bug where the `nn::uds::ConnectNetwork` function would fail to return for a prolonged period [System Updater]

Fixed a bug where the nn::uds::CreateNetwork function would fail to return for some time if called immediately after the nn::uds::ConnectNetwork function.

Known Issues with SDK 6.0.0 System Updater 0.19.0

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 5.2.0 System Updater 0.18.16

(2013/04/01)

Note 231-01: (OS) Added a process for recovering from internal inconsistencies during updates [System Updater]

Added a process for recovering from internal system inconsistencies resulting from errors occurring during system updates.

Known Issues With SDK 5.2.0 System Updater 0.18.16

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 5.2.0 Release

(2013/03/26)

Note 230-01:(CFG) Added a note about the `GetUserTimeOffset` function. [SDK]

Depending on the system version of the 3DS, using System Transfer may cause data and software to be transferred with unintentional changes to the variable RTC modification offset value.
This fact has been added to the reference.

Note 230-02:(DevEnv) Added the environment variable `CTRSDK_BUILD_ROOT`. [SDK]

The variable CTRSDK_BUILD_ROOT has been added to the CTR-SDK build system.
To use your own build system, set the corresponding directory in this variable.

Note 230-03:(FND) Revised `nn::fnd::UnitHeapTemplate<LockPolicy>::Allocator::Allocate` class template member functions.[SDK]

Fixed a bug where the nn::fnd::UnitHeapTemplate<LockPolicy>::Allocator::Allocate class template member functions could not be built.

Note 230-04:(GR) Added the ability to handle warnings of the `FragmentLight::Source::SetDistAttnScaleBiasDirectly` function. [SDK]

The FragmentLight::Souce::SetDistAttnScaleBiasDirectly function was revised to use type casting. Some compilers were issuing warnings because the function was assigning float values of the argument to member variables without casting.

Note 230-05:(OS) Fixed a bug where the `AutoStackManager` implementation would not run on the `small` build. [SDK]

Fixed a bug where nn::os::SimpleAutoStackManager and nn::os::StackMemoryAutoStackManager were not running correctly on small builds.

Note 230-06:(TOOL) Buffed the SD card write functionality of `SaveDataFiler`. [SDK]

Changed specifications so that a detailed log is output about the range of save data that was ripped normally and the range of save data that was destroyed when writing save data to an SD card.
The data is output as the export.log file found in the folder named as the date and time saved. This file can be viewed on a PC.

Note 230-07:(TOOL) Added a save data backup feature incompatibility flag to `makebanner`. [SDK]

A save data backup feature incompatibility flag was added to makebanner.

Note that this change is an added feature for future save data backup support. The save data backup feature itself cannot currently be used.

Note 230-08:(TOOL) Fixed a bug where an invalid warning was being output by `makecro`. [SDK]

Fixed a bug where ctr_makecro32.exe output an invalid warning if a field width was specified with any of the printf family of functions.

Note 230-09:(TOOL) Made `makecro` merging faster. [SDK]

Merging when using the -c and -m options with ctr_makecro32.exe could take a long time. Speed was improved.

Note 230-10:(TOOL) Updated the shader assembler tool. [SDK]

The ctr_VertexShaderAssembler32.exe shader assembler tool has been replaced with the one in the geometry shader SDK package that is distributed separately.
This tool enables you to assemble geometry shader files.

For more information about geometry shaders, see the geometry shader SDK.
It has no particular effect on assembling vertex shaders.
The version number is 2.22 GS.

Note 230-11:(TOOL) Fixed a bug where `ctr_makeMetaDataContent32` would result in an error depending on the value of the TMP environment variable. [SDK]

Fixed a bug where ctr_makeMetaDataContent32 resulted in an error if a full-width character was included in the string specified in the TMP environment variable.

Known Issues With SDK 5.2.0 Release

In the GD LightingSample demo, the area where light shines sometimes flashes in cycles.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used.
A large font size is set. (the size that causes the problem could vary depending on the font.)
Two levels of gradation are set for the number of gradations under Advanced Settings (applies to both the A4 and LA4 settings).

■ CTR-SDK Version 5.2.0 System Updater 0.18.5

(2013/03/26)

Note 229-01:(TOOL) Revised termination of the `Config` tool. [System Updater]

Fixed a bug where the Config tool would not terminate even if you pressed the POWER Button after starting the Config tool.

Note 229-02:(Internet Browser) Updated the Internet Browser. [System Updater]

The Internet Browser was updated to the latest version.
This change has no effect on application development.

Note 229-03:(Game Memo) Fixed a bug where the canvas would flicker after erasing an effect. [System Updater]

Fixed a bug where the canvas would occasionally flicker after erasing an effect. It occurred when the cache was not being flushed correctly after drawing and erasing lines or completely erasing a memo when using a thumbnail texture.

Known Issues With SDK 5.2.0 System Updater 0.18.5

For more information about known issues with System Updater, see the Symptoms of Known Issues file in the CTR-SDK.

■ CTR-SDK Version 5.2.0 Sample Demos

(2013/03/26)

Note 228-01:(DLP) Updated the Sample Demos reference. [Sample Demos]

Fixed a bug where the screenshot shown in the Sample Demos reference for DLP did not match the description.

Known Issues With SDK 5.2.0 Sample Demos

None.

■ CTR-SDK Version 5.1.1 System Updater 0.18.2

(2013/02/15)

Note 227-01:(OS) Fixed a bug where the top and bottom of the screen turned red because of socket communication or another process. [System Updater]

Fixed a bug where the screen turned red at the top and bottom and then froze if more than one thread attempted to perform socket communication in parallel.

Known Issues With System Updater 0.18.2 in SDK Version 5.1.1

For more information about known issues with System Updater, see the Symptoms of Known Issues file in the CTR-SDK.

■ CTR-SDK Version 5.1.1 Release

(2013/02/13)

Note 226-01:(TOOL) Changed the ROM format. [SDK]

Some changes were made to the ROM format generated by makerom.
This change has no effect on the development and operations of the applications.

Known Issues With SDK 5.1.1 Release

In the GD LightingSample demo, the area where light shines sometimes flashes in cycles.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used.
A large font size is set. (The size that causes the problem could vary depending on the font.)
Two levels of gradation are set for the number of gradations under Advanced Settings (applies to both the A4 and LA4 settings).

■ CTR-SDK Version 5.1.0 Release

(2013/02/07)

Note 225-01: (DevEnv) Fixed a bug that caused the AXF file to sometimes not rebuild when changed if its size exceeded 8 MB. [SDK]

If a DLL build is implemented while the AXF file size exceeds 8 MB, the rebuilding might not occur even if dependent files have been changed. This problem has been fixed.

Note 225-02: (DevEnv) Fixed a bug that caused the assembly code not to compile. [SDK]

Assembly source compiling stopped occurring because of the effects of Note 222-04. This problem has been fixed.

Note 225-03: (GD) Fixed a bug that did not allow the polygon offset settings to be made when configuring the depth buffer from another library. [SDK]

When configuring a depth buffer with an external library such as NintendoWare for CTR, if you entered the polygon offset values with the GD library, it divided by 0 without referencing the depth buffer format information within the GD library. This bug has been fixed.
Also, added a description about the change in behavior caused by the depth buffer bit count, as it concerns the argument offset of the OutputStage::SetDepthRangeMode function.

Note 225-04: (GR) Added `nn::gr::RenderState::COLOR_MASK_NONE`. [SDK]

Added the setting value, nn::gr::RenderState::COLOR_MASK_NONE, which masks all RGBA components.

Note 225-05: (GR) Fixed a bug that caused 128 not to be usable as the upper limit for embedded swizzle patterns. [SDK]

There were bugs in the GR library's Shader and ShaderLite classes such that when you attempted to use 128 swizzle patterns, the upper limit according to specifications, you would get caught by an assert.
This bug was fixed.

Note 225-06: (GX) Updated the DMPGL 2.0 specifications document. [SDK]

Added an item called "Rasterization Rules" to the DMPGL 2.0 specifications (DMPGL20_specification.pdf).

Note 225-07: (HIO) Updated the hio Library for IS-CTR-DEBUGGER. [SDK]

The hio library for IS-CTR-DEBUGGER was updated to version 20121003.

Note 225-08: (MIC) Fixed a bug that caused the loss of data at the end of the ring buffer during sampling. [SDK | System Updater]

Fixed a bug that caused the loss of two data samples at the end of the buffer specified by the nn::mic::CTR::SetBuffer function during sampling.
For applications built before using the CTR-SDK package, there is no compatibility effect because, as before, there are no operations that cause loss of data.

Note 225-09: (SND) Fixed a bug that rarely caused no return from the `WaitForDspSync` function after a restore from Sleep Mode. [SDK]

Fixed a bug that on occasion halted sound and did not return from the WaitForDspSync function upon restoring from the Sleep Mode.

Note 225-10: (SOCKET) Made `nn::socket::GetMacAddress` private. [SDK]

Made nn::socket::GetMacAddress public for purposes such as debugging and verifying communications within LANs; however, we have made it a private function to prevent its wrongful use.
If you need to use it with your product, please consult with our support department.

Note 225-11: (TOOL) Fixed a bug that caused the CCL file not to load. [SDK]

Fixed a bug that caused the CCL file not to load in CTR-SDK 5.0.

Note 225-12: (TOOL) Added the vertex cache simulator tool. [SDK]

Added the command line tool, ctr_VertexCacheSimulator32.exe, which simulates the vertex cache of the CTR GPU.

Known Issues With SDK 5.1.0 Release

In the GD LightingSample demo, the area where light shines sometimes flashes in cycles.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used.
A large font size is set. (the size that causes the problem could vary depending on the font.)
Two levels of gradation are set for the number of gradations under Advanced Settings (applies to both the A4 and LA4 settings).

■ CTR-SDK Version 5.1.0 System Updater 0.18.1

(2013/02/07)

Note 224-01: (AC) Fixed a bug that allowed an error in determining the requested EULA version during access point connection. [System Updater]

Fixed a bug that made it possible to mistake the requested EULA version and return nn::ac::ResultNotAgreeEula when connecting to an access point using the nn::ac::Connect and nn::ac::ConnectAsync functions.

Note 224-02: (AC) Hashed pre-shared key handling for the `DebugSetNetworkSetting1` function. [System Updater]

Made changes so that if a 64-character key is specified when entering WPA security settings, it is interpreted as a hashed pre-shared key.

Note 224-03: (CEC) Added a connection denial function based on the blocked-user list. [System Updater]

Made a change so that if the other party to a communication is registered in the blocked-user list, the communication terminates without sending or receiving data.
However, note that if this change has not been applied to a console, communication occurs as always.
The guidelines and method of operation have not changed for the blocked-user list.
This change actually occurred in CTR-SDK 5.0 but was accidentally omitted from the change log.

Note 224-04: (DevEnv) Fixed a bug that caused the POWER Button to get stuck when repeatedly tapping it in the development menu. [System Updater]

Fixed a bug that caused the POWER Button to sometimes stick when repeatedly tapping it when the application ended and you returned to the development menu.

Note 224-05: (MIC) Fixed a bug that caused the loss of data at the end of the ring buffer during sampling. [SDK | System Updater]

Note 224-06: (OS) Fixed a bug with the light-series time-out API. [System Updater]

Fixed a bug that caused internal status of the thread for nn::os::LightEvent::TryWait(nn::fnd::TimeSpan) and nn::os::LightSemaphore::TryAcquire(nn::fnd::TimeSpan) to become illegal.

Note 224-07: (OS) Fixed the problem that caused hanging when starting the debugger and putting it to sleep without connecting it to the debugger software. [System Updater]

Fixed the problem that caused hanging when starting the debugger and putting it to sleep without connecting it to the debugger software.

Note 224-08: (TOOL) Fixed the problem in the DevMenu that did not allow imported add-on content to be mounted. [System Updater]

Fixed a bug that caused improper mounting when the variation from DevMenu imported two add-on contents.

Known Issues With System Updater 0.18.1 in SDK Version 5.1.0

For more information about known issues with System Updater, see the Symptoms of Known Issues file in the CTR-SDK.

■ CTR-SDK Version 5.1.0 Sample Demos

(2013/02/07)

Note 223-01: (GR) PointSprite Revisions [Sample Demos]

Although Gr/PointSprite is a sample demo based on DMPGL/PointSprite, it had the following differences. This situation has been fixed.

The texture combiner srcAlpha has been changed to texture color.
Culling has been enabled.
Blending has been enabled.

In spite of the fact that in the previous Gr/PointSprite primary colors had been configured for the combiner srcAlpha, no vertex colors were exported from the geometry shader. For that reason, the situation was unstable, as the rendering results depended on setting values that remained in the hardware.

Note 223-02: (GX) PointSprite Revisions [Sample Demos]

In the DMPGL/PointSprite sample, DMP_pointSprite1_1.obj was being used as a reserved geometry shader, but that has been changed to DMP_pointSprite0_1.obj, because the number of vertex attributes (previous number) that the vertex shader actually exports was redundant.

Known Issues With SDK 5.1.0 Sample Demos

None.

■ CTR-SDK Version 5.0.0 Release

(2012/12/18)

Note 222-01: (CAMERA) Fixed an Issue Where the Camera Was Being Deactivated If the HOME Button Was Pressed Repeatedly [SDK]

The camera became deactivated if the HOME Button was pressed repeatedly while running the demo1 or camera demo from DevMenu. This bug was fixed.

Note 222-02: (DSP) Fixed a Bug Where It Took a Long Time to Return From the `nn::snd::WaitForDspSync` Function [SDK]

If it took more than about 8 seconds from a call to the nn::snd::Initialize function to a call to the nn::snd::SendParameterToDsp function and then nn::snd::WaitForDspSync was called, it took several seconds to return. This bug was fixed.
(This fix involved revising the nn::dsp::LoadDefaultComponent function.)

Note 222-03: (DevEnv) Updated the Version of the Compiler Used to Build the CTR-SDK Package [SDK]

The compiler used to build the CTR-SDK package has been updated to version ARMCC 4.1 b1049 20121026.

Note 222-04: (DevEnv) Added Support for the `-J` Compiler Option [SDK]

Previously, use of the -J compiler option was prohibited. This option can now be used freely.
It is also now possible to specify the -J option for the SDK include directory when using the SDK build system.

Note 222-05: (DevEnv) Adjusted Suppression of the Compiler Warnings [SDK]

Compiler warnings suppression can now be controlled using ARMCC #pragma push/pop inside the SDK header.
We have also added the following compiler interpretation as something you can suppress in the SDK build system.

2819: class "xxx" has an implicitly instantiated key function "xxx"

Note 222-06: (DevEnv) Fixed a Bug Where a Rebuild Was Not Triggered by Changing the Shader Assembly Header File [SDK]

A rebuild was not being generated if a header file included in a shader assembly source file was changed. This bug was fixed.

Note 222-07: (DevEnv) Added Support for `LDFLAGS_INFO` to the Build System [SDK]

The SDK build system now supports the LDFLAGS_INFO build variable.
You can control the creation of map files by the linker by changing this variable in an application's OMakefile.

Note 222-08: (ErrEula) Revised Variable Names Defined in the `ErrorType` Enumerated Type [SDK]

To correct a misspelling, the name of one of the variables defined in the ErrorType enumerated type was changed from ERROR_TYPE_ERROR_TEXT_LANGUAGE_WORD_WRAP to ERROR_TYPE_ERROR_TEXT_LANGUAGE_WORD_WRAP.

Note 222-09: (FND) Fixed a Bug Where the `ExpHeap::CheckHeap` Function Did Not Output a Log [SDK]

Fixed a bug where options specified to the ExpHeap::CheckHeap function were not working correctly and the corruption status of the expanded heap was not being correctly output to the log window.

Note 222-10: (GR) Added the `FragmentLight::Source::SetDistAttnScaleBiasDirectly` Function [SDK]

Added a function for setting the distance attenuation bias and scale without performing 20-bit floating point conversion, in contrast with the FragmentLight::Source::SetDistAttnScaleBias function.

Note 222-11: (GR) Revised the Color Buffer Read Access Control Determination [SDK]

Although there are cases when you may want to cut off read access to the color buffer if DST color is not being used during blending or in logical operations, specifications of the gr::FBAccess::MakeCommand function were not suited to this use.
The ability to determine whether DST color is being used has been added.

Note 222-12: (GX) Fixed a Bug Where the Number of Main Vertices Was Not Being Set Correctly by the GR Library When Using a Geometry Shader [SDK]

Fixed a bug where the value specified by #pragma gs_main_vertex_num in the assembly code for geometry shaders was not being correctly applied even for commands that generate the gr::ShaderLite class, not just the gr::Shader class.

Note 222-13: (GX) Added the `gr::FragmentLight::Source::MakeAttitudeCommand` Function [SDK]

The gr::FragmentLight::Source::MakeAttitudeCommand function was added for generating only commands related to spotlight orientation and light source positioning.
Commands that generate this function are included in those generated by the gr::FragmentLight::Source::MakeGeometryCommand function.

Note 222-14: (HIO) Updated the hio Library for IS-CTR-DEBUGGER [SDK]

The hio library for IS-CTR-DEBUGGER was updated to version 20121003.

Note 222-15: (MATH) Changed the `VEC2::` and `VEC4::DistanceSquare` Functions to Be `const` Member Functions [SDK]

Changed the VEC2:: and VEC4::DistanceSquare functions to be const member functions.
The VEC3::DistanceSquare function was already a const member function.

Note 222-16: (MATH) Added the `Vector3` Constructor That Takes `Vector2` as an Argument [SDK]

A new constructor for Vector3 objects that takes Vector2 objects as arguments has been added.
If a Vector2 object is specified as an argument, 0 is assigned to the z component of the newly generated Vector3 object.

Note 222-17: (OS) Improved Error Checking of `Event`, `Mutex`, `Semaphore`, and `Timer` Initialization Functions [SDK]

Specifications have been revised so that a check is made whether initialization has been performed using the Initialize or TryInitialize functions for Event, Mutex, Semaphore, and Timer.
The Finalize function must be called first before reinitializing.

Note 222-18: (RDT) Changed Namespaces and Directories to Be Independent of the Platform [SDK]

The following changes were made:

Changed the location of header files.

$CTR_SDK/include/nn/rdt/CTR -> $CTR_SDK/include/nn/rdt

Changed the location of source code.

$CTR_SDK/sources/libraries/rdt/CTR -> $CTR_SDK/sources/libraries/rdt

Changed the following namespace.

nn::rdt::CTR -> nn::rdt

Note 222-19: (TOOL) Fixed a Bug Where System Updater Did Not Terminate If the POWER Button Was Pressed When Not Connected to DevMenu [SDK | System Updater]

Fixed a bug where it should have been possible to exit DevMenu by pressing the POWER Button when DevMenu was stopped by the HOME Button, but the system waited for termination instead.

Note 222-20: (TOOL) Revised `ctr_makeciaarchive32.exe` [SDK]

Fixed a bug where an insufficient memory error occurred if the CIA entered was too large.

Known Issues With SDK 5.0.0 Release

In the GD LightingSample demo, you will see a phenomenon in which the area where light shines flashes in cycles.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used
A large font size is set (the size that causes the problem could vary depending on the font)
Two levels of gradation are set for the number of gradations under Advanced Settings (applies to both the A4 and LA4 settings)

■ CTR-SDK Version 5.0.0 System Updater 0.18.8

(2012/12/18)

Note 221-01: (CAMERA) Fixed a Bug Where the Frame Rate Became Unstable [System Updater]

Fixed a bug where the length of frames differed from the value specified when a fixed frame rate was set in an environment where image brightness was unstable (such as when it would suddenly go dark).

Note 221-02: (DSP) Improved a Condition Where Sounds Skipped When Using the snd Library [System Updater]

Fixed a bug where sounds skipped in snd because of execution latency of the firmware.

Note 221-03: (DevEnv) Changed the Way that Power Interruptions Are Determined on DevMenu [System Updater]

Previously, you had to hold down the POWER Button to turn off console power in DevMenu. Now, you can turn off power by tapping the POWER Button if the application is not stopped.

Note 221-04: (DevEnv) Fixed a Bug Where the Execution Stopped When Starting an Application With the System Closed When DevMenu Is Running [System Updater]

Fixed a bug where the application did not run normally and stopped if started from DevMenu with the system closed.

Note 221-05: (FS) Fixed a Bug Where the Value Obtained for the Available Memory on an SD card Was Less Than Was Actually Available [System Updater]

The available space on an SD card as obtained using the nn::fs::GetSdmcSize function was sometimes 1 to 256 clusters less than the actual space available. This bug was fixed.

Note 221-06: (FS) Fixed a Bug Where the Previous Version of a Downloaded Application Ran Even If It Was Overwritten (updated) [System Updater]

Fixed a bug where the previous version of a download application ran even if it was overwritten (updated).

Note 221-07: (OS) Fixed a Bug Where the System Froze If the Start Address of VRAM Being Read Was Not on a Page Boundary When Using the Debugger [System Updater]

Fixed a bug where the system froze if the address in VRAM not located on a page boundary was read first by the debugger.

Note 221-08: (OS) Added Support for Load Errors When Starting Applications in the Debugger [System Updater]

Sends an error notification if the debugger loads an application that has been started from one of the system menus.

Note 221-09: (OS) Fixed a Bug Where the Log Display Order Changed If the Debugger Continued Log Output for an Extended Period [System Updater]

Fixed a bug where the order of log output changed if the debugger was outputting log information at a high frequency for an extended period of time.
This bug occurred more frequently when multiple processes were running in the system core at the same time.

Note 221-10: (OS) Fixed a Bug Where the Debugger Could Not Output a Large Amount of Log Data for Strings Averaging 20 Bytes or Less in Size [System Updater]

Fixed a bug where the debugger did not display log information when an attempt was made to output a large volume of strings averaging 20 bytes or less.

Note 221-11: (OS) Improved Performance [System Updater]

System settings were reviewed to improve overall performance.
Because there is some risk associated with this change, changes may be undone if future problems are identified.
For now, do not implement any software that depends on this new performance.

Note 221-12: (TOOL) Fixed a Bug Where System Updater Did Not Terminate If the POWER Button Was Pressed When Not Connected to DevMenu [SDK | System Updater]

Fixed a bug where it should have been possible to exit DevMenu by pressing the Power Button when DevMenu was stopped by the HOME Button, but the system waited for termination instead.

Note 221-13: (UDS) Fixed a Bug Where the `nowEntry` Member of the `ConnectionStatus` Structure Did Not Match the Actual Number of Connections [System Updater]

Fixed a bug where the value of the nowEntry member of the ConnectionStatus structure obtained using the nn::uds::GetConnectionStatus function did not match the number of systems actually connected when there were repeated disconnects among a lot of systems.

Note 221-14: (UDS) Fixed a Bug Where the `nn::uds::Finalize` Function Sometimes Had Not Yet Returned When Using `STATE_MASTER` [System Updater]

Fixed a bug where control was sometimes not returning from the nn::uds::Finalize function after calling the nn::uds::CreateNetwork function and transitioning to STATE_MASTER.

Note 221-15: (UDS) Fixed a Bug Where the System Froze If WiFi Was Turned Off or the System Entered Sleep Mode While Calling the `nn::uds::DestroyEndpoint` Function [System Updater]

UDS enters communication error status (STATE_ERROR) if the wireless switch is turned off or the system enters Sleep Mode.
If the nn::uds::DestroyEndpoint function was called at this time, it sometimes failed to return. This bug was fixed.

Note 221-16: (UDS) Fixed a Bug Where Masters Were Not Receiving Data After a Client Disconnected With `CONNECTION_LOST` Even If the Connection Was Re-established [System Updater]

If a disconnection occurred when the client's DisconnectReason was CONNECTION_LOST, the master data frame sometimes failed to arrive even after reconnecting and calling the SendTo function. This bug was fixed.

Note 221-17: (UDS) Fixed a Bug Where the Order of Packets Was Changing [System Updater]

Fixed a bug where the order of packets changed if the SendTo function was called repeatedly without specifying the NO_WAIT option.

Note 221-18: (UDS) Fixed a Bug Where Clients Were Disconnecting With `CONNECTION_LOST` in Environments Where the Master Beacon Could Not Reach Them [System Updater]

Fixed a bug where clients sometimes did not disconnect because of CONNECTION_LOST in an environment where the master beacon could not be received if there was repeated disconnection.

Known Issues With SDK 5.0.0 System Updater 0.18.0

For more information about known issues with System Updater, see the Symptoms of Known Issues file in the CTR-SDK.

■ CTR-SDK Version 5.0.0 Sample Demos

(2012/12/18)

Note 220-01: (GR) Removed a Cast to a `math::Vector` Object Having a Different Number of Elements [Sample Demos]

Source code for the gx/Gr/PointSprite and Silhouette samples included code where static_cast was used on Vector classes having different numbers of elements. When casts were being made to vectors having a larger number of elements, the last member of the vector was being read first. This bug was fixed.

Known Issues With SDK 5.0.0 Sample Demos

None.

■ CTR-SDK Version 4.2.5 Release

(2012/12/07)

Note 219-01: (DevEnv) Deleted the `NN_COMPILER_RVCT_VERSION_MINOR` macro [SDK]

Together with the support for the build system's ARMCC, the definition for the NN_COMPILER_RVCT_VERSION_MINOR macro was deleted.

Note 219-02: (GD) Made revisions such that cube map textures cannot be created in the unsupported RGB888 format [SDK]

In CTR, RGB888 format cube maps are unsupported, but there was a bug that enabled them to be specified in the gd library.
This has now been revised such that the ResultInvalidTextureFormat error is returned when an RGB888 format texture is specified in the gd::TextureStage::CreateTextureCube function.

Note 219-03: (GR) Fixed a bug where the number of main vertices was not correctly set when using the geometry shader in the `GR` library [SDK]

There was a bug where the value specified by #pragma gs_main_vertex_num in the assembly code of the geometry shader for commands generated by the gr::Shader class was not reflected correctly. This has been fixed.
When a shader binary is created using #pragma gs_patch_size instead to avoid this bug, note that compatibility will be lost.

Note 219-04: (GR) Fixed notations specific to the specifications for the `gr::MakeDisableAllCommand` API Reference [SDK]

The description for the MakeDisableAllCommand function noted that Scissor-related settings would be disabled, but they were not actually disabled.
This behavior has been made a specification, and the API Reference description revised.

Note 219-05: (GX) Updated documentation [SDK]

The following updates were made to the GX documentation.

DMPGL20_specification.pdf

Specifications for the procedural texture, GL_CLAMP_TO_ZERO_DMP, have been revised
Added a description to the specifications of the procedural texture's shift mode
Added notes regarding the procedural texture's noise control parameters

VertexShaderReferenceManual.pdf

Changed the names of the members in the file format structure

DMPGL20_programming_guide.pdf

The interval of the procedural texture's clamp mode, GL_CLAMP_TO_ZERO_DMP, has been revised
Added Calculations for Texture Combiner's Setting Value, GL_INTERPOLATE
Revised the description in Improved Efficiency for the Vertex Cache

Note 219-06: (MATH) Fixed a bug where an error would result at assembly when instantiating multiple types with the `MTX33Mult` function [SDK]

There was an issue with the assembly code called within the MTX33Mult function (a template function), which would result in a build error when instantiating with multiple types. This has been fixed.

Note 219-07: (OS) Fixed a bug where `AutoStack` would not be released in `ManagedThread` [SDK]

There was a bug where the memory allocated internally would not be deallocated even when the thread ended, when either InitializeUsingAutoStack or TryInitializeUsingAutoStack was used with nn::os::ManagedThread. This has been fixed.

Note 219-08: (SND) Fixed a bug where certain input would prevent returning from the `EncodeAdpcmData` function [SDK]

There was a bug where, depending on the waveform entered, you would not return from the nn::snd::EncodeAdpcmData function. This has been fixed.

Known Issues with the SDK 4.2.5 Release

In the GD LightingSample demo, you will see a phenomenon in which the area where light shines flashes in cycles.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used
A large font size is set (the size that causes the problem could vary depending on the font)
Two levels of gradation are set for the number of gradations under Advanced Settings (this applies to both the A4 and LA4 settings)

At times, camera activation turns off when repeatedly pressing the HOME Button in the application started from the development menu.

■ CTR-SDK Version 4.2.5 Sample Demos

(2012/12/07)

Note 218-01: (GD) Revised `LightingSample2` sample demo [Sample Demos]

The cube map texture was changed from the RGB888 format to the RGBA8888 format.

Known Issues with SDK 4.2.5 Sample Demos

None.

■ CTR-SDK Version 4.2.4 System Updater 0.17.48

(2012/11/14)

Note 217-01: (DevEnv) Updated the Chinese version of the CTR browser [System Updater]

Updated the Chinese version of the CTR browser to the final version.
This change has no effect on application development.

Note 217-02: (System Settings) Fixed a bug where there would be a freeze when pressing the Initialize Reception Blocking Settings button in the China region [System Updater]

In the China region's Data Management screen, there was a bug where the system would freeze after pressing the Initialize Reception Blocking Settings button and once initialization of the reception blocking settings is complete. This has been fixed.

Known Issues with the SDK 4.2.4 System Updater 0.17.48

For more information about known issues with System Updater, see the Symptoms of Known Issues file in the CTR-SDK.

■ CTR-SDK Version 4.2.4 Release

(2012/10/19)

Note 216-01: (CX) Fixed a bug where `zlib` symbol caused collision [SDK]

Fixed a bug where, when using an independently prepared zlib, zlib symbols collided even if libzlib was not added to the link targets.

Note 216-02: (DBG) Fixed a bug where `ExceptionScreen` depended on `ManagedThread` [SDK]

Fixed a place that assumed nn::dbg::CTR::ExceptionScreen would use nn::os::ManagedThread.
However, note that ExceptionScreen might not function properly if ManagedThread is not used because it cannot obtain the range of the stack.

Note 216-03: (GD) Added Gd API reference [SDK]

Added the following to the gd API reference.

Added description of the result that is passed into callback when an error occurs in the gd:Draw function calls.
Added a table for result values and the corresponding functions.

Note 216-04: (GD) Fixed a bug where set value of `RasterizerStage::SetScissor` function would not be applied correctly [SDK]

Fixed a bug where an 8-bit mask was applied to the x-coordinates in the arguments of the SetScissor function, instead of the intended 10-bit mask.

Note 216-05: (GD) Fixed a bug where the command for register 0x227 would not be generated in line with the specifications in the `gd::VertexInputStage::KickDraw` function [SDK]

Fixed a bug where a command corresponding to the limitations below was not generated at the vertex index address of 0x227 [27:0] as described in the specifications.

If glDrawArrays meets the following conditions, 0x20 is written.

If [31:0] of 0x228 is larger than 0x10: (([31:0] of 0x228 -0x10)×2+([28:1] of 0x200 <<4))&0xfff >=0xfe0
If [31:0] of 0x228 is 0x10 or less: ([28:1] of 0x200 <<4)&0xfff >= 0xfe0

If these conditions are not met, 0 is written.

Note 216-06: (SND) Fixed a bug where `IsBufferInUse` of the `DspFxDelay` and `DspFxReverb` would occasionally not work [SDK]

Fixed a bug where, if an application was terminated from the HOME Menu after transitioning to the HOME Button, the return value of IsBufferInUse would remain as true even if DspFxDelay and DspFxReverb were finalized.

Note 216-07: (TOOL) Fixed a bug in `ctr_TexturePackage32` where an error would occur when you specify the maximum `miplevel` [SDK]

Fixed a bug where an error would occur if the miplevel value was specified as one less than the value specified for the miplimit attribute of the <texture> node.

Known Issues with the SDK 4.2.4 Release

In the GD LightingSample demo, the area the light is shining on periodically flashes.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used.
A large font size is set (the size that causes the problem could vary depending on the font).
Two levels of gradation are set for the number of gradations under Advanced Settings (this applies to both the A4 and LA4 settings).

If an application is started from the dev menu, the camera's Activate setting sometimes turns off if the HOME Button is pressed repeatedly.

■ CTR-SDK Version 4.2.4 Sample Demos

(2012/10/19)

Note 215-01: (RDT) RDT demo was changed to a version that includes implementation notes [Sample Demos]

Changed the RDT demo program so that it includes implementation notes.
In some cases, a communication partner was unable to detect that the data transmission was canceled and would continue to wait for a connection.
This could lead to a potential system freezes. Keep this point in mind when implementing your application.

Known Issues with the SDK 4.2.4 Sample Demos

None.

■ CTR-SDK Version 4.2.3 Release

(2012/07/26)

Note 214-01: (CAMERA) Made revisions for hardware compatibility [SDK]

Deleted constants named EFFECT_SOLARIZE_* from the Effect enumerated type.
Also, added to the reference the fact that the following limits have been placed on the SetDetailSize function.

cropX0 must be even.
cropX1 - cropX0 + 1 must be a multiple of 4.

Note 214-02: (DSP) Fixed a bug where noise would occur if a low pitch was specified when using `snd::Voice` [SDK]

Fixed a bug with the dsp::LoadDefaultComponent function where noise would occur when using the snd library if multiple voices were used and the pitch specified for a given voice was set extremely low.

Note 214-03: (DevEnv) Deleted the description for the Company Code [SDK]

Deleted information about the company code from the following documentation.

makerom reference
ID List ($CTR_SDK/documents/TechnicalNotes/IdCatalog)

Note 214-04: (TOOL) Added `FragDisk` [SDK]

Added the FragDisk tool for defragging empty areas on SD cards.

Known Issues with the SDK 4.2.3 Release

In the GD LightingSample demo, you can see a phenomenon where the area the light is shining on periodically flashes.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used.
A large font size is set (the size that causes the problem could vary depending on the font).
Two levels of gradation are set for the number of gradations under Advanced Settings (this applies to both the A4 and LA4 settings).

If an application is started from the dev menu, the camera's Activate setting sometimes turns off if the HOME Button is pressed repeatedly.

■ CTR-SDK Version 4.2.3 Sample Demos

(2012/07/26)

Note 213-01: (CAMERA) Fixed a problem with the sample demo where it did not support the POWER Button and opening/closing the cover [Sample Demos]

Fixed a bug where the CAMERA sample demo would stop if the POWER Button was pressed or the cover closed after the demo was started.

Known Issues with SDK 4.2.3 Sample Demos

None.

■ CTR-SDK Version 4.2.2 Release

(2012/07/12)

Note 212-01: (CRYPTO) Fixed a bug where the output length of RSA encryption data would differ depending on the string used to create it [SDK]

Fixed a bug where the length of encrypted output would differ depending on the string input to the RSA encryption function.
The following functions were revised.

nn::crypto::RsaContext::Encrypt

Note 212-02: (CRYPTO) Fixed a bug where the output length of RSA signatures would differ depending on the string used to create them [SDK]

Fixed a bug where the length of the signature output would differ depending on the string input to RSA signature functions.
The following functions were revised.

nn::crypto::RsaContext::Sign
nn::crypto::RsaContext::SignSha256

Note 212-03: (DevEnv) Changed `cro` build option [SDK]

Changed the options that need to be specified to armlink for a cro build to handle a problem where the buffer size required to load cro was incorrect.
Certain support is necessary when constructing a proprietary build system.
For more information, see $CTR_SDK/documents/TechnicalNotes/Dll/BuildSystemDevelopmentGuideForDll.html.

Note 212-04: (FS) Fixed a bug with a function to help prevent accidentally rolling back save data [SDK]

Fixed the following bugs with the feature to help prevent accidentally rolling back save data.

Bits other than those specified by the mask argument were being illegally set to 0 for overload functions that take the mask argument of the nn::fs::SetSaveDataSecureValue function.
Sometimes the nn::fs::VerifySaveDataSecureValueLoosely function would return true when it should have returned false.

Note 212-05: (TOOL) Fixed a bug where the buffer size required to load `cro` was incorrect [SDK]

ctr_makecro32.exe was revised due to a bug where a value lower than the actual size required was sometimes being obtained as the value of nn::ro::SizeInfo::bufferSize when using the nn:ro::GetSizeInfo function.

Known Issues with the SDK 4.2.2 Release

In the GD LightingSample demo, you can see a phenomenon where the area the light is shining on periodically flashes.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used.
A large font size is set (the size that causes the problem could vary depending on the font).
Two levels of gradation are set for the number of gradations under Advanced Settings (this applies to both the A4 and LA4 settings).

■ CTR-SDK Version 4.2.1 Release

(2012/06/27)

Note 211-01: (DBG) Added an ASSERT to the display buffer specified to `DirectPrint` [SDK]

Added the fact that the nn::dbg::CTR::DirectPrint class can only handle display buffers allocated in device memory to the API reference.
Also, changed the source to assert that the address of the display buffer passed as an argument to the ChangeDisplaybuffer member function is located in device memory.

Note 211-02: (DBG) Added a means of calling the user handler to prevent programs from stopping on an error [SDK]

Added a means of calling a pre-specified user handler when an assertion fails or a panic occurs.
For more information, see the reference for nn::dbg::SetBreakHandler.

Note 211-03: (DBG) Default registration of an error stop handler [SDK]

Changed source code to register a user handler for the on-screen display of details regarding stopped execution using nn::dbg::CTR::ExceptionScreen during the default nninitStartUp process.

Note 211-04: (DevEnv) Corrected Change Log Note 208-14 [SDK]

Fixed the description in the change log for Note 208-01 because it was wrong.

Note 211-05: (FS) Added the `nn::fs::VerifySaveDataSecureValueLoosely` function [SDK]

Added the nn::fs::VerifySaveDataSecureValueLoosely function with a looser method of verifying data immediately after system repair than nn::fs::VerifySaveDataSecureValue.
Revised the references for both functions in light of this addition.

Note 211-06: (FS) Fixed a bug where only an application's own save data could be accessed [SDK]

Fixed a bug where save data could not be mounted if a card was inserted in the slot when using the nn::fs::MountDemoSaveData function or an overload function that takes the uniqueId of the nn::fs::MountSaveData function as an argument.

Note 211-07: (GR) Added a class to help command buffer jump commands [SDK]

Added the CommandBufferJumpHelper class to gather routines that were executed in the old gx/Gr/CommandBufferJump sample demo.

Note 211-08: (GX) Updated the shader assembler tool [SDK]

Added a feature for checking whether there has been a mistaken operation due to any register dependencies of the instruction immediately before or after a mova instruction and then outputting a warning.

Note 211-09: (GX) Updated documentation [SDK]

Added an item to VertexShaderReferenceManual.pdf regarding mistaken operations due to register dependency of the instruction immediately before or after a mova instruction.

Note 211-10: (OS) Fixed a bug where unnecessary symbols were being linked [SDK]

Fixed a bug where symbols linked when using std::string or std:wstring were being linked even if neither of those were being used.

Note 211-11: (RO) Added a build system build guide (DLL advanced edition) [SDK]

Added a build system build guide (DLL advanced edition) to $CTR_SDK/documents/TechnicalNotes/Dll/BuildSystemDevelopmentGuideForDllAdvanced.html.
Also, added references for makecro and makecrr.

Note 211-12: (TOOL) Added a specification for where to write user save data to `SaveDataFiler` [SDK]

Changed specifications so that save data exported from a CTR card is imported into applications on an SD card.
See the SaveDataFiler reference for details.

Note 211-13: (TOOL) Changed `makebanner` [SDK]

Made the following changes related to makebanner.

Added makebanner support for a new Taiwanese rating (added a setting for 15-year-olds).
Changed behavior so the English name is copied if Publisher has not been set for makebanner.
Fixed a bug where makebanner would not run correctly if a TGA file in a format other than ETC was specified for BigIconFile or LittleIconFile.
Fixed a bug where makeexbanner would not run correctly if a TGA file in a format other than ETC was specified for BigIconFile or LittleIconFile.
Added a description of limitations on naming data to the reference for BannerModelConverter.

Known Issues with the SDK 4.2.1 Release

In the GD LightingSample demo, you can see a phenomenon where the area the light is shining on periodically flashes.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used.
A large font size is set (the size that causes the problem could vary depending on the font).
Two levels of gradation are set for the number of gradations under Advanced Settings (this applies to both the A4 and LA4 settings).

■ CTR-SDK Version 4.2.1 System Updater 0.17.19

(2012/06/27)

Note 210-01: (DevEnv) Added CTR browser import to the Chinese, Korean, and Taiwanese versions [System Updater]

Changed the Chinese, Korean, and Taiwanese versions of System Updater to import the CTR browser.
This allows you to start the Internet Browser from the HOME Menu.

The Internet Browser's engine is not allocated as much memory on a PARTNER-CTR Debugger or PARTNER-CTR Capture as it is on a retail CTR system or a CTR test unit.
As a result, the Internet Browser can display some pages on a retail system that it cannot display on a PARTNER-CTR Debugger or PARTNER-CTR Capture.

Note 210-02: (HOME Menu) Fixed a memory leak that would occur when using contextual banners [System Updater]

Fixed a bug where an internal memory leak occurs when a banner is displayed on the HOME Menu if textures referenced by multiple materials are swapped in the contextual banner.

Note that download contextual banners associated with this bug will not be distributed in the future for applications that register download tasks on systems prior to 3.2 NUP.

Note 210-03: (OS) Fixed a bug where thread display was irregular when the debugger output a string exceeding 270 bytes to the log [System Updater]

Fixed a bug where thread display was irregular when the debugger output a string exceeding 270 bytes to the log.

Note 210-04: (System Settings) Changed rating specifications for the Taiwan region [System Updater]

Added support for changes to the ratings used in Taiwan.
Changed rating icons and added a rating setting for ages 15 and older.

Known Issues with the SDK 4.2.1 System Updater 0.17.19

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 4.2.1 Sample Demos

(2012/06/27)

Note 209-01: (GR) Fixed a bug in the `gx/Gr/CommandBufferJump` sample demo [Sample Demos]

Revised the gx/Gr/CommandBufferJump demo to reflect the addition of the CommandBufferJumpHelper class.

Known Issues with the SDK 4.2.1 Sample Demos

None.

■ CTR-SDK Version 4.2.0 Release

(2012/05/29)

Note 208-01:(CAMERA) The values obtained by `GetTrimmingParam` are now the same as set values [SDK]

The values obtained by GetTrimmingParams for the y-axis (pYStart, pYEnd) were +1 larger than the set values. That bug has been fixed, so now it can get the correct values.
The set values were always the correct values, so it was not as if the settings were not configured as intended.

Note 208-02:(CEC) Changed the namespaces for some constants [SDK]

In the cec library header, the constants that had been defined with #define are now defined with the nn::cec namespace.

CEC_OUTBOX_SIZE_DEFAULT is now nn::cec::CEC_OUTBOX_SIZE_DEFAULT
CEC_OUTBOX_MESSNUM_DEFAULT is now nn::cec::CEC_OUTBOX_MESSNUM_DEFAULT

Note 208-03:(CEC) Changed name for function that gets transmission events [SDK]

The name of the GetCecRecvEventHandle function, which gets notification events when StreetPass has occurred, has been changed to GetCecEvent.
The function features have not changed.
This was actually changed in CTR-SDK 4.1 but was accidentally omitted from the change log.

Note 208-04:(CRYPTO) Fixed memory leak when RSA verification failed [SDK]

Memory leaks occurred when RSA verification failed. That bug has been fixed.

Note 208-05:(CX) Fixed `SecureUncompressBLZ` function's failure to decompress data correctly [SDK]

The SecureUncompressBLZ function would sometimes fail to decompress data correctly. That bug was fixed.

Note 208-06:(CX) Added functions for deflate compression and decompression [SDK]

Added API for data compression and decompression based on the deflate algorithm.

Note 208-07:(DevEnv) Improved searches in the `Result` search field [SDK]

Certain error codes could not be searched for among the Result values belonging to nn::fs. The process has been improved so that now those too can be searched.

Note 208-08:(DevEnv) Added update indicator [SDK]

Added update indicator data to $CTR_SDK/resources/icon/UpdateIndicator and also added documentation related to the update indicator, which is used on the HOME Menu to indicate when new data has arrived for an application and to notify when friends can join in.

Note 208-09:(FND) Accelerated TimeSpan conversion [SDK]

Accelerated the process by which nn::fnd::TimeSpan is converted into seconds.

Note 208-10:(GR) Fixed a bug in command generated by the `gr::MakeDisableAllCommand` function [SDK]

The gr::MakeDisableAllCommand function generated a flawed write command to the 0x118 register. That bug was fixed.

Note 208-11:(GX) Added the `gx Raw` API [SDK]

Added the gx Raw API, which is the API that enables the command-related controls of the gx API to be processed in the form of directly specified command list objects.
For more information, see gx Raw.

Note 208-12:(GX) Added the `nngxGetInitializationCommand` function [SDK]

Added the nngxGetInitializationCommand function, which gets the commands to set registers that are generated and executed when the nngxInitialize function is called.
By executing the command buffer obtained by this function when returning from the HOME Menu or an applet, you can restore the states of the GPU registers to be the same as they were immediately after initialization.

This function was added to deal with problems related to rendering that can occur upon return from the HOME Menu or elsewhere if commands for directly setting registers have been created, rather than using a graphics library supported by the CTR-SDK.
Accordingly, there is normally no need for this.

Note 208-13:(GX) Added error checking to the `nngxValidateState` function [SDK]

Added an error check for cases where a valid program object has not been set.
If there is this error, the function returns GL_ERROR_80B3_DMP.

The assumption is that in most cases the nngxValidateState function will be called directly after a return from the HOME Menu or another applet, or when the library is switched from some other graphics library. With the addition of this specification, the function will return the 80B3 error when the GL library is not being used and when glUseProgram(0) has been called before transitioning to an applet.
If the purpose is to restore the GPU registers, then there is not necessarily any need to call the nngxValidateState function.
For more information, see the page on restoring the GPU register settings in the Graphics part of the API Reference.

Note 208-14:(GX) Updated the documentation [SDK]

The following updates were made to the GX documentation.

Added the page about restoring the GPU register settings to the API Reference.
DMPGL20_specification.pdf

Noted that values input to the combiner are clamped to [0,1] prior to calculation.
Added text about vertex color values input to the combiner.

DMPGL20_system_API_specification.pdf

Added text about the nngxGetInitializationCommand function.
Added text about the error checking added to the nngxValidateState function.

Added DMPGL20_system_API_specificationRaw.pdf.

Note 208-15:(MATH) Added Mersenne Twister API [SDK]

Added the nn::math::MersenneTwister class for generating random numbers using the Mersenne Twister, and the nn::math::TinyMt class for generating random numbers using the Tiny Mersenne Twister (TinyMT).

Note 208-16:(NDM) Added the `IsDaemonStartEnable` function to check whether the wireless switch is on so daemon can run [SDK]

Added the IsDaemonStartEnable function, which checks whether the wireless switch is on so the daemon can run.

Note 208-17:(OS) Accelerated Tick conversion [SDK]

Accelerated the process by which nn::os::Tick is converted into nn::fnd::TimeSpan.
Also added a member function to nn::os::Tick for converting directly to seconds.

Note 208-18:(UDS) Fixed the value returned by the `SendTo` function when a port number reserved by the system is specified [SDK]

The SendTo function now returns ResultOutOfRange when the specified port number is one that has been reserved by the system. The function previously returned ResultOutOfResource, which is not included in the API Reference.

Note 208-19:(ZLIB) Added the zlib library [SDK]

Added the prebuilt library zlib, which is an open-source library.
For more information, see the zlib page in the API Reference.

Known Issues with SDK 4.2.0 Release

In the GD LightingSample demo, you see a phenomenon where the area the light is shining on periodically flashes.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used
A large font size is set (the size that causes the problem could vary depending on the font)
Two levels of gradation are set for the number of gradations under Advanced Settings (this applies to both the A4 and LA4 settings)

■ CTR-SDK Version 4.2.0 System Updater 0.17.17

(2012/05/29)

Note 207-01:(HOME Menu) Added a feature to pause the animation when application starts [System Updater]

A feature has been added to just the China market HOME Menu for pausing the animation when the application starts, mainly for confirming data like ISBN numbers.
Note that if you simultaneously press the Y Button and B Button and then start the application, even though the text "ISBN check mode." displays in the upper-left part of the upper screen, the startup animation will not stop unless you press some other button.

Note 207-02:(HOME Menu) Fixed a bug with disabled language-switch feature [System Updater]

While the processing-load bars are displayed, if you press the X Button and B Button simultaneously and reinsert the Game Card, you should be able to cycle through the regions and languages displayed for the title name (two-line and one-line display) and the banner model. However, this feature became disabled in System Updater 0.17.6. That has now been corrected so the feature is again available.

Note 207-03:(TOOL) Support for deleting China/Korea/Taiwan market CTR browsers from DevMenu [System Updater]

The China, Korea and Taiwan market CRT browsers can now be deleted from DevMenu.
Delete just like other applications by pressing the X Button.

Known Issues with SDK 4.2.0 System Updater 0.17.17

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 4.2.0 Sample Demos

(2012/05/29)

Note 206-01:(DLP) Fixed a bug where Taiwan ratings were not set for icons specified by `Child_0` and `Child_1` [Sample Demos]

The icons specified by dlp/Child_0 and Child_1 were not configured with the ratings for the Taiwan market, so unintended age restrictions would be applied if Parental Controls were set in the System Settings.
That problem was fixed.

Note 206-02:(GX) Fixed a bug with `gd` sample `RenderToTarget` when vertex buffer placed in main memory [Sample Demos]

In the gd sample RenderToTarget, when #define TEST_COPY_VERTEXBUFFER was enabled and data was copied between two vertex buffers allocated in main memory, an error would occur due to invalid byte alignment of vertex buffer addresses.
This was resolved by fixing the memory allocator of the sample demo library.

Note 206-03:(ZLIB) Added the `example` demo [Sample Demos]

Added the zlib/example demo, which shows how to use zlib included in the CTR-SDK to build example.c, which comes with zlib.

Known Issues with SDK 4.2.0 Sample Demos

None.

■ CTR-SDK Version 4.1.0 Release

(2012/05/02)

Note 205-01: (APPLET) Added description of `nn::applet::RestartApplication` operating conditions to references [SDK]

In the RestartApplication references, added a note that an application will not restart when the debugger is attached.

Note 205-02: (BOSS) Changed the method for specifying upload files in DataStore upload tasks [SDK]

Changed the method for specifying upload files in DataStore upload tasks to specifying the file path.
The previous method of specifying files using a file handle will be left in for backward compatibility, but use the file path specification method from now on.

Note 205-03: (CX) Fixed a bug where certain files could not be expanded with SecureUncompressLH and UncompressLH [SDK]

Fixed a bug where some LZ-Huffman compressed files could not be expanded.
Also, fixed the same bug for the ctr_compress32 tool.
Furthermore, since this is a bug in the expansion code, there is no need to recompress files that have already been compressed.

Note 205-04: (DBG) Added the `DirectPrint` class [SDK]

Added the nn::dbg::CTR::DirectPrint class that writes strings directly to the display buffer with the CPU.

Note 205-05: (DBG) Added the `ExceptionScreen` class [SDK]

Added the nn::dbg::CTR::ExceptionScreen class as a utility to output CPU exceptions.

Note 205-06: (DBG) Fixed the `NN_DBG_PRINT_RESULT` macro [SDK]

Fixed a bug in CTR-SDK 3.3 and later where the NN_DBG_PRINT_RESULT macro description display would always appear as "unknown." The correct result will be displayed now.

Note 205-07: (DLP) Removed `ResultInvalidMediaType` from the `Initialize` function return values [SDK]

Removed ResultInvalidMediaType from the Initialize function return values.
This value is never returned except for card applications or SD card applications.

Note 205-08: Added a description about how to forcibly set `pNotice` to false in the `Initialize` API reference [SDK]

Added a note in the description of the nn::dlp::Server::Initialize function in API references about how to forcibly set pNotice to false.

Note 205-09: (DLP) Added a description about the conditions under which the `StartFakeSession` function returns `ResultDeniedFromServer` [SDK]

Added a description about the conditions under which the FakeClient::StartFakeSession function returns ResultDeniedFromServer.
ResultDeniedFromServer is returned when the server is distributing a child program.

Note 205-10: (DLP) Added a note to the documentation that it is unnecessary to check operations for system updates that occur in download play [SDK]

Added a note to the documentation that it is unnecessary to check operations for system updates that occur in download play.

Note 205-11: (DevEnv) Added Result Search column [SDK]

Added a result search feature in API references to search results from 8 digit hexadecimal result values.
Users can now get to the feature by selecting Result > Search Result Value in the left center frame of the API reference.

Note 205-12: (DevEnv) Changed `cro` build procedure [SDK]

Added support for a bug where definitions were being duplicated, and changed the cro build procedure.
Certain support is necessary when constructing a proprietary build system.
For more information, see $CTR_SDK/documents/TechnicalNotes/Dll/BuildSystemDevelopmentGuideForDll.html.

Note 205-13: (DevEnv) Updated system application/applet specifications [SDK]

Made the following changes to the system application/applet specifications ($CTR_SDK/documents/TechnicalNotes/AppletGuide/Applet_Specification.pdf):

Added information about the Circle Pad Pro Calibration Applet and the EC Applet
Completely reviewed the information for the Error/EULA Applet so that only specifications are included
Updated information about the feature to join in from the Friend List and to start software from Notifications
Added information about a bug in displaying a Notification title and a bug in displaying the body of a StreetPass Notification message

Note 205-14: (DevEnv) Added Download Play icon [SDK]

Added Download Play icons and related documentation under the $CTR_SDK/resources/icon/DlplayIcon directory.

Note 205-15: (DevEnv) Organized include in headers [SDK]

Fixed a problem where include in CTR-SDK headers was going around certain locations.

Note 205-16: (DevEnv) Removed English from Language Settings in the Taiwan region [SDK | System Updater]

Removed support for English from Language Settings in the Taiwan region.

Note 205-17: (DevEnv) Added a note about contextual banner-related bugs to the CTR Icon and Banner Authoring Manual [SDK]

Added information about a bug where the HOME Menu freezes if textures that are referenced from multiple materials are switched in contextual banners to the CTR Icon and Banner Authoring Manual ($CTR_SDK/documents/TechnicalNotes/IconBannerManual/IconBannerManual.pdf).

Note 205-18: (FS) Fixed the mount save data function interface [SDK]

Separated the nn::fs::MountDemoSaveData function for mounting demo application save data from the nn::fs::MountSaveData function that gets a unique ID and mounts save data from other applications.
Also, got rid of the variation argument for the nn::fs::MountSaveData function.

Note 205-19: (FS) Changed the specifications for a feature to help prevent rolling back save data [SDK]

Removed the nn::fs::GetSaveDataSecureValue function that was released to help prevent rolling back save data, and added the nn::fs::VerifySaveDataSecureValue function.
Also, added an overloaded version for the nn::fs::SetSaveDataSecureValue function that can specify the bit mask that writes values.

Note 205-20: (FS) Added file access log parsing tool [SDK]

Added a tool for parsing the file access log that is output by the CTR-SDK.
For more information, see the reference for the Windows tool, ctr_FsAccesslogAnalyzer.

Note 205-21: (FS) Fixed error handling during redundant save data access [SDK]

Fixed the description in references about the error handling method for when redundant save data files or directories are accessed and a nn::fs::ResultVerifcationFailed-type result is returned.

Note 205-22: (GR) Removed generation of unneeded register (`0x6f[17]`) write commands [SDK]

Fixed a problem where there were unneeded commands (bit settings with no effect on operation) contained among the register write commands generated by the gr::Shader and gr::ShaderLite classes.

Note 205-23: (GX) Added an error for the `nngxValidateState` function [SDK]

There was a bug when the nngxValidateState function was called while the command list was not bound, where the state would be validated while incomplete.
This bug was fixed so that now when there is no bound command list, an error (GL_ERROR_80B2_DMP) is generated and the function returns without validating the state.

Note 205-24: (GX) Updated the documentation [SDK]

The following updates were made to the GX documentation.

DMPGL20_specification.pdf

Fixed a mistake in the description about shadow strength in Shadow Reference Pass
Fixed ranges of values to set in dmp_Texture[3].ptNoiseU and ptNoizeV.

DMPGL20_system_API_specification.pdf

Added to the description for the nngxValidateState function

GL_ERROR_80B2_DMP error
What happens when the error occurs during validation

Note 205-25: (HID) Changed the `AccelerometerReader::ConvertToAcceleration` function [SDK]

Changed the function so that now the number of pSamplingData data sets can be specified as the 4th argument (samplingLen).
If samplingLen is smaller than bufLen, the function will be stopped with an assertion.

Note 205-26: (INIT) Support for functions initialized by priority [SDK]

Added support for functions initialized by priority, which is an expanded feature of C/C++ supported by ARMCC.
However, the feature cannot be used for dynamic modules.

Note 205-27: (MATH) Added a function to update only the rotated portion of a 3×4 matrix [SDK]

Added the QUATToMTX34Partially function to update only the rotated portion of a specified matrix.

Note 205-28: (NEWS) Added the `nn::news::CTR::user::IsFromNewsList` function [SDK | Sample Demos]

Added a function that determines whether an application was started from the Notifications applet.

Note 205-29: (OS) Added the `GetCodeRegionAddress/Size` functions [SDK]

Added the nn::os::GetCodeRegionAddress and nn::os::GetCodeRegionSize functions that get the start address and size, respectively, for the static module code region.

Note 205-30: (OS) Added the `ManagedThread` class [SDK]

Added the nn::os::ManagedThread class which adds several features to the nn::os::Thread class.

Note 205-31: (OS) `SetUserExceptionHandler` can now be called from `nninitStartUp` [SDK]

The nn::os::ARM::SetUserExceptionHandler function can now be called from nninitStartUp.

Note 205-32: (OS) Prohibited `nn::os::Initialize` function calls [SDK]

The nn::os::Initialize function can no longer be called multiple times.
We have made it so that, essentially, the nn::os::Initialize function cannot be called in application code because the function is called automatically in the CTR-SDK.
If you call the nn::os::Initialize function in application code, it will be stopped with an assertion.
Although it was previously available, the nn::os::Initialize function is no longer publicly available, so delete any nn::os::Initialize function calls.

Note 205-33: (OS) Added `ASSERT` for when using default memory management mechanism [SDK]

If the default memory management mechanism is used without replacing nninitStartUp in the application, the heap region managed by the default memory management mechanism will be destroyed when the nn::os::SetHeapSize, nn::os::GetHeapSize or nn::os::GetHeapAddress functions are called.
An assertion was added to detect this and stop these functions from executing when called without replacing nninitStartUp.

Note 205-34: (OS) Default user exception handler registration [SDK]

In the default nninitStartUp process, nn::dbg::CTR::ExceptionScreen is now registered as the user exception handler.

Note 205-35: (RO) Added the `Module::Enumerate` function [SDK]

Added the nn::ro::Module::Enumerate class member function, which enumerates the loaded modules.

Note 205-36: (RO) Added the `Module::GetRegionInfo` function [SDK]

Added the nn::ro::Module::GetRegionInfo member function, which gets the information for the memory region being used by the loaded modules.

Note 205-37: (RO) Added support for a bug where definitions were being duplicated [SDK]

There was a bug where variables such as template class member variables and static variables defined in inline functions were being defined in headers, but an instance of the symbol grouping the instances of the variables would end up in every module during linking.
We have added support for this bug.
You may need to add this support to your code if you are encountering this bug.
For more information, see $CTR_SDK/documents/TechnicalNotes/Dll/DllManual.html.

Note 205-38: (SND) Changed specifications for when a buffer with a length of 0 is registered in `Voice::AppendWaveBuffer` [SDK]

Previously, a buffer with a length of 0 was included in the buffer queue when registered in Voice::AppendWaveBuffer. Now however, such a buffer is not included in the queue and its status is quickly changed to STATUS_DONE.

Note 205-39: (TOOL) Updated settings for the guideline checker for the Config tool [SDK]

In addition to changing stereo camera guidelines, changed the values to be set in the calibration data change feature (Stereo Camera Cal for Check) for checking guidelines, which is included in the Config tool.

Note 205-40: (TOOL) Increased speed of `TexturePackager` ETC encoding [SDK]

Greatly reduced the ETC encoding time with FastImproved and MediumImproved.

Note 205-41: (TOOL) Modified `makebanner` [SDK]

Made the following modifications to makebanner.

Removed English from the Taiwan/Hong Kong region
Fixed a bug where the width of title names was being checked improperly in the China, Taiwan, and Hong Kong regions.

Note 205-42: (TOOL) Added option to convert from CCI to CIA in `makecia` [SDK]

Added the "-cci" option in makecia for converting from CCI to CIA.
See references for details.

Note 205-43: (TOOL) Added a check for the highest version that can be specified in `makecia` [SDK]

Added error handling for when an improper version is specified when creating a data title with makecia.

Note 205-44: (TOOL) Added `-i CONTENTS_PATH:INDEX` to `makecia` options [SDK]

Added an option for specifying the contents included in the CIA file.
CONTENTS_PATH specifies the content file path, and INDEX specifies the index number that contains that content.

Note 205-45: (TOOL) Fixed a bug causing `makecro` to end abnormally when the `-p` option was used [SDK]

Fixed a bug where using the -p option in ctr_makecro32.exe would cause it to end abnormally for some AXF files.

Note 205-46: (TOOL) Fixed a `makerom` bug [SDK]

Fixed a bug where makerom would output an error and close in environments in which environment variables were defined more than once (for example, "Path" and "PATH").

Note 205-47: (TOOL) Added a feature for manipulating values to help prevent rolling back save data [SDK]

Added a feature to SaveDataFiler for working with 64-bit values to help prevent rolling back save data.
While hovering the cursor over a title in the User tab, pressing the R+Y Buttons will export save data to the SD card, and pressing the R+X Buttons will delete save data.
While hovering the cursor over a title in the SD card tab, pressing the A Button will import save data.

Note 205-48: (TOOL) Revised the upper limit for data title versions [SDK]

Revised the upper limit for a data title's version, which is actually 4095, but was listed incorrectly in the documentation as 1023.

Note 205-49: (UDS) Added `ResultInvalidData` to the `GetNodeInformationList` function's return values [SDK]

Added ResultInvalidData to the GetNodeInformationList function's return values.
Updated the documentation as well.

Note 205-50: (UDS) Added a note that RSSI values are stored from largest to smallest in the `Scan` function's scan results [SDK]

Added a note to the API references that RSSI values are stored from largest to smallest in the Scan function's scan results.

Known Issues with SDK 4.1.0 Release

In the GD LightingSample demo, you see a phenomenon where the area the light is shining on periodically flashes.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used
A large font size is set (the size that causes the problem could vary depending on the font)
Two levels of gradation are set for the number of gradations under Advanced Settings (this applies to both the A4 and LA4 settings)

■ CTR-SDK Version 4.1.0 System Updater 0.17.6

(2012/05/02)

Note 204-01: (DevEnv) Improved display timing during application start [System Updater]

The "Loading Application..." message that is displayed when starting an application in the development menu now appears sooner.

Note 204-02: (DevEnv) Removed English from Language Settings in the Taiwan region [SDK | System Updater]

Removed support for English from Language Settings in the Taiwan region.

Note 204-03: (HOME Menu) Added a feature to automatically return to the HOME Menu when applications or system applets end abnormally [System Updater]

Added a feature that automatically returns to the HOME Menu when applications or system applets end abnormally.
See $CTR_SDK/documents/DevHomeMenu/HomeMenu.html for details.

Note 204-04: (HOME Menu) Added a folder feature [System Updater]

Folders can now be created on the HOME Menu.

Note 204-05: (HOME Menu) Added a feature that can detect a bug in display of contextual banners [System Updater]

When textures that are referenced from multiple materials are switched in a contextual banner, there is a bug where an internal memory leak occurs when that banner is displayed in the HOME Menu.
We added a feature in the Developer HOME Menu to not display such contextual banners and to display a warning message on the lower portion of the upper screen.
A warning message is also displayed on the lower portion of the upper screen when you attempt to display a banner model that was not created with NW4C_ForBanner.

Note 204-06: (OS) Fixed a bug where an error would occur if the debugger log was output at a high frequency for a long period of time [System Updater]

Fixed a bug where a fatal error would occur if the debugger log was output at a high frequency for a long period of time.

Note 204-07: (OS) Improved communication between debugger and PC [System Updater]

Improved CPU standby processing when the debugger communicates with a PC.

Note 204-08: (OS) Added explanation for a debugger load error [System Updater]

There was a case where an explanation of the error would not be displayed when the debugger failed to load, but now an explanation is displayed.

Note 204-09: (OS) Added debugger exception handler support [System Updater]

An exception handler can now be used in the debugger.

Note 204-10: (TOOL) Fixed system behavior when changing the System Updater region [System Updater]

Fixed an issue where the system would not be initialized when the region was changed in System Updater.

Note 204-11: (Notifications) Fixed a bug where the final character in the title of a Notification would disappear [System Updater]

Fixed a bug where the final character in the title of a Notification would disappear.
For more information about this bug and rules for Notification title display (as well as related considerations), see the system application/applet specifications ($CTR_SDK/documents/TechnicalNotes/AppletGuide/Applet_Specification.pdf).

Note 204-12: (Notifications) Fixed a bug where the body of a StreetPass Notification would not fit within the display border [System Updater]

Fixed a bug when a StreetPass Notification was received from other regions with different built-in fonts, where the body of the message would not fit in the available display width and would be wrapped.
For more information about this bug as well as related considerations, see the system application/applet specifications ($CTR_SDK/documents/TechnicalNotes/AppletGuide/Applet_Specification.pdf).

Known Issues with SDK 4.1.0 System Updater 0.17.6

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 4.0.1 Sample Demos

(2012/05/02)

Note 203-01: (DevEnv) Added the `exbanner` demo [Sample Demos]

Added the exbanner demo which can create contextual banners and check operations.
Along with this change, a reference page has been added and a change to folder structure has been made (makebanner has been changed to simple and moved under makebanner/simple).

Note 203-02: (GX) Removed duplicate Gr sample framework processing time measurement code [Sample Demos]

The code for adding the processing time for each frame to measure the overall processing time was duplicated in gx/Gr/Framework/sources/gr_Framework.cpp.
As a result, you could not get the correct measurement for the intended time period, so the locations with duplicate code were fixed.

Note 203-03: (NEWS) Added the `nn::news::CTR::user::IsFromNewsList` function [SDK | Sample Demos]

Added a function that determines whether an application was started from the Notifications applet.

Note 203-04: (Other) Fixed a location where an invalid argument was being specified in the `Initialize` member function in `nn::fnd::ExpHeap` [Sample Demos]

Fixed a location where an invalid argument was being specified as the 3rd argument for the Initialize member function in nn::fnd::ExpHeap in the sample demos.

Known Issues with SDK 4.1.0 Sample Demos

The gx/Gd/RenderToTarget demo does not work correctly even if TEST_COPY_VERTEXBUFFER is enabled.
You can fix this problem by setting ALIGNMENT_VERTEX to 16 in $SampleDemos/common/libraries/demo/Utility/demo_MemoryManager.cpp.

■ CTR-SDK Version 4.0.2 System Updater 0.17.5

(2012/04/06)

Note 202-01: (FS) Ensured compatibility with cards that can be potentially supported in the future [System Updater]

Made modification to ensure compatibility with cards that could potentially be supported in the future.
This change does not have any effect on applications' operation.

Known Issues with SDK 4.0.2 System Updater 0.17.5

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 4.0.2 System Updater 0.17.4

(2012/03/30)

Note 201-01: (Error/EULA) Fixed a bug where the system would hang when using the word wrap feature [System Updater]

When a custom error message was displayed with the word wrap feature enabled, the system would sometimes hang if the wrapped message reached 8 lines. This problem has been fixed.

Known Issues with SDK 4.0.2 System Updater 0.17.4

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 4.0.2 Release

(2012/03/19)

Note 200-01: (DSP) Fixed problem of static noise with snd [SDK]

In CTR-SDK 4.0 and later versions, static noise was generated in snd sounds. That problem was fixed.

Note 200-02: (DevEnv) Support for China/Korea/Taiwan in System Application and Applet Specifications [SDK]

Descriptions relating to the China/Korea/Taiwan regions have been added to the document System Application and Applet Specifications ($CTR_SDK/documents/TechnicalNotes/AppletGuide/Applet_Specification.pdf).

Note 200-03: (DevEnv) Support in built-in font character lists for China/Korea/Taiwan [SDK]

The following changes have been made to the built-in fonts:

Revised character lists of built-in fonts for China/Korea/Taiwan regions.
Added lists of characters that can be entered with software keyboard for China/Korea/Taiwan regions.
Added lists of characters that can be used for user names for China/Korea/Taiwan regions.
Added character filter files below the $CTR_SDK/resources/xllt directory.

Note 200-04: (FND) Fixed problem with alignment ASSERT for ExpHeap and the like [SDK]

For nn::fnd::ExpHeap and other like classes, an assertion was not generated even though an alignment exceeding 128 was specified.
This bug has been fixed.

Note 200-05: (FS) Added function for creating archive alias names [SDK]

Added the nn::fs::CreateArchiveAlias function to enable a mounted archive to be accessed with a different specified name.

Note 200-06: (GX) Updated the shader assembler tool [SDK]

Added a newline to the output result of the -dependency option of the shader assembler tool.

Note 200-07: (GX) Fixed timing at which busy counter is reset in profiling API [SDK]

The specification document DMPGL20_system_API_specification.pdf states that the busy counter as measured by nngxStartProfiling(NN_GX_PROFILING_BUSY) is reset at the two times listed below, but it was only being reset at the later time.

When the nngxStartProfiling function is called.
When the nngxGetProfilingResult function is called.

This has been corrected so that now it is reset when the nngxStartProfiling function is called.

Note 200-08: (JPEG) Fixed problem with StartMpEncoderNext function [SDK]

When the nn::jpeg::CTR::JpegMpEncoder::StartMpEncoderNext function was called two or more times (that is, three or more images were encoded), the encoding process would fail even if there was sufficient room in the encoding result buffer. That problem was fixed.

Known Issues with SDK 4.0.2 Release

In the GD LightingSample demo, you see a phenomenon where the area the light is shining on periodically flashes.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used
A large font size is set (the size that causes the problem could vary depending on the font)
Two levels of gradation are set for the number of gradations under Advanced Settings (this applies to both the A4 and LA4 settings)

■ CTR-SDK Version 4.0.2 System Updater 0.17.3

(2012/03/19)

Note 199-01: (DevEnv) Changed behavior of starting System Settings from DevMenu [System Updater]

The System Settings no longer can be started while the application is suspended.

Note 199-02: (DevEnv) Updated the shared extended save data created by DevMenu [System Updater]

Updated the specification for the shared extended save data created when DevMenu starts to be in line with the latest specification for the HOME Menu.

Note 199-03: (OS) Fixed problem with POWER Button, HOME Button after card removed [System Updater]

Operation would stop if the HOME Button was pressed after pressing the POWER Button at the warning screen after card removal. That problem has been fixed.

Note 199-04: (TOOL) Fixed problem of freezing when expanded save data deleted using DevMenu [System Updater]

When DevMenu was used to delete expanded save data while it was mounted, the system would freeze. That problem has been fixed.

Known Issues with SDK 4.0.2 System Updater 0.17.3

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 4.0.2 Sample Demos

(2012/03/19)

Note 198-01: (BOSS) Added DataStore task sample demo [Sample Demos]

Added a sample demo for DataStore tasks.

Known Issues with SDK 4.0.2 Sample Demos

None.

■ CTR-SDK Version 4.0.1 Release

(2012/02/29)

Note 197-01: (DSP) Fixed a bug causing noise when performing `snd` volume operations [SDK]

Fixed a bug introduced by a revision in the dsp library in CTR-SDK 4.0, where snd volume operations would cause noise (fixed the dsp library).

Note 197-02: (DSP) Fixed a bug causing noise when the `snd::DspFxReverb::Param` structure's `m_UseHpfDamping` member was set to `true` [SDK]

Fixed a bug causing noise when the snd::DspFxReverb::Param structure's m_UseHpfDamping member was set to true (fixed the dsp library).

Note 197-03: (FS) Fixed a bug where ROMs larger than 4 GB could not be handled properly [SDK]

Fixed a bug where loading a ROM of more than 4 GB could not load any files located at memory addresses higher than 4 GB.

Note 197-04: (GR) Fixed a bug in the `ShaderLite` class's `SetupBinary` function [SDK]

Fixed a bug where the SetupBinary function would fail when not calling the GetRequiredBufferSize function.

Note 197-05: (HIO) Updated the hio library for IS-CTR-DEBUGGER [SDK]

Updated the hio library for IS-CTR-DEBUGGER to the 20120228 version.
Improved stability when using multiple instances simultaneously.

Note 197-06: (TOOL) Revised `makebanner` [SDK]

Changed makebanner to no longer allow setting rating values for unsupported regions.
Added introduction for and link to makedlexbanner in makeexbanner documentation.

Known Issues with SDK 4.0.1 Release

In the GD LightingSample demo, you will see a phenomenon where the area the light is shining on will periodically flash.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used
A large font size is set (the size that causes the problem could vary depending on the font)
Two levels of gradation are set for the number of gradations under Advanced Settings (this applies to both the A4 and LA4 settings)

■ CTR-SDK Version 4.0.1 System Updater 0.17.2

(2012/02/29)

Note 196-01: (APPLET) Fixed a bug where a request for Sleep Mode again would occur while recovering from Sleep Mode [System Updater]

Fixed a bug where closing and opening the lid once would cause the system to enter Sleep Mode twice.

Note 196-02: (FRIENDS) Fixed a bug where asynchronous processing after adding a friend would result in a communication error [System Updater]

Fixed a bug where calling the nn::friends::AddFriendWithApproach function in a state where friend presence could not be posted online, such as during UDS communication, would cause a communication error in asynchronous processing.

Note 196-03: (Y2R) Fixed a bug where the battery running out during y2r conversion would cause the system to lock up [System Updater]

Fixed a bug where the battery running out during a y2r conversion would cause the system to halt in the middle of finalizing prompted by the low battery level.

Known Issues with SDK 4.0.1 System Updater 0.17.2

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 4.0.1 Sample Demos

(2012/02/29)

Note 195-01: (OS) Revised `CriticalSection` and `Mutex` demos [Sample Demos]

Changed the CriticalSection and Mutex demos to show the differences in behavior when there is a lock and when there is not.

Note 195-02: (SND) Revised `snd/OutputCapture` demo [Sample Demos]

Revised the snd/OutputCapture demo to allow Release builds as well.

Known Issues with SDK 4.0.1 Sample Demos

None.

■ CTR-SDK Version 4.0.0 Release

(2012/02/20)

Note 194-01: (APPLET) Fixed a bug where calling `ProcessHomeButton` function would cause processing to halt [SDK]

Fixed a bug where preloading the library applet after a HOME Button press and then calling the ProcessHomeButton function would cause the system to halt.

Note 194-02: (APPLET) Added means to determine when rendering is complete during applet transitions [SDK]

Changed behavior when transitioning to the HOME Menu or starting a library applet to only halt on an assert for Development and Debug builds when the application is rendering (strictly speaking, while processing command requests).

Note 194-03: (BOSS) Fixed a bug where deleting an NSD object while getting the NSD list would cause BOSS to halt abnormally [SDK]

Fixed a bug where calling the boss::GetNsDataIdList function multiple times and then deleting an NSD while getting the NSD list would cause the next call to the boss::GetNsDataIdList function to exit abnormally.

Note 194-04: (CEC) Revised the `MessageBox::GetMessageIdPair` function's error checking [SDK]

Changed behavior of the MessageBox::GetMessageIdPair function to return an error (nn::cec::ResultNoData) when it cannot get a value, such as after receiving a message in a mode other than "convert."

Note 194-05: (DBG) Changed function that forcibly changes the startup argument buffer to be private [SDK]

Changed the nn::dbg::SetArgumentBuffer function, which forcibly changes the startup argument buffer after application start, to be private.

Note 194-06: (DevEnv) Fixed a bug where including `..` in `CTR_BANNER_SPEC` would cause an error [SDK]

Fixed a bug in the CTR-SDK build system where including two periods, "..", in the path specified in CTR_BANNER_SPEC would cause an error during parallel builds.
In line with this, also changed the bnr and icn paths generated by the build system.

Note 194-07: (DevEnv) Updated copyright [SDK | Sample Demos]

Updated the copyright notices throughout the source code of CTR-SDK and Sample Demos.

Note 194-08: (DevEnv) Updated `nn.h` and cleaned up `include` statements [SDK]

Updated nn.h to allow use by all CTR-SDK API functions by using an include statement.
In line with this, revised the include statements in various header files.

Note 194-09: (DevEnv) Added CTR Icon and Banner Authoring Manual [SDK]

Added the $CTR_SDK/documents/TechnicalNotes/IconBannerManual/IconBannerManual.pdf documentation specific to creating icons and banners.

Note 194-10: (DevEnv) Fixed typos in overall sequence chart for Build System Development Guide For DLL (DLL version) [SDK]

Corrected the command to create app.crs in the overall sequence chart in the Build System Development Guide For DLL (DLL version).
Only changed the chart.

Note 194-11: (DevEnv) Revised description of download play devices in Build System Development Guide [SDK]

Reorganized the description of download play devices in Build System Development Guide.

Note 194-12: (DevEnv) Added friend icon/friend registration icon [SDK]

Added friend icon, friend registration icon, and related documentation to the $CTR_SDK/resources/icon/FriendIcon directory.

Note 194-13: (DevEnv) Added list of characters included in internal bitmap fonts for China, Korea, and Taiwan [SDK]

Added the following list of characters included in the internal bitmap fonts for China, Korea, and Taiwan.
$CTR_SDK/documents/resources/BuiltInFont
In line with this, updated FontConverter and documentation on the internal bitmap fonts.

Note 194-14: (FND) Added note that `nn::os::Tick` and `nn::fnd::DateTime::GetNow` cannot be used together, and added a description of precision [SDK]

Added a note explaining that nn::os::Tick and nn::fnd::DateTime::GetNow cannot be used together, and added a description of precision.

Note 194-15: (FONT) Fixed a bug causing buffer overflow in `WideTextWriter` [SDK]

Fixed an issue when using WideTextWriter that could cause a buffer overflow.

Note 194-16: (FS) Fixed a bug where Card2 save data was not properly checked if in the factory-default state [System Updater]

Fixed a bug where a Result other than the expected nn::fs::ResultNotFormatted-series results was returned when attempting to mount save data from Card2 when the card was in the factory-default state.

Note 194-17: (FS) Deleted default value for the `flush` parameter of the `Write` functions [SDK]

Deleted the default value of true for the flush parameter of the Write and TryWrite functions in the nn::fs::FileStream class and other classes. Note that this parameter can no longer be omitted when calling these functions.
Leaving this parameter unspecified now causes a compiler error.
Explicitly specify this parameter with a value of true to achieve the same behavior as in the past.

Note 194-18: (FS) Added functions for parsing the file access log [SDK]

Added a feature to log output file access when calling nn::fs::SetAnalysisLog(true).
This is only enabled for development and debug builds.

Note 194-19: (FS) Multi-byte `fs` functions are now thread-safe [SDK]

The fs functions that took const char* as path arguments were previously not thread-safe.
They have been improved to be thread-safe.

Note 194-20: (FS) Fixed a bug causing a deadlock when loading invalid data [SDK]

Fixed a bug where attempting to load expanded save data from an SD card when the file size has been tampered with causes the TryRead function to deadlock.

Note 194-21: (GR) Changed specifications for `WBuffer` class's constructor and for the `MakeCommand` function [SDK]

Deleted the option to allow calling the MakeCommand function of the FBAccess class when using the WBuffer class to generate commands, as this was deemed unnecessary given that this had no dependency in the specification on the registers set by the WBuffer class.
In line with this, the WBuffer class constructor no longer requires a RenderState class as an argument, so this was also deleted.
This change breaks compatibility for code using CTR-SDK 3.x and that directly generates and uses WBuffer class instances.

Note 194-22: (GR) Fixed a bug in shadow bias values [SDK]

Fixed a bug where the value set for shadow bias was off by one bit, preventing output of the proper value.

Note 194-23: (GR) Fixed a bug in certain texture units [SDK]

Fixed a bug where Texture::Unit1 and Unit2 in the MakeCommand function would write to undocumented bits.

Note 194-24: (GX) Fixed a bug where `Gd:` texture cache would not be cleared properly [SDK]

Fixed a bug where the texture cache would not be properly cleared when using the Gd library to set a texture in the texture unit, rendering it once to screen, then rendering the texture to a buffer and using that texture as is to render to the screen.

Note 194-25: (GX) Fixed a bug in `Gd:` producing unexpected `ResultNoTextureBound` error [SDK]

Calling the gd::CombinerStage::CreateTextureCombinerState function to create a new combiner state previously failed to correctly initialize the combiner state's values.
This caused a ResultNoTextureBound error when rendering. This bug has been fixed.

Note 194-26: (GX) Deleted definitions in `Gd:` that had been left for backward compatibility [SDK]

In CTR-SDK version 3.x and earlier, old names were kept for functions, classes, and other API elements when any names were changed to maintain backward compatibility. With this upgrade, such old API names have been deleted.

Note 194-27: (GX) Added filters to `gd::System::Debug::SetFilter` function [SDK]

Added the following filters to the gd::System::Debug::SetFilter function.

FILTER_DISABLE_CULLING
FILTER_ENABLE_CULLING_CLOCKWISE
FILTER_ENABLE_CULLING_COUNTERCLOCKWISE

Note 194-28: (GX) Revised error checking in `nngxAddL2BTransferCommand` function [SDK]

The width and height arguments to the nngxAddL2BTransferCommand function are limited by the same restrictions as for the nngxTransferLinearImage function (must be at least 128 pixels, and must be an even multiple of the block size). However, due to a bug in internal error checking, the values were not checked to make sure they were at least 128.
This has been fixed to properly return an error in such cases.

Note 194-29: (GX) Added `nngxGetIsInitialized` function [SDK]

Added the nngxIsInitialized function to get whether the nngx library has been initialized (that is, whether the nngxInitialize function has been called).

Note 194-30: (GX) Added `nngxGetIsRunning` function [SDK]

Added the nngxGetIsRunning function to get whether a command list is running.

Note 194-31: (GX) Added `nngxRunCmdlistByID` function [SDK]

Added the nngxRunCmdlistByID function that takes a command object ID as an argument, providing the same functionality as the nngxRunCmdlist function.
Use this function to start executing a command list without first binding it.

Note 194-32: (GX) Deprecated state cache feature [SDK]

Deprecated the state cache feature as it has been superseded by other methods, such as the command cache feature or command buffer jumps.
In line with this, the related documentation and reference materials have been removed from publication.
Do not use the following functions any more.

glSaveProgramsDMP function
glRestoreProgramsDMP function
glSaveVertexStateCollectionsDMP function
glRestoreVertexStateCollectionsDMP function
glSaveTextureCollectionsDMP function
glRestoreTextureCollectionsDMP function

Note 194-33: (GX) Updated documentation [SDK]

The following updates were made to the GX documentation.

DMPGL20_system_API_specification.pdf

Added a note about the setting method for NN_GX_PROFILING_BUSY_SAMPLING_TIME of the nngxSetProfilingParameter function.
Added a restriction to the nngxAddL2BTransferCommand function that the width and height values must be at least 128 pixels.
Revised the specifications for the profiling feature's busy counter.

VertexShaderReferenceManual.pdf

Fixed typos in the linker error messages.

DMPGL20_statecache_specification.pdf

Deleted in line with the deprecation of the state cache feature.

Note 194-34: (HIO) Removed 32-byte alignment restrictions [SDK]

Removed 32-byte alignment restriction for buffer addresses passed to the hio::HostFile::Read and hio::HostFile::Write functions.
However, note that not using 32-byte-aligned values causes slower performance.

Note 194-35: (HIO) Deleted `HostFile::IsExist` [SDK]

Deleted the HostFile::IsExist function.
Replace any usage of the HostFile::IsExist function with the HostFile::Exists function instead.

Note 194-36: (HIO) Revised the `HostFile::Open` function to support paths containing environment variables [SDK]

Revised the nn::hio::HostFile::Open function to allow the specification of paths containing environment variables.

Note 194-37: (HIO) Updated the IS HostIO library [SDK]

Updated the HostIO library for the IS debugger to the 20120210 version.

Note 194-38: (HIO) Updated HostIO for the IS debugger [SDK]

Updated HostIO for the IS debugger to the 20120110 version.

Note 194-39: (MATH) Standardized specifications for `MTX*Translate` functions [SDK]

Revised the MTX23Translate function to match the specifications of other MTX*Translate functions.
Added the MTX23MultTranslate function to provide the same features as the previous version of the MTX23Translate function.

Note 194-40: (OS) Re-added `Light` functions with timeouts [SDK | System Updater]

Re-added bug-fixed versions of the nn::os::LightEvent::TryWait(nn::fnd::TimeSpan) and os::LightSemaphore::TryAcquire(nn::fnd::TimeSpan) functions that had previously been removed due to the discovery of bugs.

Note 194-41: (OS) Changed default stack size for main thread [SDK]

Changed the default stack size of the main thread from 16 KB to 256 KB.
If the main thread's stack size is not specified in the RSF file, the size defaults to this 256 KB.

Note 194-42: (PL) Added header files for creating contextual banners [SDK]

Added the following header file that defines the format when creating contextual banners.
$CTR_SDK/include/nn/pl/CTR/pl_ExBanner.h

Note 194-43: (PL) Made changes related to system fonts for China, Korea, and Taiwan [SDK]

Added revisions and precautions to the API reference regarding use of the nn::pl::MountSharedFont function to change the available system fonts for China, Korea, and Taiwan.

Note 194-44: (SND) Deleted bug workaround flag in `FxReverb` class, added feature to specify damping filter type [SDK]

Deleted the m_IsEnableDampingBugFix damping bug workaround flag, and changed operation to work as if this variable were set to true.
Separately, also added the m_UseHpfDamping flag to change the damping filter to a high-pass filter.

Note 194-45: (TOOL) Added precautions for when using `AccessControlInfo`/`Debug` [SDK]

Added a precaution about specifying AccessControlInfo/Debug.

Note 194-46: (TOOL) Fixed a bug with `BossLotcheckTool` [SDK]

Fixed a bug where some of the Priority display of task information in BossLotcheckTool was handled as Invalid Value.

Note 194-47: (TOOL) Improved DLL loading times [SDK]

Changed how ctr_makecro32.exe generates CRO files to speed up nn::ro::LoadModule processing.
This improves the time needed to load modules that reference other modules that expose multiple symbols with reference types that are names.

Note 194-48: (TOOL) Added feature to check for existence of files in a ROMFS [SDK]

Added a feature to output an error when running ctr_makerom and the file specified by the RSF does not exist in the ROMFS.
For more details, refer to the ctr_makerom documentation for the ctr_makerom tool.

Note 194-49: (TOOL) Changed specifications of `CardDevice` parameter specified in the RSF file [SDK]

In past versions, it was necessary to explicitly specify NorFlash or None, but this is now determined automatically, so the argument can be omitted.

Note 194-50: (TOOL) Integrated `BackupMemoryType` parameter in the RSF file into `SaveDataSize` [SDK]

Integrated the BackupMemoryType parameter in the RSF file, formerly used to specify the Card1 save data size, into the SaveDataSize parameter.
If you have only specified a value for BackupMemoryType in the past, note that you must now specify a value for SaveDataSize.
Not specifying a value for SaveDataSize is handled as if a value of 0 (zero) was specified.

Note 194-51: (TOOL) Changed to allow quitting for even partial string matches using `ctr_loadrun32` [SDK]

Changed the behavior of ctr_loadrun32 to allow for finalization checks based on partial string matches instead of just on whole-line matches.
Use the regular expressions "^" at the start of the string, and "$" at the end of the string to force whole-line matching.

Note 194-52: (TOOL) Revised `makebanner` [SDK]

Corrected errors in makebanner in the criteria for the maximum number of characters in title names.
Also fixed a bug in makebanner causing an error when a texture data file is not found.

Note 194-53: (TOOL) Fixed a bug in `makecia` [SDK]

Fixed a bug where makecia could not create a valid CIA file when specifying a CFA input file with a size of an even multiple of 4 MB.

Note 194-54: (TOOL) Added GUI support to command parsing tool [SDK]

Changed behavior to allow starting the GUI tool by double-clicking the command parsing tool's executable file.
This allows users to check command data in greater detail and to more easily make changes.

Note 194-55: (TOOL) Added feature to manually specify mipmaps [SDK]

Changed operation to now allow the user to specify any texture for each level of a texture mipmap.

Note 194-56: (UDS) Deleted `ScanResultReader::Merge` function [SDK]

Deleted the ScanResultReader::Merge function, as merging beacons with this function could result in duplicating the original beacon information, and as it is possible to implement the same originally intended feature by combining other existing functions.

Note 194-57: (UDS) Deleted `FORCE_UNICAST` option from `SendTo` function [SDK]

Deleted the FORCE_UNICAST option from the SendTo function because specifying this did not change the function's behavior.

Note 194-58: (UDS) Added specification for `TemporaryID` [SDK]

Added the following TemporaryID specifications to the reference materials.

This does not update the TemporaryID when rebuilding the network if there are no Client connections and communication has not been established between devices.
However, if it is a long time until the network is rebuilt, the system judges that a network unrelated to the prior one has been built, and updates the TemporaryID.

Note 194-59: (UDS) Deleted functions that return old `Result` values [SDK]

Deleted functions that returned old Result values used in libraries in CTR-SDK version 0.10.2 and earlier.
Below is the list of deleted functions.

MakeResultAlreadyDone function
MakeResultNoData function
MakeResultNotFoundNetwork function
MakeResultInsufficientResourceAtMaster function
MakeResultDeniedFromMaster function
MakeResultConnectionTimeout function
MakeResultInvalidState function
MakeResultNotInitialized function
MakeResultAlreadyInitialized function
MakeResultInvalidParam function
MakeResultBufferFull function
MakeResultTooLarge function
MakeResultNotFoundTarget function
MakeResultNotImplemented function
MakeResultOutOfResouece function

Note 194-60: (UDS) Revised functions where calling the `Finalize` function during calls to those functions would cause a fatal error [SDK]

Revised functions where calling the Finalize function during calls to those functions would cause a fatal error, so they now return ResultNotInitialized instead.
Below is the list of revised functions.

GetApplicationDataFromBeacon function
DestroyEndpoint function
ReceiveFrom function
Receive function
SendTo function
SetApplicationDataToBeacon function
GetConnectionStatus function

Known Issues with SDK 4.0.0 Release

In the GD LightingSample demo, you will see a phenomenon where the area the light is shining on will periodically flash.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used
A large font size is set (the size that causes the problem could vary depending on the font)
Two levels of gradation are set for the number of gradations under Advanced Settings (this applies to both the A4 and LA4 settings)

■ CTR-SDK Version 4.0.0 System Updater 0.17.1

(2012/02/20)

Note 193-01: (APPLET) Shortened HOME Button notification time [System Updater]

Revised HOME Button click determination and how applications are notified of this, thereby reducing the amount of time between HOME Button presses and notification.

Note 193-02: (APPLET) Fixed a bug where rapidly and repeatedly opening and closing the lid would cause a fatal error [System Updater]

Fixed a bug where rapidly and repeatedly opening and closing the lid on program start would cause unprocessed Sleep Mode notifications to accumulate in the system and cause a fatal error.

Note 193-03: (APPLET) Fixed a bug where background music would be output from speakers even when lid is closed on initial startup [System Updater]

Fixed a bug during initial startup where closing the lid right after turning the power on would cause background music to be output from speakers.

Note 193-04: (CAMERA) Fixed a bug where camera LED would remain on after removing card [System Updater]

Fixed a bug where starting the Photo Capture applet while an application is suspended, putting the system into Sleep Mode, removing the card, waking the system, and returning from the card-removal screen to the HOME Menu would result in the camera LED remaining illuminated.

Note 193-05: (DevEnv) Fixed a bug where calibration values would not be properly applied after system initialization [System Updater]

Fixed a bug where initializing a system with the debugger would cause incorrect calibration values to be set for things such as the touch panel and flicker adjustment.

Note 193-06: (DevEnv) Changed DevMenu key assignments [System Updater]

Switched assignments for the B Button (quit suspended application) and X Button (start System Settings).
Also changed behavior so pressing the POWER Button quits the suspended application.

Note 193-07: (DevEnv) Added handling for multiple simultaneous key presses on the DevMenu [System Updater]

Input from pressing multiple keys at once used to cause invalid operation, but this was changed to prioritize the order in which input is accepted for simultaneous presses (B > X > START > A > L).

Note 193-08: (FRIENDS) Fixed a bug where, in rare instances, system would not recover from Sleep Mode [System Updater]

Fixed a bug where closing the lid to put the system into Sleep Mode and then opening the lid would, on rare occasions, fail to wake the system, with the screen remaining black and the system stuck in Sleep Mode.

Note 193-09: (FRIENDS) Added workaround for problem where stopping the debugger right after adding a friend would cause that friend to disappear [System Updater]

Changed behavior to prevent added friends from disappearing when adding them from an application and then suspending or rebooting the debugger.
However, there is some variance in the amount of time needed to save, so make sure not to suspend or reboot for around 15 seconds after adding a friend.

Note 193-10: (FS) Fixed a bug where management memory on the SD card would, in rare instances, become corrupted when importing an SD application or add-on content [System Updater]

Fixed a bug when importing an SD application or add-on content from an SD card where simultaneous access to another file could, on rare occasions, corrupt the management memory region on the SD card.

Note 193-11: (FS) Fixed a bug where system would become unresponsive after loading invalid data from an SD card [System Updater]

Fixed a bug where the system would become unresponsive when accessing an expanded save data or other file on an SD card that has been tampered with, such as by being edited directly.

Note 193-12: (FS) Fixed a bug in `nn::fs::MountExtSaveData` function causing creation of a `3DS` directory [System Updater]

Fixed a bug in the nn::fs::MountExtSaveData function where the function would create the Nintendo 3DS and other directories if they did not already exist, even though this function should not do any writing to the SD card.

Note 193-13: (FS) Added feature to help prevent accidentally rolling back save data [System Updater]

Added the nn::fs::Get/SetSaveDataSecureValue function that reads and writes CTR system memory allocated separately for each application, as a feature to help prevent accidentally rolling back save data.

Note 193-14: (FS) Fixed a bug where system would freeze when download application is fragmented [System Updater]

Fixed a bug where attempting to read a download application's ROM region on an SD card could fail to return if that memory region is fragmented.

Note 193-15: (FS) Fixed a bug producing rare verification errors during file loading [System Updater]

Fixed a bug when reading mainly ROM files where simultaneous access to multiple files could, on rare occasions, cause an nn::fs::ResultVerificationFailed error.

Note 193-16: (FS) Fixed a bug where loading data from a write-protected SD card would, in rare instances, return `ResultWriteProtected` [System Updater]

Fixed a bug where opening a file in read-only mode from a write-protected SD card would, on rare occasions, still return a ResultWriteProtected error.

Note 193-17: (GX) Fixed a bug causing improper configuration of LCD backlight brightness [System Updater]

Fixed a bug where the LCD backlight brightness value would be set differently than described in the specification when plugging in or unplugging the AC adapter while the lid is closed and then opening the lid to wake the system.

Note 193-18: (HID) Changed timing of when to start sampling accelerometer [System Updater]

Changed the time between generating an instance of the hid::AccelerometerReader class until the system starts sampling from the previously fixed value of 1 msec to a varying value from 0 msec to around 10 msec.

Note 193-19: (HTTP) Fixed a bug producing errors when the HTTP request and POST data reach a certain combined size [System Updater]

Fixed a bug where the Read functions would return an error when the combined total size of the HTTP request and POST data was a multiple of 1536.

Note 193-20: (HTTP) Fixed a bug where system would stall when calling the `http::Finalize` function during HTTP communication [System Updater]

Fixed a bug where calling the http::Finalize function when some HTTP communication processing remains would cause the HTTP library to stall.

Note 193-21: (MCU) Fixed a bug where pedometer would start counting even when system lid was open [System Updater]

Fixed a bug where the pedometer would start counting when a running application used the accelerometer, even when the system lid was open.

Note 193-22: (OS) Fixed a bug where outputting a zero-byte string to the log would actually output a different string [System Updater]

Fixed a bug where outputting a zero-byte string to the log would unexpectedly output a different string.

Note 193-23: (OS) Re-added `Light` functions with timeouts [SDK | System Updater]

Note 193-24: (OS) Fixed a bug in the debugger where starting a thread would sometimes cause the system to hang [System Updater]

Fixed a bug causing a deadlock and causing the debugger to hang when an application loaded in the debugger started a thread.

Note 193-25: (OS) Changed debugger behavior when outputting `TARGET ERROR:` to also display an error description [System Updater]

Changed the behavior of the debugger when outputting TARGET ERROR: load errors to also display an error description.
This requires use of PARTNER-CTR Debugger version 20111222 or later.

Note 193-26: (OS) Fixed a bug in the debugger where loading an application with debugging prohibited would return an `OUT_OF_MEMORY` error [System Updater]

Fixed a bug in the debugger where repeatedly loading applications with debugging prohibited would return an OUT_OF_MEMORY error.

Note 193-27: (OS) Fixed a bug in the debugger where setting the battery level to 0% would cause the application to quit without finalizing [System Updater]

Fixed a bug in the debugger where setting the battery level to 0% would cause the application to quit without finalizing.

Note 193-28: (OS) Fixed general-purpose register value display when using forced breaks in the debugger [System Updater]

Fixed a mistake in the display of general-use register values after a forced break in the debugger.

Note 193-29: (OS) Modified display of thread starting addresses in the debugger [System Updater]

A change in System Updater 0.16.22 displayed the thread starting address as 0x100000 as a workaround for a bug that caused the debugger to hang, but this has now been revised to show the thread handler address instead.

Note 193-30: (SOCKET) Fixed a bug where a fatal error would rarely occur when calling the `Finalize` function [System Updater]

Fixed a bug where a fatal error would occur on rare occasions when calling the Finalize function.

Note 193-31: (TOOL) Added feature to Config tool to configure `SimpleAddress` [System Updater]

Added a function to the Config tool to configure SimpleAddress information (country/region).
See the Config tool documentation for details.

Note 193-32: (TOOL) Added Config tool features [System Updater]

Added a feature to the Config tool to change RawRtc.
See the Config tool documentation for details.

Note 193-33: (TOOL) Fixed a bug when importing a CIA file from HostIO where the DevMenu would display an invalid error that the SD card was not inserted [System Updater]

Fixed a bug when importing a CIA file from HostIO where the DevMenu would display an invalid error that the SD card was not inserted or could not be written to.

Note 193-34: (TOOL) Fixed a bug where DevMenu would freeze when touching the file list [System Updater]

Fixed a bug where touching ".." in the DevMenu's SD or HIO modes would cause a freeze.

Note 193-35: (TOOL) Fixed a bug where DevMenu would freeze when running without starting `HIO-Daemon` [System Updater]

Fixed a bug where the debugger would freeze when running DevMenu without starting HIO-Daemon.
Also fixed a bug caused by the same issue where shutting down the debugger and then starting DevMenu could cause a freeze.

Note 193-36: (TOOL) Changed System Updater behavior when changing regions [System Updater]

Changed the behavior when changing the region in System Updater to set the startup menu to the HOME Menu and then to automatically initialize the system and run the first-time startup sequence after the update has completed.

Note 193-37: (UDS) Fixed a bug where a fatal error would rarely occur when entering Sleep Mode during a call to the `Initialize` function [System Updater]

Fixed a bug where a fatal error would occur on rare occasions when entering Sleep Mode during a call to the Initialize function.

Note 193-38: (UDS) Fixed a bug where calling `GetLinkLevel` after stopping communication would never return a link level of 0 [System Updater]

Revised behavior after disconnecting using the DestroyNetwork or DisconnectNetwork functions so that calling the GetLinkLevel function returns a link level of 0 (zero).

Known Issues with SDK 4.0.0 System Updater 0.17.1

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 4.0.0 Sample Demos

(2012/02/20)

Note 192-01: (CAMERA) Revised the `Simple` demo [Sample Demos]

Refactored camera library use examples for clarity, and added the following specifications.

Added support for starting from the HOME Menu
Added 10 fps frame rate to list of available frame rates
Changed the size of the camera image displayed on the upper screen to be full-screen
Added a feature to auto-exposure to wait for the camera to be stable
Added to the information displayed on the lower screen (operating method, currently set frame rate)
Added Sleep Mode and HOME Button presses to log output
Revised documentation to reflect the above

Note 192-02: (DLP) Changed sample demos to use `FakeClientWithname` and `ServerWithName` classes [SDK]

Changed the FakeClient and SimpleServer sample demos to use FakeClientWithName and ServerWithName classes.

Note 192-03: (DevEnv) Updated copyright [SDK | Sample Demos]

Updated the copyright notices throughout the source code of CTR-SDK and Sample Demos.

Note 192-04: (FS) Added sample of feature to help prevent accidentally rolling back save data [Sample Demos]

Added a sample of a feature to help prevent accidentally rolling back save data.

Note 192-05: (GX) Added sample of real-time streaming [Sample Demos]

Added a sample of real-time streaming.

Note 192-06: (GX) Added `Gd/ProfilingSample` sample [Sample Demos]

Added a sample that uses the nngx profiling functions and the Gd library.

Note 192-07: (GX) Deleted sample of state cache feature [Sample Demos]

In line with the deprecation of the state cache feature, also deleted the following sample demos.

gx/DMPGL/SaveRestoreBuffer
gx/DMPGL/SaveRestoreProg
gx/DMPGL/SaveRestoreTexture

Note 192-08: (GX) Fixed a bug where the rendering order would be backward where there are double command lists [Sample Demos]

Fixed a bug that caused some of the Gr and Gd sample demos to render frames in the wrong order when double command lists were used.

Note 192-09: (HIO) Revised checking of PC application return values in `hio` demo [Sample Demos]

Revised the checking of PC application (HioDemoPC, HioDemoPCCPP) return values in the hio demo to conform to specifications.

Known Issues with SDK 4.0.0 Sample Demos

None.

■ CTR-SDK Version 3.3.1 Release

(2012/01/25)

Note 191-01: (APPLET) Fixed a bug in `AppletMsetScene` enumerated type [SDK]

The AppletMsetScene enumerated type was not defined in the nn::applet namespace. This has been fixed.

Note 191-02: (CEC) Revised the `MessageBox::GetMessageIdPair` function [SDK]

There was a bug in the MessageBox::GetMessageIdPair function that prevented it from getting the MessageID. This has been fixed.

Note 191-03: (CFG) Added function to get simple address information from the simple address ID [SDK]

Added a function to get the detailed information of the simple address (such as the country name and region name) from the simple address ID.

Note 191-04: (DLP) Added the `FakeClientWithName` and `ServerWithName` classes [SDK]

Added functions capable of setting the user name at initialization.

Note 191-05: (DLP) Added cautions for clients on development hardware with low system versions [SDK]

Added cautions for clients on development hardware with low system versions to the reference for the Server::Initialize function.

Note 191-06: (DevEnv) Revised the built-in fonts (the bcfnt files) for China, Korea, and Taiwan [SDK]

Revised the built-in font data (the bcfnt files), as follows for China, Korea, and Taiwan, in the $CTR_SDK/resources/shareddata/data/font directory.

The display position for characters of the built-in fonts for the China and Korea regions (excluding Nintendo's special characters) was lowered by two pixels, since their display position was previously higher than Japanese, North American, and European fonts.
The display position for characters of the built-in fonts for the Taiwan region was lowered by one pixel, since their display position was previously higher than Japanese, North American and European fonts.

Note 191-07: (FS) Updated the FS library reference [SDK]

Descriptions specific to archives in the FS library references were updated.
In addition, descriptions specific to flush operations during file writes were added, and descriptions specific to performance during file writes were added.

Note 191-08: (FS) Revised the reference specific to handling during the mounting of save data [SDK]

Clarified that a Result can occur in the nn::fs::ResultVerificationFailed functions when mounting save data and when duplicating save data.

Note 191-09: (GR) Increased the maximum number of data that can be written in burst access [SDK]

When writing a lookup table with the LookUpTable class, revisions were made to write a total of 256 units of data, since it is split into two burst transfers of 128 units of data each.

Note 191-10: (GX) Fixed a bug where a command was not generated for bits [25:24] for register 0x126 [SDK]

There was a bug where the command for register 0x126 [25:24], which affected additive blending D2 when rendering gas density information, was not generated. This has been fixed.

Note 191-11: (GX) Added the `gd::System::AddDummyCommands` function [SDK]

Added the gd::System::AddDummyCommands function, which inserts a specified number of dummy commands to the 3D command buffer.

Note 191-12: (GX) Added `gd::System::Debug` [SDK]

Added the gd::System::Debug::SetFilter function, which can configure filters for disabling blending and changing the minimum size of textures, to support GPU debugging.
Also added the gd::System::Debug::ColorizeMipmaps function, which can make each mipmap level visible by colorizing it with a single color.

Note 191-13: (GX) Added the `gd::System::FlushDirtyModules` function [SDK]

Added the gd::System::FlushDirtyModules function to directly generate commands for a module when it has been placed in a reconfigurable state (a changed state), with the specification of arguments.

Note 191-14: (GX) Added support for command buffer jumps to the `gd::System::StartRecordingPackets` function [SDK]

Added RECORD_3D_COMMAND_BUFFER_FOR_JUMP as a value that can be specified for the gd::System::StartRecordingPackets function's usage argument.
When this value is specified, the existing 3D command buffer can be handled as a subroutine.

Note 191-15: (HTTP) Made `http_Result.h` public [SDK]

Since http::Initialize and http::Finalize are used via http_Initialize.h, made http_Result.h public.

Note 191-16: (MATH) Revised the random number generation class name [SDK]

The RandomGenerator class that generates random numbers was mistakenly notated as RamdomGenerator. This was fixed.
Since the RamdomGenerator class will probably be deleted, do not use it from now on.

Note 191-17: (OS) Fixed a bug in the functions that get the number of resources [SDK]

If the GetMaxCount and GetCurrentCount functions, which are member functions of the Event, Mutex, Semaphore, Thread, and Timer classes, were repeatedly called, they would stop working normally. This bug has been fixed.

Note 191-18: (TOOL) Added `FriendAddTool` [SDK]

Added the FriendAddTool tool, to assist in the addition and deletion of friends.

Note 191-19: (TOOL) Improved error display in `loadrun` [SDK]

Added dedicated error messages, for error display when there is no debugger, and so forth.
Revised to display usage when program arguments are blank.

Note 191-20: (TOOL) Made revisions specific to the start of the debugger in `loadrun` [SDK]

Changed the feature that hides the debugger upon starting in the system tray to the --systray option, and changed it so that when the debugger starts it will be displayed in a window.
In addition, changed the feature that exits the debugger when ctr_loadrun32 terminates to the --exit-debugger option, and changed it so that the debugger will not quit when no options are specified.

Note 191-21: (TOOL) Revised `makebanner` [SDK]

Made the following modifications to makebanner.

Fixed the partial error that existed in determining the horizontal width of strings for the Chinese, Korean, and Taiwan regions.
Deleted from the reference the description of the StreetPass ID, which was slated for deletion.

Note 191-22: (TOOL) Fixed a bug where a CCI of the wrong size was created in `makerom` [SDK]

When the file size stored in ROMFS was at a certain level or higher, a CCI file of a size that exceeded that set in MediaSize would be created. This bug has been fixed.

Note 191-23: (TOOL) Fixed a bug in `ctr_GxCommandAnalyzer`, the command buffer parsing tool [SDK]

There was a bug in ctr_GxCommandAnalyzer that prevented you from being able to specify a relative path for an input file. This has been fixed.
In addition, documentation has been added on the format of input files.

Note 191-24: (UDS) Made deletions from the API reference for the description of `ScanResultReader::Merge` function [SDK]

When beacons were merged with the ScanResultReader::Merge function, it was possible that the same beacon information as that of the originating source would be duplicated. Therefore a description of this function was deleted from the API reference.
Plan to make this function unusable in CTR-SDK 4.0.

Note 191-25: (ULCD) Added a function to get 3D volume values [SDK]

Added the nn::ulcd::Get3DVolume function as a function to directly get the console's 3D volume value.

Note 191-26: (Y2R) Added a description specific to the return values of the `Initialize` function [SDK]

Added information to the API reference that the Initialize function may return false.

Known Issues with SDK 3.3.1 Release

In the GD LightingSample demo, you will see a phenomenon where the area the light is shining on will periodically flash.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used
A large font size is set (the size that causes the problem could vary depending on the font)
Two levels of gradation are set for the number of gradations under Advanced Settings (this applies to both the A4 and LA4 settings)

■ CTR-SDK Version 3.3.1 Sample Demos

(2012/01/25)

Note 190-01: (CFG) Revised `coppacs` sample demos [Sample Demos]

In conjunction with the fix for the AppletMsetScene enumerated type bug, revised the cfg/coppacs sample demo.

Note 190-02: (CRYPTO) Added a sample demo of the AES encryption API [Sample Demos]

Added crypto/BlockCipher as a sample demo that uses the AES encryption API.

Note 190-03: (GX) Fixed a bug in the access target for gx/GD/FogAndLight lookup tables [Sample Demos]

In the gx/Gd/FogAndLight demo, there was a bug that accessed extra-regional addresses, specific to lookup tables for fog. This has been fixed.

Note 190-04: (GX) Fixed a bug in the updating of gx/GD/LightingSample lookup tables [Sample Demos]

In the LightingSample demo, there was a problem in updating lookup tables configured for point light sources, and lighting results were not appropriate.
This bug has been fixed.

Note 190-05: (UDS) Fixed a bug where `SendThread` does not terminate when a simple network is disconnected and when wireless mode is off [Sample Demos]

In the uds/simple demo, there was a bug where SendThread, which should ordinarily terminate when the network is disconnected during UDS communication or when wireless mode is off, would not terminate. This has been fixed.

Known Issues with SDK 3.3.1 Sample Demos

None.

■ CTR-SDK Version 3.3.0 System Updater 0.16.64

(2012/01/13)

Note 189-01: (CFG) Fixed a bug where the development menu starts when initializing the system for the China, Korea, and Taiwan markets [System Updater]

A bug resulted in the starting of the development menu after initializing the system for the China, Korea, and Taiwan markets. This has been fixed.

Note 189-02: (Built-in Fonts) Revised the built-in fonts for China, Korea, and Taiwan [System Updater]

The display position for characters of the built-in fonts for the China and Korea regions (excluding Nintendo's special characters) was lowered by two pixels, since their display position was previously higher than Japanese, North American, and European fonts.
The display position for characters of the built-in fonts for the Taiwan region was lowered by one pixel, since their display position was previously higher than Japanese, North American, and European fonts.

Going forward, the built-in fonts in System Updater and the bcfnt files distributed in the CTR-SDK will have this fix applied but only the Chinese, Korean, and Taiwan built-in system fonts for the Japan, North America, and Europe markets will be updated via an Internet system update, so there will be systems without the update on the market as well.
Note that when using built-in China, Korea, and Taiwan system fonts in the Japan, North America, and Europe markets.

Known Issues with System Updater 0.16.64 in SDK Version 3.3.0

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 3.3.0 Release

(2011/12/22)

Note 188-01: (CEC) Deleted the `Initialize` function that does not specify an allocator [SDK]

Since an allocator specification is needed when accessing a box, for example, the Initialize function that does not specify an allocator was deleted.
When attempting to use it, a warning will be displayed during the build.

Note 188-02: (CRYPTO) Added a function for AES encryption [SDK]

Added a function to use AES encryption.

Note 188-03: (CRYPTO) Added an RSA signature verification feature that uses SHA-1 digests [SDK]

Added an RSA signature verification feature that uses SHA-1 digests.
This API maintains compatibility with signatures created on earlier platforms, so unless there is a reason for not doing so, use the signature verification feature that uses SHA256.

Note 188-04: (CRYPTO) Halted the publication of `crypto::Initialize` and `crypto::Finalize` [SDK]

Since calling the crypto::Initialize and crypto::Finalize functions is unnecessary, they were changed to become private.
Developers who used these functions are asked to cease using them.

Note 188-05: (CRYPTO) Changed the name of the function that gets sizes [SDK]

Functions that got sizes in byte units and constants with names that included the word Length have been changed to Size.
The old names can be used, but will produce a warning in the compiler.

Note 188-06: (CX) Source code made public [SDK]

The CX library source code has been released.

Note 188-07: (DBG) Added macro references related to panic and assert [SDK]

Added references for macros like NN_PANIC and NN_ASSERT.

Note 188-08: (DBG) Cleaned up the behavior related to panic and assert [SDK]

Cleaned up and standardized the behavior specific to macros like NN_PANIC and NN_ASSERT, including making changes to the format of debug output.

Note 188-09: (DBG) Fixed a bug where additional characters were output if a string exceeding the maximum length was passed to the log output function [SDK]

There was a bug where additional characters were output if a string exceeding the maximum length was passed to the log output function. This has been fixed.

Note 188-10: (DBG) Added function to get start parameters [SDK]

Added a feature to pass start parameter to applications when starting them in loadrun during development.
The application can get parameter data using the nn::dbg::CTR::GetArgc, nn::dbg::CTR::GetArgv, nn::dbg::CTR::GetArgBinary and nn::dbg::CTR::GetArgBinarySize functions.

Note 188-11: (DLP) Revised the `FakeClient::StartScan` function so that it will always specify a unique ID [SDK]

Changed it so that an error will result when a unique ID is not specified for a title discovered during a scan.
Until now, the specification of a unique ID was not necessary, but if a scan was performed without specifying a unique ID, you could obtain title information that was not related to your title, and this was the cause of a bug.

Note 188-12: (DevEnv) Added an ID list document [SDK]

Added documentation that listed IDs related to the CTR-SDK to $CTR_SDK/documents/TechnicalNotes/IdCatalog/IdCatalog.html.

Note 188-13: (DevEnv) Discontinued the generation of hard links to shader binaries duplicated beneath the `SHBIN_INSTALL_ROOT` path [SDK]

Changed it so that hard links will no longer be created when the shader binaries that are generated beneath objects/CTR.Shader are duplicated to a location beneath SHBIN_INSTALL_ROOT.

Note 188-14: (DevEnv) Changed the structure of the `index.html` table of contents [SDK]

Changed the structure of the table of contents for $CTR_SDK/index.html.

Note 188-15: (DevEnv) Added system mode dev2 support [SDK | System Updater]

Changed it so that even on development hardware, the system mode can be set to dev2 with the Config tool.
As a result, the feature to set the system mode on development hardware to dev1 will be deleted from System Updater.
In addition, this new Config tool that supports this change will be removed from the CTR-SDK package, since there will be problems with its use with the old System Updater applied to the system.

dev2 will continue to work with a development memory size of 80 MB, and be a system mode that enables the use of the HOME Menu and the library applet.
See the Config reference for more information on settings and limitations.

Note 188-16: (DevEnv) Added description of macros to reference specific to build rules [SDK]

Added a description of the macros defined with the CTR-SDK's build system to the reference specific to the build rules, $CTR_SDK/documents/SDKRules/BuildRules.html.

Note 188-17: (DevEnv) Added support for the China, Korea, and Taiwan markets [SDK | System Updater]

Added support for the Chinese, Korean, and Taiwan markets.
Use of the newly updated tools such as makerom, makebanner and BannerModelConverter enable the creation of applications for the China, Korea, and Taiwan markets.
System Updater also has additions for the China, Korea, and Taiwan markets. At present there are the following limitations.

Since there are no Nintendo 3DS cameras, you will halt on jumping from the HOME Menu camera
Since the HOME Menu's BOSS code is not officially issued, upload tasks, and so forth, will not function
Even if the language is set to English for the Taiwan market, the error messages for the Error/EULA applet and the title for the e-manual viewer will all be displayed in Traditional Chinese
When a Parental Controls PIN has been set in System Settings for the Taiwan market, you will be asked to enter that PIN every time you start a TWL application
General issues specific to text for system applications and applets for the China, Korea, and Taiwan markets are still tentative

Note 188-18: (DevEnv) Added references for basic types and environmental macros [SDK]

Added references specific to macros for determining endian and basic types for s32, and so forth.

Note 188-19: (DevEnv) Revised it so that its not a problem if a space is included in the `CTRSDK_ROOT` environmental variable [SDK]

Fixed the problem that prevented normal builds from occurring when a space was included in the path set for the CTRSDK_ROOT environmental variable.

Note 188-20: (DevEnv) Updated the document explaining the differences between development systems and production hardware [SDK]

Updated the documentation specific to the differences between the development and production hardware, $CTR_SDK/documents/TechnicalNotes/AboutHardwareDifference/AboutHardwareDifference.xlsx.

Added information about peers with whom you can communicate in DLP download play.
Updates related to FS access forced delay emulation
Added information about the communication ID generated in IR

Note 188-21: (DevEnv) Fixed an issue where the image files within the API reference were not included in the package [SDK]

The image files within the API reference were not included in the CTR-SDK package. This has been revised so that they are included.

Note 188-22: (Dev) Fixed a bug specific to dependencies in e-manual files [SDK]

Revised the build rules to check for updates in e-manual (.bcma) files.

Note 188-23: (FRIENDS) Added functions specific to friend registration [SDK]

Added a function to register friends to the friend list from the application.

Note 188-24: (FS) Changed so that the filename is displayed in the log when a fatal error occurs, when attempting to open a file or directory [SDK]

In builds where log display is enabled, made a change so that when the constructor for classes such as nn::fs::FileStream and nn::fs::Directory or opening with the Initialize function fails and a fatal error results, the name of the file that the attempt to open was being performed on will now be displayed in the log.

Note 188-25: (FS) Removed private APIs from the header [SDK]

Since the fs::Finalize function is private, its declaration has been removed from the header.

Note 188-26: (GR) Fixed a bug in the `gr::Vertex::MakeEnableAttrCommand` function, when using the interleave array [SDK]

When interleaved arrays are enabled and when they comprise a mixture of vertex attributes of different byte sizes for each vertex, padding is added automatically. An invalid command is generated because this automatic padding was not taken into account in the implementation. This was a bug.
When this invalid command was executed, there was the potential for a GPU hang, so revisions were made for an implementation that took the automatically added padding into account.

Note 188-27: (GR) Fixed a bug in the loss of block mode setting command creation for render buffers, and added a setting function [SDK]

There was a bug in the nn::gr::FrameBuffer::ColorBuffer::MakeCommand where a command was not generated for bit [0:0] of register 0x11b.
A second argument was then added to the nn::gr::FrameBuffer::ColorBuffer::MakeCommand function, and when its value was true, the function was revised to internally call the MakeRenderBlockModeCommand function.
By default, this argument's value is false.
The MakeRenderBlockModeCommand function generates a block mode (8 or 32) setting command for the render buffer to the nn::gr::FrameBuffer::ColorBuffer class, and has been newly added.

In addition, it has been made to generate a command that returns BLOCK_SIZE8 to the block mode for the render buffer to the nn::gr::MakeDisableAllCommand function.
As long as you are not changing the block mode, if the nn::gr::MakeDisableAllCommand function is called, the normal block mode will be returned and there will be no problem.

Note 188-28: (GR) Added the `ShaderLite` class to lower the amount of consumer memory [SDK]

Since the amount of memory consumed by the Shader class is large, ShaderLite was added to lower the amount of memory consumed.

Note 188-29: (GX) Fixed an error in the limitations specific to the height argument for the `nngxFilterBlockImage` function [SDK]

The limitation on the height argument of the nngxFilterBlockImage function was that it had to be a multiple of 8, but this was an error. It has to be a multiple of 16.
This has been revised in documentation and in the function's error checking section.

Note 188-30: (GX) Added the `nngxFlush3DCommandNoCacheFlush` function [SDK]

Given that a kick command was added when the nngxAddSubroutineCommand function was called, when the nngxFlush3DCommand function is called, a flush of the cache for the buffer up to the kick command is performed.
A function that does not perform this cache flush was added.
Instead of having the cache flush occur several times, use this function to skip the flush, and then use the nngxUpdateBuffer function to flush all at once, at the end, to lower the CPU cost.

Note 188-31: (GX) Changed it so that the timeout feature of the `nngxWaitCmdlistDone` function is enabled even in Release builds [SDK]

The nngxWaitCmdlistDone function can also determine timeouts, via the nngxSetTimeout function, but until now this was only enabled in Debug and Development builds.
With this update, it is now also enabled in Release builds.

Note 188-32: (GX) Updated the shader assembler tool [SDK]

The following changes were made to the shader assembler tool.

The setting range for the init argument of the defi instruction has been changed from [0, 255] to [-128, 255]
The latency of the performance estimate feature, the litp instruction, has been revised to 4

Note 188-33: (GX) Updated documentation [SDK]

Updated DMPGL20_specification.pdf.

Revised the content of Number of Vertex Attributes in Others.
Added Limitations 4 to Vertex Buffers in Others.
Revised the calculation methods for random number generation, shift mode, and the mapping calculator for PROCTEX_ADDSQRT2_DMP and PROCTEX_RMAX_DMP in Procedural Textures.

Updated DMPGL20_programming_guide.pdf.

Added Vertex Array Address Alignment to Performance Improvement Methods.

Updated DMPGL20_system_API_specification.pdf.

Added Limitations Specific to Load Arrays.
Added a description of the value of NN_GX_CMDLIST_HW_STATE, a factor in system hangs when invalid values are output from the vertex shader and when invalid settings are made for the load array.
Added a supplemental description to Vertex Shader Integer Registers.
Removed the limitation that disabled the command list object execution completion timeout feature in Release builds.

Updated VertexShaderReferenceManual.pdf.

Changed the specifications of the init argument of the defi instruction.
Added description for the number of stages for arithmetic instructions in Latency of Arithmetic Instructions and the cmp Instruction.
Revised Latency of Branching Instructions.

Note 188-34: (GX) Added a vertex shader manual [SDK]

Added documentation specific to vertex shaders under $CTR_SDK/documents/shader.

Note 188-35: (GX) Changed the maximum number of vertex attributes from 12 to 16 (the maximum when using a vertex buffer is 12) [SDK]

When using the DMPGL API, if the vertex buffer is not in use, the maximum number of vertex attributes that can be used has been revised to 16.
In addition, when using the vertex buffer and rendering with the glDrawElements function, when an independent vertex array is defined with 12 vertex attributes, a limitation has been added so that it will result in a GL_INVALID_OPERATION error.

As a result of these revisions, the program state cache and vertex state cache will no longer be compatible.
Note that state cache data will need to be re-generated with this version.

Note 188-36: (HID) Added +Control Pad emulation with the Circle Pad Pro's circle pad (R) [SDK]

The +Control Pad emulation available on the CTR's circle pad has been added to the Circle Pad Pro's circle pad (R).

Note 188-37: (HID) Fixed a bug where SELECT could not be used even when set to debug mode, when using the Circle Pad Pro [SDK]

When using the Circle Pad Pro, there was a bug where BUTTON_SELECT_FOR_DEBUGGING input was not available, even when setting debug mode from the Config tool and executing the nn::hid::EnableSelectButton function. This has been fixed.

Note 188-38: (HIO) Updated the `HostIO` library manufactured by IS [SDK]

IS' HostIO library for the debugger has been updated to the 20111205 version.

Note 188-39: (INIT) Added information specific to unintentional memory allocation when using STL [SDK]

When using STL, unexpected memory allocation would occur before the start of nnMain.
Information on this STL behavior has been added to the System Programming Guide.

Note 188-40: (INIT) Functions that can be used with `nninitStartUp` [SDK]

Added a list of CTR-SDK functions that can be used within nninitStartUp, the function for memory management mechanism initialization.
A link to the list can be found on the nninitStartUp page in the API reference.

Note 188-41: (MATH) Added API to update only the rotating portion of a 3×4 matrix [SDK]

Added the MTX34RotXYZRadPartially, MTX34RotXYZDegPartially, MTX34RotAxisRadPartially, and MTX34RotAxisDegPartially function to update only the rotating portion of a specified matrix.

Note 188-42: (MATH) Added a random number generating class [SDK]

Added a class to generate random numbers using a linear congruence method.

Note 188-43: (NEWS) Added the `PostNewsUrl` function [SDK | System Updater | Sample Demos]

Added a function to post notifications with URLs.
To this function was added a function to calculate the necessary work buffer size, GetWorkBufferSizeForNewsUrl.
When a post is made with the PostNewsUrl function, the CTR browser is started to the URL specified within the notification posted to the notification list.
In addition, the news/news_test demo was changed to use this function.

Note 188-44: (NGC) Added a feature to detect profanity within text [SDK]

Added a feature to detect and mask profanity within text.

Note 188-45: (OS) Removed functions with Light-related timeouts [SDK]

Since a fatal bug was found, the nn::os::LightEvent::TryWait(nn::fnd::TimeSpan) and os::LightSemaphore::TryAcquire(nn::fnd::TimeSpan) functions were removed.

Note 188-46: (OS) Added a function that gets the number of resources [SDK]

Added member functions that get the maximum number and current number of resources for each of the following classes: Event, Mutex, Semaphore, Thread, and Timer.
In addition, relevant information was added to the System Programming Guide.

Note 188-47: (RO) Updated the DLL documentation [SDK]

The following content was updated in documentation related to DLLs.

The DLL Manual $CTR_SDK/documents/TechnicalNotes/Dll/DllManual.html

Added a description of the handling of static libraries.
Noted that the CTR-SDK's static libraries must not be converted to DLLs.
Noted that the nnroUnresolved function can be used with static modules.
Noted that public types of static modules can be specified.

Build System Development for DLLs $CTR_SDK/documents/TechnicalNotes/Dll/BuildSystemDevelopmentGuideForDll.html

Added a description of the build steps required to use the nnroUnresolved function with static modules

Note 188-48: (RO) Added support for `nnroUnresolved` in static modules [SDK]

Although nothing would work, even when the nnroUnresolved function was defined in static modules, this was changed to be the same as for dynamic modules so they could be called when calling an unresolved function.
Several changes are needed when constructing your own build system.
For more information, see $CTR_SDK/documents/TechnicalNotes/Dll/BuildSystemDevelopmentGuideForDll.html.

Note 188-49: (TOOL) Added the command buffer parsing tool [SDK]

Added a command line tool to convert the 3D command buffer output from the debugger, and so forth, into a more easily understood format.

Note 188-50: (TOOL) Fixed a bug with `BossLotcheckTool` [SDK]

A bug prevented dedicated immediate-execution tasks (FGONLYT) from being deleted in the BossLotcheckTool. This has been fixed.

Note 188-51: (TOOL) Added support for negative values in command line options for the CUI version of FontConverter [SDK]

Revised the command line options of the CUI version of FontConverter so that the options that take numerical values as parameters (-ol, -or, and so forth) can now take negative values too.

Note 188-52: (TOOL) Made `DevMenu` private [SDK]

DevMenu is automatically imported with System Updater, so there is no need to release it as part of the CTR-SDK. It has, therefore, been made private.

Note 188-53: (TOOL) Added parameters for add-on content to RSF files [SDK]

Made add-on content codes and add-on content indices specifiable.
For more information, see ctr_makerom32.

Note 188-54: (TOOL) Added `TwlNandFiler` [SDK]

Added a tool to manipulate save data for TWL Nand applications imported to the CTR.

Note 188-55: (TOOL) Made the API from `WaveCodecCtr.dll` public [SDK]

Added documentation on the API for the WaveCodecCtr.dll that enables compression to the DSP ADPCM format within user applications.

The documentation also includes cautions on compression of loop waveforms, so refer to it when calling the nn::snd::EncodeAdpcmData function on production hardware to compress to the DSP ADPCM form.

For more information, see $CTR_SDK/documents/tools/WaveCodecCtr.dll.

Note 188-56: (TOOL) Added support for standard input and output for the `ctr_compress` tool [SDK]

Revised the ctr_compress tool to enable use of standard input and output.

Note 188-57: (TOOL) Added a feature to `ctr_loadrun` to pass program parameters to CTR applications [SDK]

Added a feature to ctr_loadrun for passing program parameters to CTR applications.

Note 188-58: (TOOL) Revised the error messages in `ctr_loadrun` [SDK]

Removed the display of stack traces from error messages in ctr_loadrun.

Note 188-59: (TOOL) Fixed a bug where some strings were ignored with `ctr_makerom`'s `-D` option [SDK]

A bug would halt the parsing of any text that preceded a '.', '\' or '^' when strings containing those characters were passed as values to the -D option. This has been fixed.

Note 188-60: (TOOL) Fixed a bug where ROMs were generated that might not be able to start [SDK]

When a ROM was generated with ctr_makerom32.exe, when certain conditions were met on the SD card, a bug would result in the generation of a ROM that could not start. This has been fixed.
As a result of this fix, the maximum ROM size may increase on the order of several KB.

Note 188-61: (UDS) Added a function for consolidating scan results [SDK]

Added a function to consolidate the scan results (instances of ScanResultReader) obtained with the nn::uds::Scan function.
They are consolidated with the ScanResultReader::Merge function.
Also added the ScanResultReader constructor to generate blank scan results.
This can simplify the repetition of scans.

Note 188-62: (UDS) Added the `CreateNetwork` function to be able to set arbitrary data to a beacon [SDK]

Added the CreateNetwork function which sets arbitrary data for the beacon and builds a new network.

Note 188-63: (UTIL) Added functions for base64 encoding and decoding [SDK]

Added functions to perform base64 encoding and decoding.

Note 188-64: (UTIL) Added the utility class [SDK]

Added the utility class for nn::util::Singleton, and so forth.

Known Issues with SDK 3.3.0 Release

In the GD LightingSample demo, you will see a phenomenon where the area the light is shining on will periodically flash.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used
A large font size is set (the size that causes the problem could vary depending on the font)
Two levels of gradation are set for the number of gradations under Advanced Settings (this applies to both the A4 and LA4 settings)

■ CTR-SDK Version 3.3.0 System Updater 0.16.24

(2011/12/22)

Note 187-01: (DevEnv) Added system mode dev2 support [SDK | System Updater]

Note 187-02: (DevEnv) Fixed a bug where the system would hang if the development menu was started immediately after inserting a DS/DSi card [System Updater]

When starting a DS/DSi card application from the development menu, the system would hang if the start was immediately after inserting a card.
This bug has been fixed.

Note 187-03: (DevEnv) Updated DevMenu [System Updater]

Made the following revisions to the development menu.

When the POWER Button was pressed to exit while starting the System Settings, there was a bug that kept the screen black. This has been fixed.
Revised text displayed on the upper screen (from Memory Mode to System Mode).

Note 187-04: (NEWS) Added the `PostNewsUrl` function [SDK | System Updater | Sample Demos]

Added a function to post notifications with URLs.
To this function was added a function to calculate the necessary working buffer size, GetWorkBufferSizeForNewsUrl.
When a post is made with the PostNewsUrl function, the CTR browser is started to the URL specified within the notification posted to the notification list.
In addition, the news/news_test demo was changed to use this function.

Note 187-05: (OS) Fixed a bug where the system would hang when attempting to import an invalid file from the debugger [System Updater]

There was a bug that caused the system to hang when a CIA file in an invalid format or a file other than a CIA file was attempted to be imported by the debugger. This has been fixed.

Note 187-06: (TOOL) Improved termination for the `Config` tool [System Updater]

Made changes so that, with the Config tool in a started state, when the POWER Button is briefly pushed, the Config tool will terminate and return to the System menu.

Note 187-07: (TOOL) Added a feature to import CIA files on the PC using `HostIO` in `DevMenu` [System Updater]

Added a feature to import CIA files on the PC using HostIO in DevMenu.
Set the directory where import will incur on the PC to the DEVMENU_ROOT environmental variable, after which you will need to start HIO-Daemon.
If you are using development hardware, you can import from a PC using UIC-MIDI.
As a result of this, the Import mode in DevMenu was changed to the SDMC and HIO mode.

Note 187-08: (TOOL) Added a feature to delete CIA files in `DevMenu` [System Updater]

Added a feature to delete CIA files in the SD and HIO modes in DevMenu.
Delete a CIA file with the X Button, and delete all CIA files in the current directory with the LR + X Buttons.
Import and then delete with the X + A Buttons, and import and then delete all the CIA files in the current directory with the LRX + A Buttons.

Note 187-09: (TOOL) Added support for pressing the POWER Button immediately after starting `DevMenu` [System Updater]

There was a bug that halted DevMenu if the POWER Button was pressed immediately after starting it. This has been fixed.

Known Issues with System Updater 0.16.24 in SDK Version 3.3.0

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 3.3.0 Sample Demos

(2011/12/22)

Note 186-01: (BOSS) Revised the sample demo for the NSA list feature [Sample Demos]

In the sample_nsalist demo, when downloading the files in the list, this has been revised to use instant download tasks.

Note 186-02: (CFG) Added a sample demo that uses COPPACS [Sample Demos]

Added a sample demo that uses COPPACS.

Note 186-03: (HID) Added the `AppRecommendedFlow` demo [Sample Demos]

Added the AppRecommendedFlow demo that reflects the recommended flow of use for the Circle Pad Pro.
Together with this change, a reference page has been added and a change to folder structure has been made (extra_pad has been changed to simple and moved under hid/ExtraPad).

Note 186-04: (HIO) Added Release build support for the `hio` demo [Sample Demos]

The hio demo has been changed so that it can even be built as a Release build.

Note 186-05: (NEWS) Added the `PostNewsUrl` function [SDK | System Updater | Sample Demos]

Note 186-06: (RO) Simplified the `simple` demo and added the `plugin` demo [Sample Demos]

Simplified the simple demo. Separated out the plugin demo that simultaneously used several modules that have the same symbols as were used in the simple demo.

Note 186-07: (SND) Added support for loop playback to the `AdpcmEncDec` sample demo [Sample Demos]

Revised the AdpcmEncDec sample demo so that waveforms were connected perfectly during loop playback.

Known Issues with SDK 3.3.0 Sample Demos

None.

■ CTR-SDK Version 3.2.5 System Updater 0.16.23

(2011/12/06)

Note 185-01: (HOME Menu Camera) Fixed a bug where system would freeze after recovering from sleep [System Updater]

Fixed a rare bug where the system would freeze after recovering from sleep.

Note 185-02: (Nintendo 3DS Camera) Added features to take and play back 3D movies [System Updater]

In addition to the current feature to take pictures, added features to take and play back 3D movies.

Known Issues with SDK 3.2.5 System Updater 0.16.23

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 3.2.5 System Updater 0.16.22

(2011/11/29)

Note 184-01: (OS) Fixed a bug where the debugger would hang when using a sound thread on a system core [System Updater]

Fixed a bug where the debugger would hang when using a sound thread on a system core.
Due to this change, the thread starting address is displayed as 0x100000.

Note 184-02: (OS) Fixed a bug related to compatibility mode save data [System Updater]

Fixed a bug related to compatibility mode save data.

Known Issues with SDK 3.2.5 System Updater 0.16.22

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 3.2.5 System Updater 0.16.21

(2011/11/28)

Note 183-01: (OS) Fixed a bug where sound would stutter in certain applications after recovering from sleep [System Updater]

Fixed a bug where sound would stutter in certain applications after recovering from sleep.
This change does not have any effect on applications that were unaffected by this issue.

Known Issues with SDK 3.2.5 System Updater 0.16.21

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 3.2.5 Release

(2011/11/25)

Note 182-01: (DevEnv) SDK-related changes [SDK]

No SDK-related changes have been made to the functionality except the version information.

Known Issues with SDK 3.2.5 Release

In the GD LightingSample demo, you will see a phenomenon where the area the light is shining on will periodically flash.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used
A large font size is set (the size that is problematic could depend on the font)
Two levels of gradation are set for the number of gradations under the advanced settings (this applies to both the A4 and LA4 settings)

■ CTR-SDK Version 3.2.5 System Updater 0.16.20

(2011/11/25)

Note 181-01: (DLP) Fixed a bug that prevented an error state from occurring when the wireless switch was turned off after the server was initialized [System Updater]

Fixed a bug that sometimes prevented an error state from occurring when the wireless switch was turned off after the server was initialized.

Note 181-02: (FS) Fixed a bug that caused a deadlock during intensive ROM access [System Updater]

Fixed a bug that caused a deadlock during intensive ROM access from multiple threads.

Note 181-03: (HOME Menu) Fixed a bug that on rare occasions caused execution to halt when entering and exiting the HOME Menu and system applets [System Updater]

Fixed a bug that on rare occasions caused execution to halt when entering and exiting the HOME Menu and other system applets.
This was actually changed in CTR-SDK 3.2.2 but was accidentally omitted from the change log.

Note 181-04: (HOME Menu) Fixed a bug that on rare occasions caused execution to halt during application startup [System Updater]

Fixed a bug that would occur on rare occasions when an application was started, causing the Nintendo 3DS logo to be displayed for approximately 20–30 seconds or indefinitely; in some cases execution would halt at the black screen that appears after the logo.
This was actually changed in CTR-SDK 3.2.2 but was accidentally omitted from the change log.

Known Issues with SDK 3.2.5 System Updater 0.16.20

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 3.2.4 System Updater 0.16.9

(2011/11/23)

Note 180-01: (AC) Fixed a bug that caused the initial connection to some access points to hang before it could complete [System Updater]

Fixed a bug that, for some settings, caused the initial connection to some access points to hang before it could complete.
This bug does not occur for any access point to which the system has successfully connected before.

Known Issues with System Updater 0.16.9 in SDK Version 3.2.4

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 3.2.4 System Updater 0.16.18

(2011/11/22)

Note 179-01: (DLP) Fixed a bug that caused a fatal error to occur if the system entered wireless-disabled mode while scanning [System Updater]

Fixed a bug that caused a fatal error to occur if the system entered wireless-disabled mode while scanning with FakeClient.

Note 179-02: (UDS) Fixed a bug that caused a fatal error to occur if the system was closed when the `CreateNetwork` function was called [System Updater]

Fixed a bug that caused a fatal error to occur if the system was closed and entered Sleep Mode at the same time as CreateNetwork was called.

Known Issues with System Updater 0.16.18 in SDK Version 3.2.4

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 3.2.4 System Updater 0.16.17

(2011/11/18)

Note 178-01: (UDS) Fixed `uds::Initialize` [System Updater]

Fixed a problem related to uds::Initialize compatibility.

Known Issues with System Updater 0.16.17 in SDK Version 3.2.4

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 3.2.4 System Updater 0.16.15

(2011/11/17)

Note 177-01: (OS) Fixed a bug related to LCD settings in compatibility mode [System Updater]

Fixed a bug related to LCD settings in compatibility mode.
This fix has absolutely no effect on CTR application behavior.

Known Issues with System Updater 0.16.15 in SDK Version 3.2.4

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 3.2.4 System Updater 0.16.14

(2011/11/15)

Note 176-01: (BOSS) Allowed an upload task's execution count to be increased if it is 0 [System Updater]

You can now increase an upload task's execution count if it has reached 0 because of a task error, therefore allowing the task to be re-executed.
The act of increasing the execution count for a task and then re-executing it used to always result in an error.

Known Issues with System Updater 0.16.14 in SDK Version 3.2.4

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 3.2.4 System Updater 0.16.13

(2011/11/14)

Note 175-01: (OS) Fixed a bug that caused applications to take a long time to start up [System Updater]

Fixed a bug that would occur when you started an application built with CTR-SDK 2.4.x or earlier, causing the Nintendo 3DS logo or the subsequent blank screen to be displayed for a long time.

Known Issues with System Updater 0.16.13 in SDK Version 3.2.4

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 3.2.4 Release

(2011/11/11)

Note 174-01: (ENC) Fixed `PrintResult` [SDK]

Fixed PrintResult to display the correct result for Description—instead of "Unknown"—when it is called on a Result value that belongs to MODULE_NN_ENC.

Note 174-02: (HIO) Fixed a bug that caused IS-CTR-DEBUGGER to hang when it read a directory from an HIO archive [SDK]

Fixed a bug that caused IS-CTR-DEBUGGER to hang when it read a directory from an HIO archive.
The HIO library's HostDirectory::GetNextEntry function was also changed to have different Result values when IS-CTR-DEBUGGER is used.

Note 174-03: (SND) Fixed a bug that caused `DspEffect`'s `IsBufferInUse` function to always return `true` [SDK]

Fixed a bug that caused the DspFxDelay and DspFxReverb classes' IsBufferInUse function to always return true regardless of whether the buffer could be released.

Note 174-04: (TOOL) Fixed a bug that prevented COPPACS settings from being saved in the `Config` tool [SDK | System Updater]

Fixed a bug that prevented COPPACS settings from being saved even after they were changed by the Config tool.

Known Issues with SDK 3.2.4 Release

In the GD LightingSample demo, you will see a phenomenon where the area the light is shining on will periodically flash.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used
A large font size is set (the size that causes the problem could vary depending on the font)
Two levels of gradation are set for the number of gradations under Advanced Settings (this applies to both the A4 and LA4 settings)

■ CTR-SDK Version 3.2.4 System Updater 0.16.12

(2011/11/11)

Note 173-01: (BOSS) Fixed a bug that closed handles that should not have been closed when a dedicated immediate-execution task was registered for immediate execution [System Updater]

Fixed a bug that closed handles that should not have been closed when a dedicated immediate-execution task was registered for immediate execution with the RegisterImmediateTask function.

Note 173-02: (TOOL) Fixed a bug that prevented COPPACS settings from being saved in the `Config` tool [SDK | System Updater]

Fixed a bug that prevented COPPACS settings from being saved even after they were changed by the Config tool.

Note 173-03: (UDS) Fixed a bug that caused the system to freeze after the `DestroyEndpoint` function was called [System Updater]

Fixed a bug that on very rare occasions would cause the system to freeze after the DestroyEndpoint function was called.

Note 173-04: (Nintendo 3DS Sound) Fixed a bug that caused execution to freeze when "Autoplay" was selected [System Updater]

Fixed a bug that caused execution to freeze when "Autoplay" was selected after System Updater 0.16 had been applied.

Note 173-05: (System Settings) Allowed clients to authenticate communication with a server under COPPACS [System Updater]

Changed the COPPACS sequence in System Settings for the U.S. region so that client authentication is used during communication with a server.

Nintendo provides the COPPA Compliance System (COPPACS) for applications aimed at the North American market to comply with the Children's Online Privacy Protection Act (COPPA).
The details of this system are currently under consideration, including the rules for use.

Known Issues with System Updater 0.16.12 in SDK Version 3.2.4

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 3.2.4 Sample Demos

(2011/11/11)

Note 172-01: (FS) Added unmount operations to sample demos [Sample Demos]

Revised FS demos so that each archive can be unmounted.

Known Issues with SDK 3.2.4 Sample Demos

None.

■ CTR-SDK Version 3.2.3 Release

(2011/11/04)

Note 171-01: (AC) Added a note to the API Reference Manual stating that the `GetLastErrorCode` function is not guaranteed to have a particular default return value [SDK]

Added a note to the API Reference Manual stating that the nn::ac::GetLastErrorCode function is not guaranteed to have any particular return value if no errors have ever occurred.

Note 171-02: (TOOL) Added a feature to the `Config` tool that allows it to display serial numbers [SDK | System Updater]

Changed the Config tool so that it now allows you to check the system's serial number.

Known Issues with SDK 3.2.3 Release

In the GD LightingSample demo, you will see a phenomenon where the area the light is shining on will periodically flash.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used
A large font size is set (the size that causes the problem could vary depending on the font)
Two levels of gradation are set for the number of gradations under Advanced Settings (this applies to both the A4 and LA4 settings)

■ CTR-SDK Version 3.2.3 System Updater 0.16.9

(2011/11/04)

Note 170-01: (DevEnv) Revised the dummy profanity that is used to check behavior against the guidelines [System Updater]

Shortened the dummy profanity strings that are registered for checking application behavior against the guidelines because they used to be too long to be verified.

Note 170-02: (FS) Fixed a bug that prevented responses from being returned if a CTR Card was removed while it was being accessed [SDK]

Fixed a bug that sometimes prevented system responses from being returned if a CTR Card was removed while it was being accessed.
This bug was introduced in CTR-SDK 3.2.2 (System Updater 0.16.8).

Note 170-03: (FS) Fixed a bug that caused the FS library to become unresponsive when an SD card was removed [System Updater]

Fixed a bug that caused the FS library to become unresponsive if an SD card was removed at a particular time.

Note 170-04: (OS) Fixed a bug that prevented the development menu from recovering from Sleep Mode [System Updater]

Fixed a bug that occurred after an application had been started from the development menu once, preventing the development menu from recovering from Sleep Mode later when no applications were running.

Note 170-05: (TOOL) Added a feature to the `Config` tool that allows it to display serial numbers [SDK | System Updater]

Changed the Config tool so that it now allows you to check the system's serial number.

Known Issues with System Updater 0.16.9 in SDK Version 3.2.3

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 3.2.2 Release

(2011/10/28)

Note 169-01: (APPLET) Split up header for functions to jump to System Settings [SDK]

Split off the following functions for jumping to the System Settings from "applet_Api.h" to "applet_AppJump.h".

nn::applet::CTR::JumpToInternetSetting
nn::applet::CTR::JumpToParentalControls
nn::applet::CTR::JumpToDataManagement
nn::applet::CTR::IsFromMset

Note 169-02: (CFG) Revised function for getting COPPACS restrictions [SDK]

Fixed a bug where the function for getting COPPACS restrictions would sometimes determine that the restrictions could be unlocked using the Parental Controls PIN code, even if the Parental Controls settings were disabled.

Note 169-03: (CFG) Added function to determine whether the System Settings are configured to support COPPACS [SDK | System Updater]

Added function to determine whether COPPACS is enabled in the System Settings.

Note 169-04: (FS) Revised description of ROM-access performance by CTR card applications [SDK]

Upwardly revised the overhead time of ROM access by CTR card applications in the Access Priorities section of the fs library.
Any performance designs based on the information in this document from CTR-SDK 3.2 must be reviewed.

Note 169-05: (GX) Updated the documentation [SDK]

Updated the documentation as follows.

General

Revised copyright statement.

Updated DMPGL20_programming_guide.pdf.

Renamed Vertex Attribute Data Types to Vertex Attribute Data Types, and the Relationship between the Transfer Speeds of Data Sizes, and revised content.

Updated DMPGL20_specification.pdf.

Added description of lookup-table output value range to Lookup Table (LUT) in DMP Fragment Lighting.
Added restriction that distance attenuation must be disabled when the Distance Attenuation item of DMP Fragment Lighting is layer config 7.

Updated DMPGL20_system_API_specification.pdf.

Added additional description of index array settings register 0x227.
Added restriction to byte enable of rendering size settings register 0x11e.
Added restriction that distance attenuation must be disabled when layer config 7 is set.

Updated VertexShaderReferenceManual.pdf.

Added supplementary description of litp instruction, and revised latency of this instruction from 2 to 4.

Known Issues with SDK 3.2.2 Release

In the GD LightingSample demo, you will see a phenomenon where the area the light is shining on will periodically flash.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used
A large font size is set (it is possible that what size is problematic is dependent on the font)
Two levels of gradation are set for the number of gradations under the advanced settings (this applies to both the A4 and LA4 settings)

■ CTR-SDK Version 3.2.2 System Updater 0.16.8

(2011/10/28)

Note 168-01: (AC) Fixed a bug that caused API to become unresponsive [System Updater]

Fixed a bug where canceling a connection process in the nn::ac::CancelConnectAsync function sometimes caused the AC library API to become unresponsive.
Action in the background could cause this bug even if the application does not explicitly cancel the process.

Note 168-02: (CEC) Changed specifications for checking message size in WriteMessage [System Updater]

Changed the maximum size restriction (messageSizeMax) specified in MessageBox::CreateMessageBox to a fixed value.
The specific effect of this change to the MessageBox::WriteMessage function's error-checking routine will depend on the system's firmware version, as follows.

0.15.41, and 0.16.0 to 0.16.7: If the size of the message to write exceeds messageSizeMax when creating the box, the WriteMessage function will return nn::cec::ResultMessTooLarge.
0.15.20 and earlier, 0.16.8 and later: The WriteMessage function will only return nn::cec::ResultMessTooLarge when the size of the message to write exceeds 100 KB.

Note 168-03: (FS) Revised NAND and SD card access control [System Updater]

Revised control of NAND and SD card that could cause failures when the device is functioning normally, or freezes when there is an error.
This revision could change the timing of determining an access error when removing an SD card that is being accessed.

Note 168-04: (FS) Fixed a bug where process would not return when there were many file accesses at once [System Updater]

Fixed a bug where the process would not return if a number of file accesses (generally 4 or more) occurred in a short time span.

Note 168-05: (OS) Support for register operations when stopped due to break in debugger [System Updater]

It is now possible to manipulate the registers when halted due to a break in the debugger.

Note 168-06: (OS) Fixed a bug where PC register was offset when loading a DLL in the debugger [System Updater]

Fixed a bug where the PC register value would be increased by four when stopped due to loading a DLL in the debugger.

Note 168-07: (OS) Support for register operations when stopped due to `swi` execution in debugger [System Updater]

It is now possible to manipulate the registers when stopped during swi execution in the debugger.

Note 168-08: (OS) Fixed a bug where log output would sometimes be lost if there was frequent output to the debugger log over a long period of time [System Updater]

Fixed a bug where log output would be lost if there was frequent output to the debugger log executed over a long period of time.

Known Issues with SDK 3.2.2 System Updater 0.16.8

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 3.2.1 Release

(2011/10/21)

Note 167-01: (CRYPTO) Change specific to `crypto` initialization [SDK]

Removed unneeded Initialize and Finalize functions from crypto in API reference.
These functions will be removed in a future release.

Note 167-02: (FS) Fixed rare bug that caused corruption of file system `Result` [SDK]

Fixed a rare bug that caused corruption of file system Result.

Note 167-03: (FS) Revised description of SD access performance [SDK]

Upwardly revised the overhead time of access to the SD card in the Access Priorities section of the FS library.
Any performance designs based on the information in this document from CTR-SDK 3.2 must be reviewed.

Note 167-04: (TOOL) Fixed a bug where inserting a 32 GB SD card in DevMenu would cause a freeze [SDK]

Fixed a bug where inserting a 32 GB SD card in DevMenu would cause a freeze.

Note 167-05: (TOOL) Fixed a bug where running the CTR browser in DevMenu would cause a freeze [SDK]

There was a bug where running the CTR browser from the DevMenu program list mode screen would cause a freeze.
This was fixed by preventing the CTR browser from being started from the DevMenu. The CTR browser can only be started from the HOME Menu.

Note 167-06: (TOOL) Added feature to display export and import progress in SaveDataFiler [SDK]

Changed SaveDataFiler so that when importing and exporting save data, it displays the name of the file being moved and the progress.

Note 167-07: (TOOL) Added feature to SaveDataFiler to destroy a file without destroying other entries [SDK]

Added a feature to SaveDataFiler to destroy a file without destroying other entries.
Execute this feature by selecting the file to destroy, and pressing the L + Y Buttons.
Note: This feature will not always destroy the file.

Known Issues with SDK 3.2.1 Release

In the GD LightingSample demo, you will see a phenomenon where the area the light is shining on will periodically flash.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used
A large font size is set (it is possible that what size is problematic is dependent on the font)
Two levels of gradation are set for the number of gradations under the advanced settings (this applies to both the A4 and LA4 settings)

■ CTR-SDK Version 3.2.1 System Updater 0.16.7

(2011/10/21)

Note 166-01: (AC) Fixed a bug when connecting to zone during Sleep Mode [System Updater]

Fixed a bug where the system could connect to some access points multiple times during Sleep Mode in an environment that has multiple Nintendo Zones and hot spots, rather than connecting once to all access points.

Note 166-02: (AC) Reduced time needed to free handle when finalizing library [System Updater]

Reduced the time needed to free the handle passed to the library after calling the nn::ac::Finalize function. This addresses an issue with delays in freeing this handle.

Note 166-03: (AC) Fixed a bug where canceling a connection process would have no effect [System Updater]

Fixed a bug where canceling a connection process using the nn::ac::CancelConnectAsync function would fail at certain times.

Note 166-04: (AC) Fixed a bug where the system could not correctly connect to an access point in an environment where connections from a specific application were prohibited [System Updater]

Fixed an extremely rare bug where the system could not connect to the right access point in an environment where connection from a specific application (such as Nintendo Zone) was prohibited.

Note 166-05: (AC) Fixed a bug where a library could not be initialized if repeatedly finalized without waiting for an asynchronous process to complete [System Updater]

Fixed a bug where a library could not be initialized if repeatedly finalized while an asynchronous process was running.

Note 166-06: (APPLET) Fixed a bug where closing an application from the HOME Menu could create static in the menu audio [System Updater]

The following bug was fixed. This was listed in the "Symptoms of Known Issues" for CTR-SDK 3.1.

[APPLET] Static occurs when exiting some applications from the HOME Menu.

This was actually changed in CTR-SDK 3.2 but was accidentally omitted from the changelog.

Note 166-07:(APPLET) Revised jump to System Settings in other than Japan region [System Updater]

Revised feature where applications could only jump to System Settings in the Japan region.

Note 166-08: (DLP) Fixed a bug causing fatal error during or after scanning [System Updater]

Fixed a bug where a call to a function during scanning (between the calls to the FakeClient::StartScan function and FakeClient::StopScan functions) or after scanning would result in a fatal error.
This was actually changed in CTR-SDK 3.2 but was accidentally omitted from the change log.

Note 166-09: (DevEnv) Added dummy profanity for checking guidelines [System Updater]

Added dummy profanity to check for compliance with guidelines.

Note 166-10: (FS) Fixed a bug where an unexpected error was returned when accessing SD card [System Updater]

Fixed rare bug where an unexpected error would be returned when accessing an SD card, or the card would subsequently become inaccessible.
This bug has existed since System Updater 0.16.6 (version supporting CTR-SDK 3.2).

Note 166-11: (FS) Fixed a bug where low-priority file access on SD card would fail [System Updater]

Fixed a bug where a file access to an SD card would fail with ResultMediaAccessError if it coincided with a high-priority file access to another device.

Note 166-12: (FS) Fixed a bug where loading of large files would not complete [System Updater]

Fixed a bug where a read from a relatively large file would never complete.

Note 166-13: (HOME Menu) Support for EU and US download application demos [System Updater]

Changed feature so that the message in the dialog appearing when a download application demo starts also appears outside the Japan region.

Note 166-14: (OS) Fixed a bug where frequent log output on the debugger would case a fatal error [System Updater]

Fixed a bug where frequent log output on the debugger would cause a fatal error (0xD9001BF7).

Note 166-15: (TOOL) Changed behavior of System Updater [System Updater]

Changed country setting as follows when the region is changed in System Updater.
Japan region: Japan
European region: Germany
North American region: United States

Note 166-16: (UDS) Fixed a bug where calling the `CreateNetwork` function would cause a fatal error [System Updater]

Fixed a bug where calling the CreateNetwork function would cause a fatal error.

Note 166-17: (UDS) Fixed a bug where a failure when calling the `ConnectNetwork` function in `SPECTATOR` would cause a fatal error [System Updater]

Fixed a bug where calling the ConnectNetwork function and specifying CONNECT_AS_SPECTATOR would cause a fatal error if the ConnectNetwork function was called again with the same conditions immediately after the error was returned.
This was actually changed in CTR-SDK 3.2 but was accidentally omitted from the change log.

Note 166-18: (Software Keyboard) Fixed a bug where conditions for finalizing input did not meet requirement to have a least one non-blankspace character in the input [System Updater]

When the FinishableCondition member of nn::swkbd::CTR::Config is set to FINISHABLE_CONDITION_NON_SPACE, it should not be possible to finalize the input unless the input contains at least one non-blankspace character. Fixed a bug where it was possible to finalize input containing only blankspace characters, depending on the operation.

Note 166-19: (Friend List) Changed maximum number of people that can be found using `Register Friend: Local` [System Updater]

Increased the maximum number of people that can be found using Register Friend: Local from 3 to 10.

Note 166-20: (Friend List) Added Register Friend button when friend card is displayed [System Updater]

Currently, the Register Friend button only appears when the leftmost card in the friend list is selected, but this was changed so that this button appears no matter which card is selected.

Note 166-21: (Friend List) Added a dialog box to notify the user when a friend is formally added [System Updater]

Registering a friend code makes a person a temporary friend, and the person formally becomes a friend via the server. Currently, however, only the display on the friend card changes, and there is no other demonstration of the formal registration.
This has been changed so that a dialog box stating that the two parties are now friends appears when the friend relationship is formally established.

Note 166-22: (System Settings) Added COPPACS restriction to the Parental Controls for the US region [System Updater]

Added COPPACS restriction to the Parental Controls in the System Settings for the US region.

Nintendo provides the COPPA Compliance System (COPPACS) for applications aimed at the North American market to comply with the Children's Online Privacy Protection Act (COPPA).
The details of this system are currently under consideration, including the rules for use.

Note 166-23: (System Settings) Fixed a bug where parts of icons appeared garbled [System Updater]

Fixed a bug where part of the 48x48-pixel application icons were garbled on the Software Management screen, Extra Data Management screen, and StreetPass Management screen.

Known Issues with SDK 3.2.1 System Updater 0.16.7

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 3.2.1 Sample Demos

(2011/10/21)

Note 165-01: (GD) Added sample demo combining Gd with Gl library [Sample Demos]

Added GLCombination sample, combining Gd with Gl library.

Known Issues with SDK 3.2.1 Sample Demos

None.

■ CTR-SDK Version 3.2.0 Release

(2011/10/14)

Note 164-01: (AC) Changed references to "wireless disabled" mode [SDK]

Changed name of "flight mode" and "wireless-off mode" to "wireless-disabled mode."

Note 164-02:(APPLET) Revised the `GetStartupArgument` function [SDK]

The applet::GetStartupArgument function would return true even if the first argument, pParam, was NULL. The function has been revised to return false in this case.

Note 164-03:(APPLET) The `applet::ReceiveDeliverArg` function has been made private [SDK]

The function applet::ReceiveDeliverArg has been made private because it is no longer necessary for the application to call it.
Use the applet::GetStartupArgument function to get the data specified in the applet::RestartApplication function.

Note 164-04: (APPLET) Fixed a bug where system would not go into Sleep Mode if closed while preloading a library applet [SDK]

Fixed a bug where the system would not go into Sleep Mode if closed while preloading a library applet.

Note 164-05: (APPLET) Added an applet to calibrate the Circle Pad Pro [SDK | System Updater | Sample Demos]

Added nn::extrapad, the Circle Pad Pro calibration applet.
The $SampleDemos/applet/extrapad sample demo, which uses the Circle Pad Pro calibration applet, has also been added.

Note 164-06: (APPLET) Revised function for jumping to System Settings [SDK]

Fixed an error in the nn::applet::CTR::JumpToInternetSetting function for jumping to System Settings, which caused the function to jump to the main System Settings screen rather than the Internet Settings screen.

Note 164-07: (BOSS) Improved API reference [SDK]

Improved the API references for the following features, including adding feature overviews.

NSA List (NsaList)
Dedicated immediate-execution tasks (FgOnlyTask)
DataStore upload and download tasks (DataStoreDownloadAction/DataStoreUploadAction)

Note 164-08: (BOSS) Added public-header `include` statements to `boss.h` [SDK]

Included the following header files in "boss.h".

boss_DataStoreUploadAction.h
boss_DataStoreDownloadAction.h
boss_FgOnlyTask.h
boss_NsaList.h

Note 164-09: (CRYPTO) Stopped writing to end of decrypted string during RSA decryption [SDK]

The feature used to write a NULL character to the end of the decrypted string during RSA decryption, but now does not do so.

Note 164-10: (CRYPTO) Made changes related to initializing the CRYPTO library [SDK]

The application no longer needs to call the Initialize and Finalize functions for crypto.

Note 164-11: (CX) Fixed a bug where using BLZ extraction function caused buffer overrun [SDK]

Fixed potential buffer overrun when using the UncompressBLZ and SecureUncompressBLZ functions.

Note 164-12: (CX) Fixed a bug that caused the `SecureUncompressBLZ` function to return an error for valid compressed data [SDK]

Fixed a bug where the SecureUncompressBLZ function sometimes returned an error for input data that can be expanded correctly.

Note 164-13:(CX) Fixed a bug that caused errors in the results from the `UncompressBLZ` and `SecureUncompressBLZ` functions [SDK]

Fixed a bug where different pre-compressed data was obtained using cx::UncompressBLZ and cx::SecureUncompressBLZ functions.

Note 164-14: (DLP) Revised the `Initialize` function to check an `Event`'s `Handle` [SDK]

Revised Initialize functions of FakeClient and Server to return an error when passed an invalid Event Handle.

Note 164-15: (DLP) Changed name of "wireless disabled" mode in reference pages [SDK]

Changed description from "Wireless button is off" to "Wireless disabled."

Note 164-16: (DevMenu) Added display of demo index for download demos [SDK]

Added demo index to descriptions of programs in the upper screen of the Program List Mode screen when the program is a download demo.

Note 164-17: (FRIENDS) Removed `bool pIsShowPlayedGame` from the parameter list of the `GetMyPreference` function [SDK]

Removed bool pIsShowPlayedGame from parameter list of GetMyPreference function, because it was never used.

Note 164-18: (FRIENDS) Added the `IsMyPreferenceValid` function to determine whether the user has specified a publication setting [SDK]

Added IsMyPreferenceValid function to check whether the user has specified a publication setting. This setting governs whether the system publishes the user's online status and what game the user is playing in the initial startup sequence for the friend list.

Note 164-19:(FS) Fixed a bug where removing SD card during access caused memory leak [SDK]

Fixed a bug where removing the SD card while files on the card were being accessed would occasionally cause a memory leak.

Note 164-20: (FS) Added support for Card2 in worksheet for calculating save data capacity [SDK]

Added support for Card2 in worksheet for calculating save data capacity

Note 164-21: (FS) Added feature to set priority for file access [SDK | System Updater]

It is now possible to set priority for file access, and give precedence to higher-priority processing.
Consequently, functions were added to set the priority of namespaces and class members under nn::fs.
See the documentation for details.

Note 164-22:(GR) Added the new `MakePostVertexCacheEntryTypeCommand` function [SDK]

Added a function to generate a command that changes the number of entries in a post-vertex cache.
It lets you switch between the default of 32 and half that (16).
Although reducing the number of entries to 16 normally does not have advantages because it reduces the cache hit rate, it is possible to expand the maximum number of input attributes in the geometry shader to 15 instead.
See the System API Specifications included with the Geometry Shader SDK for details.

Note 164-23:(GX) Revised the PICA macro headers [SDK]

Added register for changing number of entries in post-vertex cache to "gx_MacroReg.h".

PICA_REG_POST_VERTEX_CACHE_NUM = 0x22d

Note 164-24: (GX) Extended the specifications of the `gd::System::StartRecordingPackets` function [SDK]

Changed parameter to the gd::System::StartRecordingPackets function so that the RecordingPacketUsage enumerated type can be specified.

If the RecordingPacketUsage value is RECORD_COMMAND_LIST_COPY, it copies the command buffer. (Prior behavior/default)
If the value is RECORD_COMMAND_LIST_NO_COPY, it reuses the same command buffer.
In the first case, the copied command buffer can later be edited and executed, but the copy process takes time. In the second case, the process time is shorter, but the command buffer cannot be edited, and it also cannot be reused after it is cleared.

Note 164-25:(GX) Added the `nngxFlush3DCommandPartially` function [SDK]

Added the nngxFlush3DCommandPartially function, which can specify the execution size.
This makes it possible to implement command-buffer jumps without using the nngx functions (nngxAddJumpCommand and nngxAddSubroutineCommand).

Note 164-26:(GX) Updated the shader assembler tool [SDK]

Revised the error-checking method so that up to 16 input registers can be used.

Note 164-27: (GX) Updated the documentation [SDK]

Updated the documentation as follows.

Updated DMPGL20_system_API_specification.pdf.

Added description of maximum number of attributes to Register for Setting Number of Vertex Attribute Inputs.
Added description of 13th to 16th input in Register for Setting Input Register Map of Vertex Attributes.
Added specifications allowing the same light source to be specified multiple times to the description of register 0x1d9.
Removed from the description for register 0x1d9 the requirement that IDs be in ascending order.
Revised busy counter value in profiling API. It now uses "busy clock cycles," rather than "busy count."
Described limitations of register settings specific to the dmp_TexEnv[i].srcRgb and dmp_TexEnv[i].srcAlpha texture combiner uniforms.
Added the new nngxFlush3DCommandPartially function.
Added missing conditions from description of bit 0x112 [3:0] in Table 5-48.
Removed GL_SRC_ALPHA_SATURATE from conditions in description of bit 0x112 [3:0] in Table 5-50.

Updated DMPGL20_programming_guide.pdf.

Added "GPU Hangs when Using MultiTexture" to "Troubleshooting."
Added "Address and Size of Command Buffer" to "Performance-Enhancement Techniques."

Updated DMPGL20_specification.pdf.

Added "Number of Vertex Attributes" to "Others."

Updated VertexShaderReferenceManual.pdf.

Changed number of input registers from 12 to 16.

Note 164-28: (HID) Added a class for handling the Circle Pad Pro [SDK | Sample Demos]

Added the nn::hid::CTR::ExtraPad class to handle the Circle Pad Pro.
Consequently, SampleDemos/hid/extra_pad has also been added as a sample demo using this feature.

Note 164-29: (HIO) Changed the `hio` library's return values when an Intelligent Systems debugger is used [SDK]

Changed the return values of the hio library when using the Intelligent Systems debugger.

Note 164-30:(HIO) Revised return values for `hio` library functions [SDK]

Defined the return values of the hio library API in nn/hio/hio_Result.h.
Also Fixed a bug where (-1,63,255,1023) was returned if the HostFile::Open function was called for a non-existent file.

Note 164-31:(IR) Fixed a bug that caused `PrintResult` to show "Unknown" as the description [SDK]

Fixed a bug where if a Result returned by a function in nn::ir was printed using PrintResult, the description displayed as "Unknown."

Note 164-32:(IR) Revised reference [SDK]

Revised the following information in the reference.

Fixed errors in description of parameters to WaitConnection function.
Fixed description of WaitToConfirmId function where RequireToConfirmId was incorrectly written as "WaitToConfirmId."
Removed reference to nonexistent function, AnyConnection, from description of GetConnectionRole function.
Added missing description of parameters to description of GetConnectionStatusEvent.
Fixed errors in description of restore parameter in Send function.

Note 164-33: (IR) Revised library for infrared communication between CTR systems [SDK]

Revised the library because it was originally designed to enable communication in situations where ordinary communication could not be established.

Note 164-34: (IR) Added a tool to check the communication IDs used by infrared communication features between CTR systems [SDK]

Infrared communication features are handled by nn::ir::CTR::Communicator, which requires you to specify a communication ID that is generated from your application's unique ID.
The IrCommunicatorChecker tool was added to check this communication ID in data that is sent and received.

Note 164-35: (JPEG) Fixed decoder bugs [SDK]

Fixed the following decoder bugs.

A bug that produced monochrome results when an image was decoded with only QT0 defined as a DQT (quantization table)
A bug that made it impossible to decode data that contains APP1 segments but does not have Exif information in the first APP1

Even if the APP1 segment contains Exif information, decoding will fail when JPEG or MP-format data has an IFD0 offset other than 8.

Note 164-36: (JPEG) Fixed error codes returned when decoding fails because of unsupported data [SDK]

You were sometimes able to get JPEG_DECODER_ERROR_INTERNAL as an error code from the JpegMpDecoder::GetLastError function when progressive JPEG or some other unsupported data caused a decoding function to fail.
These error codes have been revised (to JPEG_DECODER_ERROR_DHT or JPEG_DECODER_ERROR_SOF_NOT_FOUND, for example).

Note 164-37: (NGC) Fixed the range of numbers that can be recognized by the `CountNumbers` function [SDK]

Fixed the CountNumbers function to recognize more characters as numbers (not enough characters were recognized before).

Note 164-38: (OS) Fixed a bug that caused `CriticalSection` to be more computationally expensive than necessary [SDK]

Fixed the problem where nn::os::CriticalSection processing was different than expected and caused an increased load.

Note 164-39: (OS) Modified the `Light*` synchronization classes so that they cannot be copied [SDK]

Modified the nn::os::LightEvent, nn::os::LightSemaphore, and nn::os::LightBarrier classes so that they cannot be copied (it should not have been possible to copy them in the first place).

Note 164-40: (OS) Fixed a bug that prevented `LightEvent` from waiting [SDK]

A bug caused LightEvent::Wait to incorrectly exit without waiting under certain conditions when nn::os::LightEvent was initialized using a manual reset.
This bug has been fixed.
Note that with this change, the size of the structures and classes used by members in nn::os::LightEvent and LightEvent have changed.

Note 164-41: (RDT) Fixed a bug that caused the `std::srand` function to be called implicitly [SDK]

The Sender::Initialize and Receiver::Initialize functions used to call the std::srand function implicitly, and there was therefore a risk that these functions could interfere with random number generation within an application.
The code that called the std::srand function within the RDT library has been removed, fixing this bug.

Note 164-42: (RO) Added support for debugging DLL source code [SDK | System Updater]

Added support for debugging DLL source code.
If you are implementing your own build system, you must specify additional options to makecrr.
For more information, see $CTR_SDK/documents/TechnicalNotes/Dll/BuildSystemDevelopmentGuideForDll.html.

Note 164-43: (SND) Addressed an `FxReverb` damping bug [SDK]

An FxReverb damping bug caused effects to feel weaker than they actually were.
You can now fix this bug by setting the m_IsEnableDampingBugFix member variable of the Param class to true.
Note that this member variable is false (the bug is not fixed) by default for compatibility reasons.

Note 164-44: (SND) Added the `GetMasterVolume` function [SDK]

Added a function to get the master volume set by the SetMasterVolume function.

Note 164-45: (TOOL) Allowed the `Config` tool to set the country [SDK | System Updater]

Changed the Config tool so that it can now set the country.

Note 164-46: (TOOL) Added a feature for restoring save data to factory defaults for downloadable applications [SDK]

Added a SaveDataFiler feature that restores save data to factory defaults for downloadable applications.
Place your cursor over a title on the User tab and press the X Button to restore the factory defaults.

Note 164-47: (TOOL) Allowed the Internet Browser to be removed from the DevMenu [SDK]

The Internet Browser now appears in the program list so that it can be removed from the DevMenu.
You can delete it just like other applications, by pressing the X Button.

Note 164-48: (TOOL) Added a DevMenu feature that displays the free block size [SDK]

The DevMenu now shows the free block size on an SD card and in system NAND memory.

Note 164-49: (TOOL) Added a `SaveDataFiler` feature that imports and exports raw user save data [SDK]

Added a SaveDataFiler feature that can import and export raw user save data.
You can press the L Button, B Button, and X Button at the same time to export data, which can then be imported just like any other data.

Note 164-50: (TOOL) Fixed a bug in `ctr_compress` that prevented the `-A` option from working properly [SDK]

Fixed a bug that caused the -A option to be ignored when the -lh or -lrc option was specified.
Also fixed a bug that caused the padding region to be an undefined value, instead of 0, when the -A option was specified.

Note 164-51: (TOOL) Fixed behavior in `ctr_compress` when the compressed file grows larger than the original file [SDK]

A warning message now appears when the compressed file is larger than the original file.
This warning does not appear when the -s option is specified.

Note 164-52: (TOOL) Added `DemoIndex` to `ctr_makerom` [SDK]

Revised ctr_makerom features for creating download application demos.
You can now specify a demo index between 1 and 255 for TitleInfo - DemoIndex in your RSF file.
This allows you to create multiple demos tied to a single normal application.
The DESC for download application demos has also been modified to match these changes.

Note 164-53: (TOOL) Modified `makebanner` [SDK]

Made the following modifications to makebanner.

Added support for NW4C TGA files.
Updated the EULA for the Americas region from version 1.0 to version 1.1.
You must re-generate ICN files using the makebanner provided with version 3.2 or later of the CTR-SDK before you make a master submissions for the Americas region.

Note 164-54: (TOOL) Added a tool that extracts information from StreetPass boxes [SDK]

Added CecBoxTool, which writes data from the system's StreetPass boxes to an SD card and can also write the data back.
You can use this while debugging to create an environment for reproducing bugs.

Note 164-55: (TOOL) Added a `SaveDataFiler` feature that destroys individual files in user save data and expanded save data [SDK]

Improved SaveDataFiler features so that individual files can be reliably destroyed in user save data and expanded save data.

Note 164-56: (UDS) Renamed wireless-disabled mode in reference pages [SDK]

Replaced phrases; for example, "wireless OFF" was replaced by "wireless-disabled."

Known Issues with SDK 3.2.0 Release

In the GD LightingSample demo, you will see a phenomenon where the area the light is shining on will periodically flash.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used
A large font size is set (the size that is problematic could depend on the font)
Two levels of gradation are set for the number of gradations under the advanced settings (this applies to both the A4 and LA4 settings)

■ CTR-SDK Version 3.2.0 System Updater 0.16.6

(2011/10/14)

Note 163-01: (AC) Improved connectivity in WPA/WPA2-TKIP/AES mixed mode [System Updater]

Fixed a bug that prevented connections to an access point using WPA/WPA2-TKIP/AES mixed mode configured by the WPS feature.

Note 163-02: (AC) Improved connectivity in environments with low signal strength [System Updater]

Adjusted the time taken for a connection to time out when there is low signal strength and made connections more robust.

Note 163-03: (APPLET) Fixed a bug that on rare occasions would prevent an `Awake` notification from being sent when the system recovered from Sleep Mode [System Updater]

Fixed a bug that occurred when the system recovered from Sleep Mode, which on rare occasions would prevent an Awake notification from being sent, prevent the screen from turning on, cause sound to hang, or exhibit other symptoms.

Note 163-04: (APPLET) Added an applet to calibrate the Circle Pad Pro [SDK | System Updater | Sample Demos]

Added nn::extrapad, the Circle Pad Pro calibration applet.
The $SampleDemos/applet/extrapad sample demo, which uses the Circle Pad Pro calibration applet, has also been added.

Note 163-05: (BOSS) Fixed a bugs in DataStore tasks [System Updater]

Fixed the following bugs in DataStore tasks.

Even if a DataStore task was suspended, it would not enter the Retry state nor would it try again.
Even if a DataStore task was running, applications could not get RUNNING as that task's state.
A running DataStore task would stall on rare occasions.
A notification would not be sent when a DataStore task received multiple data items and was subsequently suspended.
A DataStore task would not respond to cancel operations in rare, timing-dependent situations.

Note 163-06: (BOSS) Fixed state-transition bugs that occurred when immediate foreground task execution was canceled [System Updater]

Fixed a number of bugs that caused incorrect state transitions when immediate foreground task execution was canceled.
For example, if a task was executed immediately in the foreground, its state would sometimes change to TASK_RETRY if it was still running when another task was executed immediately in the foreground.
(The result of immediate foreground task execution must be TASK_DONE or TASK_ERROR.)

Note 163-07: (BOSS) Tasks with a result of `HTTP_ERROR_CONN_STATUS` will now be retried [System Updater]

A result of HTTP_ERROR_CONN_STATUS is now considered to indicate that a task should be retried, not that the task has an error.
This will increase the number of times that a running upload task will be retried if communication is interrupted.

Note 163-08: (BOSS) Fixed a bug related to the `X-BOSS-Closed` field when a task's state was `TASK_RETRY` before it accessed the server [System Updater]

Fixed a bug that caused an invalid value to be set in the X-BOSS-Closed field for a task whose state was TASK_RETRY before it accessed the server (services were mistakenly considered to have ended even when that was not the case).

Note 163-09: (BOSS) Fixed a bug related to the size of data when a task's state was `TASK_RETRY` before it accessed the server [System Updater]

Fixed a bug that caused an invalid download data size to be obtained for a task whose state changed to TASK_RETRY without any server access.

Note 163-10: (DevEnv) Added the Internet Browser [System Updater]

Changed System Updater so that it imports the Internet Browser.
This allows you to start the Internet Browser from the HOME Menu.

The Internet Browser's engine is not allocated as much memory on a PARTNER-CTR Debugger or PARTNER-CTR Capture as it is on a retail CTR system or a CTR test unit.
As a result, the Internet Browser can display some pages on a retail system that it cannot display on a PARTNER-CTR Debugger or PARTNER-CTR Capture.

Note 163-11: (DevEnv) System Settings can be started from the development menu [System Updater]

You can now press the X Button to start System Settings from the development menu.
However, you cannot start it when you have configured a memory size of 96 MB (dev1) from the system mode settings.

Note 163-12: (FRIENDS) Shortened login times [System Updater]

Decreased the amount of time required for asynchronous processing when the nn::friends::Login function is called while the system is offline.

Note 163-13: (FS) Added feature to set priority for file access [SDK | System Updater]

Note 163-14: (FS) Created more specialized `Result` values that are given when file access validation fails [System Updater]

Created more specialized Result values related to nn::fs::ResultVerificationFailed, which are returned during file access.
This does not change how errors are handled, but DESCRIPTION numbers may be different than they were before.

Note 163-15: (GX) Modified the brightness of the LCD backlight [System Updater]

Fixed the brightness of the LCD backlight. Upon applying System Updater 0.16.1, which supports CTR-SDK 3.1, the same brightness setting would result in a slightly darker screen.

Note 163-16: (HTTP) Fixed a bug that prevented the `Read` and `Finalize` functions from returning [System Updater]

Fixed the following bugs from CTR-SDK 3.1.

The http::Connection::Finalize function would not return when a Connection was canceled before communication started.
The http::Connection::Read function would not return for a Connection whose specified URL failed DNS resolution.

Note 163-17: (HTTP) Made `http::Finalize` and the process of cleaning up POST memory synchronous [System Updater]

It is guaranteed that once you get a response from http::Finalize, you can now verify that the POST memory configured by http::Initialize has been cleaned up.
This allows you to reuse the POST memory for some other purpose immediately after http::Finalize has been executed.
(POST memory used to be cleaned up asynchronously and was therefore unusable for some indeterminate period of time after http::Finalize was executed.
For this synchronous processing to behave correctly, however, you must run Finalize on every http::Connection before you call http::Finalize.

Note 163-18: (HTTP) Fixed a bug that occurs when `http::Finalize` is called before all communication is finalized [System Updater]

Fixed a bug that prevented the shared POST buffer from being finalized appropriately when http::Finalize was called before Connection::Finalize was called for all communication in progress.

Note 163-19: (HTTP) Fixed a bug that prevented functions from returning when a large amount of parallel HTTP communication was running [System Updater]

Fixed a bug that prevented blocking functions from returning for a large amount of parallel HTTP communication.

Note 163-20: (IR) Fixed a bug that caused the system's internal state to become inconsistent if `Finalize` was not called [System Updater]

Fixed a bug that caused the system's internal state to become inconsistent and therefore subsequently resulted in unstable behavior after any application used the IR library and quit without calling nn::ir::CTR::Communicator::Finalize.

Note 163-21: (IR) Fixed a bug that caused the first packet's data position to be overwritten by a new packet's data position [System Updater]

Fixed a bug that occurred if a new packet was received when data had already been received for the maximum number of packets, causing the first packet's data position to be overwritten by the new packet's data position.

Note 163-22: (IR) Fixed a bug that overwrote valid packet data that had been received [System Updater]

Fixed a bug that occurred when new data was received when the buffer was full, causing the received packets that had been saved in the buffer to be overwritten.

Note 163-23: (MCU) Fixed a bug that caused the recovery from Sleep Mode to fail when the accelerometer was broken [System Updater]

Fixed a bug that prevented the system from recovering from Sleep Mode when the accelerometer was broken.

Note 163-24: (NDM) Fixed a bug that prevented the system from switching between the wireless-enabled and wireless-disabled modes while it was in Sleep Mode [System Updater]

Fixed a bug that sometimes prevented the system from repeatedly switching between the wireless-enabled and wireless-disabled modes while it was in Sleep Mode.

Note 163-25: (OS) Fixed a bug that caused the screens to turn red and yellow when the system core thread was profiled with CTR-Profiler [System Updater]

Fixed a bug that sometimes caused the screens to turn red and yellow when the system core thread was profiled with the CTR-Profiler.

Note 163-26: (OS) Fixed a bug that prevented the debugger from loading a CIA file independently for an application that was built without an RSF file specified [System Updater]

Fixed a bug that caused the debugger to fail to load a CIA file for an application if it was built without an RSF file specified and the other files generated during the build process were deleted.

Note 163-27: (OS) Fixed a bug that caused the screens to turn red and yellow if an attempt to output log data was made when the debugger shut down a thread [System Updater]

Fixed a bug that caused the upper and lower screens to turn red and yellow, respectively, if an attempt to output log data was made when the debugger shut down a thread.
This was actually changed in CTR-SDK 3.0 but was accidentally omitted from the change log.

Note 163-28: (OS) Fixed a bug that caused the debugger to fail to import downloadable applications [System Updater]

Fixed a bug that prevented the same downloadable application from being imported repeatedly.

Note 163-29: (OS) Fixed a bug that caused VFP values to be invalid during a forced break in the debugger [System Updater]

Fixed a bug that sometimes caused VFP values to be invalid during a forced break in the debugger.

Note 163-30: (OS) Added debugger support for loading and unloading DLLs [System Updater]

The debugger now stops when you load or unload a DLL (RO file).
This means that you must use PARTNER-CTR Debugger 2011/09/08 or later to debug DLLs.

Note 163-31: (RO) Added support for debugging DLL source code [SDK | System Updater]

Note 163-32: (SND) Fixed a bug that prevented sound output through the speakers after the system recovered from Sleep Mode [System Updater]

Fixed a bug that on rare occasions caused sound to be sent to the headphones—even if they were not plugged in—after the system recovered from Sleep Mode.

Note 163-33: (TOOL) Allowed the `Config` tool to set the country [SDK | System Updater]

Changed the Config tool so that it can now set the country.

Note 163-34: (UDS) `ResultWirelessOff` is now returned immediately after the system enters wireless-disabled mode [System Updater]

Modified the CreateNetwork, ConnectNetwork, and Initialize functions to return ResultWirelessOff (rather than an indeterminate Result value) when they are called immediately after the system enters wireless-disabled mode.

Note 163-35: (UDS) Reduced the CPU load for wireless communication [System Updater]

Reduced the CPU load for high-frequency wireless communication.

Known Issues with System Updater 0.16.6 in SDK Version 3.2.0

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 3.2.0 Sample Demos

(2011/10/14)

Note 162-01: (APPLET) Added an applet to calibrate the Circle Pad Pro [SDK | System Updater | Sample Demos]

Added nn::extrapad, the Circle Pad Pro calibration applet.
The $SampleDemos/applet/extrapad sample demo, which uses the Circle Pad Pro calibration applet, has also been added.

Note 162-02: (BOSS) Added a sample demo for NSA list features [Sample Demos]

Added sample_nsalist, a sample demo for NSA list features.
Read the reference pages for the sample demo before you run it.

Note 162-03: (BOSS) Added a sample demo for dedicated immediate-execution tasks [Sample Demos]

Added sample_fgonlytask, a sample demo for dedicated immediate-execution tasks that are only executed immediately.

Note 162-04: (DEMO) Fixed a bug where there is an omission in the list of member variables initialized by the `GraphicsDrawing` class [Sample Demos]

Added the GraphicsDrawing class's m_UseColorFillProgram and m_UseFontProgram member variables to its constructor's initialization list because they had been accidentally omitted.
This bug also meant that you accessed these indeterminate member variables when the RenderSystemDrawing class was initialized, their values would trigger an access violation.

Note 162-05: (DevEnv) Revised samples for creating downloadable demos [Sample Demos]

Added a DemoIndex item to TitleInfo in the RSF file for the sample used to create a downloadable demo under demo1/DemoVersion.
Specify a demo index between 1 and 255 for DemoIndex.

Note 162-06: (GR) Updated the `CommandBufferJump` sample demo [Sample Demos]

Modified the implementation of CommandBufferJump to use the nngxFlush3DCommandPartially function, which was just added, and consolidated cache flushes to improve performance. NNGX API restrictions had made the previous implementation of CommandBufferJump complicated.

Note 162-07: (GR) Fixed a bug that caused some GR sample demos to render graphics incorrectly when double command lists were used [Sample Demos]

Fixed a bug that caused two GR sample demos, ProceduralTexture and GraphicsDrawing, to render graphics incorrectly when double command lists were used.

Note 162-08: (GR) Added GR sample demos [Sample Demos]

Added GR sample demos for point sprites and shadow maps.

Note 162-09: (GR) Changed `Framework` for sample demos [Sample Demos]

Made the following changes to gx/Gr/Framework.

Split commands are now added by nngxFlush3DCommand instead of nngxSplitDrawCmdlist.
Added the PostDraw function to the IScene class.

Revised all of the sample demos under gx/Gr to conform to these changes.

Note 162-10: (GX) Added a sample implementation of the `StartRecordingPackets` function to the `gx/Gd/DrawPrimitiveScene` sample demo [Sample Demos]

Added a sample implementation of the new specifications (the RecordingPacketUsage parameter) for the gd::System::StartRecordingPackets function.

Note 162-11: (HID) Added a class for handling the Circle Pad Pro [SDK | Sample Demos]

Added the nn::hid::CTR::ExtraPad class to handle the Circle Pad Pro.
Consequently, SampleDemos/hid/extra_pad has also been added as a sample demo using this feature.

Known Issues with SDK 3.2.0 Sample Demos

None.

■ CTR-SDK Version 3.1.0 Release

(2011/09/08)

Note 161-01: (AC) Made initialization functions thread-safe [SDK]

Changed the nn::ac::Initialize, Finalize, IsInitialized functions to be thread-safe.
However, this does not guarantee thread safety for functions related to initialization and other functions that require initialization before being called.

Note 161-02: (APPLET) Integrated applet package [SDK | System Updater | Sample Demos]

Integrated applet packages previously released separately into the CTR-SDK.

Note 161-03: (APPLET) Added function to determine return jump from System Settings [SDK]

Added nn::applet::CTR::IsFromMset function to determine whether control has jumped back from System Settings to the application.

Note 161-04: (APPLET) Added function to jump to System Settings [SDK | System Updater]

Added nn::applet::CTR::JumpToInternetSetting, nn::applet::CTR::JumpToParentalControls, nn::applet::CTR::JumpToDataManagement functions to jump from the application to System Settings.

Note 161-05: (BOSS) Removed `include` statements from `http` and `ssl` BOSS header files [SDK]

Removed include statements from the http and ssl BOSS header files since the HTTP and SSL libraries are now private.
Applications that indirectly included the http or ssl header files from the BOSS header files will error out when compiling, so you must directly include the http or ssl header files in your application's source code.

Note 161-06: (BOSS) Added feature to list NS archives [SDK | System Updater]

Added an NADL task feature to get a list of NS archive data files available for download on the server.
Use this to implement a service that could show the user a list of data files on the server and then download just the selected data files.

Note 161-07: (BOSS) Added network storage (`DataStore`) task [SDK | System Updater]

Added tasks to send and receive data to and from Nintendo network storage.
Added a DataStore upload task to upload data to the server, and a DataStore download task to download data from the server.
Use this to implement a background communication service that could send data from one CTR and receive it on another.

Note 161-08: (BOSS) Added dedicated immediate-execution tasks [SDK | System Updater]

Added a dedicated API (the boss::FgOnlyTask class) for immediate-execution tasks.
Use this API to simplify your implementation of immediate-execution tasks.
Tasks registered using this API are not counted against the number of tasks allowed per application, as described in the Guidelines.

Note 161-09: (CFG) Added function for getting COPPACS restrictions [SDK | System Updater]

Added a function for getting whether COPPACS restrictions have been configured in System Settings.

Note 161-10: (CFG) Added function to get just the ID for simple address data [SDK]

Added a function to get just the ID for simple address data.
Also added a function to get the region code portion from the ID for simple address data.

Note 161-11: (CRYPTO) Added software RSA library [SDK]

Added the cryptoRSA library providing encryption, decryption, signing, and authentication features using RSA public keys.

Note 161-12: (DLP) Revised documentation for `nn::dlp::CTR::EventDesc` [SDK]

Added previously missing documentation about unions used in nn::dlp::CTR::EventDesc.

Note 161-13: (DevEnv) Fixed a bug where `ccl` builds would fail [SDK]

Fixed a bug in the CTR-SDK build system where attempting to build ccl would fail when specifying MANUAL_DIR and CHILD_APPS.

Note 161-14: (DevEnv) Added Play Coin icon [SDK]

Play Coin icons and associated documentation have been placed in the $CTR_SDK/resources/icon/PlayCoin directory.

Note 161-15: (DevEnv) Added library input to library builds [SDK]

Changed build restrictions to allow inputting a .a library file when building another .a library file that uses TARGET_LIBRARY.
The system now handles this as input at build time when specifying the library file in the LIBRARY_LIBFILES variable.

Note 161-16: (DevEnv) Added support for problem where recompiles would not happen for extremely large source files [SDK]

There was a problem in omake where large source files would not be recompiled after edits. The CTR-SDK build system was updated to handle large source files, and this update extends this support to the creation of object files from source files.

Note 161-17: (ENC) Added `enc` library [SDK | Sample Demos]

Added the enc library for conversion both ways between UTF-8 and UTF-16 character encodings.
Also added a sample demo of charset conversion.

Note 161-18: (FRIENDS) Revised documentation for `nn::friends::CTR::GetFriendScreenName` [SDK]

Fixed a typo in the parameter type for nn::friends::CTR::GetFriendScreenName.
This was actually fixed in CTR-SDK 3.0 but was accidentally omitted from the change log.

Note 161-19: (FRIENDS) Made initialization functions thread-safe [SDK]

Changed the nn::friends::Initialize, Finalize, IsInitialized functions to be thread-safe.
However, this does not guarantee thread safety for functions related to initialization and other functions that require initialization before being called.

Note 161-20: (FRIENDS) Made join-in features public [SDK]

Made public the functions and constants for join-in features.
This shares the local system's matchmaking group participation status via the friends library, making it easier to join into the matchmaking group that a friend is participating in.
This design assumes a link to the NEX library, so specific details on use will be made available in a future release of the NEX library, its samples, and documentation.

Note 161-21: (GR) Fixed a bug in polygon offsets [SDK]

Fixed a bug where polygon offsets would not operate correctly, due to function RenderState::WBuffer::MakeCommand passing a 32-bit value as is to register 0x4e when a 24-bit value was needed.
Also revised polygon offset calculation when the W buffer is disabled to multiply by 128.0f, the same as when the buffer is enabled.

Note 161-22: (GX) Fixed a bug where texture unit 2 could not be used when using the `gd` library [SDK]

Fixed a bug where commands would not be properly generated even when configured via the gd library to use texture unit 2.

Note 161-23: (GX) Changed `gd` function parameter names [SDK]

Fixed typos in gd library function parameter names.

Note 161-24: (GX) In the `gd::Light::SourceType` enumerated type, changed `SOURCE_TYPE_PUNCTUAL` to `SOURCE_TYPE_POINT` [SDK]

In the gd::Light::SourceType enumerated type, changed SOURCE_TYPE_PUNCTUAL to SOURCE_TYPE_POINT.
The header file still contains SOURCE_TYPE_PUNCTUAL to maintain compatibility, but note that this is deprecated and that you should use SOURCE_TYPE_POINT from now on.

Note 161-25: (GX) Changed most `gd::RasterizerStage` functions to be immediate functions [SDK]

Excluding the early depth test functions, changed the following functions to be immediate.

SetCulling
SetViewport
EnableClippingPlane
SetClippingPlane
EnableScissor
SetScissor

Note 161-26: (GX) Fixed a bug in `gd::System::Finalize` about freeing memory [SDK]

Fixed a bug in gd::System::Finalize function where not all objects would be destroyed.
This function automatically destroys the following objects.

texture2D
textureCube
RenderTarget
DepthStencilTarget
Shader
RecordingPacket
ShaderPipeline
ShaderBinary
VertexBufferResource
Texture2DResource
CombinerState
VertexInputState
SamplerState
DepthStencilState
BlendState
InputLayout

Note 161-27: (GX) Loosened restrictions on `nngxUseSavedCmdlist` and `nngxUseSavedCmdlistNoCacheFlush` functions [SDK]

Removed the restrictions on the cmdlist parameter to the nngxUseSavedCmdlist and nngxUseSavedCmdlistNoCacheFlush functions to allow specifying the current command list. This previously caused an error.
In line with this change, removed the GL_ERROR_8039_DMP and GL_ERROR_8094_DMP errors.

Note 161-28: (GX) Updated the documentation [SDK]

The following updates were made to the GX documentation.

DMPGL20_system_API_specification.pdf

Added NN_GX_CMDLIST_CURRENT_BUFADDR and NN_GX_STATE_ALL, which were previously only included in the API reference.
Added setting bit [20:20] of register 0x83, to Table 5-33 the texture format setting register.
(This was previously only included in 5.8.20.13. Shadow Texture Settings.)
Expanded descriptions of starting profiling features and configuring parameters.

DMPGL20_programming_guide.pdf

Added 19.7. Optimization Through Command Buffer Subroutines.

Note 161-29: (GX) Added parameters to profiling functions for specifying the busy counter measuring time in microseconds or nanoseconds [SDK]

Added NN_GX_PROFILING_BUSY_SAMPLING_TIME_MICRO_SECOND and NN_GX_PROFILING_BUSY_SAMPLING_TIME_NANO_SECOND as values for the pname parameter in the profiling feature nngxSetProfilingParameter function.
This sets the busy counter to count for periods of time set in microseconds and nanoseconds.

Note 161-30: (HTTP) Added `http_Initialize.h` [SDK]

Added http_Initialize.h header file that makes just the http::Initialize and http::Finalize functions public for applications using the NEX DataStore library.
When using the DataStore library, applications must call both the http::Initialize and http::Finalize functions.

Note 161-31: (IR) Made CTR-to-CTR infrared communication features public [SDK | Sample Demos]

Made the nn::ir::CTR::Communicator function public for using the infrared communication features between two CTR systems.
Also added the SampleDemos/ir/communicator sample demo using this feature.

Note 161-32: (NET) Fixed a bug where an alignment error would occur when scanning for wireless networks [SDK]

Fixed a bug where a program would halt due to an alignment error when scanning for wireless networks.
This bug only occurs in CTR-SDK version 3.0, and does not occur in earlier versions.

Note 161-33: (OS) Added `AutoStackManager` [SDK]

Added nn::os::AutoStackManager and derived classes.
See $CTR_SDK/documents/TechnicalNotes/SystemProgrammingGuide/SystemProgrammingGuide.pdf for detailed reference and system programming guidelines.

Note 161-34: (OS) Removed definitions related to `InitializeDeviceMemory` [SDK]

Deleted nn::os::InitializeDeviceMemory and the following related declarations and definitions.

NN_OS_DEVICE_MEMORY_SIZE macro
DEVICE_MEMORY_SIZE constant
InitializeDeviceMemory function
nnosInitializeDeviceMemory function

Note 161-35: (OS) Added `ASSERT` to `InitializeMemoryBlock` to test for multiple calls [SDK]

Added an ASSERT statement to nn::os::InitializeMemoryBlock to check if function has been called multiple times.
In non-release builds, calling InitializeMemoryBlock the second time will cause the ASSERT to fail and processing to halt.

Note 161-36: (OS) Fixed a bug where state would become inconsistent when initializing `StackMemory` [SDK]

Fixed a bug in the nn::os::StackMemory initialization function when specifying a memory region that cannot be partitioned where the function would return an error but the internal state would become inconsistent.
Also added explanation to the API reference that this function cannot partition memory allocated from anywhere but the heap.

Note 161-37: (OS) Updated the System Programming Guide [SDK]

Added chapters to the system programming guide, $CTR_SDK/documents/TechnicalNotes/SystemProgrammingGuide/SystemProgrammingGuide.pdf, about threads, synchronization mechanisms, time, debug output, and CPU exception handlers.

Note 161-38: (OS) Added wait functions with timeouts [SDK | System Updater]

Added TryWait member function that includes a timeout to the nn::os::LightEvent class.
Also added TryAcquire member function that includes a timeout to the nn::os::LightSemaphore class.

Note 161-39: (RDT) Fixed a bug where a `PANIC` halt would occur when receiving a connection request when the `Receiver` state is `FINISHED` [SDK]

Fixed a bug where a PANIC halt would occur when receiving a connection request when the Receiver state is FINISHED.
Replaced this PANIC with statements to print the following strings to debug output, and revised to not halt the running program.

State is FINISHED, but received segment from remote!

This was actually fixed in CTR-SDK 3.0 but was accidentally omitted from the change log.

Note 161-40: (RO) Changed `GetSizeInfo` to allow using only part of `cro` [SDK]

Changed nn::ro::GetSizeInfo function to no longer require passing all of cro after loading into memory and instead allow using just the start of cro.

Note 161-41: (SND) Fixed a bug where parameter values would not be updated after calling `FxReverb::SetParam` [SDK]

Fixed a bug where calling nn::snd::SetEffect to register an FxReverb object and then calling FxReverb::SetParam would not update parameter values.
This bug does not occur if doing this before calling SetEffect.

Note 161-42: (SND) Fixed a bug where some buffers would change to `STATUS_DONE` without being played when hitting a buffer underrun during stream playback [SDK]

Fixed a bug where WaveBuffer objects appended at the moment when playback halts due to a buffer underrun changed to STATUS_DONE without being played, as when playing back a stream as in the snd/StreamPlayer sample demo.

Note 161-43: (SWKBD) Upgraded software keyboard library [SDK]

Added a feature to the software keyboard applet to specify the display language, which means this library is no longer compatible with the software keyboard applet included in earlier versions of the System Updater.
Note that the software keyboard will not function unless you apply System Updater 0.16.1 that supports this CTR-SDK version.

Note 161-44: (TOOL) Revised `BannerModelConverter` [SDK]

Fixed BannerModelConverter to now output an error when it cannot resolve the names of textures referenced by models being converted, instead of continuing the conversion as in past versions.

Note 161-45: (TOOL) Added feature for background immediate execution to `BossLotcheckTool` [SDK]

Added a feature to BossLotcheckTool to run tasks immediately in the background.

Note 161-46: (TOOL) Changed `dlp` debug settings of the `Config` tool [SDK]

In the Config tool under OtherSetting, changed the name of the Dlp Force Child Import setting to Dlp Debug, and reworked dlp debug feature allocation.
For more information, see Config.

Note 161-47: (TOOL) Added `Config` tool features [SDK]

Changed Config tool to allow configuration of COPPACS settings.

Note 161-48: (TOOL) Added support for faster ETC encoding to `TexturePackager` tool [SDK]

Added the FastImproved and MediumImproved new compression methods to the TexturePackager tool for faster encoding of high-quality images.

Note 161-49: (TOOL) Fixed a bug where `CardDevice`s would not be properly reflected in `ccl` [SDK]

Fixed a bug in makerom where the CardDevice value from the RSF file would not be reflected when using ccl.
This means that cci and ccl are no longer compatible for save data saved to a backup device.

Note 161-50: (TOOL) Fixed a bug where `ccl` build would error out when ROMFS was not specified [SDK]

Fixed a bug where ctr_makerom would halt on an error when building ccl with ROMFS left unspecified.

Note 161-51: (TOOL) Changed `makebanner` [SDK]

Made the following modifications to makebanner.

Added support for configuring join-in game IDs and join-in game mode masks
Fixed a rare bug where makebanner would error out on conversion and fail to properly convert

Note 161-52: (TOOL) Added `Card2` support to `makerom` [SDK]

Added feature to makerom to generate a CCI file that supports Card2 by specifying Card2 as the CardInfo/MediaType value in the rsf file.

Note 161-53: (TOOL) Added feature to `SaveDataFiler` to allow for the per-file deletion of user save data and expanded save data [SDK]

Added a feature to SaveDataFiler to allow for the per-file deletion of user save data and expanded save data.

Note 161-54: (TOOL) Fixed a bug where `ctr_makerom` would error out in certain environments [SDK]

Fixed a bug where ctr_makerom would error out on execution when certain environment variables were set multiple times.

Note 161-55: (UDS) Added `NetworkDescription` comparison function [SDK]

Added NetworkDescription::CompareWith and NetworkDescriptionReader::CompareWith functions for comparing network information obtained from a new scan against information obtained previously.

Note 161-56: (UDS) Revised documentation for `nn::uds::CTR::NO_WAIT` [SDK]

Removed documentation irrelevant to nn::uds::CTR::NO_WAIT.

Note 161-57: (Error EULA) Added automatic linebreak feature [SDK | System Updater]

Added feature to automatically wrap messages that exceed the width of one line by adding a space or tab.
To support this automatic linebreak, also added *_WORD_WRAP enumerator to the errorType enumerated type in the Config parameters.

Known Issues with SDK 3.1.0 Release

In the GD LightingSample demo, you will see a phenomenon where the area the light is shining on will periodically flash.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used
A large font size is set (it is possible that what size is problematic is dependent on the font)
Two levels of gradation are set for the number of gradations under the advanced settings (this applies to both the A4 and LA4 settings)

■ CTR-SDK Version 3.1.0 System Updater 0.16.1

(2011/09/08)

Note 160-01: (AC) Changed error code initial value [System Updater]

Changed the initial return value for nn::ac::GetLastErrorCode when no error has yet occurred from 0 to 34199.

Note 160-02: (APPLET) Fixed a bug where core 1 CPU allocations would change when performing certain operations with an application suspended [System Updater]

Fixed a bug where suspending an application by pressing the HOME Button, then starting the Friend List or other system applet, and then returning to the application via the HOME Menu would cause the core 1 CPU allocation to be reset to 30.

Note 160-03: (APPLET) Integrated applet package [SDK | System Updater | Sample Demos]

Integrated applet packages previously released separately into the CTR-SDK.

Note 160-04: (APPLET) Added function to jump to System Settings [SDK | System Updater]

Added nn::applet::CTR::JumpToInternetSetting, nn::applet::CTR::JumpToParentalControls, nn::applet::CTR::JumpToDataManagement functions to jump from the application to System Settings.

Note 160-05: (BOSS) Fixed a bug relating to background immediate execution [System Updater]

Fixed a bug where turning off the CTR power right after running a background immediate-execution task would cause that task to not be background immediate-execution after turning the power back on.
This was actually fixed in CTR-SDK 3.0 but was accidentally omitted from the change log.

Note 160-06: (BOSS) Fixed a bug where AP information would not be added when executing in the foreground [System Updater]

Fixed a bug where running a foreground immediate-execution task when connecting to a Nintendo Zone access point would prevent any access point information from being included in that HTTP request.

Note 160-07: (BOSS) Added feature to list NS archives [SDK | System Updater]

Note 160-08: (BOSS) Added support to allow task registration when the task database is full [System Updater]

Changed processing so task registration completes successfully even when registering a new task with the task database full.
Old tasks are deleted automatically.
This removes any need for applications to handle task registration failures.

Note 160-09: (BOSS) Added network storage (`DataStore`) task [SDK | System Updater]

Note 160-10: (BOSS) Added dedicated immediate-execution tasks [SDK | System Updater]

Note 160-11: (CAMERA) Fixed a bug where the gain would be reset when starting the camera [System Updater]

Fixed a bug where specifying PHOTO_MODE_NIGHT_VIEW in a call to SetPhotoMode would set the gain to "maximum," but then later either calling SetPhotoMode with the camera in standby and then starting the camera with a call to Activate; or calling SetPhotoMode with the camera running, then going into standby, and then resuming, would reset the gain to "standard."

Note 160-12: (CFG) Added function for getting COPPACS restrictions [SDK | System Updater]

Added a function for getting whether COPPACS restrictions have been configured in System Settings.

Note 160-13: (DLP) Fixed a bug where an error would occur when calling `Server::CloseSessions` [System Updater]

Fixed a bug where calling Server::OpenSessions and then calling Server::CloseSessions would cause the SERVER_STATE_ERROR error state.
Calling Server::CloseSessions now transitions to SERVER_STATE_INITIALIZED.

Note 160-14: (DLP) Added support for download applications [System Updater | Sample Demos]

Changed processing to now allow use of the DLP server from download applications.
However, the DLP server for download applications cannot run system updates, so the server cannot communicate with DLP clients running an earlier system version than the server.
Consequently, the DLP server disconnects DLP clients running earlier versions.
You must apply any system updates to the DLP client before communicating with the DLP server.
Released products must get the user to apply a system update by means of a memory card or via the network.
The server must notify the user of any messages concerning this disconnection and system updates.
Use the data provided by Nintendo for these messages.
This message display requirement may change in future.
See the nn::dlp::Server::Initialize API reference for details.
Be aware of these issues before implementing any DLP server for download applications.

Note 160-15: (DevEnv) Added support for using profiler and HostIO together [System Updater]

Changed system to allow applications that use HostIO to run on the profiler.

Note 160-16: (FRIENDS) Revised behavior when a communication partner to whom the local user's online state is hidden then deletes the friend relationship [System Updater]

Revised behavior when a communication partner to whom the local user's online state is hidden then deletes the friend relationship, where the local user would appear offline but the communication partner would still receive notifications that the local user had logged out.

Note 160-17: (FS) Revised SD card removal notification when system is waking from sleep [System Updater]

Fixed a bug where failing to mount an SD card in a non-FAT format and then recovering from sleep would cause the event to be notified of an insertion and removal.

Note 160-18: (FS) Revised SD card insertion notification when system is waking from sleep [System Updater]

Fixed a bug where successfully mounting an SD card, removing the card with the system asleep, and then recovering from sleep cause the event to be notified of a removal, an insertion, and another removal.

Note 160-19: (FS) Fixed a bug where deleting expanded save data would fail [System Updater]

Fixed a bug in CTR-SDK 3.0 where deleting expanded save data would sometimes fail.

Note 160-20: (GX) Fixed a bug where screen would be corrupted when transitioning to the HOME Menu [System Updater]

Fixed a bug where transitioning from the application to the HOME Menu would very rarely cause the screen display to be temporarily corrupted during the transition.

Note 160-21: (HOME Menu) Fixed a bug where Open button and system applet start buttons would become unusable [System Updater]

Fixed a bug where the Open Button and start buttons for system applets would not respond to touches for several seconds immediately after an SD card is inserted, or immediately after an application is suspended when an SD card is inserted.

Note 160-22: (HOME Menu) Fixed a bug where operations would be ignored for a while when resuming a suspended application [System Updater]

Fixed a bug where inserting an SD card that is full but that contains no HOME Menu software management information and resuming a suspended application at the same time causes the application to be unresponsive for up to 10 seconds.

Note 160-23: (HOME Menu) Support for download application demos [System Updater]

Changed the HOME Menu to allow displaying and starting download application demos.
However, any messages displayed in dialog boxes when starting the demos are currently left blank for all regions except Japan.
In addition, the System Updater is not included in Nintendo eShop, so it cannot start Nintendo eShop.

Note 160-24: (HOME Menu) Fixed a bug when starting card applications that cannot access backup memory [System Updater]

Fixed a bug where starting a CTR card application with no backup device inserted (with no access to backup memory) causes the 3DS logo to remain displayed on the screen.
This has been changed to display a FATAL card removal error.

Note 160-25: (HOME Menu) Fixed a bug where display image would be corrupted when pressing the POWER Button and returning to the HOME Menu [System Updater]

Fixed a bug where pressing the HOME Button to suspend an application while displaying in 2D mode on the upper screen, resuming the application, then switching in the application to 3D display on the upper screen, and finally pressing the POWER Button, causes the upper screen to temporarily display a corrupted image.

Note 160-26: (MCU) Fixed a bug where power consumption would increase when the power is turned off [System Updater]

There was a bug where turning the system power off while charging and then unplugging the power adapter would cause power consumption to increase, with the system running out of power in around 200 hours after a full charge.
This bug has been fixed.

Note 160-27: (MCU) Fixed a bug where POWER Button had to be held down for one second longer than before power would be interrupted [System Updater]

Fixed a bug where the time between starting to hold the POWER Button down and the power being interrupted took around one second longer than CTR-SDK 2.4 and previous versions.

Note 160-28: (OS) Added wait functions with timeouts [SDK | System Updater]

Added TryWait member function that includes a timeout to the nn::os::LightEvent class.
Also added TryAcquire member function that includes a timeout to the nn::os::LightSemaphore class.

Note 160-29: (OS) Improved log output when debugger is under high CPU load [System Updater]

Fixed a bug where debugger log output would be interrupted when core 1 was under heavy load.

Note 160-30: (OS) Fixed a bug where the debugger would not be notified of card removals during `cci` drop execution [System Updater]

Fixed a bug when running cci on the debugger, where the card removal error screen would not display even when operating the card emulator.
This was actually fixed in CTR-SDK 3.0 but was accidentally omitted from the change log.

Note 160-31: (UDS) Fixed a bug where sending would be delayed even when calling `SendTo` with `NO_WAIT` [System Updater]

There was a bug when specifying NO_WAIT in a call to SendTo that caused delays in sending.
This would occur when calling the function for sending without specifying NO_WAIT, and then calling the function while specifying NO_WAIT.
This bug has been fixed.

Note 160-32: (Error EULA) Added automatic linebreak feature [SDK | System Updater]

Note 160-33: (Software Keyboard) Added feature to specify display language [System Updater]

Added a function for specifying the language to use for message display, the keyboard layout, and the default dictionary used in an applet.
Specify the language to use in the Config parameter displayLanguage to use the specified language for messages, the keyboard outlet, and the default dictionary used in the applet, regardless of the language specified in System Settings.

Note 160-34: (Nintendo 3DS Sound) Updated StreetPass features [System Updater]

Updated the StreetPass features, such as including song titles in StreetPass Recent Activity, and including the nicknames and favorite color when using Mii characters.

Note 160-35: (Friend List) Fixed a bug where system would halt when deleting a friend card [System Updater]

Fixed a bug where the system would halt when a registered friend's state changes and their friend card is deleted at the same time.

Note 160-36: (Photo Selector Applet) Fixed a bug where thumbnails would not be displayed [System Updater]

Fixed a bug where thumbnails would not be displayed, depending on when a folder is opened or closed.

Known Issues with SDK 3.1.0 System Updater 0.16.1

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 3.1.0 Sample Demos

(2011/09/08)

Note 159-01: (APPLET) Added software keyboard applet to `demo1` [Sample Demos]

Added software keyboard opening and closing to the combined demo demo1.

Note 159-02: (APPLET) Integrated applet package [SDK | System Updater | Sample Demos]

Integrated applet packages previously released separately into the CTR-SDK.

Note 159-03: (DLP) Added support for download applications [System Updater | Sample Demos]

Note 159-04: (DevEnv) Added sample of download demo creation [Sample Demos]

Added a sample of creating a download application demo to demo1/DemoVersion, based on demo1.

Note 159-05: (ENC) Added `enc` library [SDK | Sample Demos]

Added the enc library for conversion both ways between UTF-8 and UTF-16 character encodings.
Also added a sample demo of charset conversion.

Note 159-06: (GR) Fixed a bug in the `CommandBufferJump` sample [Sample Demos]

There was a bug in the gx/Gr/CommandBufferJump sample, in the implementation method of a command buffer jump when using the GR library, causing different rendering results depending on whether jumps were enabled or disabled.
Revised to add the following two methods.

Creating rendering commands including a jump to a different command list, then accessing using the nngxAdd3DCommandNoCacheFlush function
Using the nngxAddSubroutineCommand function

Note 159-07: (GX) Revised Sample Demos framework for `Gr` [Sample Demos]

Revised to allow switching between single- and double-buffering command lists by pressing the A Button.
Revised to calculate CPU / GPU processing time instead of displaying FPS.

Note 159-08: (GX) Fixed errors in `LightingStage` settings for `FogAndLight` in the `gd` library sample [Sample Demos]

There was a bug in the gx/Gd/FogAndLight sample where the scale and bias values for the distance attenuation lookup table input values were not set for all lights, causing unexpected display.
This bug has been fixed.

Note 159-09: (IR) Made CTR-to-CTR infrared communication features public [SDK | Sample Demos]

Made the nn::ir::CTR::Communicator function public for using the infrared communication features between two CTR systems.
Also added the $SampleDemos/ir/communicator sample demo using this feature.

Known Issues with SDK 3.1.0 Sample Demos

None.

■ CTR-SDK Version 3.0.0 Release

(2011/08/05)

Note 158-01: (APPLET) Added function to restart application [SDK]

Added the function RestartApplication for restating the application itself, and the function GetStartupArgument for getting the argument passed by that function.

Note 158-02: (CEC) Fixed a bug where data read/write fails [SDK | System Updater]

Fixed a bug where data accessed from multiple threads or processes at the same time would cause read/write failures and occasional data corruption.

Note 158-03: (CFG) Deleted `GetParentalControlPinCode` function [SDK]

The GetParentalControlPinCode function has been deleted. Use the CheckParentalControlPinCode function to check Parental Control PIN codes.

Note 158-04: (CFG) Added function to get whether Nintendo eShop use is restricted [SDK]

Added functions to get determinant of whether there are restrictions in the Parental Controls on the use of Nintendo eShop.

Note 158-05: (CX) Made `GetCompressionHeader` function private [SDK]

The GetCompressionHeader function is no longer publicly available.
To get necessary header information, use the GetCompressionType function and the GetUncompressedSize function.

Note 158-06: (DBG) Added a function callback debug trace [SDK]

Added the functionality to build functions with a special option so calls to the function can be recorded and displayed for debug tracing.

Note 158-07: (DevEnv) Updated the version of the compiler used to build the CTR-SDK package [SDK]

The compiler used to build the CTR-SDK package has been updated to ARMCC 4.1.

Note 158-08: (DevEnv) Updated copyright [SDK | Sample Demos]

Updated the copyright notices throughout the source code of CTR-SDK and Sample Demos.

Note 158-09: (DevEnv) Added `ENABLE_CPP_EXCEPTION` variable [SDK]

The variable ENABLE_CPP_EXCEPTION has been added to the SDK build system.
When true is specified, C++ exceptions are enabled.
The initial value is false.
To use C++ exceptions with cro you must set this variable to true.

Note 158-10: (DevEnv) Deleted `omake_deprecated` [SDK]

The build rule omake_deprecated that was added back in Note 128-08 has been deleted.

Note 158-11: (DevEnv) Made scatter file shared [SDK]

Up to now, in each separate program the preprocessor provided the scatter file that was specified to the linker.
But because this preprocess result is shared, that has been changed. Specifically, a preprocessed file has been included in the CTR-SDK so that this scatter file can be directly specified to the linker.
There are plans to delete the $CTR_SDK/build/linker directory in the future.
This issue will mainly affect those who construct their own build systems.

Note 158-12: (DevMenu) Fixed the `RequiredSize` (NAND capacity) display for Download Play child programs [SDK]

The DLP child CIA file's RequiredSize (NAND capacity) was calculated incorrectly such that a result larger than the actual size was displayed in the Import menu.
That was corrected so that now the correct result is shown.

Note 158-13: (FS) Clarified API reference to state that functions that get paths with multibyte characters in them are not thread-safe [SDK]

Clarified in the API reference that functions under nn::fs with paths comprising multibyte strings (const char*) are not thread-safe functions.

Note 158-14: (FS) Changed latency emulation operating conditions [SDK | System Updater]

Enabling/disabling the latency emulation functionality (which has features for virtually reproducing the variations in access speed that can occur due to device status and fatigue) is now dependent on the Debug flag set with the Config tool.

However, you also need to call fs::InitializeLatencyEmulation.
If it is not called, this functionality will always be disabled.
In the future, this functionality will be enabled in the Debug/Development builds and disabled in the Release build.

Note 158-15: (GR) Fixed a bug affecting checks for maximum number of four-dimensional vectors that can be set by the `MakeUniformCommandVS` and `MakeUniformCommandVS` functions [SDK]

The MakeUniformCommandVS function and the MakeUniformCommandVS function set four-dimensional vector arrays as uniforms, and there is a maximum number of four-dimensional vectors that can be set. The check for that maximum incorrectly treated the maximum number as 24. That has been fixed to the correct number, which is 64.

Note 158-16: (GR) Added functions to generate commands to execute a different command buffer [SDK]

Added functions for jumping to a command execution address in a different command buffer.
With the functions listed below, you can generate commands to jump to a command execution address in a different command buffer.

MakeChannel0JumpCommand( bit32* command, const uptr commandBufferPtr, const size_t commandBufferSize )
MakeChannel1JumpCommand( bit32* command, const uptr commandBufferPtr, const size_t commandBufferSize )

With the functions listed below, you can generate commands to jump to an execution address in a different command buffer and then return to the original execution address.

MakeChannel0SubroutineCommand( bit32* command, uptr* bufferSizePtr, const uptr commandBufferPtr, const size_t commandBufferSize )
MakeChannel1SubroutineCommand( bit32* command, uptr* bufferSizePtr, const uptr commandBufferPtr, const size_t commandBufferSize )

To return from the jump destination, you can use the following function:

MakeChannelKickCommand( bit32* command, const CommandBufferChannel channel )

Note 158-17: (GX) Revised PICA macro headers [SDK]

Added command buffer execution registers to gx_MacroReg.h.

PICA_REG_COMMAND_BUF_SIZE_CH0 = 0x238
PICA_REG_COMMAND_BUF_SIZE_CH1 = 0x239
PICA_REG_COMMAND_BUF_ADDR_CH0 = 0x23a
PICA_REG_COMMAND_BUF_ADDR_CH1 = 0x23b
PICA_REG_START_COMMAND_BUF_CH0 = 0x23c
PICA_REG_START_COMMAND_BUF_CH1 = 0x23d

Note 158-18: (GX) Fixed a bug in the `gd` library due to different resolutions in `DepthStencilTarget` and `RenderTarget` under certain conditions [SDK]

Fixed a bug where rendering results would be corrupted under the conditions below.

Configured not to use the device buffer
Resolution differs between the currently used RenderTarget and the previously specified DepthStencilTarget.
The gd::System::ForceDirty function was called

Note 158-19: (GX) Fixed a bug in `gd::LightingStage` when only `ShadowAlpha` is enabled [SDK]

Fixed a bug when using the gd library where correct results could not be obtained when disabling both the primary and secondary colors for shadow attenuation and only the alpha component was enabled.

Note 158-20: (GX) Changed default value for `gd::LightingStage::GlobalColorAmbient` [SDK]

Changed the default value for gd::LightingStage::GlobalColorAmbient to (10, 10, 10) to match the default value for DMPGL.

Note 158-21: (GX) Fixed a bug where offset value in `gd::OutputStage::SetDepthRangeMode` would not be applied correctly [SDK]

There was a mistake in dividing the offset value of the gd::OutputStage::SetDepthRangeMode function, producing unexpected results.
In addition, the offset parameter is type s32 but in some places it was treated as an unsigned value.
These bugs were fixed.

Note 158-22: (GX) Fixed typos in `gd::ResultInvalidShaderUniformName` and `gd::ResultInvalidShaderUniform` module names [SDK]

In both ResultInvalidShaderUniformName and ResultInvalidShaderUniform, the module name in the result was incorrectly given as GX. That has been corrected to GD.

Note 158-23: (GX) Added `gd::System::DrawImmediate` and `gd::System::DrawImmediateIndexed` functions [SDK]

Added the new functions DrawImmediate and DrawImmediateIndexed for drawing without using the vertex buffer.
The samples TriangleSimple, RenderToTarget and SilhouetteSimple located below gx/Gd reflect the additions of these functions.

Note 158-24: (GX) Added `gd::TextureStage::SetShadowZBias` function [SDK]

Added the new function gd::TextureStage::SetShadowZBias.
It was determined that the uniform shadowScale cannot be used due to hardware restrictions.
To maintain compatibility, the conventional function gd::TextureStage::SetShadowZScaleBias has been retained.

Note 158-25: (GX) Revised determinant for creating `InputLayout` in the `gd::VertexInputStage::CreateInputLayout` function [SDK]

If an InputLayout with the same settings has been created already, the CreateInputLayout function now returns the pointer to that same InputLayout without creating a new InputLayout.

Note 158-26: (GX) Added `nngxAddJumpCommand` and `nngxAddSubroutineCommand` functions [SDK]

Added the functions nngxAddJumpCommand and nngxAddSubroutineCommand to use command buffer execution registers and jump to command buffer execution addresses.

Note 158-27: (GX) Fixed a bug in `nngxMoveCommandbufferPointer` function [SDK]

Fixed a bug where the nngxMoveCommandbufferPointer function could move to an invalid memory region (before the start of the command buffer region).

Note 158-28: (GX) Added `nngxUseSavedCmdlistNoCacheFlush` function [SDK]

Added the function nngxUseSavedCmdlistNoCacheFlush, which has the same features as the nngxUseSavedCmdlist function but also does not flush the 3D command buffer cache.

Note 158-29: (GX) Changed command execution callback specifications [SDK]

The exit callback for the last command list has been revised such that the execution status is now the exit status.
This revision enables the command list exit callback to execute the next command list object after it has been bound.

Note 158-30: (GX) Updated the shader tool [SDK]

The shader assembler now supports the -dependency option to output dependencies.

Note 158-31: (GX) Fixed a bug in limiting the allocation range for display buffer memory [SDK]

Of the 3MB of VRAM-A and VRAM-B, the latter half 1.5MB region of each is not supposed to be allocated for the display buffer. However, in the Development and Debug builds, the region determination was incorrect when the nngxSwapBuffers function was called.
This was fixed so that the correct determination is now made.
An explanation of region determination was also added to the API reference.

Note 158-32: (GX) Updated the documentation [SDK]

The following changes were made to the GX documentation.

DMPGL20_specification.pdf

Added text about orthogonal projections to the description of bias values in "Shadow Reference Pass."
Deleted the restriction stating that the vertex buffer and the glDrawElements function must be used for rendering silhouettes.

DMPGL20_programming_guide.pdf

Added to the description about early depth tests (relating to the depth buffer update flag and comparison functions).
Added text about orthogonal projections to the description of the texture transformation matrix used for the shadow reference pass.

DMPGL20_system_API_specification.pdf

Added supplementary information to "Registering Interrupt Handlers for Command Completion."
Added nngxUseSavedCmdlistNoCacheFlush.
Added nngxUseSavedCmdlistNoCacheFlush.
Added nngxAddSubroutineCommand.
Added the section "Profile API."
In the section "Framebuffer Access Control Setting Registers," revised the conditions under which color buffer reading can be turned off.
Changed the command buffer execution register channels from 1/2 to 0/1.
Revised 5.8.19.4. "Lookup Table Settings" for easier understanding.
Added a note about the command buffer execution registers.
Revised the explanation about the execution cost for PICA register write commands.

VertexShaderReferenceManual.pdf

Added a description of the -dependency option for outputting assembler file dependencies.

Note 158-33: (GX) Added profiling functions [SDK]

Added the following functions to get PICA profile information:

nngxStartProfiling Function
nngxStopProfiling Function
nngxGetProfilingResult Function
nngxSetProfilingParameter Function

For more information, see Chapter 6 "Profile API" in the System API Specification.
To view an example of their implementation, see the code for SampleDemos/gx/Api/EarlyDepthTestSample.

Note 158-34: (HID) Added constant indicating maximum amount of sampling data that can be loaded at one time by the `Read` functions [SDK]

Added the constant MAX_READ_NUM, which indicated the maximum amount of sampling data that can be loaded at one time by the various Reader class Read functions.

Note 158-35: (HID) Fixed a bug where reading sampling values would return invalid values [SDK | System Updater]

The *Reader class Read functions used for reading sampling values would sometimes have a negative value for pReadLen, which indicates the amount of sampling data read. That has been fixed.

Note 158-36: (HIO) Sped up file writes [SDK | System Updater]

Accelerated the processing of nn::hio::HostFile::Write when running a program from emulation memory in PARTNER-CTR Debugger.
This does not accelerate the process when running a program from PARTNER-CTR UIC-MIDI.

Note 158-37: (HTTP) Made library private [SDK]

Functions for debugging that were public have been privatized.
If these functions are required for debugging, contact Nintendo.

Note 158-38: (MATH) Prevented implicit type conversion to `bool` for `VEC`, `MTX`, `QUAT` [SDK]

For the VEC, MTX and QUAT classes, there is no longer implicit type conversion to bool when actions like the following are taken. This was done to curtail behavior that goes against the developer's intent.

            VEC2 v;
            if (v) {...} // v is the pointer to a VEC2 member and is always evaluated as true

Code like that shown above now generates a build error.

Note 158-39: (MATH) Added functions to generate matrices for referencing shadow textures [SDK]

Added three functions (MTX34ShadowProjectionFrustum, MTX34ShadowProjectionPerspective and MTX34ShadowProjectionOrtho) for generating matrices for shadow texture referencing.

Note 158-40: (MATH) Increased speed of some functions [SDK]

Accelerated the processing of the TanIdx function and the TanFIdx function, which were slow.
Also accelerated the SinCosIdx function.

Note 158-41: (OS) Added support for running applications on Core 1 [SDK | System Updater]

Applications can now also use CPU core 1, which is used by the system.
Added the nn::os::SetApplicationCpuTimeLimit function for setting the CPU time the application can use in core 1, and the nn::os::GetApplicationCpuTimeLimit function for getting that set value.
The default value is 0% for the amount of CPU time that is allocated to the application in core 1, so you need to set a value with SetApplicationCpuTimeLimit before starting a thread that operates in core 1.
The maximum of amount of CPU time is 30% and is restricted by the system.

To conduct a process in core 1 you create a thread that operates in core 1.
To create a thread that operates in core 1, specify 1 for the coreNo argument of the nn::os::Thread class Start function.

System processes cannot operate in core 1 during the time that is allocated to the application, even if the application is not using the CPU.
In other words, wireless communication and other system-related processes will slow down during periods when core 1 is allocated to the application.

Below is a concrete example of how core 1 CPU time is allocated to the application:
If N is specified as the argument for the SetApplicationCpuTimeLimit function, then the first 2 * N / 100 ms of every 2ms interval is allocated to the application.
If N = 25, then the application operates for the first 0.5 ms and the system operates for the next 1.5 ms, after which the application operates for 0.5 ms and then the system for 1.5 ms, etc.

The following kinds of restrictions ensure that allocated CPU time does not become 0 if there is a thread operating in core 1:

If CPU time allocation is 0, any attempt to create a thread to operate in core 1 will fail.
Use the nn::os::SetApplicationCpuTimeLimit function to allocate sufficient CPU time before creating a thread to operate in core 1.
An error will occur if a value less than 5 is specified by the nn::os::SetApplicationCpuTimeLimit function.
Once core 1 CPU time has been allocated the CPU time allocation cannot be reverted to 0.

Note 158-42: (OS) Added `explicit` modifier to constructors [SDK]

The explicit modifier has been added those OS library class constructors that take a single parameter since these are not expected to involve implicit type conversions.

Note 158-43: (OS) Added support for tasks requiring virtual destructors [SDK]

Virtual destructors were not defined for classes with virtual member functions, so definitions for these were added.

Note 158-44: (OS) Extended exception handler specifications [SDK | System Updater]

The specification for exception handlers was extended in the following ways:

You can now separately specify the buffer for holding the exception information.
You can now use the stack of the thread where the exception occurred as a buffer or stack.
You can now specify a handler as well as a buffer for each separate thread.

Note 158-45: (OS) Deleted unimplemented functions [SDK]

Deleted a number of not-implemented nn::os::Thread member functions.

Note 158-46: (RO) Added DLL support [SDK | System Updater]

Added the ro library for using dynamic modules.
For more information, see $CTR_SDK/documents/TechnicalNotes/Dll/DllManual.html.
In step with this, added sample demos under $SampleDemos/ro.

Note that you presently cannot conduct DLL debugging because the debugger does not support DLL.

Note 158-47: (SND) Fixed a bug where `Voice` playback might be delayed when specifying `NODROP` [SDK]

Fixed a bug where Voice playback with NODROP specified was sometimes delayed when specifying VOICE_DROP_MODE_REAL_TIME in a call to SetVoiceDropMode.

Note 158-48: (SND) Added `SetVoiceDropMode` function [SDK]

Added the SetVoiceDropMode function for changing how voice-drops are controlled.
When this new function is not called, the default behavior is the same as in the previous version.

Note 158-49: (SND) Loosened restrictions on `Voice::SetPriority` function [SDK]

For the SetPriority function, up until now you could not change from normal priority to VOICE_PRIORITY_NODROP and vice versa. Those restrictions have been removed.

Note 158-50: (SND) Fixed a bug in `WaitForDspSync` that could cause buffer overflow [SDK]

Fixed a bug where the temporary buffer allocated on the stack would overflow when processing a Voice object in a call to WaitForDspSync, under the conditions listed below.

When five or more WaveBuffer objects are appended to a Voice
When five WaveBuffer objects are playing in one sound frame

Note 158-51: (SND) Increased speed of effect processing [SDK]

The processing load has been lightened for Delay and Reverb.
Processing details and sound quality remain unchanged.

Note 158-52: (SND) Revised criteria for identifying processing slowdowns when triple-buffering [SDK]

When three buffers were set by the nn::snd::SetOutputBufferCount function, sometimes a processing slowdown was determined even when there was no actual slowdown. That has been fixed.

Note 158-53: (SOCKET) Made library private [SDK]

Send/receive functions for debugging that were public have been privatized.
If these functions are required for debugging, contact Nintendo.
In step with this, the header required for calling the functions socket::Initialize and socket::Finalize has been changed to nn/socket_Initialize.h (from nn/socket.h).
NEX application developers should take note of this.

Note 158-54: (SSL) Made library private [SDK]

Functions for debugging that were public have been privatized.
If these functions are required for debugging, contact Nintendo.

Note 158-55: (TOOL) Revised `BannerModelConverter` [SDK]

Corrected the following bugs for BannerModelConverter:

Did not operate correctly for certain Windows locale settings.
Would sometimes output invalid data that stopped the system viewer.

Note 158-56: (TOOL) Added `Config` tool features [SDK]

Added the following features to the operations of the Gyro/Accel Cal for Check items:

Batch change RPM 0/Offset by pressing L/R Button while holding down X Button.
Batch change RPM Sensitivity/Scale by pressing L/R Button while holding down Y Button.

Note 158-57: (TOOL) Added `Config` tool setting items [SDK]

Added a settings item to the Config tool for setting a limit value for the stereo camera's calibration value.
This setting is used for checking whether scenes captured by the stereo camera display without screen being cut when the calibration value is the limit value.

Note 158-58: (TOOL) Changed to display warning when Download Play child exceeds size restriction [SDK]

When the CIA file for the DLP child is created, a calculation is made of the NAND capacity required for import.
When the capacity exceeds the 32MB restriction, a warning is now displayed.

Note 158-59: (TOOL) Added value for add-on content to `Category` in RSF file [SDK]

Added the value AddOnContents for add-on content to TitleInfo/Category of RSF.
Note that this change is an added feature for future support of add-on content, and currently add-on content still cannot be developed.

Note 158-60: (TOOL) Support for TGA files with `ctrTexturePackager` ID field [SDK]

Fixed a bug in ctrTexturePackager where the ID field size of images in the TGA format is always treated as 0, causing color data to be off sometimes off.

Note 158-61: (TOOL) Fixed a bug in `ctr_WaveConverter` related to loading of certain `.wav` files [SDK]

Fixed a bug where conversion errors sometimes occurred when ctr_WaveConverter32.exe loaded WAV files exported by certain tools.

Note 158-62: (TOOL) Added feature to `ctr_makerom` to suppress warnings [SDK]

Added a feature to suppress ctr_makerom warnings.
However, currently, only warnings due to the combination of BackupMemoryType and CardDevice are suppressed.
See the reference page for details.

Note 158-63: (TOOL) Added `ctr_makerom` support for download application demos, added `DESC` for download application demos [SDK]

ctr_makerom now supports the creation of downloadable application demos.
You can create the CCI files for downloadable application demos by setting DemoVersion.desc for the RSF TitleInfo - Category and for the DESC file.
For more information, see ctr_makerom.
Official documentation for creating downloadable application demos is scheduled for release in September.

Note 158-64: (TPL) Added `TPL` library for Windows [SDK]

Added the TPL library libnn_tplWin{d}.lib for the Windows environment.

Note 158-65: (UDS) Improved the efficiency of the `Attach` and `Receive` functions [SDK]

Improved the efficiency inside the nn::uds::Attach function and the nn::uds::Receive function of the process of searching for the end pointer.
The processing load of calling these functions has been reduced, albeit by just a little.

Note 158-66: (UDS) Revised processing of boundary values in `ConnectNetwork` and `SendTo` functions [SDK]

When a passphrase has been specified that is shorter than the minimum length or exceeds the maximum length, the ConnectNetwork function now returns nn::uds::ResultOutOfRange.
When a dataSize has been specified that is shorter than the minimum length or exceeds the maximum length, the SendTo function now returns nn::uds::ResultTooLarge.

Note 158-67: (UDS) Support for specifying username in `Initialize` function [SDK]

Overloaded an Initialize function with an added argument for specifying the local user name.
Be sure to comply with the UGC guidelines and perform the appropriate processing when specifying user names.
If nothing is specified (NULL), the user name in the System Settings is used.

Note 158-68: (UDS) Deleted `GetMacAddress` function [SDK]

Deleted the nn::uds::GetMacAddress function, which was used for debugging.
This was done to prevent mistaken use of the nn::uds::GetMacAddress function in the retail product.
For debugging and other purposes when you want to identify systems, instead of the MAC address use the user name that can be gotten from the NodeInformation structure with the nn::uds::GetNodeInformation function, or use the local friend code.

Note 158-69: (UDS) Changed specification for `scrambledLocalFriendCode` member of `NodeInformation` structure [SDK]

Changed the specification for the scrambledLocalFriendCode member so the individual identifiers of devices can be used during the entire time from the start of the application to the end.
This way, you can determine whether clients connected while operating as the DLP server match the communicating nodes of subsequent UDS communications.

Note 158-70: (UDS) Fixed a bug where packets of size 0 could be sent [SDK | System Updater]

Fixed a bug where the nn::uds::SendTo function would send packets of size 0.
Applications can receive packets of size 0, but sending and receiving these kinds of packets increases the processing load unnecessarily.

Note 158-71: (UDS) Fixed a bug where network information could only be gotten from scan results once [SDK | System Updater]

Fixed a bug where calls to the NetworkDescriptionReader class member function GetNetworkDescription only succeed once, and would return error ResultMalformedData on subsequent calls.

Note 158-72: (UDS) Fixed a bug where a beacon's optional data could not be gotten correctly immediately after connecting to the network [SDK | System Updater]

Fixed a bug where calling ConnectNetwork to connect to the network and then immediately calling GetApplicationDataFromBeacon on the client to get optional beacon data would get incorrect data.

Known Issues with SDK 3.0.0 Release

In the GD LightingSample demo, you will see a phenomenon where the area the light is shining on will periodically flash.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used
A large font size is set (it is possible that what size is problematic is dependent on the font)
Two levels of gradation are set for the number of gradations under the advanced settings (this applies to both the A4 and LA4 settings)

■ CTR-SDK Version 3.0.0 System Updater 0.16.0

(2011/08/05)

Note 157-01: (AC) Fixed a bug where WPA connection failure would take a long time [System Updater]

Fixed a bug where connecting to certain kinds of access points via the WPA-TKIP and WPA2-TKIP protocols would take a long time to end when the connection failed.

Note 157-02: (APPLET) Suppressed sleep notifications when closing an application [System Updater]

When the application is ending on request from the HOME Menu, it no longer receives sleep notifications when the system is closed.

Note 157-03: (APPLET) Fixed a bug where system would halt when the HOME Button is pressed while in the POWER Menu [System Updater]

When the POWER Button moved the system from the application to the POWER Menu and the HOME Button was pressed while an application in the background was still in the process of ending, sometimes the processes of application finalization and menu transition would overlap and processing would stop.
This bug has been fixed.

Note 157-04: (CAMERA) Fixed a bug where `Initialize` function would not return [System Updater]

Fixed a bug where calling camera::Initialize repeatedly with no interval between calls while the system was being opened and shut rapidly would rarely fail to return.

Note 157-05: (CAMERA) Fixed a bug where camera LED would not turn off [System Updater]

Fixed a rare bug where the camera LED would remain lit if the system was opened and closed repeatedly after calling camera::Finalize.

Note 157-06: (CAMERA) Fixed a bug where calling `Activate` while opening and closing the system returns a success without actually doing anything [System Updater]

Fixed a bug where calling Activate while opening and closing the system would rarely return success, but not actually execute.

Note 157-07: (CEC) Added recovery for when NAND cannot be accessed [System Updater]

The system would hang at times when it was impossible to access the NAND region handled by CEC.
Now, when this abnormal state arises an FS fatal error is output.

Note 157-08: (CEC) Fixed a bug where data read/write fails [SDK | System Updater]

Fixed a bug where data accessed from multiple threads or processes at the same time would cause read/write failures and occasional data corruption.

Note 157-09: (CEC) Fixed a bug where values such as maximum number of receivable messages would change [System Updater]

When boxes were accessed multiple times, the CEC library would specify invalid settings values and items like the maximum number of messages would get changed.
To fix this, values now are restored to their previous settings when invalid settings values are specified.

Note 157-10: (FRIENDS) Improved logout behavior when disconnecting from access point [System Updater]

If the system was disconnected from an access point before communication was ended with a logout, the internal state of the daemon would remain in the logging out state for a certain amount of time, and this would affect such actions as immediately logging back in. The behavior has been improved.

Note 157-11: (FRIENDS) Fixed a bug where functions block when online and system sleeps or wireless is disabled [System Updater]

Fixed a bug where the friends library functions would sometimes be blocked for a period of several frames to around 1 second if the system went to sleep or the wireless switch was turned off while online.

Note 157-12: (FRIENDS) Fixed a bug where undefined Mii is registered to / received from server [System Updater]

Fixed a bug where problems occurring when sending or receiving a Mii would sometimes result in an undefined Mii being registered to or received from the server.

Note 157-13: (FS) Improved algorithm for finding free space on SD cards [System Updater]

Creating a large file can take a very long time when free space is highly fragmented on an SD card and there is relatively little space available. The algorithm has been improved to deal with this problem.

Note 157-14: (FS) Fixed behavior when backup device format is invalid [System Updater]

Fixed a bug with certain backup devices where invalid device formats would not be correctly recognized.

Note 157-15: (FS) Changed latency emulation operating conditions [SDK | System Updater]

Note 157-16: (FS) Fixed a bug where function to get number of blocks used by expanded save data would fail [System Updater]

Fixed a bug where expanded save data with an extremely deep hierarchy of files and directories would cause the Get*SaveDataBlockSize functions to freeze.

Note 157-17: (FS) Fixed a bug where open files on write-protected SD cards cannot be accessed [System Updater]

Fixed a bug where opening a file on a write-protected SD card in read-only mode and then performing other SD card operations would prevent any further access to that file.

Note 157-18: (HID) Fixed a bug where reading sampling values would return invalid values [SDK | System Updater]

The *Reader class Read functions used for reading sampling values would sometimes have a negative value for pReadLen, which indicates the amount of sampling data read. That has been fixed.

Note 157-19: (HIO) Sped up file writes [SDK | System Updater]

Note 157-20: (MCU) Fixed rare bug where calendar reverts to January 1, 2011 [System Updater]

Fixed a rare bug where errors during communication between devices would cause the screen would to look grainy and the calendar would revert to January 1, 2011. Such communication errors are now detected and invalid data is not written.

Note 157-21: (MCU) Fixed a bug where system could not be turned on [System Updater]

Fixed a bug where the system would not turn on unless the POWER Button were pressed several times, after the system was turned off and left that way for some time.

Note 157-22: (NET) Fixed a bug where DS software would freeze on Wi-Fi Connection settings screen [System Updater]

Fixed a bug where some systems would freeze after starting DS software that supports Wi-Fi Connection and then searching for access points from the Wi-Fi Connection setup screen with wireless turned off.

Note 157-23: (NET) Fixed a bug with false-positive recognition of wireless module malfunction when network mode changed [System Updater]

When the network mode was changed (Local communication/StreetPass/Internet), there was a slight chance of wireless initialization failing and a fatal error being generated on the false recognition of a wireless module malfunction. (The fatal error was RSL:0xF9606C02 Level: 0xF9606C0F Level: -1 Summary: 11 Module: 27 Desc: 2.) That problem has been fixed.

Note 157-24: (OS) Fixed a bug where HOME Button stops working when card-removed error is displayed [System Updater]

Fixed a bug where the HOME Button sometimes would not work on the Game Card or SD card removal error screen, depending on the timing of the error.

Note 157-25: (OS) Workaround for fatal error bug when card removed [System Updater]

Implemented measures to reduce the frequency at which the fatal error screen and erroneous card-removed errors are displayed when a Game Card or SD card is removed.

Note 157-26: (OS) Added support for running applications on Core 1 [SDK | System Updater]

If CPU time allocation is 0, any attempt to create a thread to operate in core 1 will fail.
Use the nn::os::SetApplicationCpuTimeLimit function to allocate sufficient CPU time before creating a thread to operate in core 1.
An error will occur if a value less than 5 is specified by the nn::os::SetApplicationCpuTimeLimit function.
Once core 1 CPU time has been allocated the CPU time allocation cannot be reverted to 0.

Note 157-27: (OS) Support for importing download applications from debugger without overwriting save data [System Updater]

Added support for an option for loading and importing downloadable applications from the debugger without overwriting the save data.
To read how to use this, see the debugger Help.

Note 157-28: (OS) Fixed a bug where debugger hangs on stepwise execution when an event is signaled [System Updater]

Fixed a bug where the debugger would hang when using stepwise execution with nn::os::Event signaled.

Note 157-29: (OS) Fixed a bug where debugger hangs on execution after setting breakpoint when waiting for signal [System Updater]

The debugger would hang on execution after setting breakpoint when event signaled.

Note 157-30: (OS) Improved debugger log output process [System Updater]

Improved the debugger's log output process.
The load on the CPU has been reduced.
However, the log output may be slow to display when the system core CPU usage rate is high.

Note 157-31: (OS) Fixed a bug where application running on debugger is not notified to shut down even though battery is at 0% [System Updater]

Fixed a bug when the battery charge reached 0%, where the power would be cut before the IsExpectedToCloseApplication termination notification could reach the application running on the debugger.

Note 157-32: (OS) Extended exception handler specifications [SDK | System Updater]

The specification for exception handlers was extended in the following ways:

You can now separately specify the buffer for holding the exception information.
You can now use the stack of the thread where the exception occurred as a buffer or stack.
You can now specify a handler as well as a buffer for each separate thread.

Note 157-33: (OS) Restricted start of applications created on future CTR-SDK versions [System Updater]

Programs can no longer be started if created on versions of the CTR-SDK whose major version is later than the version that System Updater supports.
For example, if System Updater on a system supports CTR-SDK 3.0, then programs created using CTR-SDK 4.0 cannot be started on that system.

Note 157-34: (RO) Added DLL support [SDK | System Updater]

Note 157-35: (UDS) Added feature for automatic recovery from wireless fatal error when using UDS communication [System Updater]

Added support for automatic recovery from wireless fatal errors when UDS communications being used.
With this auto-recovery process, it appears to UDS communications as if the wireless feature was disabled and immediately re-enabled.
The UDS functions running at this time return a result indicating that the wireless mode transitioned to wireless-disabled mode.

Note 157-36: (UDS) Fixed a bug causing delay in the Wi-Fi Button OFF process [System Updater]

Fixed a bug where turning off the Wi-Fi Button during UDS communication without calling nn::uds::Finalize would cause a delay of around 1 second before Wi-Fi turned off.

Note 157-37: (UDS) Fixed a bug where packets of size 0 could be sent [SDK | System Updater]

Note 157-38: (UDS) Fixed a bug where network information could only be gotten from scan results once [SDK | System Updater]

Fixed a bug where calls to the NetworkDescriptionReader class member function GetNetworkDescription only succeed once, and would return error ResultMalformedData on subsequent calls.

Note 157-39: (UDS) Fixed a bug where a beacon's optional data could not be gotten correctly immediately after connecting to the network [SDK | System Updater]

Fixed a bug where calling ConnectNetwork to connect to the network and then immediately calling GetApplicationDataFromBeacon on the client to get optional beacon data would get incorrect data.

Note 157-40: (Friend List) Added Join in Currently Playing Software button [System Updater]

In preparation for future expanded features, added a button that displays as "Join in Currently Playing Software." This button cannot be used currently.

Note 157-41: (Photo Selector Applet) Fixed a bug where applet would halt when displaying thumbnails [System Updater]

Fixed a bug where the system would hang when displaying 200 or more thumbnail images.

Note 157-42: (Photo Selector Applet) Fixed a bug where applet would not return from sleep [System Updater]

Fixed a bug where the system would sometimes not wake up after going to sleep when an applet closed.

Note 157-43: (Photo Selector Applet) Added feature to change display size [System Updater]

Added a feature for displaying photos in full screen or partial using Up/Down on Circle Pad.

Known Issues with SDK 3.0.0 System Updater 0.16.0

See the Symptoms of Known Issues file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 3.0.0 Sample Demos

(2011/08/05)

Note 156-01: (DevEnv) Updated copyright [SDK | Sample Demos]

Updated the copyright notices throughout the source code of CTR-SDK and Sample Demos.

Note 156-02: (GR) Added `CommandBufferJump` sample [Sample Demos]

To provide an example of the use of the MakeChannel0SubroutineCommand function and the MakeChannelKickCommand function, added the sample CommandBufferJump which makes a subroutine of the command for setting lookup tables for the gr/DrawPrimitive sample.

Note 156-03: (GR) Support for duplicate sample command lists [Sample Demos]

The GR sample demos only supported a single command list. That was changed to support the making of backups.

Note 156-04: (GR) Fixed a bug where menu screen displays when starting from menu [Sample Demos]

In the framework used for the sample demos located under gx/Gr, the nngxStartLcdDisplay function was called before the first image was ready.
That has been changed to be called after the first WaitVSync.

Note 156-05: (GX) Added `ShadowKnot` sample demo to `Gd` [Sample Demos]

The DMPGL demo ShadowKnot has been moved to Gd.
You can switch to orthogonal shadow using a macro.

Note 156-06: (GX) Deleted `shadowZScale` uniform from `ShadowSimple` sample [Sample Demos]

The uniform shadowZScale was deleted, but related code remained in the sample gx/DMPGL/ShadowSimple, so it too was deleted.

Note 156-07: (GX) Updated `Gd` samples [Sample Demos]

The following updates were made to the samples located under gx/Gd:

Changed the debug output message.
Support for the DrawImmediate* functions (only some; switchable with macro).

Note 156-08: (GX) Fixed samples passing incorrect `mask` value to `ngxUseSavedCmdlist` [Sample Demos]

In the sample demos, the state flag passed to nngxUseSavedCmdlist in CommandCacheVSUniformModel was 0xFFFFFFFF. That has been corrected to NN_GX_STATE_ALL.

Note 156-09: (GX) Added early depth test sample demos [Sample Demos]

Added sample demos of the use of the early depth test on its own.
A GD version and a DMPGL version have been created.

Note 156-10: (GX) Added sample of subroutine use of command buffer [Sample Demos]

Added sample of making a subroutine of the command buffer.
The new sample supports the making of subroutines with the DMPGL demo LightingMicrofacet.

Note 156-11: (GX) Changed how texture matrices are created in the samples that handle shadow maps [Sample Demos]

In some of the sample demos, texture matrices were created without using the CTR-SDK standard functions. The demos have been rewritten to use new functions added to the Math library.

Note 156-12: (HIO) Changed `RSF` file used in `hio` demo [Sample Demos]

Deleted unnecessary settings from the RSF file used in the hio demo.

Known Issues with SDK 3.0.0 Sample Demos

None.

■ CTR-SDK Version 2.4.0 Release

(2011/06/28)

Note 155-01: (APPLET) Hid the `AssignGpuRight and ReleaseGpuRight` functions from public view [SDK]

Documentation regarding the applet::AssignGpuRight and ReleaseGpuRight functions have been removed from the API reference because there is no need to call them from an application.
At present, plans call for leaving behind disclosed header files, but completely hiding these functions in future versions of CTR-SDK.

Note 155-02: (BOSS) Extended the specifications of the `TaskError::GetProperty` function.

TASK_ERROR_CODE was added, in addition to the conventional TASK_COMM_ERROR_CODE, as an identifier for getting error information.
TASK_ERROR_CODE will become the standard identifier, so use it from now on.

Note 155-03: (CAMERA) Revised argument names for the `GetStereoCameraCalibrationMatrix*` functions [SDK]

The third argument of the GetStereoCameraCalibrationMatrix function and fifth argument of the GetStereoCameraCalibrationMatrixEx function were named in a way that might lead to confusion, so they have been changed from translationByPixel to translationUnit.
Along with this change, a description of these arguments has also been added to the API reference.

Note 155-04: (CEC) Added mutex exclusion for functions that access the box

There was a bug where the value set for the maximum number of receivable messages in the message box, and other such parameters, were being unintentionally changed if the OpenMessageBox or CloseMessageBox function was called during execution of the DeleteAllMessages function.
Mutex exclusion was added so that these functions cannot execute simultaneously.

Note, however, that there is still a chance that this problem may also occur when interrupting an application by pressing the HOME Button.
As such, pay careful attention so that no malfunctions arise at this time as the system may receive more data than it is set to handle.

Note 155-05: (CFG) Now display a warning if an API function is called without having called `Initialize`

Specifications have been made so a warning message is output to the debug log if an API function is called without having first called Initialize.

Note 155-06: (CX) Added a function for expanding files compressed with LZ format backward compression.

The UncompressBLZ and SecureUncompressBLZ functions have been added for expanding files compressed with LZ backward compression.

Note 155-07: (DLP) Added a function to the server for getting client download progress [SDK | Sample Demos]

The nn::dlp::ServerGetClientState function was added to get client download progress.

Note 155-08: (DSP) Hid the API unnecessary for application development from view [SDK]

The following API functions in the nn::dsp namespace have been hidden from public view.

RegisterInterruptEvents
RecvData
SendData
RecvDataIsReady
SendDataIsEmpty
ReadPipeIfPossible
WriteProcessPipe
CheckSemaphoreRequest
ClearSemaphore
MaskSemaphore
GetSemaphore
SetSemaphore
Sleep
WakeUp
GetHeadphoneStatus
(The nn::snd class includes an API function of the same name. Use that.)

Note 155-09: (DevEnv) Deleted `NN_USE_MAKECCI` [SDK]

An unnecessary macro definition (-DNN_USE_MAKECCI) was specified as a compiler option in the CTR-SDK build system.

Note 155-10: (DevEnv) Added battery status icons [SDK]

Battery status icons and associated documentation have been placed in the $CTR_SDK/resources/icon/BatteryLevelIcon directory.

Note 155-11: (DevEnv) Added communication icons [SDK]

Communication icons and associated documentation have been placed in the $CTR_SDK/resources/icon/CommunicationIcon directory.

Note 155-12: (DevEnv) Added a document explaining the differences between development systems and production hardware

The documentation related to the differences between development systems and production hardware has been placed in the following directory.
$CTR_SDK/documents/TechnicalNotes/AboutHardwareDifference/AboutHardwareDifference.xlsx

Note 155-13: (FND) Added `UnitHeap::GetAlignment` [SDK]

An interface has been added for getting the alignment unit that can be allocated from the unit heap.

Note 155-14: (FONT) Added a document on internal bitmap fonts [SDK]

The following documentation about internal bitmap fonts has been added.
$CTR_SDK/documents/resources/BuiltInFont/BuiltInFont.html

Note 155-15: (FS) Fixed a bug where `4MbitVerificationFailed.bin` was not returning the expected result [SDK]

4MbitVerificationFailed.bin is a binary used to issue fs::ResultVerificationFailed when mounting save data. It has been revised and replaced because it has been returning fs::ResultBadFormat since CTR-SDK 2.1.

Note 155-16: (FS) Added characters that must not be used in archive names [SDK]

The fact that "$" must not be used at the start of an archive name was added to the API reference.

Note 155-17: (GR) Revised to check the maximum number of four-dimensional vectors that can be set using `MakeUniformCommandVS` and MakeUniformCommand.

Specifications have changed so that an assert is generated if an attempt is made to set a number of four-dimensional vectors inside MakeUniformCommandVS or MakeUniformCommandVS (used to set four-dimensional vector arrays as uniform) that exceeds the maximum number (24) allowed.

Note 155-18: (GR) Fixed a bug with commands related to `zBias` when using the `RenderState::ShadowMap::MakeTextureCommand` function [SDK]

Fixed a bug in the RenderState::ShadowMap::MakeTextureCommand function affecting command generation for bits [23:1] of register 0x8b, equivalent to the dmp_Texture[0].shadowZBias uniform.

Note 155-19: (GR) Delete `RenderState::ShadowMap::zScale` [SDK]

Settings of the reserved uniform shadowZScale were discovered to be disabled in hardware. Code was changed so that commands are not issued using this variable.

Note 155-20: (GR) Revised commands issued when kicking off rendering with `Vertex::MakeDrawCommand` [SDK]

Among commands generated when kicking off rendering with Vertex::MakeDrawCommand, there were locations in code where the byte enable [31:8] was not set to zero when writing to register 0x245.

Note 155-21: (GR) Deleted `gr::Shadow` [SDK]

gr::Shadow was deleted. Its planned removal has been mentioned before in the API reference.
Use the RenderState::ShadowMap class from now on for generating render state-related commands.

Note 155-22: (GX) Added a API reference for the `SetInternalDriverPrioMode` function [SDK]

A API reference was added for nn::gx::CTR::SetInternalDriverPrioMode (and the corresponding C function nngxSetInternalDriverPrioMode).

Note 155-23: (GX) Fixed a bug with the `gd::ShaderStage::SetFloatConstantBuffer` function regarding registers specified as "Unmanaged" [SDK]

Incorrect operations would result even if the ShaderStage::CreateShaderPipeline function was called by the ShaderStage::SetFloatConstantBuffer function on a register specified as "Unmanaged" when using the geometry shader.
This bug has been fixed.

Note 155-24: (GX) Changed the gd texture cache flush timing [SDK]

The texture cache was being flushed every time a texture was set in the texture unit. Specifications have changed so that the texture cache is now flushed only when necessary for each rendering pass.
In addition, a cache flush operation on the texture unit has been added. It is used by both the CopyTextureSubResource and CopyTexture2DResourceLinearToBlock functions.

Note 155-25: (GX) Fixed a bug where data would not be set correctly in `gd` library constant uniform registers starting from `c64` [SDK]

A bug has been fixed where c64 through C95 in the floating point constant register c# are not reflecting changes made by commands issuing changes.

Note 155-26: (GX) Changed the name of various API functions in the gd library [SDK]

The name of gd library API functions have been changed according to the convention below.
Note, however, that conventional names have been left behind for compatibility purposes.
Plans call for the removal of old names in a future CTR-SDK update.
Use the new names from now on.
Conventional -> Revised

Classes

VertexShader -> Shader

enum

OutputStage::StencilFailOperation → OutputStage::StencilOperation
RasterizerStage::CullingType → RasterizerStage::Culling
Resource::NativeResourceFormat → Resource::NativeFormat
Resource::ResourceFormat → Resource::Format
Resource::CompressedResourceFormat → Resource::CompressedFormat
ProceduralTextureStage::ProceduralTextureRgbMap → ProceduralTextureStage::UvMap
ProceduralTextureStage::ProceduralTextureClamp → ProceduralTextureStage::Clamp
ProceduralTextureStage::ProceduralTextureShift → ProceduralTextureStage::Shift
ProceduralTextureStage::ProceduralTextureMinFilter → ProceduralTextureStage::MinFilter

Functions

ShaderStage::SetShaderPipelineConstantF → ShaderStage::SetShaderPipelineConstantFloat
ShaderStage::SetShaderPipelineConstantB → ShaderStage::SetShaderPipelineConstantBoolean
ShaderStage::SetShaderPipelineConstantI → ShaderStage::SetShaderPipelineConstantInteger

Note 155-27: (GX) Fixed a bug in the `gd::Finalize` function [SDK]

There was a bug in finalization when using the gd:Finalize function.
Fixed a bug where initialization would not occur correctly even when calling gd::Initialize after calling gd::Finalize.

Note 155-28: (GX) Support for operations on numbers of vertex elements even less than given by settings of the `gd::InputLayout` shader [SDK]

Behavior has been changed so that operations will proceed even if InputLayout is defined as having fewer vertex elements (numElements) than the number of shader bind_symbols.

Note 155-29: (GX) Added an error check when creating `gd::InputLayout` [SDK]

A process used while creating InputLayout was added for checking that the slot numbers (m_StreamSlot) in InputElementDescription have been defined in order beginning from 0.
If they are not defined in order, the error ResultInputLayoutInvalidStreamSlots is returned.

Note 155-30: (GX) Fixed a bug with the `UnmapVertexBufferResource`, `UnmapTexture2DResource` function in the `gd::Resource` class [SDK]

Sometimes modified data was not being correctly applied due to a bug with the Resource::UnmapVertexBufferResource and UnmapTexture2DResource functions.
This bug has been fixed.

Note 155-31: (GX) Added an argument for specifying whether to copy initialized data to `gd::Resource::Create*` functions [SDK]

The argument copyInitialData has been added to the Resource::CreateTexture2DResource, Resource::CreateVertexBufferResource functions.
The default is true.
Now, if false is set, data is directly accessed without copying even if main memory (FCRAM) is specified.

Note 155-32: (GX) Added the `gd::Resource::Helper::GenerateMipMapsCPU` function [SDK]

The Resource::Helper::GenerateMipMapsCPU function was added to support the automatic generation of mipmap data by the CPU.

Note 155-33: (GX) Added support for `gd::TextureStage projection` textures [SDK]

The TextureStage::SetTexture2DProjectionForUnit0 function has been newly added to support projection textures.

Note 155-34: (GX) Revised the default value of `ptMinFilter` when using the `gd::TextureStage::SetDefault` function [SDK]

Contrary to specifications, MIN_FILTER_NEAREST was being used as the default value for the ptMinFilter argument of the gd::TextureStage::SetDefault function. The default value has been changed to MIN_FILTER_LINEAR to match stated specifications.

Note 155-35: (GX) Removed the `GetRegisterCount` and `GetManagedLocation` functions in the `gd::UniformLocation` class [SDK]

The GetRegisterCount and GetManagedLocation functions of the gd::UniformLocation class have been removed because they are not needed for development.

Note 155-36: (GX) Updated the shader tool [SDK]

The following changes were made to the shader tool.

Revised conditions that result in an assembler error when it comes to undefined operations due to executing commands in a particular order.
(Made changes so that a dependency relationship is determined if the register is the same for condition 5, 6, and 7, even if a component is not overlapped.)
Changed conditions on generating a stall by the performance check feature.
Made changes so that a stall due to dependency relationship between registers is determined even if a component is not overlapped.)

Note 155-37: (GX) Updated the documentation [SDK]

The following changes were made to the GX documentation.

DMPGL20_specification.pdf

Added the fact that the output value of each texture combiner stage is clamped in the range [0,1]
Revised an erroneous description of the byte order of compressed textures that include an alpha
Added a supplement regarding the addressing of compressed textures
Deleted dmp_Texture[0].shadowZScale from specifications (because it was clearly invalid due to hardware specifications)

DMPGL20_programming_guide.pdf

Added the description for "Configuring Textures" under the section "Performance-Enhancement Techniques"
Deleted dmp_Texture[0].shadowZScale from specifications (because it was clearly invalid due to hardware specifications)
Added supplementary information to "Implementing Vertex Shaders" in the section "Performance-Enhancement Techniques"
Added a description of a phenomenon to "Lines Are Unexpectedly Rendered Onscreen."

DMPGL20_system_API_specification.pdf

Deleted parallel execution mode and synchronous execution mode from specifications
Added supplementary information regarding nngxFilterBlockImage transfer addresses
Deleted dmp_Texture[0].shadowZScale from specifications (because it was clearly invalid due to hardware specifications)
Added a specification that specifying 0 in register 0x228 is an illegal operation
Revised descriptions given in 5.8.20.13 Shadow Texture Settings and 5.8.20.14 Gas Texture Settings.
Added supplementary information about the post-vertex cache to 3.4 NN_GX_CMDLIST_HW_STATE.
Revised the description given in 5.8.14.1 Base Address.
Added supplementary information to "Registering Interrupt Handlers for Command Completion."
Added a section titled "Execution Cost of PICA Register Write Commands"

VertexShaderReferenceManual.pdf

Added a description of rcp, rsq, exp, and log instructions to "Results of Exceptional Operations"
Added additional information to their references as well
Added a description of how to distinguish ∞, -∞, and NaN when using the cmp command.
Revised the description given in "Output Order of Calculation Results"
Changed the conditions for stalling given in "Stalls Due to Instruction Dependencies"
Revised invalid operations conditions in the "Invalid Operation Due to a Specific Order of Instruction"
Added supplemental information to "Stalls Due to Conflicts Among Arithmetic Units."
Added an item titled "Unconditional Stalls."
Revised the sample code titled "Packing Multiple Attributes into a Single Output Register" using output_map(data_name, mapped_register).

Note 155-38: (HIO) Added `HostFile::Exists` [SDK]

Added HostFile::Exists to function the same as HostFile::IsExist.
Do not use HostFile::IsExist as it will be deleted in a future release.

Note 155-39: (HIO) Fixed a bug with the `SerialChannel::GetWritableSize` function [SDK]

Fixed a bug where the value returned by hio::SerialChannel::GetWritableSize was smaller than the original value.

Note 155-40: (HIO) Deleted documentation related to the host interface [SDK]

Because the documentation supplied with PARTNER-CTR HIO Daemon is the latest available regarding the HostIO host interface, information on that topic was removed from CTR-SDK documentation.

Note 155-41: (HTTP) Deleted the `SetSocketBufferSize` function [SDK]

The nn::http::Connection::SetSocketBufferSize function was deleted.

Note 155-42: (INIT) Adopted the default implementation of `calloc/realloc` [SDK]

If nninitStartUp is not replaced, malloc and free could be used by default, but not calloc and realloc.
Specifications were changed so that calloc and realloc can also be used by default.
These functions may be replaced with original implementations just as malloc/free.

Note 155-43: (NSTD) Added the `ntsd` library [SDK]

The nstd library was added as a separate implementation of the standard library.
This library includes MemCpy and MemMove for optimized copying of memory according to the given alignment. It also includes TSPrintf, TSNPrintf and TVSNPrintf for forming strings using a small stack.

Note 155-44: (OS) Added the `Alarm::TryInitialize` function [SDK]

The TryInitialize function was added to the Alarm class. The function receives whether initialization succeeded or failed as a return value.

Note 155-45: (OS) Added the `StackMemory::TryInitialize` function [SDK]

The TryInitialize function was added to the StackMemory class. The function receives whether initialization succeeded or failed as a return value.

Note 155-46: (OS) Updated the System Programming Guide [SDK]

The System Programming Guide ($CTR_SDK/documents/TechnicalNotes/SystemProgrammingGuide/SystemProgrammingGuide.pdf) included deprecated content that was deleted.

Note 155-47: (OS) Improved error handling inside the library [SDK]

Code was revised to fix a problem with the error handling inside some functions in the OS library.
No changes were made to the behavior of these functions during normal use.

Note 155-48: (OS) Changed behavior when an internal error occurs [SDK]

Up until this release the display would switch to a fatal error screen if an internal error occurred in the OS library. Since this would cause the display of a fatal error screen due to the simplest programming mistake, specifications have been changed for the development environment so that program execution merely stops rather than displaying a fatal error screen.

Note 155-49: (SND) Changed specifications for `DecodeAdpcmData` [SDK]

const was added to the pInput and param arguments.
Code was also revised so that context information when decode ends is stored in the context argument.

Note 155-50: (SND) Fixed a bug causing noise during HOME Button transition [SDK]

There has been a bug since CTR-SDK 2.0 where a small amount of audio noise is introduced when changing screens using the HOME Button, when going to sleep, and when recovering from sleep. This bug has been fixed.
This was actually fixed in CTR-SDK 2.3.4 but was accidentally omitted from the change log.

Note 155-51: (SND) Added the `Voice::DeleteWaveBuffer` function [SDK]

The Voice::DeleteWavebuffer function has been added for deleting buffer information added using the Voice::AppendWaveBuffer function.

Note 155-52: (SND) Added the `Voice::UpdateWaveBuffer` function [SDK]

The Voice::UpdateWavebuffer function has been added for updating the sampleLength and loopFlag parameters included in buffer information added using the Voice::AppendWaveBuffer function.

Note 155-53: (DSP) Hid several Voice API functions from view [SDK]

The following functions have been hidden from view:
Use them for referencing arguments from now on.

void SetMonoFilterCoefficients(const MonoFilterCoefficients* pCoeff)
void SetBiquadFilterCoefficients(const BiquadFilterCoefficients* pCoeff)
void GetMonoFilterCoefficients(MonoFilterCoefficients* pCoeff)
void GetBiquadFilterCoefficients(BiquadFilterCoefficients* pCoeff)

Note 155-54: (SND) Found a workaround for a problem where `AllocVoice` data abort would occur if an invalid call to `FreeVoice` was made [SDK]

Specifications were changed to fix a problem where there was a chance of data abort inside the AllocVoice function if an invalid voice, such as a dual FreeVoice, was processed.

Note 155-55: (TOOL) Changed where CTR tool references are placed [SDK]

The CTR tool references located in $CTR_SDK/tools/TargetTools had been included with API references until now, but have been moved to index.html.
With this move, the items "CTR Tools" and "Windows Tools" have been added to index.html.

Note 155-56: (TOOL) Revised specifications so that save data is maintained during overwrite import on the DevMenu [SDK]

Up until this release, save data would be deleted if a CIA File was overwrite imported on the DevMenu. Save data is no longer deleted.
To delete save data, first delete the program using the X Button.
Further revision has been made so that imports are canceled if there has been no change to the program when an overwrite import is performed.

Note 155-57: (TOOL) Revised specifications so that a write-protected SD card cannot be used on the DevMenu [SDK]

Specifications have changed so that file operations are unavailable if a write-protected SD card is inserted in using DevMenu.
To use an SD card, switch to a writable one.

Note 155-58: (TOOL) Added a feature for exporting BOSS data using SaveDataFiler [SDK]

Specifications have changed so that BOSS memory is also exported when exporting expanded save data using SaveDataFiler.

Note 155-59: (TOOL) Fixed a bug where icons would be corrupted when importing expanded save data using SaveDataFiler [SDK]

Fixed a bug where icons used for expanded save data were being corrupted when expanded save data was imported using SaveDataFiler.

Note 155-60: (TOOL) Revised the file destruction feature of `SaveDataFiler` [SDK]

Fixed a bug where an error dialog box was being displayed even though file destruction succeeded when destroying files using SaveDataFiler.
The message displayed when file destruction fails was also made easier to understand.
For more information, see the API reference.

Note 155-61: (TOOL) Changed the behavior when `UniqueId` is not set [SDK]

In past releases, if UniqueId in the RSF was unspecified, processing would continue as if 0xf7fff had been specified for UniqueId. This has been changed so that an error now results.
Furthermore, 0xff3ff is specified at the end of sample code as UniqueId in Application.rsf, which serves as the default RSF.

Note 155-62: (TOOL) Fixed a bug related to option specifications when using `ctr_WaveConverter` [SDK]

A bug has been fixed with ctr_WaveConverter32.exe where it would execute even if an option not listed in the help was specified.

Note 155-63: (TOOL) Added support for LZ formatted backward compression when using `ctr_compress` [SDK].

The following options were added to ctr_compress: -lb for compressing in LZ back compressed format and -xlb for decompressing such compressed data.

Note 155-64: (TOOL) Revised `makebanner` [SDK]

Made the following modifications to makebanner.

Changed specifications so that a warning message is issued if the rating information PEGI_GEN is set, but PEGI_BBFC is not set
Changed specifications in the American and European regions so that the English title name is automatically used for languages whose title name is blank.
Changed specifications to that the width of titles is checked
An error message is displayed if a title exceeds a specified string width
Although the file that makebanner outputs to used to be calculated in terms of a relative path from the directory in which the bsf file was located, specifications have changed so that output is made in terms of a relative path from the current directory.

Note 155-65: (TOOL) Removed a warning when `UniqueId` is used in trial code [SDK]

A warning used to be issued when code for testing was specified in UniqueId when using ctr_makerom. This has been eliminated.

Note 155-66: (UBL) Revised the API Reference Manual [SDK]

A description of the CTR system ID was added to the API reference for GetUserId. Information about the maximum number of people that can be registered on the blocked-user list was added to the API reference for Entry.

Note 155-67: (UDS) Revised behavior so that SubId 0xFF is prohibited when using the `CreateNetwork` function [SDK]

Specifications were changed so that the error nn::uds::REsultOutOfRange is returned if SubId 0xFF is specified with the CreateNetwork function.
This is because SubId 0xFF is used when the Scan function queries all modes.

Note 155-68: (UDS) Made deletions from the API reference for the `SetPowerSaveMode` function [SDK]

The SetPowerSaveMode function was deleted from the API reference because although it was listed in the API reference, it could not be used.
There is no plan for continued support of the SetPowerSaveMode function.

Note 155-69: (ULCD) Made public the `GetCoefficientForParallax` function [SDK]

The GetCoefficientForParallax function was disclosed to the public.
This function can be used to speed up calculation of the parallax required when making stereoscopic display of an orthogonal projection.
For more information, see AboutULCDLibrary.pdf.

Note 155-70: (Y2R) Added mention that the `IsBusyConversion` function no longer returns `true` when Y2R conversion hangs up [SDK]

Although past documentation mentioned that events obtained by the GetTransferEven function were no longer signaled if conversion stopped due to problems with Y2R transfer, it did not include the fact that the IsBusyConverion function no longer returns true. This has been added.

Note 155-71: (Miscellaneous) Removed `ResultSuccess` from the API reference [SDK]

Specifications have been changed so that Result::IsSuccess is used instead of ResultSuccess given in the API reference.

Note 155-72: (Error EULA) Added a feature for specifying the display language [SDK | System Updater]

A function has been added for specifying the language to use for messages displayed in an applet.
Specify the type of *_LANGUAGE using errorType of the Config parameter. By specifying the language you want displayed using useLanguage, messages inside applets will be displayed in the specified language regardless of the language set under System Settings.

Known Issues with SDK 2.4.0 Release

In the GD LightingSample demo, you will see a phenomenon where the area the light is shining on will periodically flash.

■ CTR-SDK Version 2.4.0 System Updater 0.15.20

(2011/06/28)

Note 154-01: (AC) Fixed a bug where `nn::ac::Connect` would be unintentionally canceled [System Updater]

Fixed a bug where nn::ac::Connect would be unintentionally canceled in an environment where some APs cannot be used, such as when the system cannot access the Internet during connection processing.
This was actually fixed in CTR-SDK 2.3 but was accidentally omitted from the change log.

Note 154-02: (DevEnv) Updated the development menu (TestMenu) [System Updater]

The following changes were made to the developer menu (TestMenu).

Changed specifications so a message is displayed when an error occurs
Added support for hotswapping of SD cards.
Added upper screen display items.

Debug Mode enabled/disabled
EULA agreement version and EULA version required for CTR-SDK
Battery level (however, the only thing that has changed is during TestMenu re-rendering)
SD card information
User name

Note 154-03: (HOME Menu) Added a feature for deleting the icon database and icon cache [System Updater]

Limited to the HOME Menu of developers only, a debugging function for deleting the icon database and icon cache has been added when starting the HOME Menu while holding down X and Y.

The icon database is a database located in system NAND memory that saves the icon of the application started. The icon stored here is displayed in the Activity Log.
Note, however, that once an icon is stored, the icon in the database will not be updated unless the unique ID and version of the application change, even if the application is started with a subsequent change made to the icon.
The icon cache stored the icon data of applications saved on an SD card for increasing the speed of loading of icon data on the HOME Menu.

Because the icon cache is not overwritten even if a change is made to the icon just as with the icon database, specifications were changed so that the icon can be deleted to verify any changes.

Note 154-04: (HOME Menu) Fixed a bug where BOSS would sometimes run while an application was running [System Updater]

Fixed a bug where starting or closing a system applet (such as the Friend List) with the application suspended would start BOSS, even though the application had turned BOSS operations off.

Note 154-05: (HOME Menu) Added a feature so that unsupported banner models are not displayed [System Updater]

Specifications were changed so that banner models not output by NW4C_ForBanner in the NW4C environment especially for creating banners are not displayed on the HOME Menu for developers.
However, there is no bug where banner models are not being displayed; therefore, if this symptom occurs, review the banner model in question.

Note 154-06: (OS) Added support for loading cia files whose save data has not been initialized by debugger [System Updater]

Specifications have changed so that cia files can be loaded or imported without having the debugger initialize save data.
PARTNER-CTR Debugger 2011/05/11 release or later is required to use this feature.

Note 154-07: (TOOL) Fixed a bug where the menu would stop running after applying System Updater [System Updater]

If the system mode is set to anything other than Prod on development hardware to which System Updater 0.14.23 has been applied, a bug will occur if System Updater 0.15.8 or later is executed using "Keep current setting" where subsequent menus will not start. This bug has been fixed.

Note 154-08: (TOOL) Revised shared expanded save data created when starting TestMenu [System Updater]

A bug has been fixed where the specifications of shared expanded save data created when starting TestMenu differed from those of shared expanded save data created when starting the HOME Menu.
This bug fix has basically no effect on application development.

Note 154-09: (Error EULA) Added support for button input during the error display [System Updater]

During the display of error messages, specifications have changed so that all sequences can be advanced with only A and B Button input.
However, button input remains the same (will not work) as always during the EULA display.
This was actually changed in CTR-SDK 2.2 (System Updater 0.15.3) but was accidentally omitted from the changelog.

Note 154-10: (Error EULA) Added a feature for specifying the display language [SDK | System Updater]

Note 154-11: (Software Keyboard) Added a non-Japanese keyboard to supported keyboard types [System Updater]

A keyboard completely incapable of Japanese input (including Japanese kana letter input and predictive text) has been added to the keyboard types.

Known Issues with SDK 2.4.0 System Updater 0.15.20

See the Symptoms Treated as Specifications file in the CTR-SDK for details on known issues with System Updater.

■ CTR-SDK Version 2.4.0 Sample Demos

(2011/06/28)

Note 153-01: (CAMERA) Revised Stereo demo comments [Sample Demos]

Comments in the stereo camera demo were revised because they might lead to misunderstanding.

Note 153-02: (CX) Added the UncompressBlz sample demo [Sample Demos]

A sample demo was added to demonstrate the UncompressBLZ and SecureUncompressBLS functions.

Note 153-03: (DLP) Added a function to the server for getting client download progress [SDK | Sample Demos]

The nn::dlp::ServerGetClientState function was added to get client download progress.
With this change, specifications have changed so this function is used with the SimplerServer demo.

Note 153-04: (GX) Improved the speed at which ProcTexEditor images are written [Sample Demos]

This was changed because the source code for writing images has become old.
Some text during writing was also deleted.

Note 153-05: (GX) Added `gd` sample demos [Sample Demos]

The following demos have been added as gd library sample demos.

CombinationSample
FogAndLight
FogSample
LightingAniso
LightingSample2
MipMapSample
PartsysGas
PartsysSimple
ProctexClamp
ProctexFFunction
ProctexRandom
ProjectionTexture
ShadowKnotCube
ShadowSimple
SilhouetteSimple
SubdivisionLoopSimple
SubdivisionSimple
TextureCombinerSample

Note 153-06: (GX) Deleted the uniform `shadowZScale` [Sample Demos]

The reserved uniform shadowZScale has been deleted from source code because it was found to be invalid due to hardware specifications.
There is no problem with setting it as usual.

Note 153-07: (SND) Added the WaveBufferOperator sample demo [Sample Demos]

The sample demo titled WaveBufferOperator has been added. This demo shows how to use the Voice::DeleteWaveBuffer and Voice::UpdateWaveBuffer functions.

Known Issues with SDK 2.4.0 Sample Demos

None.

■ CTR-SDK Version 2.3.4 System Updater 0.15.19

(2011/06/09)

Note 152-01: (MCU) Fixed a bug that prevented the recharge LED from turning off [System Updater]

Fixed a bug that prevented a system's recharge LED from turning off until the system was turned on, even after it was fully charged, if you had started to charge the system while it was turned off with less than 60% battery life remaining.

Known Issues with SDK 2.3.4 System Updater 0.15.19

In some extremely rare cases the screen will stay black after the system is closed and opened. Audio output, button input, and other features still function normally when this happens; the only feature that has not recovered is rendering. Close and open the system once more to resolve the symptoms. This same issue, however, can also be caused by applications, depending on how they are implemented. If this happens with your application, make sure that your application's implementation does not have any possible sequence or timing in which rendering might not recover after awakening from sleep.

■ CTR-SDK Version 2.3.4 System Updater 0.15.18

(2011/06/08)

Note 151-01: (FS) Reverted ROM access speeds for card-based software [System Updater]

Reverted the adjustments made by Note 149-04 to ROM access speeds for card-based software.

Known Issues with SDK 2.3.4 System Updater 0.15.18

In some extremely rare cases the screen will stay black after the system is closed and opened. Audio output, button input, and other features still function normally when this happens; the only feature that does not recover is rendering. Close and open the system once more to resolve the symptoms. This same issue, however, can also be caused by applications, depending on how they are implemented. If this happens with your application, make sure that your application's implementation does not have any possible sequence or timing in which rendering might not recover after awakening from sleep.

■ CTR-SDK Version 2.3.4 System Updater 0.15.17

(2011/06/01)

Note 150-01: (HTTP) Disabled SetSocketBufferSize [System Updater]

Disabled the http::Connection::SetSocketBufferSize function, which had few uses.
Now the buffer size remains unchanged even after this function is called, and it always returns nn::ResultSuccess.

Known Issues with SDK 2.3.4 System Updater 0.15.17

In some extremely rare cases the screen will stay black after the system is closed and opened. Audio output, button input, and other features still function normally when this happens; the only feature that does not recover is rendering. Close and open the system once more to resolve the symptoms. This same issue, however, can also be caused by applications, depending on how they are implemented. If this happens with your application, make sure that your application's implementation does not have any possible sequence or timing in which rendering might not recover after awakening from sleep.

■ CTR-SDK Version 2.3.4 System Updater 0.15.16

(2011/05/27)

Note 149-01: (AC) Fixed a bug where connection would not complete with certain APs when sending the wrong WEP key [System Updater]

Fixed a bug where attempting to connect to certain access points using WEP encryption and sending the wrong key would cause an internal infinite loop, with the connection never being completed.
Even if this bug occurred, you could break out of the loop by moving outside of the AP's range or pushing the wireless switch off to disable wireless communication.

Note 149-02: (FS) Improved ROM access response when ROM access and access to save data or other data occur at the same time [System Updater]

Improved ROM access response when accessing save data, expanded save data, or other data during ROM access.

Note 149-03: (FS) Sped up formatting of save data for card-based applications [System Updater]

Shortened the time required when calling the nn::fs::MountSaveData function from a card-based application.

Note 149-04: (FS) Improved ROM access speed for card-based software [System Updater]

Adjusted the ROM access speeds of card-based applications to mostly eliminate the differences when accessing production cards versus development cards and emulation memory.

Note 149-05: (HTTP) Fixed a bug where keep-alive would not work properly via a proxy [System Updater]

Fixed a bug where using a keep-alive via a proxy would result in attempting to access a server at a different URL.
(This fix is provisional, and simply disables the use of keep-alives via a proxy.
A different fix will be released at a later date to allow the proper use of keep-alives via a proxy.)

Note 149-06: (OS) Fixed a bug where resources would not be released on application shutdown [System Updater]

Fixed a very rare bug where system resources would not be properly released after an application shutdown.

Note 149-07: (SSL) Fixed a bug where communication would fail when communicating using many certificates in parallel [System Updater]

Fixed a bug where using many certificates in parallel for communication (which can easily happen when using keep-alives with HTTPS) would cause the SSL heap to run out and communication to fail.

Known Issues with SDK 2.3.4 System Updater 0.15.16

In some extremely rare cases the screen will stay black after the system is closed and opened. Audio output, button input, and other features still function normally when this happens; the only feature that does not recover is rendering. Close and open the system once more to resolve the symptoms. This same issue, however, can also be caused by applications, depending on how they are implemented. If this happens with your application, make sure that your application's implementation does not have any possible sequence or timing in which rendering might not recover after awakening from sleep.

■ CTR-SDK Version 2.3.4 System Updater 0.15.9

(2011/05/24)

Note 148-01: (BOSS) Fixed a bug that prevented BOSS functions from returning [System Updater]

Fixed a bug that prevented BOSS functions called by the application from returning after the application had repeatedly called boss::Initialize and boss::Finalize.

Note 148-02: (SOCKET) Fixed a DNS bug [System Updater]

Fixed a bug that prevented GetHostByName and GetAddrInfo from properly processing hostnames that started with a number.

Known Issues with SDK 2.3.4 System Updater 0.15.9

In some extremely rare cases the screen will stay black after the system is closed and opened. Audio output, button input, and other features still function normally when this happens; the only feature that does not recover is rendering. Close and open the system once more to resolve the symptoms. This same issue, however, can also be caused by applications, depending on how they are implemented. If this happens with your application, make sure that your application's implementation does not have any possible sequence or timing in which rendering might not recover after awakening from sleep.

■ CTR-SDK Version 2.3.4 Release

(2011/05/18)

Note 147-01: (APPLET) Relaxed conditions on calling `PrepareToCloseApplication` [SDK]

Revised PrepareToCloseApplication so that it will run properly even if Sleep Mode is not prohibited when it is called.

Note 147-02: (SND) Fixed a bug where stereo sound was played when Mono was selected in System Settings [SDK]

Fixed a bug in the CTR-SDK that, since version 2.1, caused stereo sound to be output even when Mono was selected for Sound in System Settings.

Known Issues with the SDK 2.3.4 Release

In the GD LightingSample demo, you will see a phenomenon where the area the light is shining on will periodically flash.
FontConverter is sometimes not able to convert Windows fonts correctly if the following settings have been made.

Vector fonts (marked with "(V)" in the font list) are used
A large font size is set (it is possible that what size is problematic is dependent on the font)
Two levels of gradation are set for the number of gradations under the advanced settings (this applies to both the A4 and LA4 settings)

■ CTR-SDK Version 2.3.4 System Updater 0.15.8

(2011/05/18)

Note 146-01: (AC) Fixed a bug that returned unknown error codes [System Updater]

Fixed a bug in CTR-SDK 2.x that caused unknown error codes to be returned when a system was forcibly disconnected from an access point during a connection test.

Note 146-02: (AC) Reduced the time required to process a failed connection [System Updater]

Fixed a bug that caused unnecessary active scans when connecting to a USB access point.
This fix causes connections to fail more quickly wherever there are a lot of stealth SSIDs.

Note 146-03: (APPLET) Fixed a bug that prevented the `Awake` callback from being invoked when the system entered Sleep Mode immediately after a library applet was started [System Updater]

Fixed a bug that prevented the Awake callback from being invoked upon recovery from Sleep Mode if the system entered Sleep Mode immediately after a library applet was started.

Note 146-04: (FRIENDS) Fixed a bug that prevented the system from returning from Sleep Mode if it had not yet obtained any friend codes and set a Personal Mii [System Updater]

Fixed a bug in CTR-SDK versions 2.2 and later, where setting a Personal Mii in Mii Maker without having obtained a friend code would cause the system to often fail wake from Sleep Mode when opened, if the system entered Sleep Mode near an access point it could connect to.

Note 146-05: (TOOL) Made `SystemMode dev1` usable, with some restrictions, on development hardware [System Updater]

Made SystemMode dev1 usable, with some restrictions, on test units.
These restrictions are as follows.

This mode cannot be switched to from the Config tool. You must select it when you apply the System Updater.
If you select SystemMode dev1 using the System Updater, the HOME Menu is not imported and will therefore not start even if you change Menu to home menu with the Config tool. To start the HOME Menu, you must re-apply the System Updater.

Note 146-06: (UDS) Firmware compatibility with CTR-SDK 2.3.2 and subsequent versions [System Updater]

CTR-SDK 2.3.2 includes changes that affect UDS compatibility.
Note: Starting with the firmware for CTR-SDK 2.3.2 (System Updater 0.15.7), applications built with CTR-SDK 2.0 – 2.3.1 will no longer be able to run UDS communication properly when running on systems that use this firmware.

Note 146-07: (UDS) Fixed a bug that caused the `SendTo` function to return non-UDS errors [System Updater]

Fixed a bug in the SendTo function that caused it to return non-UDS errors that were not documented in the API Reference Manual, depending on when the system was disconnected from the network.

Note 146-08: (UDS) Fixed a bug that resulted in invalid node information if you destroyed or disconnected from a network [System Updater]

Fixed a bug that caused the GetConnectionStatus and GetNodeInformation functions to return invalid node information right before or after the DestroyNetwork or DisconnectNetwork functions were called.

Known Issues with SDK 2.3.4 System Updater 0.15.8

In some extremely rare cases the screen will stay black after the system is closed and opened. Audio output, button input, and other features still function normally when this happens; the only feature that does not recover is rendering. Close and open the system once more to resolve the symptoms. This same issue, however, can also be caused by applications, depending on how they are implemented. If this happens with your application, make sure that your application's implementation does not have any possible sequence or timing in which rendering might not recover after awakening from sleep.

■ CTR-SDK Version 2.3.3 Release

(2011/05/11)

Note 145-01: (CRYPTO) Fixed a bug that occurred when a large amount of data was assigned as an HMAC key [SDK]

Fixed a bug where a bad HMAC value would be calculated when more than 64 bytes of data were assigned to the CalculateHmacSha1 or CalculateHmacSha256 function as an HMAC key.
This bug was introduced in CTR-SDK 2.1, and was not present in earlier versions.

Note 145-02: (GX) Fixed a bug in the `gd::ForceDirty` function [SDK]

Fixed a bug where calling the gd::ForceDirty function would not reissue a command for the primitive to be rendered (for example, TRIANGLE).

Note 145-03: (GX) Fixed a bug where the uniform setting was not correctly reflected in `gd::ShaderStage` [SDK]

Fixed a bug where the shader uniform was not correctly configured when all of the following conditions were met:

The SetShaderPipelineConstantF function is used
The same ShaderPipeline is used consecutively to render two objects
The two objects have both a uniform with the same value and uniforms with different values

Note 145-04: (MIC) Fixed a bug in the `GetForbiddenArea` function [SDK]

Fixed a bug where the GetForbiddenArea function did not return the correct result when gain was 68 or greater.

Note 145-05: (SND) Fixed a bug where specifying a high pitch would hang the system [SDK]

Fixed a bug where the DSP core would enter an infinite loop if an extremely high pitch (for example, 100 or more) was specified in Voice::SetPitch.
However, this fix does not guarantee that the high pitch will be reproduced as intended, because increasing the pitch also increases the processing load on the DSP (nearly linearly).

Note 145-06: (TOOL) Replaced `1MbitVerificationFailed.bin` [SDK]

Replaced the binary for returning fs::ResultVerificationFailed when mounting a backup device, because the old one did not return the expected result. The new binary correctly returns fs::ResultVerificationFailed.
This was actually fixed in CTR-SDK 2.0 but was accidentally omitted from the change log.

Known Issues with SDK 2.3.3 Release

In the GD LightingSample demo, you will see a phenomenon where the area the light is shining on will periodically flash.

■ CTR-SDK Version 2.3.3 System Updater 0.15.7

(2011/05/11)

Note 144-01: (BOSS) Fixed a bug where timeouts of the update task had no effect [System Updater]

Fixed a bug where timeouts of HTTP communication by update tasks had no effect.

Note 144-02: (BOSS) Fixed a bug where it took a long time for BOSS tasks to start executing on a stealth AP [System Updater]

Fixed a bug where it took a long time for a BOSS task to start while sleeping (the task was not executed when it should have been) in an environment using a stealth AP.

Note 144-03: (BOSS) Fixed a bug where BOSS termination was delayed in an environment where friend login was unavailable [System Updater]

Fixed a bug where BOSS termination took a long time in an environment where friend login was unavailable, because the cancellation of friend login by BOSS had no effect.

Note 144-04: (BOSS) Fixed a bug where `G_ALTASK` `STOPPED` could not be specified in a policy list [System Updater]

Fixed a bug where G_ALTASK STOPPED could not be specified in a policy list (it would be deemed to be an invalid policy list).

Note 144-05: (BOSS) Fixed a bug that prevented cancellation of a policy list acquisition [System Updater]

Fixed a bug where if a BOSS process was canceled (for example, due to a Suspend operation after the system was closed), the cancellation had no effect if BOSS was in the middle of getting a policy list.

Note 144-06: (DLP) Fixed a bug where the client could not find the server [System Updater]

Fixed a bug in CTR-SDK 2.3.2 where the client could not find the server even after scanning.

Note 144-07: (FS) Changed format of save data [System Updater]

Changed the format of save data for CTR card applications created with the CTR-SDK 2.X series.
This format is not compatible with save data created using previous versions, so a reformat is necessary.
There are no changes to usage or performance.
This change will have no effect on the save data for CTR card applications or download applications created with the CTR-SDK 1.X series.

Note 144-08: (HOME Menu) Fixed a bug in the display of application icon banners [System Updater]

Fixed the following bugs in the display of application icon banners:

Application order would change suddenly
When an application was added in DevMenu, it would appear on the edge even if there was empty space
Wrapped applications would open without any user action
The banner in the upper screen was scrambled

Note 144-09: (HOME Menu) Changed save locations of application layout information and icon images [System Updater]

Changed the save location of the application layout information and icon images (icon cache) from the ROOT directory of the SD card to the expanded save data.
Consequently, the notes for checking icon images on the HOME Menu have also changed.
See the Readme of the applet package for details.

Note 144-10: (UDS) Fixed a bug where repeated connections and disconnections by a client caused inconsistency between number of nodes and node ID list [System Updater]

Fixed a bug where repeated connections and disconnections by a client over a short period of time caused a mismatch between the value of the nowEntry member and the number of valid nodes in the nodeIdList member of the ConnectionStatus structure obtained from nn::uds::GetConnectionStatus.

Note 144-11: (UDS) Fixed a bug where an invalid value was returned when the friend's local friend code was decoded [System Updater]

Fixed a bug where an invalid value was returned if an encoded local friend code obtained via UDS communication was decoded, even if the peer was a friend.

Note 144-12: (Notifications) Fixed a bug where Notifications sometimes stopped working when a DS card was inserted [System Updater]

Fixed a bug where opening the Notifications details screen with a DS card inserted sometimes caused Notifications to stop working.

Note 144-13: (Notifications) Fixed a bug with starting and stopping software from Notifications [System Updater]

Fixed a bug where pressing Start Application on the Notifications - Details screen would cause unstable HOME Menu behavior after closing the application.

Note 144-14: (Notifications) Fixed a bug with EULA check when starting software from Notifications [System Updater]

Fixed a bug where selecting Start Software from the Notifications - Details screen would start the application and ignore any EULA even if the application required acceptance of a EULA upon startup.

Note 144-15: (Notifications) Fixed a bug preventing software from being started from a local notification [System Updater]

Fixed a bug where the Start Software button was not displayed on the details screen of a local notification.

Note 144-16: (Software keyboard) Fixed a bug with the cell phone-style keyboard for North American and European regions [System Updater]

Fixed a bug on the cell phone keyboard layout for the Americas and Europe regions where the character code for the "@" symbol was FF20 when it should have been 0400.

Note 144-17: (Friend List) Fixed a bug with friend lists [System Updater]

Fixed a bug where the screen would flicker, scrolling would be jerky, or the friend list would terminate under some conditions.

Note 144-18: (System Settings) Fixed a bug where Other Settings: Region Name would be blank [System Updater]

Fixed a bug in the US/EU versions of the System Settings where the region name in the user information was saved as empty when the following procedure was carried out.

Parental Controls configured in System Settings
A country that has no individual area settings is selected in System Settings under Profile > Region Settings
(For example, Anguilla for the US region, or Iceland for the EU region)

When this was done, the region name in the language that was set in the system settings was cleared.
Normally, the country name is used for the region name that is set here.
In other words, when nn::cfg::CTR::GetSimpleAddress(pSimpleAddress) was called to obtain region information, pSimpleAddress->regionName[nn::cfg::CTR::GetLanguage()] was an empty string.

Note 144-19: (System Settings) Added CTR software management and DSiWare management screens to the Data Management Screen [System Updater]

In the Data Management screen, the CTR software management screen now supports the deleting of downloadable applications, and the DSiWare management screen now supports the deleting and copying of DSiWare.

Known Issues with SDK 2.3.3 System Updater 0.15.7

In some extremely rare cases the screen will stay black after the system is closed and opened. Audio output, button input, and other features still function normally when this happens; the only feature that does not recover is rendering. Close and open the system once more to resolve the symptoms. This same issue, however, can also be caused by applications, depending on how they are implemented. If this happens with your application, make sure that your application's implementation does not have any possible sequence or timing in which rendering might not recover after awakening from sleep.

■ CTR-SDK Version 2.3.3 Sample Demos

(2011/05/11)

Note 143-01: (UDS) Fixed a bug where scanning an unnamed master with `com_demo1` gave it another master name [Sample Demos]

Fixed a bug where scanning an unnamed master with com_demo1 gave it the display name of another master that was scanned at the same time.

Known Issues with SDK 2.3.3 Sample Demos

None.

■ CTR-SDK Version 2.3.2 Release

(2011/04/27)

Note 142-01: (APPLET) Fixed a bug with HOME Button transition from library applet [SDK | System Updater]

Sleep was permitted momentarily while returning from a library applet by a press of the HOME Button.
In this state, calling nn::applet::CTR::ProcessHomeButton and closing the system at the same would cause processing to hang on an ASSERT check. That problem was fixed by extending the HOME Menu transition lock.

Note 142-02: (GX) Updated DMPGL 2.0 System API Specifications [SDK]

Made the following changes to DMPGL20_system_API_specification.pdf:

Added a section about the load array settings and performance.
Added a description about load array padding elements.
5.9.18 talked about conversion from float32 to signed int8 for [0,1]. However, the range of conversion values is [-1,1], not [0,1], so that was corrected.
Added nngxMoveCommandbufferPointer, which had been inadvertently omitted.
Revised the bit-width for SIZE in the command buffer header.
Added a description of the command buffer execution registers.

Note 142-03: (HIO) Fixed a bug with `HostFile::Read` [SDK]

Fixed a bug where passing a byte size larger than 0x200200 to HostFile::Read would corrupt memory.

Note 142-04: (HIO) Revised the API Reference Manual [SDK]

Revised the reference to mention that nn::hio::GetEnvironmentVariable will return ResultSuccess even when there is no environment variable.

Note 142-05: (TOOL) Changed the version notation of the `Config` tool [SDK]

The version notation for Config now shows the micro version.

Note 142-06: (TOOL) Revised `SaveDataFiler` [SDK]

Fixed a bug where exporting a corrupt file would write a file of a different size than the actual size.

Note 142-07: (TOOL) Fixed `makecia` failure to create CIA [SDK]

Fixed a bug where makecia would fail to create the a CIA file when the input file size was a multiple of 4MB.

Known Issues with SDK 2.3.2 Release

In the GD LightingSample demo, you will see a phenomenon where the area the light is shining on will periodically flash.

■ CTR-SDK Version 2.3.2 System Updater 0.15.6

(2011/04/27)

Note 141-01: (AC) Accelerated finalization when resources not released [System Updater]

When an application ended without releasing resources provided to the AC, such as Event, the finalization process took a long time. That process has now been accelerated.

Note 141-02: (APPLET) Fixed a bug where calling `CancelLibraryApplet` when sleep is allowed would cause a deadlock [System Updater]

Fixed a bug where calling CancelLibraryApplet with sleep allowed would cause a deadlock.

Note 141-03: (APPLET) Fixed a bug with HOME Button transition from library applet [SDK | System Updater]

Note 141-04: (BOSS) Fixed a bug affecting retry of tasks executing immediately in background [System Updater]

Fixed a bug when executing a task immediately in the background where retrying due to a disconnection or other reason would prevent that task from resuming execution from where it left off.

Note 141-05: (BOSS) Fixed a bug where normal tasks would sometimes execute right after start, ahead of their execution time [System Updater]

Fixed a bug where registered and started tasks would sometimes execute immediately after Start (that is, before their execution time).

Note 141-06: (BOSS) Fixed a bug where play history upload tasks would have invalid `X-BOSS-Digest` value [System Updater]

Fixed a bug in play history upload tasks where an invalid X-BOSS-Digest value (an empty string) was given to the HTTP request.

Note 141-07: (FRIENDS) Fixed a bug where state would be online even though asynchronous login process failed because system went to sleep [System Updater]

Fixed a bug where the system going to sleep during an asynchronous login would return a failure but the login request would remain, with the result that the system would be online after it woke from sleep.

Note 141-08: (FRIENDS) Workaround for possibility of blocking of as long as roughly 1 second when API is called while login process is executing [System Updater]

Fixed a bug where a call to a friends library function can block for as long as 1 second when the login process is running in the background.

Note 141-09: (FS) Fixed a bug in verification error range when loading files [System Updater]

Fixed a bug where loading a memory region where a nn::fs::ResultVerificationFailed error had occurred would cause that error to be returned as the result for other memory regions where that error had not occurred.

Note 141-10: (UDS) Fixed a bug where `CONNECTION_LOST` was always given as reason for client disconnection when `DestroyNetwork` called [System Updater]

Normally, when the master performs DestroyNetwork a disconnect-request packet is sent to all clients and they are immediately disconnected from the network.
At this time, GetConnectionStatus gets DISCARDED_FROM_NETWORK as the reason for disconnection (DisconnectReason).
However, sometimes the disconnect-request packet is not received, and when this is the case the client is disconnected around 1 second after DestroyNetwork is performed.
In this case, the reason for disconnection is CONNECTION_LOST.

However, because of a bug, the reason for disconnection was always returned as CONNECTION_LOST because the master actually was not sending a disconnect-request packet.
This bug was fixed in the following ways, depending on which version of the CTR-SDK to which the application is linked:

CTR-SDK 1.x versions
As was the case previously, the master does not send a disconnect-request packet.
CTR-SDK 2.3.2 and later versions
The master sends a disconnect-request packet.

The firmware for CTR-SDK 2.2 and CTR-SDK 2.3 is such that the master sends a disconnect-request packet regardless of the CTR-SDK version to which the application is linked, so there is a possibility of connection compatibility problems.

Known Issues with SDK 2.3.2 System Updater 0.15.6

In some extremely rare cases the screen will stay black after the system is closed and opened. Audio output, button input, and other features still function normally when this happens; the only feature that does not recover is rendering. Close and open the system once more to resolve the symptoms. This same issue, however, can also be caused by applications, depending on how they are implemented. If this happens with your application, make sure that your application's implementation does not have any possible sequence or timing in which rendering might not recover after awakening from sleep.
If you reset the settings using the Config tool, start an application without going through the startup sequence on the HOME Menu, and then open and close the system, the system will stop and the top and bottom screens will turn black.

■ CTR-SDK Version 2.3.1 Release

(2011/04/21)

Note 140-01: (TOOL) Revised display of `DevMenu` firmware version [SDK]

The firmware version displayed in DevMenu showed the wrong micro version. That was corrected.

Note 140-02: (TOOL) Modified `SaveDataFiler` [SDK]

Made the following changes to the SaveDataFiler tool.

The menu now updates when an SD card is inserted or removed.
When file destruction fails, a dialog now displays.
You can now transition to the filer by touching on a data item again.
Revised the guide in the upper screen.

Known Issues with SDK 2.3.1 Release

In the GD LightingSample demo, you will see a phenomenon where the area the light is shining on will periodically flash.

■ CTR-SDK Version 2.3.1 System Updater 0.15.5

(2011/04/21)

Note 139-01: (BOSS) Fixed a bug where BOSS timer value would be invalid right after CTR started [System Updater]

Fixed a bug where tasks would take a while to start running due to an invalid BOSS timer value immediately after starting the CTR.

Note 139-02: (BOSS) Fixed a bug where service termination notification could not be obtained [System Updater]

Fixed a bug where a service termination notification could sometimes not be obtained.

Note 139-03: (FS) Corrected Result returned when save data mounted twice [System Updater]

When save data was mounted a second time, the MountSaveData function returned a value indicating success. The has been fixed so the correct Result is returned.
This was actually changed in CTR-SDK 2.1 but was accidentally omitted from the change log.

Note 139-04: (OS) Fixed shutdown process when `FATAL ERROR` occurs [System Updater]

Fixed a bug where pressing the POWER Button quickly after a FATAL ERROR would forcibly turn the power off without performing the normal shutdown process.

Note 139-05: (UDS) Fixed a bug where turning off wireless during a call to `Finalize` would cause a deadlock [System Updater]

Fixed a bug where turning off the wireless button during a call to nn::uds::Finalize would prevent the function from returning in some cases depending on the timing.

Known Issues with SDK 2.3.1 System Updater 0.15.5

In some extremely rare cases the screen will stay black after the system is closed and opened. Audio output, button input, and other features still function normally when this happens; the only feature that has not recovered is rendering. Close and open the system once more to resolve the symptoms. This same issue, however, can also be caused by applications, depending on how they are implemented. If this happens with your application, make sure that your application's implementation does not have any possible sequence or timing in which rendering might not recover after awakening from sleep.
If you reset the settings using the Config tool, start an application without going through the startup sequence on the HOME Menu, and then open and close the system, the system will stop and the top and bottom screens will turn black.

■ CTR-SDK Version 2.3.0 Release

(2011/04/15)

Note 138-01: (APPLET) Fixed inability to get entire parameter with `applet::ReceiveDeliverArg` function [SDK]

Fixed a bug where calling applet::ReceiveDeliverArg at such times as application jumping would return parameter data of only 386 bytes, shorter than the actual data size of 768 bytes.

Note 138-02: (APPLET) Added `nn::applet::CTR::ReceiveDeliverArg`, which allows the buffer region size to be specified [SDK | System Updater]

With the nn::applet::CTR::ReceiveDeliverArg function, the buffer region for receiving DeliverArg data was set to a fixed size by NN_APPLET_PARAMETER_BUF_SIZE and NN_APPLET_HMAC_BUF_SIZE. A function with the same name has been added that enables you to specify only the needed size.

Note 138-03: (DevEnv) Moved Download Application Development Manual to programming manuals [SDK]

Moved the Download Application Development Manual ($CTR_SDK/documents/TechnicalNotes/DownloadAppManual), deleting it from the CTR-SDK and moving it to a Programming Manual.

Note 138-04: (GR) Fixed a bug with light source disable commands using `FragmentLight::MakeDisableCommand` [SDK]

When FragmentLight::MakeDisableCommand was used to generate commands to disable light sources, the value of register 0x1c6 became "0" in error. This has been corrected to 1.

Note 138-05: (GR) Added to the text about exclusive fragment operation modes in the RenderState API reference [SDK]

Supplemented the explanation in the RenderState API reference about the mode settings for exclusive fragment operations (MODE_GL/GAS_ACC_DMP/SHADOW_DMP) and logical operations/blending.

Note 138-06: (GR) Fixed a bug in `RenderState::ShadowMap::MakeCommand` [SDK]

Fixed a bug where RenderState::ShadowMap::MakeCommand would not properly generate commands for register 0x100.

Note 138-07: (GR) Changed the default value for `RenderState::StencilTest::maskOp` to "0xff" [SDK]

The default value for RenderState::StencilTest::maskO was 0. It was changed to "0xff" to match the OpenGL specification.

Note 138-08: (GR) When rendering to shadow texture is enabled, commands related to the framebuffer are now issued by `RenderState::FBAccess::MakeCommand` [SDK]

When rendering to shadow textures, commands related to the framebuffer are now created using RenderState::FBAccess::MakeCommand.

Note 138-09: (GR) Added a function for generating commands for only the texture combiner's constant color [SDK]

Added the function Combiner::Stage::MakeConstantColorCommand, which generates commands only for the constant color of the texture combiner.

Note 138-10: (GR) Fixed a bug where padding vertex attribute load array elements would cause the GPU to hang [SDK]

Fixed a bug where generating commands by calling Vertex::MakeEnableAttrCommand would cause the GPU to hang if padding was used for vertex attribute load array elements.

Note 138-11: (HID) Added the `GetAxisRotationMatrix` function [SDK]

Added the function GetAxisRotationMatrix, which requires less overhead than the existing function, to the AccelerometerReader class and the GyroscopeReader class.

Note 138-12: (HIO) Fixed a bug with `HostFile::Read` [SDK]

Fixed a bug when using PARTNER-CTR 2011/03/25 and later versions for debugging that caused the following problems when calling nn::hio::HostFile::Read.

After a read there was a shift in the seek position.
The value returned was larger than the amount read.

Note 138-13: (TOOL) Fixed a bug where inserting/removing SD card would cause DevMenu to freeze [SDK]

Fixed a bug where the DevMenu would freeze if the SD card was vigorously inserted and removed.

Note 138-14: (TOOL) Added FontConverter files [SDK]

Added the following FontConverter files: 3ds_bitmap_font_std.xlor and 3ds_bitmap_font_std.xllt

Note 138-15: (TOOL) Fixed a bug with `makebanner` [SDK]

The change made in Note 131-48 was insufficient, and error messages were not handled correctly when the join-in game ID and join-in game mode bit were set.
This problem was corrected.

Note 138-16: (UDS) Made change relating to unique ID used by `CreateLocalCommunicationId` function [SDK | Sample Demos]

Up until now, when the nn::uds::CreateLocalCommunicationId function generated a local communication ID for development purposes, the unique ID 0xFFFFF was used. From now on, use the unique IDs for game software prototypes (0xFF000 to 0xFF3FF) instead.
When the local communication ID is generated using a game software prototype unique ID (as opposed to using the unique ID 0xFFFFF), the setting for Debug Mode in the Config tool Other Setting will not affect the behavior of the API.

Note 138-17: (UDS) Revised descriptions related to block time [SDK]

In the UDS API reference, clarified that a reference value is specified for a function that blocks for longer than 100ms.

Known Issues with SDK 2.3.0 Release

In the GD LightingSample demo, you will see a phenomenon where the area the light is shining on will periodically flash.

■ CTR-SDK Version 2.3.0 System Updater 0.15.4

(2011/04/15)

Note 137-01: (APPLET) Added `nn::applet::CTR::ReceiveDeliverArg`, which allows the buffer region size to be specified [SDK | System Updater]

Note 137-02: (CAMERA) Fixed a bug where system would hang when opening/closing [System Updater]

Fixed a rare bug where the system would hang when opened or closed while the camera was in use.

Note 137-03: (CEC) Fixed a bug where daemon would stop [System Updater]

Fixed a rare bug where the StreetPass daemon would stop if the system connected to a communication partner and then immediately disconnected.

Note 137-04: (CEC) Fixed a bug where connecting to CTR systems running earlier versions would fail [System Updater]

Fixed a bug where connecting from a CTR with System Updater 0.15.2 connected to a system that had System Updater version 0.15.1 or earlier would fail half of the time.

Note 137-05: (CEC) Fixed inability to communicate again with same peer after resetting time [System Updater]

Fixed a bug where a reset of the system's internal clock, possibly because the battery was removed, would sometimes cause a miscalculation of the length of time not to communicate again with same peer, and the inability to communicate would persist.

Note 137-06: (FS) Added support for backup devices made by second-party vendors [System Updater]

Fixed a bug where backup devices made by second-party vendors did not operate correctly.

Note 137-07: (HTTP) Fixed a bug relating to CONNECT requests [System Updater]

Fixed a bug where an error occurring immediately after receiving Connection Established would cause the CONNECT request for the next connection to be invalid.

Note 137-08: (OS) Fixed inability to recover from sleep when country code not set [System Updater]

Fixed a bug where the system would not wake up in cases when the country code had not been set, possibly because the HOME Menu had never been started.

Note 137-09: (PL) Revised so that in compatibility mode, the pedometer now stores a full seven days of steps [System Updater]

In compatibility mode, the pedometer under certain conditions would store 6 minutes less than a full 7 days of steps. That has been fixed so the pedometer now stores data for the full 7 days (7 x 24 hours).

Note 137-10: (UDS) Fixed a bug where system would hang during call to `Initialize` when country code not set [System Updater]

Fixed a bug where a call to Initialize would cause the system to hang in cases when the country code had not been set, possibly because the HOME Menu had never been started.

Known Issues with SDK 2.3.0 System Updater 0.15.4

In some extremely rare cases the screen will stay black after the system is closed and opened. Audio output, button input, and other features still function normally when this happens; the only feature that has not recovered is rendering. Close and open the system once more to resolve the symptoms. This same issue, however, can also be caused by applications, depending on how they are implemented. If this happens with your application, make sure that your application's implementation does not have any possible sequence or timing in which rendering might not recover after awakening from sleep.
If you reset the settings using the Config tool, start an application without going through the startup sequence on the HOME Menu, and then open and close the system, the system will stop and the top and bottom screens will turn black.
If the POWER Button is quickly pressed after a FATAL ERROR has been generated, the shutdown process just forces the power off.

■ CTR-SDK Version 2.3.0 Sample Demos

(2011/04/15)

Note 136-01: (UDS) Made change relating to unique ID used by `CreateLocalCommunicationId` function [SDK | Sample Demos]

Known Issues with SDK 2.3.0 Sample Demos

None.

■ CTR-SDK Version 2.2.0 System Updater 0.15.3

(2011/04/12)

Note 135-01: (HOME Menu) Support for DSiWare [System Updater]

The following features related to DSiWare have been added to the HOME Menu:

Listing the DSiWare in NAND.
Starting Nintendo DSiWare

Note 135-02: (HOME Menu) Fixed a bug where application did not receive termination notification when POWER Button was held down immediately after HOME Button pressed [System Updater]

When the POWER Button was pressed and held down immediately after the HOME Button was pressed, the application was not given a termination notification.

Note 135-03: (HOME Menu) Fixed a bug of not transitioning to sleep when system closed while returning to application from HOME Menu [System Updater]

Fixed a bug where closing the system while returning to the application from the HOME Menu would prevent the system from transitioning to sleep even when returning REPLY_ACCEPT.

Note 135-04: (HOME Menu) Support for download applications [System Updater]

The following features related to downloadable applications have been added to the HOME Menu:

List the applications in the SD card.
Start downloadable applications.
Hot swapping of SD cards.

Note 135-05: (HOME Menu) Fixed a bug where microphone input would not work after using HOME Menu to quit application using microphone [System Updater]

Fixed a bug where suspending an application that uses microphone input and then quitting that application from the HOME Menu would disable microphone input until another application was started.
When this problem happened, the banner on the HOME Menu would stop rotating in response to microphone input.

Note 135-06: (HOME Menu) Added calibration for accelerometer [System Updater]

Added a feature for correcting the offset value of the accelerometer by keeping the Y and B Buttons depressed for 3 seconds while the HOME Menu is displaying.
The corrected offset value is immediately applied to the suspended application.

Note 135-07: (HOME Menu) Changed the POWER Menu screen [System Updater]

Changed the POWER Menu screen display when the POWER Button is pressed.
The text and layout were changed, and the SLEEP Button was eliminated.
Applications do not need to do anything in response to these changes.

Note 135-08: (Mii Maker) Added a feature to move special Mii from the front-end database to the back-end database [System Updater]

Added a feature for moving special Mii characters from the front-end database where they were registered to the back-end database.

Note 135-09: (Notifications) Added start application function to Notifications [System Updater]

By pressing the Start Application button on the Notifications details screen, you can now start applications that have been delivered in notifications.
Information about the arguments passed to the application side will be included in the next planned release of the applet specifications.

Note 135-10: (Game Notes) Added a border to the touch-disabled range [System Updater]

Added a border to the touch-disabled range of the Game Notes screen.

Note 135-11: (Software keyboard) Fixed a bug in North American/European versions where system would stop if the user pressed the HOME Button or POWER Button after pressing the button for switching dictionaries [System Updater]

Fixed a bug where the North American/European versions of the software keyboard would stop working if the user pressed the button to switch dictionaries, and then pressed the HOME Button (or the POWER Button) at the moment the dialog displayed.

Note 135-12: (Software keyboard) Fixed a bug with sleep recovery that occurred in response to timing of character input [System Updater]

Fixed a bug where the system would not wake up if the system went to sleep after characters were input but before predictive text input candidates were displayed.

Note 135-13: (System Settings) Support for downloadable applications on CTR software management screen, and support for DSiWare on DSiWare management screen [System Updater]

Note 135-14: (System Settings) Fixed problem of blanks in Other Settings: Region name [System Updater]

In the US/EU versions of the System Settings, the region name in the user information was saved as empty when the following procedure was carried out. That problem has been fixed.

Parental Controls were configured in the System Settings.
In the System Settings, a country that has no individual area settings was selected in Profile > Region Settings
(For example, Anguilla for the US region, or Iceland for the EU region.)

When this was done, the region name in the language that was set in the system settings was cleared.
In other words, when nn::cfg::CTR::GetSimpleAddress(pSimpleAddress) was called to obtain region information, pSimpleAddress->regionName[nn::cfg::CTR::GetLanguage()] was an empty string.
This was fixed by setting the country name as the region name.

Note 135-15: (Audio Selector Applet) Added audio selector applet [System Updater]

An applet was added that allows you to select audio recorded using Nintendo 3DS Sound.

Known Issues with SDK 2.2.0 System Updater 0.15.3

In some extremely rare cases the screen will stay black after the system is closed and opened. Audio output, button input, and other features still function normally when this happens; the only feature that has not recovered is rendering. Close and open the system once more to resolve the symptoms. This same issue, however, can also be caused by applications, depending on how they are implemented. If this happens with your application, make sure that your application's implementation does not have any possible sequence or timing in which rendering might not recover after awakening from sleep.
The system may stop with the top and bottom screens remaining black in some rare cases when closing and opening the system during camera capture.
If you reset the settings using the Config tool, start an application without going through the startup sequence on the HOME Menu, and then open and close the system, the system will stop and the top and bottom screens will turn black.

■ CTR-SDK Version 2.2.0 Release

(2011/04/08)

Note 134-01: (AC) Removed `AP_TYPE_FREESPOT` [SDK | System Updater]

Merged AP_TYPE_FREESPOT with AP_TYPE_HOTSPOT.

Note 134-02: (CAMERA) Added information about the CAMERA library termination procedure [SDK]

If the application exits without shutting down the camera, there will be audible noise from the HOME Menu. A recommended procedure for terminating the camera library was added to the API Reference.

Note 134-03: (DevEnv) Added the compiler version to `version.h` [SDK]

Added the following constants, which indicate the compiler version, to version.h.

NN_VERSION_RVCT_MAJOR: RVCT major version
NN_VERSION_RVCT_MINOR: RVCT minor version
NN_VERSION_RVCT_CC_REV: RVCT compiler revision number
NN_VERSION_RVCT_LD_REV: RVCT linker revision number

Note 134-04: (DevEnv) Shared fonts are now uncompressed [SDK]

Changed the shared fonts included in CTR-SDK from compressed to uncompressed.

Note 134-05: (FRIENDS) Changed `GetFriendKeyList` to return `ResultTooLarge` [SDK]

Changed the GetFriendKeyList function so that it returns ResultTooLarge when the caller tries to retrieve a list that is larger than the number of users that can be registered in a friend list.

Note 134-06: (GX) Revised PICA macro headers [SDK]

Added the following enumerated constants to gx_MacroTexture.h to specify the format of shadow map textures and gas textures.

PICA_DATA_TEXTURE_FORMAT_SHADOW_UNSIGNED_INT = 0x0
PICA_DATA_TEXTURE_FORMAT_GAS_DMP_UNSIGNED_SHORT = 0x0

Note 134-07: (GX) Fixed memory fragmentation in `nngxInitialize` [SDK]

Memory buffers are allocated inside the nngxInitialize function. Some are kept until the nngxFinalize function is called as an administrator, and some are allocated for temporary use.
The order of buffer allocation was rearranged so that the memory freed when the nngxInitialize function terminates will not be in disparate chunks.

Note 134-08: (HID) Added a debugging mechanism to detect the SELECT button [SDK]

For debugging purposes, added the nn::hid::EnableSelectButton function to enable retrieval of SELECT and nn::hid::DisableSelectButton to disable it again.

Note 134-09: (HIO) Fixed a bug with `Finalize` [SDK]

Fixed a bug where work memory passed with the Initialize function was still used after the Finalize function.

Note 134-10: (HIO) Sped up file reads [SDK | System Updater]

Improved the nn::hio::HostFile::Read function speed when running a program from emulation memory in PARTNER-CTR Debugger.
This does not accelerate the process when running a program from PARTNER-CTR UIC-MIDI.

Note 134-11: (OS) Documented stack-size restrictions specified with `nn::os::Thread::[Try]StartUsingAutoStack` [SDK]

Added documentation to the API Reference about restrictions for the stack-size argument specified in the nn::os::Thread::[Try]StartUsingAutoStack function.

Note 134-12: (SND) Revised return values from `EncodeAdpcmData` [SDK]

The API Reference stated that the return value from the EncodeAdpcmData function was "None," but it was actually an s32. The value was changed to void.

Note 134-13: (SND) Fixed a bug where diffused noise would emanate when the `biquad` filter was used [SDK]

Fixed a bug (since CTR-SDK 2.0) where using the biquad voice filter caused diffused noise to emanate.

Note 134-14: (SND) Fixed a bug where `nn::snd::Delay` and `nn::snd::Reverb` would be disabled when recovering from sleep or returning from the HOME Menu [SDK]

If the application went into sleep or transitioned to the HOME Menu while using nn::snd::Delay or nn::snd::Reverb, this would not be reflected in the output. This bug has been fixed.

Note 134-15: (SND) Stopped noise that continued when three buffers were used in a sound's final output stage [SDK]

Fixed a rare bug where sound cutoff would trigger continued noise when three buffers were used for the final output stage by the nn::snd::SetOutputBufferCount function.

Note 134-16: (SOCKET) Fixed a bug where `GetHostByName` stopped operation [SDK]

Fixed a bug where assigning 256 or more characters to GetHostByName would stop the operation.

Note 134-17: (TOOL) Added support for 4 GB cards [SDK]

ctr_makerom now supports 4 GB cards.
4 GB was added as one of the values that can be specified for the RFS MediaSize.

Note 134-18: (TOOL) Fixed a bug with `BossLotcheckTool` [SDK]

Fixed the BossLotcheckTool tool to prevent buffer overflow.

Note 134-19: (TOOL) Changed the language setting of the `Config` tool [SDK]

The HOME Menu could not be configured if the Config tool language was set to invalid, but this limitation has been removed and configuration is now possible.

Note 134-20: (TOOL) Display remaining volume of importable media in `DevMenu` [SDK]

Changed the DevMenu display to indicate the remaining volume of importable media.

Note 134-21: (TOOL) Changed disconnection from an access point in `FriendTestingPartner` to be handled as error [SDK]

Changed disconnection from access point in the FriendTestingPartner function to be handled as error.

Note 134-22: (TOOL) Added `SaveDataSize` to RSF files [SDK]

Added Rom/SaveDataSize to RSF. This item specifies the save data size of a download application.
For more information, see makerom.

Note 134-23: (TOOL) Changed the `WMTestTool` [SDK]

Removed unneeded features from WMTestTool.

Note 134-24: (UDS) Added a function to obtain the channel [SDK | System Updater]

Added the nn::uds::GetChannel function to get the communication channel.

Note 134-25: (UDS) Changed the return values of `Send` and `Receive` [SDK]

Changed the SendTo function to return ResultMisalignedAddress if the send buffer passed to it is not 4-byte aligned.
The send data size parameter indicating the size of the send buffer must be rounded up to the nearest multiple of 4.
Changed the Receive and ReceiveFrom functions to return ResultMisalignedAddress if the receive buffer passed to them is not 4-byte aligned.
If the receive buffer size assigned to the argument is not a multiple of 4, the function returns ResultMisalignedSize.

Known Issues with SDK 2.2.0 Release

In the GD LightingSample demo, you will see a phenomenon where the area the light is shining on will periodically flash.
DevMenu may cause a data abort if an SD card that is not fully inserted is pushed and pulled several times.
If the CTR Card and SD card are inserted and removed at the same time repeatedly, DevMenu may display two CTR Card items.

■ CTR-SDK Version 2.2.0 System Updater

(2011/04/08)

Note 133-01: (AC) Removed `AP_TYPE_FREESPOT` [SDK | System Updater]

Merged AP_TYPE_FREESPOT with AP_TYPE_HOTSPOT.

Note 133-02: (BOSS) Added BOSS features [System Updater]

The following features were added to BOSS.

If-Modified-Since at ZoneAP level
When a task executes, the LastModifiedTime is recorded for each ZoneAP it connects to. This function therefore enables it to switch the If-Modified-Since time that it notifies to the download server in accordance with the access point it is connected to.
This makes it possible to download at the connected ZoneAP level, retrieving new data and avoiding the re-acquisition of data it has already acquired.
This function is available with services that switch the distribution data at the connected access-point level.
Resume task execution after going into resume ready state while connected to a zone access point
If a task went into resume ready state while running connected to a zone access point, using this function it can later run a task connected to a non-zone access point (for example, a task running on a home access point), and then resume when connected again to the zone access point.
This makes it possible to receive a data delivery from a particular dedicated zone access point.
Prevention of duplicated NSA data reception
The ID of download data (NSA) is recorded. therefore if an NSA that has already been downloaded is delivered, this feature will avoid retrieving the NSA twice.
The IDs of the latest NSAs that were downloaded (up to 50 max) are recorded for each task.

Note 133-03: (BOSS) Fixed a bug that prevented the play history from being recorded while in DS compatibility mode [System Updater]

The fix in Note 130-05 was insufficient. This note fixes a bug where at certain times the play history could not be recorded in DS compatibility mode, during Internet configuration.

Note 133-04: (BOSS) Fixed a bug that caused the system to take a long time to go to sleep or to end processing during policy list downloads [System Updater]

The fix in Note 130-06 was insufficient. This fix resolves the bug (if a process suddenly entered sleep or received a process termination notification while downloading a policy list, it would take a long time to complete).

Note 133-05: (FS) Prevented a drop in the write speed to expanded save data [System Updater]

There was a significant performance drop on some types of SD cards when performing large writes (on the order of several megabytes) to files on expanded save data. This drop in performance was alleviated.

Note 133-06: (HID) Revised sampling shutdown processing of the accelerometer and gyroscope [System Updater]

There was a bug with shutting down sampling of the accelerometer and gyroscope when an application using one of them failed to free the AccelerometerReader or GyroscopeReader functions upon shutdown before calling hid::Finalize.

Note 133-07: (HIO) Sped up file reads [SDK | System Updater]

Note 133-08: (HTTP) Fixed a bug relating to reusing `KeepAlive` in communication using chunked reception [System Updater]

Fixed a bug where reusing a KeepAlive on a connection that performed chunked reception would result in a response header error.

Note 133-09: (MCU) Fixed a bug where in compatibility mode the step count record could be one hour off [System Updater]

Fixed a bug where the seven-day record of steps would be off by one hour overall while in compatibility mode; if the user used the pedometer for seven days and continued to increase the step count immediately before recording stopped.

Note 133-10: (NDM) Changed BOSS to be stopped by default [System Updater]

Changed BOSS to be stopped by default.
An application that wants to run BOSS autonomously in the background must release the stop on BOSS by using the nn::ndm::Resume function.
The nn:: boss::StartImmediate function, indicating explicit execution and execution during sleep, is not affected by stopping.

Note 133-11: (NET) Fixed a bug where the state may not change from `disconnected` if Wi-Fi is turned off during UDS initialization [System Updater]

Fixed a bug where if Wi-Fi was switched off while initializing UDS, the state could not change from disconnected.

Note 133-12: (NET) Added a feature to automatically recover from a fatal wireless error [System Updater]

Changed to automatically recover from fatal wireless errors.
If a fatal wireless error occurred before, the fatal error screen would appear and the system would stop. From this release, the system recovers automatically without stopping.
After automatic recovery, it will appear to the AC, CECD, NDM, and other higher layers that wireless communication mode turned on immediately after turning off.
For this reason, depending on the application's implementation, a message may appear stating that the connection was lost.

At this time, there is no auto recovery from fatal wireless communication errors occurring during background communication in sleep mode, or when using UDS communication.
(Currently, fatal errors will never happen in these cases that are not covered by auto recovery.)

Note 133-13: (NET) Added fatal error display for wireless module malfunctions [System Updater]

The system was changed to display the fatal error screen if a malfunction in the wireless module caused wireless initialization to fail.

Note 133-14: (OS) Shortened the time required for thread initialization [System Updater]

Reduced the time required for internal processing by Thread::Start and other functions that initialize threads.

Note 133-15: (OS) Fixed a bug where the timer was not properly freed [System Updater]

Fixed a bug where the nn::os::Timer function would not be properly freed if Finalize was called before Stop.

Note 133-16: (OS) Fixed a bug where importing a CIA file via SPI failed with the debugging software [System Updater]

Fixed a bug where importing a CIA file via SPI would fail with the debugging software.
Note that CIA file imports via SPI are not conducted unless an option is specified.
(It is only performed when the .spi option is specified for the NAND WRITE and L commands.)

Note 133-17: (PTM) Revised detection of changes in the system state during sleep [System Updater]

Fixed a bug where it was not possible to get correct system information when the state of the power adapter, battery level, or charge indicator changed during sleep.

Note 133-18: (SOCKET) Fixed a bug where `ENOTCONN` was returned from `Send` upon reception of RST [System Updater]

ECONNRESET is returned when RST is received while blocking on Send on a TCP socket, but there were other cases in which ENOTCONN was returned.
This bug has been fixed.

Note 133-19: (TOOL) Added a screen capture feature to the development menu [System Updater]

Added the following specifications to the Test Menu when the application is suspended.

Display the images of the top and bottom screens of the application while suspended
When the L Button is pressed, bitmaps of the top and bottom screens (3 screens if stereoscopic view is enabled) are saved to the SD card

See the Test Menu documentation for details.

Note 133-20: (UDS) Revised the system so that a CTR-SDK internal error is not returned [System Updater]

CreateNetwork, ConnectNetwork, DestroyNetwork, and DisconnectNetwork were returning an error that is only handled internally by the CTR-SDK (nn::uds::detail::ResultFatalError). The functions were revised to no longer return the error.

Note 133-21: (UDS) Fixed a bug where the state would become `STATE_CREATING_NETWORK` after `CreateNetwork` failed [System Updater]

If the CreateNetwork function fails, the state should become STATE_DISCONNECTED, but the state sometimes became STATE_CREATING_NETWORK; this bug has been fixed.

Note 133-22: (UDS) Fixed a bug where `GetLinkLevel` would always return link level 0 [System Updater]

Fixed a bug (since CTR-SDK 2.1) where the GetLinkLevel function would always return link level 0.

Note 133-23: (UDS) Added a function to obtain the channel [SDK | System Updater]

Added the nn::uds::GetChannel function to get the communication channel.

Note 133-24: (UDS) Fixed a bug where the system stopped due to an exception during reception [System Updater]

Fixed a bug where the system would in rare cases stop with an exception when receiving a large volume of data on one port.

Note 133-25: (UDS) Revised the return values from `Scan` when the wireless switch is set to OFF [System Updater]

Fixed a bug where if the wireless switch is set to off during a call to the Scan function, it should return ResultWirelessOff but was returning ResultInvalidState.

Known Issues with System Updater in SDK Version 2.2.0

In some extremely rare cases the screen will stay black after the system is closed and opened. Audio output, button input, and other features still function normally when this happens; the only feature that has not recovered is rendering. Close and open the system once more to resolve the symptoms. This same issue, however, can also be caused by applications, depending on how they are implemented. If this happens with your application, make sure that your application's implementation does not have any possible sequence or timing in which rendering might not recover after awakening from sleep.
The system may stop with the top and bottom screens remaining black in some rare cases when closing and opening the system during camera capture.
If you reset the settings using the Config tool, start an application without going through the startup sequence on the HOME Menu, and then open and close the system, the system will stop and the top and bottom screens will turn black.

■ CTR-SDK Version 2.2.0 Sample Demos

(2011/04/08)

Note 132-01: (APPLET) Added `lib_applet` [Sample Demos]

In CTR-SDK 2.1, applet[.h|.cpp] added to demo1, demo2, and so forth. has been moved into the $SampleDemos/common directory in the format lib_applet.

Note 132-02: (APPLET) `applet::Enable` and others added to sample demos [Sample Demos]

The applet::Enable function was added to the sample demos. Starting from the HOME Menu is now also possible.
Some demos have also been revised to use lib_applet and now enable HOME Button and sleep transitions.

The following demos do not support HOME Menu startup.

hio
http
makebanner
news
ssl
template

Note 132-03: (GX) Sped up the `ScreenCapture` sample [Sample Demos]

Sped up saving to SD card in the ScreenCapture sample.
There was a bug in the old implementation that caused degraded performance.

Known Issues with SDK 2.2.0 Sample Demos

None.

■ CTR-SDK Version 2.1.0 Release

(2011/03/25)

Note 131-01: (APPLET) Revised so that `PrepareToCloseApplication` is called from `CloseApplication` [SDK]

Revised so that PrepareToCloseApplication is called from CloseApplication.

Note 131-02: (APPLET) Added wrapper functions for HOME Menu transitions and POWER Menu transitions [SDK]

Added the nn::applet::ProcessHomeButtonAndWait and nn::applet::ProcessPowerButtonAndWait wrapper functions concerning HOME Menu transition and POWER Menu transition processing.

Note 131-03: (BOSS) Changed the default setting value for the `TASK_PERMISSION` attribute [SDK]

Changed the default setting for the TASK_PERMISSION attribute of a task to TASK_PERMISSION_IN_PARENTAL_CONTROL(task that can run even when Parental Controls have restricted "Online Interaction").

Note 131-04: (CAMERA) Added the `GetParallax` function [SDK]

Added the GetParallax function to calculate parallax for the specified distance from the camera using the calibration data.

Note 131-05: (CAMERA) Revised the `GetStereoCameraCalibrationMatrix` function [SDK]

The GetStereoCameraCalibrationData function returns a 3×4 matrix to use for two-dimensional geometric conversions.
The z-axis scale should have been 1 but was mistakenly set to 0. This has been fixed.

Note 131-06: (CAMERA) Added the `GetStereoCameraCalibrationMatrixEx` function [SDK]

Stereo camera placement errors vary widely, so the GetStereoCameraCalibrationMatrixEx function was added to return a correction matrix that would not lose the edges of the image even for systems that had placement errors near the limit.

Note 131-07: (CAMERA) Added the `SetBrightnessSynchronization` function [SDK | System Updater]

Added the SetBrightnessSynchronization function to enable a feature that links the stereo camera brightness.
By default, the above link feature is disabled.

Note 131-08: (CEC) Changed the `MessageBox` class function names [SDK]

Changed function names because some function names had abbreviations in them.

GetBoxMessNumMax → GetBoxMessageNumMax
GetBoxMessNum → GetBoxMessageNum
GetMessageMessSize → GetMessageSize
GetMessageMessTypeFlag → GetMessageTypeFlag
GetMessageMessIdPair → GetMessageIdPair
GetMessageMessId → GetMessageId
GetMessIndex → GetMessageIndex

Note 131-09: (CEC) Added debug functions to transition to StreetPass-exclusive mode [SDK]

The system can switch between various types of background communication (including Internet and StreetPass), but we also provide a feature for switching background communication to StreetPass-exclusive mode.

nn::cec::CecControl::EnterExclusiveState
nn::cec::CecControl::LeaveExclusiveState

This can be used to verify StreetPass communication and other operations.
These functions operate only when debug mode is enabled.

Note 131-10: (CRYPTO) Added a 4-byte alignment restriction for the hash acquisition pointer [SDK]

An error may occur if the output destination pointer pOut is not 4-byte aligned for Sha1Context::GetHash, or CalculateSha1, and CalculateHmacSha1. This restriction, which also applies to Sha256, is included in the API reference.

Note 131-11: (CX) Changed the `IsFinishedUncompRL` function name to `IsFinishedUncomp [SDK]`

The IsFinishedUncompRL function name was inappropriate, so it has been changed to IsFinishedUncomp.
The old function name is kept for compatibility, but it has been removed from public release.

Note 131-12: (DLP) Deleted symbols related to DUP [SDK | System Updater | Sample Demos]

Deleted the symbols related to DUP (updates through Download Play).
In conjunction with this, some of the information about the client that can be obtained from the server will change.
Specifically, the DUP client is always in the CLIENT_STATE_JOINED_SESSION (state before child device distribution).
After the DUP completes, transitions to CLIENT_STATE_DOWNLOADING and child device distribution begin.
Finally, nn::dlp::Server::GetClientStatus was removed because the download progress during DUP can be determined. It was replaced with nn::dlp::Server::GetClientState.

Note 131-13: (DLP) Added a function to determine whether a device is a child [SDK | Sample Demos]

Added a function to determine whether a device is a child device.
The function is nn::dlp::IsChild, which is defined in dlp_Common.h.
Use it when neither nn::dlp::Server nor nn::dlp::FakeClient can be used (that is, when the Initialize function has not been called).

Note 131-14: (DevEnv) Support for C++ exceptions [SDK]

Made changes so that C++ exceptions can be used.
However, C++ exceptions are disabled by default with the CTR-SDK build system.
When using C++ exceptions, add the CCFLAGS += --rtti --exceptions LDFLAGS += --exceptions specification to the application's OMakefile.

Note 131-15: (DevEnv) Added how to import a TWL NAND application to CTR [SDK]

Added how to import a TWL NAND application to the development menu, ctr_makecia reference, and Download Application Development Manual.

Note 131-16: (DevEnv) Support for the CCL format [SDK]

Support added to build for the CCL format. This separates the CCI executable code and ROM-FS portions and loads them separately to the debugger.
In OMakefile, specify LIST for the CTR_APPTYPE variable to generate the CCL format.
The CCL format is not currently supported, however, so it cannot be used for debugging or other purposes.

Note 131-17: (DevEnv) Added Download Application Development Manual [SDK]

The Download Application Development Manual was added to $CTR_SDK/documents/TechnicalNotes/DownloadAppManual.

Note 131-18: (DevEnv) Added build variables for the vertex shader assembler and linker [SDK]

Added SHADER_ASFLAGS and SHADER_LDFLAGS as build variables that can be specified as options for the vertex shader assembler and linker, respectively.

Note 131-19: (FS) Added an archive that can directly write to an SD card [SDK]

Added an archive that can directly write to an SD card.
It cannot load files nor open directories.
It can be used by calling the nn::fs::MountSdmcWriteOnly function.

Note 131-20: (FS) Changed error-handling specifications for two archive functions [SDK]

The specification for the following two functions was changed so that internal errors do not return an error before transitioning to the error display screen.
- nn::fs::GetRomRequiredMemorySize
- nn::fs::MounrRom
These functions only return successful, so there is no longer any need for error handling by the application.

Note 131-21: (FS) Revised to deny access when application save data is invalid [SDK]

When accessing card applications or download applications, the application data cannot be accessed if the application's save data is invalid.
The return value indicates invalid save data.

In conjunction with this change, a C8804497 error occurs when starting a card application that uses save data if the inserted CTR card does not have on-board backup memory.

Note 131-22: (FS) Documented buffer access when reading or writing a file [SDK]

Explained in the FS library API reference the result of buffer access while reading or writing to a file.

Note 131-23: (FS) Deleted `ResultArchiveInvalidated` from expanded-save-data error handling [SDK]

There were cases when ResultArchiveInvalidated was returned when mounting, creating, deleting, or enumerating expanded save data archives, but a ResultMediaNotFound error is now returned instead.
As a result, error handling for ResultArchiveInvalidated is unnecessary when dealing with expanded save data archives.
However, for expanded save data directory and file operations, ResultArchiveInvalidated must be handled as it had been previously.

Note 131-24: (GR) Fixed a bug that prevented using `Vertex::DisableAttr` to disable vertex attributes that were enabled with `Vertex::EnableAttrAsArray` [SDK]

Vertex attributes enabled using the Vertex::EnableAttrAsArray function could only be disabled using Vertex::DisableAll, which was a bug. This has been revised so that attributes can be disabled using Vertex::DisableAttr.

Note 131-25: (GX) Updated the PICA macro header [SDK]

Added two enumerated constants, PICA_DATA_TEXTURE_FORMAT_SHADOW_UNSIGNED_INT and PICA_DATA_TEXTURE_FORMAT_GAS_DMP_UNSIGNED_SHORT to the PicaDataTexture0SamplerType enumerated type to specify shadow map texture and gas texture formats.

Note 131-26: (GX) Added the `glGetTexLevelParameter[if]v` function [SDK]

The glGetTexLevelParameter[if]v function has been added to the API to get information related to textures that are currently bound.

Note 131-27: (GX) Added the `nngxAdd3DCommandNoCacheFlush` function [SDK]

The nngxAdd3DCommandNoCacheFlush function, which does not flush the cache of the region specified by bufferaddr, has been added for cases when GL_FALSE is added to the copycmd argument of the nngxAdd3DCommand function.

Note 131-28: (GX) Expanded capability of the `nngxAddCmdlist` function [SDK]

The nngxAddCmdlist function was revised so that a command request to reference external command buffers can be added.

Note 131-29: (GX) Added the `nngxAddVramDmaCommandNoCacheFlush` function [SDK]

The nngxAddVramDmaCommandNoCacheFlush function, which does not flush the cache of the region specified by srcaddr, has been added for the nngxAddVramDmaCommand function.

Note 131-30: (GX) Revised `nngxCmdlistStorage` to reduce the number of allocator calls [SDK]

Reduced the number of times the memory allocator is called by the nngxCmdlistStorage function.

Note 131-31: (GX) Fixed a bugs in `nngxCopyCmdlist` and `nngxClearFillCmdlist` [SDK]

Fixed a bugs that caused the gas density information to be incorrectly updated when command lists included the nngxCopyCmdlist or nngxClearFillCmdlist functions.

Note 131-32: (GX) Revised `nngxInitialize` to reduce the number of allocator calls [SDK]

Reduced the number of times the memory allocator is called by the nngxInitialize function.
Also, optimized the request size.

Note 131-33: (GX) Updated the shader tool [SDK]

The following changes were made to the shader tool.

The break command, which is not covered by the specification, cannot be compiled.
An error occurs when the break command is called immediately before the endloop command.
An error occurs when a jpb or jpc command is called immediately before a else, endif, endloop, or ret command
An error occurs when a jpb or jpc command jumps in an if or loop statement.
Fixed typos in error messages.
Added the -preprocess option to support shader assembler preprocessing.

Note 131-34: (GX) Updated the documentation [SDK]

The following changes were made to the GX documentation.

DMPGL20_specification.pdf

Added "Obtaining Texture Level Parameters"
Added a description of dmp_LightEnv.absLutInput{RR,...}
Added supplementary explanations for "Shadow Attenuation Term" and "Bump Mapping"

DMPGL20_programming_guide.pdf

Added a description to 13.5 "Normal Map Formats and Types"

DMPGL20_system_API_specification.pdf

Added descriptions of the nngxAddVramDmaCommandNoCacheFlush and nngxAdd3DCommandNoCacheFlush functions
Revised the Catmull-Clark subdivision shader register settings

VertexShaderReferenceManual.pdf

Added a description of the preprocessing execution option
Supplemented explanations of the jpb, jpc, and breakc commands

Note 131-35: (HID) Changed the gyro sensor zero point correction setting value [SDK]

Reviewed and changed the strength of zero-point correction when configuring GYROSCOPE_ZERODRIFT_STANDARD of hid::ZeroDriftMode.
The zero-point correction for STANDARD is now stronger.
Nothing has changed for TIGHT and LOOSE.
Revise applications in accordance with the new STANDARD settings.
The previous settings for STANDARD are now more similar to the settings for TIGHT.

Note 131-36: (HID) Announced change for assessing the accelerometer calibration value when transitioning to the HOME Menu [SDK]

Explained in the reference that the calibration value may change upon transition from the application to the HOME Menu. The implementation of this feature is planned for a future release.

Note 131-37: (HIO) Added reference to `nn::hio::CTR::SerialChannel::GetReadableSize` [SDK]

Documented the different sizes that can be received based on the attr argument.

Note 131-38: (JPEG) Added the `GetLastDateTimePointer` function [SDK]

Added the GetLastDateTimePointer function to return a pointer to the Exif date and time information.

Note 131-39: (MATH) Added functions that were previously omitted from the reference [SDK]

All of the functions in $CTR_SDK/include/nn/math/math_Utility.h were omitted from the API Reference. This oversight has been corrected.

Note 131-40: (MIDI) Changed the `nn::midi::CTR::Open` function to determine the UIC-MIDI device [SDK]

In CTR-SDK 2.0 and later, the UIC-MIDI device is identified when the nn::midi::CTR::Open function is called.
When a UIC-MIDI device is not recognized, nn::midi::ResultUnknownDevice is returned.
The CTR system cannot correctly recognize the UIC-MIDI device when this result is returned. Verify that the UIC-MIDI is inserted in the card slot and then reload the program.

The debugger software specification prior to the PARTNER-CTR 2011/03/09 version does not allow for correct recognition of a reinserted UIC-MIDI device, therefore, by pressing the Reload button.
To correctly recognize the UIC-MIDI device, use the debugger software and either click Load or drag the file icon to the correct screen location.

Note 131-41: (TOOL) Added `BossLotcheckTool` [SDK]

Added BossLotcheckTool to verify BOSS task information or NS data information registered by the application.
For more details, see the API Reference.

Note 131-42: (TOOL) Changed the option to generate a CXI file [SDK]

Specify -f exec in makerom to generate a CXI file. Previously, this was specified using -f nand.
The -f nand specification still works with CTR-SDK version 2.1, but this capability will be removed in the future.
For more information, see makerome.

Note 131-43: (TOOL) Changed the `Config` tool [SDK | System Updater]

Made the following changes to the Config tool.

Language settings can now be configured
When the language settings are changed to invalid, some menu settings are changed instantaneously
Revised the feature to shift gyro acceleration correction values to write a fixed value to the correction value so individual differences in the shift value do not appear
To perform verification using this feature in the future, use the Config tool from CTR-SDK 2.1 and later

For more details, see the API Reference.

Note 131-44: (TOOL) Added support for importing to SD cards [System Updater] [SDK]

Added a feature to the development menu so that downloaded applications can be imported to SD cards.

Note 131-45: (TOOL) Updated `SaveDataFiler` [SDK]

Made the following changes to the SaveDataFiler tool.

Added a feature to initialize shared expanded save data
Added the features Export, Import, and Destroy Individual Files for the save data of downloadable applications.
The save data of downloadable applications exported using the CTR-SDK 2.1 version of SaveDataFilercannot be imported using earlier versions of SaveDataFiler.
Other save data can be mutually imported and exported.
Changed so that pressing the B Button traverses back up the hierarchy
Changed so Result is displayed when an error occurs

For more details, see the API Reference.

Note 131-46: (TOOL) Improved the performance of `makerom` [SDK]

Improved the performance of makerom.

Note 131-47: (TOOL) Added debug mode setting [SDK]

Added Debug mode to the Config tool settings.
When Debug mode is enabled, debugging features for the following functions are enabled.
For more information, see the individual functions in the Reference Manual.

nn::ac::DebugSetApType
nn::ac::DebugSetNetworkArea
nn::ac::DebugSetNetworkSetting1

CEC

nn::cec::CecControl::StartScanning
nn::cec::CecControl::EnterExclusiveState

nn::uds::CreateNetwork
nn::uds::ConnectNetwork

Note 131-48: (TOOL) Changed banner data capacity restrictions [SDK]

Changed some of the restrictions for data capacity.
Also, made changes so that data that violates these restrictions generates an error during conversion.

Note 131-49: (TOOL) Added tool for generating friend presence load [SDK]

Added the FriendTestingPartner tool to run friend presence background processing on the CTR where a friend relationship was made (the friend presence is updated at a high frequency).

Note 131-50: (TOOL) Added the `UdsLocalIdChecker` tool to confirm the local communication ID [SDK]

Added UdsLocalIdChecker to confirm the local communication ID.

Note 131-51: (TOOL) Added a tool to generate jamming [SDK]

Added WMTestTool, which is provided with Nintendo DS systems as a wireless test tool.
For CTR, use only the feature to generate radio interference (Noise Mode).
Import the CIA file from $CTR_SDK/tools/TargetTools/CTR-TS/Release to the CTR. Then start the tool from the development menu.
It executes in TWL-compatible mode.
For more information, see the API Reference.

Note 131-52: (TOOL) Revised tools that was not displayed on the HOME Menu outside of the Japanese Region [SDK]

When SaveDataFiler and CecLotCheckTool were imported to a system, they were not displayed on the HOME Menu (outside of the Japanese region).
They are now displayed in all regions.

Note 131-53: (TOOL) Changed to display the firmware version on the development menu [SDK | System Updater]

The firmware version is displayed on the top screen of the development menu. Prior to this change there was no way to confirm the firmware version when the start default was set to the HOME Menu.
Also, the version displayed on the HOME Menu System Settings was not accurate and was set to 0.

Note 131-54: (UBL) Revised the API Reference Manual [SDK]

The corrections described in Note 128-43 were not uniformly applied to the documentation, so the text has now been deleted.

Note 131-55: (Y2R) Added the `GetPackageParameter` function [SDK]

Added the GetPackageParameter function to get PackageParameter structure parameters in one operation.

Known Issues with SDK 2.1.0 Release

In the GD LightingSample demo, you will see a phenomenon where the area the light is shining on will periodically flash.

■ CTR-SDK Version 2.1.0 System Updater

(2011/03/25)

Note 130-01: (APPLET) Fixed a bug that allowed both `IsExpectedToCloseApplication` and `IsExpectedToProcessPowerButton` to be `true` at the same time [System Updater]

A bug caused both IsExpectedToCloseApplication and IsExpectedToProcessPowerButton to be true at the same time. This occurred when the POWER Button was clicked to return control to the application while a library applet, such as the software keyboard applet or photo selection applet, was running.
This was changed so that only IsExpectedToProcessPowerButton is true.

Note 130-02: (APPLET) Fixed a bug that occurred when a card was removed while waiting for a sleep query callback [System Updater]

Fixed a bug where an inconsistency occurred in the internal state if a card was removed while the application was returning LATER in response to a SLEEP QUERY, after which the system could not go to sleep.
This was actually changed in CTR-SDK 2.0 but was accidentally omitted from the change log.

Note 130-03: (APPLET) Revised so that `AwakeCallback` is called when the battery is fully discharged during sleep [System Updater]

AwakeCallback was not called if the battery was fully discharged during sleep, so the application could not perform the finalization process. This has been revised so AwakeCallback is called.

Note 130-04: (BOSS) Added BOSS features [System Updater]

The following features were added to BOSS.

Added the Execute Background Tasks Immediately feature.
This is a feature to immediately start background task execution. The function is nn::boss::Task::StartBgImmediate.
Added the Specify Maximum Number of Files for BOSS Storage feature.
This feature ensures the number of files in BOSS storage do not exceed the specified number. The function is an overridden version of nn::boss::RegisterStorage.
Changed the method of scheduling.
Unlike the scheduling method used to date, the highest priority is given to task priority at the time the order of task execution is determined.
The control over task execution order has been changed to be even more precise.
(For example, if a MEDIUM priority task and a HIGH priority task are set to execute at the same time, the HIGH priority task will always be executed first.)

Note 130-05: (BOSS) Fixed a bug that prevented the play history from being recorded while in DS compatibility mode [System Updater]

Fixed a problem associated with the bug in the BOSS finalization process of Internet settings that prevented PTM from finalizing and prevented the play history during DS compatibility mode from being recorded.

Note 130-06: (BOSS) Fixed a bug that caused the system to take a long time to go to sleep or to end processing during policy list downloads [System Updater]

Fixed a bug that occasionally caused the system to take a long time to complete entering sleep or to end processing when notification arrived during policy list downloads.

Note 130-07: (CAMERA) Added the `SetBrightnessSynchronization` function [SDK | System Updater]

Added the SetBrightnessSynchronization function to enable a feature that links the stereo camera brightness.
By default, the above link feature is disabled.

Note 130-08: (CAMERA) Revised priorities for the finalization process [System Updater]

When the HOME Menu was displayed a bug caused sound playback to be interrupted because the thread priority of the camera finalization process was high. The priority for executing the finalization process has been lowered.
The priorities of other camera processes have not been changed.

Note 130-09: (DLP) Deleted symbols related to DUP [SDK | System Updater | Sample Demos]

Note 130-10: (DLP) Fixed a bug that prevented returning from `FakeClient::StopScan` when the wireless switch was OFF [System Updater]

Fixed a bug where control would not return from the FakeClient::StopScan function when it was called immediately before or after switching the wireless button off.

Note 130-11: (DevEnv) Fixed a bug that prevented the system from going to sleep when the system was closed immediately after starting from the development menu [System Updater]

Fixed a bug where the system would not sleep when closed immediately after starting an application that was loaded from the development menu using the debugger L command.

Note 130-12: (FRIENDS) Organized the `Results` returned by `Login` [System Updater]

Made changes so that the friends::Login function does not return ResultTemporarilyBusy or ResultAlreadyDone.
ResultSuccess is now returned in these situations.

Note 130-13: (FRIENDS) Changed the timing for autonomous login after resuming [System Updater]

Changed the delay time for automatic logins. If a sufficient amount of time has passed after the system was suspended, the time delay between resume and automatic login is reduced, even if the most recent automatic login failed.

Note 130-14: (FS) Revised the `nn::fs::TryDelete` and `nn::fs:TryRename` functions [System Updater]

An nn::fs::ResultBadFormat error was sometimes returned when deleting using nn::fs::TryDeleteFile or nn::fs::TryDeleteDirectory if a file with the same name as the directory was present in the same path.
In addition, an nn::fs::ResultInvalidArgument error was returned when using nn::fs::TryRenameFile or nn::fs::TryRenameDirectory if the same name was used for both a file and a directory in the same path.
These have been fixed and an nn::fs::ResultOperationDenied error is now returned.

Note 130-15: (FS) Revised the `nn::fs::TryDeleteDirectory` and `nn::fs::TryDeleteDirectoryRecursively` functions [System Updater]

When trying to delete directories with names that contained "..." using the nn::fs::TryDeleteDirectory or nn::fs::TryDeleteDirectoryRecursively functions, deletion failed and an nn::fs::ResultOperationDenied error was returned.
This bug has been fixed and the directories are now deleted.

Note 130-16: (FS) Added format determination process when mounting card save data [System Updater]

Added a process to determine whether the driver layer format is correct when a card application is mounting its own save data.
If the format is invalid, an nn::fs::ResultBadFormat error is returned. You should first retry formatting.

Note 130-17: (FS) Fixed a bug that prevented processing to return when an SD card was removed while accessing data from a download application [System Updater]

Fixed a bug where control did not return when an SD card was removed while accessing download application data.

Note 130-18: (FS) Fixed a bug that caused `nn::fs::TryDeleteFile` to fail for expanded save data files [System Updater]

Fixed a bug that caused an error to be returned when using nn::fs::TryDeleteFile for a file in expanded save data in an invalid state regardless of whether the actual process completes.

Note 130-19: (FS) Fixed a bug that caused loading a file to fail at some specific time [System Updater]

Fixed a bug that caused a failure in verification when loading a file. It occurred on rare occasions in certain situations.
This bug occurred only with CTR-SDK 2.0 or later.

Note 130-20: (FS) Fixed a bug that prevented an SD card from being properly recognized when it was removed and inserted under specific conditions [System Updater]

Fixed a bug that prevented an SD card from being properly recognized when it was removed and inserted under specific conditions.

Note 130-21: (HTTP) Fixed a bug that caused `Read` functions to timeout after canceling a `ChunkedPost` [System Updater]

Fixed a bug that sometimes caused Read functions to time out after implementing http::Connection::NotifyFinishSendPostData and Connection::Cancel at the same time during ChunkedPost processing . (Specifications call for ResultTimeout to be returned.)

Note 130-22: (HTTP) Added a function to specify whether to enable `KeepAlive` communication [System Updater]

Added the SetKeepAliveAvailability function to specify whether KeepAlive communication is used.

Note 130-23: (NET) Fixed the wireless FATAL error that occurred when specific applications were operating [System Updater]

Fixed a bug that caused wireless FATAL errors at a relatively high frequency when using background communications or local communications in specific applications.

Note 130-24: (OS) Revised `nn::os::SetDeviceMemory` to enable changing the device memory size [System Updater]

Revised the nn::os::SetDeviceMemory function. It can now change the device memory size.
However, the device memory size must be a multiple of 1,048,576 bytes (1 MB) both before and after the change.

Note 130-25: (OS) Fixed a bug that prevented errors from displaying when a card was removed [System Updater]

Fixed a bug that caused an active CTR card application to freeze without displaying the error screen under certain conditions when the card was removed.

Note 130-26: (OS) Added support for debugging download applications [System Updater]

The debugger can now load and debug downloadable applications.

Note 130-27: (OS) Fixed a bug that occasionally caused the system to freeze when it was opened and closed quickly [System Updater]

Fixed a bug that occasionally caused the system to freeze when it was opened and closed quickly.

Note 130-28: (SOCKET) Changed specification for when RST is received [System Updater]

Changed the behavior so data that has already been received can be read even when RST is received at a TCP socket.

Note 130-29: (SOCKET) Fixed a bug that caused data received at a TCP socket to be corrupted [System Updater]

Fixed a bug that caused received data to be corrupted if certain conditions overlapped when resent data was received at a TCP socket.

Note 130-30: (SOCKET) Improved connectivity [System Updater]

Fixed a bug that prevented a successful connection if enough wait time was not allowed when the receiving host's TCP socket specified a window size of 0 (using SYN-ACK).

Note 130-31: (TOOL) Changed the `Config` tool [SDK | System Updater]

Made the following changes to the Config tool.

Language settings can now be configured
When the language settings are changed to invalid, some menu settings are changed instantaneously
Revised the feature to shift gyro acceleration correction values to write a fixed value to the correction value so individual differences in the shift value do not appear
To perform verification using this feature in the future, use the Config tool from CTR-SDK 2.1 and later

For more details, see the API Reference.

Note 130-32: (TOOL) Changed System Updater specifications [System Updater]

Made changes so whether to reboot after updating can be selected.

Note 130-33: (TOOL) Changed to display the firmware version on the development menu [SDK | System Updater]

Note 130-34: (UDS) Revised the `Result` values when `ConnectNetwork` fails [System Updater]

Fixed a bug where the Result values indicating failure of the ConnectNetwork function differed from the API Reference.
To maintain compatibility, the Result values returned for applications built with CTR-SDK 1.x or earlier are based on the previous definitions.

Note 130-35: (UDS) Fixed a bug that prevented event notification when wireless disabled mode was entered immediately after Initialization [System Updater]

A bug prevented updated connection states from being signaled when wireless communication was disabled immediately after the nn::uds::Initialize function succeeded.
This bug has been fixed.

Note 130-36: (UDS) Fixed a bug that caused the system to enter an invalid state when `Finalize` was executed during communication [System Updater]

Fixed a bug that caused the system to enter an invalid state when the Finalize function was called without calling the DestroyNetwork or DisconnectNetwork function during communication.

Known Issues with System Updater in SDK Version 2.1.0

In some extremely rare cases the screen will stay black after the system is closed and opened. Audio output, button input, and other features still function normally when this happens; the only feature that has not recovered is rendering. Close and open the system once more to resolve the symptoms. This same issue, however, can also be caused by applications, depending on how they are implemented. If this happens with your application, make sure that your application's implementation does not have any possible sequence or timing in which rendering might not recover after awakening from sleep.
In very rare cases, a fatal error occurs when background communication is performed. The following error values may be displayed at this time.

0xF9606C0F Level: -1 Summary:11 Module:27 Desc: 15
0xF9606C11 Level: -1 Summary:11 Module:27 Desc: 17

■ CTR-SDK Version 2.1.0 Sample Demos

(2011/03/25)

Note 129-01: (AC) Deleted calls to `fs::Finalize` in the sample demos [Sample Demos]

Calls to the fs::Finalize function are unnecessary and therefore were deleted from the AC-related sample demos.
This was actually changed in CTR-SDK 2.0 but was accidentally omitted from the change log.

Note 129-02: (APPLET) Organized the code for applet-related processes [Sample Demos]

Reorganized the code in demo1 and demo2 related to applets such as sleep, HOME Button, and POWER Menu.
Also deleted the code that terminated the application autonomously without interpreting the HOME Menu.

Note 129-03: (CAMERA) Fixed a bug in the `Stereo` demo [Sample Demos]

Fixed a bug in the camera Stereo demo that caused capture to restart when the system was opened and closed and Capture Disable was specified on the lower screen.

Note 129-04: (DLP) Deleted symbols related to DUP [SDK | System Updater | Sample Demos]

Note 129-05: (DLP) Deleted `DummyUpdatePartition` [Sample Demos]

Deleted DummyUpdatePartition from the sample demos because DUP (updates via download play) is no longer necessary for server application development.

Note 129-06: (DLP) Added a function to determine whether a device is a child [SDK | Sample Demos]

Note 129-07: (FS) Added sample demos [Sample Demos]

Added sample demos for the FS library.
The demos include sample code to mount ROM archives, save data, and expanded save data, and sample code for subsequent file operations.

Note 129-08: (GR) Revised `lib_grfw` so that the DMPGL display buffer functions are not used [Sample Demos]

Revised the lib_grfw library, which is the framework for GR library demos, so that the DMPGL display buffer object functions (nngxBindDisplaybuffer, nngxDisplaybufferStorage, nngxSwapBuffers, and so forth) are not used and allocation of the display buffer is explicitly performed.
Also, revised the nngxSwapBuffersByAddress function to enable setting of display buffer swap values.

Note 129-09: (OS) Deleted calls to `os::Initialize` from the sample demos [Sample Demos]

Calls to the os::Initialize function are unnecessary and therefore were deleted from the sample demos.

Note 129-10: (SND) Added Applet support for the `SimplePlayer` sample demo [Sample Demos]

The SimplePlayer sample demo was revised to support applets, so HOME Button and Sleep Mode transitions are now possible.

Known Issues with SDK 2.1.0 Sample Demos

None.

■ CTR-SDK Version 2.0.0 Release

(2011/02/24)

Note 128-01: (APPLET) Removed `nn::applet::CTR::GetSleepNotificationState`, `nn::applet::CTR::ClearSleepNotificationState` [SDK]

Until now the investigation of the application's returning a hold for sleep queries was carried out by the nn::applet::CTR::GetSleepNotificationState function, and it was necessary for it to be cleared on the application side by the nn::applet::CTR::ClearSleepNotificationState function, but with this method there were instances, based on timing, where sleep notifications could not be picked up.
The response to the hold was therefore standardized to nn::applet::CTR::IsExpectedToReplySleepQuery.
In addition, the nn::applet::CTR::GetSleepNotificationState and nn::applet::CTR::ClearSleepNotificationState functions have been removed from public release.

Note 128-02: (APPLET) End library applet when exiting application [SDK]

When an application ends, changes have been made such that if a Library Applet is in a preloaded state, it will be terminated.
This process will be performed by the applet::PrepareToCloseApplication function.

Note 128-03: (BOSS) Revised so that CA certificate is automatically set in the NADL task [SDK]

Revisions have been made such that when registering a NADL task, the necessary CA certificate is automatically set in the BOSS library.
As a result, CA certificate setting processes are no longer needed on the application side.

Note 128-04: (CRYPTO) Increased the speed of SHA-256 process functions [SDK]

Increased the speed for implementations related to SHA-256 in the crypto library.

Note 128-05: (DBG) Added macros for debugging log output [SDK]

Added macros (NN_LOGV and NN_PUT) that perform output of debugging logs.

Note 128-06: (DLP) Simplified the state and events of the server at distribution [SDK | System Updater | Sample Demos]

Simplified server states and events during data distribution to simplify application development.
As a result, when developing server applications, the developer no longer needs to be aware of system updates in DLP.
Specifically, the changes are as follows.
The server data distribution states defined for the ServerState enumerated type, shown below, have been gathered together into one state: SERVER_STATE_DISTRIBUTING.

SERVER_STATE_PREPARING_FOR_SYSTEM_DISTRIBUTION
SERVER_STATE_DISTRIBUTING_SYSTEM
SERVER_STATE_WAITING_RECONNECT
SERVER_STATE_PREPARING_FOR_TITLE_DISTRIBUTION
SERVER_STATE_DISTRIBUTING_TITLE

The events notified for server data distribution defined for the EventType enumerated type, shown below, have been gathered together into one event: EVENT_TYPE_SERVER_STATE_DISTRIBUTING.

EVENT_TYPE_SERVER_STATE_PREPARING_FOR_SYSTEM_DISTRIBUTION
EVENT_TYPE_SERVER_STATE_DISTRIBUTING_SYSTEM
EVENT_TYPE_SERVER_STATE_WAITING_RECONNECT
EVENT_TYPE_SERVER_STATE_PREPARING_FOR_TITLE_DISTRIBUTION
EVENT_TYPE_SERVER_STATE_DISTRIBUTING_TITLE

Note 128-07: (DevEnv) Added libraries that will be linked by default [SDK]

Made changes such that the following libraries will be linked by default.

boss
friends
gd
gr
news
ngc
nwm
rdt
tpl
ubl
ulcd

Note 128-08: (DevEnv) Organized the build rules [SDK]

Organized the omake rule definitions, used by builds that use omake.
With the aim of fixing bugs and improving maintenance, we plan to continue making changes in CTR-SDK 2.1.
The old build rules exist in $CTR_SDK/build/omake_deprecated, but we plan to delete them in the next release.

Note 128-09: (DevEnv) Avoided an error when deleting the header [SDK]

In previous versions of the CTR-SDK, when the header was deleted you needed to use --depend to recreate the dependency relationships, but changes have been made so that this is no longer needed.

Note 128-10: (FND) Revised the unit heap `Dump` function [SDK]

Fixed a bug where information on allocated blocks and unallocated blocks was not correctly displayed by the unit heap's Dump function.

Note 128-11: (FONT) Changed the specifications for the `ArchiveFont::InitStreamingConstruct` function [SDK]

Changed the specifications such that an error is returned when an argument is missing or incorrect in the nn::font::ArchiveFont::InitStreamingConstruct function.
Up until now there was only an assert failure check, which led to undefined behavior in release builds.

Note 128-12: (FS) Revised return values for Mount*SaveData [SDK]

The error was nn::fs::ResultOutOfMemory when the archive name passed to nn::fs::Mount*SaveData had already been registered or was longer than seven characters and did not include a colon (":") character.
These have been respectively revised to return the nn::fs::ResultAlreadyExists and nn::fs::ResultInvalidArgument errors.

Note 128-13: (FS) Revised the `nn::fs::ForceEnableLatencyEmulation` function [SDK]

In addition to the feature to emulate changes in access speed when a non-volatile memory device deteriorates. we also added the feature to emulate the wait for a fixed time when an FS conflict occurs with the BOSS library in the background.

Note 128-14: (FS) Added the `nn::fs::GetExtSaveDataFormatInfo` function [SDK]

Gets the format information for expanded save data. The information that can be obtained is the maximum number of files and directories specified when formatting.

Note 128-15: (FS) Added the `nn::fs::GetSaveDataFormatInfo` function [SDK]

Added the nn::fs::GetSaveDataFormatInfo function to get save data's format information.
The available information is the maximum number of files and directories specified at formatting and the flag for whether automatic redundancy is applied to the entire save data region.

Note 128-16: (FS) Support for release builds for `nn::fs::hio` and the `HOST_IO` build option [SDK]

Made changes such that nn::fs::hio and the HOST_IO build option can be used in release builds.

Note 128-17: (FS) Increased access speed to expanded save data [SDK]

Improved the access speed for expanded save data.
For more details, see the separately released document, CTR Performance Tips.

Note 128-18: (GD) Added GD library [SDK | Sample Demos]

Added the new GD library as a graphics library.
Also added a sample demo that uses the GD library.
See the API Reference Manual for differences with the existing GL and GR libraries.

Note 128-19: (GR) Added the `RenderState::ShadowMap` class [SDK]

Added the RenderState::ShadowMap class to set the value of the 0x100 register.
The Shadow still remains, but we plan to abolish it in the future.

Note 128-20: (GR) Fixed a bug in `Shader::MakeOutAttrCommand` [SDK]

There was a bug in Shader::MakeOutAttrCommand_ which generates the output attribute commands when a reserved geometry shader (for example, point sprites) is used, including generic attributes.

Note 128-21: (GR) Added constructors for `Vertex` internal classes (`LoadArray`, `InterleaveInfo`, and `IndexStream`) [SDK]

Vertex::LoadArray, which is an internal class for Vertex, was revised from a structure to a class, and constructors were added for the following internal classes: Vertex::LoadArray, Vertex::InterleaveInfo, and Vertex::IndexStream. Changes were also made such that the minimum member variables are now initialized.

Note 128-22: (GR) Added functions to specify the vertex and geometry shaders within the shader binary used and to generate only the commands necessary when switching shaders [SDK]

Added the Shader::SetShaderIndex function to specify the vertex and geometry shader within the used shader binary, and the Shader::MakeShaderCommand function to generate only the commands necessary when switching the used shaders.

Note 128-23: (GR) Added `Vertex::LoadArray::DisableAll` and `Vertex::AttrConstArray::DisableAll` for internal use by `Vertex::DisableAll` to disable vertex attributes and initialize member variables [SDK]

Added the Vertex::LoadArray::DisableAll and Vertex::AttrConstArray::DisableAll methods to disable vertex attributes and initialize member variables, and made changes such that these methods, and not std::memset within the Vertex::DisableAll method which disabled all vertex attributes, will be used.

Note 128-24: (GX) Changed the PICA macro header [SDK]

Made the following changes to the PICA macro headers.

gxMacroTexture.h
Added PICA_DATA_TEXTURE0_SAMPLER_TYPE_FALSE to the enumerated type tag name PicaDataTexture0SamplerType
gxMacroMisc.h
Corrected errors in the API Reference Manual for PicaDataGasColorLutInput and PicaDataDepthTest2

Note 128-25: (MATH) Added the `One` function to `Vector2`, `Vector3`, and `Vector4` [SDK]

Added the One function that returns a vector, all of which elements are 1.0f, to the following classes: Vector2, Vector3 and Vector4.

Note 128-26: (MATH) Made the constructor explicit [SDK]

To curtail implicit type conversions which go against developers' intents, constructors with one argument defined for each class in the MATH library were made explicit.

Note 128-27: (OS) Changed `Thread::IsAlive` [SDK]

Made changes such that IsValid is also confirmed within IsAlive.

Note 128-28: (OS) Fixed a bug where the rounding mode was different outside of the main thread [SDK]

Fixed a bug where the rounding method for threads other than the main thread was not rounding to the nearest value for floating point numbers.

Note 128-29: (PTM) Revised so that functions for getting system information do not block [SDK | System Updater]

Since calling the GetAdapterState, GetBatteryLevel, and GetBatteryChargeState functions were blocked, changes were made such that they were not blocked.
As a result of these changes, once there has been an actual change in the remaining battery level, there will be at most a delay of ten seconds until the GetBatteryLevel function can get the changed value.
The values are immediately reflected after the change for the GetAdapterState and GetBatteryChargeState functions.

Note 128-30: (SND) Fixed a bug where noise would occur when using the biquad filter [SDK]

When using the biquad filter, sometimes noise would occur on large amplitude signals. This has been fixed.

Note 128-31: (SND) Added a parameter check for FxReverb [SDK]

Within nn::snd::FxReverb::SetParam, made revisions to check whether each of the variables for m_pFilterSize has a positive value.

Note 128-32: (SND) Added functions to increase the number of buffers at sound's final output stage [SDK]

Added the nn::snd::SetOutputBufferCount function to increase the number of buffers at sound's final output stage.

Note 128-33: (TOOL) Changed so that pressing the B Button in DevMenu now moves to the parent directory [SDK]

Made changes such that pressing the B Button while the SD Tab is displayed will take you to the parent directory.

Note 128-34: (TOOL) TWL system titles are not displayed in DevMenu [SDK]

Made changes such that TWL system titles are not displayed in DevMenu.

Note 128-35: (TOOL) System applications are not displayed in DevMenu [SDK]

Made it such that system applications are not displayed in DevMenu.

Note 128-36: (TOOL) Made small revisions to descriptions in DevMenu [SDK]

Made it such that the columns in the SD Tab can be sorted.
Also added a percentage indicator to the progress bar when importing.

Note 128-37: (TOOL) Fixed a bug where `DlpClient` would abort during a download [SDK]

There was a bug where DlpClient would occasionally abort if communications were interrupted during a download. This has been fixed.

Note 128-38: (TOOL) Improved the method of specifying files to exclude from ROMFS [SDK]

Added specifications to the RSF Reject parameters to allow for more flexible specification of files to exclude from ROMFS.
There is no change in operations when using the existing Reject parameters to specify files.
For details on the new specifications, see ctr_makerom.

Note 128-39: (TOOL) Added the `CardDevice` item to RSF [SDK]

Added the CardDevice field to RSF.
As a result of this change, applications that have None specified for BackupMemoryType will result in a warning when ctr_makerom is run as long as nothing appropriate is set for the CardDevice field.
For more information, see ctr_makerom.

Note 128-40: (TOOL) Added `SaveDataFiler` [SDK]

Added SaveDataFiler and a reference page for it.
SaveDataFiler is a tool that includes features for viewing, importing and exporting the save data on the CTR Card, and the expanded save data on the SD card.
For more details, refer to the CTR-SDK API reference.

Note 128-41: (TOOL) Updated `makebanner` [SDK]

Made the following modifications specific to makebanner.
・Corrected mistakes in the manual regarding makebanner and makeexbanner
・BannerModelConverter now supports NW4CForBanner
In step with this change, you now need .NET Framework version 3.5 or later to execute BannerModelConverter.

Note 128-42: (TOOL) Revised `makeciaarchive` [SDK]

Fixed a bug that resulted in a larger than usual CFA file size when --romfs-root was specified.

Note 128-43: (UBL) Revised the API Reference Manual [SDK]

Changed the phrasing of expanded save data to the system's NAND memory.
Also deleted the references to DevMenu from the Description of the Initialize function, as they were not needed.

Note 128-44: (UDS) Added functions to check whether networks found by scan are connectable [SDK]

Added API to confirm during scanning the state specified by a master using the uds::DisallowToConnect function.

Note 128-45: (UDS) Improved error checking when functions are executed in an uninitialized state [SDK]

Revised such that a check for completed initialization is performed for functions that can only be executed between the execution of the uds::Initialize function and the execution of the uds::Finalize function.

Known Issues with SDK 2.0.0 Release

In the GD LightingSample demo, you will see a phenomenon where the area the light is shining on will periodically flash.

■ CTR-SDK Version 2.0.0 System Updater

(2011/02/24)

Note 127-01: (AC) Changed the return value of the `Connect` function [System Updater]

The result returned when connection was completed indicated whether you could get on the Internet but this has been changed to return a simple success or failure only, and a separate API was added to confirm whether the network connection could get onto the Internet during a connection.

Note 127-02: (AC) Fixed a Wi-Fi station connection bug [System Updater]

Fixed a bug where you could not connect to Wi-Fi stations based on their SSIDs.

Note 127-03: (APPLET) Support for holding down the POWER Button during Sleep Mode [System Updater]

Until now, holding down the POWER Button during Sleep Mode did not result in the power turning off until the cover opened and the system woke up.
Made changes such that holding down the POWER Button was a main case for the system to wake up, and that the power would turn off without a need to open the cover.

Note 127-04: (APPLET) Fixed a bug where `SleepQueryCallback` would not be called even if the system was opened while writing to media [System Updater]

There was a bug where, because SleepQueryCallback was not called even if the cover was opened while writing to media, screen and sound recovery would not occur. This has been fixed such that SleepQueryCallback is called when the cover is opened.

Note 127-05: (APPLET) Fixed a bug where screen capture information would be overwritten during a transition [System Updater]

The capture information held by the system for a System Applet would be overwritten at capture when a Library Applet was started.
As a result, information on whether a 3D (3D screen) capture occurred becomes invalid, and in some cases different images are displayed on the right and left sides of the upper screen.
This was actually changed in CTR-SDK 0.14.22 but was accidentally omitted from the change log.

Note 127-06: (BOSS) Fixed a bug where task with response code 304 ("Not Modified") would return an error as the execution result [System Updater]

Fixed a bug where getting a task's execution result would obtain an error when the BOSS proprietary If-Modified-Since check returned an HTTP response code of 304 ("Not Modified") for NSD files of 200 KB or more.

Note 127-07: (BOSS) Fixed a bug that prevented BOSS storage from UnMounting [System Updater]

Fixed a bug where, if the GetNsDataHeaderInfo function was called for an invalid serial ID, any BOSS storage mounted within that would not be able to be unmounted.

Note 127-08: (BOSS) Fixed a bug where `Suspend` would take a lot of time if there were a large number of files in BOSS storage [System Updater]

Fixed a bug where Suspend would take a lot of time (it would take a lot of time to enter Sleep Mode even after closing the cover) when BOSS storage was full and there was a large number of files.

Note 127-09: (BOSS) Fixed the GetTaskInfo bug [System Updater]

Fixed a bug where you could not correctly get TaskPermission and LAST_MODIFIED_TIME via the GetTaskInfo function.

Note 127-10: (BOSS) Fixed a bug where `NsData::GetHeaderInfo` would not return [System Updater]

Fixed a bug where, if the NsData::GetHeaderInfo function was called at the same time as a data download, in rare instances you would not return from that function.

Note 127-11: (BOSS) Fixed a bug where tasks would end up running after `PauseAllTasks` was executed [System Updater]

Fixed a bug where, after the execution of the PauseAllTasks functions, tasks would end up running with a new infrastructure network connection as a trigger.

Note 127-12: (BOSS) Fixed a bug where a new application's tasks could not be registered if another application's database became full [System Updater]

Fixed a bug where a new application's tasks could not be registered when another application's database became full and the automatic delete operation that should have been performed on that application's information was not performed.

Note 127-13: (BOSS) Fixed a bug where data could not be downloaded after a task was determined successful when canceling a task [System Updater]

Fixed a bug where, if a task was canceled at a specific timing, the task would end up being handled as successful, and subsequent data downloads would not work.

Note 127-14: (BOSS) Fixed a bug where data was downloaded to inappropriate BOSS storage [System Updater]

Fixed a bug where, due to an exception error in an application's information database, download data would end up being downloaded to inappropriate BOSS storage.

Note 127-15: (BOSS) Fixed a bug where the same data was downloaded [System Updater]

Fixed a bug where an error in task execution resulted in the clearing of LastModifiedTime, such that the same data would end up being downloaded again the next time.

Note 127-16: (BOSS) Revised symptoms where task execution results would result in errors in environments where the signal strength was poor [System Updater]

There were cases where executed tasks would result in an error due to poor signal strength and tasks would not re-execute until the next execution time, but this has been revised such that in these cases the result will be retry, and the task will re-execute in a shorter time.

Note 127-17: (CAMERA) Fixed a bug where internal state inconsistencies would result during Applet transitions [System Updater]

There were bugs where the camera LED would either remain lit or else not light up at all because the camera state would not correctly be returned when performing Applet transitions (transitioning to the HOME Menu when pressing the HOME Button, for example) or when rapidly opening and closing the cover.

Note 127-18: (CAMERA) Fixed an issue where the camera image was shifted up and down [System Updater]

When opening and closing the cover and when transitioning to the HOME Menu, there were cases where a buffer error that should have occurred did not occur, and as a result there was the possibility that the camera image would shift up and down. This has been fixed.

Note 127-19: (CAMERA) Fixed a bug where the `Activate` function would always return `IsSleeping` when the system was rapidly opened and closed [System Updater]

Fixed a bug where, when the cover is rapidly opened and closed, the Activate function would always continue to return IsSleeping in the interval it took to close and open the cover once.

Note 127-20: (CAMERA) Fixed a bug where the cameras would lose synchronization when the system was rapidly opened and closed [System Updater]

Fixed a bug where the cameras would not synchronize even when calling the SynchronizeVsyncTiming function as part of the application's waking up process, because the waking up process was not executed when the cover was opened and closed rapidly.

Note 127-21: (DLP) Fixed a bug that resulted in a halt if the language code was set to `INVALID_LANGUAGE` [System Updater]

Fixed a bug that resulted in a halt on the CTR if Server::Initialize was called when the market was set to either Europe or the US and the language code was set to INVALID_LANGUAGE.

Note 127-22: (DLP) Simplified the state and events of the server at distribution [SDK | System Updater | Sample Demos]

SERVER_STATE_PREPARING_FOR_SYSTEM_DISTRIBUTION
SERVER_STATE_DISTRIBUTING_SYSTEM
SERVER_STATE_WAITING_RECONNECT
SERVER_STATE_PREPARING_FOR_TITLE_DISTRIBUTION
SERVER_STATE_DISTRIBUTING_TITLE

The events notified for server data distribution defined for the EventType enumerated type, shown below, have been gathered together into one event: EVENT_TYPE_SERVER_STATE_DISTRIBUTING.

EVENT_TYPE_SERVER_STATE_PREPARING_FOR_SYSTEM_DISTRIBUTION
EVENT_TYPE_SERVER_STATE_DISTRIBUTING_SYSTEM
EVENT_TYPE_SERVER_STATE_WAITING_RECONNECT
EVENT_TYPE_SERVER_STATE_PREPARING_FOR_TITLE_DISTRIBUTION
EVENT_TYPE_SERVER_STATE_DISTRIBUTING_TITLE

Note 127-23: (DevEnv) Fixed a bug where you could not return to the HOME Menu from the card removal error screen [System Updater]

Fixed a bug where a screen is displayed to instruct you to return to the HOME Menu if a card is removed while card-based software is running, you sometimes cannot return to the HOME Menu by pressing the HOME Button at this screen (the upper and lower screens will remain black).

Note 127-24: (FRIENDS) Fixed a bug where it would take a lot of time to get automatically online after disconnecting from an access point [System Updater]

Fixed a bug where it would take a lot of time to get automatically online again when reconnecting in a short period after disconnecting from an access point.

Note 127-25: (FRIENDS) Fixed a bug where you could not automatically get online when immediately reconnecting after disconnecting from an access point [System Updater]

Fixed a bug where you could not automatically get online, no matter how long you waited, when immediately reconnecting after disconnecting from an access point you were connected to.

Note 127-26: (FRIENDS) Fixed a bug where you could not automatically get online [System Updater]

Fixed a bug where you could not automatically get online with the Friend Presence feature after waking from the Sleep Mode, based on timing.

Note 127-27: (FS) Improved ROM access speed [System Updater]

Improved the ROM access speed.
For more details, see the separately released document, CTR Performance Tips.

Note 127-28: (FS) Fixed a bug where expanded save data was not correctly mounted after hot-swapping an SD card [System Updater]

Fixed a bug where, after hot-swapping an SD card and mounting expanded save data, even though the nn::fs::MountExtSaveData function returned nn::ResultSuccess, the process was insufficient, and attempts to access files, etc., within the archive after that would return the nn::fs::ResultArchiveInvalidated error.
This bug was registered in BOSS and elsewhere, and could occur when mounting expanded save data with the possibility of being accessed at the same time by other processes.

Note 127-29: (FS) Fixed a bug where the files were renamed with the name "." or ".." in save data or expanded save data [System Updater]

Fixed a bug where files with the name "." or ".." in save data or expanded save data would be renamed.

Note 127-30: (FS) Fixed a bug where files in save data or expanded save data would be renamed to a higher level directory [System Updater]

Fixed a bug where if you attempted to rename save data and expanded save data to a higher-level directory, everything under that directory was deleted.

Note 127-31: (FS) Improved save data access speed [System Updater]

Improved the save data access speed.
For more information about the improvements, see the separately released document, CTR Performance Tips.

Note 127-32: (FS) Guaranteed the values when creating save data files [System Updater]

When creating save data files with the nn::fs::TryCreateFile function, made changes such that we guarantee the first 512 bytes of the file (or all data of the file for smaller sized files) are filled with zeroes.

Note 127-33: (FS) Fixed a bug where a directory would become a file when interrupting the directory creation or renaming process [System Updater]

If you removed an SD memory card while creating or renaming a directory, the entry for what should have been a directory will end being one for a file, based on the timing of the removal. This has been fixed.

Note 127-34: (FS) Fixed a bug where the expanded save data root directory would be deleted or renamed [System Updater]

Fixed a bug where you could delete or rename the expanded save data's root directory.

Note 127-35: (FS) Guaranteed the values when creating expanded save data files [System Updater]

When creating expanded save data files with the nn::fs::TryCreateFile function, made changes such that we guarantee the first 512 bytes of the file (or all data of the file for smaller sized files) are filled with zeroes.

Note 127-36: (GX) Fixed a bug where `nngxIsStereoVisionAllowed` returns `true` when generating `hid::CTR::GyroscopeReader` [System Updater]

When generating hid::CTR::GyroscopeReader, nngxIsStereoVisionAllowed returned true even when the 3D depth slider was all the way down. This has been fixed.

Note 127-37: (GX) Fixed a bug where the screen would freeze black when executing `nngxFinalize` [System Updater]

Fixed a bug where the nngxFinalize call's timing would sometimes overlap that of VSync and in rare cases result in a system freeze.

Note 127-38: (HTTP) Fixed a bug resulting from `Cancel` directly after starting communication [System Updater]

Fixed a bug where, when Cancel was performed immediately after starting communication, other functions would not return a response for that communication.

Note 127-39: (MIC) Revised the `nn::mic::SetAmp` and `nn::mic::SetLowPassFilter` functions [System Updater]

There was a bug where sound processes were blocked for long periods of time when executing the nn::mic::SetAmp function (with a false argument) or when executing the nn::mic::SetLowPassFilter function (regardless of argument).
As a result, there would be losses of sound or short instances of noise heard. This has been fixed.

Note 127-40: (MIDI) Revised the UIC-MIDI driver [System Updater]

Revised the specifications such that at the same time the UIC-MIDI features are being used, a backup device can be accessed.

Note 127-41: (NDM) Fixed a bug where the autonomous operations of background communications would remain halted when in Wi-Fi disabled mode [System Updater]

Fixed a bug where background communication ceased to run autonomously if Wi-Fi was disabled at the same time as uds::Initialize, ac::Connect, ac::ConnectAsync, or dlp::Client::Initialize was called, even if Wi-Fi was subsequently enabled.

Note 127-42: (NDM) Fixed a bug where BOSS would not enter autonomous operations when the system was closed but the system was not in Sleep Mode [System Updater]

Fixed a bug where if Sleep Mode was rejected when the system is closed, BOSS ceased to run autonomously until the system either entered Sleep Mode or was opened.

Note 127-43: (OS) Fixed a bug where the debugger would hang when a forced break occurred during `event` execution [System Updater]

Fixed a bug where the debugger would hang when a forced break was applied for an application while an event was executing.

Note 127-44: (OS) Fixed a bug where the card removal error was displayed twice [System Updater]

Fixed a bug where, if the game card was removed using a specific procedure, the error screen would be displayed again after disappearing once after pressing the HOME Button when the card removal error display first appeared.

Note 127-45: (OS) Revised the display of debugger registers during hardware breaks and exceptions [System Updater]

Fixed a bug where there was an error in the displayed value of debugger registers during hardware breaks and exceptions.

Note 127-46: (OS) Fixed a bug that caused the debugger to hang up when the battery dropped to 0% [System Updater]

Fixed a bug where the debugger would hang when the battery reached 0%.

Note 127-47: (OS) Improved break point processing [System Updater]

Improved the execution time of debugger breakpoints.
To reflect this change you need to use debugger software from the 2010/12/22 version or later of PARTNER-CTR.

Note 127-48: (PL) Fixed a bug where the number of steps was not correctly recorded if recorded for more than seven consecutive days in compatibility mode [System Updater]

Fixed a bug where some or all of the steps recorded during compatibility mode would disappear when recording steps and using compatibility mode for seven or more days in a row.
Seven days worth of steps will be recorded from the start of compatibility mode.

Note 127-49: (PL) Fixed a bug in the pedometer history when repeatedly changing the time [System Updater]

Fixed a bug where the number of steps from before the time was changed would remain, for an interval in which there was no walking, when repeatedly changing the time.
With this fix, the bug where a number of steps from before the time was changed would remain, but would suddenly become zero, or some would remain, was also resolved.

Note 127-50: (PL) Fixed a bug where step count could not be saved for a maximum of one day if pedometer was left unused for more than eight days without increasing the step count [System Updater]

Fixed a bug where, regardless of whether the system had been turned on, if you left it alone for eight days without increasing the step count you would be unable to save up to one day's step count afterward.

Note 127-51: (PTM) Revised so that functions for getting system information do not block [SDK | System Updater]

Note 127-52: (SOCKET) Fixed a bug where `INFTIM` could not be used to specify a timeout for `Poll` [System Updater]

Fixed a bug where a fatal error would result when setting INFTIM for the timeout while continuing to specify the non-blocked mode's socket descriptor for Poll.

Note 127-53: (SOCKET) Fixed a bug where name resolution would always fail when setting a DNS server with a specific address [System Updater]

Fixed a bug where name resolution always failed when the DNS server address, either distributed by DHCP or set manually, was between x.x.x.224 and x.x.x.239.

Note 127-54: (TOOL) Changed System Updater specifications [System Updater]

Made the following changes to System Updater:

Changed to provide a System Updater for each region.
As part of this change, removed RegionSelector.
Made changes such that CIA files included in the Home Menu package can be imported.
Changed menus to make Test Menu (for development) and HOME Menu selectable.
These can also be changed using the Config tool after applying System Updater.
Made changes such that the Config tool can be imported.
Made changes such that system initialization will not occur.

Note 127-55: (UDS) Fixed a bug where the `ResultInvalidNode` error would not be returned even when specifying a node ID not found by the `GetNodeInformation` function [System Updater]

Fixed a bug where the ResultInvalidNode error would not be returned even when specifying a node ID that does not exist in the GetNodeInformation function.

Note 127-56: (UDS) Fixed a bug where UDS functions would be unable to complete when you transitioned to wireless disabled mode or when you suddenly entered Sleep Mode during UDS communications [System Updater]

During UDS communication, particularly while executing a process to transition a state with the CreateNetwork function, etc., and when transitioning to wireless disabled mode or entering Sleep Mode, a deadlock would occur within the system, and any subsequently executed functions might not complete. This has been fixed.

Note 127-57: (UDS) Fixed a bug affecting the connectivity for the last device, when the number of connected devices is equal to maximum number of connections specified by the master.[System Updater]

When the same number of devices that the master has specified as the maximum number for connections has connected, the last device, which should be allowed to successfully connect, is determined to fail to connect. This has been fixed.

Note 127-58: (UDS) Fixed a bug where UDS processes would no longer work when you transitioned to wireless disabled mode at a specific time [System Updater]

Fixed a bug where the ConnectNetwork function would no longer complete when transitioning to wireless disabled mode at some point in the timing when a client was attempting to connect to the network.

Note 127-59: (UDS) Fixed a bug where Client/Spectator disconnection could not be performed correctly when signal status was poor [System Updater]

Fixed a bug where clients would not correctly handle disconnection when signal quality was extremely poor and there was a large volume of communication data.

Known Issues with System Updater in SDK Version 2.0.0

Once REPLY_LATER has been returned to a SleepQuery issued because the system was closed (or for some other reason), if a card is removed before REPLY_ACCEPT or REPLY_REJECT is returned the system will no longer be able to enter Sleep Mode.
In some extremely rare cases the screen will stay black after the system is closed and opened. Only rendering cannot be restored properly: sound output, button input, and other features run normally.
Closing and opening the system again resolves this issue. This same issue can also be caused by applications, depending on how they are implemented. If this happens with your application, make sure that your application's implementation does not have any possible sequence or timing in which rendering might not recover after awakening from sleep.
The following bugs have been found with the file system.

If the MountSdmc or MountExtSaveData functions have not succeeded and the GetSdmcSize function is called, an error (NotFound) is returned.
* If a file is accessed as a directory or vice versa, an unexpected Result (DESCRIPTION_FAT_BROKEN_ENTRY or DESCRIPTION_INVALID_PATH_FORMAT) is sometimes returned.
* Even though you can create a directory with "..." in its name on an SDMC archive, an error (OperationDenied) is returned when you attempt to delete it.

If a card's save data is in an invalid format, you should be able to run nn::fs::FormatSaveData to put the save data into a normal state, but in some rare cases the invalid format is not cleared up even if FormatSaveData itself returns ResultSuccess.
When you format the save data of a card that has been intentionally tampered with, the data is sometimes not formatted correctly even if the return value indicates success. In this case, Mount will fail and return BadFormat or MediaAccessError immediately after Format or after several files have been created.
In very rare cases, a fatal error occurs during infrastructure or background communication. The following error values are displayed at this time.

0xF9606C0F Level:-1 Summary:11 Module:27 Desc: 15
0xF9606C11 Level:-1 Summary:11 Module:27 Desc: 17
0xF9606C04 Level: -1 Summary:11 Module:27 Desc: 4

On very rare occasions a fatal error occurs while carrying out local communication (UDS or DLP).

0xF9606C10 Level: -1 Summary:11 Module: 27 Desc: 16

■ CTR-SDK Version 2.0.0 Sample Demos

(2011/02/24)

Note 126-01: (BOSS) Removed CA certificate setting code [Sample Demos]

Since the necessary CA certificate is now automatically set in the BOSS library when registering NADL tasks, the unnecessary CA settings code has been removed from the sample demo.

Note 126-02: (CEC) Added StreetPass sample demo. [Sample Demos]

Added the cec_demo2 sample demo that supports screen display.

Note 126-03: (DLP) Simplified the state and events of the server at distribution [SDK | System Updater | Sample Demos]

SERVER_STATE_PREPARING_FOR_SYSTEM_DISTRIBUTION
SERVER_STATE_DISTRIBUTING_SYSTEM
SERVER_STATE_WAITING_RECONNECT
SERVER_STATE_PREPARING_FOR_TITLE_DISTRIBUTION
SERVER_STATE_DISTRIBUTING_TITLE

The events notified for server data distribution defined for the EventType enumerated type, shown below, have been gathered together into one event: EVENT_TYPE_SERVER_STATE_DISTRIBUTING.

EVENT_TYPE_SERVER_STATE_PREPARING_FOR_SYSTEM_DISTRIBUTION
EVENT_TYPE_SERVER_STATE_DISTRIBUTING_SYSTEM
EVENT_TYPE_SERVER_STATE_WAITING_RECONNECT
EVENT_TYPE_SERVER_STATE_PREPARING_FOR_TITLE_DISTRIBUTION
EVENT_TYPE_SERVER_STATE_DISTRIBUTING_TITLE

Note 126-04: (GD) Added GD library [SDK | Sample Demos]

Added the new GD library as a graphics library.
Also added a sample demo that uses the GD library.
See the API Reference Manual for differences with the existing GL and GR libraries.

Note 126-05: (GR) Added the `Silhouette` demo that performs silhouette rendering using reserved geometry shaders [Sample Demos]

Added the Silhouette demo that performs silhouette rendering using reserved geometry shaders.

Note 126-06: (GX) Revised so that the unnecessary commands are not generated when the rendering function is the `glDrawElements`in demos that directly generate 3D commands [Sample Demos]

Since the 0x253[0:0] register is initialized to 0x0 during nngxInitialize for the demos that directly generate 3D commands (TriangleSimpleCmd and FragmentLightingSimpleCmd), changes were made to not generate unnecessary commands that would write 0x0 to register 0x253[0:0] for every frame when the rendering API was glDrawElements.

Note 126-07: (GX) Deleted the definitions of unused constant registers in vertex shaders for the DMPGL sample demos [Sample Demos]

Deleted the definitions of unused constant registers in vertex shaders for the DMPGL sample demos.

Note 126-08: (GX) Added a feature in the demo that edits the parameters of a procedural texture to display a gradation bar for the alpha color [Sample Demos]

In the ProcTexEditor demo that edits that parameters of procedural textures, a change was made to display a gradation bar for the alpha color.
It displays the alpha color lookup table in RGBA shared mode and the Fa lookup table in alpha independent mode.

Known Issues with SDK 2.0.0 Sample Demos

When starting demo1 from the HOME Menu, and accessing save data using the A + X Buttons, if you then press the HOME Button there is a high probability that the demo will freeze.
In the DLP SimpleServer server, a DUP cannot be run because an update archive cannot be attached.

■ CTR-SDK Version 1.1.0 Release

(2011/02/15)

Note 125-01: (CAMERA) Revised the `SetReceiving` API reference [SDK]

The reference for how to use handles with SetReceiving was revised.

Note 125-02: (CFG) Added a function for verifying PIN numbers for Parental Controls [SDK]

The CheckParentalControlPinCode function was added for verifying Parental Controls PIN codes.
Plans call for removing the GetParentalControlPinCode function used to get the PIN code.
Be sure to use the CheckParentalControlPinCode function to verify PIN codes.

Note 125-03: (DLP) Changed the specifications of the `FakeClient::StartScan` function [SDK | Sample Demos]

Because old specifications of the FakeClient::StartScan function allowed developers to specify a wireless channel when they should not have been able to, a FakeClient::StartScan function that does not allow wireless channel specification has been prepared.
This function automatically scans all scannable channels.
Use this function from now on.
Also, use of the FakeClient::GetChannels functions, used to get scannable channels, is prohibited.

Although the FakeClient::GetChannels function and the FakeClient::StartScan function that allows wireless channel specification can be accessed to maintain mutual compatibility, use the new functions so that unnecessary problems do not arise.

Note 125-04: (DLP) Fixed a bug where user names were not NULL-terminated [SDK]

Fixed a bug where node user name strings were not NULL-terminated when the string was 10 characters long.
With this change, the NodeInfo user names obtained by the following functions now always include NULL at the end (11th character).

nn::dlp::FakeClient::GetServerInfo
nn::dlp::FakeClient::GetNodeInfo

Note 125-05: (DevEnv) Addressed symptoms treated as specifications [SDK]

A document about symptoms that are handled as specifications under CTR-SDK 1.x has been added to $CTR_SDK/documents/knownIssues.html.

Note 125-06: (FND) Added an interface for returning the number of blocks already allocated for the unit heap [SDK]

An interface for returning the number of blocks already allocated for the unit heap has been added.

Note 125-07: (FS) Revised the error return value when mounting an archive of the same name [SDK]

There was a bug where nn::fs::ResultOutOfMemory was being returned as an error when mounting a new archive using a name already registered.
This has been revised so that nn::fs::ResultAlreadyExists is returned.

Note 125-08: (GX) Revised the default settings of `dmp_FragmentLightSource[i].position` and `dmp_FragmentLightSource[i].spotDirection` [SDK]

A bug has been fixed where the default settings for the reserved uniforms, dmp_FragmentLightSource[i].position and dmp_FragmentLightSource[i].spotDirection, did not match the specification manual.

Note 125-09: (GX) Added `NN_GX_CMDLIST_GAS_UPDATE` to the `nngxSetCmdlistParameteri` function [SDK]

pname has been newly added for making settings related to updating additive blend results for rendering gas density information.

Note 125-10: (GX) Added the new `nngxSwapBuffersByAddress` function [SDK]

The nngxSwapBuffersByAddress function has been added. This function can specify the address of a buffer to be directly swapped without using a display buffer object.

Note 125-11: (NGC) Revised default settings related to the stencil test [SDK]

When using the glStencilFunc function for stencil tests, the default setting for the func argument differed in terms of the state on the driver and the value in the GPU register.
Although the state was GL_ALWAYS as per specifications, the register value was GL_NEVER. If glStencilFunc(GL_ALWAYS, 0, ~0) was specified, this would lead to a bug where operation would advance using GL_NEVER without updating the value of the register to match the actual state.
This bug has been fixed.

Note 125-12: (GX) Updated documentation [SDK]

The following graphics-related documentation was updated.

$CTR_SDK/documents/DMPGL20/DMPGL20_specification.pdf

Deleted DMP_subdivision0.obj because it was determined there was a risk it could lead to illegal operations
Added a description of additive blend D2 when rendering gas density information
Added a supplement about periodicity in random number generation for procedural textures

$CTR_SDK/documents/DMPGL20/DMPGL20_programming_guide.pdf

Changed the default value of dmp_LightEnv.lutEnabledRefl from GL_TRUE to GL_FALSE
Added a description of a problem where block-shaped noise is being rendered for certain pixels
Added a supplement about noise settings for procedural textures
Added the fact that rendering is not being performed correctly if the viewport size is larger than 1023x1016
Added the fact that the early depth test is not being performed correctly if a viewport offset is used

$CTR_SDK/documents/DMPGL20/DMPGL20_system_API_specification.pdf

Added a detailed description of the value of NN_GX_CMDLIST_HW_STATE
Added a supplement about the registers, 0x0af[11:8], 0x126[25:24], 0x1c0, and 0x229[1:0]
Deleted unnecessary register settings listed for the reserved geometry shader
Revised the description of clearing the framebuffer cache
Revised the description of color buffer address alignment
Added NN_GX_CMDLIST_GAS_UPDATE to the nngxSetCmdlistParameteri function
Added the new nngxSwapBuffersByAddress function
Deleted the RGBA8 format from the display buffer

$CTR_SDK/documents/DMPGL20/VertexShaderReferenceManual.pdf

Added a description of the performance check feature of the shader linker
Revised swizzling by the mad instruction and changed the upper limit on the number of masking patterns from 64 to 32
Fixed typos related to instructions that cannot be consecutively called
Added information about shader implementations that can lead to undefined operations
Added a supplemental description of swizzling

Note 125-13: (GX) Updated the reserved geometry shader [SDK]

The reserved geometry shader has been updated as follows.

Registers have been relocated and unnecessary constant register definitions inside each shader have been deleted
Deleted subdivision0.obj because there was a risk it would lead to undefined operations

Note 125-14: (GX) Fixed a bug with the `glShaderBinary` function that would occur under specific conditions [SDK]

Fixed a bug where an error was illegally generated by the glShaderBinary function when specifying a generic attribute for the eighth or later attribute in the definition of a #pragma output_map statement in the shader assembler.

Note 125-15: (SND) Fixed a bug related to assert failures [SDK]

Fixed a bug where the Sender::Cancel function would sometimes result in an assert failure if signal reception was poor, regardless of whether the build was a Release build.
Also, code was revised so that the ASSERT macro of the RDT library is disabled for Release builds.

Note 125-16: (SND) Fixed a bug when using `AllocVoice` where NULL would return and then the sound thread would stop [SDK]

Fixed a bug that would occur when calling AllocVoice from a thread other than a sound thread where the function would return NULL and then the sound thread would stop.
This bug did not occur in CTR-SDK 0.14.23 or earlier.

Note 125-17: (SND) Fixed a bug causing noise when using linear interpolation [SDK]

Fixed a bug found in CTR-SDK 1.0 where noise would arise in segments without any sound when specifying INTERPOLATION_TYPE_LINEAR in a call to nn::snd::Voice::SetInterpolationType.
This bug did not occur in CTR-SDK 0.14.23 or earlier.

Note 125-18: (TOOL) Added a feature for selecting menus to the Config tool [SDK]

A feature has been added so that Config tool can be used to select the menu to be started when power is turned on or when performing debugger reset. Up until this version, this menu could only be selected using MenuSelector.csu.
For more information, see the documentation for the Config tool.

Note 125-19: (TOOL) Added a binary for save data that generates `nn::fs::ResultVerificationFailed` [SDK]

A binary so the nn::fs::MountSaveData function returns nn::fs::ResultVerificationFailed has been added to $CTR_SDK/tools/TargetTools/CTR-TS.
Be sure to write it to a backup device using PARTNER-CTR and use it.

Note 125-20: (TOOL) Added a feature for outputting a warning when conditions leading to hardware bugs are violated when using the shader [SDK]

The shader assembler and shader linker now output a warning if an attempt is made to use a shader implementation described in 2.10. Shader Implementations that Cause Invalid Operations added to $CTR_SDK/documents/DMPGL20/VertexShaderReferenceManual.pdf under this version.

Note 125-21: (TOOL) Added a feature for measuring shader performance [SDK]

A feature has been added for detecting instructions that cause stalling and a feature that estimates the number of clocks required per vertex when executing from a shader assembler implementation specified as an option to ctr_VertexShaderLinker32.exe.
These features are disabled by default.
For more information, see $CTR_SDK/documents/DMPGL20/VertexShaderReferenceManual.pdf.

Note 125-22: (UDS) Fixed a bug where user names obtained using the `NetworkDescriptionReader::GetNodeInformationList` function were not being NULL-terminated [SDK]

Fixed a bug where strings were not NULL-terminated if the username string was 10 characters long when getting the username by calling NetworkDescriptionReader::GetNodeInformationList, and when scanning after turning the power on and UDS communication had been carried out even once, including by another application.

Known Issues with SDK 1.1.0 Release

The GetNodeInformation function in the UDS library gives a Result value indicating success even when a nonexistent node ID is specified.

■ CTR-SDK Version 1.1.0 Sample Demos

(2011/02/15)

Note 124-01: (CAMERA) Revised the Stereo demos [Sample Demos]

Added support for the POWER Button and HOME Menu button to the camera/Stereo demo.
Also, the following bugs associated with this demo were fixed.

Could not perform retry for the nn::camera::Activate function if the system was opened and closed repeatedly
If the system was closed while configuring the cameras, two buffers for images would be allocated upon retry

Note 124-02: (DLP) Changed the specifications of the `FakeClient::StartScan` function [SDK | Sample Demos]

Note 124-03: (DLP) Fixed a bug where the `SimpleServer` would not run except in the JP market [Sample Demos]

Fixed a bug where SimpleServer would not operate outside the JP region.
This was because the JP market had been set for the Child_0 icon. The icon was changed to support all markets.

Note 124-04: (DevEnv) Switched electronic manuals for samples [Sample Demos]

The data format used in the electronic manual included with demo1 was old and could not be displayed, so it was replaced with the most recent data.

Note 124-05: (DevEnv) Added sample demo references [Sample Demos]

A description of sample demos was added under $Sample Demos/documents.

Note 124-06: (FS) Fixed a bug with the `FragmentLightSimpleCmd` sample demo [Sample Demos]

Fixed a bug in the demo1 code that used a non-Try function for save data, by changing the code to determine results using a Try function.

Note 124-07: (GX) Added a `ProjectionTexture` sample [Sample Demos]

The sample, gx/DMPGL/ProjectionTexture, for procedural textures was newly added.

Note 124-08: (GX) Revised how functions used with `demo1` save data are used [Sample Demos]

Fixed a bug where register 0x149 was not set correctly in relation to the value of position w for Light 0.
This bug was addressed in the CTR-SDK 1.1 graphics driver update.

Note 124-09: (HID) Added a gyro demo [Sample Demos]

The sample demo gyroscope, for using the gyro, was added.

Note 124-10: (TPL) Fixed a bug with the `ReadTexturePackage2` demo [Sample Demos]

Fixed a bug where incorrect mipmap settings were used by the ReadTexturePackage2 demo.

Known Issues with SDK 1.1.0 Sample Demos

None.

■ CTR-SDK Version 1.0.0 Release

(2011/01/25)

Note 123-01: (CEC) Removed version of `nn::cec::MessageBox::CreateMessageBox` function that does not specify icon data [SDK]

Removed the version of the nn::cec::MessageBox::CreateMessageBox function that does not specify icon data, since there is no need to use it.

Note 123-02: (CEC) Revised the API Reference Manual [SDK]

Added the following to the CEC library API reference.

MessageBox Class Error Handling
Precautions when Implementing MessageBox::OpenMessageBox

Also removed descriptions of the MessageBoxInfoReader class, since this class is not supported.
Also see the Programming Manual for details on how to implement.

Note 123-03: (FS) Fixed a bug causing verification failure on loading from ROM [SDK]

Fixed a bug that would rarely cause verification to fail when reading from a file or directory opened from an archive mounted using MountRom, with the function returning a Result of type nn::fs::ResultVerificationFailed.

Note 123-04: (GR) Changed `Shader::SetDrawMode` function to support `GL_TRIANGLE_STRIP` and `GL_TRIANGLE_FAN` when in triangle render mode [SDK]

Changed the gr::Shader class to support GL_TRIANGLE_STRIP and GL_TRIANGLE_FAN when in triangle render mode.

Note 123-05: (GR) Changed member function that generates commands to a `const` member function for the `gr::Viewport`, `gr::Scissor`, and `gr::Shadow` classes [SDK]

Changed the gr::Viewport::MakeCommand, gr::Scissor::MakeCommand, and gr::Shadow::MakeCommand member functions to be const member functions.

Note 123-06: (GR) Changed all `private` member variables to `protected` member variables [SDK]

Changed all private member variables in the library to protected member variables.

Note 123-07: (GR) Fixed a bug in command to set register `0x85` to the physical address of a cube map's +X plane [SDK]

Fixed a bug in the Texture::Unit0::MakeCommand function when generating the command to set register 0x85 to the physical address of a cube map's +X plane.

Note 123-08: (GR) Added function and class methods to disable graphics settings [SDK]

Added the gr::MakeDisableAllCommand function and other class methods to generate 3D commands to disable graphics settings (such as shader modes, vertex attributes, fog, fragment lighting, textures, and render states).

Note 123-09: (GR) Added methods to generate fragment lighting light source color information commands and geometric information commands [SDK]

Added the FragmentLight::Source::MakeColorCommand function to generate fragment lighting light source color information commands, and the FragmentLight::Source::MakeGeometryCommand function to generate geometric information commands.

Note 123-10: (GX) Fixed a bug in fragment light shadow attenuation commands [SDK]

Fixed a bug in the FragmentLight::MakeLightEnvCommand function causing miscalculation of the value in the register corresponding to the dmp_FragmentLightSource[i].shadowed uniform.

Note 123-11: (GR) Added methods to configure lookup table commands when input values are `[0.0, 1.0]` or `[-1.0, 1.0]` [SDK]

Added the LookUpTable::SetAbsTable method to configure lookup table commands when the input value is [0.0, 1.0], and the LookUpTable::SetNotAbsTable for when the input value is [-1.0, 1.0].
The LookUpTable::SetTable function is kept for compatibility purposes, and this now calls the LookUpTable::SetAbsTable function internally by default.

Note 123-12: (GR) Added default argument to configure the last difference value of a lookup table [SDK]

Added a default argument for the last difference value of a lookup table to the LookUpTable::SetTable, Fog::SetTable, ProcedureTexture::SetNoiseLookUpTable, ProcedureTexture::SetRgbMapLookUpTable, and ProcedureTexture::SetAlphaMapLookUpTable functions.
This default value is 0.0f.

Working memory region alignment
No need to split threads
Maximum number of threads that can be checked at once

Note 123-16: (SND) Fixed a bug where the `Voice` object obtained from `AllocVoice` was sometimes not initialized [SDK]

Fixed a bug where the Voice object obtained from AllocVoice was sometimes not initialized.

Note 123-17: (SND) Fixed a bug causing infinite loop when calling `applet::ProcessPowerButton` or `applet::ProcessHomeButton` when there is no sound thread [SDK]

Fixed a bug causing an infinite loop when calling the apple