Step 1: Choose an AWS CloudFormation Template - AWS Ground Station

Step 1: Choose an AWS CloudFormation Template

After you onboard your satellite, you need to define mission profiles to define the AWS Ground Station antenna configuration to downlink data from your satellite. To assist you with this process, we provide preconfigured AWS CloudFormation templates that use public broadcast satellites. These templates make it easy for you to start using AWS Ground Station. For more information about AWS CloudFormation, see What is AWS CloudFormation?

Preconfigured Templates

Today, you can configure multiple streams of data per contact to flow into an S3 bucket. These data streams are available in two different formats. Data streams containing VITA-49 Signal/IP data can be configured for S-Band and X-Band signals up to 54 MHz in bandwidth. VITA-49 Extension data/IPs can be configured for demodulated and/or decoded X-Band signals up to 500 MHz in bandwidth.

AWS Ground Station provides templates for both data stream formats that demonstrate how to use the service. Use this guide to find the right template for you.

Available templates

You can use a preconfigured template to receive direct broadcast data from the Aqua, SNPP, JPSS-1/NOAA-20, and Terra satellites. These AWS CloudFormation templates contain the required AWS Ground Station and Amazon S3 resources to schedule and execute contacts and receive the data in an Amazon S3 bucket in your account. If Aqua, SNPP, JPSS-1/NOAA-20, and Terra are not onboarded to your account, see Customer Onboarding.

  • The AWS CloudFormation template named AquaSnppJpss-1DemodDecodeS3DataDelivery.yml contains an Amazon S3 bucket and the required AWS Ground Station resources to schedule contacts and receive demodulated and decoded direct broadcast data. This template is a good starting point if you plan to process the data using NASA Direct Readout Labs software (RT-STPS and IPOPP).

    To download the template using AWS CLI, use the following command:

    aws s3 cp s3://groundstation-cloudformation-templates-us-west-2/AquaSnppJpss-1DemodDecodeS3DataDelivery.yml .

    You can view and download the template in the console by navigating to the following URL in your browser:

    https://s3.console.aws.amazon.com/s3/object/groundstation-cloudformation-templates-us-west-2/AquaSnppJpss-1DemodDecodeS3DataDelivery.yml

    You can specify the template directly in AWS CloudFormation using the following link:

    https://groundstation-cloudformation-templates-us-west-2.s3.us-west-2.amazonaws.com/AquaSnppJpss-1DemodDecodeS3DataDelivery.yml
  • The AWS CloudFormation template named AquaSnppJpss-1TerraDigIfS3DataDelivery.yml contains an Amazon S3 bucket and the required AWS Ground Station resources to schedule contacts and receive VITA-49 Signal/IP direct broadcast data. This template is a good starting point if you plan to process the data using a software defined radio (SDR) to demodulate and decode the data before post-processing.

    To download the template using AWS CLI, use the following command:

    aws s3 cp s3://groundstation-cloudformation-templates-us-west-2/AquaSnppJpss-1TerraDigIfS3DataDelivery.yml .

    You can view and download the template in the console by navigating to the following URL in your browser:

    https://s3.console.aws.amazon.com/s3/object/groundstation-cloudformation-templates-us-west-2/AquaSnppJpss-1TerraDigIfS3DataDelivery.yml

    You can specify the template directly in AWS CloudFormation using the following link:

    https://groundstation-cloudformation-templates-us-west-2.s3.us-west-2.amazonaws.com/AquaSnppJpss-1TerraDigIfS3DataDelivery.yml

What resources do these template define?

Both of the templates contain the same resources, with the sole difference being the antenna configs. See the Antenna Config description below for more information.

  • Amazon S3 Bucket - The bucket to which the downlinked data will be delivered. The name of this bucket starts with aws-groundstation to meet criteria described in S3 Recording Config.

  • IAM Role - A role assumable by the groundstation.amazonaws.com service principal that AWS Ground Station assumes when writing the downlinked data to your Amazon S3 bucket.

  • Amazon S3 Bucket Policy - A policy that allows the IAM Role to perform the following actions on your Amazon S3 bucket and its objects:

    • s3:GetBucketLocation

    • s3:PutObject

  • Tracking Config - An AWS Ground Station tracking config that defines how the antenna system tracks your satellite as it moves through the sky.

  • S3 Recording Config - An AWS Ground Station S3 recording config that references the Amazon S3 bucket and IAM role for AWS Ground Station to use when delivering your data.

  • Antenna Config - An AWS Ground Station antenna config that specifies how to configure the AWS Ground Station antenna during a contact. The AquaSnppJpss-1DemodDecodeS3DataDelivery.yml template contains an antenna downlink demod decode config that configures the AWS Ground Station antenna to demodulate and decode the downlinked data before delivering it to your Amazon S3 bucket. The AquaSnppJpss-1TerraDigIfS3DataDelivery.yml instead contains an antenna decode config that configures the AWS Ground Station antenna to deliver the data to your Amazon S3 as VITA-49 Signal/IP packets.

  • Mission Profile - An AWS Ground Station mission profile that groups all of the AWS Ground Station configs together to allow you to schedule and execute contacts using the configurations referenced.

Building your own template

Configuring the resources to schedule and execute contacts for your own satellites requires you configure the AWS Ground Station resources in your account to match your satellite's settings. This is difficult to do on your own. The AWS Ground Station team is available to help you configure the AWS Ground Station resources in your account to downlink from and uplink to your satellite. To configure your own satellite to use with AWS Ground Station, contact AWS Support.