1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META http-equiv="Content-Style-Type" content="text/css">
6	<TITLE>nwc24errgen Tool</TITLE>
7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
8<LINK rel="stylesheet" type="text/css" href="../nwc24.css">
9</HEAD>
10<BODY>
11
12<h1>nwc24errgen</h1>
13
14<h2>Introduction</h2>
15
16<P>
17The <CODE>nwc24errgen</CODE> tool is used to assist in the implementation of error processing for applications that use WiiConnect24. This tool can generate several error states related to message boxes.
18</P>
19
20<H2>Running the Tool</H2>
21<p>
22Change to the <code>$REVOLUTION_EXT_ROOT/RVL/bin/tools</code> directory and run the <code>ndrun</code> script with the <code>nwc24errgen[D].elf</code> file as an argument.</p>
23
24<H2>Using the Tool</H2>
25
26<P>
27Operations can be performed using either the Wii Remote or the Nintendo GameCube controller.
28</P>
29
30<P>
31<TABLE border="1">
32  <TBODY>
33    <TR>
34      <TD width="120">Confirm</TD>
35      <TD width="520">A Button</TD>
36    </TR>
37    <TR>
38      <TD width="120">Cancel</TD>
39      <TD width="520">B Button</TD>
40    </TR>
41    <TR>
42      <TD width="120">Move Cursor</TD>
43      <TD width="520">+Control Pad - Up/Down/Left/Right</TD>
44    </TR>
45    <TR>
46      <TD width="120">Return to the Wii Menu</TD>
47      <TD width="520">HOME (START/PAUSE)</TD>
48    </TR>
49  </TBODY>
50</TABLE>
51</P>
52
53<H2>Menu Items</H2>
54
55<DL>
56  <DT>Initialize the send box</DT>
57  <DD><P>
58  Initializes the outbox.<BR> <BR>If the inbox is corrupted, this will also initialize the inbox.
59  </P></DD>
60  <DT>Initialize the recv box</DT>
61  <DD><P>
62  Initializes the inbox.<BR> <BR>If the outbox is corrupted, this will also initialize the outbox.
63  </P></DD>
64  <DT>Break the send box</DT>
65  <DD><P>
66  Puts the outbox into a corrupted state.<BR> <BR> If the application runs the <CODE><A HREF="../Misc/NWC24OpenLib.html">NWC24OpenLib</A></CODE> function in this state, <CODE>NWC24_ERR_BROKEN</CODE> will be returned and the function will fail.
67  </P></DD>
68  <DT>Break the recv box</DT>
69  <DD><P>
70  Puts the inbox into a corrupted state.<BR> <BR> If the application runs the <CODE><A HREF="../Misc/NWC24OpenLib.html">NWC24OpenLib</A></CODE> function in this state, <CODE>NWC24_ERR_BROKEN</CODE> will be returned and the function will fail.
71  </P></DD>
72  <DT>Fill the send box</DT>
73  <DD><P>
74  Fills the outbox completely.<BR> <BR> If, in this state, the application runs the <CODE><A HREF="../Misc/NWC24Check.html">NWC24Check</A></CODE> function with <CODE>NWC24_USE_MESSAAGES</CODE> as an argument, <CODE>NWC24_ERR_FULL</CODE> will be returned.<BR> The packed-in messages have special settings that cause them to remain unsent even if time has elapsed. Initialize the outbox to return it to its original state. (Any messages present in the outbox before this command was run will be sent as usual.)
75  </P></DD>
76  <DT>Post a broken msg to the recv box</DT>
77  <DD><P>
78Stores a single message with corrupted content in the inbox.<BR><BR> It is possible to specify the message type (either <CODE>MSGTYPE_WII_APP</CODE> or <CODE>MSGTYPE_WII_APP_HIDDEN</CODE>) and the application ID for the message. <BR>If an application attempts to load the message created here, the <CODE>NWC24ReadMsg*</CODE> functions will return an error and fail.<BR>
79  </P></DD>
80</DL>
81
82<H2>Revision History</H2>
83<P>
842008/12/11 Added description related to specifying the message type. <BR> 2008/05/01 Initial version.<BR>
85</P>
86