Welcome to ROSMASTER M3 repository
1.Quick start handle to control the car
Quick Start Guide to Controlling the Car with a Handle
Quick Start Guide to Controlling the Car with a Handle1. Course Content2. Disable Handle Control3. Disable Auto-start for Handle and Chassis Agent3.1 Disable Handle Auto-start3.2 Disable Chassis Agent Auto-start
1. Course Content
- Plug the handle receiver into the mainboard or the HUB expansion board. After the car is powered on, the system will automatically connect to the agent and start the handle control program.
- Press the [START] button on the handle to activate it.
| Handle Action | Function |
|---|---|
| Left Stick Up/Down | Car moves forward/backward straight |
| Left Stick Left/Right | Car translates left/right |
| Right Stick Left/Right | Car rotates left/right |
| "START" Button | End sleep mode / Control buzzer |
| Left Stick Press | Adjust X/Y axis linear speed |
| Right Stick Press | Adjust angular speed |
| Right Button 1 | Switch ambient light mode |
This section is a quick start tutorial. For a more detailed tutorial on handle control, please refer to the [01.Chassis Control Course-02.Handle Control] tutorial.
2. Disable Handle Control
- When the handle is not needed, you can close the window running the handle control program. As shown in the figure below, press
ctrl+cto close this terminal.

3. Disable Auto-start for Handle and Chassis Agent
[!IMPORTANT]
- It is recommended to disable the auto-start function for the chassis agent and handle control when you need to connect to the network later. This function is for convenient testing during initial use.
- The reason is that if the system connects to the network, it will calibrate the local time after entering the system. If the chassis agent starts before the network time calibration, the agent's timestamp will not match the system time after networking, resulting in no data from the radar and IMU.
3.1 Disable Handle Auto-start
If you want to permanently disable the handle control auto-start function, follow these steps:
- Enter in the terminal:
mv ~/.config/autostart/joy_control.desktop ~
- To restore the handle control auto-start, copy the file back to the
~/.config/autostart/directory.
xxxxxxxxxxcp ~/joy_control.desktop ~/.config/autostart/
3.2 Disable Chassis Agent Auto-start
Similarly, if you want to permanently disable the chassis agent auto-start function, follow these steps:
- Enter in the terminal:
xxxxxxxxxxmv ~/.config/autostart/agent.desktop ~
- To restore the chassis agent auto-start, copy the file back to the
~/.config/autostart/directory.
xxxxxxxxxxcp ~/agent.desktop ~/.config/autostart/