Jump to content
Sign in to follow this  

Swiftpoint Z FAQs and Troubleshooting

Recommended Posts

What are the starter mappings, and what do they do?

When you install the driver we load up some mappings to help get you started and show a few examples of how The Z can be configured. You can use these mappings and customize them, or delete them altogether - they can always be imported again from your   / Documents / Swiftpoint Settings folder.

Global Defaults
Mappings defined in the ‘Global Defaults’ will carry through to all profiles unless they are specifically overridden.

Configure Mode

  • Lift the mouse and look at the OLED screen (tilting the mouse past 25 degrees to the right) – this automatically changes to ‘config mode’

When in configure mode (tilted):

  • Scroll Up & Down to decrease / increase DPI
  • Click the Front Edge Buttons to cycle through profiles
  • Pull the Left Trigger Button to cycle through OLED displays

Pulling the right trigger (with the mouse flat),  reset / zeroes the  Tilt and Pivot  Angles

Desktop Profile
This is set up as the Default Active Profile loaded on The Z

  • Push Left Trigger to switch between two open applications
  • Push Left Trigger and move the mouse to select any open application
  • Push Right Trigger to switch Next Tab in a browser
  • Push Right Trigger and move The Z left and right to navigate the Browser Tabs
  • Click the Left Fingertip Button to select multiple items (performs a <CTRL> + Left Click)
  • Deep Click (push  harder) Left Fingertip to close the current tabe (<CTRL> + <F4>)

Gaming Profiles
We have included  gaming profiles that map most of The Z functions to joystick buttons (including tilts and deep clicks).

There are two gaming profiles, Gaming Gestures and Gaming Analog.

  • Gaming Gestures maps joystick buttons to all buttons deep clicks and tilt gestures.
  • Gaming Analog   is the same as the Gestures Profile except that it maps tilting to joystick analog movement, which is   ideal when using the flight extender accessory in a driving or flying in a game. We've set up  the  right trigger button to reset the tilt and pivot angles -  holding down right trigger while pivoting left and right will output joystick rotate (yaw).

If you wanted to make some changes to a gaming profile that are specific to a game, then an easy way to do this would be to set up a sub-profile under one of these gaming profiles, with the name of the game, and just create the mappings that you want to override.

Taking a close look at the starter mappings in the Driver, is a great way to see some of the configuration capabilities , and  will be a  great learning tool,   when it comes to creating  your own mappings.

Force percentages differ on the left and right buttons, or don’t go to 100%?
The force sensors are designed to work at full sensitivity in the center of the buttons, so clicking on the edges means it may not register a full force.
The Z's are calibrated at the factory so that the readings are the same on both the left and right side, but we've heard from a few users that, by the time the mouse reaches them (after travelling with vibration and low temperatures in an aircraft hull), the calibration can change and the percentage values can read differently on each side.
This isn’t a problem, however, as you can set a threshold percentage that gives you the right feel for a 'deep click', independently on each button.
We’d like the percentages shown to be similar on both sides when the same force is applied (even if the calibration changes), so we are developing an 'auto calibration' process in the firmware, that will re-calibrate when the mouse is turned on and show more user-friendly / matching percentages.

Pushing the scroll wheel to the right activates a button, but to the left does not.
This behavior from the Z's scroll wheel is normal and is just due to the scroll-wheels pressure sensor being on its right side.
Which means if you push the scroll wheel to the right it will still actuate the middle mouse button, while pushing it to the left will lift the scroll wheel from the sensor.

Can I use the Z with my USB Hub?
When possible it is recommend to connect your Z directly to your computers USB ports. But if a USB hub is required it is recommended that you use a powered hub.

I can't change profiles using config mode?
You may be stuck on the "Global Defaults" Profile. Simply set one of the other profiles to active in the driver and you will be able to cycle through them again.

Mouse button outputs 6-16 are not working?
While mouse buttons 6-16 are technically "standard" mouse outputs, unfortunately they are not very widely supported by applications; since so few mice actually use these outputs. We have made them available as they are still useful in application that do support them. 
If you are setting up a general profile for your Z we would instead recommend mapping keyboard keys to your extra mouse buttons, as they will be recognized by practically any application.

Joystick functions work in game ‘A’, but not in game ‘B’?
When you plug in The Z Mouse, the PC automatically recognizes it as an analog controller, meaning any game that has an analog joystick support will interpret The Z’s pitch, roll  and yaw as an analog joystick movement.

If your joystick mappings are not being recognized in a particular game, it's likely that the game has XBox controller (Xinput) support, and does not support a standard analog joystick (DirectInput).   We will be adding Xinput support in the future, but, but for now you still have a couple of options for working around this.

In most cases the easiest way would be to assign your Zs buttons to keyboard commands rather than joystick.
Where that is not an option, (e.g if you need analog outputs) you can use a tool to map the Zs "DirectInput" outputs to "XInput" inputs. Further details on how to do this can be found in our guide here.

