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.