Getting Started on the iPAQs

This document gives you some of the basics you will need to know in order to program on the iPAQs.

Connecting to the Network

  1. First, you need to turn the wireless card on:
    Start -> iPAQ Wireless -> WLAN should be green
    If the WLAN button is not gree, tap it to turn the wireless off/on.
  2. Next, you need to make sure that the adapter is configurd properly:
    Start -> Settings -> Connections -> Connections -> Advanced -> Network Card -> Network Adapters -> iPAQ USB Wireless Adapter (Double-click) -> Make sure "Use server-assigned IP address" is selected
    This is also where you will find the IP address assigned to the device when you need it. It will appear in the box in the middle of the screen. You will need to replace "localhost" with the IP address of the server device in your client code.
  3. Go back to "Network Card". If MHC does not appear in the list in the middle of the screen:
    Add New Settings -> Network name: MHC (make sure it is in caps)
    Authentication -> Data encryption unchecked
  4. At this point, the device should connect to the network. You may need to click "OK" on the top right then go back to the "Network Card" screen to see if "Connected" appears next to MHC in the list.

Connecting to the PC

  1. In order to connect the device to the computer, plug the cradle into an electric outlet and then plug the USB connector into the USB port on the computer.
  2. ActiveSync should automatically launch when device is placed on cradle. If not, you can manually launch the program.
  3. Create a "Guest Partnership".
  4. Open the file Explorer and you should see the "Mobile Device".

Developing Code

  1. Write your code using JBuilder, emacs, NotePad, etc.
  2. Compile from the command line using the compiler in c:\tools\jdk1.1.8\bin. Recall, you should SET PATH to put this directory in your path.
  3. Before actually running your program on the iPAQ, you can emulate running on the device. The emulator works much like the regular java interpreter. However, instead of running by typing java ClassName you type pjava ClassName. In order to use pjava, it also must be in your path. You should set your path to include: c:\tools\pjee3.1\bin
  4. If you get errors during the emulation, debug, recompile, reemulate.
  5. Once your code runs in the emulator, then you can transfer to the device and run. Note that you can develop and emulate without having access to the devices. You probably want to wait until you have done all of the debugging and emulation you can before you check out the devices.

Transferring Files to the Device and Running your Program

  1. Using the file Explorer, create a folder \Mobile Device\My Pocket PC\Windows\lib\Username. Make sure to remove this folder and its contents when you are finished.
  2. Copy all of your .class files to the folder you just created.
  3. Using the file Explorer, create a folder \Mobile Device\My Pocket PC\Windows\Start Menu\Programs\Jeode\Examples\Username. Again, remove this folder and its contents when you are finished.
  4. Create a file (using NotePad or similar) called something.lnk. The something might be the name of your program.
  5. The contents of the file should be:
    18#"\Windows\evm.exe" -Djeode.evm.console.local.keep=TRUE -cp \Windows\lib\username JavaMainClassName
  6. Copy this file to the folder you created in step 3.
  7. To run:
    Start -> Programs -> Jeode -> Examples -> Username -> icon

Sami Rollins