Vizzy Cartesian Interface - Revision history

Giovanni Saponaro: clean up obsolete Vizzy information

2016-07-22T14:06:49Z

clean up obsolete Vizzy information

← Older revision		Revision as of 14:06, 22 July 2016
Line 1:		Line 1:
	~~==Introduction==~~

	The Cartesian Interface used with Vizzy to reach a XYZ point using its inverse kinematics is based in the tutorial "Customizing the Cartesian Interface for a Generic Robot"[http://eris.liralab.it/iCub/main/dox/html/icub_anyrobot_cartesian_interface.html] by Ugo Pattacini. Reading Ugo's tutorial is strongly advised.

	~~For the Cartesian Interface to work the iCubInterface (Vizzy adapted version) needs to be running, and the desired arm, shoulders and torso ports open.~~

	The interface makes use of three distinct modules. A '''solver''' which solves the motors position for a desired XYZ position given a kinematic chain. A '''server''' which controls the motors directly while it tries to confer human like movements to the robot. Finally a '''client''' which calls the server and solver methods through a defined interface.

	The modules used for the Vizzy robot are based and very similar to the ones available in the tutorial "Customizing the Cartesian Interface for a Generic Robot". The most important differences are in the ini files.

	~~==Solver==~~

	~~The solver ini file for the Vizzy robot has two extra parameters besides the ones presented in the original tutorial. The 'kinematics_file' and 'part' parameters.~~
	* kinematics_file: indicates the path and name of the file with the kinematic chain description.
	* part: indicates which part of the robot is going to be solved, the right_arm or left_arm part. The selected part does not only affect the part referred but also the respective shoulder and torso.

	~~If there is an interest in blocking a motor the dof parameter can be used to do that, this can be set through the ini file or dynamically.~~

	In the original tutorial the robot was constituted of only one part, in the Vizzy case each arm can be constituted of three parts: arm, shoulder, and torso. In the code a function was added just to simplify the part properties definition the "newPartProperties()", and the three part properties objects were added to the PartDescriptor:
	~~PartDescriptor *p=new PartDescriptor;~~
	~~p->lmb=limb; // a pointer to the iKinLimb~~
	~~p->chn=limb->asChain(); // the associated iKinChain object~~
	~~p->cns=NULL; // any further (linear) constraints on the joints other than the bounds? This requires some more effort~~
	~~p->prp.push_back(optTorsoPart);~~
	~~p->prp.push_back(optShoulderPart);~~
	~~p->prp.push_back(optArmPart);~~
	~~p->rvs.push_back(true);~~
	~~p->rvs.push_back(true);~~
	~~p->rvs.push_back(true);~~
	~~p->num=3;~~

	~~==Server==~~

	~~The server ini file for the Vizzy robot has four extra parameters besides the ones presented in the original tutorial. The 'kinematics_file', 'robot', 'part', and 'local'.~~
	* kinematics_file: indicates the path and name of the file with the kinematic chain description.
	* part: indicates which part of the robot is going to be solved, the right_arm or left_arm part. The selected part does not only affect the part referred but also the respective shoulder and torso.
	* robot: indicates the name of the robot (in Vizzy's case 'vizzy').
	* local: indicates the prefix name for the server port.

	The ini file also has three [DRIVER_X] groups one per each part of the robot that needs to be controlled. The 'JointsOrder' parameter depends on how the kinematic chain is described in it's ini file.

	Just as the solver the server differentiates itself from the original because the Vizzy Cartesian Interface needs to control three distinct parts. This parts are added to a Polydriver list, which is attached to a wrapper.
	~~PolyDriverList list;~~
	~~list.push(&partDrvTorso,torsoPart.c_str());~~
	~~list.push(&partDrvShoulder,shoulderPart.c_str());~~
	~~list.push(&partDrvArm,armPart.c_str());~~

	~~==Client==~~

	~~The iCub Cartesian Interface client is also valid for the Vizzy robot[http://eris.liralab.it/iCub/main/dox/html/icub_cartesian_interface.html].~~

	~~==Kinematic ini example==~~

	~~This are the Denavit–Hartenberg parameters for the right arm~~

	~~H0 (1.0 0.0 0.0 0.0 0.0 0.0 -1.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 0.0 1.0)~~

	~~numLinks 9~~

	~~link_0 (A 0.0) (D -0.0805) (alpha -90.0) (offset 0.0) (min -20.0) (max 20.0)~~
	~~link_1 (A 0.0) (D 0.212) (alpha -90.0) (offset 0.0) (min -18.0) (max 18.0)~~
	~~link_2 (A 0.0) (D 0.10256) (alpha 90.0) (offset 90.0) (min -75.0) (max 135.0)~~
	~~link_3 (A 0.0) (D 0.0) (alpha -90.0) (offset -70.0) (min 0.0) (max 75.0)~~
	~~link_4 (A 0.0) (D 0.16296) (alpha -90.0) (offset 90.0) (min -85.0) (max 85.0)~~
	~~link_5 (A 0.0) (D 0.0) (alpha 90.0) (offset 0.0) (min -0.0) (max 120.0)~~
	~~link_6 (A 0.0) (D 0.18925) (alpha 90.0) (offset 0.0) (min -85.0) (max 85.0)~~
	~~link_7 (A 0.0) (D 0.0) (alpha 90.0) (offset -90.0) (min -35.0) (max 35.0)~~
	~~link_8 (A -0.100) (D 0.0) (alpha -90.0) (offset 0.0) (min -35.0) (max 35.0)~~

	~~The H0 parameter is for an virtual link that only rotates the orientation for the link_0 parameters.~~

	~~The link 0 is only considered for the torso, from link 1 to 3 corresponds to the shoulder, and the rest of the links are relative to the arm. The DH parameters are very similar for both arms.~~

	~~==Tutorial files==~~

	~~An modified version of the "anyRobotCartesianInterface" tutorial files for the Vizzy robot can be found [[Media:Vizzy_iKin2.tar.gz\|here]].~~

	~~This compressed file has four programs: a solver; a server; a client; and a testServer.~~

	The server, solver and client are described in the "Customizing the Cartesian Interface for a Generic Robot" tutorial and also in the section above. The client also allows for keyboard input of positions (type help on the shell the client is running to get a full description of the commands), this client also has an ini where it is possible to define the trajectory time and a target tolerance value. Before using any of these programs make sure that the ini files in the "./app/conf" have the correct parameters.

	The testServer is a simpler server, this server does not have try to make human like movement has the server does, instead it only sets the position of the motors to the one sent by the solver RPC port. This works by sending RPC commands for a new XYZ position to the solver input port.

	~~[[Vizzy\|<< Back to Vizzy wiki homepage]]~~


	~~[[Category:Robots]]~~
	~~[[Category:Vislab]]~~

Daragao: /* Kinematic ini example */

2012-09-05T10:41:14Z

Kinematic ini example

← Older revision		Revision as of 10:41, 5 September 2012
Line 55:		Line 55:

	H0 (1.0 0.0 0.0 0.0 0.0 0.0 -1.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 0.0 1.0)		H0 (1.0 0.0 0.0 0.0 0.0 0.0 -1.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 0.0 1.0)

	numLinks 9		numLinks 9

	link_0 (A 0.0) (D -0.0805) (alpha -90.0) (offset 0.0) (min -20.0) (max 20.0)		link_0 (A 0.0) (D -0.0805) (alpha -90.0) (offset 0.0) (min -20.0) (max 20.0)
	link_1 (A 0.0) (D 0.212) (alpha -90.0) (offset 0.0) (min -18.0) (max 18.0)		link_1 (A 0.0) (D 0.212) (alpha -90.0) (offset 0.0) (min -18.0) (max 18.0)

Daragao: /* Kinematic ini example */

2012-09-05T10:41:00Z

Kinematic ini example

Daragao at 17:17, 17 November 2011

2011-11-17T17:17:59Z

← Older revision		Revision as of 17:17, 17 November 2011
Line 69:		Line 69:

	The H0 parameter is for an virtual link that only rotates the orientation for the link_0 parameters.		The H0 parameter is for an virtual link that only rotates the orientation for the link_0 parameters.

			The link 0 is only considered for the torso, from link 1 to 3 corresponds to the shoulder, and the rest of the links are relative to the arm. The DH parameters are very similar for both arms.

	==Tutorial files==		==Tutorial files==

Daragao at 17:05, 17 November 2011

2011-11-17T17:05:35Z

@@ Line 50: / Line 50: @@
 The iCub Cartesian Interface client is also valid for the Vizzy robot[http://eris.liralab.it/iCub/main/dox/html/icub_cartesian_interface.html].
-==Kinematic chain ini file==
+==Kinematic ini example==
 ==Tutorial files==

Daragao at 17:01, 17 November 2011

2011-11-17T17:01:07Z

← Older revision		Revision as of 17:01, 17 November 2011
Line 49:		Line 49:

	The iCub Cartesian Interface client is also valid for the Vizzy robot[http://eris.liralab.it/iCub/main/dox/html/icub_cartesian_interface.html].		The iCub Cartesian Interface client is also valid for the Vizzy robot[http://eris.liralab.it/iCub/main/dox/html/icub_cartesian_interface.html].

			==Kinematic chain ini file==



	==Tutorial files==		==Tutorial files==

Daragao at 16:57, 17 November 2011

2011-11-17T16:57:36Z

← Older revision		Revision as of 16:57, 17 November 2011
Line 56:		Line 56:
	This compressed file has four programs: a solver; a server; a client; and a testServer.		This compressed file has four programs: a solver; a server; a client; and a testServer.

	The server, solver and client are described in the "Customizing the Cartesian Interface for a Generic Robot" tutorial and also in the section above. ~~Although the~~ client also allows for keyboard input of positions (type help on the shell the client is running to get a full description of the commands). Before using any of these programs make sure that the ini files in the "./app/conf" have the correct parameters.		The server, solver and client are described in the "Customizing the Cartesian Interface for a Generic Robot" tutorial and also in the section above. The client also allows for keyboard input of positions (type help on the shell the client is running to get a full description of the commands), this client also has an ini where it is possible to define the trajectory time and a target tolerance value. Before using any of these programs make sure that the ini files in the "./app/conf" have the correct parameters.

	The testServer is a simpler server, this server does not have try to make human like movement has the server does, instead it only sets the position of the motors to the one sent by the solver RPC port. This works by sending RPC commands for a new XYZ position to the solver input port.		The testServer is a simpler server, this server does not have try to make human like movement has the server does, instead it only sets the position of the motors to the one sent by the solver RPC port. This works by sending RPC commands for a new XYZ position to the solver input port.

Daragao at 16:42, 17 November 2011

2011-11-17T16:42:48Z

← Older revision		Revision as of 16:42, 17 November 2011
Line 56:		Line 56:
	This compressed file has four programs: a solver; a server; a client; and a testServer.		This compressed file has four programs: a solver; a server; a client; and a testServer.

	The server, solver and client are described in the		The server, solver and client are described in the "Customizing the Cartesian Interface for a Generic Robot" tutorial and also in the section above. Although the client also allows for keyboard input of positions (type help on the shell the client is running to get a full description of the commands). Before using any of these programs make sure that the ini files in the "./app/conf" have the correct parameters.

			The testServer is a simpler server, this server does not have try to make human like movement has the server does, instead it only sets the position of the motors to the one sent by the solver RPC port. This works by sending RPC commands for a new XYZ position to the solver input port.

	[[Vizzy\|<< Back to Vizzy wiki homepage]]		[[Vizzy\|<< Back to Vizzy wiki homepage]]

Daragao: /* Issues and important notes */

2011-11-17T16:37:32Z

Issues and important notes

← Older revision		Revision as of 16:37, 17 November 2011
Line 50:		Line 50:
	The iCub Cartesian Interface client is also valid for the Vizzy robot[http://eris.liralab.it/iCub/main/dox/html/icub_cartesian_interface.html].		The iCub Cartesian Interface client is also valid for the Vizzy robot[http://eris.liralab.it/iCub/main/dox/html/icub_cartesian_interface.html].

	==~~Issues and important notes~~==		==Tutorial files==

	An modified version of the "anyRobotCartesianInterface" tutorial files for the Vizzy robot can be found [[Media:Vizzy_iKin2.tar.gz\|here]].		An modified version of the "anyRobotCartesianInterface" tutorial files for the Vizzy robot can be found [[Media:Vizzy_iKin2.tar.gz\|here]].

			This compressed file has four programs: a solver; a server; a client; and a testServer.

			The server, solver and client are described in the

	[[Vizzy\|<< Back to Vizzy wiki homepage]]		[[Vizzy\|<< Back to Vizzy wiki homepage]]

Daragao at 16:35, 17 November 2011

2011-11-17T16:35:28Z

← Older revision		Revision as of 16:35, 17 November 2011
Line 52:		Line 52:
	==Issues and important notes==		==Issues and important notes==

	An modified version of the "anyRobotCartesianInterface" tutorial files for the Vizzy robot can be found ~~here -->~~ [[Media:Vizzy_iKin2.tar.gz]].		An modified version of the "anyRobotCartesianInterface" tutorial files for the Vizzy robot can be found [[Media:Vizzy_iKin2.tar.gz\|here]].

	[[Vizzy\|<< Back to Vizzy wiki homepage]]		[[Vizzy\|<< Back to Vizzy wiki homepage]]

← Older revision		Revision as of 10:41, 5 September 2012
Line 54:		Line 54:
	This are the Denavit–Hartenberg parameters for the right arm		This are the Denavit–Hartenberg parameters for the right arm

	H0 (1.0 0.0 0.0 0.0 0.0 0.0 -1.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 0.0 1.0) ~~// given per rows~~		H0 (1.0 0.0 0.0 0.0 0.0 0.0 -1.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 0.0 1.0)

	numLinks 9		numLinks 9

	link_0 (A 0.0) (D -0.0805) (alpha -90.0) (offset 0.0) (min -20.0) (max 20.0)		link_0 (A 0.0) (D -0.0805) (alpha -90.0) (offset 0.0) (min -20.0) (max 20.0)
	link_1 (A 0.0) (D 0.212) (alpha -90.0) (offset 0.0) (min -18.0) (max 18.0)		link_1 (A 0.0) (D 0.212) (alpha -90.0) (offset 0.0) (min -18.0) (max 18.0)
	link_2 (A 0.0) (D 0.10256) (alpha 90.0) (offset 90.0) (min -~~135~~.0) (max 75.0)		link_2 (A 0.0) (D 0.10256) (alpha 90.0) (offset 90.0) (min -75.0) (max 135.0)
	link_3 (A 0.0) (D 0.0) (alpha -90.0) (offset -70.0) (min 0.0) (max 75.0)		link_3 (A 0.0) (D 0.0) (alpha -90.0) (offset -70.0) (min 0.0) (max 75.0)
	link_4 (A 0.0) (D 0.16296) (alpha -90.0) (offset -90.0) (min -85.0) (max 85.0)		link_4 (A 0.0) (D 0.16296) (alpha -90.0) (offset 90.0) (min -85.0) (max 85.0)
	link_5 (A 0.0) (D 0.0) (alpha -90.0) (offset 0.0) (min -0.0) (max 120.0)		link_5 (A 0.0) (D 0.0) (alpha 90.0) (offset 0.0) (min -0.0) (max 120.0)
	link_6 (A 0.0) (D -0.18925) (alpha 90.0) (offset 0.0) (min -85.0) (max 85.0)		link_6 (A 0.0) (D 0.18925) (alpha 90.0) (offset 0.0) (min -85.0) (max 85.0)
	link_7 (A 0.0) (D 0.0) (alpha -90.0) (offset -90.0) (min -35.0) (max 35.0)		link_7 (A 0.0) (D 0.0) (alpha 90.0) (offset -90.0) (min -35.0) (max 35.0)
	link_8 (A 0.100) (D 0.0) (alpha 90.0) (offset 0.0) (min -35.0) (max 35.0)		link_8 (A -0.100) (D 0.0) (alpha -90.0) (offset 0.0) (min -35.0) (max 35.0)

	The H0 parameter is for an virtual link that only rotates the orientation for the link_0 parameters.		The H0 parameter is for an virtual link that only rotates the orientation for the link_0 parameters.