GUI program for manual control of REV Robotics Expansion Hub from a PC. Unofficial "Community Edition".
Project description
Rev Hardware Client (Community Edition)
The REV Hub Interface is a piece of software allowing for a direct connection from a REV Expansion Hub and its peripherals to a PC.
This interface provides a method for teams to prototype with motors, servos, and sensors in a way that is faster and easier than setting up an entire robot control system. It is also a valuable troubleshooting tool that can help isolate the cause of an issue and determine if it is electrical or software related. The REV Hub Firmware can also be updated and recovered through this interface in addition to the Robot Controller Application.
This is a community continuation of the software, updating to newer underlying technologies (e.g. porting from Python 2 to Python 3), adding features, and porting to more platforms (Linux and macOS, in addition to Windows).
Installing the software
(note: binaries are not available yet, this is a placeholder)
Start by downloading the latest version of the software from the Releases page. An .exe
is provided for Windows systems, an AppImage for Linux systems, and a .DMG
for macOS.
Alternately, download from Flatpak (TODO) or from PyPi (just needs publishing)
PyPi installation steps:
- Install Python3
- Run
pip install REVHubInterface
to install - Finally, run
python -m REVHubInterface
to run the app
Firmware updates require installing a driver.
- Windows: The newest versions of Windows should automatically install the required USB drivers. Alternatively, you can download the latest drivers from the FTDI VCP website.
- Linux: The latest
libftdi.so
is provided in the download, no additional action should be necessary. - macOS: (TODO: figure out;
UPDATE: Will be fixed when https://github.com/lsgunth/pyft232/pull/22 is merged and published, in the mean time we should manually apply the change in our releases that have the library bundled. Also, should we bundlebrew install libftdi
doesn't seem to make the error go away.libftdi1.dylib
and its dependencies, or request users install it via Homebrew themselves?)
Connecting and Controlling an Expansion Hub
- Connect your Expansion Hub to the computer with a USB A to USB Mini-B cable.
- Run the REV Hub Interface Software.
- Press Connect. The software will scan and connect to the Expansion Hub. The various peripheral tabs will populate with controls once connected.
Running the development version
If you want to run the development version from this repository rather than using a pre-packaged version, you will need to install a few additional dependencies:
- Python 3
- Tkinter
- Windows: This is included in the Python 3 installer, just make sure sure it is selected to be installed at install time.
- Linux: On Ubuntu and derivatives, this is instaled with
sudo apt install python3-tk
. The package name will likely be similar on other distributions. - macOS: If using Homebrew, it can be install via
brew install python-tk
.
- On Linux, you will also need the latest
libftdi.so
. On Ubuntu and derivitaves, this can be installed withsudo apt install libftdi-dev
. The package name may be similar on other distributions. - The remaining Python dependencies (currently
pyft232
andpyserial
, subject to future changes) can be installed viapip3 install -r requirements.txt
- Finally, run
python REVHubInterface
while in the base folder of the repo - Alternately, you can install onto your system from source using
pip install .
from the base folder of the repo, then usingpython -m REVHubInterface
from anywhere
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for revhubinterface-1.3.1.dev27.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 47c5837da81a7cb88d56f3e1b15654e52a8cbca091002e82255bdec7a508371f |
|
MD5 | 1cef48652ca2a43cc57b9679a9625566 |
|
BLAKE2b-256 | 784426a2be3c35b9b47b2eaa7c2d3786a58ab21efbfce2952759f0d011e7f8fe |
Hashes for REVHubInterface-1.3.1.dev27-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 94e4c893d92f57d4723f6b4941e46b99b7e2ccd344fb793e50ba7d173a24b1ad |
|
MD5 | d45fb04173ca260e650ebe3eb6c90a9d |
|
BLAKE2b-256 | 4f566cf31d1374ca5e1ca6c840a6c61ba70c3c6f1adffb3def44bfc434647117 |