Command: thrust

  USBDOS is a collection of different USB drivers and tools:
  THRUST returns low-level information (raw numbers) about your game
  port and joysticks. This information will probably not be very useful
  unless you understand how game ports and joysticks really work.

Syntax:

  THRUST [Options]

Options:

  There are two methods THRUST can use to look at your joysticks. Depen-
  ding on your exact hardware and software, one method may work better
  than the other.
  The first method uses the computer's BIOS. If you are using a
  compatible digital joystick driver (like my SDWRGMPD or USBJSTIK
  programs), THRUST will automatically use the BIOS method.
  The second method looks directly at the I/O port hardware. THRUST uses
  the direct hardware method by default if it does not find a compatible
  digital joystick driver installed in memory.
  To have THRUST use a specific method (BIOS or Direct I/O Port access),
  whether there is a compatible digital joystick driver installed or not,
  use an appropriate option on the command line:
    THRUST B                               (force BIOS method)
    THRUST D #, THRUST P #, or THRUST I #  (force DIRECT I/O PORT method)

    The # (I/O Port Number) is optional, and can be a decimal
    (512-527) or hexadecimal (200h-20Fh) port number. The default is 201h
    (513), which is the correct port for 99.99% of all computers.

Comments:

  THRUST is a program designed to test your joysticks. It does this by
  displaying the low-level, "raw" data that is coming from the joysticks,
  either through the joystick BIOS (software) or directly from the
  joystick (game port) hardware. It's included here as a "companion"
  program to help you test USBJSTIK (discussed directly on page 123
  of USBINTRO.DOC, see links below), but you can also use it to simply
  test your analog joysticks.
  What you will see on the screen when you run THRUST is divided into
  three sections. At the left will be a description of how THRUST is
  currently interacting with the joysticks: using the joystick BIOS
  (software), or by directly using the hardware (in which case USBJSTIK
  will show you an I/O port number).
  The second section will show you the raw data (numbers) being returned
  by each of the four axes (AX, AY, BX, and BY). For each particular
  axis, if you move the appropriate control (handle or direction-pad or
  slider or whatever), the displayed number will change. Usually, moving
  the control left or up or counter-clockwise will make the number get
  smaller, and moving it right or up or clockwise will make the number
  get bigger. However, if the joystick is using the ThrustMaster protocol
  (described in "Joystick Protocols" on page 124 of USBINTRO.DOC,
  see links below), the last (BY) axis is displaying the status of the
  (digital) 4-way Hat-switch. In this case, the number in BY will be
  maximum when the Hat-switch is centered, a little lower when up, a
  little lower yet when right, still lower when down, and minimum when
  left.
  The third and last section of THRUST will display the status of the
  joystick buttons, whether the joystick is using the 4-button or 15-
  button protocol (see "Joystick Protocols" on page 124 of USBINTRO.DOC,
  see links below) if you don't know what this means). If the joystick
  is using the 4-button protocol, the A1, A2, B1, and B2 columns will
  display the status of the four buttons (whether they are each pressed
  or not). If the joystick is using the 15-button protocol, the column
  labeled "15" will display the number of the button that is currently
  pressed (0 = no Button currently pressed, 1 = Button #1 pressed,
  etc.).
  THRUST can interact with the joysticks in two different ways, either
  through the BIOS (software) or directly through the hardware. The
  default method that THRUST uses depends on whether or not you have a
  digital joystick driver (like my SDWRGMPD or USBJSTIK programs)
  installed in memory or not. If you do have such a program, THRUST will
  use the BIOS (software) method by default. If you do not have such a
  program installed, THRUST will use the direct hardware method by
  default.
  No matter which access method THRUST would use by default, you can
  force it to use whichever method you want. To force THRUST to use the
  BIOS method, you would do the following:
    THRUST B
  To force THRUST to use the direct hardware method, you would do the
  following:
    THRUST D #
  where the # (the I/O port number) is optional. The I/O port number can
  be any number between 200h and 20Fh, which is the range of I/O port
  numbers reserved for game ports. The default I/O port number that game
  ports use is 201h, which is what THRUST will use if you don't specify a
  number (if you simply do "THRUST D"). Virtually all computers use port
  201h, so there is rarely a reason to specify any other port. In
  addition to the "D" (Direct), you can also use the alias "P" (Port) or
  "I" (I/O port) to tell THRUST to use the direct hardware method.
  After you are through viewing the raw joystick data, simply press a key
  on the keyboard and THRUST will stop.

  For more information see:
    https://gitlab.com/FreeDOS/drivers/usbdos/-/tree/master/DOC/DOSUSB
  OR:
    C:\FREEDOS\DOC\usbintro.doc (too big for edit, please use
    another editor, e.g. Blocek!)
  OR:
    https://bretjohnson.us/

Examples:

  - see examples above -

See also:

  boundtst
  drives
  hidsupt1
  inklevel
  irq
  ps2mtest
  scantest
  uni2asci
  usbdevic
  usbdos
  usbdrive
  usbhosts
  usbhub
  usbjstik
  usbkeyb
  usbmouse
  usbprint
  usbsupt1
  usbuhci
  usbuhcil
  vendorid

  Copyright © 1998-2009 Bret E. Johnson, help version
  2023 W. Spiegl.

  This file is derived from the FreeDOS Spec Command HOWTO.
  See the file H2Cpying for copying conditions.