Visual Servoing Platform  version 3.6.1 under development (2024-03-28)
vpRobotKinova.h
1 /****************************************************************************
2  *
3  * ViSP, open source Visual Servoing Platform software.
4  * Copyright (C) 2005 - 2023 by Inria. All rights reserved.
5  *
6  * This software is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  * See the file LICENSE.txt at the root directory of this source
11  * distribution for additional information about the GNU GPL.
12  *
13  * For using ViSP with software that can not be combined with the GNU
14  * GPL, please contact Inria about acquiring a ViSP Professional
15  * Edition License.
16  *
17  * See https://visp.inria.fr for more information.
18  *
19  * This software was developed at:
20  * Inria Rennes - Bretagne Atlantique
21  * Campus Universitaire de Beaulieu
22  * 35042 Rennes Cedex
23  * France
24  *
25  * If you have questions regarding the use of this file, please contact
26  * Inria at visp@inria.fr
27  *
28  * This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
29  * WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
30  *
31  * Description:
32  * Interface for Kinova Jaco robot.
33  *
34 *****************************************************************************/
35 
36 #ifndef vpRobotKinova_h
37 #define vpRobotKinova_h
38 
47 #include <visp3/core/vpConfig.h>
48 
49 #ifdef VISP_HAVE_JACOSDK
50 
51 #include <KinovaTypes.h>
52 
53 #ifdef __linux__
54 #include <Kinova.API.CommLayerUbuntu.h>
55 #include <Kinova.API.UsbCommandLayerUbuntu.h>
56 #include <dlfcn.h>
57 #include <stdio.h>
58 #include <unistd.h>
59 #include <vector>
60 #elif _WIN32
61 #include <CommandLayer.h>
62 #include <CommunicationLayer.h>
63 #include <winsock2.h>
64 #include <windows.h>
65 #include <conio.h>
66 #include <iostream>
67 #endif
68 
69 #include <visp3/core/vpHomogeneousMatrix.h>
70 #include <visp3/robot/vpRobot.h>
71 
89 class VISP_EXPORT vpRobotKinova : public vpRobot
90 {
91 public:
92  typedef enum { CMD_LAYER_USB, CMD_LAYER_ETHERNET, CMD_LAYER_UNSET } CommandLayer;
93 
94  vpRobotKinova();
95  virtual ~vpRobotKinova() vp_override;
96 
97  int connect();
98 
99  void get_eJe(vpMatrix &eJe) vp_override;
100  void get_fJe(vpMatrix &fJe) vp_override;
101 
106  vpHomogeneousMatrix get_eMc() const { return m_eMc; }
107 
108  int getActiveDevice() const { return m_active_device; }
109  int getNumDevices() const { return m_devices_count; }
110  void getDisplacement(const vpRobot::vpControlFrameType frame, vpColVector &q) vp_override;
111  void getPosition(const vpRobot::vpControlFrameType frame, vpColVector &position) vp_override;
112  void getPosition(const vpRobot::vpControlFrameType frame, vpPoseVector &pose);
113 
114  void homing();
115 
120  void set_eMc(vpHomogeneousMatrix &eMc) { m_eMc = eMc; }
121  void setActiveDevice(int device);
126  void setCommandLayer(CommandLayer command_layer) { m_command_layer = command_layer; }
127  void setDoF(unsigned int dof);
128  void setPosition(const vpRobot::vpControlFrameType frame, const vpColVector &q) vp_override;
135  void setPluginLocation(const std::string &plugin_location) { m_plugin_location = plugin_location; }
136  void setVelocity(const vpRobot::vpControlFrameType frame, const vpColVector &vel) vp_override;
142  void setVerbose(bool verbose) { m_verbose = verbose; }
143 
144 protected:
145  void closePlugin();
146  void getJointPosition(vpColVector &q);
147  void init();
148  void loadPlugin();
149  void setCartVelocity(const vpRobot::vpControlFrameType frame, const vpColVector &v);
150  void setJointVelocity(const vpColVector &qdot);
151 
152 protected:
154  std::string m_plugin_location;
155  bool m_verbose;
158  KinovaDevice *m_devices_list;
161 
162 #ifdef __linux__
163  void *m_command_layer_handle;
164 #elif _WIN32
165  HINSTANCE m_command_layer_handle;
166 #endif
167 
168 private:
169  int (*KinovaCloseAPI)();
170  int (*KinovaGetAngularCommand)(AngularPosition &);
171  int (*KinovaGetCartesianCommand)(CartesianPosition &);
172  int (*KinovaGetDevices)(KinovaDevice devices[MAX_KINOVA_DEVICE], int &result);
173  int (*KinovaInitFingers)();
174  int (*KinovaInitAPI)();
175  int (*KinovaMoveHome)();
176  int (*KinovaSendBasicTrajectory)(TrajectoryPoint command);
177  int (*KinovaSetActiveDevice)(KinovaDevice device);
178  int (*KinovaSetAngularControl)();
179  int (*KinovaSetCartesianControl)();
180 };
181 
182 #endif
183 #endif
Implementation of column vector and the associated operations.
Definition: vpColVector.h:163
Implementation of an homogeneous matrix and operations on such kind of matrices.
Implementation of a matrix and operations on matrices.
Definition: vpMatrix.h:146
Implementation of a pose vector and operations on poses.
Definition: vpPoseVector.h:189
void set_eMc(vpHomogeneousMatrix &eMc)
void setCommandLayer(CommandLayer command_layer)
KinovaDevice * m_devices_list
int getNumDevices() const
std::string m_plugin_location
vpHomogeneousMatrix m_eMc
Constant transformation between end-effector and tool (or camera) frame.
CommandLayer m_command_layer
void setVerbose(bool verbose)
void setPluginLocation(const std::string &plugin_location)
int getActiveDevice() const
Class that defines a generic virtual robot.
Definition: vpRobot.h:57
vpControlFrameType
Definition: vpRobot.h:75
virtual void setVelocity(const vpRobot::vpControlFrameType frame, const vpColVector &vel)=0
virtual void getPosition(const vpRobot::vpControlFrameType frame, vpColVector &position)=0
Get the robot position (frame has to be specified).
virtual void init()=0
virtual void getDisplacement(const vpRobot::vpControlFrameType frame, vpColVector &q)=0
virtual void setPosition(const vpRobot::vpControlFrameType frame, const vpColVector &q)=0
Set a displacement (frame has to be specified) in position control.