No version for distro humble. Known supported distros are highlighted in the buttons above.
No version for distro jazzy. Known supported distros are highlighted in the buttons above.
No version for distro rolling. Known supported distros are highlighted in the buttons above.

Package Summary

Tags No category tags.
Version 0.0.0
License TODO: License declaration
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description ROS2 hardware interface for the Z1 manipulator from Unitree
Checkout URI https://github.com/idra-lab/z1_ros2.git
VCS Type git
VCS Version main
Last Updated 2025-04-24
Dev Status UNKNOWN
CI status No Continuous Integration
Released UNRELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Package Description

TODO: Package description

Additional Links

No additional links.

Maintainers

  • matteo

Authors

No additional authors.

Z1 Hardware Interface

This package contains the hardware interface for the Unitree Z1 robot by leveraging the Unitree provided packages:

  • z1_controller: for the direct communication with the robot at a lower level;
  • z1_sdk: to access z1_controller from the ROS2 hardware interface and send commands to the manipulator.

In particular, the hardware interface is capable of exposing all command interfaces, namely: position, velocity, and effort (torque).

First startup and network configuration

Prior the starting of the communication with the robot though ROS2, make sure you followed the official instructions before powering the robot.

There, they also show how to correctly setup the local network to ensure the communication with the robot that, by default, has IP address 192.168.123.110. In short, make sure the network port where the robot is connected into is configured with manual IPv4 address and the following parameters:

  • address: 192.168.123.235;
  • netmask: 255.255.255.0;
  • gateway: 192.168.123.1.

z1_controller

This package builds the official z1_controller package, but also install accordingly the executables and the configuration files. For simplicity and ease of modification, the z1_controllers configuration folder has been copied at config/. You may refer to the official website documentation to correctly configure the config.xml file, even though the standard values are good defaults.

Hardware interface

This package implementes a ROS2 control hardware interface by using the z1_sdk library to send low-level command to the robot and read its state.

CHANGELOG
No CHANGELOG found.

Wiki Tutorials

This package does not provide any links to tutorials in it's rosindex metadata. You can check on the ROS Wiki Tutorials page for the package.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged z1_hardware_interface at Robotics Stack Exchange

No version for distro noetic. Known supported distros are highlighted in the buttons above.
No version for distro ardent. Known supported distros are highlighted in the buttons above.
No version for distro bouncy. Known supported distros are highlighted in the buttons above.
No version for distro crystal. Known supported distros are highlighted in the buttons above.
No version for distro eloquent. Known supported distros are highlighted in the buttons above.
No version for distro dashing. Known supported distros are highlighted in the buttons above.
No version for distro galactic. Known supported distros are highlighted in the buttons above.
No version for distro foxy. Known supported distros are highlighted in the buttons above.
No version for distro iron. Known supported distros are highlighted in the buttons above.
No version for distro lunar. Known supported distros are highlighted in the buttons above.
No version for distro jade. Known supported distros are highlighted in the buttons above.
No version for distro indigo. Known supported distros are highlighted in the buttons above.
No version for distro hydro. Known supported distros are highlighted in the buttons above.
No version for distro kinetic. Known supported distros are highlighted in the buttons above.
No version for distro melodic. Known supported distros are highlighted in the buttons above.