1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<META http-equiv="Content-Type" content="text/html; charset=utf-8">
6<META http-equiv="Content-Style-Type" content="text/css">
7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
8<title>HIO2 Demos</title>
9</head>
10
11<body>
12
13<h1>Host I/O (HIO2) Sample Demos</h1>
14
15<h2>Location</h2>
16
17<p><CODE>$REVOLUTION_SDK_ROOT/build/demos/hio2demo</CODE></p>
18
19<h2>Compilation</h2>
20<p>Each demo consists of two parts: the target side and the host side.</p>
21<p><font color="red">Microsoft Visual Studio 2005 or later is required to build an executable program for the host.</font></p>
22<h3>Target</h3>
23<p>Change directories to <CODE>$REVOLUTION_SDK_ROOT/build/demos/hio2demo</CODE> and enter &quot;make&quot;. The executable programs (<CODE>.elf</CODE> files) will be generated under <CODE>$REVOLUTION_SDK_ROOT/build/demos/hio2demo/bin/RVL/</CODE>.</p>
24
25<h3>Host</h3>
26<p>Change directories to <CODE>$REVOLUTION_SDK_ROOT/build/demos/hio2demo</CODE> and enter <CODE>make X86 = TRUE</CODE>. The executables (<CODE>.exe</CODE> files) will be generated under <CODE>$REVOLUTION_SDK_ROOT/X86/hio2demo/</CODE>. </p>
27<p>Pre-built sample programs are available under</p>
28<p><code>$REVOLUTION_SDK_ROOT/RVL/bin/demos/hio2demo/</code> (Target side)<br><code>$REVOLUTION_SDK_ROOT/X86/hio2demo/</code> (Host side)</p>
29<p>These files are overwritten when you compile the demos.</p>
30
31<h2>Execution</h2>
32<p>To run an application on the host side, move to <CODE>$REVOLUTION_SDK_ROOT/X86/hio2demo/</CODE> in the bash shell called from <CODE>RVL_NDEV.bat</CODE>, and execute the <CODE>.exe</CODE> file.</p>
33
34<p><strong>Note: </strong>This must be done because these programs use dll files in the <CODE>/X86/bin/</CODE> portion of the SDK install directories, and because path settings are made inside <CODE>RVL_NDEV.bat</CODE>. Note that applications cannot be started from Explorer if the path has not been configured.</p>
35
36<p>To run the target side application, go to <code>$REVOLUTION_SDK_ROOT/build/demos/hio2demo/bin/RVL/</code> and do one of the following:</p>
37
38
39<ul>
40<li>To simply run the application, execute the <code>ndrun</code> script, using the <code>.elf</code> file as an argument.</li>
41<li>If you want to debug with CodeWarrior, run <CODE>ide</CODE> with the <code>.elf</code> file as an argument.</li>
42</ul>
43
44<h2>Description</h2>
45<TABLE class="demo_list" border="1" >
46  <tr>
47<th><A href="simple.html">simple.exe/simple.elf</A></th>
48<td>Sample on using HIO2.</td>
49  </tr>
50  <tr>
51<th><A href="dual.html">dual.exe/dual.elf</A></th>
52<td>Demo for communicating between a single Wii console and a single PC.<br>The <CODE>dual</CODE> demo was designed to use EXI0 for communication from the NDEV to the PC via one channel, and MrEXI for communication from the PC to the NDEV via a separate channel. However, because the current hardware does not support transfers using EXI0, only unidirectional communication from the PC to the NDEV works.</td>
53  </tr>
54  <tr>
55<th><A href="multi.html">multi.exe/multi.elf</A></th>
56<td>Demo for communicating between multiple Wii consoles and a single  PC.<br>Although the <CODE>multi</CODE> demo is meant to work with multiple NDEV consoles connected to a single PC, at this time the demo has not been verified to operate when multiple NDEV units are connected.<br>When one NDEV is connected, the demo is meant to operate in the opposite way of <CODE>dual</CODE>: it uses EXI0 for communication from the PC to the NDEV, and MrEXI for communication from the NDEV to the PC. However, for the reason mentioned above, currently only unidirectional communication from the NDEV to the PC works.</td>
57  </tr>
58</TABLE>
59
60<h2>See Also</h2>
61<p class="reference">
62<a href="../list.html">Host I/O(HIO2) API</a>
63</p>
64
65<H2>Revision History</H2>
66<P>
672010/06/17 Added information about the <CODE>hio2demo</CODE> demos, <CODE>dual</CODE> and <CODE>multi</CODE>.<br>2008/07/22 Explicitly stated the compiler versions that can build a program for the host.<br>2006/04/07 Revised the description about starting the PC-side <CODE>hio2demo</CODE> program.<br>2006/03/01 Initial version.<br>
68</P>
69
70<hr><p>CONFIDENTIAL</p></body>
71</html>