Add some troubleshooting suggestions

Author: LeeNX

README.md

@@ -127,6 +127,9 @@ Battery level can be set during operation by calling, for example, bleGamepad.se
 Update sent on next gamepad update if auto reporting is not enabled
 
 
+## Troubleshooting Guide
+Troubleshooting guide and suggestions can be found in [TroubleshootingGuide](TroubleshootingGuide.md)
+
 ## Credits
 Credits to [T-vK](https://github.com/T-vK) as this library is based on his ESP32-BLE-Mouse library (https://github.com/T-vK/ESP32-BLE-Mouse) that he provided.
 

TroubleshootingGuide.md

@@ -0,0 +1,55 @@
+# Based on common issues reported by users:
+
+## Configuration Changes Not Taking Effect:
+Symptom: Updated configurations (e.g., buttin coutn, button mappings, device name, HID settings) are not reflected when reconnecting to the host device.  
+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.  
+Solution:
+ - 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).
+- Go to the host's Bluetooth settings, locate the ESP32 device, and select "Remove," "Delete," "Unpair," or "Forget."
+- Restart both the ESP32 and the host device, then re-pair them to ensure the updated configuration is applied.
+
+## Button Mapping Issues:
+Symptom: Buttons not responding as expected or incorrect button assignments.  
+Solution:
+- Review the button mapping configuration in your code.
+- Ensure that each button is correctly assigned according to the library's documentation. 
+
+## Connection Problems:
+Symptom: The ESP32 device does not appear on the PC but is visible on mobile devices.  
+Solution:
+- Verify that your PC's Bluetooth drivers are up to date.
+- Additionally, ensure that the ESP32 is not already paired with another device, which might prevent it from appearing on the PC.
+
+## Custom Configuration Challenges:
+Symptom: Difficulties in setting up a custom configuration for the gamepad.  
+Solution:
+- Refer to the library's examples and documentation to understand the correct procedures for custom configurations.
+- Ensure that all parameters are set correctly and that there are no conflicts in the configuration.
+
+## Multiple Device Pairing Issues:
+Symptom: Inability to pair multiple devices simultaneously.
+Solution:
+- The ESP32-BLE-Gamepad library may have limitations regarding multiple device pairings.
+- It's recommended to pair and use one device at a time to ensure stable connections.
+
+## Slow or Inconsistent Connections:
+Symptom: The ESP32 takes a long time to connect or fails to connect intermittently.  
+Solution:
+- Ensure that the ESP32 is in close proximity to the host device to avoid signal interference.
+Check for any power supply issues; unstable power can affect Bluetooth performance.
+- Update the ESP32 firmware and the BLE-Gamepad library to the latest versions, as updates often include connectivity improvements.
+
+## High Latency or Unresponsive Controls:
+Symptom: Noticeable delay between input on the gamepad and action on the host device.  
+Solution:
+- Optimize the code to reduce any delays in the loop handling the gamepad inputs.
+- Minimize the use of delay functions in the code, as they can introduce latency.
+- Ensure that the BLE connection interval is set appropriately for low-latency communication.
+
+## Pin Functionality Issues:
+Symptom: Certain GPIO pins not working as intended for button inputs or analog readings.  
+Solution:
+- Consult the ESP32 pinout to ensure that the selected pins support the desired functions.
+- Avoid using pins that are reserved or have dual functions that might interfere with input readings.
+- Test the pins independently to confirm their functionality before integrating them into the gamepad setup.
+