# WMTestTool

## Overview

`WMTestTool` 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 `OS_GetMacAddress`. The following four items will be displayed on the main menu:

Scan Test | Can perform a check on the GGID and TGID. Uses `WM_StartScan`. When using a wireless LAN access point, the SSID will be displayed in the GGID field.
ScanEx Test | Can perform a check on the GGID and TGID. Uses `WM_StartScanEx`. When using a wireless LAN access point, the SSID will be displayed in the GGID field.
MeasureChannel Test | Displays the usage rate of a designated channel. This rate will be a value from 0-100, and larger values indicate more crowding. Uses `WM_MeasureChannel`.
Noise Mode | Transmits jamming on a designated channel. Uses a command for non-public testing.

## Scan Test

Select 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.

Channel | When set to seek, this scans through channels 1, 7, and 13. 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.
MaxChannelTime | Maximum amount of time to search on a single channel. This time can be configured in the range of 10-300 milliseconds.

## ScanEx Test

Select 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.

Channel

Designates a channel to scan.
When set to 1, 7, or 13, `0x1041` is configured to the channelList of `WMScanExParam`.
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.
When the ScanType is Active, all channels from 1 to 13 are designated.

MaxChTime | Maximum amount of time to search on a single channel. This time can be configured in the range of 10-300 milliseconds. When the ScanType is Active, this value is fixed at 50 milliseconds.
ScanType | Configures the ScanType. Be aware that the DS parent device can only be found in Passive mode.

## MeasureChannel Test

Select 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.

Channel | Designates the channel on which to execute MeasureChannel. Keep in mind that this will have an effect on the usage rates of neighboring channels.
MeasureTime | Configures the scan time (in milliseconds). A value of 10-1000 in increments of 10 can be configured.

## Noise Mode

Select 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.

Channel | Configures the channel that generates the noise. A value of 1-13 can be configured here. Keep in mind that this will influence a number of neighboring channels.

Noise rate

Configures the noise generation rate.
Noise generation or non-generation is determined randomly for each frequency interval.
Make sure that this rate is the amount of time that the radio waves are being emitted rather than the strength of those waves.
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.

Frequency | Cycle (in milliseconds) that determines whether noise is generated or not generated. A value from 5-50 can be configured here.

## Location

`$TwlSDK/bin/ARM9-TS/Rom/WMTestTool.srl`

## See Also

## Revision History

2008/09/29 Transplanted from NITRO-SDK.
2005/08/04 Added a note regarding the noise rate.
2005/07/08 Changed the display for the wireless LAN access point.
2005/03/03 Initial version.

CONFIDENTIAL