MPX1950 Support Package

motoman_mpx1950_support/CMakeLists.txt

@@ -0,0 +1,15 @@
+cmake_minimum_required(VERSION 3.0.2)
+
+project(motoman_mpx1950_support)
+
+find_package(catkin REQUIRED)
+
+catkin_package()
+
+if (CATKIN_ENABLE_TESTING)
+  find_package(roslaunch REQUIRED)
+  roslaunch_add_file_check(test/roslaunch_test_mpx1950.xml)
+endif()
+
+install(DIRECTORY config launch meshes urdf
+  DESTINATION ${CATKIN_PACKAGE_SHARE_DESTINATION})

motoman_mpx1950_support/config/joint_names_mpx1950.yaml

@@ -0,0 +1 @@
+controller_joint_names: ['joint_1_s', 'joint_2_l', 'joint_3_u', 'joint_4_r', 'joint_5_b', 'joint_6_t']

motoman_mpx1950_support/config/opw_parameters_mpx1950.yaml

@@ -0,0 +1,20 @@
+#
+# Parameters for use with IK solvers which support OPW (Ortho-Parallel Wrist)
+# kinematic configurations, as described in the paper "An Analytical Solution
+# of the Inverse Kinematics Problem of Industrial Serial Manipulators with an
+# Ortho-parallel Basis and a Spherical Wrist" by Mathias Brandstötter, Arthur
+# Angerer, and Michael Hofbaur (Proceedings of the Austrian Robotics Workshop
+# 2014, 22-23 May, 2014, Linz, Austria).
+#
+# The moveit_opw_kinematics_plugin package provides such a solver.
+#
+opw_kinematics_geometric_parameters:
+    a1:  0.000
+    a2:  0.000
+    b:   0.000
+    c1:  0.500
+    c2:  0.725
+    c3:  0.725
+    c4:  0.100
+opw_kinematics_joint_offsets: [0.0, 0.0, deg(-90.0), 0.0, 0.0, deg(180.0)]
+opw_kinematics_joint_sign_corrections: [1, 1, -1, -1, -1, -1]

motoman_mpx1950_support/launch/load_mpx1950.launch

@@ -0,0 +1,3 @@
+<launch>
+  <param name="robot_description" command="$(find xacro)/xacro --inorder '$(find motoman_mpx1950_support)/urdf/mpx1950.xacro'" />
+</launch>

motoman_mpx1950_support/launch/robot_interface_streaming_mpx1950.launch

@@ -0,0 +1,21 @@
+<!--
+  Manipulator specific version of 'robot_interface_streaming.launch'.
+
+  Defaults provided for MPX1950:
+   - 6 joints
+
+  Usage:
+    robot_interface_streaming_mpx1950.launch robot_ip:=<value> controller:=<dx200>
+-->
+<launch>
+  <arg name="robot_ip" />
+
+  <!-- controller: Controller name (dx200) -->
+  <arg name="controller"/>
+
+  <rosparam command="load" file="$(find motoman_mpx1950_support)/config/joint_names_mpx1950.yaml" />
+
+  <include file="$(find motoman_driver)/launch/robot_interface_streaming_$(arg controller).launch">
+    <arg name="robot_ip" value="$(arg robot_ip)" />
+  </include>
+</launch>

motoman_mpx1950_support/launch/robot_state_visualize_mpx1950.launch

@@ -0,0 +1,28 @@
+<!--
+  Manipulator specific version of the state visualizer.
+
+  Defaults provided for MPX1950:
+   - 6 joints
+
+  Usage:
+    robot_state_visualize_mpx1950.launch robot_ip:=<value> controller:=<dx200>
+-->
+<launch>
+  <arg name="robot_ip" />
+
+  <!-- controller: Controller name (dx200) -->
+  <arg name="controller" />
+
+  <rosparam command="load" file="$(find motoman_mpx1950_support)/config/joint_names_mpx1950.yaml" />
+
+  <include file="$(find motoman_driver)/launch/robot_state_$(arg controller).launch">
+    <arg name="robot_ip" value="$(arg robot_ip)" />
+  </include>
+
+  <node name="robot_state_publisher" pkg="robot_state_publisher" 
+    type="robot_state_publisher" />
+
+  <include file="$(find motoman_mpx1950_support)/launch/load_mpx1950.launch" />
+
+  <node name="rviz" pkg="rviz" type="rviz" args="-d $(find industrial_robot_client)/config/robot_state_visualize.rviz" required="true" />
+</launch>

