Driving the robot using Terminal

To drive the robot using the terminal you must fulfill the following requirements:

  1. Ensure the robot is powered on.

  2. Open one terminal session that is connected to the robot (via SSH), check Connecting to the Robot for details.

  3. Wait for the robot to activate the MCB, this will lock the robot wheels, and you will not be able to manually push the robot anymore.

Note

If the robot’s wheels don’t lock automatically, manually lock them by pressing the button on the Motor Control Board (MCB). It’s the button closest to the wire connector.

Enable the MCB button

Warning

Place the robot on the ground before driving to prevent it from falling off a table.

Our robots are meant to be table-top robots and we take measures against this, however the risk is always there.

  1. In the terminal (the one already connected to the robot), run the following command:

ros2 run teleop_twist_keyboard teleop_twist_keyboard --ros-args --remap cmd_vel:=mcb/cmd_vel
  1. Focus the terminal and follow the teleop instructions to drive the robot.

Note

If the wheels are locked but the robot does not respond to teleoperation commands, restart the MCB by pressing the middle button. After that you can try driving the robot with teleop again.

Restart the MCB button

If the wheels fail to lock afterward, repeat the manual wheel-locking procedure above.


Congratulations! You have successfully driven the robot using the terminal.

If you prefer a graphical interface, follow our next guide Driving the robot through EZ-Map to learn how to control the robot using the EZ-Map UI.