Dock (Map)

Send the platform to a dock that is located on the map.

Action Name: autonomy/dock_map

Action Type: clearpath_dock_msgs/action/MapDock

Python

from action_msgs.msg import GoalStatus  # Import for reference to status constants
from clearpath_config.common.utils.yaml import read_yaml
from clearpath_dock_msgs.action import MapDock
import rclpy
from rclpy.action import ActionClient
from rclpy.node import Node

ROBOT_CONFIG_PATH = '/etc/clearpath/robot.yaml'
LOGGING_NAME = 'MapDock'

# TODO: Enter your mission and map uuids
DOCK_NAME: str = ''
MAP_ID: str = ''


class MapDockActionClient(Node):

    def __init__(self, namespace: str):
        super().__init__('execute_map_dock')
        self._namespace = namespace
        self._action_client = ActionClient(self, MapDock, f'/{self._namespace}/autonomy/dock_map')

        self._map_dock_goal_handle = None
        self._map_dock_running = False
        self._docked = False

    def send_map_dock_goal(self, dock_name, map_id):
        goal_msg = MapDock.Goal()
        goal_msg.dock_name = dock_name
        goal_msg.map_uuid = map_id

        if not self._action_client.wait_for_server(timeout_sec=5.0):
            self.get_logger().error(f'[{LOGGING_NAME}] /{self._namespace}/autonomy/dock_map action server not available!')
            self.destroy_node()
            rclpy.shutdown()
            return

        self._send_goal_future = self._action_client.send_goal_async(goal_msg, feedback_callback=self.map_dock_feedback_cb)
        self._send_goal_future.add_done_callback(self.map_dock_goal_response_cb)

    def map_dock_goal_response_cb(self, future):
        self._map_dock_goal_handle = future.result()
        if not self._map_dock_goal_handle.accepted:
            self.get_logger().info(f'[{LOGGING_NAME}] Map Dock goal rejected')
            self.destroy_node()
            rclpy.shutdown()
            return

        self._map_dock_running = True
        self.get_logger().info(f'[{LOGGING_NAME}] Map Dock goal accepted')

        self._get_result_future = self._map_dock_goal_handle.get_result_async()
        self._get_result_future.add_done_callback(self.map_dock_get_result_cb)

    def map_dock_feedback_cb(self, feedback_msg):
        feedback = feedback_msg.feedback
        self.get_logger().info(f'[{LOGGING_NAME}] Map docking has been running for: {feedback.elapsed_time:.2f}s', throttle_duration_sec=20)

    def map_dock_get_result_cb(self, future):
        result = future.result().result
        status = future.result().status

        self._docked = False

        # Compare the status integer against the constants defined in the message
        if status == GoalStatus.STATUS_SUCCEEDED:
            if result.success:
                self.get_logger().info(f'[{LOGGING_NAME}] [Map Dock Goal Result] Succeeded! Result: Robot docked successfully!')
                self._docked = True
            else:
                self.get_logger().info(f'[{LOGGING_NAME}] [Map Dock Goal Result] Succeeded! Result: Robot failed to dock')

        elif status == GoalStatus.STATUS_CANCELED:
            self.get_logger().info(f'[{LOGGING_NAME}] [Map Dock Goal Result] Cancelled!')

        elif status == GoalStatus.STATUS_ABORTED:
            self.get_logger().info(f'[{LOGGING_NAME}] [Map Dock Goal Result] Aborted!')
        else:
            self.get_logger().info(f'[{LOGGING_NAME}] [Map Dock Goal Result] Finished with unknown status: {status}')

        self._map_dock_goal_handle = None
        self._map_dock_running = False

        self.destroy_node()
        rclpy.shutdown()


def main(args=None):
    rclpy.init(args=args)
    robot_config = read_yaml(ROBOT_CONFIG_PATH)
    namespace = robot_config['system']['ros2']['namespace']

    map_dock = MapDockActionClient(namespace)
    map_dock.send_map_dock_goal(DOCK_NAME, MAP_ID)
    rclpy.spin(map_dock)


if __name__ == '__main__':
    main()

C++

#include <functional>
#include <future>
#include <memory>
#include <string>
#include <yaml-cpp/yaml.h>