motoman_mpx1950_support/launch/test_mpx1950.launch

@@ -0,0 +1,7 @@
+<launch>
+  <include file="$(find motoman_mpx1950_support)/launch/load_mpx1950.launch" />
+  <param name="use_gui" value="true" />
+  <node name="joint_state_publisher" pkg="joint_state_publisher" type="joint_state_publisher" />
+  <node name="robot_state_publisher" pkg="robot_state_publisher" type="robot_state_publisher" />
+  <node name="rviz" pkg="rviz" type="rviz" args="-d $(find industrial_robot_client)/config/robot_state_visualize.rviz" required="true" />
+</launch>

motoman_mpx1950_support/package.xml

@@ -0,0 +1,56 @@
+<?xml version="1.0"?>
+<?xml-model href="http://download.ros.org/schema/package_format2.xsd" schematypens="http://www.w3.org/2001/XMLSchema"?>
+<package format="2">
+  <name>motoman_mpx1950_support</name>
+  <version>0.1.0</version>
+  <description>
+    <p>ROS-Industrial support for the Motoman MPX1950 (and variants).</p>
+    <p>
+      This package contains configuration data, 3D models and launch files
+      for Motoman MPX1950 manipulators.
+    </p>
+    <p>
+      <b>Specifications</b>
+    </p>
+    <ul>
+      <li>MPX1950 - Default</li>
+   </ul>
+    <p>
+      Joint limits and maximum joint velocities are based on the information 
+      found in <em>YASKAWA MOTOMAN-MPX1950 INSTRUCTIONS (HW1485452)</em>
+      version <em>185476-1CD, rev 7</em>.
+    </p>
+    <p>
+      All urdfs are based on the default motion and joint velocity limits, 
+      unless noted otherwise.
+    </p>
+    <p>
+      Before using any of the configuration files and / or meshes included
+      in this package, be sure to check they are correct for the particular
+      robot model and configuration you intend to use them with.
+    </p>
+  </description>
+  <author>Eric Marcil</author>
+  <maintainer email="[email protected]">Eric Marcil</maintainer>
+  <maintainer email="[email protected]">G.A. vd. Hoorn (TU Delft Robotics Institute)</maintainer>
+  <license>BSD</license>
+
+  <url type="website">http://wiki.ros.org/motoman_mpx1950_support</url>
+  <url type="bugtracker">https://github.com/ros-industrial/motoman/issues</url>
+  <url type="repository">https://github.com/ros-industrial/motoman</url>
+
+  <buildtool_depend>catkin</buildtool_depend>
+
+  <test_depend>roslaunch</test_depend>
+
+  <exec_depend>joint_state_publisher</exec_depend>
+  <exec_depend>motoman_driver</exec_depend>
+  <exec_depend>motoman_resources</exec_depend>
+  <exec_depend>robot_state_publisher</exec_depend>
+  <exec_depend>rviz</exec_depend>
+  <exec_depend>xacro</exec_depend>
+
+  <export>
+    <architecture_independent/>
+  </export>
+</package>

motoman_mpx1950_support/test/roslaunch_test_mpx1950.xml

@@ -0,0 +1,30 @@
+<launch>
+  <arg name="req_arg" value="default"/>
+  <arg name="dx200" value="dx200"/>
+
+  <group ns="load_mpx1950">
+    <include file="$(find motoman_mpx1950_support)/launch/load_mpx1950.launch"/>
+  </group>
+
+  <group ns="test_mpx1950">
+    <include file="$(find motoman_mpx1950_support)/launch/test_mpx1950.launch"/>
+  </group>
+
+  <group ns="robot_interface_streaming_mpx1950">
+    <group ns="dx200" >
+      <include file="$(find motoman_mpx1950_support)/launch/robot_interface_streaming_mpx1950.launch">
+        <arg name="robot_ip"   value="$(arg req_arg)" />
+        <arg name="controller" value="$(arg dx200)"/>
+      </include>
+    </group>
+  </group>
+
+  <group ns="robot_state_visualize_mpx1950">
+    <group ns="dx200" >
+      <include file="$(find motoman_mpx1950_support)/launch/robot_state_visualize_mpx1950.launch">
+        <arg name="robot_ip"   value="$(arg req_arg)" />
+        <arg name="controller" value="$(arg dx200)"/>
+      </include>
+    </group>
+  </group>
+</launch>

