background image

Preferences

Preferences   settings   are   values   that   control   the   overall   operation   of   the   Quadstick.   The
Quadstick preference settings can be tailored to an individual's needs. Globally (in prefs.csv), in
a Game Configuration file, by Voice Command, or even in a specific game Mode sheet within a
game configuration file.

The   Default   Preferences   spreadsheet   contains   the   values   in   the   prefs.csv   file   when   the
Quadstick is new.   The user can create their own copy of the Preferences spreadsheet and
modify the values then download the CSV file into the Quadstick, or use the Quadstick Manager
Program to adjust them.  The values in the prefs.csv file can be overridden by a Preferences
sheet in the active game profile.  Likewise, each mode sheet can modify preferences that are
active only on that sheet.  Every time the configuration changes in the Quadstick, the prefs.csv
file is read, then any values in a Preference sheet in the active game configuration file are read,
then the any individual preferences in the active mode sheet are applied.   A typical use-case
could   be   special   modes   sheets,   like   a   driving   mode,   where   the   joystick   sensitivity   may   be
reduced to make steering easier.

Preferences

Can be set in prefs.csv or Preferences page in game csv file

prefs.csv

Can be changed with voice command, or file

Preference

Value

Units

Can be changed on Mode sheet, Command or file

joystick_deflection_minimum 9

percent

Defines center dead zone. Percent of physical movement

joystick_deflection_maximum 30

percent

Defines physical deflection scaled to 100% Signal

deflection_multiplier_up

140

percent

Adjusts joystick deflection value in the UP direction

deflection_multiplier_down

130

percent

Adjusts joystick deflection value in the DOWN direction

deflection_multiplier_left

100

percent

Adjusts joystick deflection value in the LEFT direction

deflection_multiplier_right

100

percent

Adjusts joystick deflection value in the RIGHT direction

joystick_dead_zone_shape

1

0=Square, 1=Circle

anti_dead_zone

0

percent

Counteracts the dead zone built into the Game Console's joystick 
software

joystick_warning

400

percent

Joystick position beyond full scale that will flash the leds

joystick_alarm

500

percent

Joysitck position beyond full scale that will buzz the speaker

usb_1_multiplier_up

100

percent

Adjusts a USB input sensitivity in one direction

usb_1_multiplier_down

100

percent

Adjusts a USB input sensitivity in one direction

usb_1_multiplier_left

100

percent

Adjusts a USB input sensitivity in one direction

usb_1_multiplier_right

100

percent

Adjusts a USB input sensitivity in one direction

usb_2_multiplier_up

100

percent

Adjusts a USB input sensitivity in one direction

usb_2_multiplier_down

100

percent

Adjusts a USB input sensitivity in one direction

usb_2_multiplier_left

100

percent

Adjusts a USB input sensitivity in one direction

usb_2_multiplier_right

100

percent

Adjusts a USB input sensitivity in one direction

joystick_D_Pad_inner

25

percent

Inner Zone Ring as percent of scaled Signal

joystick_D_Pad_outer

60

percent

Outer Zone Ring as percent of scaled Signal

sip_puff_threshold_soft

8

percent

Percent of full scale Pressure to detect Soft Sip/Puff

sip_puff_threshold

40

percent

Percent of full scale Pressure to detect Hard Sip/Puff

36

Summary of Contents for FPS

Page 1: ...QuadStick A Gamepad for Quadriplegic Gamers User Manual...

Page 2: ...itz owner of Quad Control for making mouth operated joysticks and other control devices for quadriplegics for three decades and who s counseling advice and experience have guided many aspects of the Q...

Page 3: ...ference in a residential installation This equipment generates uses and can radiate radio frequency energy and if not installed and used in accordance with the manufacturer s instructions may cause in...

Page 4: ...ement 3 Table of Contents 4 Illustration Index 8 Index of Tables 8 Introduction 9 Inputs 9 Outputs 9 Spreadsheets 10 Connections 10 The Quadstick Manager Program 11 Hardware Features 12 Front 13 Diffe...

Page 5: ...hannel selection 31 QuadStick Menu 31 Changing Profiles 34 Selecting Output Names for PlayStation and XBox 35 Preferences 36 USB Emulated Devices 40 Intro 40 Human Interface Devices 40 Flash Drive 40...

