WiiConnect24 Programming Manual Ver sion 1.2.2 The content of this document is highly confidential and should be handled accordingly. 2007 -2009 N intendo RVL -06 -0271 -001 -D CONFIDENTIAL Released : February 16, 2009 WiiConnect24 Programming Manual Confidential These coded instructions, statements, and computer programs contain proprietary information of Nintendo and/or its licensed developers and are protected by national and international copyright laws. They may not be disclosed to third parties or copied or duplica ted in any form, in whole or in part, without the prior written consent of Nintendo. RVL -06 -0271 -001 -D 2 2007 -2009 N intendo Released : February 16, 2009 CONFIDENTIAL WiiConnect24 Programming Manual Table of Contents 1 Introduction ................................ ................................ ................................ ................................ ................... 8 1.1 Requirements ................................ ................................ ................................ ................................ ........ 8 1.2 RevoEX (Revolution SDK Extensions) ................................ ................................ ................................ .8 1.2. 1 Preparing the Development Environment ................................ ................................ ..................... 8 1.2.2 Using the Wii Menu ................................ ................................ ................................ ....................... 8 1.2.3 Configuration Procedures to Use the Communication Fea tures ................................ ................... 9 1.2.4 Support Codes and Errors ................................ ................................ ................................ ............. 9 1.2.5 Cautions for Configuration Items That Limit Use of Communication Features ............................. 9 2 Structure of the WiiConnect24 System ................................ ................................ ................................ ....... 10 2.1 NWC24 Firmware (Subsystems) ................................ ................................ ................................ ........ 10 2.2 NWC24 Library ................................ ................................ ................................ ................................ ... 10 2.3 NWC24 and Wii Console NAND Memory ................................ ................................ ........................... 10 2.3.1 NWC24 System Files ................................ ................................ ................................ .................. 10 2.3.2 NWC24 User Files ................................ ................................ ................................ ....................... 11 2.4 Wii Menu and Wii Message Board ................................ ................................ ................................ ...... 11 3 NWC24 Library ................................ ................................ ................................ ................................ ........... 12 3.1 Notes for Designing Applications ................................ ................................ ................................ ........ 12 3.2 Opening and Closing the NWC24 Library ................................ ................................ ........................... 12 3.2.1 Opening the NWC24 Library ................................ ................................ ................................ ....... 14 3.2.2 Closing the NWC24 Library ................................ ................................ ................................ ......... 15 3.3 Checking the NWC24 System’s Operational Stat e................................ ................................ ............. 15 4 Messages ................................ ................................ ................................ ................................ .................... 17 4.1 Initializing the Message API ................................ ................................ ................................ ................ 17 4.2 Creat ing Messages ................................ ................................ ................................ ............................. 17 4.3 Obtaining the Message List ................................ ................................ ................................ ................ 20 4.4 Viewing Messages ................................ ................................ ................................ .............................. 22 4.4.1 Obtaining the Sender ................................ ................................ ................................ .................. 22 4.4.2 Obtaining the Recipient ................................ ................................ ................................ ............... 23 4.4.3 Obtaining the Subject ................................ ................................ ................................ .................. 25 4.4.4 Obtaining the Creation Time and Date ................................ ................................ ........................ 26 4.4.5 Obtaining the Body Text ................................ ................................ ................................ .............. 26 4.4.6 Obt aining the Attached Binary Data ................................ ................................ ............................ 28 4.4.7 Obtaining Miscellaneous Information ................................ ................................ .......................... 29 4.5 Deleting Messages ................................ ................................ ................................ ............................. 29 4.6 Searching for Messages ................................ ................................ ................................ ..................... 30 5 Downloading ................................ ................................ ................................ ................................ ............... 34 2007 -2009 N intendo 3 RVL -06 -0271 -001 -D CONFIDENTIAL Released : February 16, 2009 WiiConnect24 Programming Manual 5.1 Splitting Usage with the RVL DWC( -DL ) Library ................................ ................................ ................ 34 5.1.1 Content Size Restrictions ................................ ................................ ................................ ........... 34 5.1.2 Immediacy ................................ ................................ ................................ ................................ ... 35 5.2 Terminology and Overview ................................ ................................ ................................ ................. 35 5.2.1 Download Task ................................ ................................ ................................ ............................ 35 5.2.2 Download Task List ................................ ................................ ................................ ..................... 35 5.2.3 Download Box ................................ ................................ ................................ ............................. 36 5.2.4 Download Signature ................................ ................................ ................................ .................... 36 5.3 Download Task Configuration Items ................................ ................................ ................................ ... 36 5.3.1 URL ................................ ................................ ................................ ................................ ............. 36 5.3.2 Update Verification Interval ................................ ................................ ................................ ......... 37 5.3.3 Priority ................................ ................................ ................................ ................................ ......... 37 5.3.4 Download Count ................................ ................................ ................................ ......................... 37 5.3.5 File Name ................................ ................................ ................................ ................................ .... 37 5.3.6 Server Side Update Interv al ................................ ................................ ................................ ........ 38 5.3.7 Retry Margin ................................ ................................ ................................ ............................... 38 5.3.8 Flag ................................ ................................ ................................ ................................ ............. 38 5.4 Configuration Item s for Individual Applications ................................ ................................ .................. 39 5.4.1 Download Box ................................ ................................ ................................ ............................. 39 5.4.2 Public Keys and Shared Keys ................................ ................................ ................................ .... 39 5.5 Using the Download API ................................ ................................ ................................ ..................... 40 5.5.1 Initializing the Download API ................................ ................................ ................................ ...... 40 5.5.2 Obtaining Tasks ................................ ................................ ................................ ........................... 40 5.5.3