NASA Astrobee Robot Software
Switch branches/tags
Nothing to show
Clone or download
bcoltinnasa Release 0.5.0.
Build 3 - CERT Release. Prepared for CERT testing and upgraded
simulator.
Latest commit d4c05f6 Oct 17, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
astrobee Release 0.5.0. Oct 17, 2018
behaviors Release 0.5.0. Oct 17, 2018
cmake Release 0.5.0. Oct 17, 2018
communications
debian Release 0.5.0. Oct 17, 2018
description Release 0.5.0. Oct 17, 2018
doc Release 0.5.0. Oct 17, 2018
external
gnc Release 0.5.0. Oct 17, 2018
hardware Release 0.5.0. Oct 17, 2018
localization Release 0.5.0. Oct 17, 2018
management Release 0.5.0. Oct 17, 2018
mobility Release 0.5.0. Oct 17, 2018
scripts Release 0.5.0. Oct 17, 2018
shared Release 0.5.0. Oct 17, 2018
simulation Release 0.5.0. Oct 17, 2018
submodules Release 0.5.0. Oct 17, 2018
tools Release 0.5.0. Oct 17, 2018
wdock First release of Astrobee Robot Software v1. Aug 31, 2017
.gitignore Release 0.4.0. Jul 13, 2018
.gitmodules First release of Astrobee Robot Software v1. Aug 31, 2017
CMakeLists.txt Release 0.5.0. Oct 17, 2018
INSTALL.md Release 0.5.0. Oct 17, 2018
LICENSE First release of Astrobee Robot Software v1. Aug 31, 2017
NASA_INSTALL.md Release 0.4.0. Jul 13, 2018
NOTICE Release 0.4.0. Jul 13, 2018
README.md Release 0.5.0. Oct 17, 2018
RELEASE.md Release 0.5.0. Oct 17, 2018
THIRD_PARTY Release 0.4.0. Jul 13, 2018
freeflyer.doxyfile Release 0.5.0. Oct 17, 2018
licenses.csv First release of Astrobee Robot Software v1. Aug 31, 2017

README.md

Astrobee Robot Software - Flight Software repository

About

Astrobee is a free-flying robot designed to operate as a payload inside the International Space Station (ISS). The Astrobee Robot Software consists of embedded (on-board) software, supporting tools and a simulator. The Astrobee Robot Software operates on Astrobee's three internal single board computers and uses the open-source Robot Operating System (ROS) framework as message-passing middleware. The Astrobee Robot Software performs vision-based localization, provides autonomous navigation, docking and perching, manages various sensors and actuators, and supports user interaction via screen-based displays, light signaling, and sound. The Astrobee Robot Software enables Astrobee to be operated in multiple modes: plan-based task execution (command sequencing), teleoperation, or autonomously through execution of hosted code uploaded by project partners (guest science). The software simulator enables Astrobee Robot Software to be evaluated without the need for robot hardware.

This repository provides flight software and a simulator, both primarily written in C++. The repository also provides several other utilities, including a tool for creating maps for localization. A separate repository, astrobee_android, contains the Java API, which uses the ROS messaging system to communicate with flight software.

The Astrobee Robot Software is in a beta stage. This means that some features are incomplete, and extensive changes can be expected. Please consult RELEASE for the current list of features and limitations.

Usage instructions

If you don't have access to NASA's internal network, please see the usage instructions.

If you do, please see the NASA usage instructions.

Contributors

The Astrobee Robot Software is open source, and we welcome contributions from the public. However, for us to merge any pull requests, we must request that contributors sign and submit a Contributor License Agreement due to NASA legal requirements. Thank you for your understanding.

Documentation

To generate the Astrobee documentation, run

doxygen freeflyer.doxyfile

after checking out the code. The documentation will be generated in the doc/html folder. Open the index.html to get to the main page of the documentation.

Guest Science

If you are interested in guest science, please do one of the following for more information.

If you are a non-NASA user, please checkout the astrobee_android nasa github project (if you followed the usage instructions, you should have checked this out already). Once that is checked out, please see guest_science/readme.md located in the astrobee_android/guest_science folder.

If you are a NASA user, please make sure the android submodule was checked out and then visit submodules/android/guest_science/readme.md.

License

Copyright (c) 2017, United States Government, as represented by the Administrator of the National Aeronautics and Space Administration. All rights reserved.

The Astrobee platform is licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.