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 name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<TITLE>WMTestTool</TITLE>
8<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
9<STYLE type="text/css">
10
11</STYLE>
12</HEAD>
13<BODY>
14<H1 align="left">WMTestTool</H1>
15<H2>Overview</H2>
16<code>WMTestTool</code> is a program made to test the TWL and DS wireless features. When the program is started, the MAC address is displayed in the lower portion of the screen. The MAC address is the value obtained with <a href="../os/ownerInfo/OS_GetMacAddress.html"><CODE>OS_GetMacAddress</CODE></a>. The following four items will be displayed on the main menu:
17<TABLE border="1" width="100%">
18  <TBODY>
19	<TR>
20<TD width="200"><B>Scan Test</B></TD>
21      <TD width="800">
22		Can perform a check on the GGID and TGID. <br> Uses <a href="../wm/wm/WM_StartScan.html"><CODE>WM_StartScan</CODE></a>. When using a wireless LAN access point, the SSID will be displayed in the GGID field.
23      </TD>
24    </TR>
25	<TR>
26<TD width="200"><B>ScanEx Test</B></TD>
27      <TD width="800">
28		Can perform a check on the GGID and TGID. <br> Uses <a href="../wm/wm/WM_StartScanEx.html"><CODE>WM_StartScanEx</CODE></a>. When using a wireless LAN access point, the SSID will be displayed in the GGID field.
29      </TD>
30    </TR>
31	<TR>
32<TD width="200"><B>MeasureChannel Test</B></TD>
33      <TD width="800">
34		Displays the usage rate of a designated channel. This rate will be a value from 0-100, and larger values indicate more crowding. <br> Uses <a href="../wm/wm/WM_MeasureChannel.html"><CODE>WM_MeasureChannel</CODE></a>.
35      </TD>
36    </TR>
37    <TR>
38<TD width="200"><B>Noise Mode</B></TD>
39      <TD width="800">
40		Transmits jamming on a designated channel. <br> Uses a command for non-public testing.
41      </TD>
42    </TR>
43  </TBODY>
44</TABLE>
45
46
47<H2>Scan Test</H2>
48Select items by pressing Up and Down on the +Control Pad. Pressing Left and Right on the +Control Pad will change the parameters. Start the scan by pressing the A Button, and end it with the B Button.
49<TABLE border="1" width="100%">
50  <TBODY>
51	<TR>
52<TD width="200"><B>Channel</B></TD>
53      <TD width="800">
54		When set to seek, this scans through channels 1, 7, and 13. <br> When a value between 1 and 13 is designated, only that channel will be searched. <br> However, even in that case the parent devices on a number of neighboring channels may be found.
55	  </TD>
56	</TR>
57	<TR>
58<TD width="200"><B>MaxChannelTime</B></TD>
59      <TD width="800">
60		Maximum amount of time to search on a single channel. <br> This time can be configured in the range of 10-300 milliseconds.
61	  </TD>
62	</TR>
63  </TBODY>
64</TABLE>
65
66<H2>ScanEx Test</H2>
67Select items by pressing Up and Down on the +Control Pad. Pressing Left and Right on the +Control Pad will change the parameters. Start ScanEx by pressing the A Button, and end it with the B Button.
68<TABLE border="1" width="100%">
69  <TBODY>
70	<TR>
71<TD width="200"><B>Channel</B></TD>
72      <TD width="800">
73		Designates a channel to scan. <br> When set to 1, 7, or 13, <CODE>0x1041</CODE> is configured to the channelList of <a href="../wm/wm/WMScanExParam.html"><CODE>WMScanExParam</CODE></a>. <br> When a value between 1 and 13 is designated, only that channel will be searched. However, even in that case the parent devices on a number of neighboring channels may be found. <br> When the ScanType is Active, all channels from 1 to 13 are designated.
74	  </TD>
75	</TR>
76	<TR>
77<TD width="200"><B>MaxChTime</B></TD>
78      <TD width="800">
79		Maximum amount of time to search on a single channel. <br> This time can be configured in the range of 10-300 milliseconds. <br> When the ScanType is Active, this value is fixed at 50 milliseconds.
80	  </TD>
81	</TR>
82	<TR>
83<TD width="200"><B>ScanType</B></TD>
84      <TD width="800">
85		Configures the ScanType. <br> Be aware that the DS parent device can only be found in Passive mode.
86	  </TD>
87	</TR>
88  </TBODY>
89</TABLE>
90
91<H2>MeasureChannel Test</H2>
92Select items by pressing Up and Down on the +Control Pad. Pressing Left and Right on the +Control Pad will change the parameters. Start MeasureChannel with the A Button, and end it with the B Button.
93<TABLE border="1" width="100%">
94  <TBODY>
95	<TR>
96<TD width="200"><B>Channel</B></TD>
97      <TD width="800">
98		Designates the channel on which to execute MeasureChannel. <br> Keep in mind that this will have an effect on the usage rates of neighboring channels.
99	  </TD>
100	</TR>
101	<TR>
102<TD width="200"><B>MeasureTime</B></TD>
103      <TD width="800">
104		Configures the scan time (in milliseconds). <br> A value of 10-1000 in increments of 10 can be configured.
105	  </TD>
106	</TR>
107  </TBODY>
108</TABLE>
109
110<H2>Noise Mode</H2>
111Select items by pressing Up and Down on the +Control Pad. Pressing Left and Right on the +Control Pad will change the parameters. Start noise generation with the A Button, and end it with the B Button. Once noise generation has started, the number of times noise is generated or not generated will be displayed.
112<TABLE border="1" width="100%">
113  <TBODY>
114	<TR>
115<TD width="200"><B>Channel</B></TD>
116      <TD width="800">
117		Configures the channel that generates the noise. <br> A value of 1-13 can be configured here. <br> Keep in mind that this will influence a number of neighboring channels.
118	  </TD>
119	</TR>
120	<TR>
121<TD width="200"><B>Noise rate</B></TD>
122      <TD width="800">
123		Configures the noise generation rate. <br> Noise generation or non-generation is determined randomly for each frequency interval. <br> Make sure that this rate is the amount of time that the radio waves are being emitted rather than the strength of those waves. <br> Changes can be made even after noise generation starts. Note that a noise rate of 100 percent is an extreme case and this state is not sustainable in a real environment.
124	  </TD>
125	</TR>
126	<TR>
127<TD width="200"><B>Frequency</B></TD>
128      <TD width="800">
129		Cycle (in milliseconds) that determines whether noise is generated or not generated. A value from 5-50 can be configured here.
130	  </TD>
131	</TR>
132  </TBODY>
133</TABLE>
134<H2>Location</H2>
135<P><CODE>$TwlSDK/bin/ARM9-TS/Rom/WMTestTool.srl</CODE></P>
136
137<H2>See Also</H2>
138
139<H2>Revision History</H2>
140
141<P>
1422008/09/29 Transplanted from NITRO-SDK.<br> 2005/08/04 Added a note regarding the noise rate.<br> 2005/07/08 Changed the display for the wireless LAN access point.<br> 2005/03/03 Initial version.
143</P>
144<hr><p>CONFIDENTIAL</p></body>
145</HTML>