Creating a Reference Deployment

Oct 13, 2025 by wbrum.org 58 views

Introduction

In this article, we will guide you through the process of creating a reference deployment for the HPSC (High-Performance System Controller) board using the fprime-hpsc-linux library. This library provides a set of tools and utilities to help you develop and deploy applications on the HPSC board. Our goal is to create a reference deployment that can be used as a starting point for your own projects, and to ensure that it works correctly on the HPSC board in the lab.

Prerequisites

Before we begin, make sure you have the following:

An HPSC board available in the F Prime Lab
The fprime-hpsc-linux library installed on your system
A basic understanding of Linux and C programming

Hooking up the HPSC Board

The first step is to hook up the HPSC board in the F Prime Lab. This involves connecting the board to a power source, a display, and a keyboard. Once the board is powered on, you should see a Linux console on the display.

# Connect to the HPSC board using SSH
ssh root@hpsc-board-ip

Creating a Reference Deployment

A reference deployment is a pre-configured environment that includes all the necessary tools and utilities to develop and deploy applications on the HPSC board. To create a reference deployment, we will use the fprime-hpsc-linux library.

# Clone the fprime-hpsc-linux repository
git clone https://github.com/fprime-hpsc-linux/fprime-hpsc-linux.git

# Change into the repository directory
cd fprime-hpsc-linux

# Build the reference deployment
make reference-deployment

Running the Reference Deployment

Once the reference deployment is built, we can run it on the HPSC board. This will start the Linux kernel and the necessary services to support the reference deployment.

# Run the reference deployment on the HPSC board
./run-reference-deployment.sh

Sending a Command and Receiving Completion Events

To verify that the reference deployment is working correctly, we will send a command to the HPSC board and receive the corresponding completion events.

// Send a NO_OP command to the HPSC board
int send_no_op_command() {
    int fd = open("/dev/hpsc", O_RDWR);
    if (fd < 0) {
        return -1;
    }

    char command[] = "NO_OP";
    write(fd, command, strlen(command));

    close(fd);
    return 0;
}

// Receive completion events from the HPSC board
int receive_completion_events() {
    int fd = open("/dev/hpsc", O_RDWR);
    if (fd < 0) {
        return -1;
    }

    char buffer[1024];
    read(fd, buffer, 1024);

    close(fd);
    return 0;
}

Running Nominal F Prime FIT Scripts

To ensure that the reference deployment is working correctly, we will run the nominal F Prime FIT (Functional Integration and Test) scripts.

# Run the nominal F Prime FIT scripts
./run-fprime-fit.sh

Verifying Test Results

To verify that all tests pass, we will check the output of the FIT scripts.

# Check the output of the FIT scripts
cat fprime-fit-output.log

Adding Reference Deployment to CI

To automate the process of creating and running the reference deployment, we will add it to our Continuous Integration (CI) pipeline.

# Add the reference deployment to the CI pipeline
git add .
git commit -m "Added reference deployment to CI pipeline"
git push origin main

Conclusion

In this article, we have guided you through the process of creating a reference deployment for the HPSC board using the fprime-hpsc-linux library. We have also verified that the reference deployment works correctly on the HPSC board in the lab, and that it can send a command and receive completion events. Finally, we have added the reference deployment to our CI pipeline to automate the process of creating and running it.

Future Work

In the future, we plan to:

Improve the performance of the reference deployment
Add support for additional features and functionality
Integrate the reference deployment with other systems and applications

References

fprime-hpsc-linux repository
HPSC board documentation
Linux kernel documentation
HPSC Linux Reference Deployment Q&A =====================================

Introduction

In our previous article, we guided you through the process of creating a reference deployment for the HPSC (High-Performance System Controller) board using the fprime-hpsc-linux library. In this article, we will answer some of the most frequently asked questions about the HPSC Linux reference deployment.

Q: What is the HPSC Linux reference deployment?

A: The HPSC Linux reference deployment is a pre-configured environment that includes all the necessary tools and utilities to develop and deploy applications on the HPSC board. It provides a starting point for your own projects and ensures that the HPSC board is working correctly.

Q: How do I create a reference deployment?

A: To create a reference deployment, you will need to clone the fprime-hpsc-linux repository, change into the repository directory, and run the make reference-deployment command.

# Clone the fprime-hpsc-linux repository
git clone https://github.com/fprime-hpsc-linux/fprime-hpsc-linux.git

# Change into the repository directory
cd fprime-hpsc-linux

# Build the reference deployment
make reference-deployment

Q: How do I run the reference deployment?

A: To run the reference deployment, you will need to run the ./run-reference-deployment.sh script.

# Run the reference deployment on the HPSC board
./run-reference-deployment.sh

Q: What is the purpose of the NO_OP command?

A: The NO_OP command is used to test the communication between the HPSC board and the Linux kernel. It sends a command to the HPSC board and receives the corresponding completion events.

Q: How do I send a NO_OP command?

A: To send a NO_OP command, you will need to use the send_no_op_command function.

// Send a NO_OP command to the HPSC board
int send_no_op_command() {
    int fd = open("/dev/hpsc", O_RDWR);
    if (fd < 0) {
        return -1;
    }

    char command[] = "NO_OP";
    write(fd, command, strlen(command));

    close(fd);
    return 0;
}

Q: How do I receive completion events?

A: To receive completion events, you will need to use the receive_completion_events function.

// Receive completion events from the HPSC board
int receive_completion_events() {
    int fd = open("/dev/hpsc", O_RDWR);
    if (fd < 0) {
        return -1;
    }

    char buffer[1024];
    read(fd, buffer, 1024);

    close(fd);
    return 0;
}

Q: How do I run nominal F Prime FIT scripts?

A: To run nominal F Prime FIT scripts, you will need to run the ./run-fprime-fit.sh script.

# Run the nominal F Prime FIT scripts
./run-fprime-fit.sh

Q: How do I verify test results?

A: To verify test results, you will need to check the output of the FIT scripts.

# Check the output of the FIT scripts
cat fprime-fit-output.log

Q: How do I add the reference deployment to my CI pipeline?

A: To add the reference deployment to your CI pipeline, you will need to add the ./run-reference-deployment.sh script to your CI pipeline configuration.

# Add the reference deployment to the CI pipeline
git add .
git commit -m "Added reference deployment to CI pipeline"
git push origin main

Conclusion

In this article, we have answered some of the most frequently asked questions about the HPSC Linux reference deployment. We hope that this Q&A article has been helpful in providing you with the information you need to create and run a reference deployment on the HPSC board.

Future Work

In the future, we plan to:

Improve the performance of the reference deployment
Add support for additional features and functionality
Integrate the reference deployment with other systems and applications