Z's joystick capabilities are interfering with my other Joystick; or adversely effecting controls in specific games.
The Z's joystick functions can be disabled temporarily within Device Manager. Which can be accessed via control panel, or by right clicking the Start Menu.

Within device manager expand the "Human Interface Devices" section, then find the "HID-compliant game controller". Right click it and select "Disable Device". This will prevent any of your games from recognizing the Z as a joystick until you re-enable this device in Device Manager.


Alternately if you are not on Windows, or have your settings saved to flash memory. You can disable the Z's joystick output by unplugging your Z then holding down the "Top Thumb Button" and "Left Trigger Push" while you plug it back in. Just note that this will prevent the driver from detecting your Z until it is unplugged again.

Can I prevent the driver from launching on startup? 
In Windows 10 this can be done from the Task Manager. Which can be opened with "Ctrl + Shift + Esc" or right clicking the taskbar.
In the task manager window just select the Startup tab, then find the Swiftpoint Driver in the list and click Disable.

Can I use my custom profiles without the driver (Linux, Mac, PS4, XBOX etc.)? 
All of the settings you can customize in the driver can be saved to the Z's flash memory so they can be used on systems without access to the driver.
This option can be found in the drop-down menu at the top left of the driver window. Listed as "Save Mappings to Permanent Flash Memory in Mouse".

"Something went wrong" error during firmware update.
If you encounter this error consistently, or have trouble with your Z after it occurs please contact us here so we can get this resolved for you.

My character is sometimes shooting constantly without my input in Battlefield 4/Hardline?
This behavior can be corrected by removing the joystick "Trigger 2" key-bind from Fire under the on foot category in Battlefield.


Mappings that toggle a button press on and off are not working?
To prevent buttons from accidentally being stuck down if you forget to add a Release output to correspond to each Press. The Z's firmware has a fail-safe which releases all buttons if the Z is not currently processing any user input. So a press command will automatically release if the Z is not tilted, no buttons are physically held down, or no macros are running.
If you want to allow toggle functions you can effectively disable this fail-safe by creating a loop of wait commands that triggers on profile switch as shown below.



I frequently need to reset my Zs tilt angles for my tilt outputs to work correctly.

This behavior from your tilt inputs may be caused by the auto-calibration system the Z is currently using.

This system is intended to ensure the Zs tilt levels do not drift over time, but there are certain use cases where it can make matters worse. So we are looking at making adjustments to the calibration system to correct this.

In the meantime though there is a workaround to disable the auto calibration entirely. Which should result in more consistent performance for anyone who is currently needing to reset their tilt angles frequently.

The auto-calibration system works by re-zeroing tilt angles if the Z is at a consistent tilt level close to zero while the mouse is moving. So to disable it you can intentionally mis-calibrate one axis to prevent the Z from ever auto calibrating the other.

This works because the tilt angles will never be close enough to zero for the auto-calibration to kick in.

The steps to do this are as follows.

  1. Ensure you have a reset tilt angles mapping on your Z. By default this will be set to right trigger pull.
  2. Set your OLED display to Tilt Angles, either with the driver or by tilting the Z into config mode then pulling the left trigger.
  3. Put your Z flat on your mouse mat and reset your tilt angles to ensure the "R" value on the OLED screen is correctly showing zero.
  4. Now lean your Z forward, keeping the "R" value at zero, but reducing the "P" value into negatives. The easiest way to do this is to leave the front of your Z on the mouse mat and lift it up slightly from the back
  5. When your Z is in a position such that "R" is zero and "P" is close to negative two, reset tilt angles again.
  6. Now put your Z back down flat on the mouse pad and check that "R" is still correctly at zero, while "P" close to two . If it's not go back to step three and try again.

We plan to rework the auto-calibration system, and also give the option to disable it within the driver so these steps are not necessary. 

The OLED screen on my Z is no longer working.

Please try performing a reset of your Z with the steps below and confirm if there is any response from the screen.

  1. Unplug your Z.
  2. Hold down the main left and right mouse buttons.
  3. Plug your Z back in while continuing to hold both mouse buttons.
  4. A countdown should be displayed on the OLED screen along with the logo backlight flashing red and the mouse vibrating.

The Z is outputting the incorrect keyboard keys.

This issue is due to the fact that the Z operates as a US QWERTY device, and windows does not support multiple devices with different keyboard layouts correctly.  So if you are using a non US QWERTY keyboard, some of the Z's outputs will be modified by windows to match your keyboard layout.

Hopefully we can add other keyboard layout options for the Z in a firmware or driver update. But for now the only solution is to keep the conversion in mind when you are setting up your mappings.

So when you want to send a key that has a different position on a QWERTY keyboard, look at the position of the key you want to output on your keyboard, then output the QWERTY key in this position instead (adding a Shift Modifier when required). When windows receives this key it will then translate it back into the key you wanted.


  • Thanks 1

Share this post

Link to post
Share on other sites
Sign in to follow this  

  • Create New...