
      ******************************************************************
      *        LANSTART, LANSTAR (Setup, Diagnostics and Tx/Rx)        *
      ******************************************************************


  Subject: This program is a demo program for W89C905, W89C904A, W89C904,
           W89C904AX.
           a. LANSTAR.EXE: This program only runs in the board that INTM is
                           direct mode.
           b. LANSTART.EXE: This program only runs in the board that INTM is
                            coded mode.



  1. Input file:
     a. MINISIZE.PKT, MAXISIZE.PKT, and RUNTSIZE.PKT
        -> Test data files.
     b. TRX.DAT
        -> Used by testing the TRX function.
           It's format is as below:
           6 bytes' destination address.
        note: If does not exit TRX.DAT, the default destination address is
              broadcast address (ff ff ff ff ff ff).
     c. LANSTAR.DAT (used for lanstar.exe)
        -> It's format is as below:
           IC number (905, 904AX, 904A or 904)
           IRQ number of INT0 connecting in Diecet mode
           IRQ number of INT1 connecting in Direct mode
           IRQ number of INT2 connecting in Direct mode
           IRQ number of INT3 connecting in Direct mode
           boot rom size (16K, 32K or 64K)
           memory address ( W89C904 does not need this item. )
     d. LANSTART.DAT (used for lanstart.exe)
        -> It's format is as below:
           IC number (905, 904AX, 904A, or 904)
           IRQ number of INT0 connecting in Coded mode
           IRQ number of INT1 connecting in Coded mode
           IRQ number of INT2 connecting in Coded mode
           IRQ number of INT3 connecting in Coded mode
           IRQ number of INT4 connecting in Coded mode
           IRQ number of INT5 connecting in Coded mode
           IRQ number of INT6 connecting in Coded mode
           IRQ number of INT7 connecting in Coded mode
           boot rom size (16K, 32K or 64K)
           memory address ( W89C904 does not need this item )



  2. Output file:
     a. *.ERR
        -> Text file that reports the tested items and the error output.
     b. ~~LANERR.TRX
        -> This is a binary file that reports the error output for testing
           the transceive function.  When receiving some packet with errors,
           this file reports the buffer header and the packet data with 55
           AA leading and tailed.



  3. Steps for Software Installation:
     -> The computer must not be on the network.  Keep the LANSTAR.EXE or
        LANSTART.EXE and three tested data files in one directary, then
        execute the LANSTAR.EXE or LANSTART.EXE in that directary.



  4. Operation :
     a. Use the <up> or <down> key to move the red bar to the function needed,
        and press <Enter> to execute.
     b. Press the upper-case letter in the function name to select a
        particular function.
     c. Press <Esc> or <F10> to quit the active window.



  5. main functions :
     5.1. Configurate the W89C905, W89C904A, or W89C904.
     5.2. Diagnose.
     5.3. Transmit/receive packets.
     5.4. Access physical address.
     5.5. Reset.

  5.1. Configurate the W89C905, W89C904A, or W89C904.
       function: Let user to change configurations and select to write new
                 configurations defined by user to the test board or EEPROM.
       5.1.1. Show current configurations on board.
              function: The program read configurations from this test board,
                        and show them in the screen.
       5.1.2. set configuration A.
              function: Let user change configuration A.
                 items: IOBASE, INT, FAST and MEMIO.
       5.1.3. set configuration B.
              function: Let user change configuration B.
                 items: Thick, GDLINK, EIO16, ECHRDY and BPWE.
       5.1.4. set configuration C.
              function: Let user change CFC.
                 items: BPBASE, COMP, INTM, CLKSEL and SOFTEN.
       5.1.5. set memory mapping register.
              function: Let user change memory mapping register A and B.
                 items: ALOW, AHIGH, LOCAL BUS WIDTH and SYSTEM BUS WIDTH.
       5.1.6. write configurations to eeprom.
              function: Let user write new configurations to EEPROM on this
                        test board. User can set EECONFIG bit, turn off the
                        power, turn on the power again and the chip can load
                        the new configurations to the test board from EEPROM.
       5.1.7. write configurations to board.
              function: Let user write configurations to the test board. The
                        program uses the method of software programming to
                        change old configurations to new configurations
                        defined by user immediately.

  5.2. Diagnose.
       function: Let user do a variety of tests.
           note: a. The user can select test file and test times.
                 b. This test will stop when you press <Esc>.
       5.2.1. Network functional test.
              function: Let user do diagnose tests which include register
                        read/write test, remote DMA read/write test, send
                        packet test, memory read/write test and loopback 1,
                        2 tests. Following these tests, the transceive test
                        be executed. The program stops at the time one of
                        the tests failed.
                  note: Before executing this tests, connect two PCs.
       5.2.2. Auto functional test.
              function: Let user do simple diagnose tests which include
                        register read/write test, remote DMA read/write test,
                        send packet test, memory read/write test and loopback
                        1, 2, and 3 tests.
               default: test file -> minisize.pkt.
                        test times -> infinite.
       5.2.3. Perform functional tests.
              function: Let user do single functional test.
              5.2.3.1. register read/write test.
                       function: Let user test register read and write
                                 function. The program writes test pattern
                                 to three pages' registers and read back to
                                 check.
                   test pattern: a. the first test pattern
                                    -> 0x55, 0xaa, 00, 0xff, ...
                                 b. the second test pattern
                                    -> 00, 0xff, 0x55, 0xaa, ...
              5.2.3.2. Remote DMA read/write test.
                       function: Let user test remote byte counter and remote
                                 DMA function using a variety of data
                                 configuration combinations in I/O mode.
                        default: test file -> minisize.pkt.
                                 test times -> infinite.
              5.2.3.3. Send packet test.
                       function: Let user test send packet function using a
                                 variety of data configuration combinations
                                 in I/O mode.
                        default: test file -> minisize.pkt.
                                 test times -> infinite.
              5.2.3.4. Memory read/write test.
                       function: Let user test memory read and write functions
                                 using a variety of data configuration
                                 combinations in memory mode.
                        default: test file -> minisize.pkt.
                                 test times -> infinite.
              5.2.3.5. Loopback all mode test.
                       function: Let user test loopback mode 1, 2 and 3
                                 functions using a fixed data configuration,
                                 a fixed transmit configuration, a fixed
                                 receive configuration and a variety of packet
                                 configuration combinations.
                        default: test file -> minisize.pkt.
                                 test times -> infinite.
              5.2.3.6. Loopback all mode test.
                       function: Let user test loopback mode 1, 2 and 3
                                 functions using a fixed data configuration,
                                 a fixed transmit configuration, a fixed
                                 receive configuration and a variety of
                                 packet configuration combinations.
                        default: test file -> minisize.pkt.
                                 test times -> infinite.
                           note: LAN card must connect a 25 ohm terminator,
                                 otherwise this test will fail.
              5.2.3.7. Loopback mode 1 test.
                       function: Let user test loopback mode 1 function using
                                 a fixed data configuration, a fixed transmit
                                 configuration, a fixed receive configuration,
                                 and a variety of packet configuration
                                 combinations.
                        default: test file -> minisize.pkt.
                                 test times -> infinite.
              5.2.3.8. Loopback mode 2 test.
                       function: Let user test loopback mode 2 function using
                                 a fixed data configuration, transmit
                                 configuration, receive configuration, and
                                 packet configuration.
                        default: test file -> minisize.pkt.
                                 test times -> infinite.
              5.2.3.9. Loopback mode 3 test.
                       function: Let user test loopback mode 3 function using
                                 a fixed data configuration, transmit
                                 configuration, receive configuration and
                                 packet configuration.
                         default: test file -> minisize.pkt.
                                  test times -> infinite.
                            note: LAN card must connect a 25 ohm terminator,
                                  otherwise this test will fail.

  5.3. Transmit/receive packets.
       function: Let user do transmit function test, or receive function
                 test or transceive function test.
       5.3.1. Transmit packets.
              function: Let user do transmit function test.
              5.3.1.1. Load transmit packet.
                       function: Let user set the transmit packet by loading
                                 file.
                        default: maxisize.pkt.
              5.3.1.2. Set destination address.
                       function: Let user set destination address. The program
                                 will show multicast bit if the input address
                                 is a multicast address.
              5.3.1.3. Set transmit packet length.
                       function: Let user set the length of transmitting
                                 packet. The range of packet length is 64-
                                 1518.
                        default: 1518.
              5.3.1.4. Set delay time index for next transmission.
                       function: Let user set the delay time in every
                                 transmission. The maximum value of delay
                                 time is 65535.
                        default: 0.
              5.3.1.5. Transmit.
                       function: Depending on the enviornments (include
                                 transmit packet, destination address,
                                 transmit packet length and delay time index
                                 for next transmission) that user defined or
                                 the program default, let user transmit
                                 packets continuously until pressing <Esc>.
                                 The program will show the contents of
                                 interrupt status register and transmit status
                                 register in transmission.
                           note: You must use another PC to receive packets
                                 synchronous.
       5.3.2. Receive packets.
              function: Let user do receive function test.
               default: reception mode
                        -> accept this board physical address packets.
              5.3.2.1. Set reception mode.
                       function: Let user set receive configuration register.
                       5.3.2.1.1. accept only this physical address packets.
                                  function: Only this physical address
                                            packets will be accepted.
                                            Multicast and Broadcast address
                                            packets will not be accepted.
                       5.3.2.1.2. accept all physical address packets.
                                  function: All physical address packets will
                                            be accepted.
                       5.3.2.1.3. accept multicast address match packets.
                                  function: Only multicast address match
                                            packets will be accepted.
                                    note: Multicast address registers must be
                                          set.
                       5.3.2.1.4. accept broadcast address packets.
                                  function: Only broadcast address packets
                                            will be accepted.
                       5.3.2.1.5. accept every mode packet.
                                  function: Physical, multicast and broadcast
                                            address packets will be accepted.
                                    note: All multicast register bits are set.
                       5.3.2.1.6. set multicast address registers.
                                  function: Let user set multicast address
                                            registers. User can clear or set
                                            all multicast bits and some
                                            some special multicast bit.
              5.3.2.2. Receive packets.
                       function: Depending on the reception mode that user
                                 defined or the program default, let user
                                 reveive packets continuously until pressing
                                 <Esc>. The program will show the contents of
                                 interrupt status register and receive status
                                 register in reception.
                           note: You must use another PC to transmit packets
                                 synchronous and check the destination addess
                                 , Otherwise you can not receive anything.
       5.3.3. Transceive.
              function: Let user test transmit and receive functions.
                  note: Before executing this tests, connect two PCs, and
                        write the physical address to TRX.DAT at the opposite
                        PC or input the destination address.

  5.4. Access physical address.
       function: Let user get this board physical address and the result of
                 checking ring buffer.

  5.5. Reset.
       function: Let user reset the chip.
