🔧 Environment Setup¶
💡 The host IPC is pre-installed with required environments. This guide is for new machine setup only.
📋 Prerequisites¶
💻 Software Environment¶
- Ubuntu 22.04 LTS
- ROS2 Humble
1.1 Install ROS2 Humble¶
Skip if already installed. See ROS2 Installation.
1.2 Install System Dependencies¶
sudo apt update -y
sudo apt-get install ros-humble-moveit -y
sudo apt-get install ros-humble-gripper-controllers -y
sudo apt-get install ros-humble-position-controllers -y
sudo apt-get install ros-humble-joint-state-broadcaster -y
sudo apt-get install ros-humble-joint-trajectory-controller -y
sudo apt-get install ros-humble-xacro -y
sudo apt-get install ros-humble-hardware-interface -y
sudo apt-get install ros-humble-controller-manager -y
sudo apt-get install ros-humble-moveit-plugins ros-humble-moveit-ros-perception -y
sudo apt-get install libxcb-cursor0 libxcb-xinerama0 libxcb-icccm4 libxcb-keysyms1 libxcb-render-util0 -y
sudo apt-get install can-utils -y
sudo apt-get install git -y
sudo apt-get install python3-vcstool -y
python3 -m pip install python-can -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple
python3 -m pip install pyside6 -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple
python3 -m pip install openarmx_arm_driver -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple
sudo apt update -y
sudo apt-get install ros-humble-moveit -y
sudo apt-get install ros-humble-gripper-controllers -y
sudo apt-get install ros-humble-position-controllers -y
sudo apt-get install ros-humble-joint-state-broadcaster -y
sudo apt-get install ros-humble-joint-trajectory-controller -y
sudo apt-get install ros-humble-xacro -y
sudo apt-get install ros-humble-hardware-interface -y
sudo apt-get install ros-humble-controller-manager -y
sudo apt-get install ros-humble-moveit-plugins ros-humble-moveit-ros-perception -y
sudo apt-get install libxcb-cursor0 libxcb-xinerama0 libxcb-icccm4 libxcb-keysyms1 libxcb-render-util0 -y
sudo apt-get install can-utils -y
sudo apt-get install git -y
sudo apt-get install python3-vcstool -y
python3 -m pip install python-can -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple
python3 -m pip install pyside6 -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple
python3 -m pip install openarmx_arm_driver -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple
python3 -m pip install placo -i https://pypi.tuna.tsinghua.edu.cn/simple
sudo apt update -y
sudo apt-get install ros-humble-moveit -y
sudo apt-get install ros-humble-gripper-controllers -y
sudo apt-get install ros-humble-position-controllers -y
sudo apt-get install ros-humble-joint-state-broadcaster -y
sudo apt-get install ros-humble-joint-trajectory-controller -y
sudo apt-get install ros-humble-xacro -y
sudo apt-get install ros-humble-hardware-interface -y
sudo apt-get install ros-humble-controller-manager -y
sudo apt-get install ros-humble-moveit-plugins ros-humble-moveit-ros-perception -y
sudo apt-get install libxcb-cursor0 libxcb-xinerama0 libxcb-icccm4 libxcb-keysyms1 libxcb-render-util0 -y
sudo apt-get install can-utils -y
sudo apt-get install git -y
sudo apt install libfuse2
sudo apt-get install python3-vcstool -y
python3 -m pip install python-can -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple
python3 -m pip install pyside6 -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple
python3 -m pip install openarmx_arm_driver -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple
python3 -m pip install websockets -i https://pypi.tuna.tsinghua.edu.cn/simple
sudo usermod -a -G dialout $USER
sudo chmod +x 'Qnbot HMI Control-1.2.2.AppImage'
1.3 Install KCAN Driver (skip if already installed)¶
See Install KCAN Driver.
1.4 Build Workspace¶
cd
mkdir -p ~/openarmx_ws/src
cd ~/openarmx_ws/src
Pull source
# clone
git clone https://github.com/openarmx/openarmx_ros2.git
# Fetch the required full optional set
vcs import < openarmx_ros2/openarmx.repos
Build
cd ~/openarmx_ws
colcon build
Shell aliases (optional)
echo "alias sc='source install/local_setup.bash'" >> ~/.bashrc
echo "alias cb='colcon build --packages-select'" >> ~/.bashrc
source ~/.bashrc