#include "clearpath_dock_msgs/action/map_dock.hpp"

#include "rclcpp/rclcpp.hpp"
#include "rclcpp_action/rclcpp_action.hpp"
#include "rclcpp_components/register_node_macro.hpp"

// TODO: Enter your dock name and map id
const std::string DOCK_NAME = "lma02_doghouse_dock";
const std::string MAP_ID = "02227f12-a32b-45d0-9d34-c90b6e50d49c";

namespace map_dock_action_client
{
class MapDockActionClient : public rclcpp::Node
{
public:
  using MapDock = clearpath_dock_msgs::action::MapDock;
  using GoalHandleMapDock = rclcpp_action::ClientGoalHandle<MapDock>;

  explicit MapDockActionClient(const rclcpp::NodeOptions & options)
  : Node("execute_map_dock", options)
  {
    YAML::Node robot_config = YAML::LoadFile("/etc/clearpath/robot.yaml");
    namespace_ = robot_config["system"]["ros2"]["namespace"].as<std::string>();

    this->client_ptr_ = rclcpp_action::create_client<MapDock>(
      this, "/" + namespace_ + "/" + std::string("autonomy/dock_map"));

    this->timer_ = this->create_wall_timer(
      std::chrono::milliseconds(500),
      std::bind(&MapDockActionClient::send_goal, this));
  }

  void send_goal()
  {
    using namespace std::placeholders;

    this->timer_->cancel();

    if (!this->client_ptr_->wait_for_action_server()) {
      RCLCPP_ERROR(this->get_logger(), "%s/autonomy/dock_map action server not available after waiting", namespace_.c_str());
      rclcpp::shutdown();
    }

    auto goal_msg = MapDock::Goal();
    goal_msg.dock_name = DOCK_NAME;
    goal_msg.map_uuid = MAP_ID;

    auto send_goal_options = rclcpp_action::Client<MapDock>::SendGoalOptions();

    send_goal_options.goal_response_callback = [this](const GoalHandleMapDock::SharedPtr & goal_handle)
    {
      if (!goal_handle) {
        RCLCPP_ERROR(this->get_logger(), "Map Dock Goal was rejected by server");
      } else {
        RCLCPP_INFO(this->get_logger(), "Map Dock Goal accepted by server, waiting for result");
      }
    };

    send_goal_options.feedback_callback = [this](
      GoalHandleMapDock::SharedPtr,
      const std::shared_ptr<const MapDock::Feedback> feedback)
    {
      RCLCPP_INFO_THROTTLE(this->get_logger(), *this->get_clock(), 60000, "Map docking has been running for: %.3f", feedback->elapsed_time);
    };

    send_goal_options.result_callback = [this](const GoalHandleMapDock::WrappedResult & result)
    {
      switch (result.code) {
        case rclcpp_action::ResultCode::SUCCEEDED:
          if (result.result->success)
          {
            RCLCPP_INFO(this->get_logger(), "[Map Dock Goal Result] Succeeded! Result: Robot map docked successfully!");
          }
          else
          {
            RCLCPP_ERROR(this->get_logger(), "[Map Dock Goal Result] Succeeded! Result: Robot failed to map dock");
          }
          break;
        case rclcpp_action::ResultCode::ABORTED:
          RCLCPP_ERROR(this->get_logger(), "[Map Dock Goal Result] Aborted!");
          return;
        case rclcpp_action::ResultCode::CANCELED:
          RCLCPP_ERROR(this->get_logger(), "[Map Dock Goal Result] Cancelled!");
          return;
        default:
          RCLCPP_ERROR(this->get_logger(), "[Map Dock Goal Result] Finished with unknown code");
          return;
      }
      rclcpp::shutdown();
    };

    this->client_ptr_->async_send_goal(goal_msg, send_goal_options);
  }

private:
  rclcpp_action::Client<MapDock>::SharedPtr client_ptr_;
  rclcpp::TimerBase::SharedPtr timer_;
  std::string namespace_;

};  // class MapDockActionClient

}  // namespace map_dock_action_client

int main()
{
}

RCLCPP_COMPONENTS_REGISTER_NODE(map_dock_action_client::MapDockActionClient)