Arctos GUI is a graphical user interface for controlling a robotic arm using ROS (Robot Operating System). It supports connections through Arduino Mega or CANable adapter, allowing users to control the arm's joints, Cartesian coordinates, and gripper movements, as well as send custom CAN messages.
You have two options to install Arctos GUI:
- Step-by-step installation: Install ROS, dependencies, and Arctos GUI manually.
- Preconfigured Virtual Machine: Use a preconfigured Virtual Machine image with everything set up for you.
- Step-by-Step Installation
- Preconfigured Virtual Machine
- Gear Ratios
- Arduino MEGA Open Loop Support
- Useful Links
To start, you need to install ROS and its dependencies:
su root
nano /etc/sudoers
<username> ALL=(ALL) ALL
sudo sh -c 'echo "deb http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main" > /etc/apt/sources.list.d/ros-latest.list'
sudo apt install curl
curl -s https://raw.githubusercontent.com/ros/rosdistro/master/ros.asc | sudo apt-key add -
sudo apt update
sudo apt install ros-melodic-desktop
echo "source /opt/ros/melodic/setup.bash" >> ~/.bashrc
source ~/.bashrc
Next, install additional ROS dependencies:
sudo apt-get install ros-melodic-catkin python-catkin-tools
sudo apt install ros-melodic-moveit ros-melodic-moveit-visual-tools
sudo apt-get install git
git clone https://github.com/ArctosRobotics/ROS
bash
catkin build
cd ROS
source devel/setup.bash
Clone and Build the Repository Clone the Arctos GUI repository and install dependencies:
git clone https://github.com/ArctosRobotics/arctosgui
sudo apt update
sudo apt install python3-pip
pip3 install python-can[serial] ttkthemes sv-ttk
Add ROS environment to your bash profile:
nano ~/.bashrc
Add this line:
source /home/<your-username>/ROS/devel/setup.bash
Save with Ctrl+S and exit with Ctrl+X.
Running the GUI After installation, navigate to the arctosgui directory and start the GUI:
cd arctosgui
chmod +x run.sh
./run.sh
Alternatively, you can manually open each tab:
roslaunch arctos_config demo.launch
rosrun moveo_moveit interface.py
rosrun moveo_moveit transform.py
python3 ui.py
Connecting the Robot
In MoveIt RViz, go to File > Open Config or press Ctrl+O and open the arctosgui_config.rviz file. Once the configuration is loaded, connect the robot via Arduino or CANable, and use the GUI to plan and execute movements.
If you prefer a faster setup, you can use a preconfigured Virtual Machine:
- Download and install VirtualBox.
- Download the Arctos preconfigured VM image from this Google Drive link.
- Open VirtualBox and create a new machine (Ctrl+N).
- Name the machine and set the type to Linux (Debian 64-bit).
- Use iso image zz-disk001.iso
- Set at least 4 GB of RAM.
- Use the existing virtual hard disk file (zz-disk002.vmdk).
- Start the machine and log in with the password: zz.
- In the left toolbar, launch Arctos GUI, connect the robot via Arduino or CANable, and start using the interface.
Set the gear ratios in convert.py and roscan.py as needed for your robot:
gear_ratios = [1, 1, 1, 1, 1, 1] # Replace with your actual gearbox ratios For raw gear ratios:
X: 13.5 Y: 150 Z: 150 A: 48 B: 67.82 C: 67.82 These raw gear ratios can be multiplied by 0.5 for estimated values:
gear_ratios = [6.75, 75, 75, 24, 33.91, 33.91]
To use the open loop version with Arduino MEGA, adapt the serial port configuration in convert.py:
serial_port = "/dev/ttyUSB0"
Before running, you need to give permissions to the USB port:
sudo chmod a+rw /dev/ttyUSB0