30 Tools guide — RIM 950 Wireless Handheld simulator
Developer’s Guide – RIM 950 Wireless Handheld™
When using a physical modem with the simulator, you cannot s imulate
different coverage situations in software; you are limited by what the
modem is actually experiencing. To simulate different coverage
situations, change the position of the antenna or obst ruct the antenna's
coverage. The dialog box for manually controlling radio coverage
situations is unavailable when running the simulator with a RAP
modem, as its behaviour is determined by what the actual modem
experiences on the live network.
Command line options for modem simulation using a RAP modem
/R1 /R2 /R2...
This option sets the radio serial port number. With this command
line option, the simulator simulates network traffic by
communicating to a real modem.
The simulator is able to communicate with the Allpoints wireless modem
from Megahertz and all RIM modem products for your network,
including the RIM 957, the RIM 902M OEMs, and the RIM 950 Wireless
Handheld.
Using the RIM Wireless Handheld as the modem
The RIM Wireless Handheld is an integrated embedded system and
radio modem. Although radio functionality is availa ble to applications
running on the Wireless Handheld, this functionality is normally not
available through a serial connection. To allow the SDK’s Windows
simulator to communicate with the RIM Wireless Handheld, a special
program, SDKRADIO.DLL, must be loaded onto the RIM Wireless
Handheld to enable it to communicate radio information over the serial
port. You can load SDKRADIO.DLL with the PROGRAMMER.EXE utility
by typing:
PROGRAMMER LOAD SDKRADIO.DLL
When SDKRADIO.DLL is loaded, it aut omatically detects when the
simulator is attempting to contact the RIM Wireless Handheld, and
opens the COM port for communication. When not connected to the
Windows simulator, the SDKRADIO.DLL does nothing. It can coexist
with your regular applications on the RIM Wireless Handheld without
harmful effects.
When using the wireless handheld as your modem, remember that the
RIM Wireless Handheld was not designed as a high-capacity modem.