ros2node

Create a ROS 2 node on the specified network

Description

The ros2node object represents a ROS 2 node, and allows you to communicate with the rest of the ROS 2 network. You have to create a node before you can create publishers and subscribers.

Creation

Syntax

node = ros2node(Name)

node = ros2node(Name,ID)

Description

node = ros2node(Name) initializes a ROS 2 node with the given Name. The node will be on the network specified by the domain identification 0, unless otherwise specified by the ROS_DOMAIN_ID environment variable.

By default the node uses the 'rmw_fastrtps_cpp' ROS middleware (RMW) implementation unless otherwise specified by the RMW_IMPLEMENTATION environment variable. Set the RMW_IMPLEMENTATION environment variable before creating the ros2node object. For example, setenv('RMW_IMPLEMENTATION','rmw_cyclonedds_cpp') sets the RMW implementation to 'rmw_cyclonedds_cpp'. For more information on RMW implementations see Switching Between ROS Middleware Implementations.

node = ros2node(Name,ID) will initialize the ROS 2 node with Name and connect to the network using domain ID.

Input Arguments

Name — Name of the node

string | char array

The name of the node on the ROS 2 network.

Note

In ROS 1, node names are unique and this is being enforced by shutting down existing nodes when a new node with the same name is started. In ROS 2, the uniqueness of node names is not enforced. When creating a new node, use ros2 function to list existing nodes.

ID — Domain identification of the network

non-negative scalar integer

The domain identification of the ROS 2 network.

Data Types: double

Properties

Name — Name of the node

char array

This property is read-only.

The name of the node on the ROS 2 network.

Example: "/node_1"

Data Types: char

ID — Domain identification of the network

non-negative scalar integer between 0 and 232

This property is read-only.

The domain identification of the ROS 2 network, specified as a non-negative scalar integer between 0 and 232.

Example: 2

Data Types: double

Object Functions

delete

Remove reference to ROS 2 node

Examples

Initialize a Node on Default ROS 2 Network

Initialize the node, '/node_1', on the default ROS 2 network.

node1 = ros2node('/node_1')

node1 = 
  ros2node with properties:

    Name: '/node_1'
      ID: 0

Initialize a Node on Specified ROS 2 Network

Initialize the node, '/node_2', on the ROS 2 network identified with domain 2.

node2 = ros2node("/node_2", 2)

node2 = 
  ros2node with properties:

    Name: '/node_2'
      ID: 2

Extended Capabilities

C/C++ Code Generation

Generate C and C++ code using MATLAB® Coder™.

Usage notes and limitations:

• Only one ros2node object is allowed in a single MATLAB^® function. You can write individual MATLAB functions for each additional ros2node.

Version History

Introduced in R2019b