F Prime Installation

Troubleshooting not in F’ user guide

Enviroment
Linux: Ubuntu LTS 20.04
FPrime: latest / branch: devel
Python: 3.9.11
CMake: 3.24.0
OpenSSL: 1.1.1f

Steps

• Tutorial
• Installation Guide
• Install F’
• Install Tab Completion

CMake not able to find OpenSSL library

Could NOT find OpenSSL, try to set the path to OpenSSL root folder in the
 system variable OPENSSL_ROOT_DIR (missing: OPENSSL_LIBRARIES
 OPENSSL_INCLUDE_DIR)

Solution

• Instal OpenSSL

Python3 building virtual environment

Error: Command '['/home/user/fprime-venv/bin/python3', '-Im', 'ensurepip', ' - upgrade', ' - default-pip']' returned non-zero exit status 1.

Tried

sudo apt-get install python3.9-dev python3.9-venv

Solution

• uninstall python 3.9.11 and install python 3.9.10

Leave venv

• How to leave/exit/deactivate a Python virtualenv

Ubuntu desktop crash

Solution

• How to Fix the Ubuntu Login Loop

Build error while “pip install requirements.txt”

Building wheel for fprime-fpp (setup.py) ... error
  error: subprocess-exited-with-error
  
  × python setup.py bdist_wheel did not run successfully.
  │ exit code: 1
  ╰─> [34 lines of output]
note: This error originates from a subprocess, and is likely not a problem with pip.
ERROR: Failed building wheel for fprime-fpp

solution

pip install zipp==3.8.0

And install requirements.txt again

Errors

if args.zmq and zmq is None:
AttributeError: ‘Namespace’ object has no attribute ‘zmq’

tried

• Python3: ImportError: No module named ‘_ctypes’ when using Value from module multiprocessing

solution

• put import zmq at the begining of cli.py

No module named '_ctypes'

solution

• reconfigure and remake python 3.9.10

root = Path(args.root_dir)
NameError: name 'Path' is not defined

solution

• addfrom pathlib import Path at the begining of run_deployment.py
• pip show fprime-gds to check gds version latest is 3.1.2

Install Tab Completion

Autocomplete: Tab Completion for Command-Line Tools

Run F Prime

source $HOME/fprime-venv/bin/activate

The above command must be run in each new terminal where the user wishes to use the virtual environment.

fprime-gds -g html -r <path to fprime checkout>/Ref/build-artifacts

By running this command, a webpage like below figure will show up.