Page 6: ...tendo Switch 65 Connecting Devices and Hosts to the USB A port 66 Host mode 66 Dual Shock 4 66 UltraStik 360 66 Mayflash F300 Fightstick 67 Device Mode 67 Connection Examples 68 Quadstick to PS4 Direc...

Page 7: ...The Singleton default configuration 85 Voice Commands 87 Vocola files 88 Appendix 92 OSK Shortcut 92 Cleaning Mouthpiece 94 7...

Page 8: ...28 Illustration 9 Input Sensor Dropdown List 29 Illustration 10 QuadStick Spreadsheet Menu Commands 31 Illustration 11 PS3 Buttons Controls 42 Illustration 12 Mouse Buttons Controls 45 Illustration 1...

Page 9: ...ns for the lip position sensor and external inputs The joystick position sip puff lip sensors and optional external switches are used to generate Input signals to the Quadstick which are then used to...

Page 10: ...a menu command to a CSV file that is transferred to the Quadstick s flash memory by the Quadstick Manager Program or manually using a PC s file manager The Quadstick can contain many configuration fi...

Page 11: ...e configuration file management Voice commands interface Voice command file management Firmware updates External pointers interface for UltraStik 360 Joystick PC Mouse Tobii Eye gaze TrackIR head trac...

Page 12: ...Hardware Features 12 Illustration 1 Front View of Original model Illustration 2 Front View of FPS model...

Page 13: ...which the mouthpiece is attached An extra spring is used to help hold up the weight of the mouthpiece and Lip button assembly and stiffen the movement In the FPS model a larger and stiffer joystick mo...

Page 14: ...9 Auxiliary Digital Inputs for 8 way external joystick Alternative USB connection to host using a USB A to USB A cable 3 Output Jack 3mm stereo jack with two optically isolated outputs 4 Input Jack 3m...

Page 15: ...urn below the Deactivation Threshold before the signal will release When either Soft or Hard pressure signals are active the pressure above the higher threshold can be used as an analog value like wit...

Page 16: ...ations is typically used but the capability is there when needed for special situations The soft hard pressure thresholds and the time delay for detecting a soft Sip Puff are adjustable by the user 16...

Page 17: ...riple_sip Mouthpiece Hard Sip All Three sip puff sensors instant mp_triple_puff Mouthpiece Hard Puff All Three sip puff sensors instant mp_left_sip_soft Mouthpiece Soft Sip Left sip puff sensor delay...

Page 18: ...tion_minimum 9 percent Defines center dead zone Percent of physical movement joystick_deflection_maximum 30 percent Defines physical deflection scaled to 100 Signal deflection_multiplier_up 140 percen...

Page 19: ...ue for this setting is for circle 1 If you prefer the action of the original square dead zone instead the preference can be set to 0 in the misc tab in the QuadStick Manager Program by turning off the...

Page 20: ...zone For instance starting at North the joystick can be moved from the Green area into the Blue Green Gray area towards either NE or NW and still maintain the North signal It can move back into the G...

Page 21: ...instant NW Joystick Outer ring North West zone instant N_inner Joystick Inner ring North zone delay NE_inner Joystick Inner ring North East zone delay E_inner Joystick Inner ring East zone delay SE_in...

Page 22: ...o input circuits Tip Ring and Shield or Ground Two switches may be connected using the following circuit Input Name Description Delay digital_in_1 Input Jack Tip to Shield SW1 instant digital_in_2 Inp...

Page 23: ...using the circuit below Input Name Description Delay digital_in_3 USB A Data to Gnd SW2 instant digital_in_4 USB A Data to Gnd SW1 instant Table 3 External Digital Inputs 3 4 The Quadstick can detect...

Page 24: ...to Shield SW1 instant digital_in_6 Input Jack Ring to Shield SW2 instant Table 4 External Digital Inputs 5 6 When using two Switches in this manner the lip sensor is inoperative Summary The goal of th...

Page 25: ...e Google Drive Spreadsheets The free Google Drive Spreadsheet cloud service is used for creating and modifying configuration files When a new configuration is ready to be loaded into the Quadstick the...

Page 26: ...Typical mode sheet 26 USB vs Bluetooth Channel Outputs Inputs Function Sheet name...

