Quadstick FPS, User Manual

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