Bring Your Own Satellite

In this last section of the workshop, you will learn how you can deploy a pre-built satellite with a few more bells and whistles.


Once again, you will use Docker to deploy your virtual satellite but this time, you do not have to build it from scratch. Rather, you will simply need to deploy the new satellite using the following command:

docker run --net=openc3-cosmos-network --name HackSpaceCon -p1234:1234/udp -p1337:1337 --rm hackethos/hsc-1

alt text

Deploying Docker Container

The previous command will download the container image and then deploy it with the name HackSpaceCon.

Right after Docker has downloaded the container image, you should see the new satellite running in your terminal window like what is shown below.

alt text

HackSpaceCon Satellite Running

With your HackSpaceCon satellite running, you will then need to download the pre-generated COSMOS plugin.

In a new terminal window, you can then run the following command to download the pre-generated COMSOS plugin:

wget https://byos.ethoslabs.space/openc3-cosmos-hackspacecon-1-1.0.0.gem

OR you click the following link from within your VM's browser:

Click Here: Download HSC-1 Plugin

alt text

Downloading Plugin File Via wget

After you have downloaded the plugin file, you need to get the IP address of your container using the following command, looking for the entry for HackSpaceCon as well as the openc3-operator container:

docker network inspect openc3-cosmos-network

alt text

HackSpaceCon Container IP Address

Once you have the IP address, you can switch over to your VM's browser and access the Admin Console within COSMOS, to be able to install the plugin.

alt text

COSMOS Admin Console

Click on the middle section as highlighted above and then find your newly downloaded plugin and click Select.

alt text

HackSpaceCon Plugin File Selection

Like the previous section you will need to populate the IP address field for you plugin and then click Install.

alt text

Configuring Plugin and Installing

Once installation and configuration is complete, you can click on the CmdTlmServer menu option from the side menu and see that your new interface is connected.

alt text

HackSpaceCon_1 Interface Connected in COSMOS

Next click on the Command Sender option and make sure HackSpaceCon-1 is selected as the target. Then select SAT_ENA_TLM as the packet and in the DEST_IP field, insert the IP address of your openc3-operator container and then click Send.

alt text

Sending SAT_ENA_TLM Command

Switching over to your terminal window where your HackSpaceCon- satellite is running, you should see that the satellite received the command successfully.

alt text

Satellite Received Command

Switching back to COSMOS and clicking on the CmdTlmSever menu option and the Tlm packets option in the top bar, you should see that the packet TLM_STATUS has a packet count of one, meaning that it successfully received data from your satellite.

Note

You may need to expand the number of packets shown from the default 10 to a high number to see the packet.

alt text
Rows Per Page Selection

alt text

Tlm Packets for HACKSPACECON_1

Feel free to play with the other commands for a moment. Once done, you can remove the plugin from COSMOS using the Admin Console by clicking on the trashcan icon and then you can stop your virtual satellite by hitting crtl+c.