Skip to content

README_EN.md

Latest commit

 

History

History
68 lines (49 loc) · 2.9 KB

README_EN.md

File metadata and controls

68 lines (49 loc) · 2.9 KB

gamepad Instructions

简体中文

This project enables listening for physical button trigger events on the gamepad via UDP communication on the remote host. Developers can use this project to obtain real-time triggering information of physical buttons on the controller and develop your own robot remote control programs based on this information.

1 Code Download and Compilation

Clone the code repository onto the development PC and compile it:

git clone --recurse-submodules https://github.com/DeepRoboticsLab/gamepad.git
mkdir build && cd build
cmake .. -DBUILD_EXAMPLE=ON
make -j4

[Caution] The program listens for controller data on port 12121 by default. Please ensure that the port is not being used by other programs. If needed, you can modify the port number by opening the corresponding file in the /example directory:

  • For the Jueying Lite3 controller, modify example_retroid.cpp
  • For the Jueying X30 controller, modify example_skydroid.cpp
//Using example_retroid.cpp as an example
int main(int argc, char* argv[]) {
  RetroidGamepad rc(12121); 
  //RetroidGamepad rc( Port number for receiving handlebar commands )
  InitialRetroidKeys(rc);
  ......
}

After modifying the port number in the respective file, you can proceed with compiling the program.

 

2 Program Execution

  • Both the Lite3 and X30 official controller come with the controlapp.apk pre-installed. After installation, The interface after installation is shown in the figure below:

    a

  • Connect the controller to the development PC's network, then open the app. Click the button in the top-left corner to configure the IP address of the development PC that needs to be connected and the port number for the program to receive controller data. The image below uses the Lite3 official controller Retroid as an example.

    a

    App display interface

    s

    IP configuration interface

  • Run the Program:

    • Jueying Lite3 controller: 
      cd build/
./example/example_retroid
    • Jueying X30 controller: 
      cd build/
./example/example_skydroid

  • Press the physical buttons on the controller, and the terminal will display the trigger information of the controller's physical buttons:

    a

    Skydroid controller communication successful display interface

    s

    Retroid controller communication successful display interface