Summary of Contents for Logitech Magellan/SPACE MOUSE Classic
Page 2
More Raumfahrt e.V. (DLR). copies or newer editions of this manual and technical information on the Magellan/SPACE Edited 08/00 by LogiCad3D GmbH - A Logitech MOUSE can be obtained only from LogiCad3D Company, GERMANY. GmbH.
Contents Magellan/SPACE MOUSE Operation..4 Manual Configuration ........4 Communication and Notation......5 Commands ...........5 Data Structures ..........9 Hints for Software Development ..10 Transmitting the First Command....10 Checking the Handshake Signals....10 Echo Mode OFF .......... 10 Carriage Return Character "\r"..... 10 Fixed Number of Characters in Commands ...
Magellan/SPACE MOUSE Operation For basic information on how to install, use and configure the Magellan/SPACE MOUSE, please review the Magellan/SPACE MOUSE User's Manual. It is included on the LogiCad3D CD-ROM and is also available on our website at www.logicad3d.com/docs. Manual Configuration The various operating modes and sensitivities of the Magellan/SPACE MOUSE may be manually configured using the eight predefined...
K<*> and K<8> the meaning of the bits is defined in the Default Sensitivity subsequent line. For example, suppose a bit Returns the translational and rotational sequence is defined as follows: sensitivities and the zero radius to the default <B7><B6><B5><B4> <B3><B2><B1><B0> settings, as indicated by a double beep.
Page 6
<rot> <extkey> The bit has no effect on the State of the Magellan/SPACE components of the data packet. MOUSE plus (+) button appears in bit <B1> of <nibble3> of the The rotational components of the keyboard response (command data packet (inputs A, B and C) "kQ\r").
Page 7
Data Rate Setup Command Sensitivity Setup Command Function: Defines the maximum and Function: Sets the sensitivity of the minimum time periods. Magellan/SPACE MOUSE. Defines relationships between 1) Command: p<nibble1><nibble2>\r translational displacements of the <nibble1> <B7...4> <B3><B2><B1><B0> cap and the corresponding <...
Page 8
A string containing the version of Flash Command the installed firmware. Function: Activates the internal flasher of The following is an example string returned: the Magellan/SPACE MOUSE for v MAGELLAN Version 5.49 by LOGITECH INC. 10/22/96 the specified amount of time.
Data Structures data command "dQ\r". If data packets are requested more often than the minimum Data packets are transmitted from the time period permits, the requests are Magellan/SPACE MOUSE to the computer using ignored. the data structures described below. Note that these packet structures cannot be used as As an example, suppose the Magellan/SPACE commands.
Hints for Software Development The following hints should be helpful for return character "\r" ("\r" = CR = 13d = 0DH). developing software using Magellan/SPACE If this character is missing at the end of a MOUSE. command string, the Magellan/SPACE MOUSE will remain in a completely passive state while Transmitting the First Command waiting for the terminating "\r".
X-Window Interface This chapter describes the technical X-Window Driver Window background of the X-Window driver interface, The X-Window driver opens a window in which including how data is moved from the X- it starts the application. Events can only be Window driver to the application.
CommandEventNumber; sensitivity increases the range to Event.xclient.data.s[0] = XHigh32( window ); approximately ±6000. The following program Event.xclient.data.s[1] = XLow32( window ); excerpt reads the movement files out of the Event.xclient.data.s[2] = data packet. CommandMessageApplicationWindow; /* =1 */ XSendEvent(display,MagellanWindow,FALSE,0x0000, &Event); int X,Y,Z,A,B,C,Period; XFlush(display);...
Syntax: int MagellanInit (<display>, <window>) xclient.data 16-bit Word Display *<display>; Window <window>; s[0] Magellan Window High 16 bit <display> Makes the connection to the X-server firm (see XOpenDisplay in Xlib Programming s[1] Magellan Window Low 16 bit Manual). s[2] Keyboard Number <window>...
Page 14
<Magellan A pointer on the data structure in which Result: The function always returns the value Event> all information on the served event is TRUE. stored. xdrvlib.h File: <Magellan The scaling factor multiplied by the 3 TraScale> translation values of a MagellanMotion MagellanMultiplicationMatrix Event .
Windows Interface (mgldll.c Library) The mgldll.c library contains several useful one of three different types of events occurs: MotionEvent , ButtonPressEvent or functions for constructing the interface for a ButtonReleaseEvent . Windows application. The file is found on the LogiCad3D CD-ROM under the directory int MagellanTranslateEvent ( Syntax: \win95nt\source\mgldrv\ .
Magellan Set the current application sensitivity Syntax: int MagellanClose ( Application stored in MagellanInfo (type is float ) into /* [in] */ HMAGELLAN MagellanHandle ); Sensitivity the Magellan/SPACE MOUSE driver. Note Magellan Magellan handle. Normally, this that the feature to display the current Handle parameter is a variable initialized by the application sensitivity has been disabled...
Appendices Turbo Magellan/SPACE MOUSE 2-Nibble 6 Bits 8 Bits Character Code (Hex) The differences between the standard Ç Magellan/SPACE MOUSE (SSM) and the Turbo Magellan/SPACE MOUSE (TSM) are the baud rates and the data packet formats. The TSM â uses a double-speed internal clock and a à...
<cs 1,0> The checksum is also (1, 1, 1) (-1, 1, 1) 1 old 2 old (-1, -1, 1) (1, -1, 1) transmitted in two bytes, with 3 old 4 old six significant bits per byte. The (1, 1, -1) (-1, 1, -1) 5 old 6 old...
Page 19
= [R](P ) + T choice of an appropriate scaling factor for translation and another for rotation is This equation describes the one-step motion of dependent on the tasks to be performed and the graphical cube as represented by its eight the available graphics and computational corner points.
Page 20
This yields a new 3x3 matrix whose elements X = 1.5 Y = 0 Z = 0 are calculated using the following set of nine A = 0 B = 0 C = 0 equations: Summing the translational motion gives the = (R )(R* ) + (R...
LogiCad3D Support If you have any questions or comments about the Magellan/ SPACE MOUSE product, please contact the persons or organizations listed below for your area. Various information about the Magellan/ SPACE MOUSE, including the latest driver versions, can be found at the web sites.
Warranty Information LogiCad3D's Limited Lifetime Hardware CONSEQUENTIAL OR INCIDENTAL DAMAGES Warranty ARISING OUT OF THE USE OF OR INABILITY TO USE THE PRODUCT, EVEN IF LOGICAD3D LogiCad3D warrants that Magellan/SPACE HAS BEEN ADVISED OF THE POSSIBILITY OF MOUSE is free from significant defects in SUCH DAMAGES.
Page 25
European Economic Community the Software, but you may transfer the Declaration of Conformance (CE) Software on a permanent basis, provided you retain no copies and the recipient agrees to The Magellan/SPACE MOUSE is attested to the terms of this Agreement. You may not meet the essential protection requirements reverse- engineer, decompile or disassemble against electromagnetic emission, which are...
Page 26
Terms RIGHTS. YOU MAY HAVE OTHERS, WHICH VARY FROM STATE TO STATE. This license is effective until terminated. You may terminate it at any time by destroying the Limitation of Liabilities Software. It will also terminate upon conditions IN NO EVENT SHALL LOGICAD3D OR ITS set forth elsewhere in this Agreement or if you SUPPLIERS BE LIABLE FOR ANY fail to comply with any terms or conditions of...
Need help?
Do you have a question about the Magellan/SPACE MOUSE Classic and is the answer not in the manual?
Questions and answers