Astrobee Robot Software
About
Three NASA Astrobee free-flying robots have been operating inside
the International Space Station (ISS) since 2019. This astrobee repository contains source code for the Astrobee Robot Software, consisting of
the flight software that runs onboard the Astrobee robots, a software simulator, and supporting tools, primarily written in C++.
Astrobee's flight software performs vision-based localization,
provides autonomous navigation, docking and perching, manages various sensors
and actuators, and supports human-robot interaction with co-located astronauts via screen-based displays, light
signaling, and sound. The flight software is hosted on each Astrobee's three internal single board computers and
uses the open-source Robot Operating System (ROS) framework as message-passing
middleware. It provides a high-level Astrobee Command API for controlling the robot and has multiple operating modes. It can execute a plan (command sequence), individual operator commands (teleoperation), or commands from guest science code running onboard Astrobee.
The Astrobee Robot Software simulator, built using ROS and Gazebo, enables the flight software to be evaluated without the need for robot hardware. The supporting tools include a tool that processes ISS imagery to build maps for Astrobee localization, along with many others.
Released separately, the Astrobee ground data system (GDS) includes Astrobee control station software that communicates with Astrobee flight software via the Data Distribution Service (DDS) network protocol over the ISS Ku-IP space-to-ground link. The control station is written primarily in Java using the Eclipse RCP framework. Source code is in the astrobee_gds repository, or you can download the binary release.
Together, the Astrobee Robot and Ground Software were the NASA Software of the Year Award Runner-Up in 2020!
The Astrobee Robot Software remains a work in progress. Please consult the
release notes for the current list of features and limitations.
Usage
Instructions on installing and using the Astrobee Robot Software.
Contributing
The Astrobee Robot Software is open source, and we welcome contributions
from the public. Please submit pull requests to the develop branch. The code must follow the Astrobee code style.
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
Extensive documentation is auto-generated from the contents of this repository.
"A Brief Guide to Astrobee’s Flight Software" is a good tutorial, with a particular emphasis on the advanced topic of modifying Astrobee's flight software to enable Guidance, Navigation, & Control (GN&C) research. (Note that most guest science can be implemented as an app that uses the Astrobee Command API without modifying the flight software.)
The "Astrobee ROS Demo" package provides a C++/Python interface to implement custom control methods in ROS.
For more information, read Astrobee-related publications.
Learning about the Astrobee platform,
software, original mapping and localization system, and current localizer
are good starting points.
Guest Science
The ISS Astrobee Facility maintains a collection of resources for guest scientists interested in conducting research with Astrobee, including the Astrobee Guest Science Guide overview.
Guest science code that runs onboard Astrobee is usually hosted as an Android Java app running on Astrobee's high-level processor (HLP). Guest science apps can use the Astrobee Command API through its Java bindings. The astrobee_android repository contains source code for Astrobee services that run on the HLP, example guest science apps, as well as a Guest Science Readme and Guest Science Developer Guide focused on HLP guest science apps.
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.