Page 27: ...uts column indicates the end of the list any outputs following an empty cell will be ignored A blank cell in an Inputs column means the Output is off in that mode It is permitted to have more than one...

Page 28: ...Dropdown list for Outputs 28 Illustration 8 Output Commands Dropdown List...

Page 29: ...Dropdown list for Inputs 29 Illustration 9 Input Sensor Dropdown List...

Page 30: ...Dropdown list for output Functions 30...

Page 31: ...the mouse The Mouse mode sheets would have the Channel set to Bluetooth while the Game controller sheets would be set to USB The Bluetooth module has multiple uses which will be described in detail la...

Page 32: ...Display Button Mapping will display an image of a game controller with the current mode sheet s button assignments 32...

Page 33: ...The Reference Card command will add a new sheet that contains a summary of the IO assignments that may be printed and used the remind the user of configuration details 33...

Page 34: ...n both four and five stay on and the pattern repeats The sum of the LED numbers indicates the mode number up to 15 increment_mode normal right_sip decrement_mode normal right_puff Since the command to...

Page 35: ...Right Button Left Puff L2 LT Left Trigger Right Puff R2 RT Right Trigger Left Soft Sip select Right Soft Sip start Left Center Sip L3 Left Thumb Right Center Sip R3 Right Thumb Center Soft Sip home G...

Page 36: ...scaled to 100 Signal deflection_multiplier_up 140 percent Adjusts joystick deflection value in the UP direction deflection_multiplier_down 130 percent Adjusts joystick deflection value in the DOWN dir...

Page 37: ...uetooth_connection_mode pair Bluetooth pairing control bluetooth_throttle 15 ms Bluetooth mouse report interval in ms enable_swap_inputs 0 Allow user to swap inputs with Lip sensor enable_select_files...

Page 38: ...tick in a game controller mode then adjust the mouse speed second The mouse_response_curve setting can make the mouse less sensitive near the center position and move much faster when the joystick is...

Page 39: ...lue can replace many of the values in prefs csv or a Preferences page Finally any preference value found on a mode sheet in a game configuration file has the final say for the value The Preferences fo...

Page 40: ...hat consists of Gamepad Mouse and Keyboard Devices These devices are generically called Human Interface Devices HID They each have a specific data report they send to the host over the USB connection...

Page 41: ...option or convenient 4 PS4 compatible mode Gives access to Touchpad Gyro and Accelerometers outputs 5 Nintendo Switch Works for games that do not require motion controls The preference variable that...

Page 42: ...ame console While several of the buttons appear to be simple on off switches in comparison to joysticks or triggers which are obviously analog almost all the buttons measure the pressure too The X Cir...

Page 43: ..._up PS3 Left Joystick Up left_joy_down PS3 Left Joystick Down right_joy_left PS3 Right Joystick Left side right_joy_right PS3 Right Joystick Right side right_joy_up PS3 Right Joystick Up right_joy_dow...

Page 44: ...calculated from the Square of the deflection from the center position not in linear proportion to the deflection This gives the ability for slow and fine control near the center position but also a sm...

Page 45: ...l Up rotation mouse_wheel_down Mouse Wheel Down rotation mouse_pan_left Mouse Pan Left tilt mouse_pan_right Mouse Pan Right tilt mouse_back Mouse Button Back mouse_forward Mouse Button Forward mouse_l...

Page 46: ...by one of the sensor inputs or by a sequence of inputs in a specific order The Quadstick can press up to six keys simultaneously plus the Windows Shift Control and Alt keys These example rows are fro...

Page 47: ...ad_caret kb_enter kb_f22 kb_keypad_percentage kb_escape kb_f23 kb_keypad_less_than_sign kb_backspace kb_f24 kb_keypad_greater_than_sign kb_tab kb_execute kb_keypad_amp kb_space kb_help kb_keypad_amp_a...

Page 48: ...lation Preferences Preference Value Units Description digital_out_1 0 on off Initial output state for relay 1 digital_out_2 1 on off Initial output state for relay 2 enable_DS3_emulation 1 Switch to p...

Page 49: ...ll both work with x360ce The primary difference is the Left and Right Triggers get converted as buttons with mode 0 and as Analog axes in mode 2 Full instructions for x360ce itself can be found on the...

