wiki
Getting startedGuidesFAQ
1.0.0
1.0.0
  • b-it-bots wiki
  • @home
    • Getting started
      • First steps
      • Setting up your development environment
        • Configuring your editor
        • Using ssh
      • Adding your first contribution
    • Tutorials
      • Architecture
    • Guides
      • git
        • Making good commits
        • Branching model
        • Adding git aliases to make your life easier
        • Creating a release
      • SSH
      • ROS
        • Creating a new package
          • Creating a new node
        • Creating a new message, service or action
        • Testing in ROS
        • Linting
      • Coding conventions
        • C++
        • Python
      • Toolkit
        • CLion
        • Atom configuration
        • Using vim
        • TMUX - Terminal Multiplexer
    • Resources
    • FAQ
      • git
  • @work
    • 2018-05-06-navigation-atwork
    • 2018-05-06-simulation_mapping
    • How to use the RealSense2 camera
    • Getting the classifier from a data set
Powered by GitBook
On this page
  • Installing the requirements
  • ROS - Robot Operating System
  • Git - Version Control
  • GitHub setup
  • Fork the b-it-bots@home repositories

Was this helpful?

  1. @home
  2. Getting started

First steps

PreviousGetting startedNextSetting up your development environment

Last updated 4 years ago

Was this helpful?

Installing the requirements

Ubuntu Xenial 16.04 LTS

We recommend you use Ubuntu 16.04 for your development environment. In general, our repository and its related components have been tested using Ubuntu Xenial. Keep in mind that the robots in the lab will also be setup with the latest compatible Ubuntu distribution.

If you are not currently using Ubuntu, you can download it to your computer from

ROS Kinetic officially supports Ubuntu Wily (15.10) and Ubuntu Xenial (16.04 LTS). To see other supported platforms please see the .

It is possible to set up a different operating system for your development environment. However is the support for those options very limited or not given at all. In the following you find an approach for Arch-Linux that has been applied by some students, already.

Arch-linux

It is possible to setup your development environment by using a Docker-based setup locally.

ROS - Robot Operating System

The current supported version of ROS is Kinetic Kame. To install ROS, follow the official installation instructions found here:

ROS Kinetic -

Don't forget to initialize rosdep:

sudo rosdep init
rosdep update

Finally, a few recommended tools that you can install include and :

sudo apt install python-wstool python-catkin-tools

Git - Version Control

Installation

Install the Git core components and some additional GUI's for the version control:

 sudo apt-get install git-core gitg gitk

Set Up Git

Now it's time to configure your settings. To do this you need to open a new Terminal. First you need to tell git your name, so that it can properly label the commits you make:

 git config --global user.name "Your Name Here"

Git also saves your email address into the commits you make.

 git config --global user.email "your-email@youremail.com"

Add your ssh key to GitHub

Make sure that you are following the instructions for Linux.

GitHub setup

Fork the b-it-bots@home repositories

Required:

Required:

Required:

Required:

Optional:

Required:

Optional:

Required:

Optional:

It is recommended that you use ssh to connect to GitHub. For more information you can read GitHub's documentation on ssh .

Make sure you have joined the b-it-bots organization by visiting

Depending on what you are working on, you might want to fork different repositories. For most people working on the following areas, will be more than enough, but here are some other repositories you might want to fork:

To find out how to fork a repo, .

http://www.ubuntu.com/download
ROS Kinetic installation instructions
http://wiki.ros.org/kinetic/Installation/Ubuntu
wstool
catkin-tools
here
https://github.com/b-it-bots
mas_domestic_robotics
mas_domestic_robotics
mas_domestic_robotics
mas_domestic_robotics
mas_domestic_robotics
mas_perception
dataset_interface
mas_domestic_robotics
mas_execution_manager
mas_knowledge_base
action-execution
mas_domestic_robotics
mas_hri_interface
use GitHub's guide