Version 12 (modified by bz, 3 years ago) (diff)

--

Ubuntu 20.04, low-latency, non-realtime

Start by installing Ubuntu 20.04.

Install Peak CAN card hardware:

  • PCAN-PCI
  • PCAN-PCIe
  • PCAN-USB
  • PCAN-ISA

NOTE: These cards are supported by the SocketCAN driver built into Linux, however, we have found that the SocketCAN txbuffer can occasionally fail to send CAN frames without reporting an error, and this causes the WAM to E-Stop itself unexpectedly. This can happen a few seconds, a few minutes, or even several hours after starting a WAM application. Fortunately, Peak offers an alternative driver (pcan) which is still socket-based but avoids this SocketCAN bug.

Then install git:

sudo apt install git

Download the libbarrett source code:

cd && git clone -b feature/ubuntu2004 https://git.barrett.com/software/libbarrett

Install the libbarrett software dependencies and scripts. This will replace the standard kernel with one compiled for low interrupt latency.

cd ~/libbarrett/scripts && ./install_dependencies.sh

Remove the generic Linux kernel, then reboot:

sudo apt autoremove --purge linux-image-generic-hwe-20.04
sudo reboot

Build and install the Peak pcan driver:

sh ~/libbarrett/scripts/install-pcan.sh

For PCAN-ISA only:

sudo tee /etc/modprobe.d/pcan.conf <<EOF
options pcan type=isa,isa io=0x300,0x320 irq=7,5
install pcan modprobe --ignore-install pcan
EOF

Reboot to use the new CAN driver:

sudo reboot

Build libbarrett:

export CC=/usr/bin/clang
export CXX=/usr/bin/clang++
cd ~/libbarrett && cmake .
make -j$(nproc)

Install libbarrett:

sudo make install

Build the libbarrett example programs:

cd ~/libbarrett/examples && cmake .
make -j$(nproc)

Get the WAM ready:

  • Connect the WAM's CAN cable to the first port of your CAN device.
  • Turn on the WAM.
  • Ensure both E-Stop buttons are released by turning them a quarter-turn clockwise.

Then run an example program:

./ex04_display_basic_info

Press Shift+Idle on the WAM's Control Pendant to exit this application.

Installing ROS

If your application is based on ROS, you can continue by installing ROS Noetic.

Then install our barrett-ros-pkg.