Computer Overview and Configuration

Both Fetch and Freight have an internal computer which runs a Long Term Support (LTS) release of Ubuntu and an LTS release of ROS. These releases are intended to give long-term stability to the system.

Default User Account

Each robot ships with a default user account, with username fetch and password robotics. It is recommended to change the password when setting up the robot.

Creating User Accounts

It is recommended that each user create their own account on the robot, especially when developing from source. To create an account on the robot, ssh into the robot as the fetch user, and run the following commands:

>$ sudo adduser USERNAME
>$ sudo usermod -G adm,cdrom,sudo,dip,plugdev,lpadmin,sambashare USERNAME

Networking

The robot has both internal and external Ethernet-based networks, as well as an external wireless network interface. The external network interfaces are intended for users to connect to the robot, while the internal networks are used to send data between the internal components of the robot.

The majority of communication between components onboard Fetch and Freight happen via the internal Ethernet network. This network is located in the 10.42.42.0/24 subnet and connects the robot computer to the devices listed in the table below. As such, it is important that your building networks do not use the same subnet.

Device IP Address
Laser range finder 10.42.42.10
Mainboard 10.42.42.42
Gripper 10.42.42.43

There are two possible interfaces for connecting to the robot computer: the wireless interface and the wired interface. Most users will prefer to use the wireless interface, however the access panel also includes a Gigabit Ethernet interface for stationary tasks that require higher bandwidth.

Warning

Never drive the robot with an Ethernet cable attached to the access panel.

Connecting the Robot to a Wireless Network

The easiest way to configure the wireless networking is to connect a monitor, keyboard, and mouse and use the Network Manager interface.

Clock Synchronization

It is recommended to install the chrony NTP client on both robots and desktops in order to keep their time synchronized. By default, robots do not ship with chrony installed. To install chrony on Ubuntu:

> sudo apt-get update
> sudo apt-get install chrony

Upstart Services

Fetch and Freight use upstart to start and manage various services on the robot. The following upstart services start when the robot is booted:

Name Description
roscore starts a roscore
robot starts robot drivers, requires roscore
sixad driver for robot joystick over bluetooth
soundplay starts the sound_play node for audio in ROS

Upstart service can be restart with the service command. For instance, to restart the robot drivers:

>sudo service robot stop
>sudo service robot start

Since the roscore runs independently of the drivers, the drivers can be restarted without having to restart remote instances of RVIZ or similar ROS tools. Note that this also means the parameter server will not be reset when restarting the drivers, and so a roscore restart may be required if the parameter server has been corrupted by a user script.

Log Files

A number of log files are created on the robot. Log files related to upstart services can be found in the /var/log/upstart folder, the name of the log will be service.log.

ROS logs for the robot and roscore upstart services will be created in the /var/log/ros folder.

Speakers and Audio

The mainboard of Fetch and Freight contains a USB audio device. While the device enumerates as a standard Linux audio device, we recommend using the sound_play ROS package to access the speakers. sound_play is automatically started as an upstart service when the robot starts. This service is pre-configured to have the correct group-level access to the audio system. If using the speakers directly through a Linux interface, be sure to add your user to the audio group in order to actually access the speakers.

While the sound_play ROS interface allows users to set an audio level, the audio level set is a percentage of the audio level set for Linux. To adjust the Linux audio level, use the following command and follow the on-screen instructions:

>$ sudo su ros -c "alsamixer -c 1"