Skip to content
Software for Argo - an autonomous suitcase that follows you around.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
launch
lib
msg
src
srv
.gitignore
CMakeLists.txt
README.md
package.xml

README.md

Argo - An Autonomous Suitcase that Follows You

Northwestern MSR Winter Project 2018

Aamir Husain

Please see my portfolio post to read more about how the code works.

Part 1: Requirements

Hardware

  • Raspberry Pi 3 B
  • 2 DC Brushed motors
  • RoboClaw Motor controller
  • 12V battery (2800mAh)
  • Raspberry Pi Camera Module v2
  • 2 wheels
  • Extra features: power switch, caster wheel, camera mount, screws, velcro, adhesives, USB cables (A, micro, mini)

Software

  • ROS Kinetic
  • Ubuntu MATE (Rasbian OS also compatible)

ROS packages:

  • raspicam_node Provides an easy way to interfave the Raspberry Pi camera module with ROS
  • ar_track_alvar (use apt-get) Library for creating, detecting, and tracking AR tags
  • image_view (use apt-get) Simple viewer for ROS image topics

Part 2: Installing ROS Kinetic on the Pi (more info here)

  1. Install the Ubuntu MATE operating system onto an SD card and plug it into the Pi. Grab a snack, the initial setup will take a little while.
  2. Update and upgrade your Pi:
$ sudo apt-get update
$ sudo apt-get dist-upgrade

Set your localization settings and restart the Pi. 3. Set up your ROS repositories:

$ 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-key adv --keyserver hkp://ha.pool.sks-keyservers.net:80 --recv-key 421C365BD9FF1F717815A3895523BAEEB01FA116
  1. Run sudo apt-get update.
  2. Install ROS Kinetic (full desktop version):
$ sudo apt-get install ros-kinetic-desktop-full
  1. Initialize rosdep
$ sudo rosdep init
$ rosdep update
  1. Create your workspace:
$ mkdir ~/catkin_ws/src/
$ cd ~/catkin_ws
$ catkin_make
  1. source your new setup using the command:
$ source devel/setup.bash

You'll need to source your .bash file every time you open a new shell. Save some time by making an alias for this command in your .bash_aliases file.

Part 3: Download the rospicam_node and argo packages.

  1. In your src directory of /catkin_ws, run the commands:
$ git clone https://github.com/dganbold/raspicam_node.git
$ git clone https://github.com/aamirhatim/argo.git
  1. Run catkin_make in your workspace:
$ cd ~/catkin_ws
$ catkin_make

Part 4: Running Modes

Autonomous Tracking Mode

In this mode, Argo will search for an AR tag and begin following it. Run the following commands to launch the program:

$ roslaunch argo find_tag.launch

Within find_tag.launch you can change the size of the AR tag as well as the error tolerance.

Manual Drive Mode

To control with your keyboard, run the manual_drive.py node:

$ rosrun argo manual_drive.py

Control Argo using the WASD keys. Press 'e' to stop and 'q' to quit the node. You must press Enter for your command to register!

Path Following Mode

Run the path_driver.py node to have Argo follow a pre-programmed path: a line, a figure eight, or a circle. The robot will continue to follow its last command on quitting so you must run the stop command in manual_drive.py to stop it.

$ rosrun argo path_driver.py
You can’t perform that action at this time.