Skip to content

Latest commit

 

History

History
41 lines (36 loc) · 4.6 KB

dependencies.md

File metadata and controls

41 lines (36 loc) · 4.6 KB

Dependencies

Software Dependencies

  • PySide6: Python library for Qt6 GUI framework.
  • Arduino-Cli: Command line utility for compiling and uploading Arduino sketches to the boards.
  • SBC-ArduinoSketches: This repository includes Arduino sketches for clock, trigger fan-in/fan-out, and position sensing Arduinos.
  • SBCBinaryFormat: This repository provides the python library for writing to and reading from sbc binary data format.
  • NI_USB-6501: A third party driver for NI USB device, modified to work with Python3.
  • Icons8: Icons used in the program is by Icons8, specifically the IOS17 Outlined icon set.
  • Other standard python libraries including logging, json, time, datetime, os, sys, enum, re, etc.

Managing and Updating Dependencies

The dependencies of this project is managed in a few different ways. PySide6 is a public python library installed from pip into the conda environment. SBCBinaryFormat is a custom python library that is compiled and installed locally using pip into the conda environment. SBC-ArduinoSketches and NI_USB-6501 are custom/modified code that is included in this repository in the dependencies folder. They are managed using git subtree comand. Arduino-Cli is a public command line program, and the binary executable is downloaded to the DAQ PC, and the path to it is specified in config file.

Using git subtree

git subtree can be used to handle dependencies on external code. Unlike git submodule which contains a link to the original git repository, git subtree contains a hard copy of the repository. Here's a brief tutorial for using git subtree, using the example of SBC-ArduinoSketches which is saved to dependencies/ArduinoSketches.

  • First add the SBC-ArduinoSketches as a remote in the RunControl repository: git remote add arduino-repo https://github.com/SBC-Collaboration/SBC-ArduinoSketches.git.
  • Check that the remote has been added. Run git remote -v. The output should be:
arduino-repo	https://github.com/SBC-Collaboration/SBC-ArduinoSketches.git (fetch)
arduino-repo	https://github.com/SBC-Collaboration/SBC-ArduinoSketches.git (push)
origin	https://github.com/SBC-Collaboration/SBC-RunControl.git (fetch)
origin	https://github.com/SBC-Collaboration/SBC-RunControl.git (push)
  • Add the repository into git subtree: git subtree add --prefix {local directory being pulled into} {remote repo} {remote branch} --squash. In this example, it would be:
git subtree add --prefix dependencies/ArduinoSketches arduino-repo main --squash

This should copy the external repository in the the local directory. The --squash parameter consolidates all commit history of the external repository into one commit, simplifying the local repository history.

  • After changes have been made locally in the dependencies/ArduinoSketches folder, committhe changes using git add and git commit.
  • Upload the changes to external repository by running the following command in the main directory of RunControl:
git subtree push --prefix=dependencies/ArduinoSketches arduino-repo main
  • Upload changes to RunControl repository by running git push origin main.
  • If there has been some changes in the external repository, run git subtree pull --prefix=dependencies/ArduinoSketches arduino-repo main to pull the changes. Commit merges in RunControl repository and upload.

Using Qt designer and resource manager

Qt designer can be used to edit all the UI components, then a python script can load the UI and add functionalities to the widgets (buttons, labels, etc). To use the designer program, run pyside6-designer within the conda envrionment. After saving the .ui file, run pyside6-uic filename.ui -o filename.py to generate the python file. This step needs to be repeated for every .ui file.

The resource manager in Qt can be used as a convinient way to keep track of all resources. This can include icons, images, config files, data, etc. The list is saved as a .qrc file, and can be edited in the designer. To update the resources, run pyside6-rcc filename.qrc -o resources_rc.py to generate python script. The resources_rc filename seems to be the default expected by the uic program. After placing the resources_rc.py file in the working directory, the program should load all data correctly.