Usage
Running the Application To start the application, run the Flask server on your local machine. By default, the application is accessible at:
`http://127.0.0.1:5000`
Using the GUI Once you open the GUI in your browser, you will see several buttons that allow you to interact with the system. Below is an overview of the available functionalities and the necessary steps to perform antenna operations.
Buttons and Their Functions
Initialize System
Description: This is the first step to perform any antenna operation.
Function: Starts a VCAN network, runs the antenna simulator on a Docker container, and subscribes to relevant sensors on the simulator.
Steps to Use:
Click on the “Initialize System” button.
You will be prompted with a modal to enter your system password.
Enter your password and click submit.
Wait for the system to start and confirm initialization.
Confirmation of initialization:
Stow pin state reports ENGAGED
Mode state reports IDLE
Functional state reports BRAKED
Scan Sources Currently the scan Sources button is not functional.
Antenna Modes
Description: Allows you to choose the operational mode of the antenna.
Modes:
IDLE: The antenna is in a standby state.
POINT: The antenna is ready to point to a specified azimuth and elevation.
STOW: The antenna is parked in its default stowed position.
Steps to Use:
Click on the “Antenna Modes” button.
Select the desired mode (IDLE, POINT, or STOW).
Confirm the mode selection to change the antenna’s operational state.
Point Source
Description: Allows you to manually point the antenna to a specific azimuth and elevation.
Function: Adjusts the antenna’s direction based on user input.
Steps to Use:
Click on the “Point Source” button.
Enter the desired azimuth and elevation values and submit.
Confirm to point the antenna to the specified direction.
Track Source
Description: Enables the antenna to automatically track a specific source, such as the sun or an Intel satellite.
Function: Uses predefined algorithms to follow the chosen source.
Steps to Use:
Click on the “Track Source” button.
Select the source you want to track (e.g., Sun, Intel Satellite).
You can either use Azimuth speed and Elevation speed or not.
The system will start tracking the chosen source.
Monitored attributes on the antenna
Attribute |
Type |
Description |
|---|---|---|
Azimuth |
float |
The azimuth angle of the antenna. Limits: -127.0 <= az <= 127.0 |
Elevation |
float |
The elevation angle of the antenna. Limits: -15.0 <= el <= 92.0 |
Timestamp |
time |
The timestamp of the measurement. |
Mode |
enum |
The operational mode of the antenna. See Mode Enum. |
FuncState |
enum |
The functional state of the antenna. See FuncState Enum. |
StowPinState |
enum |
The stow pin state of the antenna. See StowPinState Enum. |
Enums
Mode Enum
class Mode(enum.IntEnum):
IDLE = 0
POINT = 1
STOW = 2
UNKNOWN = 3
FuncState Enum
class FuncState(enum.IntEnum):
BRAKED = 0
MOVING = 1
ESTOP = 2
ERROR = 3
UNKNOWN = 4
StowPinState Enum
class StowPinState(enum.IntEnum):
NOT_ENGAGED_NOT_RELEASED_NOT_STOW_WINDOW = 0
NOT_ENGAGED_NOT_RELEASED_STOW_WINDOW = 1
NOT_ENGAGED_RELEASED_NOT_STOW_WINDOW = 2
NOT_ENGAGED_RELEASED_STOW_WINDOW = 3
ENGAGED_NOT_RELEASED_NOT_STOW_WINDOW = 4
ENGAGED_NOT_RELEASED_STOW_WINDOW = 5
ENGAGED_RELEASED_NOT_STOW_WINDOW = 6
ENGAGED_RELEASED_STOW_WINDOW = 7
UNKNOWN = 8
Application state transition
Functional state transition
Mode transition