Logitech Magellan/SPACE MOUSE Classic Programmer's Manual

Logicad3d

Advertisement

Advertisement

Table of Contents
loading

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.
  • Page 3: Table Of Contents

    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 ...
  • Page 4: Magellan/Space Mouse Operation

    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...
  • Page 5: Communication And Notation

    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.
  • Page 9: Data Structures

    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.
  • Page 10: Hints For Software Development

    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".
  • Page 11: X-Window Interface

    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.
  • Page 12: Receiving Events

    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);...
  • Page 13: The Xdrvlib.c Library

    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 .
  • Page 15: Windows Interface (Mgldll.c Library)

    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\ .
  • Page 16: Magellaninfowindow

    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...
  • Page 17: Appendices

    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 à...
  • Page 18: Mathematics Of 3D Motion Control

    <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...
  • Page 21: Product Specifications

    Product Specifications Magellan/SPACE Magellan/SPACE Magellan/SPACE Feature/Specification MOUSE Classic MOUSE Plus MOUSE Plus XT Contactless, wearless, high-linear measuring system Operating speed levels (increments of resolution) Number of freely programmable buttons Software-controllable keyboard LEDs Yes (2 yellow, 1 red) Quicktip virtual button Device weight (for stability) 0.665 kg 0.680 kg...
  • Page 22: References

    References Holmes, Michael and Bob Flanders. C++ Nye, Adrian. Xlib Reference Manual for X11 Communications Utilities . PC Magazine. Release 4 and Release 5 , 3rd ed. Volume Two. ISBN 1-56276-110-2. ©1997 O’Reilly & Associates, Inc. ISBN 1-56592-006-6. Nye, Adrian. Xlib Reference Manual for X11 Release 4 and Release 5 , 3rd ed.
  • Page 23: Logicad3D Support

    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.
  • Page 24: Warranty Information

    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...

This manual is also suitable for:

Magellan/space mouse plusMagellan/space mouse plus xt

Table of Contents