Sending Test Messages with Radiotest

Radiotest.exe enables you to send a message through a device driver to emulate a Windows CE–based device that receives a message from a radio card. You can type the message on the command line or send it from a file. If you do not type any command-line switches or messages, Radiotest.exe brings up a GUI with which you can interact. This is useful on machines without a full-size keyboard.

The following table shows the switches used when you run Radiotest.exe.

Switch
Description
/anum Specifies the address number the message is sent to.
/atag Specifies the address tag the message is sent to.
/mtype Specifies the message type (1=numeric, 2=alpha).
/mpri Specifies the MsgPriority field.
/errflags Specifies the value for the wErrFlags field.
/mseq Specifies the value for the wMsgSequenceNumber field.
/mflags Specifies the value for the MsgFlags field.
/delay Specifies the number of seconds to delay before sending the message.
/count Specifies the number of times to repeat sending the message.
/log Specifies the file name of the activity log file.
/msg Specifies the file name from which to read the message.
/cnvt Specifies to convert the message from Unicode to ASCII if /cnvt=1.
Specifies not to convert if omitted, or if /cnvt=0.

You can specify either /atag or /anum, but not both. If you specify neither, an address of zero is assumed. If you specify /anum and you do not program the address into the device, the tag AddrXX is used instead. For example, if you send a message to a nonexistent /anum=4, then the message is sent to an address with a tag Addr04.

If /delay and /count are both specified, the delay value is used before sending each copy of the message, including the first copy.

If no log file is given and an error occurs, a message box pops up to alert the user of the error.

If a file name is specified for a message body, the message is read and sent exactly as it appears in the file.

The following command line examples further explain the switches:

radiotest /anum=3 /log=rtst.log Hello, world!

This sends a message containing the text "Hello, world!" to address number 3, logging any errors in the file Rtst.log.

radiotest /atag=Addr1 /delay=2 /count=5 /msg=testmsg1.txt

This sends the contents of the file Testmsg1.txt to the address with the tag Addr1 five times, with a two-second delay before each message is sent.

radiotest Test Message

This sends a message containing the text "Test Message" to address number 0, which is the default. If an error occurs, a dialog box alerts the user.