motoman_mpx1950_support/urdf/mpx1950.xacro

@@ -0,0 +1,5 @@
+<?xml version="1.0" ?>
+<robot name="motoman_mpx1950" xmlns:xacro="http://ros.org/wiki/xacro">
+  <xacro:include filename="$(find motoman_mpx1950_support)/urdf/mpx1950_macro.xacro" />
+  <xacro:motoman_mpx1950 prefix=""/>
+</robot>

motoman_mpx1950_support/urdf/mpx1950_macro.xacro

@@ -0,0 +1,169 @@
+<?xml version="1.0" ?>
+<robot xmlns:xacro="http://ros.org/wiki/xacro">
+  <xacro:macro name="motoman_mpx1950" params="prefix">
+    <xacro:include filename="$(find motoman_resources)/urdf/common_materials.xacro"/>
+
+    <!-- link list -->
+    <link name="${prefix}base_link">
+      <visual>
+        <geometry>
+          <mesh filename="package://motoman_mpx1950_support/meshes/mpx1950/visual/base_link.dae"/>
+        </geometry>
+        <xacro:material_yaskawa_blue/>
+      </visual>
+      <collision>
+        <geometry>
+          <mesh filename="package://motoman_mpx1950_support/meshes/mpx1950/collision/base_link.stl"/>
+        </geometry>
+      </collision>
+    </link>
+    <link name="${prefix}link_1_s">
+      <visual>
+        <geometry>
+          <mesh filename="package://motoman_mpx1950_support/meshes/mpx1950/visual/link_1_s.dae"/>
+        </geometry>
+        <xacro:material_yaskawa_blue/>
+      </visual>
+      <collision>
+        <geometry>
+          <mesh filename="package://motoman_mpx1950_support/meshes/mpx1950/collision/link_1_s.stl"/>
+        </geometry>
+      </collision>
+    </link>
+    <link name="${prefix}link_2_l">
+      <visual>
+        <geometry>
+          <mesh filename="package://motoman_mpx1950_support/meshes/mpx1950/visual/link_2_l.dae"/>
+        </geometry>
+        <xacro:material_yaskawa_blue/>
+      </visual>
+      <collision>
+        <geometry>
+          <mesh filename="package://motoman_mpx1950_support/meshes/mpx1950/collision/link_2_l.stl"/>
+        </geometry>
+      </collision>
+    </link>
+    <link name="${prefix}link_3_u">
+      <visual>
+        <geometry>
+          <mesh filename="package://motoman_mpx1950_support/meshes/mpx1950/visual/link_3_u.dae"/>
+        </geometry>
+        <xacro:material_yaskawa_blue/>
+      </visual>
+      <collision>
+        <geometry>
+          <mesh filename="package://motoman_mpx1950_support/meshes/mpx1950/collision/link_3_u.stl"/>
+        </geometry>
+      </collision>
+    </link>
+    <link name="${prefix}link_4_r">
+      <visual>
+        <geometry>
+          <mesh filename="package://motoman_mpx1950_support/meshes/mpx1950/visual/link_4_r.dae"/>
+        </geometry>
+        <xacro:material_yaskawa_blue/>
+      </visual>
+      <collision>
+        <geometry>
+          <mesh filename="package://motoman_mpx1950_support/meshes/mpx1950/collision/link_4_r.stl"/>
+        </geometry>
+      </collision>
+    </link>
+    <link name="${prefix}link_5_b">
+      <visual>
+        <geometry>
+          <mesh filename="package://motoman_mpx1950_support/meshes/mpx1950/visual/link_5_b.dae"/>
+        </geometry>
+        <xacro:material_yaskawa_blue/>
+      </visual>
+      <collision>
+        <geometry>
+          <mesh filename="package://motoman_mpx1950_support/meshes/mpx1950/collision/link_5_b.stl"/>
+        </geometry>
+      </collision>
+    </link>
+    <link name="${prefix}link_6_t">
+      <visual>
+        <geometry>
+          <mesh filename="package://motoman_mpx1950_support/meshes/mpx1950/visual/link_6_t.dae"/>
+        </geometry>
+        <xacro:material_yaskawa_silver/>
+      </visual>
+      <collision>
+        <geometry>
+          <mesh filename="package://motoman_mpx1950_support/meshes/mpx1950/collision/link_6_t.stl"/>
+        </geometry>
+      </collision>
+    </link>
+    <!-- end of link list -->
+
+    <!-- joint list -->
+    <joint name="${prefix}joint_1_s" type="revolute">
+      <parent link="${prefix}base_link"/>
+      <child link="${prefix}link_1_s"/>
+      <origin xyz="0 0 0.500" rpy="0 0 0" />
+      <axis xyz="0 0 1" />
+      <limit lower="${radians(-170)}" upper="${radians(170)}" effort="2940" velocity="${radians(180.4)}"/>
+    </joint>
+    <joint name="${prefix}joint_2_l" type="revolute">
+      <parent link="${prefix}link_1_s"/>
+      <child link="${prefix}link_2_l"/>
+      <origin xyz="0 0 0" rpy="0 0 0" />
+      <axis xyz="0 1 0" />
+      <limit lower="${radians(-100)}" upper="${radians(140)}" effort="2940" velocity="${radians(180.4)}"/>
+    </joint>
+    <joint name="${prefix}joint_3_u" type="revolute">
+      <parent link="${prefix}link_2_l"/>
+      <child link="${prefix}link_3_u"/>
+      <origin xyz="0 0 0.725" rpy="0 0 0" />
+      <axis xyz="0 -1 0" />
+      <limit lower="${radians(-62)}" upper="${radians(235)}" effort="1470" velocity="${radians(180.2)}"/>
+    </joint>
+    <joint name="${prefix}joint_4_r" type="revolute">
+      <parent link="${prefix}link_3_u"/>
+      <child link="${prefix}link_4_r"/>
+      <origin xyz="0.725 0 0.015" rpy="0 0 0" />
+      <axis xyz="-1 0 0" />
+      <limit lower="${radians(-200)}" upper="${radians(200)}" effort="215.6" velocity="${radians(360)}"/>
+    </joint>
+    <joint name="${prefix}joint_5_b" type="revolute">
+      <parent link="${prefix}link_4_r"/>
+      <child link="${prefix}link_5_b"/>
+      <origin xyz="0 0 0" rpy="0 0 0" />
+      <axis xyz="0 -1 0" />
+      <limit lower="${radians(-150)}" upper="${radians(150)}" effort="96.04" velocity="${radians(400)}"/>
+    </joint>
+    <joint name="${prefix}joint_6_t" type="revolute">
+      <parent link="${prefix}link_5_b"/>
+      <child link="${prefix}link_6_t"/>
+      <origin xyz="0 0 0" rpy="0 0 0" />
+      <axis xyz="-1 0 0" />
+      <limit lower="${radians(-400)}" upper="${radians(400)}" effort="22.54" velocity="${radians(500)}"/>
+    </joint>
+    <!-- end of joint list -->
+
+    <!-- ROS-Industrial 'flange' frame: attachment point for EEF models -->
+    <link name="${prefix}flange"/>
+    <joint name="${prefix}joint_6_t-flange" type="fixed">
+      <origin xyz="0.100 0 0" rpy="0 0 0"/>
+      <parent link="${prefix}link_6_t"/>
+      <child link="${prefix}flange"/>
+    </joint>
+
+    <!-- ROS-Industrial 'tool0' frame: all-zeros tool frame -->
+    <link name="${prefix}tool0"/>
+    <joint name="${prefix}flange-tool0" type="fixed">
+      <origin xyz="0 0 0" rpy="${radians(180)} ${radians(-90)} 0"/>
+      <parent link="${prefix}flange"/>
+      <child link="${prefix}tool0"/>
+    </joint>
+
+    <!-- ROS base_link to Robot Manufacturer World Coordinates transform -->
+    <link name="${prefix}base" />
+    <joint name="${prefix}base_link-base" type="fixed">
+      <origin xyz="0 0 0.500" rpy="0 0 0"/>
+      <parent link="${prefix}base_link"/>
+      <child link="${prefix}base"/>
+    </joint>
+  </xacro:macro>
+</robot>