search

proveskit / fprime-proves

Apache License 2.0
1 stars 1 forks source link

readme

F´ PROVES

build

F´ (F Prime) flight software for the PROVES CubeSat Kit. This version of the PROVES flight software is under development and is not ready to be used with flight hardware. Please see proveskit/flight_software for our latest flight ready software.

Building and Running the Deployment

Getting started is easy! Please let us know if you run into any issues with the instructions below.

Check your environment

You must have Python 3.9+ to build this repo. You can check with python3 --version

Setup dependencies

  1. Pull the fprime submodule git submodule update --init --recursive
  2. Create a python venv python3 -m venv fprime-venv
  3. Activate the venv . fprime-venv/bin/activate
  4. Install required packages pip install -r fprime/requirements.txt
  5. Install the arduino-cli curl -fsSL https://raw.githubusercontent.com/arduino/arduino-cli/master/install.sh | BINDIR=$VIRTUAL_ENV/bin sh
  6. Install the arduino-cli-wrapper pip install arduino-cli-cmake-wrapper
  7. Install the RP2040 board 
    arduino-cli config init
arduino-cli config add board_manager.additional_urls https://github.com/earlephilhower/arduino-pico/releases/download/global/package_rp2040_index.json
arduino-cli core install rp2040:rp2040
  8. Install additional arduino-cli dependencies: 
    arduino-cli lib install Time
arduino-cli lib install RadioHead

Deploy onto the RP2040

  1. Build the binary fprime-util generate rpipico && fprime-util build rpipico -j20
  2. Move the binary from 'build-artifacts/rpipico/BroncoDeployment/bin/BroncoDeployment into the Proves board over USB after it has been intiialized in boot loader mode (Press both Boot loader and Reset button at the same time). This should reinit the board automatically and will run the deployment.

Run GDS over serial:

  1. fprime-gds -n --dictionary build-artifacts/rpipico/BroncoDeployment/dict/BroncoDeploymentTopologyAppDictionary.xml --comm-adapter uart --uart-baud 115200 --uart-device /dev/ttyACM0 --output-unframed-data -
    • Be sure to replace '--uart-device /dev/ttyACM0' to the proper port you connect to the board!