pr2_base_controller.h
Go to the documentation of this file.
1 /*********************************************************************
2  * Software License Agreement (BSD License)
3  *
4  * Copyright (c) 2009, Willow Garage, Inc.
5  * All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  *
11  * * Redistributions of source code must retain the above copyright
12  * notice, this list of conditions and the following disclaimer.
13  * * Redistributions in binary form must reproduce the above
14  * copyright notice, this list of conditions and the following
15  * disclaimer in the documentation and/or other materials provided
16  * with the distribution.
17  * * Neither the name of the Willow Garage nor the names of its
18  * contributors may be used to endorse or promote products derived
19  * from this software without specific prior written permission.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
24  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
25  * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
26  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
27  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
28  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
29  * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
31  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
32  * POSSIBILITY OF SUCH DAMAGE.
33  *********************************************************************/
34 /*
35  * Author: Sachin Chitta and Matthew Piccoli
36  */
37 
38 #include <ros/node_handle.h>
40 #include <pr2_mechanism_controllers/BaseControllerState.h>
43 #include <geometry_msgs/Twist.h>
44 #include <angles/angles.h>
45 #include <boost/shared_ptr.hpp>
46 #include <boost/scoped_ptr.hpp>
47 #include <boost/thread/condition.hpp>
49 
50 namespace controller
51 {
56  {
57  public:
63 
69 
70  /*
71  * \brief The starting method is called by the realtime thread just before
72  * the first call to update. Overrides Controller.staring().
73  * @return Successful start
74  */
75  void starting();
76 
78 
79  /*
80  * \brief callback function for setting the desired velocity using a topic
81  * @param cmd_vel Velocity command of the base in m/s and rad/s
82  */
83  void setCommand(const geometry_msgs::Twist &cmd_vel);
84 
89  geometry_msgs::Twist getCommand();
90 
96 
100  pthread_mutex_t pr2_base_controller_lock_;
101 
106  void update();
107 
111  void setJointCommands();
112 
116  void setDesiredCasterSteer();
117 
118  private:
119 
121 
123 
125 
127 
131  double timeout_;
132 
137 
142 
147 
152  geometry_msgs::Twist cmd_vel_t_;
153 
157  geometry_msgs::Twist cmd_vel_;
158 
162  geometry_msgs::Twist desired_vel_;
163 
167  geometry_msgs::Twist max_vel_;
168 
172  geometry_msgs::Twist max_accel_;
173 
178 
183 
188 
192  double alpha_stall_;
193 
197  std::vector<boost::shared_ptr<JointVelocityController> > wheel_controller_;
198 
202  std::vector<boost::shared_ptr<JointVelocityController> > caster_controller_;
203 
207  boost::scoped_ptr<realtime_tools::RealtimePublisher<pr2_mechanism_controllers::BaseControllerState> > state_publisher_;
208 
212  void computeJointCommands(const double &dT);
213 
217  void updateJointControllers();
218 
222  void computeDesiredCasterSteer(const double &dT);
223 
228 
232  void setDesiredWheelSpeeds();
233 
237  geometry_msgs::Twist interpolateCommand(const geometry_msgs::Twist &start, const geometry_msgs::Twist &end, const geometry_msgs::Twist &max_rate, const double &dT);
238 
242  void commandCallback(const geometry_msgs::TwistConstPtr& msg);
243 
247  geometry_msgs::Twist base_vel_msg_;
248 
252  double eps_;
253 
258 
263 
268 
273 
274 
278  void publishState(const ros::Time &current_time);
279 
281 
285  std::vector<control_toolbox::Pid> caster_position_pid_;
286 
288 
289  std::vector<double> filtered_velocity_;
290  };
291 
292 }
void setJointCommands()
set the joint commands
ros::Time cmd_received_timestamp_
timestamp corresponding to when the command received by the node
void computeJointCommands(const double &dT)
computes the desired caster steers and wheel speeds
bool init(pr2_mechanism_model::RobotState *robot, ros::NodeHandle &n)
void commandCallback(const geometry_msgs::TwistConstPtr &msg)
deal with Twist commands
std::vector< control_toolbox::Pid > caster_position_pid_
The pid controllers for caster position.
geometry_msgs::Twist base_vel_msg_
callback message, used to remember where the base is commanded to go
double eps_
generic epsilon value that is used as a minimum or maximum allowable input value
void updateJointControllers()
tells the wheel and caster controllers to update their speeds
geometry_msgs::Twist max_vel_
velocity limits specified externally
double max_translational_velocity_
maximum translational velocity magnitude allowable
boost::scoped_ptr< realtime_tools::RealtimePublisher< pr2_mechanism_controllers::BaseControllerState > > state_publisher_
publishes information about the caster and wheel controllers
geometry_msgs::Twist cmd_vel_t_
Input speed command vector represents the desired speed requested by the node. Note that this may dif...
geometry_msgs::Twist desired_vel_
Input speed command vector represents the desired speed requested by the node.
double cmd_vel_rot_eps_
minimum rotational velocity value allowable
Pr2BaseController()
Default Constructor of the Pr2BaseController class.
bool new_cmd_available_
true when new command received by node
void update()
(a) Updates commands to caster and wheels. Called every timestep in realtime
ros::Time last_time_
time corresponding to when update was last called
filters::MultiChannelTransferFunctionFilter< double > caster_vel_filter_
double cmd_vel_trans_eps_
minimum tranlational velocity value allowable
double timeout_
timeout specifying time that the controller waits before setting the current velocity command to zero...
void publishState(const ros::Time &current_time)
Publish the state.
double kp_caster_steer_
local gain used for speed control of the caster (to achieve resultant position control) ...
void setCommand(const geometry_msgs::Twist &cmd_vel)
geometry_msgs::Twist interpolateCommand(const geometry_msgs::Twist &start, const geometry_msgs::Twist &end, const geometry_msgs::Twist &max_rate, const double &dT)
interpolates velocities within a given time based on maximum accelerations
geometry_msgs::Twist max_accel_
acceleration limits specified externally
double alpha_stall_
low pass filter value used for finding stalls
pthread_mutex_t pr2_base_controller_lock_
mutex lock for setting and getting commands
geometry_msgs::Twist cmd_vel_
speed command vector used internally to represent the current commanded speed
~Pr2BaseController()
Destructor of the Pr2BaseController class.
std::vector< boost::shared_ptr< JointVelocityController > > caster_controller_
vector that stores the caster controllers
double state_publish_time_
Time interval between state publishing.
double max_rotational_velocity_
maximum rotational velocity magnitude allowable
void setDesiredCasterSteer()
set the desired caster steer
void computeDesiredCasterSteer(const double &dT)
computes the desired caster speeds given the desired base speed
void computeDesiredWheelSpeeds()
computes the desired wheel speeds given the desired base speed
BaseKinematics base_kin_
class where the robot&#39;s information is computed and stored
geometry_msgs::Twist getCommand()
Returns the current position command.
std::vector< double > filtered_velocity_
ros::Time last_publish_time_
Time interval between state publishing.
std::vector< boost::shared_ptr< JointVelocityController > > wheel_controller_
vector that stores the wheel controllers
void setDesiredWheelSpeeds()
sends the desired wheel speeds to the wheel controllers


pr2_mechanism_controllers
Author(s): Sachin Chita, John Hsu, Melonee Wise
autogenerated on Wed Jun 5 2019 19:34:08