TEST3D Rev 3.4 USER DOCUMENTATION: NOTE: The term 3D Mouse in this document refers to the product and all its components. MINIMUM SYSTEM REQUIREMENTS: User must have access to the following to run TEST3D: 1) IBM-compatible PC 386 or above with coprocessor 2) 2 megabytes of RAM 3) 3.5 inch floppy drive 4) VGA color system 5) DOS 5.0 or later (may or may not work with earlier versions of DOS) 6) Minimum of 1 Serial Port INSTALLATION: Install the 3D Mouse per the installation instructions in the Technical Reference Manual. Connect the serial communication cable from the 3D Mouse to COM1, COM2, COM3, or COM4. Place the receiver in front of the transmitter and run the "TEST3D" program (i.e. A:\TEST3D). TEST3D OPERATION: The display shows numerous options: 0. Line Configuration 1. Hardware Test 2. Master/Slaves Test 3. Raw Information Display 4. Time Based Display 5. View Operating Configuration 6. 2D Mode Raw Information Display Esc Exit program Press the desired key; 0-6 or Esc. ---- Line Configuration ---- The Line Configuration choice is used to set the communication port and baud rate for communicating to the 3D Mouse. The user can optionally save the configuration setup to the file LOGIDRVR.CFG. This file is used during the start of TEST3D to setup the communication parameters between the PC and the 3D Mouse. ---- Hardware Test ---- The Hardware Test choice is divided into 3 major areas: Button Status Position Status Orientation Status The button status area shows a picture of the receiver. This picture displays all 4 logical buttons; left, middle, right and suspend, if the attached receiver support buttons. As each button is pressed a '+' label will appear in the appropriate location. Releasing the button will clear the '+' label. The position status area shows a bar with three tick marks. The center tick mark is the origin. The left and the right tick marks coorespond to -20 and +20 inches, respectively. There are three bars, one for each axis; X, Y and Z. The orientation status area shows a circle with a line from the center to the outside edge. This line cooresponds to the degree line with 0 degrees pointing straight up. There are three circles, one for each axis; X, Y and Z. X rotations are referred to as pitch, Y as Yaw and Z as Roll. All three degrees lines will change from white to black when the receiver is moved into the fringe area. The lines will return to white when the receiver is moved back into the normal working area. ---- Master/Slaves Test ---- The Master/Slaves Test choice is very similar to the Hardware Test except its main emphasis is to show the operation of multiple 3D Mouse Systems connected to the host computer. Only Orientation Status is given for each of the connected systems. Additional information supplied by this test are: 1) The COM Port Number of the connected 3D Mouse system. 2) The Master/Slave status of the connected 3D Mouse system. NOTE: 3D Mouse Systems operating with firmware version 1.0 have their Master/Slave status omitted and replaced by MAST/SLAV (implying that the connected system could either be in Master mode or Slave mode). This is because firmware version 1.0 did not support the Current Operating Configuration Information command (which reports to the host computer the master/slave status along with many other statuses of the connected system). ---- Raw Information Display ---- The Raw Information Display choice shows the button, position and orientation status in 3D mode. The information is displayed in numerical form as opposed to Hardware Test which is a graphical display. ---- Time Based Display ---- The Time Based Display choice is a method of displaying the position and orientation data over time. The user can either display position data or orientation data or position and orientation data simultaneously. The host computer sets the 3D Mouse in Demand Reporting Mode. The host then repeatedly demands a report and updates the display from the data sent from the 3D Mouse. 600 data updates are allowed per screen before the display graph is refreshed. Holding down the suspend button disables updates to the display graph. Pressing '+' increases the maximum value allowed on the display graph. Pressing '-' decreases the maximum value allowed on the display graph. ---- View Operating Configuration ---- The View Operating Configuration choice displays the current operating configuration data of the 3D Mouse. NOTE: 3D Mouse Systems operating with firmware version 1.0 does not support View Operating Configuration. ---- 2D Mode Raw Information Display ---- The 2D Mode Raw Information Display choice shows the button and X-Y positional displacement in 2D mode. The control unit is set to M+ format for this test. ERROR MESSAGES: The following are the error messages that TEST3D can generate along with steps for corrective action. "Logitech 3D Mouse not powered on or serial cable not installed." [Verify the 3D Mouse is turned on and connected to the right COM port.] "Not enough memory to run program." [This shouldn't occur. If it does try rebooting or removing TSRs.] "Communication port problem." [C Asynch Manager has detected a port problem, possibly bad hardware.] "Logitech 3D Mouse diagnostics failed." [The following sentence(s) will detail the failure.] Control Unit Board Failure - Unrecoverable Failure in Motherboard CPU Failure - Unrecoverable Failure in CPU ROM Failure - Unrecoverable Failure in ROM RAM Failure - Unrecoverable Failure in RAM Communication Port Failure - Unrecoverable Failure in COM Port within 3D Mouse Calibration Microphone Failure - PROBLEM: Calibration Microphone is not detecting signals from lower left speaker of transmitter. POSSIBLE REMEDIES: Clear obstruction between calibration microphone and transmitter speakers. EFFECTS: Slight inaccuracy to orientation and positional data. Receiver Not Receiving Data - PROBLEM: Receiver not receiving signals from transmitter. POSSIBLE REMEDIES: 1) Transmitter not connected. 2) Receiver not connected. 3) Receiver not in range. 4) Receiver not in line of sight of transmitter. EFFECTS: If not resolved all data reports sent shall have the OUT bit set. EEPROM Checksum Failure - PROBLEM: EEPROM not programmed properly or a brand new unprogrammed EEPROM has been installed. POSSIBLE REMEDIES: 1) Reboot 2) Reprogram the EEPROM (need support from Logitech) "Logitech 3D Mouse is not connected (another device is, though)." [Disconnect other device and replace with 3D Mouse or change COM Port settings via Line Configuration Menu selection.] "Invalid 2D status message received from control unit." [Control unit did not send 2D status message upon entering 2D mode.] "2D Mode not supported in firmware of connected unit." [Firmware in control unit does not support 2D mode.] "Receiver is not in range." [Move the receiver in front of the transmitter, remove any line of sight obstacles and run the test again.] "Bad Serial port parameter." [This shouldn't occur. This is a C Asynch Manager sanity check error.] "Logitech 3D Mouse serial connection problem." [Verify serial cable connection.] "Failed Operating Configuration data request." [Either the serial communication has been lost or you are testing a pre-production level 3D Mouse.] "Logitech 3D Mouse communication lost." [Correct broken connection and run the test again.] "Can't set to VGA graphics mode." [Test requires VGA graphics. Connect 3D Mouse to PC with VGA.] "Logitech 3D Mouse EEPROM can't be read." [Verify serial cable connection. If problem still exists, you may have a 3D Mouse hardware problem. Call Logitech Technical Support, see below.] "Not enough units connected for master/slaves test." [At least one unit needs connecting to run this test. Diagnostics may have failed if unit is connected. Run Hardware Test on each connected 3D Mouse.] "Connected unit has Firmware Version Number 1.0." "Selected feature not allowed with Firmware Version Number 1.0." [Test not allowed for connected unit.] TECHNICAL SUPPORT: 3D Mouse Developers' Electronic Bulletin Board Service (BBS) The Logitech Technical Support BBS has been expanded to include a forum for the 3D Mouse Developers. The phone number is (510) 795-0408 and operates 24 hours a day. It supports 300, 1200 and 2400 baud and operates with 8 data bits, 1 stop bit and no parity. After you give your life history, you enter the top menu. At this point, just type in "/GO 3DMAIN". This will transport you to the 3D Developer's forum. There is an announcement section, a file upload/download section and a message base area. The message base area can be used for communicating with the Logitech 3D Mouse development team. File uploads are encouraged and will be made available to all developers.