-
Notifications
You must be signed in to change notification settings - Fork 0
Troubleshooting
If the Aquarius+ computer is power cycled (turned off and then on), or if it's ESP32 is reset (CTRL+SHIFT+ESC) while an Aq+ Gamepad is connected, the Aq+ Gamepad's main LED will remain BLUE, thinking it is still connected, even though the connection has been broken. This leaves the Aq+ Gamepad in a state where the unit can't be reconnected to.
To fix:
- Make sure the USB micro charging cable is not attached to the Aq+ Gamepad
- Power cycle the Aq+ Gamepad using the switch on the back while the Aquarius+ computer is on and Bluetooth is enabled
- The unit's main LED should start out CYAN and then turn BLUE
- It should show up in the Overlay setting menu as a Connected device
The first Aq+ Gamepad that is connected via Bluetooth to the Aquarius+ at start up is assigned to Hand Controller 1, and can be used to navigate the Overlay settings menu:
- First, enable the Allow Gamepad navigation setting option in the Overlay menu
- Second, the Aq+ Gamepad must be turned on, paired, and connected to the Aquarius+ as the FIRST controller attached
- Third, if you've swapped button rows (1 2 3) <> (4 5 6), your Activate (Button 4) and Back (Button 5) will now be on the other row of buttons
- Finally, the Aq+ Gamepad must be in DPAD mode rather than Analog mode to navigate up and down the Overlay menu list
The Aq+ Gamepad uses a standard thumbstick component with two potentiometers that register 0 - ~5226 on both the X and Y axis, usually with a value of ~2613 as the middle range. While a small "dead zone" has been created in the center to compensate for this and create stability when at rest, it doesn't always block out values that are just beyond it. This is because while the thumbstick components are MOSTLY the same, they are not rigorously tested or calibrated, as they are commodity items. As such, the X and Y values have to be trimmed to better center the stick.
To reset or calibrate the Aq+ Gamepad:
- Connect the Aq+ Gamepad to a computer configured to communicate via serial terminal (i.e. Arduino IDE Serial Monitor)
- Within the terminal window, type ? and ENTER to see the available menu of commands
- Run a diagnostic by typing D and ENTER. If in any of the 10 rows the following conditions are true, an auto-trim is needed:
- The second column (dataOut) shows anything other than 0b100000000
- Either the fourth (rawX) or seventh (rawY) columns show values that are below 2560 or above 2660
- Run auto-trim by typing T and ENTER. The system will auto-trim the X & Y values.
The battery management circuitry on the Aq+ Gamepad ensures that an approved LiPo battery pack will charge safely and consistently. As such, while the reporting of the battery level may be a bit off, the circuit itself is managing it correctly. Similar in the way in which the X and Y values for the thumbstick are reported based on electrical values on those sense pins, the battery is subject to the same fluctuations.
Two preferences are saved within the Aq+ Gamepad, a maximum battery value that saves the top end range of the analog value output from the battery (managed by the battery management circuit), and a battery trim value that can be used to better update the "perceived" top end of the battery to normalize to 100% when charging has stopped (no RED charging light).
To update this:
- For proper calibration of the battery level, the battery must be fully charged:
- A battery that is not fully charged will have a red light glowing when it is plugged in via USB micro to either a computer or a power source
- A battery that is fully charged will NOT have a red light glowing when it is plugged in
- Connect the Aq+ Gamepad to a computer configured to communicate via serial terminal (i.e. Arduino IDE Serial Monitor)
- Within the terminal window, type ? and ENTER to see the available menu of commands
- Run a diagnostic by typing D and ENTER. If the tenth column (rawBatt) in any of the 10 rows show values that are below 2560 or above 2660, a calibration is needed.
- Run auto-set max battery level by typing M and ENTER. The system will auto-adjust the max battery value.
- Ensure the Aq+ Gamepad and Arduino IDE are set-up correctly
- If you're using a different terminal program, your settings must match the ones indicated in the set-up section, particularly line terminations MUST ONLY be New Line, not NL + CR, etc.