Bridge the web clients to ROS2.0 by a JSON interface
npm install ros2-web-bridge
ros2-web-bridge, which leverages the rclnodejs client, provides a JSON interface to ROS 2 by adopting the rosbridge v2 protocol. The bridge can process commands through JSON tuneled over WebSockets.
The ros2-web-bridge SUPPORTS the latest ROS 2 stable release by default (currently Dashing Patch 2), please visit the relase channel to check out the information.
Any one who wants to run on the nightly build of ROS 2, please change the dependencies section of package.json file to install other version of rclnodejs.
A client is a program that communicates with ros2-web-bridge using its JSON API. Clients include:
* roslibjs - A JavaScript API, which communicates with ros2-web-bridge over WebSockets.
1. Prepare for ROS 2
Please reference the documentation to install ROS 2.
2. Install Node.js
You can install Node.js:
* Download from Node.js offical website, and install it.
* Use the Node Version Manager (nvm) to install it.
3. Clone and install dependencies
Note that a ROS 2 installation has to be sourced before installing dependencies.
``bash`
$ git clone https://github.com/RobotWebTools/ros2-web-bridge.git
$ cd ros2-web-bridge
$ source /opt/ros/$DISTRO/setup.sh # or a source installation
$ npm install
1. Make sure to source a ROS 2 installation, e.g.:
`bash`
$ source /opt/ros/$DISTRO/setup.sh # or a source installation
2. Start module:`
bash`
$ node bin/rosbridge.js
If you want to start in client mode (i.e. connecting the bridge to an existing websocket server), do this instead:
bash`
$ node bin/rosbridge.js --address ws://:
3. Start the express server:
bash`
$ cd examples && node index.js
4. Open your browser, and navigate to URL: http://localhost:3000/html/publisher.html
Some experimental operations defined by rosbridge v2.0 protocol specification are not supported by ros2-web-bridge now, please check out the list:
and the authentication
* auth
We are trying to obey the rosbridge v2 protocol, but there are still some operation commands which can not follow the spec. The table below lists the differences:
opreations | rosbridge v2.0 protocol spec | ros2-web-bridge implementation |
:------------: | :------------ | :------------- |
publish | If the msg is a subset of the type of the topic, then a warning status message is sent and the unspecified fields are filled in with defaults. | If the subset of the msg is unspecified, then an error status message is sent and this message is dropped.
subscribe | The type of the topic is optional. | The type of the topic must be offered.
If you use roslibjs as the client running in the browser, please reference the code snippet below:
* Subscribe to a topic.
`JavaScript
// Define a topic with its type.
var example = new ROSLIB.Topic({
ros : ros,
name : '/example_topic',
messageType : 'std_msgs/String'
});
// Subscribe to a topic.
example.subscribe(function(message) {
console.log(Receive message: ${message});``
});
If you want to contribute code to this project, first you need to fork the
project. The next step is to send a pull request (PR) for review. The PR will be reviewed by the project team members. Once you have gained "Look Good To Me (LGTM)", the project maintainers will merge the PR.
This project abides by Apache License 2.0.