Introduction

This repository contains the GUI tool for the selection and addition of signals to the Vehicle Signal Specification (VSS). The tool is used to select signals (data or parameters) from hundreds of signals defined in VSS bassed on the requirements of an application.

Getting started

Dependencies

1. The VSS GUI tool runs in Ubuntu (tested in Ubuntu 22.04).
2. The GUI tool is based on Python (tested in v3.10) and the following libraries:
   • Tkinter
   • Anytree
   • Pyyaml
   • Screeninfo
3. The GUI tool is also dependent on the .vspec files defined in the Vehicle Signal Specification repository and the corresponding VSS-tools repository.

Structure of the repository

1. container - Contains the dockerfile recipe for the container image that is used to run the necessary scripts.
2. scripts - Contains the necessary Python scripts with respect to the GUI tool.
3. documentation - Contains the document explaining the features of the GUI tool.

Running the script

1. Update the submodules linked to the repository: git submodule update --init --recursive.
2. Since the GUI tool has been tested upto v4.X of the VSS tools, navigate to the vss-tools repository located in the [vss] (./scripts/vss) folder and checkout to the required version: git checkout v4.1.1.
3. Build the container image by running the build.sh script in the container folder.
4. Run the container: docker run -ti -e DISPLAY=$(hostname).local:0 -it vss_gui:latest. In case of WSL, ensure that x11 forwarding is enabled and working.
5. Run the Python vss_gui.pyscript in /app/gui folder.