REVHubInterface


NameREVHubInterface JSON
Version 1.4.1 PyPI version JSON
download
home_pageNone
SummaryGUI program for manual control of REV Robotics Expansion Hub from a PC. Unofficial "Community Edition".
upload_time2024-09-17 18:49:33
maintainerNone
docs_urlNone
authorNone
requires_pythonNone
licenseCopyright (c) 2024, Unofficial Rev Port team and contributors. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of the Unofficial Rev Port team nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE UNOFFICIAL REV PORT TEAM OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. This software is based on the REV Hub Interface tool created by REV, which was released under the following license: Copyright (c) 2019, REV Robotics LLC All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of the <organization> nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Sflash.exe is a product of Texas Instruments and is re-distributed by REV Robotics LLC under grant permission. It is only to be used to program REV Expansion Hubs that feature TI chips. TI License for sflash is below Copyright (c) 2006-2017 Texas Instruments Incorporated. All rights reserved. Software License Agreement Texas Instruments (TI) is supplying this software for use solely and exclusively on TI's microcontroller products. The software is owned by TI and/or its suppliers, and is protected under applicable copyright laws. You may not combine this software with "viral" open-source software in order to form a larger program. THIS SOFTWARE IS PROVIDED "AS IS" AND WITH ALL FAULTS. NO WARRANTIES, WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE APPLY TO THIS SOFTWARE. TI SHALL NOT, UNDER ANY CIRCUMSTANCES, BE LIABLE FOR SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, FOR ANY REASON WHATSOEVER. This is part of revision 2.1.4.178 of the Tiva Firmware Development Package.
keywords rev expansion hub hub interface
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # REV Hub Interface — Community Edition
[![Discord](https://img.shields.io/discord/1237587540014403614?style=flat&logo=discord&color=5865F2&label=Join%20our%20Discord%21)](https://discord.gg/2CJqU6YX2W)
[![PyPI - Version](https://img.shields.io/pypi/v/REVHubInterface?label=Latest%20Version%20%28PyPI%29)](https://pypi.org/project/REVHubInterface/)
[![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/unofficial-rev-port/REVHubInterface/total?label=GitHub%20Downloads)](https://github.com/unofficial-rev-port/REVHubInterface/releases)
![Flathub Downloads](https://img.shields.io/flathub/downloads/org.unofficialrevport.REVHubInterface?label=Flathub%20Downloads)


This is the Community Edition of REV Hub Interface.
REV Hub Interface allows you to manually control an Expansion Hub from your computer with zero code.
Originally created by REV, we have now ported it to Linux and macOS.
We have also added a more modern UI, more control features,
and overhauled the backend to make everything more responsive.

Though the original version of the software was created by REV Robotics,
this version is <ins>not maintained by or affiliated with REV Robotics</ins>.
Please do <ins>**not**</ins> contact REV Robotics official support about any issues you experience with this software;
instead, you may create a GitHub Issue or ask in [our Discord server](https://discord.gg/pU2fesSTqF).

This software is licensed under the BSD-3-Clause license, as is the official REV version that it is based on.
The full text is available in the LICENSE.txt file.

## Installing the software

<a href='https://flathub.org/apps/org.unofficialrevport.REVHubInterface'><img width='240' alt='Download on Flathub' src='https://flathub.org/api/badge?svg&locale=en'/></a>

Start by downloading the latest version of the software from [the Releases page](https://github.com/unofficial-rev-port/REVHubInterface/releases).  
An `.exe` is provided for Windows, a `.DMG` for macOS, and AUR Pkgbuild, Flatpak, and binary for Linux
You can [download from Flathub here](https://flathub.org/apps/org.unofficialrevport.REVHubInterface).
Alternately, you can download it from PyPi:

1. Install Python 3
2. Run `pip install REVHubInterface` to install
3. Finally, run `python3 -m REVHubInterface` to run the app (it should also be runnable as `revhubinterface`)

To avoid needing to run REV Hub Interface with root privileges on Linux, add your user to the `dialout` group:

1. Run ```sudo usermod `whoami` -a -G dialout``` (on Arch Linux, you need to use `uucp` instead of `dialout`)
2. Reboot


## Connecting and Controlling an Expansion Hub

1. Connect your Expansion Hub to the computer with a USB A to USB Mini-B cable.
2. Run the REV Hub Interface Software.
3. Press Connect.  The software will scan and connect to the Expansion Hub. The various peripheral tabs will be populated with controls once connected.

## Running the development version

Early binaries are available from the Actions tab,
or from the pre-releases section of https://pypi.org/project/REVHubInterface/#history.

To compile yourself, first install a few additional dependencies:

- Python 3
- Tkinter
  - Windows: This is included in the Python 3 installer. Make sure the checkbox to install it is selected.
  - Linux: On Ubuntu and derivatives, this is installed with `sudo apt install python3-tk`. On Arc and derivatives, it can be installed with `sudo pacman -Su tk`. The package name should be similar on other distributions.
  - macOS: If using Homebrew, it can be installed via `brew install python-tk`.


            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "REVHubInterface",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": "REV, Expansion Hub, Hub Interface",
    "author": null,
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/78/73/fb98e166958bac4b8c506dd3061bef85eea42160039b89391eef390d4c95/revhubinterface-1.4.1.tar.gz",
    "platform": null,
    "description": "# REV Hub Interface \u2014 Community Edition\n[![Discord](https://img.shields.io/discord/1237587540014403614?style=flat&logo=discord&color=5865F2&label=Join%20our%20Discord%21)](https://discord.gg/2CJqU6YX2W)\n[![PyPI - Version](https://img.shields.io/pypi/v/REVHubInterface?label=Latest%20Version%20%28PyPI%29)](https://pypi.org/project/REVHubInterface/)\n[![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/unofficial-rev-port/REVHubInterface/total?label=GitHub%20Downloads)](https://github.com/unofficial-rev-port/REVHubInterface/releases)\n![Flathub Downloads](https://img.shields.io/flathub/downloads/org.unofficialrevport.REVHubInterface?label=Flathub%20Downloads)\n\n\nThis is the Community Edition of REV Hub Interface.\nREV Hub Interface allows you to manually control an Expansion Hub from your computer with zero code.\nOriginally created by REV, we have now ported it to Linux and macOS.\nWe have also added a more modern UI, more control features,\nand overhauled the backend to make everything more responsive.\n\nThough the original version of the software was created by REV Robotics,\nthis version is <ins>not maintained by or affiliated with REV Robotics</ins>.\nPlease do <ins>**not**</ins> contact REV Robotics official support about any issues you experience with this software;\ninstead, you may create a GitHub Issue or ask in [our Discord server](https://discord.gg/pU2fesSTqF).\n\nThis software is licensed under the BSD-3-Clause license, as is the official REV version that it is based on.\nThe full text is available in the LICENSE.txt file.\n\n## Installing the software\n\n<a href='https://flathub.org/apps/org.unofficialrevport.REVHubInterface'><img width='240' alt='Download on Flathub' src='https://flathub.org/api/badge?svg&locale=en'/></a>\n\nStart by downloading the latest version of the software from [the Releases page](https://github.com/unofficial-rev-port/REVHubInterface/releases).  \nAn `.exe` is provided for Windows, a `.DMG` for macOS, and AUR Pkgbuild, Flatpak, and binary for Linux\nYou can [download from Flathub here](https://flathub.org/apps/org.unofficialrevport.REVHubInterface).\nAlternately, you can download it from PyPi:\n\n1. Install Python 3\n2. Run `pip install REVHubInterface` to install\n3. Finally, run `python3 -m REVHubInterface` to run the app (it should also be runnable as `revhubinterface`)\n\nTo avoid needing to run REV Hub Interface with root privileges on Linux, add your user to the `dialout` group:\n\n1. Run ```sudo usermod `whoami` -a -G dialout``` (on Arch Linux, you need to use `uucp` instead of `dialout`)\n2. Reboot\n\n\n## Connecting and Controlling an Expansion Hub\n\n1. Connect your Expansion Hub to the computer with a USB A to USB Mini-B cable.\n2. Run the REV Hub Interface Software.\n3. Press Connect.  The software will scan and connect to the Expansion Hub. The various peripheral tabs will be populated with controls once connected.\n\n## Running the development version\n\nEarly binaries are available from the Actions tab,\nor from the pre-releases section of https://pypi.org/project/REVHubInterface/#history.\n\nTo compile yourself, first install a few additional dependencies:\n\n- Python 3\n- Tkinter\n  - Windows: This is included in the Python 3 installer. Make sure the checkbox to install it is selected.\n  - Linux: On Ubuntu and derivatives, this is installed with `sudo apt install python3-tk`. On Arc and derivatives, it can be installed with `sudo pacman -Su tk`. The package name should be similar on other distributions.\n  - macOS: If using Homebrew, it can be installed via `brew install python-tk`.\n\n",
    "bugtrack_url": null,
    "license": "Copyright (c) 2024, Unofficial Rev Port team and contributors. All rights reserved.  Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of the Unofficial Rev Port team nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE UNOFFICIAL REV PORT TEAM OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.  This software is based on the REV Hub Interface tool created by REV, which was released under the following license: Copyright (c) 2019, REV Robotics LLC All rights reserved.  Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of the <organization> nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.  Sflash.exe is a product of Texas Instruments and is re-distributed by REV Robotics LLC under grant permission. It is only to be used to program REV Expansion Hubs that feature TI chips. TI License for sflash is below  Copyright (c) 2006-2017 Texas Instruments Incorporated.  All rights reserved. Software License Agreement  Texas Instruments (TI) is supplying this software for use solely and exclusively on TI's microcontroller products. The software is owned by TI and/or its suppliers, and is protected under applicable copyright laws. You may not combine this software with \"viral\" open-source software in order to form a larger program.  THIS SOFTWARE IS PROVIDED \"AS IS\" AND WITH ALL FAULTS. NO WARRANTIES, WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE APPLY TO THIS SOFTWARE. TI SHALL NOT, UNDER ANY CIRCUMSTANCES, BE LIABLE FOR SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, FOR ANY REASON WHATSOEVER.  This is part of revision 2.1.4.178 of the Tiva Firmware Development Package. ",
    "summary": "GUI program for manual control of REV Robotics Expansion Hub from a PC. Unofficial \"Community Edition\".",
    "version": "1.4.1",
    "project_urls": {
        "Homepage": "https://unofficialrevport.org",
        "Issues": "https://github.com/unofficial-rev-port/REVHubInterface/issues",
        "Repository": "https://github.com/unofficial-rev-port/REVHubInterface.git"
    },
    "split_keywords": [
        "rev",
        " expansion hub",
        " hub interface"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "83c95849c33513be5bfbffa3ae328a79044075f84b5d80c2b545ce60e78f0fde",
                "md5": "53ba97b68b8c6ad04ea94b7a66c16265",
                "sha256": "38047dded3b61f44adc9b6a0856f4870b49c2ccc0f9b972d1e2fd0ee1263ca8c"
            },
            "downloads": -1,
            "filename": "REVHubInterface-1.4.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "53ba97b68b8c6ad04ea94b7a66c16265",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 52769,
            "upload_time": "2024-09-17T18:49:31",
            "upload_time_iso_8601": "2024-09-17T18:49:31.148522Z",
            "url": "https://files.pythonhosted.org/packages/83/c9/5849c33513be5bfbffa3ae328a79044075f84b5d80c2b545ce60e78f0fde/REVHubInterface-1.4.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "7873fb98e166958bac4b8c506dd3061bef85eea42160039b89391eef390d4c95",
                "md5": "4dab35ce03b7bf0cbf4de6ac236f4c4d",
                "sha256": "1349f7a58d11e076f1c3ec98a5b5fdb0e10b5cec26c897866641a41f25581c6e"
            },
            "downloads": -1,
            "filename": "revhubinterface-1.4.1.tar.gz",
            "has_sig": false,
            "md5_digest": "4dab35ce03b7bf0cbf4de6ac236f4c4d",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 325207,
            "upload_time": "2024-09-17T18:49:33",
            "upload_time_iso_8601": "2024-09-17T18:49:33.122927Z",
            "url": "https://files.pythonhosted.org/packages/78/73/fb98e166958bac4b8c506dd3061bef85eea42160039b89391eef390d4c95/revhubinterface-1.4.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-09-17 18:49:33",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "unofficial-rev-port",
    "github_project": "REVHubInterface",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "lcname": "revhubinterface"
}
        
Elapsed time: 0.32468s