ۥ-GHr$EspDpDDqDqDqDqDqRqRqRqRqbq lq vqLqq(qqqqqqq4r)HrHr$* RL2DIAG / SRL2DIAG Users Guide Document Number 610-0021 Version 1.3 February 2, 1996 Proxim Confidential PRELIMINARY REVISION Revision Number: Revision Date: Revised By: Description of Changes:       1.0 04/28/95 Hung Nguyen Initial document  1.1 01/04/96 Jean Fuentes Updated document and added serial commands.  1.2 01/09/96 Jean Fuentes Updated the command parameter descriptions and some test command descriptions.  1.3 02/02/96 Jean Fuented Added a new command, Continuous Ping Test and a new parameter, /N master name   Introduction RL2DIAG.EXE and SRL2DIAG.EXE are utilities that provide the ability to configure, test, and debug PROXIMs RangeLAN2 family of products. RL2DIAG is used for ISA, PCMCIA, and OEM ISA RangeLAN2 products. SRL2DIAG is used with 6301 Serial OEM RF network cards. These utilities are intended to be used only as a debugging tool. Using them may violate FCC rules. Running RL2DIAG.EXE/SRL2DIAG.EXE To run the RL2DIAG utility, type the following at the DOS prompt: RL2DIAG To run the SRL2DIAG utility, type the following at the DOS prompt: SRL2DIAG RL2DIAG/SRL2DIAG were not designed to run in a Windows environment. Make sure you run these utilities from DOS and that no other RL2 drivers (ODI, NDIS, PACKET driver, RL2SETUP) are loaded. For SRL2DIAG, if the correct baud rate is not specified, this utility will detect the current baud rate setting on the 6301 serial OEM RF network card. Command Line Parameters The following table shows the parameters that you can enter from the command line. The parameters are not case sensitive and multiple parameters may be specified at one time. Parameters must be separated by white space and some parameters should not be combined with other parameters. For example, you would not want to enter both the /S (station) and the /M (master) parameters together. If the RF network card is not configured as a master, alternate master, or a station, then hopping is disabled on frequency 10. Note that if an invalid parameter is entered, the usage display screen is printed. Parameter Description For all cards: /? Displays usage information. /A Makes unit an alternate master. /B Selects number of hops between beacons. Valid number of hops are 1 - 7. The default number of hops is 1. This parameter applies to master stations only. /Bridge Turns the bridge flag on. /C Selects the channel number. Valid channels are 1 - 15. The channel number is used by master and alternate master stations only. The default channel is 4. /D Selects domain. Valid domains are 0 - 15. The default domain is 0. /DEBUG Turn driver debugging messages on. /F Disables hopping on a given frequency. Valid frequencies are 0 - 100. When the card is not configured as a master, alternate master, or a station, the default frequency is 10. Do not combine this parameter with the /A, /M, or the /S parameters. /H Selects hop period. Valid hop periods are 0, 1, or 2. /I Selects IRQ number. Valid IRQs are 3, 4, 5, 7, 10, 11, 12, and 15. The default IRQ for non-serial cards is 15 and the default IRQ for serial cards is 3. /M Makes unit a master station. /N Assignes a name to a master station. /P Selects the port address. Valid port number for Non-Serial cards: 100, 120, 140, 218, 270, 280, 290, 298, 2A0, 2A8, 2E0, 300, 310, 358, 360, and 368. Serial cards: 3F8 (COM1), 2F8 (COM2), 3E8 (COM3), 2E8 (COM4) The default port number for non-serial cards is 270 and the default port number for serial cards is 2F8 (COM 2). /S Makes unit a station. /SL The timeout value is in units of 5 seconds. The RF Network Card will go into sniff mode after 5*timeout seconds of inactivity. Sending a packet will take the card out of sniff mode. Valid inactivity timeout values are 0 - 255. The default inactivity timeout value is 0 (disabled - dont go into sniff mode). /T Initializes two cards in the system. All other parameters MUST begin with the card number (i.e. /T /1P270 /2P2A0 /1d10 /2DEBUG). /V Selects video mode. T for terminal, 25 for 25 lines, 50 for 50 lines. For non-Serial cards: /ISA Selects ISA type adapter. All cards are ISA cards by default. /8 Selects byte transfer mode. For PCMCIA cards: /E Selects socket number. Valid socket numbers are 0 , 1, 2, or 3. The default socket number is 0. /PCM Selects PCMCIA type adapter. /W Selects memory window. Valid memory windows are A000 - FF00. The default memory window is D000. /365 Tells the driver to configure the Intel 82365 PCIC chip. For OEM cards: /OEM Selects OEM type adapter. For Serial cards: /G<1,4,8,14> Sets the UART receive FIFO interrupt trigger level. The 8250 UART does not have a FIFO, so this parameter does not apply. The trigger level tells the UART how many characters to receive before generating a character receive interrupt. The default trigger level for the 16550 UART is 4. /R Selects the baud rate used to communicate with the RF network card. Baud rate codes are 0-7. 0=1200 1=2400 2=4800 3=9600 4=19200 5=38400 6=57600 7=115200. The default baud rate code is 4 (19200). Example Command Line Parameters To run RL2DIAG setting the unit to a master station on domain 5 at interrupt level (IRQ) 15 with an I/O address (port) of 0x270, you would enter the following parameters: RL2DIAG /M /D5 /I15 /P270 To run RL2DIAG using a PCMCIA card as a station on domain 2 with the Intel 82365 PCIC option turned on, you would enter the following parameters: RL2DIAG /PCM /365 /S /D2 To run SRL2DIAG setting the unit to a master station on domain 2 at 9600 baud on COM port 1, you would enter the following parameters: SRL2DIAG /P3F8 /M /D2 /R3 Menu Components General program information: When a test prompts you for a 6 byte HEX destination address, you may enter either a node address or the broadcast address. (e.g. 0020a6002193 or ffffffffffff). The - minus key, is a short cut for the broadcast address. If you enter the - key at an address prompt, it will use the broadcast address. All packet lengths are entered in decimal. The key exits you from any menu, including the main menu. An asterisk * in front of a test command indicates that the test command is a menu. After RL2DIAG comes up, a menu of test commands are displayed. The following is a list of available tests. 1. Exit This command exits the program. The key also allows you to exit from the program and from any sub-menu. 2. Set Security ID This command allows you to change the RF network cards security ID. For wireless stations to communicate, they must be on the same domain and have matching security IDs. From RL2DIAG, the security ID is entered as a 3-byte hex number. When running PROXIMs RL2SETUP program, the security ID is entered as a 20 byte character string. This string is then converted into a 3-byte hex value. If you want to use the same character strings, you can run the program CALCID.EXE to convert the character string into the correct hex value. Usage : calcid c:\> calcid YourName security id = 4f3d1d 3. This command is reserved for future use. 4. ROM Version/Cksum This command displays the RF network cards ROM version number and checksum. This checksum should be consistent for a given release. 5. Peek EEPROM This command reads and displays the contents of EEPROM at address locations 0x0000 through 0x00FF. Use this test to verify that the contents of the EEPROM can be read. 6. Disable Hopping This command disables hopping and forces the controller to stay on the specified frequency. Enter the frequency number as an unsigned decimal number ranging from 0 to 255. 7. Radio Mode This command allows the user to specify the radio mode and frequency. Radio mode choices are Tx, Rx, Standby, Tx/Rx, and Hop test. All numbers are entered as decimal numbers. For more details please refer to the design guide. 8. Serial Configuration/ This command is not available for the ISA/PCMCIA/OEM RF network cards. It is only available for the serial RF network cards. For serial cards, this command gives you a menu of command choices. You can changes the baud rate, change the FIFO trigger level, query the driver for the current FIFO trigger level setting, or query the firmware for the current baud rate, Serial Configuration Submenu 1. Set Rx FIFO Trigger Level. This command allows the user to change the trigger level setting on the UART. The FIFO trigger level tells the UART how many character to receive before generating an interrupt. For example, if the trigger level is set to 4, then the UART will not generate a receive interrupt until 4 character have been received. The 8250 UART does not have a FIFO, so you cannot change its trigger level. Valid trigger levels for the 16550 are 1, 4, 8, and 14. 2. Set Baud Rate. This command allows the user to change the baud rate. Baud rates support by the driver and the firmware are: 1200, 2400, 4800, 9600, 19200, 38400, 57600, and 115200. This command changes the baud rate for both the driver and the RF network card. The baud rate on the RF network card is changed by sending a PokeEEPROM packetized command, resetting the RF network card, and then re-initializing the driver. 3. Query Rx FIFO Trigger Level. This command displays the both the UART type (8250/16550) and the current FIFO trigger level. 4. Query Baud Rate. This command displays the current baud rate setting. This is accomplished by quering the RF network card for its baud rate setting using the PeekEEPROM packetized command. 5. Return to Main Menu. This command allows the user to return to the main menu. 9. Standby Test This command puts the card into standby mode and waits for the user to hit a key before taking it out of standby mode. The RF network card is placed into standby mode by sending the GoToStandby packetized command. For non-serial cards, the card is taken out of standby by setting the wakeup bit in the cards control register. For serial cards, toggling RTS takes the card out of standby mode. 10. HBTimer Test This command tests the heartbeat and RF timers. If both timers are working, the test displays a success message. If a problem is found with either timer, an error message is displayed along with the failure status number. The failure statuss for the heartbeat timer are: 1 = Oscillator Dead, 2 = Frequency Error. The failure status for the RF timer is: 1 = Timer Failure. 11. TX Hello World This command transmits a small packet containing the string Hello World From Cheetah! It accepts as input the destination node address and a modulation modes. These modes are BFSK, QFSK, and AUTO mode. 12. Transmit Ping This command transmits ping packets. The user enters the destination node address, the packet length, and the modulation mode (BFSK, QFSK, or AUTO). 13. Echo Packet This command continually sends random length echo packets until a key is hit or an error occurs. Packet lengths vary from 0 to 1500. When the RF network card receives the packet, it echoes the packet back to the driver. If the data in the returned packet does not match the original data, the test fails. 14. Get RSSI Value This command will get the current RSSI (Receive Signal Strength Indicator) value at the current frequency. RSSI values range from 0 to 255. If the value you receive is among 0 and 10, it probably means you do not have an antenna connected. If the value you receive is among 10 and 100, you are probably not getting an RF input signal (not receiving a packet). When the RF unit is receiving a packet, expect RSSI values ranging from 100 to 255. 15. Get Statistics This menu allows you to display or reset the statistics for the driver or for the RF controller. Get Statistics SubMenus 1. Get Driver Statistics. This command displays the statistics for the driver. These are divided into two columns. The first column contains the LLS statistics and the second column contains the LLD statistics. Driver LLS Statistics Description  Rx The number of data packets received by LLS.  Rx Drop (no buf) The number of data packets dropped by LLS due to lack of buffers.  Rx Raw The number of raw data packets received by LLS.  Rx Raw Drop (no buf) The number of raw data packets dropped by LLS due to lack of buffers.  Sent The number of packets LLS sent to LLD.  Sent Completed The number of LLSSendComplete() calls made by LLD. For each packet the LLS sends to the LLD, an LLSSendComplete() should be received.  Raw Sent The number of raw data packets LLS sent to LLD.  Raw Sent Completed The number of raw LLSSendComplete() calls made by LLD. For each packet the LLS sends to the LLD, an LLSSendComplete() should be received.   Driver LLD Statistics Description  Receive Look Ahead The number of times LLSReceiveLookAhead() was called.  Need Reset The number of times the driver set the LLDNeedReset flag indicating that a reset was needed.  Error Resets The number of times we reset due to an error condition.  Total Sent Total number of packets transmitted by LLD. Includes retransmissions.  ReSent Total number of packets that had to be resent. Caused by ACK, CTS, or some other error condition.  Sent Completed The number of times a transmission completed was received from the firmware.  Rxmit Timeouts The number of times LLDPoll() detected a timeout in the receive loop. This timeout causes a reset.  Txmit Timeouts The number of times LLDPoll() detected a timeout in the transmission loop. This timeout causes a reset.   2. Get RFNC Statistics This command displays the statistics for the RF network card. RF Statistics Description  Number of Hops  Number of hop periods.  Number of Searches  Number of times the controller searched for other masters. Does not apply to master stations.  Times been Master  Number of times the controller has been a master. Applies to alternate masters only.  Times Resynced Number of times the controller has re-synchronized to another master. Does not apply to master stations.  Missed Sync Messages Number of sync messages the controller missed.  Rx Data Packets The number of wireless packets received.  Tx Data Packets The number of wireless packets transmitted.  Lost CTS Packets Number of times the controller sent an RTS without receiving a CTS.  ACK Errors Number of times ACK retries expired.  Missed Start of Bs Number of start of B messages missed.   3. Reset Driver Statistics. This command clear both the LLS and the LLD statistics. 4. Reset RFNC Statistics. This command sends a packetized command to the RFNC to clear its statistics. 5. Return to Main Menu. This command allows the user to return to the main menu. 16. Reset RFNC This command allows you to reset and reinitialize the RF network card. It maintains the current configuration selected with the command line parameters. The driver statistics are not cleared. 17. Continuous Tx This command allows you to continuously transmit packets. It accepts as input a fixed packet length, a destination node address, and a time delay (in milliseconds). As each packet transmission completes, we print out the total number of packets transmitted. Also, we allow packets to be received and displayed while we are transmitting packets. 18. Receive Test This command receives packets and keeps a 10 second window for the number of received and missed packets. Use this command in parallel with the continuous transmit command running on another wireless station. Receive data packets are not displayed on the screen. 19. Throughput Test This command continuously transmits packets and calculates the throughput rate for each packet. The user enters the destination node address and the packet length. While this test is running, all packets received are discarded. 20. Random TX Test This command continuously transmits packets to the specified node address using random length packets and random data. The first data byte in the packet is the seed value used to generate the random data. The receiver uses this seed when comparing the data. 21. Random RX Test This command should be used in conjunction with the Random Tx Test running on another wireless station. It continuously receives and validates incoming packets. The first data byte in the packet is the seed which the rest of the bytes are generated from. If a data miscompare is detected, an error message is displayed indicating the byte offset, the expected data, the received data, and the length of the packet. 22. Continuous Ping Test This command continuously transmits ping packets until the user press a key. The user enters the destination node address, the packet length, the modulation mode (BFSK, QFSK, or AUTO), and a delay value in milliseconds. The delay value is how long to delay between sending ping packets. The number of successful packets transmitted is displayed along with the number of packets that failed due to CTS errors, ACK errors, or timeouts. RL2DIAG Users Guide Proxim Confidential Page page \* arabic2 of numpages \* mergeformat 1 v 00$13ACEMOQS#%4 "$|xtplf     ! $    ,  ((*WY  s y actv:<  zvrn !  !      *FHeiz|EG   GI^` i!k!{!a"c""#$$!$@$  2@$&&&'''7(:(O(())S)U)g)** +,,,o-q--..0.e/g/|/=1>1P1R1111112222555588899!!399=9J9L9W9Y9x<|<<<<<>=@=Y====i>k>~>???@@AAA BCC(CDDFFFFFFFFFFFFFGGGGG!!4GGGB "$13579;=?ACEOQSepw @ (@ (2#ƽzzWK@77 H "l42 #  H "l42 #  H "l42 # #%*4B  "$+-ƽzzWOGGGG"l42 #  H "l42 #  H "l42 # (*npWY  s u w y A ` = / b,~] ~ @ ~ 6 ~ @ ZZ ~ @ ~ 6 ~ @ ZZ$ Z& ( L8Aacv~Z8:<  FHegiz|E h @ ~ 6 ~ @ ZZ @ ~ 6 ~ @ ZZ ~ @ ~ 6 ~ @ ZZ3 GI` i!k!{!a"c"" # ##$$!$@$&&&'''7(:(ľ|vvnhh888R ~~ ~ ~ ~ ~  & &':(O(())S)U)g)*** +,,,o-q--..0.e/g/|/=1R1111112vvvh[ & *8 * &~ ~ ~ ~ ~  ~88222222333Y3[3c3333333#4Ưk``I>> l,"IJIIIIIJ l,"IJIIIIIJ l,"IJIIIIIJ l,"JIIIIJ l,"JJJIJIJJ  *#4%454444445555555566ǼvkkTII2l,"JIIIIJ l,"JJJIJIJJ  *l,"IJJIIIJJ l,"IJIIIIIJ l,"IJIIIIIJ l,"IJIIIIIJ66}66666677&7777777a8c8ӼxmmVKK4l,"IJIIIIIJ l,"IJIIIIIJ l,"IJIIIIIJ l,"IJIIIIIJ l,"IJIIIIIJ l,"IJIIIIIJ c8s8888899;9=9L9Y9[9k999999:i:örggPEE l,"IJIIIIIJ l,"JIIIIJ l,"JJJIJIJJ  & *8 *l,"IJJIIIJJ i:k:{::::.;0;A;k;m;~;;;;<<<8<ǼxxaVV?44 l,"IJIIIIIJ l,"IJIIIIIJ l,"IJIIIIIJ l,"IJIIIIIJ l,"IJIIIIIJ l,"IJIIIIIJ8<:<O<v<x<z<|<<<<<>=@=Y====i>k>Ǽ{pbUJB<40~  * & &8 * & &8 * & &8 &l,"IJJIIIJJ l,"IJIIIIIJk>~>???@AAA BCC(CDDDFFFFFFFGGGG~ ~ ~ ~ ~ ZF !! < < < < <<<<<EGqsG$G*L Tms Rmn `Symbol HelvTimes New Roman ArialCG Times (W1):IKPjlE!"t"t"- ) Jean Fuentes Jean Fuentes