Skip to content
This repository has been archived by the owner on Dec 15, 2022. It is now read-only.

Latest commit

 

History

History
56 lines (42 loc) · 2.56 KB

README.md

File metadata and controls

56 lines (42 loc) · 2.56 KB

Shared Software

This repository contains the vehicle agnostics code designed to work in conjunction with UWRT's main codebase riptide_software. This repo is designed to work with the Robot Operating System framework.

The Underwater Robotics Team
The Ohio State University

Website | RoboSub | License

OSU UWRT Logo

What This Package Contains

shared_hardware -- Common hardware interfaces for The OSU Underwater Robotics Team

  • scripts -- Common scripts for setting up various peripherals.
  • imu_state.cpp -- Node for transforming IMU state messages.
  • udev -- Contains UDEV rules for our peripherals.

shared_utils -- Common custom utilities for making ROS a little easier to deal with.

  • extract_video.cpp -- Node to extract an AVI from a series of rosbag image messages.

Building

ROS is compiled using the catkin build system, and so this repo will use catkin.

Cloning

To collaborate with the sim_software platform, you must fork this repo (click "Fork" at the top-right of this page). When executing the commands below, you will need to enter the URL to your forked repo. Form YOUR forked repo, click "Clone or download" at the top-right of the page, copy the URL, and then insert that URL in place of "<your_forked_repo>".

mkdir -p ~/osu-uwrt/shared_software/
cd ~/osu-uwrt/shared_software/
git clone <your_forked_repo> src

Setting up Git Remotes

Since you just cloned your fork to your computer, your remote called "origin" will point to your fork. Now, create a new remote called "upstream" that points to this repo.

cd ~/osu-uwrt/shared_software/src/
git remote add upstream https://github.com/osu-uwrt/shared_software.git

Now, if you type:

git remote -v

You will see both a remote to your fork and to the main repo. You will use these two remotes a lot when pushing code to your fork, submitting pull-requests, and pulling down the latest code.

Compiling

To compile this repo, you simply execute the "catkin_make" command from a terminal. As a word of caution, you MUST be inside the folder "~/osu-uwrt/shared_software" to run "catkin_make"

cd ~/osu-uwrt/shared_software/
catkin_make

Chaining Workspaces

Please refer to the Readme for the riptide_software for how to chain workspaces.