Skip to content
ROS files for full SLAM navigation for FRC robots. This requires a Jetson TX2 with Jetpack 3.3, Ubuntu 16.04, and ROS Kinetic.
C++ Other
  1. C++ 99.3%
  2. Other 0.7%
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.
catkin_ws
JetPack-L4T-3.3-linux-x64_b39.run
README.md
Setup.sh
Update.sh
common-sensors.tar.gz
depth_B00364725109104B.yaml
hokuyo_04lx_laser.gazebo.xacro
kinect_ros.tar.gz
rgb_B00364725109104B.yaml
rplidar_ros.tar.gz
run_ros_server.sh
tiger_ros.service

README.md

FRC-ROS

This is the source code for using ROS with an FRC Robot. The steps for installing and running ROS applications are identical for desktop PC's, laptops, Raspberry PI, NVidia Jetson.

Youtube Demos

Simulation Demo: https://www.youtube.com/watch?v=qSjgmY7hYsY

Teleop Demo w/ SLAM: https://www.youtube.com/watch?v=1Qe-s1liH5k

Autonomous and Swerve Simulation: https://youtu.be/OrnWRP20IEY

Setup

Setup is fairly simple. You will need a computer with Ubuntu 16.04 installed. This package is intended to be used on an NVidia Jetson TX2, however, you should be able to run it on a Raspberry Pi as well, but that won't have the performance of a PC or a Jetson.

1. Install Ubuntu on Your Computer

Make sure you have Ubuntu 16.04 installed on your computer: https://tutorials.ubuntu.com/tutorial/tutorial-install-ubuntu-desktop-1604#0

2. Download FRC-ROS to Your Computer

Enter the following to download FRC-ROS to your Documents:

cd ~/Documents
git clone https://github.com/JakeAllison/FRC-ROS.git
cd FRC-ROS
./Setup.sh

3. Install NVidia Jetpack (Skip if you're not using a Jetson)

This part will be performed on your computer with the Jetson hooked up.

cd ~/Documents/FRC-ROS
cp ./JetPack-L4T-3.3-linux-x64_b39.run ~/Downloads
~/Downloads/JetPack-L4T-3.3-linux-x64_b39.run

You can follow the guide (NVidia Developer membership required): [https://developer.nvidia.com/embedded/dlc/jetpack-install-guide-3_3. At a minimum, you will want follow directions to install: Target - Jetson TX2/TX2i (or whatever hardware you have).

4. Install FRC-ROS on Your Jetson (Skip if you're not using a Jetson)

Follow the steps above to install on your computer. This process is identical to your computer. Once you know how to use ROS, you will be able to connect your computer to your Jetson and have then interact seamlessly.

5. Make Updates When Needed

If you make changes to the source code, you will need to update the files from the location where you downloaded FRC-ROS to your Catkin workspace. Open a terminal and put the following command to bring up the simulation:

cd ~/Documents/FRC-ROS
./Update.sh

6. Run a Simulation

You can run a robot simulation in Gazebo simulator. Open a terminal and put the following command to bring up the simulation:

roslaunch frc_robot main_sim.launch
  1. You can control the virtual robot using the GUI screen that pops up, or an XBox 360 controller.
  2. To control the robot, use the analog sticks on your controller. You need to hold down the RB button for normal speed, or LB for turbo speed.
  3. You can set navigation goals in RViz using '2D Nav Goal' and placing the arrow anywhere you like. The robot will try to drive autonomously to that location.
  4. You can hit ctrl-c in the terminal to exit.

The options include the following and can be typed in similar to above:

  • auton: Enables autonomous nagivation and driving.
  • kinectlidar: Starts up a Kinect and RPLidarA2 connected over USB.
  • robot: FOR THE REAL ROBOT. This brings up all sensors and the bridge to the roboRIO.
  • sim: Brings up a simulation.
  • slam: Enables SLAM (Simeltaneous Localization and Mapping)
  • teleop: Enables teleop control through either GUI or any joystick such as an XBox controller.
  • user_interface: Brings up GUI for viewing and sending data to ROS.
  • visualize: Bring up RViz used to visualize ROS data.

To-Do

Implement a Network Tables Interface for RoboRIO

This requires 2 parts. The first part is a ROS package capable of communicating over FRC Network Tables. The second part needs a software interface on the RoboRIO to send and receive data to and from the Jetson.

Interface will be like this:

RoboRio Software (RoboRio) <--Network Tables--> ROS Converter Node (Jetson) <-- ROS Topics --> ROS Software (Jetson)

Implement Commands and Data Transfer

The following data is the most essential data that will be transferred:

  • Velocity Commands (Jetson -> RoboRIO) (required)
  • Send IMU measurements (RoboRIO -> Jetson) (optional)
  • Send Wheel Odometry (RoboRIO -> Jetson) (optional)

The folowing data will allow for usability in competition:

  • Send Commands (RoboRIO -> Jetson)
  • Receive Status (Jetson -> RoboRIO)

Commands from RoboRIO -> Jetson could include stuff like:

  • Set navigation goals.
  • Activate target tracking.
  • Switch to Mapping-Mode (SLAM) or Localization-Only (needs existing map)

Status from Jetson -> RoboRIO could include stuff like:

  • Target tracking info
  • Localization info
  • Navigation statuses
  • General ROS Status

Implement Target Tracking

A single ROS node can take any camera data and perform image processing. This can be written and configured however the user likes and can output targeting data. A single node can be run, or multiple nodes can be doing processing on the same camera feed.

Tutorials and Helpful Information

Recommended Tutorials to Get Started

Getting Started:

Additional Tutorials:

Packages and Software Used in FRC-ROS

Some sensor packages are included here:

SLAM (Simeltaneous Localization and Mapping):

Robot Localization:

Autonomous Navigation:

Other Relevant Topics

Swerve Drive Kinematics:

Machine learning is a more advanced topic:

You can’t perform that action at this time.