https://github.com/FRC-Utilities/QDriverStation

Cross-platform clone of the FRC Driver Station
https://github.com/FRC-Utilities/QDriverStation

control-systems frc networking robotics

Last synced: about 1 month ago
JSON representation

Cross-platform clone of the FRC Driver Station

• Host: GitHub
• URL: https://github.com/FRC-Utilities/QDriverStation
• Owner: FRC-Utilities
• License: mit
• Created: 2015-09-12T22:40:00.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2024-03-15T17:52:46.000Z (9 months ago)
• Last Synced: 2024-10-29T22:46:25.529Z (about 2 months ago)
• Topics: control-systems, frc, networking, robotics
• Language: QML
• Homepage: https://frc-utilities.github.io
• Size: 24.9 MB
• Stars: 188
• Watchers: 21
• Forks: 26
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGES.md
  • License: LICENSE.md

Awesome Lists containing this project

• awesome-frc - QDriverStation - Popular open-source Driver Station clone for all Desktop platforms. Though not permitted in competition, essential for teams wishing to drive on another platform or up their open source cred. (Driving)

README

        
# QDriverStation



    



[![Build Status](https://github.com/FRC-Utilities/QDriverStation/workflows/Build/badge.svg)](https://github.com/FRC-Utilities/QDriverStation/actions)

[![Github All Releases](https://img.shields.io/github/downloads/FRC-Utilities/QDriverStation/total.svg)](https://github.com/FRC-Utilities/QDriverStation/releases/)

The QDriverStation is a cross-platform and open-source alternative to the FRC Driver Station. It allows you to operate FRC robots with the major operating systems (Windows, Mac OSX and GNU/Linux). The QDriverStation is able to operate both 2009-2014 robots and 2015-2017 robots, support for 2020 robots is on the way.

The actual code that operates a FRC robot is found in a [separate repository](https://github.com/FRC-Utilities/LibDS), which is written in C and can be used for your own projects or change it to support more communication protocols (such as [ROS](https://github.com/FRC-Utilities/QDriverStation/issues/21)).

You can find the online documentation of the QDriverStation and its sub-projects [here](http://frc-utilities.github.io/documentation/).

![macOS Screenshot](doc/QDriverStation-macOS.png)

### Install notes

You can download the QDriverStation from [GitHub](http://github.com/FRC-Utilities/QDriverStation/releases).

Once you finish installing the software, you can launch it and begin driving your robot. Just be sure to input your team number and to verify that the joysticks are working correctly.

Mac users will be prompted to download an additional driver for Xbox 360 controllers to work.

###### Note for Linux users

For convenience, Linux releases are now handled with AppImages. To run the AppImage, simply download the latest release, make it executable and run it. 

Terminal commands below:

    cd Downloads

    chmod +x QDriverStation*.AppImage

    ./QDriverStation*.AppImage

More info can be found here: [https://appimage.org/](https://appimage.org/).

###### Warnings

If you are on Linux, the QDriverStation may detect some devices as a joystick ([more info...](https://gist.github.com/denilsonsa/978f1d842cf5430f57f6#file-51-these-are-not-joysticks-rules)). If that happens, just disable the faulty device by clicking on the power button next to its name.

### Build instructions

###### Requirements

The only requirement to compile the application is to have [Qt](http://www.qt.io/download-open-source/) installed in your system. The desktop application will compile with Qt 5.15 or greater.

- If you are using Linux, make sure that you have installed the following packages:

    - `libsdl2-dev`

The project already contains the compiled SDL libraries for Windows and Mac.

### Cloning this repository

This repository makes use of [`git submodule`](https://git-scm.com/docs/git-submodule). In order to clone it, you have two options:

One-liner:

    git clone --recursive https://github.com/FRC-Utilities/QDriverStation/

Normal procedure:

    git clone https://github.com/FRC-Utilities/QDriverStation/

    cd QDriverStation

    git submodule init

    git submodule update

    

###### Compiling the application

Once you have Qt installed, open *QDriverStation.pro* in Qt Creator and click the "Run" button.

Alternatively, you can also use the following commands:

- qmake

- make

- **Optional:** sudo make install

### Credits

This application was created by [Alex Spataru](http://github.com/alex-spataru).

Of course, many people contributed in different ways to this project, you can find more details in the [contributors list](CONTRIBUTORS.md). Finally, we want to thank you for trying this little project, we sincerely hope that you enjoy our application and we would love some of your feedback.

### License

This project is released under the MIT License. For more information, [click here](LICENSE.md).