LoCoBot ControlView Package on GitHub
This package contains the configuration and launch files necessary to easily start the various
components of the X-Series LoCoBot platform. This includes launching the xs_sdk node
responsible for driving the DYNAMIXEL motors on the robot, loading the URDF to the
robot_description parameter, starting the mobile base, and activating the RealSense D435 camera
and RPLidar 2D laser scanner. Essentially, this package is what all 'downstream' ROS packages
should reference to get the robot up and running.
As shown in the image above, the interbotix_xslocobot_control package builds on top of the interbotix_xslocobot_descriptions and interbotix_xs_sdk packages among many others. To get familiar with the nodes not described below, just hop over to the ROS packages in this repo that launches them.
- rplidarNode: responsible for starting the A2 RPlidar sensor and publishing
LaserScan messages on the
/<robot_name>/scantopic. See the RPLidar ROS Wiki for parameter descriptions. All parameters were left at their default values except for the following:
- kobuki nodes: a group of three nodes responsible for starting the Kobuki base. See the
Kobuki ROS Wiki for parameter descriptions. All parameters were left at their default values
except for the following:
- rs_rgbd.launch: launches four nodes to run the RealSense D435 camera and publish a
variety of image topics. Note that the base_link frame of the camera is in the depth frame
and is called
/<robot_name>/camera_link. See the realsense_ros repository for parameter descriptions. All parameters were left at their default values except for the following:
You will also notice a config directory containing many YAML files. Each file (beside the modes.yaml one) specifies the names and initial register values for all the motors that make up a specific locobot. There is also some 'meta-info' like names of joint groups, the desired joint-topic name and publishing frequency, etc... For a full explanation of each of these parameters, check out the Motor Config file template. The other file located in that directory is the Mode Config one (a.k.a mode.yaml). The parameters in there define the desired operating modes for either a group of joints or single joints, and whether or not they should be torqued on/off at node startup. See more by referencing the Mode Config file template. Typically, the Motor Config file is only defined here while the Mode Config file is also defined in any 'downstream' ROS package. This makes it easy for users to configure their desired motor operating modes depending on their project.
To run this package on the physical robot, type the line below in a terminal
locobot_wx200 is being launched with the onboard lidar and
$ roslaunch interbotix_xslocobot_control xslocobot_control.launch robot_model:=locobot_wx200 use_base:=true use_lidar:=true use_camera:=true
If you are working from a remote computer and would like to visualize the robot using RViz, open a terminal on your remote and type...
$ roslaunch interbotix_xslocobot_descriptions remote_view.launch
Note that in order for this to work, you must first run the remote installation script on your remote computer.
To further customize the launch file at run-time, refer to the table below.
|model type of the Interbotix LoCoBot such as 'locobot_base' or 'locobot_wx250s'
|name of the robot (could be anything but defaults to 'locobot')
|if true, the gripper_bar link is included in the 'robot_description' parameter; if false, the gripper_bar and finger links are not loaded to the parameter server. Set to false if you have a custom gripper attachment
|if true, the gripper fingers are included in the 'robot_description' parameter; if false, the gripper finger links are not loaded to the parameter server. Set to false if you have custom gripper fingers
|the file path to the custom urdf.xacro file that you would like to include in the Interbotix robot's urdf.xacro file
|launches RViz; if you are SSH'd into the robot, DON'T set this to true
|fixed frame in RViz; this should be changed to
<robot_name>/odom if mapping or using local odometry respectively
|if true, the base ROS nodes are launched
|if true, loads base AutoDock features (only for the Kobuki version)
|if true, the RPLidar node is launched
|set to true if the lidar is installed on the robot; this will load the lidar related links to the 'robot_description' parameter
|if true, the RealSense D435 camera nodes are launched
|types of RealSense camera filters to use (in this case, the 'pointcloud' filter is needed)
|whether to publish topics with the depth stream aligned with the color stream
|frame rate of the color images taken on the RealSense camera
|frame rate of the depth images taken on the RealSense camera
|horizontal resolution of the color images taken on the RealSense camera
|vertical resolution of the color images taken on the RealSense camera
|the file path to the 'motor config' YAML file
|refer to xslocobot_control.launch
|the file path to the 'mode config' YAML file
|refer to xslocobot_control.launch
|a boolean that specifies whether or not the initial register values (under the 'motors' heading) in a Motor Config file should be written to the motors; as the values being written are stored in each motor's EEPROM (which means the values are retained even after a power cycle), this can be set to false after the first time using the robot. Setting to false also shortens the node startup time by a few seconds and preserves the life of the EEPROM
|if true, the DYNAMIXEL simulator node is run; use RViz to visualize the robot's motion; if false, the real DYNAMIXEL driver node is run