Skip to content

Commit

Permalink
Fix #114 Add new installation instructions to the readme
Browse files Browse the repository at this point in the history
The following additions were made to improve novice user installation experience.

Added a brief introductory statement describing cFS to the top of the page.
Added prerequisite software (make, cmake, gcc, and git) instruction to the Setup section.
Added statement about a possible third dependency (libcanberra-gtk-module) to the Send commands recieve telemetry section.

Additionally, some typos were corrected.

Resolves: #114
  • Loading branch information
Jandlyn Bentley committed Jul 30, 2020
1 parent b1f3e36 commit 830ad24
Showing 1 changed file with 12 additions and 11 deletions.
23 changes: 12 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@

# Core Flight System - BUNDLE

This repository is a bundle of submodules that make up the Core Flight System (cFS) framework. Note the "lab" apps are intended as examples only, and enable this bundle to build, execute, receive commands, and send telemetry. This is not a flight distribution, which is typically made up of the cFE, OSAL, PSP, and a selection of flight apps that coorespond to specific mission requirements.
The Core Flight System (cFS) is a generic flight software architcture framework used on flagship spacecraft, human spacecraft, cubesats, and Raspberry Pi. This repository is a bundle of submodules that make up the cFS framework. Note the "lab" apps are intended as examples only, and enable this bundle to build, execute, receive commands, and send telemetry. This is not a flight distribution, which is typically made up of the cFE, OSAL, PSP, and a selection of flight apps that correspond to specific mission requirements.

This bundle has not been fully verified as an operational system, and is provided as a starting point vs an end product. Testing of this bundle consists of building, executing, sending setup commands and verifying receipt of telemetry. Unit testing is also run, but extensive analysis is not performed. All verification and validation per mission requirements is the responsibility of the mission (although attempts are made in the cFS Framework to provide a testing framework to facilitate the process).

Expand All @@ -21,7 +21,7 @@ See [releases](https://github.com/nasa/cFS/releases) for release history and ass

**Aquila: OFFICIAL RELEASE**:
- Released under Apache 2.0
- Inclueds cFE 6.7.0 (cFE, PSP, framework apps, and framework tools as marked) and OSAL 5.0.0
- Includes cFE 6.7.0 (cFE, PSP, framework apps, and framework tools as marked) and OSAL 5.0.0

**cFS 6.6.0a Suite: OFFICIAL RELEASE**:
- cFE 6.6.0a is released under Apache 2.0 license, see [LICENSE](https://github.com/nasa/cFE/blob/v6.6.0a/LICENSE-18128-Apache-2_0.pdf)
Expand All @@ -30,7 +30,7 @@ See [releases](https://github.com/nasa/cFS/releases) for release history and ass
- [Version description document](https://github.com/nasa/cFE/blob/v6.6.0a/docs/cFE_6_6_0_version_description.md)
- [Test results](https://github.com/nasa/cFE/tree/v6.6.0a/test-and-ground/test-review-packages/Results)

Other elements listed below are released under a varitey of licenses as detailed in their respective repositories.
Other elements listed below are released under a variety of licenses as detailed in their respective repositories.

## Known issues

Expand All @@ -50,9 +50,9 @@ See related repositories for current open issues.
- Deployment quality of life improvements (configuration, transition to CMake source selection vs compiler directives)
- Update OS support (VxWorks 7, RTEMS 5)
- Time services refactor
- Documentation (updated tracability, APIs/ICDs, general update)
- Documentation (updated traceability, APIs/ICDs, general update)
- Symmetric multi-processing APIs
- Electronic Data Sheet integration option and improvements to packet layouts for portability/consistancy
- Electronic Data Sheet integration option and improvements to packet layouts for portability/consistency
- Toolchain updates

## Getting Help
Expand All @@ -65,7 +65,7 @@ Community email list subscription request: https://lists.nasa.gov/mailman/listin

## Setup

To setup the cFS BUNDLE directly from the latest set of interoperable repositories:
Ensure the following software are installed: Make, CMake, GCC, and Git. To setup the cFS BUNDLE directly from the latest set of interoperable repositories:

git clone https://github.com/nasa/cFS.git
cd cFS
Expand Down Expand Up @@ -95,9 +95,10 @@ Note: The steps above are for a debug, permissive mode build and includes deprec

## Send commands, receive telemetry

The cFS-GroundSystem tool can be used to send commands and receive telemetry (see https://github.com/nasa/cFS-GroundSystem/tree/master/Guide-GroundSystem.txt, the Guide-GroundSystem.txt). Note it depends on PyQt5 and PyZMQ:
The cFS-GroundSystem tool can be used to send commands and receive telemetry. For details on using and setting up the Ground System, see the [Guide-GroundSystem](https://github.com/nasa/cFS-GroundSystem/blob/main/Guide-GroundSystem.md). Note it depends on PyQt5 and PyZMQ:

1. Install PyQt5 and PyZMQ on your system
1. Install PyQt5 and PyZMQ on your system. Some systems may also require installing libcanberra-gtk-module.

2. Compile cmdUtil and start the ground system executable

cd tools/cFS-GroundSystem/Subsystems/cmdUtil
Expand All @@ -109,7 +110,7 @@ The cFS-GroundSystem tool can be used to send commands and receive telemetry (se
4. Select "Enable Tlm"
5. Enter IP address of system executing cFS, 127.0.0.1 if running locally

Should see telemetry, can send noops and see command counters increment
Should see telemetry, can send noops and see command counters increment.

## Compatible list of cFS apps

Expand All @@ -118,11 +119,11 @@ The following applications have been tested against this release:

## Other cFS related elements/tools/apps/distributions

The following list is user submitted, and not CCB controlled. They are released by various orgainizations, under various licenses.
The following list is user submitted, and not CCB controlled. They are released by various organizations, under various licenses.

- Distributions
- cFS-101: Virtual machine distribution at https://github.com/nasa/CFS-101
- OpenSatKit: Open source kit for satelite software at https://github.com/OpenSatKit/OpenSatKit
- OpenSatKit: Open source kit for satellite software at https://github.com/OpenSatKit/OpenSatKit
- Other Ground station software
- TBD
- Other Apps
Expand Down

0 comments on commit 830ad24

Please sign in to comment.