Page 50: ...The following screen captures show setting up x360ce for Rocket League in Steam 50...

Page 51: ...51...

Page 52: ...Next start the game and it should respond to the QuadStick as an XBox 360 controller 52...

Page 53: ...mes still need a mouse or keyboard for some functions while playing or the game does not tolerate switching in and out of the XBox 360 mode When the Quadstick switches the USB emulation mode it discon...

Page 54: ...mode 4 This requires setting the USB emulation in the prefs csv file instead of a game configuration file The Quadstick Manager Program has a setting on the Misc tab to accomplish this When the Quads...

Page 55: ...x_left normal left acceleration_x_right normal right acceleration_y_fore normal up acceleration_y_aft normal down acceleration_z_up normal up acceleration_z_down normal down gyroscope_y_cw normal left...

Page 56: ...Switch will go back to sleep Since the Quadstick will not be in the NS mode with it starts up the user will need to quickly select the correct game file that has the protocol emulation set to 5 and t...

Page 57: ...oot in PS4 mode To eliminate a brief interruption in the connection every seven minutes connect the Dual Shock 4 DS4 controller that came with the console to the USB A connector on the back of the Qua...

Page 58: ...special situations like when combining the Quadstick with other 3rd party devices When using the CronusMax Plus the CronusMax Full Crossover method is recommended The PS4 continuously tests for a lic...

Page 59: ...to one port on the hub and the Quadstick connects to another If U A continues to flash on the CronusMax display reverse the order of the ports Enable PS4 Partial Crossover must be OFF In CronusPro Al...

Page 60: ...USB emulation mode at any time when used with Partial Crossover Support This allows an individual game configuration spreadsheet to contain a Preference sheet with the Error Reference source not found...

Page 61: ...ax but they can also be selected by using a combination of controller buttons on the Quadstick if that feature is enabled in the Options dialog box in CronusPro In the Default Configuration a soft sip...

Page 62: ...To remap the Right Analog Stick to control the location the touchpad is touched hold Select press Circle select normal mp_right_puff_soft circle delay_on 100 mp_right_puff_soft 62...

Page 63: ...hpad support is limited to Pressing the touchpad in the center Using PCPROG with QMP In the QMP Misc tab check Enable CronusMax See QMP External Pointers for using the UltraStik 360 or other mouse poi...

Page 64: ...is with the PS4 Remove the battery pack from the game controller to ensure it turns off after authenticating the CronusMax Full instructions are available on the CronusMax com website Without a USB H...

Page 65: ...will go back to sleep A Quadstick needs to be changed from the default configuration to a Switch game configuration file that has USB emulation mode 5 and the A button pressed within 45 seconds If th...

Page 66: ...eight large buttons Dual Shock 4 When used for authentication with a PS4 the DS4 is simply plugged into the USB A port and left off Turn on the console from the front panel The DS4 will appear to be...

Page 67: ...Preferences sheet controls which port is active Preferences Preference Value enable_usb_a_device 1 Do not set the value of the enable_usb_a_device to 1 in the prefs csv or default csv files You may l...

Page 68: ...0 F3 00 0 or 4 Any CronusMax PCPROG with PS4 PC US360 F3 00 0 2 or 4 Any Brook PS3 to PS4 Super Converter BSC US360 F3 00 0 or 1 Any XBox One Brook PS3 PS4 to XBox One Super Converter BSC US360 F3 00...

Page 69: ...PS4 PlayStation 4 console 0 PS3 compatible game controller Mouse Keyboard and Flash drive DS4 Dual Shock 4 controller 1 Dual Shock 3 emulation Game controller only PS3 PlayStation 3 console 2 X360CE...

Page 70: ...t the connection between the Quadstick and the PS4 will be briefly interrupted every seven minutes Some games will react to the interruption however many others are not affected by it If switching fro...

Page 71: ...e HID firmware Three parameters that control the module are adjustable in the Preferences section of the configuration Bluetooth_device_mode mutually exclusive keyboard game_pad mouse combo keyboard m...

Page 72: ...luetooth radios from any nearby WiFi devices may improve throughput The connection mode for PCs is almost always pair and the Auth mode is usually 2 or 4 Try 2 first If 4 is used if prompted for a pai...

