dpsctl-gui.py

dpsctl-gui.py is a crude frontend for OpenDPS dpsctl

Requirements

The tool runs inside a Python virtual environment and requires the installation of certain Python dependencies listed in requirements.txt.

Installation

1. Clone the repository

git clone https://github.com/gabtremblay/dpsctl-gui.git

2. Set up a Virtual Environment

Create a Python virtual environment:

python -m venv dpsctl-gui

Activate the virtual environment:

• On Linux/macOS:

  cd dpsctl-gui
  source bin/activate

• On Windows:

  cd dpsctl-gui
  Scripts\activate.ps1

3. Install Dependencies

Once the virtual environment is activated, install the necessary dependencies using the following command:

• On Windows:

pip install -r requirements.txt

• On Linux/macOS:

pip install scikit-build
pip install -r requirements.txt

4. !LINUX ONLY! Fix txextrafont

A bug in tkextrafont makes it impossible to read Google open font under linux. You need to find this code block

vi lib/_your_python_version/site-packages/tkextrafont/fontnameinfo.tcl

Go to line 209 and change the block

if { $::tcl_platform(platform) == "windows" } {
		set baseTriplet [binary format "SSS" 3 1 0x0409]	 
	} else {
		set baseTriplet [binary format "SSS" 1 0 0]	 
	}

For

	set baseTriplet [binary format "SSS" 3 1 0x0409]	

Usage

To run the tool, you need to specify the -d parameter. This parameter can either be an IP address or a TTY device.

Example usage:

python dpsctl-gui.py -d <device_ip_or_tty>

Examples:

• Using an IP address:

  python dpsctl-gui.py -d 192.168.1.10

• Using a TTY device:

  python dpsctl-gui.py -d /dev/ttyUSB0

If the -d parameter is missing, the tool will not run and prompt you to provide the required device parameter.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

---

Happy coding!