AquaSnppJpssTerraDigIF Template - AWS Ground Station

AquaSnppJpssTerraDigIF Template

The AWS CloudFormation template named AquaSnppJpssTerraDigIF.yml is designed to give you quick access to start receiving digitized intermediate frequency (DigIF) data for the Aqua, SNPP, JPSS-1/NOAA-20, and Terra satellites. It contains an Amazon EC2 instance and the required AWS CloudFormation resources to receive raw DigIF direct broadcast data. This template is a good starting point for processing the data using a software defined radio (SDR).

If Aqua, SNPP, JPSS-1/NOAA-20, and Terra are not onboarded to your account, see Customer Onboarding.

Important

When creating an AWS CloudFormation stack from the provided template, the Amazon EC2 instance will install Data Defender upon creation and needs to complete the installation (approximately 5 minutes) before you manually stop the Amazon EC2 instance. Once Data Defender installation is complete and the instance is stopped, you will need to start the instance before a reserved contact. The template provides the option to automatically start and/or stop the instance for you or you can choose to do it manually.

You can access the template by accessing the customer onboarding S3 bucket. Note that the links below use a regional S3 bucket. Change <us-west-2> to the region in which you are creating the AWS CloudFormation stack.

Note

The following instructions use YAML. However, the templates are available in both YAML and JSON format. To use JSON, replace <.yml> with <.json>.

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

aws s3 cp s3://groundstation-customer-assets-us-west-2/cloudformation_templates/AquaSnppJpssTerraDigIF.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-customer-assets-us-west-2/cloudformation_templates/AquaSnppJpssTerraDigIF.yml

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

https://groundstation-customer-assets-us-west-2.s3-us-west-2.amazonaws.com/cloudformation_templates/AquaSnppJpssTerraDigIF.yml

What resources does the template define?

The AquaSnppJpssTerraDigIF template includes the following resources:

  • Data Delivery Service Role - AWS Ground Station assumes this role to create/delete ENIs in your account in order to stream data.

  • (Optional) Receiver Instance - The Amazon EC2 instance that will send/receive data to/from your satellite using AWS Ground Station.

    • Instance Security Group - The security group for your Amazon EC2 instance.

    • Instance Role - The role for your Amazon EC2 instance.

    • Instance Profile - The instance profile for your Amazon EC2 instance.

    • Cluster Placement Group - The placement group in which your Amazon EC2 instance is launched.

  • Dataflow Endpoint Security Group - The security group that the elastic network interface created by AWS Ground Station belongs to. By default, this security group allows AWS Ground Station to stream traffic to any IP address in your VPC. You can modify this in a way that limits traffic to a specific set of IP addresses.

  • Receiver Instance Network Interface - An elastic network interface that provides a fixed IP address for AWS Ground Station to connect to. This attaches to the receiver instance on eth1.

  • Receiver Instance Interface Attachment - An elastic network interface that attaches to your Amazon EC2 instance.

  • (Optional) CloudWatch Event Triggers - AWS Lambda Function that is triggered using CloudWatch Events sent by AWS Ground Station before and after a contact. The AWS Lambda Function will start and optionally stop your Receiver Instance.

  • Dataflow Endpoint Group - The AWS Ground Station dataflow endpoint group that defines the endpoints used to send/receive data to/from your satellite. As part of the dataflow endpoint group creation, AWS Ground Station creates an elastic network interface in your account to stream data.

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

  • Downlink Dig IF Endpoint Config - A defined endpoint used to downlink data from your satellite.

In addition, the template provides the following resources for the Aqua, SNPP, JPSS-1/NOAA-20, and Terra satellites:

  • A downlink DigIF antenna config for Aqua, SNPP, JPSS-1/NOAA-20, and Terra.

  • A mission profile for JPSS-1/NOAA-20 and SNPP, a mission profile for Aqua, and a mission profile for Terra.

The values and parameters for the satellites in this template are already populated. These parameters make it easy for you to use AWS Ground Station immediately with these satellites. You do not need to configure your own values in order to use AWS Ground Station when using this template. However, you can customize the values to make the template work for your use case.

Where do I receive my data?

The dataflow endpoint group is set up to use the receiver instance network interface that part of the template creates. The receiver instance uses Data Defender to receive the data stream from AWS Ground Station on the port defined by the dataflow endpoint. Once received, the data is available for consumption via UDP port 50000 on the loopback adapter of the receiver instance. For more information about setting up a dataflow endpoint group, see AWS::GroundStation::DataflowEndpointGroup.