Wireless Debugging Procedure

If you have a Windows Mobile device that supports Wi-Fi and a Wi-Fi enabled computer or wireless router, you can debug an application without a physical connection. Install the Java ME runtime on the device as described in CLDC Emulator Installation for a Device Running Windows Mobile.

Note, multiple phones can be connected simultaneously.

1. Make sure that your computer is running and somehow accessible via Wi-Fi.

   There is no difference between plugging it into Wi-Fi enabled router and starting an ad-hoc network on the computer.

2. On the device, turn on Wi-Fi, then find its IP address and write it down.

   This can be different for different vendors and models, so check the documentation shipped with your device. A good point to start your search might be START > Settings > Connections > WLAN Settings > Connection Status.

3. On the host, run one of the following commands to ensure that the computer can access the device:

   ping device-ip

   tracert device-ip

4. Start the Sun Java CLDC Emulator runtime. See CLDC Emulator Installation for a Device Running Windows Mobile, Step 9 through Step 11.
5. In a command window, go to /bin. Type:

   Windows

   device-address.exe add ip device-ip

   Mac OS

   installdir/Contents/Resources/bin/device-address add ip device-ip

   If you use a wireless router you can probably configure its DHCP server to always assign the same IP address to your device. If you can, you don’t need to run the device-address command every time because your device will be detected and added to the wireless network.

6. Wait a few seconds, then check for the newly connected device:

   Windows

   emulator.exe -Xquery

   Mac OS

   installdir/Contents/Resources/bin/emulator -Xquery

   Xquery returns the device name. You can also start the SDK user interface and look for the new device in the Device Selector panel.

7. Test the connection.

   The device should work like any other device or emulator. From the /bin directory, try these commands to install a MIDlet on the device:

   Windows

   emulator.exe -Xdescriptor:C:\Java_ME_platform_SDK_3.0\apps\Games\dist\Games.jad              -Xdevice:device-name-from-Xquery

   Mac OS

   emulator -Xdescriptor:../apps/Games/dist/Games.jad -Xdevice:device-name-from-Xquery
8. Start the project in Debug Mode, as described in On-device Debugging Procedure.
9. Test debugging.

   See the debugging procedures in Attach a Graphical Debugger and Sample CLDC Debugging Session.