Regbot GUI: Difference between revisions

From Rsewiki
Line 58: Line 58:
* Get the newest version from repository (SVN)
* Get the newest version from repository (SVN)


HERTIL
=== From zip file ===


===Install SVN=== 
Unzip the Python files (many files (23), so keep them in a clean directory).


The source is on a SVN repository, if not available, then install:
=== From SVN repository ===


Install TortoiseSVN from https://subversion.apache.org
Make sure your PC has SVN (Apache subversion) support.
On left menu find "Binary packages" and from here the 'Windows' section


* Download TortoiseSVN
===== Windows =====
* Install, and remember to add 'command line' support.
* restart a 'cmd' terminal after installation


=== Get the GUI (SVN repository) ===
Install e.g. SilkSVN (https://sliksvn.com/download/), this is a command-line interface, but there are other packages too.


The file-browser may have support for SVN (or it can be added), in this case 'checkout' the regbot_gui on this address
Start a 'cmd' terminal after installation.


svn://repos.gbar.dtu.dk/jcan/regbot/regbot_gui
===== Linux (and MAC) =====


On Linux (and maybe Apple) install subversion (Linux: sudo apt install subversion)
sudo apt install subversion


The checkout with the command
==== Get the GUI Python files ====


Open a terminal window, change the directory, to where you want to install, e.g. called 'svn'
mkdir svn
cd svn
  svn checkout svn://repos.gbar.dtu.dk/jcan/regbot/regbot_gui
  svn checkout svn://repos.gbar.dtu.dk/jcan/regbot/regbot_gui
cd regbot_gui


=== Get the GUI (GIT repository) ===
There should be several Python files, including 'regbot.py'.
 
A snapshot of the GUI is provided for Teensy version 1535 (14 February 2023) in a git repository


Find the repository and the python files here
=== Start the Regbot GUI ===


https://repos.gbar.dtu.dk/git/jcan/regbot_gui.git
Go to the directory, where the Python files are placed.


Copy files or clone to your disk
* Execute the 'regbot.py' file.


git clone https://repos.gbar.dtu.dk/git/jcan/regbot_gui.git
From a terminal


NB! The SVN repository is regularly updated and this GIT version may be outdated.
cd regbot_gui
python3 regbot.py


== Run the GUI ==
== Run the GUI ==

Revision as of 14:00, 7 December 2023

Back to Regbot

Back to Robobot


Install Python

Install python and the python install program pip.

Windows

Install Python from Microsoft store (Includes pip). (Should be python version 3.x)

Mac

Install Python (version 3.x) Maybe it is installed by default (I have no MAC)

Linux

install pip (Python Install Program)

sudo apt install python3
sudo apt install pip

Install Python packages

Windows

Open a terminal window (search for 'cmd' app)

At the command prompt install these packages:

> pip install pyqt4
> pip install pyserial
> pip install pyqtgraph
> pip install numpy

MAC

The same packages are needed.

Linux

> pip install pyqt5
> pip install pyqtgraph
> pip install pyserial
> pip install numpy

Get REGBOT GUI

The REGBOT GUI is just a set of python files

There are two options

  • Get the python files from a zip-file (available in Learn)
  • Get the newest version from repository (SVN)

From zip file

Unzip the Python files (many files (23), so keep them in a clean directory).

From SVN repository

Make sure your PC has SVN (Apache subversion) support.

Windows

Install e.g. SilkSVN (https://sliksvn.com/download/), this is a command-line interface, but there are other packages too.

Start a 'cmd' terminal after installation.

Linux (and MAC)

sudo apt install subversion

Get the GUI Python files

Open a terminal window, change the directory, to where you want to install, e.g. called 'svn'

mkdir svn
cd svn
svn checkout svn://repos.gbar.dtu.dk/jcan/regbot/regbot_gui
cd regbot_gui

There should be several Python files, including 'regbot.py'.

Start the Regbot GUI

Go to the directory, where the Python files are placed.

  • Execute the 'regbot.py' file.

From a terminal

cd regbot_gui
python3 regbot.py

Run the GUI

The python version

In the regbot_gui directory, run the regbot.py script.

  • On Linux, this command line should work:
cd regbot_gui
python3 regbot.py
  • On Windows

Find the directory in your file browser (Stifinder)

Start the file 'regbot.py' - maybe create a shortcut on the desktop.

If there are errors about libraries, then check if they are installed (from the list above).

Regbot.exe for Windows

A windows executable is generated (using the instructions below); this is found in a subdirectory called "dist".

> cd Downloads
> cd regbot
> cd regbot_gui
> cd dist
> regbot

Use the browser to locate the file and execute it. It also holds all the needed python-libraries, so it takes a long time to start.

The regbot.exe file is made on a Windows 10 (I don't have anything newer if there are problems; revert to the Python version)

NB! the version from 2022 does not work anymore; it has to have a date from 2023.

Regbot GUI use

See the User interface

Make a windows EXE file

If you installed all the python stuff, you don't need the exe file.

To make a single exe-file without the need to install anything, then it is a bit more complicated (for me at least)

Install python

After installation, start 'cmd' terminal windows as administrator (right-click on 'cmd' and select 'as administrator') to install additional packages using 'pip'.

> pip install pyqt5
> pip install pyqtgraph
> pip install pyserial
> pip install pyinstaller
> exit

Generate EXE file

Open a 'cmd' terminal window as a normal user

Then make the EXE-file from the directory with the REGBOT GUI

> cd Downloads\regbot_gui
> pyinstaller --onefile regbot.py

This takes some time, and the regbot.exe should be found in a 'dist' subdirectory.

Try:

> cd dist
> regbot.exe

PS! tried also with Python 3.9, but regbot.exe failed with the error: "PyQt5.sip not found".