You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: TroubleshootingGuide.md
+3-4Lines changed: 3 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,10 +1,10 @@
1
1
# Based on common issues reported by users:
2
2
3
3
## Configuration Changes Not Taking Effect:
4
-
Symptom: Updated configurations (e.g., buttin coutn, button mappings, device name, HID settings) are not reflected when reconnecting to the host device.
4
+
Symptom: Updated configurations (e.g., button count, button mappings, device name, HID settings) are not reflected when reconnecting to the host device.
5
5
Cause: Many host operating systems cache Bluetooth device characteristics (e.g., device name, button configurations, and HID descriptors) for faster reconnections. When the ESP32 configuration changes, the cached data may no longer match the updated settings, leading to inconsistencies.
6
6
Solution:
7
-
- If you modify the BLE Gamepad configuration, such as device name, device features, button count or button assignments, you must remove the previously paired connection from the host device (PC, mobile, or console).
7
+
- If you modify the BLE Gamepad configuration, such as device name, device features, button count or button assignments, you must remove the previously paired connection from the host device (PC, mobile, or console).
8
8
- Go to the host's Bluetooth settings, locate the ESP32 device, and select "Remove," "Delete," "Unpair," or "Forget."
9
9
- Restart both the ESP32 and the host device, then re-pair them to ensure the updated configuration is applied.
10
10
@@ -36,7 +36,7 @@ Solution:
36
36
Symptom: The ESP32 takes a long time to connect or fails to connect intermittently.
37
37
Solution:
38
38
- Ensure that the ESP32 is in close proximity to the host device to avoid signal interference.
39
-
Check for any power supply issues; unstable power can affect Bluetooth performance.
39
+
-Check for any power supply issues; unstable power can affect Bluetooth performance.
40
40
- Update the ESP32 firmware and the BLE-Gamepad library to the latest versions, as updates often include connectivity improvements.
41
41
42
42
## High Latency or Unresponsive Controls:
@@ -52,4 +52,3 @@ Solution:
52
52
- Consult the ESP32 pinout to ensure that the selected pins support the desired functions.
53
53
- Avoid using pins that are reserved or have dual functions that might interfere with input readings.
54
54
- Test the pins independently to confirm their functionality before integrating them into the gamepad setup.
0 commit comments