Page 73: ...0mAh or similar instead of receiving power from a host Data Channel assignment The data destined for the mouse keyboard or game controller outputs is sent to the USB port by default When using the Blu...

Page 74: ...be more conveniently controlled in the Bluetooth section of the Misc tab in the Quadstick Manager Program In this example the RBA has the Bluetooth Address of 0006668CE2E7 Your RBA will differ The twe...

Page 75: ...similar to the following row on a mode sheet digital_out_4 normal bluetooth_status The main Quadstick controls the Bluetooth connection and will keep trying to establish a connection with the RBA unt...

Page 76: ...e Android host instead of using Bluetooth and being powered by another source The catch is the Android device will not accept external power while in this mode unless Rooted and running special softwa...

Page 77: ...d table ir_play Xmit IR code from command table ir_stop Xmit IR code from command table ir_fast_forward Xmit IR code from command table ir_rewind Xmit IR code from command table ir_skip_forward Xmit I...

Page 78: ...x2 0000 006D 0022 0000 00ad 00ad 0015 0041 0015 0041 0015 0041 0015 0015 0015 0015 0015 0015 0015 0015 0015 0015 0015 0041 0015 0041 0015 0041 0015 0015 0015 0015 0015 0015 0015 0015 0015 0015 0015 00...

Page 79: ...2 21 22 21 22 64 22 64 22 64 22 64 22 64 22 1820 0000 006D 0000 0022 00ac 00ac 0016 0040 0016 0040 0016 0040 0016 0015 0016 0015 0016 0015 0016 0015 0016 0015 0016 0040 0016 0040 0016 0040 0016 0015 0...

Page 80: ...files will be erased and must be rewritten to the flash drive from a backup copy or a fresh download from a configuration spreadsheet The QMP has a tab for firmware updates that automates the process...

Page 81: ...rive 2 Download the desired Joystick bin firmware from http fw quadstick com 3 Copy the Joystick bin file into the Quadstick s flash and wait for the Quadstick to reboot It can take a minute or two 4...

Page 82: ...location The QuadStick uses the velocity of the joystick dropping to a low value to determine the user s intention and flashes the center Blue LED when it registers that location while recording the...

Page 83: ...83 Illustration 15 Pattern for Letter I Illustration 16 Pattern for Letter K...

Page 84: ...84...

Page 85: ...pointer mode mode 1 where the joystick movement controls the mouse location The puff is mapped to Left Mouse Button sip mapped to Right Mouse Button and the soft puff mapped to the Middle Mouse Butto...

Page 86: ...eyboard OSK with a ctr alt K see appendix then a soft sip followed by moving the joystick to the South East corner then back to the center will open the OSK and return the Singleton to the Mouse mode...

Page 87: ...contained in VCH files which are imported by the VCL file The commands are sent through a serial connection either via Bluetooth a serial cable connected to the Input jack or when Commands over USB i...

Page 88: ...mmands It includes two VCH files _qs_common vch and _includes vch _qs_common vch contains the voice commands that are considered common to all games _includes vch is automatically generated by the QMP...

Page 89: ...Command 1 1 2 200 Command seen by Quadstick dpad_n 1 50 200 Example press and hold Circle button continuously until new command or reset Vocola file buttons on Command 1 1 100 1 Command seen by Quads...

Page 90: ...button down with 100 force Select Off Releases button Start Toggle Releases or Holds button Left One Left Two Left Three Right One Right Two Right Three D Pad North D Pad Up North East D Pad Up and Ri...

Page 91: ...Xray Home Select Start Clear Clears out Swap funtion Quadstick Control Reset All outputs cleared Quit Stop Mode Switch directly to mode Full Screen Toggles Full Screen display Help Display help text...

Page 92: ...ernal values Preference settings can be changed via command The general command format is preference_name new value Examples Vocola file set volume pct Command volume 1 When set volume 25 is spoken th...

Page 93: ...6 In the Shortcut key field simultaneously press Ctrl Alt k 7 Click on OK and test the shortcut 93...

Page 94: ...locking the air holes can be pushed out from the barbed fitting end with a small wire or compressed air Soaking can help In multi user settings individual mouthpieces are recommended Contact QuadStick...

Reviews: