Difference between revisions of "Command line"

From GIMX
Jump to: navigation, search
(General emuclient options)
(General emuclient options)
Line 51: Line 51:
  
 
* --curses
 
* --curses
[http://en.wikipedia.org/wiki/Curses_%28programming_library%29 curses] terminal display
+
[http://en.wikipedia.org/wiki/Curses_%28programming_library%29 curses] terminal display.<br/>
 
Mouse calibration is available through this interface.
 
Mouse calibration is available through this interface.
 
* --status
 
* --status
Line 65: Line 65:
 
the main use case for this is the automation of macro's execution<br/>
 
the main use case for this is the automation of macro's execution<br/>
 
all other events are ignored, except events generated by macros<br/>
 
all other events are ignored, except events generated by macros<br/>
the only way to quit is to add KEYDOWN ESCAPE at the end of the macro, or use --nograb and press ctrl+c into the terminal
+
the only way to quit is to add KEYDOWN ESCAPE at the end of the macro, or use --nograb and press ctrl+c into the terminal<br/>
 
another use case is the sending of a single command (it requires to use a macro as no key up event is generated).
 
another use case is the sending of a single command (it requires to use a macro as no key up event is generated).

Revision as of 17:14, 11 June 2012

Motivation

It's not for performance at this time, but a future release may be able to run entirely from a Linux terminal without having to run a windowing system. This would improve performances on all hardwares, especially on small ones like the raspberry pi or thin clients.
And it's also useful for other stuff like automation.

Linux + bluetooth

In a terminal:

   emu ps3_mac_address bt_device_index sixaxis_index
  • ps3_mac_address

this argument is mandatory

  • bt_device_index

the bluetooth device index (ex : 0 for hci0, 1 for hci1, etc)
this argument is optional, default device index is 0

  • sixaxis_index

the sixaxis index (ex : 0 for sixaxis 1, 1 for sixaxis 2, etc)
this argument is optional, default sixaxis index is 0

In another terminal:

   emuclient --config file_name
  • file_name

the name of the config file, in the ~/.emuclient/config directory (ex : toto.xml)
this argument is mandatory
use backslashes to escape spaces

Linux or Windows + DIY USB adapter or GPP

In a terminal:

   emuclient --config file_name --serial --port /dev/ttyUSBX --joystick --precision 16 --refresh 4

emuclient options:

  • file_name

the name of the config file, in the ~/.emuclient/config directory (ex : toto.xml)
this argument is mandatory

  • --serial --port /dev/ttyUSB0

serial port, ex /dev/ttyUSB0 in Linux, COM4 in windows
only mandatory for the DIY USB adapter

  • --joystick / --GPP / --360pad / --Sixaxis / --PS2pad

the type of USB adapter

  • --precision 16

the axis precision (joystick: 16, other adapters: 8)

  • --refresh 4

the refresh period, in ms
recommended values:
joystick/GPP/360pad/Sixaxis: 4 (250Hz)
PS2pad: 16 (62.5Hz)

General emuclient options

  • --curses

curses terminal display.
Mouse calibration is available through this interface.

  • --status

display controls in the terminal

  • --nograb

do not grab the mouse cursor

  • --force-updates

send button+axis status even if there is no change (for compatibility with games like DNF)

  • --subpos

improve stick precision (counteract rounding issues)

  • --keygen key

generate a key press at emuclient startup
the main use case for this is the automation of macro's execution
all other events are ignored, except events generated by macros
the only way to quit is to add KEYDOWN ESCAPE at the end of the macro, or use --nograb and press ctrl+c into the terminal
another use case is the sending of a single command (it requires to use a macro as no key up event is generated).