Main Content

getFeedbackMessage

Create new action feedback message

Since R2022a

Description

example

msg = getFeedbackMessage(server) creates and returns an empty message, msg, whose message type is determined by the action type of server. The format of msg is determined by the DataFormat property of the action server. This message is the default feedback message that this server sends to the client while executing a goal.

Examples

collapse all

This example shows how to create a ROS action server, connect an action client to it, receive goal, and execute it.

Connect to a ROS network.

rosinit
Launching ROS Core...
Done in 0.95726 seconds.
Initializing ROS master on http://172.29.206.170:59470.
Initializing global node /matlab_global_node_01023 with NodeURI http://dcc598343glnxa64:41999/ and MasterURI http://localhost:59470.

Set up an action server for calculating Fibonacci sequence. Use structures for the ROS message data format. Use fibbonacciExecution function as the callback.

cb = @fibonacciExecution; 
server = rosactionserver("/fibonacci","actionlib_tutorials/Fibonacci",ExecuteGoalFcn=cb,DataFormat="struct")
server = 
  SimpleActionServer with properties:

        ActionName: '/fibonacci'
        ActionType: 'actionlib_tutorials/Fibonacci'
    ExecuteGoalFcn: @fibonacciExecution
        DataFormat: 'struct'

Create action client and send a goal to the server to calculate the Fibonacci sequence up to 10 terms past the first two terms, 0 and 1. Display the result sequence.

client = rosactionclient("/fibonacci","actionlib_tutorials/Fibonacci",DataFormat="struct");
goal = rosmessage(client);
goal.Order = int32(10);
result = sendGoalAndWait(client,goal);
result.Sequence
ans = 12x1 int32 column vector

    0
    1
    1
    2
    3
    5
    8
   13
   21
   34
      ⋮

Shut down ROS network.

rosshutdown
Shutting down global node /matlab_global_node_01023 with NodeURI http://dcc598343glnxa64:41999/ and MasterURI http://localhost:59470.
Shutting down ROS master on http://172.29.206.170:59470.

Supporting Functions

The callback function fibbonacciExecution is executed every time the server receives a goal execution request from the client. This function checks if the goal has been preempted, executes the goal and sends feedback to the client during goal execution.

function [result,success] = fibonacciExecution(src,goal,defaultFeedback,defaultResult)

    % Initialize variables
    success = true;
    result = defaultResult;
    feedback = defaultFeedback;
    feedback.Sequence = int32([0 1]);

    for k = 1:goal.Order
        % Check that the client has not canceled or sent a new goal
        if isPreemptRequested(src)
            success = false;
            break
        end

        % Send feedback to the client periodically
        feedback.Sequence(end+1) = feedback.Sequence(end-1) + feedback.Sequence(end);
        sendFeedback(src,feedback)
        
        % Pause to allow time to complete other callbacks (like client feedback)
        pause(0.2)
    end

    if success
        result.Sequence = feedback.Sequence;
    end

end

Input Arguments

collapse all

ROS action server, specified as a SimpleActionServer object handle.

Output Arguments

collapse all

Default feedback message, returned as a ROS message whose type is determined by the action type of server.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

Version History

Introduced in R2022a